"**
+// For example: **indoor\_level:"1"**
+// Returns beacons which are located on the given indoor level.
+//
// Accepts
-// multiple filters that will be combined with OR logic.
+//
+// multiple filters that will be combined with OR logic.
//
// Multiple filters on the same field are combined with OR logic
// (except
@@ -2639,7 +2696,9 @@ type BeaconsRegisterCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **Is owner** or **Can edit** permissions in the
// Google
// Developers Console project.
@@ -2800,7 +2859,9 @@ type BeaconsUpdateCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **Is owner** or **Can edit** permissions in the
// Google
// Developers Console project.
@@ -2972,7 +3033,9 @@ type BeaconsAttachmentsBatchDeleteCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **Is owner** or **Can edit** permissions in the
// Google
// Developers Console project.
@@ -3159,7 +3222,9 @@ type BeaconsAttachmentsCreateCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **Is owner** or **Can edit** permissions in the
// Google
// Developers Console project.
@@ -3329,7 +3394,9 @@ type BeaconsAttachmentsDeleteCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **Is owner** or **Can edit** permissions in the
// Google
// Developers Console project.
@@ -3490,7 +3557,9 @@ type BeaconsAttachmentsListCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **viewer**, **Is owner** or **Can edit**
// permissions in
// the Google Developers Console project.
@@ -3679,7 +3748,9 @@ type BeaconsDiagnosticsListCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **viewer**, **Is owner** or **Can edit**
// permissions in
// the Google Developers Console project.
@@ -3694,10 +3765,11 @@ func (r *BeaconsDiagnosticsService) List(beaconName string) *BeaconsDiagnosticsL
// beacons that have low batteries use `alert_filter=LOW_BATTERY`.
//
// Possible values:
-// "ALERT_UNSPECIFIED"
-// "WRONG_LOCATION"
-// "LOW_BATTERY"
-// "LOW_ACTIVITY"
+//
+// "ALERT_UNSPECIFIED"
+// "WRONG_LOCATION"
+// "LOW_BATTERY"
+// "LOW_ACTIVITY"
func (c *BeaconsDiagnosticsListCall) AlertFilter(alertFilter string) *BeaconsDiagnosticsListCall {
c.urlParams_.Set("alertFilter", alertFilter)
return c
@@ -3923,7 +3995,9 @@ type NamespacesListCall struct {
// Authenticate using an [OAuth
// access
// token](https://developers.google.com/identity/protocols/OAuth2)
-// from a
+//
+// from a
+//
// signed-in user with **viewer**, **Is owner** or **Can edit**
// permissions in
// the Google Developers Console project.
diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json
index d4e010f2613..06b1b9fa204 100644
--- a/pubsub/v1/pubsub-api.json
+++ b/pubsub/v1/pubsub-api.json
@@ -1424,7 +1424,7 @@
}
}
},
- "revision": "20220718",
+ "revision": "20220808",
"rootUrl": "https://pubsub.googleapis.com/",
"schemas": {
"AcknowledgeRequest": {
@@ -1492,7 +1492,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
@@ -2059,7 +2059,7 @@
"type": "object"
},
"Subscription": {
- "description": "A subscription resource.",
+ "description": "A subscription resource. If none of `push_config` or `bigquery_config` is set, then the subscriber will pull and ack messages using API methods. At most one of these fields may be set.",
"id": "Subscription",
"properties": {
"ackDeadlineSeconds": {
@@ -2069,7 +2069,7 @@
},
"bigqueryConfig": {
"$ref": "BigQueryConfig",
- "description": "If delivery to BigQuery is used with this subscription, this field is used to configure it. Either `pushConfig` or `bigQueryConfig` can be set, but not both. If both are empty, then the subscriber will pull and ack messages using API methods."
+ "description": "If delivery to BigQuery is used with this subscription, this field is used to configure it."
},
"deadLetterPolicy": {
"$ref": "DeadLetterPolicy",
@@ -2113,7 +2113,7 @@
},
"pushConfig": {
"$ref": "PushConfig",
- "description": "If push delivery is used with this subscription, this field is used to configure it. Either `pushConfig` or `bigQueryConfig` can be set, but not both. If both are empty, then the subscriber will pull and ack messages using API methods."
+ "description": "If push delivery is used with this subscription, this field is used to configure it."
},
"retainAckedMessages": {
"description": "Indicates whether to retain acknowledged messages. If true, then messages are not expunged from the subscription's backlog, even if they are acknowledged, until they fall out of the `message_retention_duration` window. This must be true if you would like to [`Seek` to a timestamp] (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in the past to replay previously-acknowledged messages.",
diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go
index a6f88e1b5d7..d96b9ea08c8 100644
--- a/pubsub/v1/pubsub-gen.go
+++ b/pubsub/v1/pubsub-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/pubsub/docs
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/pubsub/v1"
-// ...
-// ctx := context.Background()
-// pubsubService, err := pubsub.NewService(ctx)
+// import "google.golang.org/api/pubsub/v1"
+// ...
+// ctx := context.Background()
+// pubsubService, err := pubsub.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// pubsubService, err := pubsub.NewService(ctx, option.WithScopes(pubsub.PubsubScope))
+// pubsubService, err := pubsub.NewService(ctx, option.WithScopes(pubsub.PubsubScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// pubsubService, err := pubsub.NewService(ctx, option.WithAPIKey("AIza..."))
+// pubsubService, err := pubsub.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// pubsubService, err := pubsub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// pubsubService, err := pubsub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package pubsub // import "google.golang.org/api/pubsub/v1"
@@ -341,16 +341,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1663,7 +1667,9 @@ func (s *Snapshot) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// Subscription: A subscription resource.
+// Subscription: A subscription resource. If none of `push_config` or
+// `bigquery_config` is set, then the subscriber will pull and ack
+// messages using API methods. At most one of these fields may be set.
type Subscription struct {
// AckDeadlineSeconds: The approximate amount of time (on a best-effort
// basis) Pub/Sub waits for the subscriber to acknowledge receipt before
@@ -1684,9 +1690,7 @@ type Subscription struct {
AckDeadlineSeconds int64 `json:"ackDeadlineSeconds,omitempty"`
// BigqueryConfig: If delivery to BigQuery is used with this
- // subscription, this field is used to configure it. Either `pushConfig`
- // or `bigQueryConfig` can be set, but not both. If both are empty, then
- // the subscriber will pull and ack messages using API methods.
+ // subscription, this field is used to configure it.
BigqueryConfig *BigQueryConfig `json:"bigqueryConfig,omitempty"`
// DeadLetterPolicy: A policy that specifies the conditions for dead
@@ -1759,9 +1763,7 @@ type Subscription struct {
Name string `json:"name,omitempty"`
// PushConfig: If push delivery is used with this subscription, this
- // field is used to configure it. Either `pushConfig` or
- // `bigQueryConfig` can be set, but not both. If both are empty, then
- // the subscriber will pull and ack messages using API methods.
+ // field is used to configure it.
PushConfig *PushConfig `json:"pushConfig,omitempty"`
// RetainAckedMessages: Indicates whether to retain acknowledged
@@ -2174,8 +2176,8 @@ type ProjectsSchemasCreateCall struct {
// Create: Creates a schema.
//
-// - parent: The name of the project in which to create the schema.
-// Format is `projects/{project-id}`.
+// - parent: The name of the project in which to create the schema.
+// Format is `projects/{project-id}`.
func (r *ProjectsSchemasService) Create(parent string, schema *Schema) *ProjectsSchemasCreateCall {
c := &ProjectsSchemasCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2332,8 +2334,8 @@ type ProjectsSchemasDeleteCall struct {
// Delete: Deletes a schema.
//
-// - name: Name of the schema to delete. Format is
-// `projects/{project}/schemas/{schema}`.
+// - name: Name of the schema to delete. Format is
+// `projects/{project}/schemas/{schema}`.
func (r *ProjectsSchemasService) Delete(name string) *ProjectsSchemasDeleteCall {
c := &ProjectsSchemasDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2467,8 +2469,8 @@ type ProjectsSchemasGetCall struct {
// Get: Gets a schema.
//
-// - name: The name of the schema to get. Format is
-// `projects/{project}/schemas/{schema}`.
+// - name: The name of the schema to get. Format is
+// `projects/{project}/schemas/{schema}`.
func (r *ProjectsSchemasService) Get(name string) *ProjectsSchemasGetCall {
c := &ProjectsSchemasGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2480,11 +2482,16 @@ func (r *ProjectsSchemasService) Get(name string) *ProjectsSchemasGetCall {
// out. Set to `BASIC` to omit the `definition`.
//
// Possible values:
-// "SCHEMA_VIEW_UNSPECIFIED" - The default / unset value. The API will
+//
+// "SCHEMA_VIEW_UNSPECIFIED" - The default / unset value. The API will
+//
// default to the BASIC view.
-// "BASIC" - Include the name and type of the schema, but not the
+//
+// "BASIC" - Include the name and type of the schema, but not the
+//
// definition.
-// "FULL" - Include all Schema object fields.
+//
+// "FULL" - Include all Schema object fields.
func (c *ProjectsSchemasGetCall) View(view string) *ProjectsSchemasGetCall {
c.urlParams_.Set("view", view)
return c
@@ -2647,10 +2654,10 @@ type ProjectsSchemasGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSchemasService) GetIamPolicy(resource string) *ProjectsSchemasGetIamPolicyCall {
c := &ProjectsSchemasGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2821,8 +2828,8 @@ type ProjectsSchemasListCall struct {
// List: Lists schemas in a project.
//
-// - parent: The name of the project in which to list schemas. Format is
-// `projects/{project-id}`.
+// - parent: The name of the project in which to list schemas. Format is
+// `projects/{project-id}`.
func (r *ProjectsSchemasService) List(parent string) *ProjectsSchemasListCall {
c := &ProjectsSchemasListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2850,11 +2857,16 @@ func (c *ProjectsSchemasListCall) PageToken(pageToken string) *ProjectsSchemasLi
// `type`, but not `definition`. Set to `FULL` to retrieve all fields.
//
// Possible values:
-// "SCHEMA_VIEW_UNSPECIFIED" - The default / unset value. The API will
+//
+// "SCHEMA_VIEW_UNSPECIFIED" - The default / unset value. The API will
+//
// default to the BASIC view.
-// "BASIC" - Include the name and type of the schema, but not the
+//
+// "BASIC" - Include the name and type of the schema, but not the
+//
// definition.
-// "FULL" - Include all Schema object fields.
+//
+// "FULL" - Include all Schema object fields.
func (c *ProjectsSchemasListCall) View(view string) *ProjectsSchemasListCall {
c.urlParams_.Set("view", view)
return c
@@ -3049,10 +3061,10 @@ type ProjectsSchemasSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSchemasService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsSchemasSetIamPolicyCall {
c := &ProjectsSchemasSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3200,10 +3212,10 @@ type ProjectsSchemasTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSchemasService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsSchemasTestIamPermissionsCall {
c := &ProjectsSchemasTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3346,8 +3358,8 @@ type ProjectsSchemasValidateCall struct {
// Validate: Validates a schema.
//
-// - parent: The name of the project in which to validate schemas.
-// Format is `projects/{project-id}`.
+// - parent: The name of the project in which to validate schemas.
+// Format is `projects/{project-id}`.
func (r *ProjectsSchemasService) Validate(parent string, validateschemarequest *ValidateSchemaRequest) *ProjectsSchemasValidateCall {
c := &ProjectsSchemasValidateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3490,8 +3502,8 @@ type ProjectsSchemasValidateMessageCall struct {
// ValidateMessage: Validates a message against a schema.
//
-// - parent: The name of the project in which to validate schemas.
-// Format is `projects/{project-id}`.
+// - parent: The name of the project in which to validate schemas.
+// Format is `projects/{project-id}`.
func (r *ProjectsSchemasService) ValidateMessage(parent string, validatemessagerequest *ValidateMessageRequest) *ProjectsSchemasValidateMessageCall {
c := &ProjectsSchemasValidateMessageCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3650,11 +3662,11 @@ type ProjectsSnapshotsCreateCall struct {
// generated name is populated in the returned Snapshot object. Note
// that for REST API requests, you must specify a name in the request.
//
-// - name: User-provided name for this snapshot. If the name is not
-// provided in the request, the server will assign a random name for
-// this snapshot on the same project as the subscription. Note that
-// for REST API requests, you must specify a name. See the resource
-// name rules. Format is `projects/{project}/snapshots/{snap}`.
+// - name: User-provided name for this snapshot. If the name is not
+// provided in the request, the server will assign a random name for
+// this snapshot on the same project as the subscription. Note that
+// for REST API requests, you must specify a name. See the resource
+// name rules. Format is `projects/{project}/snapshots/{snap}`.
func (r *ProjectsSnapshotsService) Create(name string, createsnapshotrequest *CreateSnapshotRequest) *ProjectsSnapshotsCreateCall {
c := &ProjectsSnapshotsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3805,8 +3817,8 @@ type ProjectsSnapshotsDeleteCall struct {
// snapshot or its subscription, unless the same subscription is
// specified.
//
-// - snapshot: The name of the snapshot to delete. Format is
-// `projects/{project}/snapshots/{snap}`.
+// - snapshot: The name of the snapshot to delete. Format is
+// `projects/{project}/snapshots/{snap}`.
func (r *ProjectsSnapshotsService) Delete(snapshot string) *ProjectsSnapshotsDeleteCall {
c := &ProjectsSnapshotsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.snapshot = snapshot
@@ -3944,8 +3956,8 @@ type ProjectsSnapshotsGetCall struct {
// bulk. That is, you can set the acknowledgment state of messages in an
// existing subscription to the state captured by a snapshot.
//
-// - snapshot: The name of the snapshot to get. Format is
-// `projects/{project}/snapshots/{snap}`.
+// - snapshot: The name of the snapshot to get. Format is
+// `projects/{project}/snapshots/{snap}`.
func (r *ProjectsSnapshotsService) Get(snapshot string) *ProjectsSnapshotsGetCall {
c := &ProjectsSnapshotsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.snapshot = snapshot
@@ -4094,10 +4106,10 @@ type ProjectsSnapshotsGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSnapshotsService) GetIamPolicy(resource string) *ProjectsSnapshotsGetIamPolicyCall {
c := &ProjectsSnapshotsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4272,8 +4284,8 @@ type ProjectsSnapshotsListCall struct {
// you can set the acknowledgment state of messages in an existing
// subscription to the state captured by a snapshot.
//
-// - project: The name of the project in which to list snapshots. Format
-// is `projects/{project-id}`.
+// - project: The name of the project in which to list snapshots. Format
+// is `projects/{project-id}`.
func (r *ProjectsSnapshotsService) List(project string) *ProjectsSnapshotsListCall {
c := &ProjectsSnapshotsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -4617,10 +4629,10 @@ type ProjectsSnapshotsSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSnapshotsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsSnapshotsSetIamPolicyCall {
c := &ProjectsSnapshotsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4768,10 +4780,10 @@ type ProjectsSnapshotsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSnapshotsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsSnapshotsTestIamPermissionsCall {
c := &ProjectsSnapshotsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4919,8 +4931,8 @@ type ProjectsSubscriptionsAcknowledgeCall struct {
// redelivered later. Acknowledging a message more than once will not
// result in an error.
//
-// - subscription: The subscription whose message is being acknowledged.
-// Format is `projects/{project}/subscriptions/{sub}`.
+// - subscription: The subscription whose message is being acknowledged.
+// Format is `projects/{project}/subscriptions/{sub}`.
func (r *ProjectsSubscriptionsService) Acknowledge(subscription string, acknowledgerequest *AcknowledgeRequest) *ProjectsSubscriptionsAcknowledgeCall {
c := &ProjectsSubscriptionsAcknowledgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -5073,13 +5085,13 @@ type ProjectsSubscriptionsCreateCall struct {
// generated name is populated in the returned Subscription object. Note
// that for REST API requests, you must specify a name in the request.
//
-// - name: The name of the subscription. It must have the format
-// "projects/{project}/subscriptions/{subscription}".
-// `{subscription}` must start with a letter, and contain only letters
-// (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`),
-// periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It
-// must be between 3 and 255 characters in length, and it must not
-// start with "goog".
+// - name: The name of the subscription. It must have the format
+// "projects/{project}/subscriptions/{subscription}".
+// `{subscription}` must start with a letter, and contain only letters
+// (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`),
+// periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It
+// must be between 3 and 255 characters in length, and it must not
+// start with "goog".
func (r *ProjectsSubscriptionsService) Create(name string, subscription *Subscription) *ProjectsSubscriptionsCreateCall {
c := &ProjectsSubscriptionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5226,8 +5238,8 @@ type ProjectsSubscriptionsDeleteCall struct {
// association with the old subscription or its topic unless the same
// topic is specified.
//
-// - subscription: The subscription to delete. Format is
-// `projects/{project}/subscriptions/{sub}`.
+// - subscription: The subscription to delete. Format is
+// `projects/{project}/subscriptions/{sub}`.
func (r *ProjectsSubscriptionsService) Delete(subscription string) *ProjectsSubscriptionsDeleteCall {
c := &ProjectsSubscriptionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -5364,8 +5376,8 @@ type ProjectsSubscriptionsDetachCall struct {
// subscription is a push subscription, pushes to the endpoint will
// stop.
//
-// - subscription: The subscription to detach. Format is
-// `projects/{project}/subscriptions/{subscription}`.
+// - subscription: The subscription to detach. Format is
+// `projects/{project}/subscriptions/{subscription}`.
func (r *ProjectsSubscriptionsService) Detach(subscription string) *ProjectsSubscriptionsDetachCall {
c := &ProjectsSubscriptionsDetachCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -5499,8 +5511,8 @@ type ProjectsSubscriptionsGetCall struct {
// Get: Gets the configuration details of a subscription.
//
-// - subscription: The name of the subscription to get. Format is
-// `projects/{project}/subscriptions/{sub}`.
+// - subscription: The name of the subscription to get. Format is
+// `projects/{project}/subscriptions/{sub}`.
func (r *ProjectsSubscriptionsService) Get(subscription string) *ProjectsSubscriptionsGetCall {
c := &ProjectsSubscriptionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -5649,10 +5661,10 @@ type ProjectsSubscriptionsGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSubscriptionsService) GetIamPolicy(resource string) *ProjectsSubscriptionsGetIamPolicyCall {
c := &ProjectsSubscriptionsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -5823,8 +5835,8 @@ type ProjectsSubscriptionsListCall struct {
// List: Lists matching subscriptions.
//
-// - project: The name of the project in which to list subscriptions.
-// Format is `projects/{project-id}`.
+// - project: The name of the project in which to list subscriptions.
+// Format is `projects/{project-id}`.
func (r *ProjectsSubscriptionsService) List(project string) *ProjectsSubscriptionsListCall {
c := &ProjectsSubscriptionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6024,8 +6036,8 @@ type ProjectsSubscriptionsModifyAckDeadlineCall struct {
// modify the subscription-level `ackDeadlineSeconds` used for
// subsequent messages.
//
-// - subscription: The name of the subscription. Format is
-// `projects/{project}/subscriptions/{sub}`.
+// - subscription: The name of the subscription. Format is
+// `projects/{project}/subscriptions/{sub}`.
func (r *ProjectsSubscriptionsService) ModifyAckDeadline(subscription string, modifyackdeadlinerequest *ModifyAckDeadlineRequest) *ProjectsSubscriptionsModifyAckDeadlineCall {
c := &ProjectsSubscriptionsModifyAckDeadlineCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -6173,8 +6185,8 @@ type ProjectsSubscriptionsModifyPushConfigCall struct {
// Messages will accumulate for delivery continuously through the call
// regardless of changes to the `PushConfig`.
//
-// - subscription: The name of the subscription. Format is
-// `projects/{project}/subscriptions/{sub}`.
+// - subscription: The name of the subscription. Format is
+// `projects/{project}/subscriptions/{sub}`.
func (r *ProjectsSubscriptionsService) ModifyPushConfig(subscription string, modifypushconfigrequest *ModifyPushConfigRequest) *ProjectsSubscriptionsModifyPushConfigCall {
c := &ProjectsSubscriptionsModifyPushConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -6318,13 +6330,13 @@ type ProjectsSubscriptionsPatchCall struct {
// Patch: Updates an existing subscription. Note that certain properties
// of a subscription, such as its topic, are not modifiable.
//
-// - name: The name of the subscription. It must have the format
-// "projects/{project}/subscriptions/{subscription}".
-// `{subscription}` must start with a letter, and contain only letters
-// (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`),
-// periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It
-// must be between 3 and 255 characters in length, and it must not
-// start with "goog".
+// - name: The name of the subscription. It must have the format
+// "projects/{project}/subscriptions/{subscription}".
+// `{subscription}` must start with a letter, and contain only letters
+// (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`),
+// periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It
+// must be between 3 and 255 characters in length, and it must not
+// start with "goog".
func (r *ProjectsSubscriptionsService) Patch(name string, updatesubscriptionrequest *UpdateSubscriptionRequest) *ProjectsSubscriptionsPatchCall {
c := &ProjectsSubscriptionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6467,8 +6479,8 @@ type ProjectsSubscriptionsPullCall struct {
// Pull: Pulls messages from the server.
//
-// - subscription: The subscription from which messages should be
-// pulled. Format is `projects/{project}/subscriptions/{sub}`.
+// - subscription: The subscription from which messages should be
+// pulled. Format is `projects/{project}/subscriptions/{sub}`.
func (r *ProjectsSubscriptionsService) Pull(subscription string, pullrequest *PullRequest) *ProjectsSubscriptionsPullCall {
c := &ProjectsSubscriptionsPullCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -6762,10 +6774,10 @@ type ProjectsSubscriptionsSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSubscriptionsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsSubscriptionsSetIamPolicyCall {
c := &ProjectsSubscriptionsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6913,10 +6925,10 @@ type ProjectsSubscriptionsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSubscriptionsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsSubscriptionsTestIamPermissionsCall {
c := &ProjectsSubscriptionsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7061,12 +7073,12 @@ type ProjectsTopicsCreateCall struct {
// [resource name rules]
// (https://cloud.google.com/pubsub/docs/admin#resource_names).
//
-// - name: The name of the topic. It must have the format
-// "projects/{project}/topics/{topic}". `{topic}` must start with a
-// letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
-// dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus
-// (`+`) or percent signs (`%`). It must be between 3 and 255
-// characters in length, and it must not start with "goog".
+// - name: The name of the topic. It must have the format
+// "projects/{project}/topics/{topic}". `{topic}` must start with a
+// letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
+// dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus
+// (`+`) or percent signs (`%`). It must be between 3 and 255
+// characters in length, and it must not start with "goog".
func (r *ProjectsTopicsService) Create(name string, topic *Topic) *ProjectsTopicsCreateCall {
c := &ProjectsTopicsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7213,8 +7225,8 @@ type ProjectsTopicsDeleteCall struct {
// subscriptions to this topic are not deleted, but their `topic` field
// is set to `_deleted-topic_`.
//
-// - topic: Name of the topic to delete. Format is
-// `projects/{project}/topics/{topic}`.
+// - topic: Name of the topic to delete. Format is
+// `projects/{project}/topics/{topic}`.
func (r *ProjectsTopicsService) Delete(topic string) *ProjectsTopicsDeleteCall {
c := &ProjectsTopicsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.topic = topic
@@ -7348,8 +7360,8 @@ type ProjectsTopicsGetCall struct {
// Get: Gets the configuration of a topic.
//
-// - topic: The name of the topic to get. Format is
-// `projects/{project}/topics/{topic}`.
+// - topic: The name of the topic to get. Format is
+// `projects/{project}/topics/{topic}`.
func (r *ProjectsTopicsService) Get(topic string) *ProjectsTopicsGetCall {
c := &ProjectsTopicsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.topic = topic
@@ -7498,10 +7510,10 @@ type ProjectsTopicsGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsTopicsService) GetIamPolicy(resource string) *ProjectsTopicsGetIamPolicyCall {
c := &ProjectsTopicsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7672,8 +7684,8 @@ type ProjectsTopicsListCall struct {
// List: Lists matching topics.
//
-// - project: The name of the project in which to list topics. Format is
-// `projects/{project-id}`.
+// - project: The name of the project in which to list topics. Format is
+// `projects/{project-id}`.
func (r *ProjectsTopicsService) List(project string) *ProjectsTopicsListCall {
c := &ProjectsTopicsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7869,12 +7881,12 @@ type ProjectsTopicsPatchCall struct {
// Patch: Updates an existing topic. Note that certain properties of a
// topic are not modifiable.
//
-// - name: The name of the topic. It must have the format
-// "projects/{project}/topics/{topic}". `{topic}` must start with a
-// letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
-// dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus
-// (`+`) or percent signs (`%`). It must be between 3 and 255
-// characters in length, and it must not start with "goog".
+// - name: The name of the topic. It must have the format
+// "projects/{project}/topics/{topic}". `{topic}` must start with a
+// letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
+// dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus
+// (`+`) or percent signs (`%`). It must be between 3 and 255
+// characters in length, and it must not start with "goog".
func (r *ProjectsTopicsService) Patch(name string, updatetopicrequest *UpdateTopicRequest) *ProjectsTopicsPatchCall {
c := &ProjectsTopicsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8018,8 +8030,8 @@ type ProjectsTopicsPublishCall struct {
// Publish: Adds one or more messages to the topic. Returns `NOT_FOUND`
// if the topic does not exist.
//
-// - topic: The messages in the request will be published on this topic.
-// Format is `projects/{project}/topics/{topic}`.
+// - topic: The messages in the request will be published on this topic.
+// Format is `projects/{project}/topics/{topic}`.
func (r *ProjectsTopicsService) Publish(topic string, publishrequest *PublishRequest) *ProjectsTopicsPublishCall {
c := &ProjectsTopicsPublishCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.topic = topic
@@ -8164,10 +8176,10 @@ type ProjectsTopicsSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsTopicsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsTopicsSetIamPolicyCall {
c := &ProjectsTopicsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -8315,10 +8327,10 @@ type ProjectsTopicsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsTopicsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsTopicsTestIamPermissionsCall {
c := &ProjectsTopicsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -8465,8 +8477,8 @@ type ProjectsTopicsSnapshotsListCall struct {
// bulk. That is, you can set the acknowledgment state of messages in an
// existing subscription to the state captured by a snapshot.
//
-// - topic: The name of the topic that snapshots are attached to. Format
-// is `projects/{project}/topics/{topic}`.
+// - topic: The name of the topic that snapshots are attached to. Format
+// is `projects/{project}/topics/{topic}`.
func (r *ProjectsTopicsSnapshotsService) List(topic string) *ProjectsTopicsSnapshotsListCall {
c := &ProjectsTopicsSnapshotsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.topic = topic
@@ -8661,8 +8673,8 @@ type ProjectsTopicsSubscriptionsListCall struct {
// List: Lists the names of the attached subscriptions on this topic.
//
-// - topic: The name of the topic that subscriptions are attached to.
-// Format is `projects/{project}/topics/{topic}`.
+// - topic: The name of the topic that subscriptions are attached to.
+// Format is `projects/{project}/topics/{topic}`.
func (r *ProjectsTopicsSubscriptionsService) List(topic string) *ProjectsTopicsSubscriptionsListCall {
c := &ProjectsTopicsSubscriptionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.topic = topic
diff --git a/pubsub/v1beta1a/pubsub-gen.go b/pubsub/v1beta1a/pubsub-gen.go
index d85a2473fb3..148db8b965b 100644
--- a/pubsub/v1beta1a/pubsub-gen.go
+++ b/pubsub/v1beta1a/pubsub-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/pubsub/docs
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/pubsub/v1beta1a"
-// ...
-// ctx := context.Background()
-// pubsubService, err := pubsub.NewService(ctx)
+// import "google.golang.org/api/pubsub/v1beta1a"
+// ...
+// ctx := context.Background()
+// pubsubService, err := pubsub.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// pubsubService, err := pubsub.NewService(ctx, option.WithScopes(pubsub.PubsubScope))
+// pubsubService, err := pubsub.NewService(ctx, option.WithScopes(pubsub.PubsubScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// pubsubService, err := pubsub.NewService(ctx, option.WithAPIKey("AIza..."))
+// pubsubService, err := pubsub.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// pubsubService, err := pubsub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// pubsubService, err := pubsub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package pubsub // import "google.golang.org/api/pubsub/v1beta1a"
diff --git a/pubsub/v1beta2/pubsub-api.json b/pubsub/v1beta2/pubsub-api.json
index d0d48179205..8e8877fa74c 100644
--- a/pubsub/v1beta2/pubsub-api.json
+++ b/pubsub/v1beta2/pubsub-api.json
@@ -724,7 +724,7 @@
}
}
},
- "revision": "20220502",
+ "revision": "20220808",
"rootUrl": "https://pubsub.googleapis.com/",
"schemas": {
"AcknowledgeRequest": {
@@ -750,7 +750,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/pubsub/v1beta2/pubsub-gen.go b/pubsub/v1beta2/pubsub-gen.go
index 3a96744df1a..b4fd4c08828 100644
--- a/pubsub/v1beta2/pubsub-gen.go
+++ b/pubsub/v1beta2/pubsub-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/pubsub/docs
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/pubsub/v1beta2"
-// ...
-// ctx := context.Background()
-// pubsubService, err := pubsub.NewService(ctx)
+// import "google.golang.org/api/pubsub/v1beta2"
+// ...
+// ctx := context.Background()
+// pubsubService, err := pubsub.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// pubsubService, err := pubsub.NewService(ctx, option.WithScopes(pubsub.PubsubScope))
+// pubsubService, err := pubsub.NewService(ctx, option.WithScopes(pubsub.PubsubScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// pubsubService, err := pubsub.NewService(ctx, option.WithAPIKey("AIza..."))
+// pubsubService, err := pubsub.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// pubsubService, err := pubsub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// pubsubService, err := pubsub.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package pubsub // import "google.golang.org/api/pubsub/v1beta2"
@@ -242,16 +242,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1331,13 +1335,13 @@ type ProjectsSubscriptionsCreateCall struct {
// subscription on the same project as the topic. Note that for REST API
// requests, you must specify a name.
//
-// - name: The name of the subscription. It must have the format
-// "projects/{project}/subscriptions/{subscription}".
-// `{subscription}` must start with a letter, and contain only letters
-// (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`),
-// periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It
-// must be between 3 and 255 characters in length, and it must not
-// start with "goog".
+// - name: The name of the subscription. It must have the format
+// "projects/{project}/subscriptions/{subscription}".
+// `{subscription}` must start with a letter, and contain only letters
+// (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`),
+// periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It
+// must be between 3 and 255 characters in length, and it must not
+// start with "goog".
func (r *ProjectsSubscriptionsService) Create(name string, subscription *Subscription) *ProjectsSubscriptionsCreateCall {
c := &ProjectsSubscriptionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1767,10 +1771,10 @@ type ProjectsSubscriptionsGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSubscriptionsService) GetIamPolicy(resource string) *ProjectsSubscriptionsGetIamPolicyCall {
c := &ProjectsSubscriptionsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -1941,8 +1945,8 @@ type ProjectsSubscriptionsListCall struct {
// List: Lists matching subscriptions.
//
-// - project: The name of the cloud project that subscriptions belong
-// to.
+// - project: The name of the cloud project that subscriptions belong
+// to.
func (r *ProjectsSubscriptionsService) List(project string) *ProjectsSubscriptionsListCall {
c := &ProjectsSubscriptionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -2436,8 +2440,8 @@ type ProjectsSubscriptionsPullCall struct {
// `UNAVAILABLE` if there are too many concurrent pull requests pending
// for the given subscription.
//
-// - subscription: The subscription from which messages should be
-// pulled.
+// - subscription: The subscription from which messages should be
+// pulled.
func (r *ProjectsSubscriptionsService) Pull(subscription string, pullrequest *PullRequest) *ProjectsSubscriptionsPullCall {
c := &ProjectsSubscriptionsPullCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.subscription = subscription
@@ -2582,10 +2586,10 @@ type ProjectsSubscriptionsSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSubscriptionsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsSubscriptionsSetIamPolicyCall {
c := &ProjectsSubscriptionsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2733,10 +2737,10 @@ type ProjectsSubscriptionsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSubscriptionsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsSubscriptionsTestIamPermissionsCall {
c := &ProjectsSubscriptionsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2879,12 +2883,12 @@ type ProjectsTopicsCreateCall struct {
// Create: Creates the given topic with the given name.
//
-// - name: The name of the topic. It must have the format
-// "projects/{project}/topics/{topic}". `{topic}` must start with a
-// letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
-// dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus
-// (`+`) or percent signs (`%`). It must be between 3 and 255
-// characters in length, and it must not start with "goog".
+// - name: The name of the topic. It must have the format
+// "projects/{project}/topics/{topic}". `{topic}` must start with a
+// letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
+// dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus
+// (`+`) or percent signs (`%`). It must be between 3 and 255
+// characters in length, and it must not start with "goog".
func (r *ProjectsTopicsService) Create(name string, topic *Topic) *ProjectsTopicsCreateCall {
c := &ProjectsTopicsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3314,10 +3318,10 @@ type ProjectsTopicsGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsTopicsService) GetIamPolicy(resource string) *ProjectsTopicsGetIamPolicyCall {
c := &ProjectsTopicsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3831,10 +3835,10 @@ type ProjectsTopicsSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsTopicsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsTopicsSetIamPolicyCall {
c := &ProjectsTopicsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3982,10 +3986,10 @@ type ProjectsTopicsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsTopicsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsTopicsTestIamPermissionsCall {
c := &ProjectsTopicsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
diff --git a/pubsublite/v1/pubsublite-gen.go b/pubsublite/v1/pubsublite-gen.go
index 91ca9d22947..6e768d314f6 100644
--- a/pubsublite/v1/pubsublite-gen.go
+++ b/pubsublite/v1/pubsublite-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/pubsub/lite/docs
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/pubsublite/v1"
-// ...
-// ctx := context.Background()
-// pubsubliteService, err := pubsublite.NewService(ctx)
+// import "google.golang.org/api/pubsublite/v1"
+// ...
+// ctx := context.Background()
+// pubsubliteService, err := pubsublite.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// pubsubliteService, err := pubsublite.NewService(ctx, option.WithAPIKey("AIza..."))
+// pubsubliteService, err := pubsublite.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// pubsubliteService, err := pubsublite.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// pubsubliteService, err := pubsublite.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package pubsublite // import "google.golang.org/api/pubsublite/v1"
@@ -2188,8 +2188,8 @@ type AdminProjectsLocationsReservationsCreateCall struct {
// Create: Creates a new reservation.
//
-// - parent: The parent location in which to create the reservation.
-// Structured like `projects/{project_number}/locations/{location}`.
+// - parent: The parent location in which to create the reservation.
+// Structured like `projects/{project_number}/locations/{location}`.
func (r *AdminProjectsLocationsReservationsService) Create(parent string, reservation *Reservation) *AdminProjectsLocationsReservationsCreateCall {
c := &AdminProjectsLocationsReservationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2344,9 +2344,9 @@ type AdminProjectsLocationsReservationsDeleteCall struct {
// Delete: Deletes the specified reservation.
//
-// - name: The name of the reservation to delete. Structured like:
-// projects/{project_number}/locations/{location}/reservations/{reserva
-// tion_id}.
+// - name: The name of the reservation to delete. Structured like:
+// projects/{project_number}/locations/{location}/reservations/{reserva
+// tion_id}.
func (r *AdminProjectsLocationsReservationsService) Delete(name string) *AdminProjectsLocationsReservationsDeleteCall {
c := &AdminProjectsLocationsReservationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2479,10 +2479,10 @@ type AdminProjectsLocationsReservationsGetCall struct {
// Get: Returns the reservation configuration.
//
-// - name: The name of the reservation whose configuration to return.
-// Structured like:
-// projects/{project_number}/locations/{location}/reservations/{reserva
-// tion_id}.
+// - name: The name of the reservation whose configuration to return.
+// Structured like:
+// projects/{project_number}/locations/{location}/reservations/{reserva
+// tion_id}.
func (r *AdminProjectsLocationsReservationsService) Get(name string) *AdminProjectsLocationsReservationsGetCall {
c := &AdminProjectsLocationsReservationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2628,8 +2628,8 @@ type AdminProjectsLocationsReservationsListCall struct {
// List: Returns the list of reservations for the given project.
//
-// - parent: The parent whose reservations are to be listed. Structured
-// like `projects/{project_number}/locations/{location}`.
+// - parent: The parent whose reservations are to be listed. Structured
+// like `projects/{project_number}/locations/{location}`.
func (r *AdminProjectsLocationsReservationsService) List(parent string) *AdminProjectsLocationsReservationsListCall {
c := &AdminProjectsLocationsReservationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2826,9 +2826,9 @@ type AdminProjectsLocationsReservationsPatchCall struct {
// Patch: Updates properties of the specified reservation.
//
-// - name: The name of the reservation. Structured like:
-// projects/{project_number}/locations/{location}/reservations/{reserva
-// tion_id}.
+// - name: The name of the reservation. Structured like:
+// projects/{project_number}/locations/{location}/reservations/{reserva
+// tion_id}.
func (r *AdminProjectsLocationsReservationsService) Patch(name string, reservation *Reservation) *AdminProjectsLocationsReservationsPatchCall {
c := &AdminProjectsLocationsReservationsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2983,10 +2983,10 @@ type AdminProjectsLocationsReservationsTopicsListCall struct {
// List: Lists the topics attached to the specified reservation.
//
-// - name: The name of the reservation whose topics to list. Structured
-// like:
-// projects/{project_number}/locations/{location}/reservations/{reserva
-// tion_id}.
+// - name: The name of the reservation whose topics to list. Structured
+// like:
+// projects/{project_number}/locations/{location}/reservations/{reserva
+// tion_id}.
func (r *AdminProjectsLocationsReservationsTopicsService) List(name string) *AdminProjectsLocationsReservationsTopicsListCall {
c := &AdminProjectsLocationsReservationsTopicsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3182,8 +3182,8 @@ type AdminProjectsLocationsSubscriptionsCreateCall struct {
// Create: Creates a new subscription.
//
-// - parent: The parent location in which to create the subscription.
-// Structured like `projects/{project_number}/locations/{location}`.
+// - parent: The parent location in which to create the subscription.
+// Structured like `projects/{project_number}/locations/{location}`.
func (r *AdminProjectsLocationsSubscriptionsService) Create(parent string, subscription *Subscription) *AdminProjectsLocationsSubscriptionsCreateCall {
c := &AdminProjectsLocationsSubscriptionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3631,8 +3631,8 @@ type AdminProjectsLocationsSubscriptionsListCall struct {
// List: Returns the list of subscriptions for the given project.
//
-// - parent: The parent whose subscriptions are to be listed. Structured
-// like `projects/{project_number}/locations/{location}`.
+// - parent: The parent whose subscriptions are to be listed. Structured
+// like `projects/{project_number}/locations/{location}`.
func (r *AdminProjectsLocationsSubscriptionsService) List(parent string) *AdminProjectsLocationsSubscriptionsListCall {
c := &AdminProjectsLocationsSubscriptionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3829,9 +3829,9 @@ type AdminProjectsLocationsSubscriptionsPatchCall struct {
// Patch: Updates properties of the specified subscription.
//
-// - name: The name of the subscription. Structured like:
-// projects/{project_number}/locations/{location}/subscriptions/{subscr
-// iption_id}.
+// - name: The name of the subscription. Structured like:
+// projects/{project_number}/locations/{location}/subscriptions/{subscr
+// iption_id}.
func (r *AdminProjectsLocationsSubscriptionsService) Patch(name string, subscription *Subscription) *AdminProjectsLocationsSubscriptionsPatchCall {
c := &AdminProjectsLocationsSubscriptionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4144,8 +4144,8 @@ type AdminProjectsLocationsTopicsCreateCall struct {
// Create: Creates a new topic.
//
-// - parent: The parent location in which to create the topic.
-// Structured like `projects/{project_number}/locations/{location}`.
+// - parent: The parent location in which to create the topic.
+// Structured like `projects/{project_number}/locations/{location}`.
func (r *AdminProjectsLocationsTopicsService) Create(parent string, topic *Topic) *AdminProjectsLocationsTopicsCreateCall {
c := &AdminProjectsLocationsTopicsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4725,8 +4725,8 @@ type AdminProjectsLocationsTopicsListCall struct {
// List: Returns the list of topics for the given project.
//
-// - parent: The parent whose topics are to be listed. Structured like
-// `projects/{project_number}/locations/{location}`.
+// - parent: The parent whose topics are to be listed. Structured like
+// `projects/{project_number}/locations/{location}`.
func (r *AdminProjectsLocationsTopicsService) List(parent string) *AdminProjectsLocationsTopicsListCall {
c := &AdminProjectsLocationsTopicsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4921,8 +4921,8 @@ type AdminProjectsLocationsTopicsPatchCall struct {
// Patch: Updates properties of the specified topic.
//
-// - name: The name of the topic. Structured like:
-// projects/{project_number}/locations/{location}/topics/{topic_id}.
+// - name: The name of the topic. Structured like:
+// projects/{project_number}/locations/{location}/topics/{topic_id}.
func (r *AdminProjectsLocationsTopicsService) Patch(name string, topic *Topic) *AdminProjectsLocationsTopicsPatchCall {
c := &AdminProjectsLocationsTopicsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5416,10 +5416,10 @@ type CursorProjectsLocationsSubscriptionsCursorsListCall struct {
// List: Returns all committed cursor information for a subscription.
//
-// - parent: The subscription for which to retrieve cursors. Structured
-// like
-// `projects/{project_number}/locations/{location}/subscriptions/{subsc
-// ription_id}`.
+// - parent: The subscription for which to retrieve cursors. Structured
+// like
+// `projects/{project_number}/locations/{location}/subscriptions/{subsc
+// ription_id}`.
func (r *CursorProjectsLocationsSubscriptionsCursorsService) List(parent string) *CursorProjectsLocationsSubscriptionsCursorsListCall {
c := &CursorProjectsLocationsSubscriptionsCursorsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/qpxexpress/v1/qpxexpress-gen.go b/qpxexpress/v1/qpxexpress-gen.go
index 333071de776..2b056be0fc9 100644
--- a/qpxexpress/v1/qpxexpress-gen.go
+++ b/qpxexpress/v1/qpxexpress-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: http://developers.google.com/qpx-express
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/qpxexpress/v1"
-// ...
-// ctx := context.Background()
-// qpxexpressService, err := qpxexpress.NewService(ctx)
+// import "google.golang.org/api/qpxexpress/v1"
+// ...
+// ctx := context.Background()
+// qpxexpressService, err := qpxexpress.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// qpxexpressService, err := qpxexpress.NewService(ctx, option.WithAPIKey("AIza..."))
+// qpxexpressService, err := qpxexpress.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// qpxexpressService, err := qpxexpress.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// qpxexpressService, err := qpxexpress.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package qpxexpress // import "google.golang.org/api/qpxexpress/v1"
diff --git a/realtimebidding/v1/realtimebidding-api.json b/realtimebidding/v1/realtimebidding-api.json
index 1f940f93238..f237474461b 100644
--- a/realtimebidding/v1/realtimebidding-api.json
+++ b/realtimebidding/v1/realtimebidding-api.json
@@ -1305,7 +1305,7 @@
}
}
},
- "revision": "20220608",
+ "revision": "20220802",
"rootUrl": "https://realtimebidding.googleapis.com/",
"schemas": {
"ActivatePretargetingConfigRequest": {
@@ -1820,7 +1820,7 @@
"type": "array"
},
"version": {
- "description": "Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates.",
+ "description": "Output only. The version of the creative. Version for a new creative is 1 and it increments during subsequent creative updates.",
"format": "int32",
"readOnly": true,
"type": "integer"
diff --git a/realtimebidding/v1/realtimebidding-gen.go b/realtimebidding/v1/realtimebidding-gen.go
index b0add925252..f7e6482a973 100644
--- a/realtimebidding/v1/realtimebidding-gen.go
+++ b/realtimebidding/v1/realtimebidding-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/realtimebidding/v1"
-// ...
-// ctx := context.Background()
-// realtimebiddingService, err := realtimebidding.NewService(ctx)
+// import "google.golang.org/api/realtimebidding/v1"
+// ...
+// ctx := context.Background()
+// realtimebiddingService, err := realtimebidding.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithAPIKey("AIza..."))
+// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package realtimebidding // import "google.golang.org/api/realtimebidding/v1"
@@ -967,7 +967,7 @@ type Creative struct {
// "ALCOHOL" - The alcohol restricted category.
RestrictedCategories []string `json:"restrictedCategories,omitempty"`
- // Version: Output only. The version of this creative. Version for a new
+ // Version: Output only. The version of the creative. Version for a new
// creative is 1 and it increments during subsequent creative updates.
Version int64 `json:"version,omitempty"`
@@ -3123,8 +3123,8 @@ type BiddersGetCall struct {
// Get: Gets a bidder account by its name.
//
-// - name: Name of the bidder to get. Format:
-// `bidders/{bidderAccountId}`.
+// - name: Name of the bidder to get. Format:
+// `bidders/{bidderAccountId}`.
func (r *BiddersService) Get(name string) *BiddersGetCall {
c := &BiddersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3456,19 +3456,19 @@ type BiddersCreativesListCall struct {
// pages. We recommend Google Cloud Pub/Sub
// (//cloud.google.com/pubsub/docs/overview) to view the latest status.
//
-// - parent: Name of the parent buyer that owns the creatives. The
-// pattern for this resource is either `buyers/{buyerAccountId}` or
-// `bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the
-// `buyerAccountId` can be one of the following: 1. The ID of the
-// buyer that is accessing their own creatives. 2. The ID of the child
-// seat buyer under a bidder account. So for listing creatives
-// pertaining to the child seat buyer (`456`) under bidder account
-// (`123`), you would use the pattern: `buyers/456`. 3. The ID of the
-// bidder itself. So for listing creatives pertaining to bidder
-// (`123`), you would use `buyers/123`. If you want to access all
-// creatives pertaining to both the bidder and all of its child seat
-// accounts, you would use `bidders/{bidderAccountId}`, e.g., for all
-// creatives pertaining to bidder (`123`), use `bidders/123`.
+// - parent: Name of the parent buyer that owns the creatives. The
+// pattern for this resource is either `buyers/{buyerAccountId}` or
+// `bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the
+// `buyerAccountId` can be one of the following: 1. The ID of the
+// buyer that is accessing their own creatives. 2. The ID of the child
+// seat buyer under a bidder account. So for listing creatives
+// pertaining to the child seat buyer (`456`) under bidder account
+// (`123`), you would use the pattern: `buyers/456`. 3. The ID of the
+// bidder itself. So for listing creatives pertaining to bidder
+// (`123`), you would use `buyers/123`. If you want to access all
+// creatives pertaining to both the bidder and all of its child seat
+// accounts, you would use `bidders/{bidderAccountId}`, e.g., for all
+// creatives pertaining to bidder (`123`), use `bidders/123`.
func (r *BiddersCreativesService) List(parent string) *BiddersCreativesListCall {
c := &BiddersCreativesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3513,11 +3513,17 @@ func (c *BiddersCreativesListCall) PageToken(pageToken string) *BiddersCreatives
// specify the view as "FULL".
//
// Possible values:
-// "CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to
+//
+// "CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to
+//
// SERVING_DECISION_ONLY.
-// "SERVING_DECISION_ONLY" - Only creativeServingDecision is included
+//
+// "SERVING_DECISION_ONLY" - Only creativeServingDecision is included
+//
// in the response.
-// "FULL" - The entire creative resource (including the declared
+//
+// "FULL" - The entire creative resource (including the declared
+//
// fields and the creative content) is included in the response.
func (c *BiddersCreativesListCall) View(view string) *BiddersCreativesListCall {
c.urlParams_.Set("view", view)
@@ -3721,9 +3727,9 @@ type BiddersCreativesWatchCall struct {
// invocations of this method will return the existing Pub/Sub
// configuration.
//
-// - parent: To watch all creatives pertaining to the bidder and all its
-// child seat accounts, the bidder must follow the pattern
-// `bidders/{bidderAccountId}`.
+// - parent: To watch all creatives pertaining to the bidder and all its
+// child seat accounts, the bidder must follow the pattern
+// `bidders/{bidderAccountId}`.
func (r *BiddersCreativesService) Watch(parent string, watchcreativesrequest *WatchCreativesRequest) *BiddersCreativesWatchCall {
c := &BiddersCreativesWatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3865,8 +3871,8 @@ type BiddersEndpointsGetCall struct {
// Get: Gets a bidder endpoint by its name.
//
-// - name: Name of the bidder endpoint to get. Format:
-// `bidders/{bidderAccountId}/endpoints/{endpointId}`.
+// - name: Name of the bidder endpoint to get. Format:
+// `bidders/{bidderAccountId}/endpoints/{endpointId}`.
func (r *BiddersEndpointsService) Get(name string) *BiddersEndpointsGetCall {
c := &BiddersEndpointsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4012,8 +4018,8 @@ type BiddersEndpointsListCall struct {
// List: Lists all the bidder's endpoints.
//
-// - parent: Name of the bidder whose endpoints will be listed. Format:
-// `bidders/{bidderAccountId}`.
+// - parent: Name of the bidder whose endpoints will be listed. Format:
+// `bidders/{bidderAccountId}`.
func (r *BiddersEndpointsService) List(parent string) *BiddersEndpointsListCall {
c := &BiddersEndpointsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4209,11 +4215,11 @@ type BiddersEndpointsPatchCall struct {
// Patch: Updates a bidder's endpoint.
//
-// - name: Output only. Name of the endpoint resource that must follow
-// the pattern `bidders/{bidderAccountId}/endpoints/{endpointId}`,
-// where {bidderAccountId} is the account ID of the bidder who
-// operates this endpoint, and {endpointId} is a unique ID assigned by
-// the server.
+// - name: Output only. Name of the endpoint resource that must follow
+// the pattern `bidders/{bidderAccountId}/endpoints/{endpointId}`,
+// where {bidderAccountId} is the account ID of the bidder who
+// operates this endpoint, and {endpointId} is a unique ID assigned by
+// the server.
func (r *BiddersEndpointsService) Patch(name string, endpoint *Endpoint) *BiddersEndpointsPatchCall {
c := &BiddersEndpointsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4368,8 +4374,8 @@ type BiddersPretargetingConfigsActivateCall struct {
// Activate: Activates a pretargeting configuration.
//
-// - name: The name of the pretargeting configuration. Format:
-// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - name: The name of the pretargeting configuration. Format:
+// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) Activate(name string, activatepretargetingconfigrequest *ActivatePretargetingConfigRequest) *BiddersPretargetingConfigsActivateCall {
c := &BiddersPretargetingConfigsActivateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4512,8 +4518,8 @@ type BiddersPretargetingConfigsAddTargetedAppsCall struct {
// AddTargetedApps: Adds targeted apps to the pretargeting
// configuration.
//
-// - pretargetingConfig: The name of the pretargeting configuration.
-// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - pretargetingConfig: The name of the pretargeting configuration.
+// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) AddTargetedApps(pretargetingConfig string, addtargetedappsrequest *AddTargetedAppsRequest) *BiddersPretargetingConfigsAddTargetedAppsCall {
c := &BiddersPretargetingConfigsAddTargetedAppsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.pretargetingConfig = pretargetingConfig
@@ -4656,8 +4662,8 @@ type BiddersPretargetingConfigsAddTargetedPublishersCall struct {
// AddTargetedPublishers: Adds targeted publishers to the pretargeting
// config.
//
-// - pretargetingConfig: The name of the pretargeting configuration.
-// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - pretargetingConfig: The name of the pretargeting configuration.
+// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) AddTargetedPublishers(pretargetingConfig string, addtargetedpublishersrequest *AddTargetedPublishersRequest) *BiddersPretargetingConfigsAddTargetedPublishersCall {
c := &BiddersPretargetingConfigsAddTargetedPublishersCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.pretargetingConfig = pretargetingConfig
@@ -4800,8 +4806,8 @@ type BiddersPretargetingConfigsAddTargetedSitesCall struct {
// AddTargetedSites: Adds targeted sites to the pretargeting
// configuration.
//
-// - pretargetingConfig: The name of the pretargeting configuration.
-// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - pretargetingConfig: The name of the pretargeting configuration.
+// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) AddTargetedSites(pretargetingConfig string, addtargetedsitesrequest *AddTargetedSitesRequest) *BiddersPretargetingConfigsAddTargetedSitesCall {
c := &BiddersPretargetingConfigsAddTargetedSitesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.pretargetingConfig = pretargetingConfig
@@ -4947,8 +4953,8 @@ type BiddersPretargetingConfigsCreateCall struct {
// may create a maximum of 10 pretargeting configurations. Attempts to
// exceed this maximum results in a 400 bad request error.
//
-// - parent: Name of the bidder to create the pretargeting configuration
-// for. Format: bidders/{bidderAccountId}.
+// - parent: Name of the bidder to create the pretargeting configuration
+// for. Format: bidders/{bidderAccountId}.
func (r *BiddersPretargetingConfigsService) Create(parent string, pretargetingconfig *PretargetingConfig) *BiddersPretargetingConfigsCreateCall {
c := &BiddersPretargetingConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5089,8 +5095,8 @@ type BiddersPretargetingConfigsDeleteCall struct {
// Delete: Deletes a pretargeting configuration.
//
-// - name: The name of the pretargeting configuration to delete. Format:
-// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - name: The name of the pretargeting configuration to delete. Format:
+// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) Delete(name string) *BiddersPretargetingConfigsDeleteCall {
c := &BiddersPretargetingConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5223,8 +5229,8 @@ type BiddersPretargetingConfigsGetCall struct {
// Get: Gets a pretargeting configuration.
//
-// - name: Name of the pretargeting configuration to get. Format:
-// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - name: Name of the pretargeting configuration to get. Format:
+// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) Get(name string) *BiddersPretargetingConfigsGetCall {
c := &BiddersPretargetingConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5370,8 +5376,8 @@ type BiddersPretargetingConfigsListCall struct {
// List: Lists all pretargeting configurations for a single bidder.
//
-// - parent: Name of the bidder whose pretargeting configurations will
-// be listed. Format: bidders/{bidderAccountId}.
+// - parent: Name of the bidder whose pretargeting configurations will
+// be listed. Format: bidders/{bidderAccountId}.
func (r *BiddersPretargetingConfigsService) List(parent string) *BiddersPretargetingConfigsListCall {
c := &BiddersPretargetingConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5567,9 +5573,9 @@ type BiddersPretargetingConfigsPatchCall struct {
// Patch: Updates a pretargeting configuration.
//
-// - name: Output only. Name of the pretargeting configuration that must
-// follow the pattern
-// `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`.
+// - name: Output only. Name of the pretargeting configuration that must
+// follow the pattern
+// `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`.
func (r *BiddersPretargetingConfigsService) Patch(name string, pretargetingconfig *PretargetingConfig) *BiddersPretargetingConfigsPatchCall {
c := &BiddersPretargetingConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5725,8 +5731,8 @@ type BiddersPretargetingConfigsRemoveTargetedAppsCall struct {
// RemoveTargetedApps: Removes targeted apps from the pretargeting
// configuration.
//
-// - pretargetingConfig: The name of the pretargeting configuration.
-// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - pretargetingConfig: The name of the pretargeting configuration.
+// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) RemoveTargetedApps(pretargetingConfig string, removetargetedappsrequest *RemoveTargetedAppsRequest) *BiddersPretargetingConfigsRemoveTargetedAppsCall {
c := &BiddersPretargetingConfigsRemoveTargetedAppsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.pretargetingConfig = pretargetingConfig
@@ -5869,8 +5875,8 @@ type BiddersPretargetingConfigsRemoveTargetedPublishersCall struct {
// RemoveTargetedPublishers: Removes targeted publishers from the
// pretargeting config.
//
-// - pretargetingConfig: The name of the pretargeting configuration.
-// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - pretargetingConfig: The name of the pretargeting configuration.
+// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) RemoveTargetedPublishers(pretargetingConfig string, removetargetedpublishersrequest *RemoveTargetedPublishersRequest) *BiddersPretargetingConfigsRemoveTargetedPublishersCall {
c := &BiddersPretargetingConfigsRemoveTargetedPublishersCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.pretargetingConfig = pretargetingConfig
@@ -6013,8 +6019,8 @@ type BiddersPretargetingConfigsRemoveTargetedSitesCall struct {
// RemoveTargetedSites: Removes targeted sites from the pretargeting
// configuration.
//
-// - pretargetingConfig: The name of the pretargeting configuration.
-// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - pretargetingConfig: The name of the pretargeting configuration.
+// Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) RemoveTargetedSites(pretargetingConfig string, removetargetedsitesrequest *RemoveTargetedSitesRequest) *BiddersPretargetingConfigsRemoveTargetedSitesCall {
c := &BiddersPretargetingConfigsRemoveTargetedSitesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.pretargetingConfig = pretargetingConfig
@@ -6156,8 +6162,8 @@ type BiddersPretargetingConfigsSuspendCall struct {
// Suspend: Suspends a pretargeting configuration.
//
-// - name: The name of the pretargeting configuration. Format:
-// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
+// - name: The name of the pretargeting configuration. Format:
+// bidders/{bidderAccountId}/pretargetingConfig/{configId}.
func (r *BiddersPretargetingConfigsService) Suspend(name string, suspendpretargetingconfigrequest *SuspendPretargetingConfigRequest) *BiddersPretargetingConfigsSuspendCall {
c := &BiddersPretargetingConfigsSuspendCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6299,9 +6305,9 @@ type BiddersPublisherConnectionsBatchApproveCall struct {
// BatchApprove: Batch approves multiple publisher connections.
//
-// - parent: The bidder for whom publisher connections will be approved.
-// Format: `bidders/{bidder}` where `{bidder}` is the account ID of
-// the bidder.
+// - parent: The bidder for whom publisher connections will be approved.
+// Format: `bidders/{bidder}` where `{bidder}` is the account ID of
+// the bidder.
func (r *BiddersPublisherConnectionsService) BatchApprove(parent string, batchapprovepublisherconnectionsrequest *BatchApprovePublisherConnectionsRequest) *BiddersPublisherConnectionsBatchApproveCall {
c := &BiddersPublisherConnectionsBatchApproveCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6445,9 +6451,9 @@ type BiddersPublisherConnectionsBatchRejectCall struct {
// BatchReject: Batch rejects multiple publisher connections.
//
-// - parent: The bidder for whom publisher connections will be rejected.
-// Format: `bidders/{bidder}` where `{bidder}` is the account ID of
-// the bidder.
+// - parent: The bidder for whom publisher connections will be rejected.
+// Format: `bidders/{bidder}` where `{bidder}` is the account ID of
+// the bidder.
func (r *BiddersPublisherConnectionsService) BatchReject(parent string, batchrejectpublisherconnectionsrequest *BatchRejectPublisherConnectionsRequest) *BiddersPublisherConnectionsBatchRejectCall {
c := &BiddersPublisherConnectionsBatchRejectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6590,11 +6596,11 @@ type BiddersPublisherConnectionsGetCall struct {
// Get: Gets a publisher connection.
//
-// - name: Name of the publisher whose connection information is to be
-// retrieved. In the pattern
-// `bidders/{bidder}/publisherConnections/{publisher}` where
-// `{bidder}` is the account ID of the bidder, and `{publisher}` is
-// the ads.txt/app-ads.txt publisher ID. See publisherConnection.name.
+// - name: Name of the publisher whose connection information is to be
+// retrieved. In the pattern
+// `bidders/{bidder}/publisherConnections/{publisher}` where
+// `{bidder}` is the account ID of the bidder, and `{publisher}` is
+// the ads.txt/app-ads.txt publisher ID. See publisherConnection.name.
func (r *BiddersPublisherConnectionsService) Get(name string) *BiddersPublisherConnectionsGetCall {
c := &BiddersPublisherConnectionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6740,9 +6746,9 @@ type BiddersPublisherConnectionsListCall struct {
// List: Lists publisher connections for a given bidder.
//
-// - parent: Name of the bidder for which publishers have initiated
-// connections. The pattern for this resource is `bidders/{bidder}`
-// where `{bidder}` represents the account ID of the bidder.
+// - parent: Name of the bidder for which publishers have initiated
+// connections. The pattern for this resource is `bidders/{bidder}`
+// where `{bidder}` represents the account ID of the bidder.
func (r *BiddersPublisherConnectionsService) List(parent string) *BiddersPublisherConnectionsListCall {
c := &BiddersPublisherConnectionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7120,14 +7126,14 @@ type BuyersGetRemarketingTagCall struct {
// When a user visits a page containing a remarketing tag, Google adds
// the user to a user list.
//
-// - name: To fetch remarketing tag for an account, name must follow the
-// pattern `buyers/{accountId}` where `{accountId}` represents ID of a
-// buyer that owns the remarketing tag. For a bidder accessing
-// remarketing tag on behalf of a child seat buyer, `{accountId}`
-// should represent the ID of the child seat buyer. To fetch
-// remarketing tag for a specific user list, name must follow the
-// pattern `buyers/{accountId}/userLists/{userListId}`. See
-// UserList.name.
+// - name: To fetch remarketing tag for an account, name must follow the
+// pattern `buyers/{accountId}` where `{accountId}` represents ID of a
+// buyer that owns the remarketing tag. For a bidder accessing
+// remarketing tag on behalf of a child seat buyer, `{accountId}`
+// should represent the ID of the child seat buyer. To fetch
+// remarketing tag for a specific user list, name must follow the
+// pattern `buyers/{accountId}/userLists/{userListId}`. See
+// UserList.name.
func (r *BuyersService) GetRemarketingTag(name string) *BuyersGetRemarketingTagCall {
c := &BuyersGetRemarketingTagCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7454,12 +7460,12 @@ type BuyersCreativesCreateCall struct {
// Create: Creates a creative.
//
-// - parent: The name of the parent buyer that the new creative belongs
-// to that must follow the pattern `buyers/{buyerAccountId}`, where
-// `{buyerAccountId}` represents the account ID of the buyer who owns
-// a creative. For a bidder accessing creatives on behalf of a child
-// seat buyer, `{buyerAccountId}` should represent the account ID of
-// the child seat buyer.
+// - parent: The name of the parent buyer that the new creative belongs
+// to that must follow the pattern `buyers/{buyerAccountId}`, where
+// `{buyerAccountId}` represents the account ID of the buyer who owns
+// a creative. For a bidder accessing creatives on behalf of a child
+// seat buyer, `{buyerAccountId}` should represent the account ID of
+// the child seat buyer.
func (r *BuyersCreativesService) Create(parent string, creative *Creative) *BuyersCreativesCreateCall {
c := &BuyersCreativesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7615,11 +7621,17 @@ func (r *BuyersCreativesService) Get(name string) *BuyersCreativesGetCall {
// specify the view as "FULL".
//
// Possible values:
-// "CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to
+//
+// "CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to
+//
// SERVING_DECISION_ONLY.
-// "SERVING_DECISION_ONLY" - Only creativeServingDecision is included
+//
+// "SERVING_DECISION_ONLY" - Only creativeServingDecision is included
+//
// in the response.
-// "FULL" - The entire creative resource (including the declared
+//
+// "FULL" - The entire creative resource (including the declared
+//
// fields and the creative content) is included in the response.
func (c *BuyersCreativesGetCall) View(view string) *BuyersCreativesGetCall {
c.urlParams_.Set("view", view)
@@ -7786,19 +7798,19 @@ type BuyersCreativesListCall struct {
// pages. We recommend Google Cloud Pub/Sub
// (//cloud.google.com/pubsub/docs/overview) to view the latest status.
//
-// - parent: Name of the parent buyer that owns the creatives. The
-// pattern for this resource is either `buyers/{buyerAccountId}` or
-// `bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the
-// `buyerAccountId` can be one of the following: 1. The ID of the
-// buyer that is accessing their own creatives. 2. The ID of the child
-// seat buyer under a bidder account. So for listing creatives
-// pertaining to the child seat buyer (`456`) under bidder account
-// (`123`), you would use the pattern: `buyers/456`. 3. The ID of the
-// bidder itself. So for listing creatives pertaining to bidder
-// (`123`), you would use `buyers/123`. If you want to access all
-// creatives pertaining to both the bidder and all of its child seat
-// accounts, you would use `bidders/{bidderAccountId}`, e.g., for all
-// creatives pertaining to bidder (`123`), use `bidders/123`.
+// - parent: Name of the parent buyer that owns the creatives. The
+// pattern for this resource is either `buyers/{buyerAccountId}` or
+// `bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the
+// `buyerAccountId` can be one of the following: 1. The ID of the
+// buyer that is accessing their own creatives. 2. The ID of the child
+// seat buyer under a bidder account. So for listing creatives
+// pertaining to the child seat buyer (`456`) under bidder account
+// (`123`), you would use the pattern: `buyers/456`. 3. The ID of the
+// bidder itself. So for listing creatives pertaining to bidder
+// (`123`), you would use `buyers/123`. If you want to access all
+// creatives pertaining to both the bidder and all of its child seat
+// accounts, you would use `bidders/{bidderAccountId}`, e.g., for all
+// creatives pertaining to bidder (`123`), use `bidders/123`.
func (r *BuyersCreativesService) List(parent string) *BuyersCreativesListCall {
c := &BuyersCreativesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7843,11 +7855,17 @@ func (c *BuyersCreativesListCall) PageToken(pageToken string) *BuyersCreativesLi
// specify the view as "FULL".
//
// Possible values:
-// "CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to
+//
+// "CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to
+//
// SERVING_DECISION_ONLY.
-// "SERVING_DECISION_ONLY" - Only creativeServingDecision is included
+//
+// "SERVING_DECISION_ONLY" - Only creativeServingDecision is included
+//
// in the response.
-// "FULL" - The entire creative resource (including the declared
+//
+// "FULL" - The entire creative resource (including the declared
+//
// fields and the creative content) is included in the response.
func (c *BuyersCreativesListCall) View(view string) *BuyersCreativesListCall {
c.urlParams_.Set("view", view)
@@ -8045,11 +8063,11 @@ type BuyersCreativesPatchCall struct {
// Patch: Updates a creative.
//
-// - name: Output only. Name of the creative. Follows the pattern
-// `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents
-// the account ID of the buyer who owns the creative, and `{creative}`
-// is the buyer-specific creative ID that references this creative in
-// the bid response.
+// - name: Output only. Name of the creative. Follows the pattern
+// `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents
+// the account ID of the buyer who owns the creative, and `{creative}`
+// is the buyer-specific creative ID that references this creative in
+// the bid response.
func (r *BuyersCreativesService) Patch(name string, creative *Creative) *BuyersCreativesPatchCall {
c := &BuyersCreativesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8347,12 +8365,12 @@ type BuyersUserListsCreateCall struct {
// Create: Create a new user list.
//
-// - parent: The name of the parent buyer of the user list to be
-// retrieved that must follow the pattern `buyers/{buyerAccountId}`,
-// where `{buyerAccountId}` represents the account ID of the buyer who
-// owns user lists. For a bidder accessing user lists on behalf of a
-// child seat buyer , `{buyerAccountId}` should represent the account
-// ID of the child seat buyer.
+// - parent: The name of the parent buyer of the user list to be
+// retrieved that must follow the pattern `buyers/{buyerAccountId}`,
+// where `{buyerAccountId}` represents the account ID of the buyer who
+// owns user lists. For a bidder accessing user lists on behalf of a
+// child seat buyer , `{buyerAccountId}` should represent the account
+// ID of the child seat buyer.
func (r *BuyersUserListsService) Create(parent string, userlist *UserList) *BuyersUserListsCreateCall {
c := &BuyersUserListsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8643,14 +8661,14 @@ type BuyersUserListsGetRemarketingTagCall struct {
// When a user visits a page containing a remarketing tag, Google adds
// the user to a user list.
//
-// - name: To fetch remarketing tag for an account, name must follow the
-// pattern `buyers/{accountId}` where `{accountId}` represents ID of a
-// buyer that owns the remarketing tag. For a bidder accessing
-// remarketing tag on behalf of a child seat buyer, `{accountId}`
-// should represent the ID of the child seat buyer. To fetch
-// remarketing tag for a specific user list, name must follow the
-// pattern `buyers/{accountId}/userLists/{userListId}`. See
-// UserList.name.
+// - name: To fetch remarketing tag for an account, name must follow the
+// pattern `buyers/{accountId}` where `{accountId}` represents ID of a
+// buyer that owns the remarketing tag. For a bidder accessing
+// remarketing tag on behalf of a child seat buyer, `{accountId}`
+// should represent the ID of the child seat buyer. To fetch
+// remarketing tag for a specific user list, name must follow the
+// pattern `buyers/{accountId}/userLists/{userListId}`. See
+// UserList.name.
func (r *BuyersUserListsService) GetRemarketingTag(name string) *BuyersUserListsGetRemarketingTagCall {
c := &BuyersUserListsGetRemarketingTagCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8796,12 +8814,12 @@ type BuyersUserListsListCall struct {
// List: Lists the user lists visible to the current user.
//
-// - parent: The name of the parent buyer for the user lists to be
-// returned that must follow the pattern `buyers/{buyerAccountId}`,
-// where `{buyerAccountId}` represents the account ID of the buyer who
-// owns user lists. For a bidder accessing user lists on behalf of a
-// child seat buyer , `{buyerAccountId}` should represent the account
-// ID of the child seat buyer.
+// - parent: The name of the parent buyer for the user lists to be
+// returned that must follow the pattern `buyers/{buyerAccountId}`,
+// where `{buyerAccountId}` represents the account ID of the buyer who
+// owns user lists. For a bidder accessing user lists on behalf of a
+// child seat buyer , `{buyerAccountId}` should represent the account
+// ID of the child seat buyer.
func (r *BuyersUserListsService) List(parent string) *BuyersUserListsListCall {
c := &BuyersUserListsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9137,13 +9155,13 @@ type BuyersUserListsUpdateCall struct {
// Update: Update the given user list. Only user lists with
// URLRestrictions can be updated.
//
-// - name: Output only. Name of the user list that must follow the
-// pattern `buyers/{buyer}/userLists/{user_list}`, where `{buyer}`
-// represents the account ID of the buyer who owns the user list. For
-// a bidder accessing user lists on behalf of a child seat buyer,
-// `{buyer}` represents the account ID of the child seat buyer.
-// `{user_list}` is an int64 identifier assigned by Google to uniquely
-// identify a user list.
+// - name: Output only. Name of the user list that must follow the
+// pattern `buyers/{buyer}/userLists/{user_list}`, where `{buyer}`
+// represents the account ID of the buyer who owns the user list. For
+// a bidder accessing user lists on behalf of a child seat buyer,
+// `{buyer}` represents the account ID of the child seat buyer.
+// `{user_list}` is an int64 identifier assigned by Google to uniquely
+// identify a user list.
func (r *BuyersUserListsService) Update(nameid string, userlist *UserList) *BuyersUserListsUpdateCall {
c := &BuyersUserListsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.nameid = nameid
diff --git a/realtimebidding/v1alpha/realtimebidding-gen.go b/realtimebidding/v1alpha/realtimebidding-gen.go
index f0e0ffd6c66..990fae9dfeb 100644
--- a/realtimebidding/v1alpha/realtimebidding-gen.go
+++ b/realtimebidding/v1alpha/realtimebidding-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/realtimebidding/v1alpha"
-// ...
-// ctx := context.Background()
-// realtimebiddingService, err := realtimebidding.NewService(ctx)
+// import "google.golang.org/api/realtimebidding/v1alpha"
+// ...
+// ctx := context.Background()
+// realtimebiddingService, err := realtimebidding.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithAPIKey("AIza..."))
+// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package realtimebidding // import "google.golang.org/api/realtimebidding/v1alpha"
@@ -383,9 +383,9 @@ type BiddersBiddingFunctionsActivateCall struct {
// function is available for invocation for the server-side TURTLEDOVE
// simulations.
//
-// - name: The name of the bidding function to activate. Format:
-// `bidders/{bidder_account_id}/biddingFunction/{bidding_function_name}
-// `.
+// - name: The name of the bidding function to activate. Format:
+// `bidders/{bidder_account_id}/biddingFunction/{bidding_function_name}
+// `.
func (r *BiddersBiddingFunctionsService) Activate(name string, activatebiddingfunctionrequest *ActivateBiddingFunctionRequest) *BiddersBiddingFunctionsActivateCall {
c := &BiddersBiddingFunctionsActivateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -529,9 +529,9 @@ type BiddersBiddingFunctionsArchiveCall struct {
// will not be available for function invocation for the server-side
// TURTLEDOVE simulations unless it is activated.
//
-// - name: The name of the bidding function to archive. Format:
-// `bidders/{bidder_account_id}/biddingFunction/{bidding_function_name}
-// `.
+// - name: The name of the bidding function to archive. Format:
+// `bidders/{bidder_account_id}/biddingFunction/{bidding_function_name}
+// `.
func (r *BiddersBiddingFunctionsService) Archive(name string, archivebiddingfunctionrequest *ArchiveBiddingFunctionRequest) *BiddersBiddingFunctionsArchiveCall {
c := &BiddersBiddingFunctionsArchiveCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -673,8 +673,8 @@ type BiddersBiddingFunctionsCreateCall struct {
// Create: Creates a new bidding function.
//
-// - parent: The name of the bidder for which to create the bidding
-// function. Format: `bidders/{bidderAccountId}`.
+// - parent: The name of the bidder for which to create the bidding
+// function. Format: `bidders/{bidderAccountId}`.
func (r *BiddersBiddingFunctionsService) Create(parent string, biddingfunction *BiddingFunction) *BiddersBiddingFunctionsCreateCall {
c := &BiddersBiddingFunctionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -817,8 +817,8 @@ type BiddersBiddingFunctionsListCall struct {
// List: Lists the bidding functions that a bidder currently has
// registered.
//
-// - parent: Name of the bidder whose bidding functions will be listed.
-// Format: `bidders/{bidder_account_id}`.
+// - parent: Name of the bidder whose bidding functions will be listed.
+// Format: `bidders/{bidder_account_id}`.
func (r *BiddersBiddingFunctionsService) List(parent string) *BiddersBiddingFunctionsListCall {
c := &BiddersBiddingFunctionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json
index 2300b80d537..f1000aa699b 100644
--- a/recaptchaenterprise/v1/recaptchaenterprise-api.json
+++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json
@@ -371,7 +371,7 @@
]
},
"retrieveLegacySecretKey": {
- "description": "Returns the secret key related to the specified public key. You should use the legacy secret key only if you are integrating with a 3rd party using the legacy reCAPTCHA instead of reCAPTCHA Enterprise.",
+ "description": "Returns the secret key related to the specified public key. You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.",
"flatPath": "v1/projects/{projectsId}/keys/{keysId}:retrieveLegacySecretKey",
"httpMethod": "GET",
"id": "recaptchaenterprise.projects.keys.retrieveLegacySecretKey",
@@ -380,7 +380,7 @@
],
"parameters": {
"key": {
- "description": "Required. The public key name linked to the requested secret key , in the format \"projects/{project}/keys/{key}\".",
+ "description": "Required. The public key name linked to the requested secret key in the format \"projects/{project}/keys/{key}\".",
"location": "path",
"pattern": "^projects/[^/]+/keys/[^/]+$",
"required": true,
@@ -409,7 +409,7 @@
],
"parameters": {
"project": {
- "description": "Required. The name of the project to search related account group memberships from, in the format \"projects/{project}\".",
+ "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: \"projects/{project}\".",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
@@ -441,7 +441,7 @@
],
"parameters": {
"pageSize": {
- "description": "Optional. The maximum number of groups to return. The service may return fewer than this value. If unspecified, at most 50 groups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+ "description": "Optional. The maximum number of groups to return. The service might return fewer than this value. If unspecified, at most 50 groups are returned. The maximum value is 1000; values above 1000 are coerced to 1000.",
"format": "int32",
"location": "query",
"type": "integer"
@@ -472,7 +472,7 @@
"memberships": {
"methods": {
"list": {
- "description": "Get the memberships in a group of related accounts.",
+ "description": "Get memberships in a group of related accounts.",
"flatPath": "v1/projects/{projectsId}/relatedaccountgroups/{relatedaccountgroupsId}/memberships",
"httpMethod": "GET",
"id": "recaptchaenterprise.projects.relatedaccountgroups.memberships.list",
@@ -481,7 +481,7 @@
],
"parameters": {
"pageSize": {
- "description": "Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 50 accounts will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+ "description": "Optional. The maximum number of accounts to return. The service might return fewer than this value. If unspecified, at most 50 accounts are returned. The maximum value is 1000; values above 1000 are coerced to 1000.",
"format": "int32",
"location": "query",
"type": "integer"
@@ -514,11 +514,11 @@
}
}
},
- "revision": "20220722",
+ "revision": "20220812",
"rootUrl": "https://recaptchaenterprise.googleapis.com/",
"schemas": {
"GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": {
- "description": "Account Defender risk assessment.",
+ "description": "Account defender risk assessment.",
"id": "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment",
"properties": {
"labels": {
@@ -534,9 +534,9 @@
"enumDescriptions": [
"Default unspecified type.",
"The request matches a known good profile for the user.",
- "The request is potentially a suspicious login event and should be further verified either via multi-factor authentication or another system.",
- "The request matched a profile that previously had suspicious account creation behavior. This could mean this is a fake account.",
- "The account in the request has a high number of related accounts. It does not necessarily imply that the account is bad but could require investigating."
+ "The request is potentially a suspicious login event and must be further verified either through multi-factor authentication or another system.",
+ "The request matched a profile that previously had suspicious account creation behavior. This can mean that this is a fake account.",
+ "The account in the request has a high number of related accounts. It does not necessarily imply that the account is bad but can require further investigation."
],
"type": "string"
},
@@ -586,7 +586,7 @@
"type": "string"
},
"hashedAccountId": {
- "description": "Optional. Optional unique stable hashed user identifier to apply to the assessment. This is an alternative to setting the hashed_account_id in CreateAssessment, for example when the account identifier is not yet known in the initial request. It is recommended that the identifier is hashed using hmac-sha256 with stable secret.",
+ "description": "Optional. Unique stable hashed user identifier to apply to the assessment. This is an alternative to setting the hashed_account_id in CreateAssessment, for example when the account identifier is not yet known in the initial request. It is recommended that the identifier is hashed using hmac-sha256 with stable secret.",
"format": "byte",
"type": "string"
},
@@ -600,6 +600,8 @@
"CHARGEBACK_DISPUTE",
"REFUND",
"REFUND_FRAUD",
+ "TRANSACTION_ACCEPTED",
+ "TRANSACTION_DECLINED",
"PAYMENT_HEURISTICS",
"INITIATED_TWO_FACTOR",
"PASSED_TWO_FACTOR",
@@ -609,11 +611,13 @@
],
"enumDescriptions": [
"Default unspecified reason.",
- "Indicates a chargeback issued for the transaction with no other details. When possible, specify the type by using CHARGEBACK_FRAUD or CHARGEBACK_DISPUTE instead.",
- "Indicates a chargeback related to an alleged unauthorized transaction from the cardholder's perspective (for example, the card number was stolen).",
- "Indicates a chargeback related to the cardholder having provided their card details but allegedly not being satisfied with the purchase (for example, misrepresentation, attempted cancellation).",
- "Indicates a completed payment transaction was refunded by the seller.",
- "Indicates a completed payment transaction was determined to be fraudulent by the seller, and was cancelled and refunded as a result.",
+ "Indicates that the transaction had a chargeback issued with no other details. When possible, specify the type by using CHARGEBACK_FRAUD or CHARGEBACK_DISPUTE instead.",
+ "Indicates that the transaction had a chargeback issued related to an alleged unauthorized transaction from the cardholder's perspective (for example, the card number was stolen).",
+ "Indicates that the transaction had a chargeback issued related to the cardholder having provided their card details but allegedly not being satisfied with the purchase (for example, misrepresentation, attempted cancellation).",
+ "Indicates that the completed payment transaction was refunded by the seller.",
+ "Indicates that the completed payment transaction was determined to be fraudulent by the seller, and was cancelled and refunded as a result.",
+ "Indicates that the payment transaction was accepted, and the user was charged.",
+ "Indicates that the payment transaction was declined, for example due to invalid card details.",
"Indicates the transaction associated with the assessment is suspected of being fraudulent based on the payment method, billing details, shipping address or other transaction information.",
"Indicates that the user was served a 2FA challenge. An old assessment with `ENUM_VALUES.INITIATED_TWO_FACTOR` reason that has not been overwritten with `PASSED_TWO_FACTOR` is treated as an abandoned 2FA flow. This is equivalent to `FAILED_TWO_FACTOR`.",
"Indicates that the user passed a 2FA challenge.",
@@ -640,7 +644,7 @@
"properties": {
"accountDefenderAssessment": {
"$ref": "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment",
- "description": "Assessment returned by Account Defender when a hashed_account_id is provided."
+ "description": "Assessment returned by account defender when a hashed_account_id is provided."
},
"event": {
"$ref": "GoogleCloudRecaptchaenterpriseV1Event",
@@ -653,7 +657,7 @@
},
"privatePasswordLeakVerification": {
"$ref": "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification",
- "description": "The private password leak verification field contains the parameters used to check for leaks privately without sharing user credentials."
+ "description": "The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials."
},
"riskAnalysis": {
"$ref": "GoogleCloudRecaptchaenterpriseV1RiskAnalysis",
@@ -703,7 +707,7 @@
"type": "string"
},
"hashedAccountId": {
- "description": "Optional. Optional unique stable hashed user identifier for the request. The identifier should ideally be hashed using sha256 with stable secret.",
+ "description": "Optional. Unique stable hashed user identifier for the request. The identifier must be hashed using hmac-sha256 with stable secret.",
"format": "byte",
"type": "string"
},
@@ -887,7 +891,7 @@
"id": "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification",
"properties": {
"encryptedLeakMatchPrefixes": {
- "description": "Output only. List of prefixes of the encrypted potential password leaks that matched the given parameters. They should be compared with the client-side decryption prefix of `reencrypted_user_credentials_hash`",
+ "description": "Output only. List of prefixes of the encrypted potential password leaks that matched the given parameters. They must be compared with the client-side decryption prefix of `reencrypted_user_credentials_hash`",
"items": {
"format": "byte",
"type": "string"
@@ -906,7 +910,7 @@
"type": "string"
},
"reencryptedUserCredentialsHash": {
- "description": "Output only. Corresponds to the re-encryption of the `encrypted_user_credentials_hash` field. Used to match potential password leaks within `encrypted_leak_match_prefixes`.",
+ "description": "Output only. Corresponds to the re-encryption of the `encrypted_user_credentials_hash` field. It is used to match potential password leaks within `encrypted_leak_match_prefixes`.",
"format": "byte",
"readOnly": true,
"type": "string"
@@ -930,7 +934,7 @@
"id": "GoogleCloudRecaptchaenterpriseV1RelatedAccountGroupMembership",
"properties": {
"hashedAccountId": {
- "description": "The unique stable hashed user identifier of the member. The identifier corresponds to a `hashed_account_id` provided in a previous CreateAssessment or AnnotateAssessment call.",
+ "description": "The unique stable hashed user identifier of the member. The identifier corresponds to a `hashed_account_id` provided in a previous `CreateAssessment` or `AnnotateAssessment` call.",
"format": "byte",
"type": "string"
},
@@ -942,7 +946,7 @@
"type": "object"
},
"GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse": {
- "description": "Secret key used in legacy reCAPTCHA only. Should be used when integrating with a 3rd party which is still using legacy reCAPTCHA.",
+ "description": "Secret key is used only in legacy reCAPTCHA. It must be used in a 3rd party integration with legacy reCAPTCHA.",
"id": "GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse",
"properties": {
"legacySecretKey": {
@@ -1025,12 +1029,12 @@
"id": "GoogleCloudRecaptchaenterpriseV1SearchRelatedAccountGroupMembershipsRequest",
"properties": {
"hashedAccountId": {
- "description": "Optional. The unique stable hashed user identifier we should search connections to. The identifier should correspond to a `hashed_account_id` provided in a previous CreateAssessment or AnnotateAssessment call.",
+ "description": "Optional. The unique stable hashed user identifier we should search connections to. The identifier should correspond to a `hashed_account_id` provided in a previous `CreateAssessment` or `AnnotateAssessment` call.",
"format": "byte",
"type": "string"
},
"pageSize": {
- "description": "Optional. The maximum number of groups to return. The service may return fewer than this value. If unspecified, at most 50 groups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+ "description": "Optional. The maximum number of groups to return. The service might return fewer than this value. If unspecified, at most 50 groups are returned. The maximum value is 1000; values above 1000 are coerced to 1000.",
"format": "int32",
"type": "integer"
},
diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go
index 4d996bb7a86..3cd2247e3bf 100644
--- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go
+++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recaptcha-enterprise/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/recaptchaenterprise/v1"
-// ...
-// ctx := context.Background()
-// recaptchaenterpriseService, err := recaptchaenterprise.NewService(ctx)
+// import "google.golang.org/api/recaptchaenterprise/v1"
+// ...
+// ctx := context.Background()
+// recaptchaenterpriseService, err := recaptchaenterprise.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// recaptchaenterpriseService, err := recaptchaenterprise.NewService(ctx, option.WithAPIKey("AIza..."))
+// recaptchaenterpriseService, err := recaptchaenterprise.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// recaptchaenterpriseService, err := recaptchaenterprise.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// recaptchaenterpriseService, err := recaptchaenterprise.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package recaptchaenterprise // import "google.golang.org/api/recaptchaenterprise/v1"
@@ -207,7 +207,7 @@ type ProjectsRelatedaccountgroupsMembershipsService struct {
}
// GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment: Account
-// Defender risk assessment.
+// defender risk assessment.
type GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment struct {
// Labels: Labels for this request.
//
@@ -216,14 +216,14 @@ type GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment struct {
// "PROFILE_MATCH" - The request matches a known good profile for the
// user.
// "SUSPICIOUS_LOGIN_ACTIVITY" - The request is potentially a
- // suspicious login event and should be further verified either via
+ // suspicious login event and must be further verified either through
// multi-factor authentication or another system.
// "SUSPICIOUS_ACCOUNT_CREATION" - The request matched a profile that
- // previously had suspicious account creation behavior. This could mean
- // this is a fake account.
+ // previously had suspicious account creation behavior. This can mean
+ // that this is a fake account.
// "RELATED_ACCOUNTS_NUMBER_HIGH" - The account in the request has a
// high number of related accounts. It does not necessarily imply that
- // the account is bad but could require investigating.
+ // the account is bad but can require further investigation.
Labels []string `json:"labels,omitempty"`
// ForceSendFields is a list of field names (e.g. "Labels") to
@@ -309,12 +309,11 @@ type GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest struct {
// the reasons field instead.
Annotation string `json:"annotation,omitempty"`
- // HashedAccountId: Optional. Optional unique stable hashed user
- // identifier to apply to the assessment. This is an alternative to
- // setting the hashed_account_id in CreateAssessment, for example when
- // the account identifier is not yet known in the initial request. It is
- // recommended that the identifier is hashed using hmac-sha256 with
- // stable secret.
+ // HashedAccountId: Optional. Unique stable hashed user identifier to
+ // apply to the assessment. This is an alternative to setting the
+ // hashed_account_id in CreateAssessment, for example when the account
+ // identifier is not yet known in the initial request. It is recommended
+ // that the identifier is hashed using hmac-sha256 with stable secret.
HashedAccountId string `json:"hashedAccountId,omitempty"`
// Reasons: Optional. Optional reasons for the annotation that will be
@@ -322,21 +321,26 @@ type GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest struct {
//
// Possible values:
// "REASON_UNSPECIFIED" - Default unspecified reason.
- // "CHARGEBACK" - Indicates a chargeback issued for the transaction
- // with no other details. When possible, specify the type by using
- // CHARGEBACK_FRAUD or CHARGEBACK_DISPUTE instead.
- // "CHARGEBACK_FRAUD" - Indicates a chargeback related to an alleged
- // unauthorized transaction from the cardholder's perspective (for
- // example, the card number was stolen).
- // "CHARGEBACK_DISPUTE" - Indicates a chargeback related to the
- // cardholder having provided their card details but allegedly not being
- // satisfied with the purchase (for example, misrepresentation,
- // attempted cancellation).
- // "REFUND" - Indicates a completed payment transaction was refunded
- // by the seller.
- // "REFUND_FRAUD" - Indicates a completed payment transaction was
- // determined to be fraudulent by the seller, and was cancelled and
+ // "CHARGEBACK" - Indicates that the transaction had a chargeback
+ // issued with no other details. When possible, specify the type by
+ // using CHARGEBACK_FRAUD or CHARGEBACK_DISPUTE instead.
+ // "CHARGEBACK_FRAUD" - Indicates that the transaction had a
+ // chargeback issued related to an alleged unauthorized transaction from
+ // the cardholder's perspective (for example, the card number was
+ // stolen).
+ // "CHARGEBACK_DISPUTE" - Indicates that the transaction had a
+ // chargeback issued related to the cardholder having provided their
+ // card details but allegedly not being satisfied with the purchase (for
+ // example, misrepresentation, attempted cancellation).
+ // "REFUND" - Indicates that the completed payment transaction was
+ // refunded by the seller.
+ // "REFUND_FRAUD" - Indicates that the completed payment transaction
+ // was determined to be fraudulent by the seller, and was cancelled and
// refunded as a result.
+ // "TRANSACTION_ACCEPTED" - Indicates that the payment transaction was
+ // accepted, and the user was charged.
+ // "TRANSACTION_DECLINED" - Indicates that the payment transaction was
+ // declined, for example due to invalid card details.
// "PAYMENT_HEURISTICS" - Indicates the transaction associated with
// the assessment is suspected of being fraudulent based on the payment
// method, billing details, shipping address or other transaction
@@ -390,7 +394,7 @@ type GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentResponse struct {
// GoogleCloudRecaptchaenterpriseV1Assessment: A recaptcha assessment
// resource.
type GoogleCloudRecaptchaenterpriseV1Assessment struct {
- // AccountDefenderAssessment: Assessment returned by Account Defender
+ // AccountDefenderAssessment: Assessment returned by account defender
// when a hashed_account_id is provided.
AccountDefenderAssessment *GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment `json:"accountDefenderAssessment,omitempty"`
@@ -402,8 +406,8 @@ type GoogleCloudRecaptchaenterpriseV1Assessment struct {
Name string `json:"name,omitempty"`
// PrivatePasswordLeakVerification: The private password leak
- // verification field contains the parameters used to check for leaks
- // privately without sharing user credentials.
+ // verification field contains the parameters that are used to to check
+ // for leaks privately without sharing user credentials.
PrivatePasswordLeakVerification *GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification `json:"privatePasswordLeakVerification,omitempty"`
// RiskAnalysis: Output only. The risk analysis result for the event
@@ -493,9 +497,9 @@ type GoogleCloudRecaptchaenterpriseV1Event struct {
// client-side platforms already integrated with recaptcha enterprise.
ExpectedAction string `json:"expectedAction,omitempty"`
- // HashedAccountId: Optional. Optional unique stable hashed user
- // identifier for the request. The identifier should ideally be hashed
- // using sha256 with stable secret.
+ // HashedAccountId: Optional. Unique stable hashed user identifier for
+ // the request. The identifier must be hashed using hmac-sha256 with
+ // stable secret.
HashedAccountId string `json:"hashedAccountId,omitempty"`
// SiteKey: Optional. The site key that was used to invoke reCAPTCHA on
@@ -805,7 +809,7 @@ type GoogleCloudRecaptchaenterpriseV1MigrateKeyRequest struct {
type GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification struct {
// EncryptedLeakMatchPrefixes: Output only. List of prefixes of the
// encrypted potential password leaks that matched the given parameters.
- // They should be compared with the client-side decryption prefix of
+ // They must be compared with the client-side decryption prefix of
// `reencrypted_user_credentials_hash`
EncryptedLeakMatchPrefixes []string `json:"encryptedLeakMatchPrefixes,omitempty"`
@@ -820,8 +824,8 @@ type GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification struct {
LookupHashPrefix string `json:"lookupHashPrefix,omitempty"`
// ReencryptedUserCredentialsHash: Output only. Corresponds to the
- // re-encryption of the `encrypted_user_credentials_hash` field. Used to
- // match potential password leaks within
+ // re-encryption of the `encrypted_user_credentials_hash` field. It is
+ // used to match potential password leaks within
// `encrypted_leak_match_prefixes`.
ReencryptedUserCredentialsHash string `json:"reencryptedUserCredentialsHash,omitempty"`
@@ -886,7 +890,7 @@ func (s *GoogleCloudRecaptchaenterpriseV1RelatedAccountGroup) MarshalJSON() ([]b
type GoogleCloudRecaptchaenterpriseV1RelatedAccountGroupMembership struct {
// HashedAccountId: The unique stable hashed user identifier of the
// member. The identifier corresponds to a `hashed_account_id` provided
- // in a previous CreateAssessment or AnnotateAssessment call.
+ // in a previous `CreateAssessment` or `AnnotateAssessment` call.
HashedAccountId string `json:"hashedAccountId,omitempty"`
// Name: Required. The resource name for this membership in the format
@@ -919,8 +923,8 @@ func (s *GoogleCloudRecaptchaenterpriseV1RelatedAccountGroupMembership) MarshalJ
}
// GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse:
-// Secret key used in legacy reCAPTCHA only. Should be used when
-// integrating with a 3rd party which is still using legacy reCAPTCHA.
+// Secret key is used only in legacy reCAPTCHA. It must be used in a 3rd
+// party integration with legacy reCAPTCHA.
type GoogleCloudRecaptchaenterpriseV1RetrieveLegacySecretKeyResponse struct {
// LegacySecretKey: The secret key (also known as shared secret)
// authorizes communication between your application backend and the
@@ -1088,14 +1092,14 @@ func (s *GoogleCloudRecaptchaenterpriseV1ScoreMetrics) MarshalJSON() ([]byte, er
type GoogleCloudRecaptchaenterpriseV1SearchRelatedAccountGroupMembershipsRequest struct {
// HashedAccountId: Optional. The unique stable hashed user identifier
// we should search connections to. The identifier should correspond to
- // a `hashed_account_id` provided in a previous CreateAssessment or
- // AnnotateAssessment call.
+ // a `hashed_account_id` provided in a previous `CreateAssessment` or
+ // `AnnotateAssessment` call.
HashedAccountId string `json:"hashedAccountId,omitempty"`
// PageSize: Optional. The maximum number of groups to return. The
- // service may return fewer than this value. If unspecified, at most 50
- // groups will be returned. The maximum value is 1000; values above 1000
- // will be coerced to 1000.
+ // service might return fewer than this value. If unspecified, at most
+ // 50 groups are returned. The maximum value is 1000; values above 1000
+ // are coerced to 1000.
PageSize int64 `json:"pageSize,omitempty"`
// PageToken: Optional. A page token, received from a previous
@@ -1424,8 +1428,8 @@ type ProjectsAssessmentsAnnotateCall struct {
// additional information on whether the event turned out to be
// authentic or fraudulent.
//
-// - name: The resource name of the Assessment, in the format
-// "projects/{project}/assessments/{assessment}".
+// - name: The resource name of the Assessment, in the format
+// "projects/{project}/assessments/{assessment}".
func (r *ProjectsAssessmentsService) Annotate(name string, googlecloudrecaptchaenterprisev1annotateassessmentrequest *GoogleCloudRecaptchaenterpriseV1AnnotateAssessmentRequest) *ProjectsAssessmentsAnnotateCall {
c := &ProjectsAssessmentsAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1571,8 +1575,8 @@ type ProjectsAssessmentsCreateCall struct {
// Create: Creates an Assessment of the likelihood an event is
// legitimate.
//
-// - parent: The name of the project in which the assessment will be
-// created, in the format "projects/{project}".
+// - parent: The name of the project in which the assessment will be
+// created, in the format "projects/{project}".
func (r *ProjectsAssessmentsService) Create(parent string, googlecloudrecaptchaenterprisev1assessment *GoogleCloudRecaptchaenterpriseV1Assessment) *ProjectsAssessmentsCreateCall {
c := &ProjectsAssessmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1716,8 +1720,8 @@ type ProjectsKeysCreateCall struct {
// Create: Creates a new reCAPTCHA Enterprise key.
//
-// - parent: The name of the project in which the key will be created,
-// in the format "projects/{project}".
+// - parent: The name of the project in which the key will be created,
+// in the format "projects/{project}".
func (r *ProjectsKeysService) Create(parent string, googlecloudrecaptchaenterprisev1key *GoogleCloudRecaptchaenterpriseV1Key) *ProjectsKeysCreateCall {
c := &ProjectsKeysCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1859,8 +1863,8 @@ type ProjectsKeysDeleteCall struct {
// Delete: Deletes the specified key.
//
-// - name: The name of the key to be deleted, in the format
-// "projects/{project}/keys/{key}".
+// - name: The name of the key to be deleted, in the format
+// "projects/{project}/keys/{key}".
func (r *ProjectsKeysService) Delete(name string) *ProjectsKeysDeleteCall {
c := &ProjectsKeysDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1993,8 +1997,8 @@ type ProjectsKeysGetCall struct {
// Get: Returns the specified key.
//
-// - name: The name of the requested key, in the format
-// "projects/{project}/keys/{key}".
+// - name: The name of the requested key, in the format
+// "projects/{project}/keys/{key}".
func (r *ProjectsKeysService) Get(name string) *ProjectsKeysGetCall {
c := &ProjectsKeysGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2142,8 +2146,8 @@ type ProjectsKeysGetMetricsCall struct {
// GetMetrics: Get some aggregated metrics for a Key. This data can be
// used to build dashboards.
//
-// - name: The name of the requested metrics, in the format
-// "projects/{project}/keys/{key}/metrics".
+// - name: The name of the requested metrics, in the format
+// "projects/{project}/keys/{key}/metrics".
func (r *ProjectsKeysService) GetMetrics(name string) *ProjectsKeysGetMetricsCall {
c := &ProjectsKeysGetMetricsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2290,8 +2294,8 @@ type ProjectsKeysListCall struct {
// List: Returns the list of all keys that belong to a project.
//
-// - parent: The name of the project that contains the keys that will be
-// listed, in the format "projects/{project}".
+// - parent: The name of the project that contains the keys that will be
+// listed, in the format "projects/{project}".
func (r *ProjectsKeysService) List(parent string) *ProjectsKeysListCall {
c := &ProjectsKeysListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2491,8 +2495,8 @@ type ProjectsKeysMigrateCall struct {
// reCAPTCHA Site Key, and your user must have the reCAPTCHA Enterprise
// Admin IAM role in the destination project.
//
-// - name: The name of the key to be migrated, in the format
-// "projects/{project}/keys/{key}".
+// - name: The name of the key to be migrated, in the format
+// "projects/{project}/keys/{key}".
func (r *ProjectsKeysService) Migrate(name string, googlecloudrecaptchaenterprisev1migratekeyrequest *GoogleCloudRecaptchaenterpriseV1MigrateKeyRequest) *ProjectsKeysMigrateCall {
c := &ProjectsKeysMigrateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2635,8 +2639,8 @@ type ProjectsKeysPatchCall struct {
// Patch: Updates the specified key.
//
-// - name: The resource name for the Key in the format
-// "projects/{project}/keys/{key}".
+// - name: The resource name for the Key in the format
+// "projects/{project}/keys/{key}".
func (r *ProjectsKeysService) Patch(name string, googlecloudrecaptchaenterprisev1key *GoogleCloudRecaptchaenterpriseV1Key) *ProjectsKeysPatchCall {
c := &ProjectsKeysPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2792,12 +2796,11 @@ type ProjectsKeysRetrieveLegacySecretKeyCall struct {
}
// RetrieveLegacySecretKey: Returns the secret key related to the
-// specified public key. You should use the legacy secret key only if
-// you are integrating with a 3rd party using the legacy reCAPTCHA
-// instead of reCAPTCHA Enterprise.
+// specified public key. You must use the legacy secret key only in a
+// 3rd party integration with legacy reCAPTCHA.
//
-// - key: The public key name linked to the requested secret key , in
-// the format "projects/{project}/keys/{key}".
+// - key: The public key name linked to the requested secret key in the
+// format "projects/{project}/keys/{key}".
func (r *ProjectsKeysService) RetrieveLegacySecretKey(key string) *ProjectsKeysRetrieveLegacySecretKeyCall {
c := &ProjectsKeysRetrieveLegacySecretKeyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.key = key
@@ -2906,7 +2909,7 @@ func (c *ProjectsKeysRetrieveLegacySecretKeyCall) Do(opts ...googleapi.CallOptio
}
return ret, nil
// {
- // "description": "Returns the secret key related to the specified public key. You should use the legacy secret key only if you are integrating with a 3rd party using the legacy reCAPTCHA instead of reCAPTCHA Enterprise.",
+ // "description": "Returns the secret key related to the specified public key. You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.",
// "flatPath": "v1/projects/{projectsId}/keys/{keysId}:retrieveLegacySecretKey",
// "httpMethod": "GET",
// "id": "recaptchaenterprise.projects.keys.retrieveLegacySecretKey",
@@ -2915,7 +2918,7 @@ func (c *ProjectsKeysRetrieveLegacySecretKeyCall) Do(opts ...googleapi.CallOptio
// ],
// "parameters": {
// "key": {
- // "description": "Required. The public key name linked to the requested secret key , in the format \"projects/{project}/keys/{key}\".",
+ // "description": "Required. The public key name linked to the requested secret key in the format \"projects/{project}/keys/{key}\".",
// "location": "path",
// "pattern": "^projects/[^/]+/keys/[^/]+$",
// "required": true,
@@ -2946,8 +2949,9 @@ type ProjectsRelatedaccountgroupmembershipsSearchCall struct {
// Search: Search group memberships related to a given account.
//
-// - project: The name of the project to search related account group
-// memberships from, in the format "projects/{project}".
+// - project: The name of the project to search related account group
+// memberships from. Specify the project name in the following format:
+// "projects/{project}".
func (r *ProjectsRelatedaccountgroupmembershipsService) Search(project string, googlecloudrecaptchaenterprisev1searchrelatedaccountgroupmembershipsrequest *GoogleCloudRecaptchaenterpriseV1SearchRelatedAccountGroupMembershipsRequest) *ProjectsRelatedaccountgroupmembershipsSearchCall {
c := &ProjectsRelatedaccountgroupmembershipsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -3058,7 +3062,7 @@ func (c *ProjectsRelatedaccountgroupmembershipsSearchCall) Do(opts ...googleapi.
// ],
// "parameters": {
// "project": {
- // "description": "Required. The name of the project to search related account group memberships from, in the format \"projects/{project}\".",
+ // "description": "Required. The name of the project to search related account group memberships from. Specify the project name in the following format: \"projects/{project}\".",
// "location": "path",
// "pattern": "^projects/[^/]+$",
// "required": true,
@@ -3115,8 +3119,8 @@ type ProjectsRelatedaccountgroupsListCall struct {
// List: List groups of related accounts.
//
-// - parent: The name of the project to list related account groups
-// from, in the format "projects/{project}".
+// - parent: The name of the project to list related account groups
+// from, in the format "projects/{project}".
func (r *ProjectsRelatedaccountgroupsService) List(parent string) *ProjectsRelatedaccountgroupsListCall {
c := &ProjectsRelatedaccountgroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3124,9 +3128,9 @@ func (r *ProjectsRelatedaccountgroupsService) List(parent string) *ProjectsRelat
}
// PageSize sets the optional parameter "pageSize": The maximum number
-// of groups to return. The service may return fewer than this value. If
-// unspecified, at most 50 groups will be returned. The maximum value is
-// 1000; values above 1000 will be coerced to 1000.
+// of groups to return. The service might return fewer than this value.
+// If unspecified, at most 50 groups are returned. The maximum value is
+// 1000; values above 1000 are coerced to 1000.
func (c *ProjectsRelatedaccountgroupsListCall) PageSize(pageSize int64) *ProjectsRelatedaccountgroupsListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -3253,7 +3257,7 @@ func (c *ProjectsRelatedaccountgroupsListCall) Do(opts ...googleapi.CallOption)
// ],
// "parameters": {
// "pageSize": {
- // "description": "Optional. The maximum number of groups to return. The service may return fewer than this value. If unspecified, at most 50 groups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+ // "description": "Optional. The maximum number of groups to return. The service might return fewer than this value. If unspecified, at most 50 groups are returned. The maximum value is 1000; values above 1000 are coerced to 1000.",
// "format": "int32",
// "location": "query",
// "type": "integer"
@@ -3314,11 +3318,11 @@ type ProjectsRelatedaccountgroupsMembershipsListCall struct {
header_ http.Header
}
-// List: Get the memberships in a group of related accounts.
+// List: Get memberships in a group of related accounts.
//
-// - parent: The resource name for the related account group in the
-// format
-// `projects/{project}/relatedaccountgroups/{relatedaccountgroup}`.
+// - parent: The resource name for the related account group in the
+// format
+// `projects/{project}/relatedaccountgroups/{relatedaccountgroup}`.
func (r *ProjectsRelatedaccountgroupsMembershipsService) List(parent string) *ProjectsRelatedaccountgroupsMembershipsListCall {
c := &ProjectsRelatedaccountgroupsMembershipsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3326,9 +3330,9 @@ func (r *ProjectsRelatedaccountgroupsMembershipsService) List(parent string) *Pr
}
// PageSize sets the optional parameter "pageSize": The maximum number
-// of accounts to return. The service may return fewer than this value.
-// If unspecified, at most 50 accounts will be returned. The maximum
-// value is 1000; values above 1000 will be coerced to 1000.
+// of accounts to return. The service might return fewer than this
+// value. If unspecified, at most 50 accounts are returned. The maximum
+// value is 1000; values above 1000 are coerced to 1000.
func (c *ProjectsRelatedaccountgroupsMembershipsListCall) PageSize(pageSize int64) *ProjectsRelatedaccountgroupsMembershipsListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -3446,7 +3450,7 @@ func (c *ProjectsRelatedaccountgroupsMembershipsListCall) Do(opts ...googleapi.C
}
return ret, nil
// {
- // "description": "Get the memberships in a group of related accounts.",
+ // "description": "Get memberships in a group of related accounts.",
// "flatPath": "v1/projects/{projectsId}/relatedaccountgroups/{relatedaccountgroupsId}/memberships",
// "httpMethod": "GET",
// "id": "recaptchaenterprise.projects.relatedaccountgroups.memberships.list",
@@ -3455,7 +3459,7 @@ func (c *ProjectsRelatedaccountgroupsMembershipsListCall) Do(opts ...googleapi.C
// ],
// "parameters": {
// "pageSize": {
- // "description": "Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 50 accounts will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
+ // "description": "Optional. The maximum number of accounts to return. The service might return fewer than this value. If unspecified, at most 50 accounts are returned. The maximum value is 1000; values above 1000 are coerced to 1000.",
// "format": "int32",
// "location": "query",
// "type": "integer"
diff --git a/recommendationengine/v1beta1/recommendationengine-gen.go b/recommendationengine/v1beta1/recommendationengine-gen.go
index 11fc86846c1..1952ee4d535 100644
--- a/recommendationengine/v1beta1/recommendationengine-gen.go
+++ b/recommendationengine/v1beta1/recommendationengine-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recommendations-ai/docs
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/recommendationengine/v1beta1"
-// ...
-// ctx := context.Background()
-// recommendationengineService, err := recommendationengine.NewService(ctx)
+// import "google.golang.org/api/recommendationengine/v1beta1"
+// ...
+// ctx := context.Background()
+// recommendationengineService, err := recommendationengine.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// recommendationengineService, err := recommendationengine.NewService(ctx, option.WithAPIKey("AIza..."))
+// recommendationengineService, err := recommendationengine.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// recommendationengineService, err := recommendationengine.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// recommendationengineService, err := recommendationengine.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package recommendationengine // import "google.golang.org/api/recommendationengine/v1beta1"
@@ -1585,7 +1585,8 @@ func (s *GoogleCloudRecommendationengineV1beta1PredictResponse) MarshalJSON() ([
}
// GoogleCloudRecommendationengineV1beta1PredictResponsePredictionResult:
-// PredictionResult represents the recommendation prediction results.
+//
+// PredictionResult represents the recommendation prediction results.
type GoogleCloudRecommendationengineV1beta1PredictResponsePredictionResult struct {
// Id: ID of the recommended catalog item
Id string `json:"id,omitempty"`
@@ -2990,8 +2991,8 @@ type ProjectsLocationsCatalogsCatalogItemsCreateCall struct {
// Create: Creates a catalog item.
//
-// - parent: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsCatalogItemsService) Create(parent string, googlecloudrecommendationenginev1beta1catalogitem *GoogleCloudRecommendationengineV1beta1CatalogItem) *ProjectsLocationsCatalogsCatalogItemsCreateCall {
c := &ProjectsLocationsCatalogsCatalogItemsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3134,9 +3135,9 @@ type ProjectsLocationsCatalogsCatalogItemsDeleteCall struct {
// Delete: Deletes a catalog item.
//
-// - name: Full resource name of catalog item, such as
-// `projects/*/locations/global/catalogs/default_catalog/catalogItems/s
-// ome_catalog_item_id`.
+// - name: Full resource name of catalog item, such as
+// `projects/*/locations/global/catalogs/default_catalog/catalogItems/s
+// ome_catalog_item_id`.
func (r *ProjectsLocationsCatalogsCatalogItemsService) Delete(name string) *ProjectsLocationsCatalogsCatalogItemsDeleteCall {
c := &ProjectsLocationsCatalogsCatalogItemsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3269,9 +3270,9 @@ type ProjectsLocationsCatalogsCatalogItemsGetCall struct {
// Get: Gets a specific catalog item.
//
-// - name: Full resource name of catalog item, such as
-// `projects/*/locations/global/catalogs/default_catalog/catalogitems/s
-// ome_catalog_item_id`.
+// - name: Full resource name of catalog item, such as
+// `projects/*/locations/global/catalogs/default_catalog/catalogitems/s
+// ome_catalog_item_id`.
func (r *ProjectsLocationsCatalogsCatalogItemsService) Get(name string) *ProjectsLocationsCatalogsCatalogItemsGetCall {
c := &ProjectsLocationsCatalogsCatalogItemsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3423,10 +3424,10 @@ type ProjectsLocationsCatalogsCatalogItemsImportCall struct {
// that it is possible for a subset of the items to be successfully
// updated.
//
-// - parent: `projects/1234/locations/global/catalogs/default_catalog`
-// If no updateMask is specified, requires catalogItems.create
-// permission. If updateMask is specified, requires
-// catalogItems.update permission.
+// - parent: `projects/1234/locations/global/catalogs/default_catalog`
+// If no updateMask is specified, requires catalogItems.create
+// permission. If updateMask is specified, requires
+// catalogItems.update permission.
func (r *ProjectsLocationsCatalogsCatalogItemsService) Import(parent string, googlecloudrecommendationenginev1beta1importcatalogitemsrequest *GoogleCloudRecommendationengineV1beta1ImportCatalogItemsRequest) *ProjectsLocationsCatalogsCatalogItemsImportCall {
c := &ProjectsLocationsCatalogsCatalogItemsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3568,8 +3569,8 @@ type ProjectsLocationsCatalogsCatalogItemsListCall struct {
// List: Gets a list of catalog items.
//
-// - parent: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsCatalogItemsService) List(parent string) *ProjectsLocationsCatalogsCatalogItemsListCall {
c := &ProjectsLocationsCatalogsCatalogItemsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3778,9 +3779,9 @@ type ProjectsLocationsCatalogsCatalogItemsPatchCall struct {
// Patch: Updates a catalog item. Partial updating is supported.
// Non-existing items will be created.
//
-// - name: Full resource name of catalog item, such as
-// `projects/*/locations/global/catalogs/default_catalog/catalogItems/s
-// ome_catalog_item_id`.
+// - name: Full resource name of catalog item, such as
+// `projects/*/locations/global/catalogs/default_catalog/catalogItems/s
+// ome_catalog_item_id`.
func (r *ProjectsLocationsCatalogsCatalogItemsService) Patch(name string, googlecloudrecommendationenginev1beta1catalogitem *GoogleCloudRecommendationengineV1beta1CatalogItem) *ProjectsLocationsCatalogsCatalogItemsPatchCall {
c := &ProjectsLocationsCatalogsCatalogItemsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4467,9 +4468,9 @@ type ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsCreateCall
// Create: Register an API key for use with predict method.
//
-// - parent: The parent resource path.
-// `projects/*/locations/global/catalogs/default_catalog/eventStores/de
-// fault_event_store`.
+// - parent: The parent resource path.
+// `projects/*/locations/global/catalogs/default_catalog/eventStores/de
+// fault_event_store`.
func (r *ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsService) Create(parent string, googlecloudrecommendationenginev1beta1createpredictionapikeyregistrationrequest *GoogleCloudRecommendationengineV1beta1CreatePredictionApiKeyRegistrationRequest) *ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsCreateCall {
c := &ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4613,9 +4614,9 @@ type ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsDeleteCall
// Delete: Unregister an apiKey from using for predict method.
//
-// - name: The API key to unregister including full resource path.
-// `projects/*/locations/global/catalogs/default_catalog/eventStores/de
-// fault_event_store/predictionApiKeyRegistrations/`.
+// - name: The API key to unregister including full resource path.
+// `projects/*/locations/global/catalogs/default_catalog/eventStores/de
+// fault_event_store/predictionApiKeyRegistrations/`.
func (r *ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsService) Delete(name string) *ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsDeleteCall {
c := &ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4748,9 +4749,9 @@ type ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsListCall s
// List: List the registered apiKeys for use with predict method.
//
-// - parent: The parent placement resource name such as
-// `projects/1234/locations/global/catalogs/default_catalog/eventStores
-// /default_event_store`.
+// - parent: The parent placement resource name such as
+// `projects/1234/locations/global/catalogs/default_catalog/eventStores
+// /default_event_store`.
func (r *ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsService) List(parent string) *ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsListCall {
c := &ProjectsLocationsCatalogsEventStoresPredictionApiKeyRegistrationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4949,9 +4950,9 @@ type ProjectsLocationsCatalogsEventStoresUserEventsCollectCall struct {
// domain. This method is used only by the Recommendations AI JavaScript
// pixel. Users should not call this method directly.
//
-// - parent: The parent eventStore name, such as
-// `projects/1234/locations/global/catalogs/default_catalog/eventStores
-// /default_event_store`.
+// - parent: The parent eventStore name, such as
+// `projects/1234/locations/global/catalogs/default_catalog/eventStores
+// /default_event_store`.
func (r *ProjectsLocationsCatalogsEventStoresUserEventsService) Collect(parent string) *ProjectsLocationsCatalogsEventStoresUserEventsCollectCall {
c := &ProjectsLocationsCatalogsEventStoresUserEventsCollectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5143,9 +5144,9 @@ type ProjectsLocationsCatalogsEventStoresUserEventsImportCall struct {
// be successfully inserted. Operation.metadata is of type
// ImportMetadata.
//
-// - parent:
-// `projects/1234/locations/global/catalogs/default_catalog/eventStores
-// /default_event_store`.
+// - parent:
+// `projects/1234/locations/global/catalogs/default_catalog/eventStores
+// /default_event_store`.
func (r *ProjectsLocationsCatalogsEventStoresUserEventsService) Import(parent string, googlecloudrecommendationenginev1beta1importusereventsrequest *GoogleCloudRecommendationengineV1beta1ImportUserEventsRequest) *ProjectsLocationsCatalogsEventStoresUserEventsImportCall {
c := &ProjectsLocationsCatalogsEventStoresUserEventsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5293,9 +5294,9 @@ type ProjectsLocationsCatalogsEventStoresUserEventsListCall struct {
// of the ingested event is not in the current catalog, it could lead to
// degraded model quality. This is called an unjoined event.
//
-// - parent: The parent eventStore resource name, such as
-// `projects/*/locations/*/catalogs/default_catalog/eventStores/default
-// _event_store`.
+// - parent: The parent eventStore resource name, such as
+// `projects/*/locations/*/catalogs/default_catalog/eventStores/default
+// _event_store`.
func (r *ProjectsLocationsCatalogsEventStoresUserEventsService) List(parent string) *ProjectsLocationsCatalogsEventStoresUserEventsListCall {
c := &ProjectsLocationsCatalogsEventStoresUserEventsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5526,10 +5527,10 @@ type ProjectsLocationsCatalogsEventStoresUserEventsPurgeCall struct {
// this operation could take hours or days to complete. To test a
// filter, use the list command first.
//
-// - parent: The resource name of the event_store under which the events
-// are created. The format is
-// `projects/${projectId}/locations/global/catalogs/${catalogId}/eventS
-// tores/${eventStoreId}`.
+// - parent: The resource name of the event_store under which the events
+// are created. The format is
+// `projects/${projectId}/locations/global/catalogs/${catalogId}/eventS
+// tores/${eventStoreId}`.
func (r *ProjectsLocationsCatalogsEventStoresUserEventsService) Purge(parent string, googlecloudrecommendationenginev1beta1purgeusereventsrequest *GoogleCloudRecommendationengineV1beta1PurgeUserEventsRequest) *ProjectsLocationsCatalogsEventStoresUserEventsPurgeCall {
c := &ProjectsLocationsCatalogsEventStoresUserEventsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5678,9 +5679,9 @@ type ProjectsLocationsCatalogsEventStoresUserEventsRejoinCall struct {
// It can also be used to correct events joined with wrong catalog
// items.
//
-// - parent: Full resource name of user event, such as
-// `projects/*/locations/*/catalogs/default_catalog/eventStores/default
-// _event_store`.
+// - parent: Full resource name of user event, such as
+// `projects/*/locations/*/catalogs/default_catalog/eventStores/default
+// _event_store`.
func (r *ProjectsLocationsCatalogsEventStoresUserEventsService) Rejoin(parent string, googlecloudrecommendationenginev1beta1rejoinusereventsrequest *GoogleCloudRecommendationengineV1beta1RejoinUserEventsRequest) *ProjectsLocationsCatalogsEventStoresUserEventsRejoinCall {
c := &ProjectsLocationsCatalogsEventStoresUserEventsRejoinCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5822,9 +5823,9 @@ type ProjectsLocationsCatalogsEventStoresUserEventsWriteCall struct {
// Write: Writes a single user event.
//
-// - parent: The parent eventStore resource name, such as
-// "projects/1234/locations/global/catalogs/default_catalog/eventStores
-// /default_event_store".
+// - parent: The parent eventStore resource name, such as
+// "projects/1234/locations/global/catalogs/default_catalog/eventStores
+// /default_event_store".
func (r *ProjectsLocationsCatalogsEventStoresUserEventsService) Write(parent string, googlecloudrecommendationenginev1beta1userevent *GoogleCloudRecommendationengineV1beta1UserEvent) *ProjectsLocationsCatalogsEventStoresUserEventsWriteCall {
c := &ProjectsLocationsCatalogsEventStoresUserEventsWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5890,7 +5891,9 @@ func (c *ProjectsLocationsCatalogsEventStoresUserEventsWriteCall) doRequest(alt
// error will be non-nil. Any non-2xx status code is an error. Response
// headers are in either
// *GoogleCloudRecommendationengineV1beta1UserEvent.ServerResponse.Header
-// or (if a response was returned at all) in
+//
+// or (if a response was returned at all) in
+//
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
diff --git a/recommender/v1/recommender-gen.go b/recommender/v1/recommender-gen.go
index e8fc30310d7..8453a6cf109 100644
--- a/recommender/v1/recommender-gen.go
+++ b/recommender/v1/recommender-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recommender/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/recommender/v1"
-// ...
-// ctx := context.Background()
-// recommenderService, err := recommender.NewService(ctx)
+// import "google.golang.org/api/recommender/v1"
+// ...
+// ctx := context.Background()
+// recommenderService, err := recommender.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// recommenderService, err := recommender.NewService(ctx, option.WithAPIKey("AIza..."))
+// recommenderService, err := recommender.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// recommenderService, err := recommender.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// recommenderService, err := recommender.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package recommender // import "google.golang.org/api/recommender/v1"
@@ -1681,21 +1681,21 @@ type BillingAccountsLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *BillingAccountsLocationsInsightTypesInsightsService) List(parent string) *BillingAccountsLocationsInsightTypesInsightsListCall {
c := &BillingAccountsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2209,21 +2209,21 @@ type BillingAccountsLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *BillingAccountsLocationsRecommendersRecommendationsService) List(parent string) *BillingAccountsLocationsRecommendersRecommendationsListCall {
c := &BillingAccountsLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3038,21 +3038,21 @@ type FoldersLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *FoldersLocationsInsightTypesInsightsService) List(parent string) *FoldersLocationsInsightTypesInsightsListCall {
c := &FoldersLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3566,21 +3566,21 @@ type FoldersLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *FoldersLocationsRecommendersRecommendationsService) List(parent string) *FoldersLocationsRecommendersRecommendationsListCall {
c := &FoldersLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4248,13 +4248,13 @@ type OrganizationsLocationsInsightTypesGetConfigCall struct {
// GetConfig: Gets the requested InsightTypeConfig. There is only one
// instance of the config for each InsightType.
//
-// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
-// PE_ID]/config` *
-// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
-// D]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
-// GHT_TYPE_ID]/config`.
+// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
+// PE_ID]/config` *
+// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
+// D]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
+// GHT_TYPE_ID]/config`.
func (r *OrganizationsLocationsInsightTypesService) GetConfig(name string) *OrganizationsLocationsInsightTypesGetConfigCall {
c := &OrganizationsLocationsInsightTypesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4403,9 +4403,9 @@ type OrganizationsLocationsInsightTypesUpdateConfigCall struct {
// UpdateConfig: Updates an InsightTypeConfig change. This will create a
// new revision of the config.
//
-// - name: Name of insight type config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
-// _TYPE_ID]/config.
+// - name: Name of insight type config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
+// _TYPE_ID]/config.
func (r *OrganizationsLocationsInsightTypesService) UpdateConfig(name string, googlecloudrecommenderv1insighttypeconfig *GoogleCloudRecommenderV1InsightTypeConfig) *OrganizationsLocationsInsightTypesUpdateConfigCall {
c := &OrganizationsLocationsInsightTypesUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4723,21 +4723,21 @@ type OrganizationsLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *OrganizationsLocationsInsightTypesInsightsService) List(parent string) *OrganizationsLocationsInsightTypesInsightsListCall {
c := &OrganizationsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5102,14 +5102,14 @@ type OrganizationsLocationsRecommendersGetConfigCall struct {
// GetConfig: Gets the requested Recommender Config. There is only one
// instance of the config for each Recommender.
//
-// - name: Name of the Recommendation Config to get. Acceptable formats:
-// *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]/config` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]/config`.
+// - name: Name of the Recommendation Config to get. Acceptable formats:
+// *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]/config` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]/config`.
func (r *OrganizationsLocationsRecommendersService) GetConfig(name string) *OrganizationsLocationsRecommendersGetConfigCall {
c := &OrganizationsLocationsRecommendersGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5258,9 +5258,9 @@ type OrganizationsLocationsRecommendersUpdateConfigCall struct {
// UpdateConfig: Updates a Recommender Config. This will create a new
// revision of the config.
//
-// - name: Name of recommender config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
-// NDER_ID]/config.
+// - name: Name of recommender config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
+// NDER_ID]/config.
func (r *OrganizationsLocationsRecommendersService) UpdateConfig(name string, googlecloudrecommenderv1recommenderconfig *GoogleCloudRecommenderV1RecommenderConfig) *OrganizationsLocationsRecommendersUpdateConfigCall {
c := &OrganizationsLocationsRecommendersUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5580,21 +5580,21 @@ type OrganizationsLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *OrganizationsLocationsRecommendersRecommendationsService) List(parent string) *OrganizationsLocationsRecommendersRecommendationsListCall {
c := &OrganizationsLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6262,13 +6262,13 @@ type ProjectsLocationsInsightTypesGetConfigCall struct {
// GetConfig: Gets the requested InsightTypeConfig. There is only one
// instance of the config for each InsightType.
//
-// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
-// PE_ID]/config` *
-// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
-// D]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
-// GHT_TYPE_ID]/config`.
+// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
+// PE_ID]/config` *
+// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
+// D]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
+// GHT_TYPE_ID]/config`.
func (r *ProjectsLocationsInsightTypesService) GetConfig(name string) *ProjectsLocationsInsightTypesGetConfigCall {
c := &ProjectsLocationsInsightTypesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6417,9 +6417,9 @@ type ProjectsLocationsInsightTypesUpdateConfigCall struct {
// UpdateConfig: Updates an InsightTypeConfig change. This will create a
// new revision of the config.
//
-// - name: Name of insight type config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
-// _TYPE_ID]/config.
+// - name: Name of insight type config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
+// _TYPE_ID]/config.
func (r *ProjectsLocationsInsightTypesService) UpdateConfig(name string, googlecloudrecommenderv1insighttypeconfig *GoogleCloudRecommenderV1InsightTypeConfig) *ProjectsLocationsInsightTypesUpdateConfigCall {
c := &ProjectsLocationsInsightTypesUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6737,21 +6737,21 @@ type ProjectsLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *ProjectsLocationsInsightTypesInsightsService) List(parent string) *ProjectsLocationsInsightTypesInsightsListCall {
c := &ProjectsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7116,14 +7116,14 @@ type ProjectsLocationsRecommendersGetConfigCall struct {
// GetConfig: Gets the requested Recommender Config. There is only one
// instance of the config for each Recommender.
//
-// - name: Name of the Recommendation Config to get. Acceptable formats:
-// *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]/config` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]/config`.
+// - name: Name of the Recommendation Config to get. Acceptable formats:
+// *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]/config` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]/config`.
func (r *ProjectsLocationsRecommendersService) GetConfig(name string) *ProjectsLocationsRecommendersGetConfigCall {
c := &ProjectsLocationsRecommendersGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7272,9 +7272,9 @@ type ProjectsLocationsRecommendersUpdateConfigCall struct {
// UpdateConfig: Updates a Recommender Config. This will create a new
// revision of the config.
//
-// - name: Name of recommender config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
-// NDER_ID]/config.
+// - name: Name of recommender config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
+// NDER_ID]/config.
func (r *ProjectsLocationsRecommendersService) UpdateConfig(name string, googlecloudrecommenderv1recommenderconfig *GoogleCloudRecommenderV1RecommenderConfig) *ProjectsLocationsRecommendersUpdateConfigCall {
c := &ProjectsLocationsRecommendersUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7594,21 +7594,21 @@ type ProjectsLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *ProjectsLocationsRecommendersRecommendationsService) List(parent string) *ProjectsLocationsRecommendersRecommendationsListCall {
c := &ProjectsLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/recommender/v1beta1/recommender-gen.go b/recommender/v1beta1/recommender-gen.go
index 88d4f41e9f8..1094e87b8e3 100644
--- a/recommender/v1beta1/recommender-gen.go
+++ b/recommender/v1beta1/recommender-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recommender/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/recommender/v1beta1"
-// ...
-// ctx := context.Background()
-// recommenderService, err := recommender.NewService(ctx)
+// import "google.golang.org/api/recommender/v1beta1"
+// ...
+// ctx := context.Background()
+// recommenderService, err := recommender.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// recommenderService, err := recommender.NewService(ctx, option.WithAPIKey("AIza..."))
+// recommenderService, err := recommender.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// recommenderService, err := recommender.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// recommenderService, err := recommender.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package recommender // import "google.golang.org/api/recommender/v1beta1"
@@ -1736,21 +1736,21 @@ type BillingAccountsLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *BillingAccountsLocationsInsightTypesInsightsService) List(parent string) *BillingAccountsLocationsInsightTypesInsightsListCall {
c := &BillingAccountsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2266,21 +2266,21 @@ type BillingAccountsLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *BillingAccountsLocationsRecommendersRecommendationsService) List(parent string) *BillingAccountsLocationsRecommendersRecommendationsListCall {
c := &BillingAccountsLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3099,21 +3099,21 @@ type FoldersLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *FoldersLocationsInsightTypesInsightsService) List(parent string) *FoldersLocationsInsightTypesInsightsListCall {
c := &FoldersLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3629,21 +3629,21 @@ type FoldersLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *FoldersLocationsRecommendersRecommendationsService) List(parent string) *FoldersLocationsRecommendersRecommendationsListCall {
c := &FoldersLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4314,13 +4314,13 @@ type OrganizationsLocationsInsightTypesGetConfigCall struct {
// GetConfig: Gets the requested InsightTypeConfig. There is only one
// instance of the config for each InsightType.
//
-// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
-// PE_ID]/config` *
-// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
-// D]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
-// GHT_TYPE_ID]/config`.
+// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
+// PE_ID]/config` *
+// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
+// D]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
+// GHT_TYPE_ID]/config`.
func (r *OrganizationsLocationsInsightTypesService) GetConfig(name string) *OrganizationsLocationsInsightTypesGetConfigCall {
c := &OrganizationsLocationsInsightTypesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4469,9 +4469,9 @@ type OrganizationsLocationsInsightTypesUpdateConfigCall struct {
// UpdateConfig: Updates an InsightTypeConfig change. This will create a
// new revision of the config.
//
-// - name: Name of insight type config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
-// _TYPE_ID]/config.
+// - name: Name of insight type config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
+// _TYPE_ID]/config.
func (r *OrganizationsLocationsInsightTypesService) UpdateConfig(name string, googlecloudrecommenderv1beta1insighttypeconfig *GoogleCloudRecommenderV1beta1InsightTypeConfig) *OrganizationsLocationsInsightTypesUpdateConfigCall {
c := &OrganizationsLocationsInsightTypesUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4790,21 +4790,21 @@ type OrganizationsLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *OrganizationsLocationsInsightTypesInsightsService) List(parent string) *OrganizationsLocationsInsightTypesInsightsListCall {
c := &OrganizationsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5170,14 +5170,14 @@ type OrganizationsLocationsRecommendersGetConfigCall struct {
// GetConfig: Gets the requested Recommender Config. There is only one
// instance of the config for each Recommender.
//
-// - name: Name of the Recommendation Config to get. Acceptable formats:
-// *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]/config` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]/config`.
+// - name: Name of the Recommendation Config to get. Acceptable formats:
+// *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]/config` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]/config`.
func (r *OrganizationsLocationsRecommendersService) GetConfig(name string) *OrganizationsLocationsRecommendersGetConfigCall {
c := &OrganizationsLocationsRecommendersGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5326,9 +5326,9 @@ type OrganizationsLocationsRecommendersUpdateConfigCall struct {
// UpdateConfig: Updates a Recommender Config. This will create a new
// revision of the config.
//
-// - name: Name of recommender config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
-// NDER_ID]/config.
+// - name: Name of recommender config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
+// NDER_ID]/config.
func (r *OrganizationsLocationsRecommendersService) UpdateConfig(name string, googlecloudrecommenderv1beta1recommenderconfig *GoogleCloudRecommenderV1beta1RecommenderConfig) *OrganizationsLocationsRecommendersUpdateConfigCall {
c := &OrganizationsLocationsRecommendersUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5649,21 +5649,21 @@ type OrganizationsLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *OrganizationsLocationsRecommendersRecommendationsService) List(parent string) *OrganizationsLocationsRecommendersRecommendationsListCall {
c := &OrganizationsLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6334,13 +6334,13 @@ type ProjectsLocationsInsightTypesGetConfigCall struct {
// GetConfig: Gets the requested InsightTypeConfig. There is only one
// instance of the config for each InsightType.
//
-// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
-// PE_ID]/config` *
-// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
-// D]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
-// GHT_TYPE_ID]/config`.
+// - name: Name of the InsightTypeConfig to get. Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/global/recommenders/[INSIGHT_TY
+// PE_ID]/config` *
+// `projects/[PROJECT_ID]/locations/global/recommenders/[INSIGHT_TYPE_I
+// D]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/global/recommenders/[INSI
+// GHT_TYPE_ID]/config`.
func (r *ProjectsLocationsInsightTypesService) GetConfig(name string) *ProjectsLocationsInsightTypesGetConfigCall {
c := &ProjectsLocationsInsightTypesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6489,9 +6489,9 @@ type ProjectsLocationsInsightTypesUpdateConfigCall struct {
// UpdateConfig: Updates an InsightTypeConfig change. This will create a
// new revision of the config.
//
-// - name: Name of insight type config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
-// _TYPE_ID]/config.
+// - name: Name of insight type config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT
+// _TYPE_ID]/config.
func (r *ProjectsLocationsInsightTypesService) UpdateConfig(name string, googlecloudrecommenderv1beta1insighttypeconfig *GoogleCloudRecommenderV1beta1InsightTypeConfig) *ProjectsLocationsInsightTypesUpdateConfigCall {
c := &ProjectsLocationsInsightTypesUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6810,21 +6810,21 @@ type ProjectsLocationsInsightTypesInsightsListCall struct {
// List: Lists insights for the specified Cloud Resource. Requires the
// recommender.*.list IAM permission for the specified insight type.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
-// T_TYPE_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
-// PE_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
-// pes/[INSIGHT_TYPE_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
-// _ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
-// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
-// supported insight types:
-// https://cloud.google.com/recommender/docs/insights/insight-types.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH
+// T_TYPE_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TY
+// PE_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy
+// pes/[INSIGHT_TYPE_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE
+// _ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[
+// INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to
+// supported insight types:
+// https://cloud.google.com/recommender/docs/insights/insight-types.
func (r *ProjectsLocationsInsightTypesInsightsService) List(parent string) *ProjectsLocationsInsightTypesInsightsListCall {
c := &ProjectsLocationsInsightTypesInsightsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7190,14 +7190,14 @@ type ProjectsLocationsRecommendersGetConfigCall struct {
// GetConfig: Gets the requested Recommender Config. There is only one
// instance of the config for each Recommender.
//
-// - name: Name of the Recommendation Config to get. Acceptable formats:
-// *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]/config` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]/config` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]/config`.
+// - name: Name of the Recommendation Config to get. Acceptable formats:
+// *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]/config` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]/config` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]/config`.
func (r *ProjectsLocationsRecommendersService) GetConfig(name string) *ProjectsLocationsRecommendersGetConfigCall {
c := &ProjectsLocationsRecommendersGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7346,9 +7346,9 @@ type ProjectsLocationsRecommendersUpdateConfigCall struct {
// UpdateConfig: Updates a Recommender Config. This will create a new
// revision of the config.
//
-// - name: Name of recommender config. Eg,
-// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
-// NDER_ID]/config.
+// - name: Name of recommender config. Eg,
+// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMME
+// NDER_ID]/config.
func (r *ProjectsLocationsRecommendersService) UpdateConfig(name string, googlecloudrecommenderv1beta1recommenderconfig *GoogleCloudRecommenderV1beta1RecommenderConfig) *ProjectsLocationsRecommendersUpdateConfigCall {
c := &ProjectsLocationsRecommendersUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7669,21 +7669,21 @@ type ProjectsLocationsRecommendersRecommendationsListCall struct {
// Requires the recommender.*.list IAM permission for the specified
// recommender.
//
-// - parent: The container resource on which to execute the request.
-// Acceptable formats: *
-// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
-// ENDER_ID]` *
-// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
-// R_ID]` *
-// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
-// ers/[RECOMMENDER_ID]` *
-// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
-// ID]` *
-// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
-// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
-// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
-// supported recommenders:
-// https://cloud.google.com/recommender/docs/recommenders.
+// - parent: The container resource on which to execute the request.
+// Acceptable formats: *
+// `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM
+// ENDER_ID]` *
+// `projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDE
+// R_ID]` *
+// `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend
+// ers/[RECOMMENDER_ID]` *
+// `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_
+// ID]` *
+// `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[
+// RECOMMENDER_ID]` LOCATION here refers to GCP Locations:
+// https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to
+// supported recommenders:
+// https://cloud.google.com/recommender/docs/recommenders.
func (r *ProjectsLocationsRecommendersRecommendationsService) List(parent string) *ProjectsLocationsRecommendersRecommendationsListCall {
c := &ProjectsLocationsRecommendersRecommendationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/redis/v1/redis-gen.go b/redis/v1/redis-gen.go
index aad7c977c70..76d976e4dca 100644
--- a/redis/v1/redis-gen.go
+++ b/redis/v1/redis-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/memorystore/docs/redis/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/redis/v1"
-// ...
-// ctx := context.Background()
-// redisService, err := redis.NewService(ctx)
+// import "google.golang.org/api/redis/v1"
+// ...
+// ctx := context.Background()
+// redisService, err := redis.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// redisService, err := redis.NewService(ctx, option.WithAPIKey("AIza..."))
+// redisService, err := redis.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// redisService, err := redis.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// redisService, err := redis.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package redis // import "google.golang.org/api/redis/v1"
@@ -1606,8 +1606,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1822,9 +1822,9 @@ type ProjectsLocationsInstancesCreateCall struct {
// response field. The returned operation is automatically deleted after
// a few hours, so there is no need to call DeleteOperation.
//
-// - parent: The resource name of the instance location using the form:
-// `projects/{project_id}/locations/{location_id}` where `location_id`
-// refers to a GCP region.
+// - parent: The resource name of the instance location using the form:
+// `projects/{project_id}/locations/{location_id}` where `location_id`
+// refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall {
c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1982,9 +1982,9 @@ type ProjectsLocationsInstancesDeleteCall struct {
// Delete: Deletes a specific Redis instance. Instance stops serving and
// data is deleted.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Delete(name string) *ProjectsLocationsInstancesDeleteCall {
c := &ProjectsLocationsInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2120,9 +2120,9 @@ type ProjectsLocationsInstancesExportCall struct {
// returned operation is automatically deleted after a few hours, so
// there is no need to call DeleteOperation.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Export(name string, exportinstancerequest *ExportInstanceRequest) *ProjectsLocationsInstancesExportCall {
c := &ProjectsLocationsInstancesExportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2266,9 +2266,9 @@ type ProjectsLocationsInstancesFailoverCall struct {
// node for a specific STANDARD tier Cloud Memorystore for Redis
// instance.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Failover(name string, failoverinstancerequest *FailoverInstanceRequest) *ProjectsLocationsInstancesFailoverCall {
c := &ProjectsLocationsInstancesFailoverCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2410,9 +2410,9 @@ type ProjectsLocationsInstancesGetCall struct {
// Get: Gets the details of a specific Redis instance.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Get(name string) *ProjectsLocationsInstancesGetCall {
c := &ProjectsLocationsInstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2560,9 +2560,9 @@ type ProjectsLocationsInstancesGetAuthStringCall struct {
// not enabled for the instance the response will be empty. This
// information is not included in the details returned to GetInstance.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) GetAuthString(name string) *ProjectsLocationsInstancesGetAuthStringCall {
c := &ProjectsLocationsInstancesGetAuthStringCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2713,9 +2713,9 @@ type ProjectsLocationsInstancesImportCall struct {
// returned operation is automatically deleted after a few hours, so
// there is no need to call DeleteOperation.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Import(name string, importinstancerequest *ImportInstanceRequest) *ProjectsLocationsInstancesImportCall {
c := &ProjectsLocationsInstancesImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2862,9 +2862,9 @@ type ProjectsLocationsInstancesListCall struct {
// specified as `-` (wildcard), then all regions available to the
// project are queried, and the results are aggregated.
//
-// - parent: The resource name of the instance location using the form:
-// `projects/{project_id}/locations/{location_id}` where `location_id`
-// refers to a GCP region.
+// - parent: The resource name of the instance location using the form:
+// `projects/{project_id}/locations/{location_id}` where `location_id`
+// refers to a GCP region.
func (r *ProjectsLocationsInstancesService) List(parent string) *ProjectsLocationsInstancesListCall {
c := &ProjectsLocationsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3065,14 +3065,14 @@ type ProjectsLocationsInstancesPatchCall struct {
// automatically deleted after a few hours, so there is no need to call
// DeleteOperation.
//
-// - name: Unique name of the resource in this scope including project
-// and location using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` Note: Redis instances are managed and addressed at regional
-// level so location_id here refers to a GCP region; however, users
-// may choose which specific zone (or collection of zones for
-// cross-zone instances) an instance should be provisioned in. Refer
-// to location_id and alternative_location_id fields for more details.
+// - name: Unique name of the resource in this scope including project
+// and location using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` Note: Redis instances are managed and addressed at regional
+// level so location_id here refers to a GCP region; however, users
+// may choose which specific zone (or collection of zones for
+// cross-zone instances) an instance should be provisioned in. Refer
+// to location_id and alternative_location_id fields for more details.
func (r *ProjectsLocationsInstancesService) Patch(name string, instance *Instance) *ProjectsLocationsInstancesPatchCall {
c := &ProjectsLocationsInstancesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3231,9 +3231,9 @@ type ProjectsLocationsInstancesRescheduleMaintenanceCall struct {
// RescheduleMaintenance: Reschedule maintenance for a given instance in
// a given project and location.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) RescheduleMaintenance(name string, reschedulemaintenancerequest *RescheduleMaintenanceRequest) *ProjectsLocationsInstancesRescheduleMaintenanceCall {
c := &ProjectsLocationsInstancesRescheduleMaintenanceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3376,9 +3376,9 @@ type ProjectsLocationsInstancesUpgradeCall struct {
// Upgrade: Upgrades Redis instance to the newer Redis version specified
// in the request.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Upgrade(name string, upgradeinstancerequest *UpgradeInstanceRequest) *ProjectsLocationsInstancesUpgradeCall {
c := &ProjectsLocationsInstancesUpgradeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/redis/v1beta1/redis-gen.go b/redis/v1beta1/redis-gen.go
index b0031dac633..4cb4944b64f 100644
--- a/redis/v1beta1/redis-gen.go
+++ b/redis/v1beta1/redis-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/memorystore/docs/redis/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/redis/v1beta1"
-// ...
-// ctx := context.Background()
-// redisService, err := redis.NewService(ctx)
+// import "google.golang.org/api/redis/v1beta1"
+// ...
+// ctx := context.Background()
+// redisService, err := redis.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// redisService, err := redis.NewService(ctx, option.WithAPIKey("AIza..."))
+// redisService, err := redis.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// redisService, err := redis.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// redisService, err := redis.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package redis // import "google.golang.org/api/redis/v1beta1"
@@ -1619,8 +1619,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1835,9 +1835,9 @@ type ProjectsLocationsInstancesCreateCall struct {
// response field. The returned operation is automatically deleted after
// a few hours, so there is no need to call DeleteOperation.
//
-// - parent: The resource name of the instance location using the form:
-// `projects/{project_id}/locations/{location_id}` where `location_id`
-// refers to a GCP region.
+// - parent: The resource name of the instance location using the form:
+// `projects/{project_id}/locations/{location_id}` where `location_id`
+// refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Create(parent string, instance *Instance) *ProjectsLocationsInstancesCreateCall {
c := &ProjectsLocationsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1995,9 +1995,9 @@ type ProjectsLocationsInstancesDeleteCall struct {
// Delete: Deletes a specific Redis instance. Instance stops serving and
// data is deleted.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Delete(name string) *ProjectsLocationsInstancesDeleteCall {
c := &ProjectsLocationsInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2133,9 +2133,9 @@ type ProjectsLocationsInstancesExportCall struct {
// returned operation is automatically deleted after a few hours, so
// there is no need to call DeleteOperation.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Export(name string, exportinstancerequest *ExportInstanceRequest) *ProjectsLocationsInstancesExportCall {
c := &ProjectsLocationsInstancesExportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2279,9 +2279,9 @@ type ProjectsLocationsInstancesFailoverCall struct {
// node for a specific STANDARD tier Cloud Memorystore for Redis
// instance.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Failover(name string, failoverinstancerequest *FailoverInstanceRequest) *ProjectsLocationsInstancesFailoverCall {
c := &ProjectsLocationsInstancesFailoverCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2423,9 +2423,9 @@ type ProjectsLocationsInstancesGetCall struct {
// Get: Gets the details of a specific Redis instance.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Get(name string) *ProjectsLocationsInstancesGetCall {
c := &ProjectsLocationsInstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2573,9 +2573,9 @@ type ProjectsLocationsInstancesGetAuthStringCall struct {
// not enabled for the instance the response will be empty. This
// information is not included in the details returned to GetInstance.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) GetAuthString(name string) *ProjectsLocationsInstancesGetAuthStringCall {
c := &ProjectsLocationsInstancesGetAuthStringCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2726,9 +2726,9 @@ type ProjectsLocationsInstancesImportCall struct {
// returned operation is automatically deleted after a few hours, so
// there is no need to call DeleteOperation.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Import(name string, importinstancerequest *ImportInstanceRequest) *ProjectsLocationsInstancesImportCall {
c := &ProjectsLocationsInstancesImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2875,9 +2875,9 @@ type ProjectsLocationsInstancesListCall struct {
// specified as `-` (wildcard), then all regions available to the
// project are queried, and the results are aggregated.
//
-// - parent: The resource name of the instance location using the form:
-// `projects/{project_id}/locations/{location_id}` where `location_id`
-// refers to a GCP region.
+// - parent: The resource name of the instance location using the form:
+// `projects/{project_id}/locations/{location_id}` where `location_id`
+// refers to a GCP region.
func (r *ProjectsLocationsInstancesService) List(parent string) *ProjectsLocationsInstancesListCall {
c := &ProjectsLocationsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3078,14 +3078,14 @@ type ProjectsLocationsInstancesPatchCall struct {
// automatically deleted after a few hours, so there is no need to call
// DeleteOperation.
//
-// - name: Unique name of the resource in this scope including project
-// and location using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` Note: Redis instances are managed and addressed at regional
-// level so location_id here refers to a GCP region; however, users
-// may choose which specific zone (or collection of zones for
-// cross-zone instances) an instance should be provisioned in. Refer
-// to location_id and alternative_location_id fields for more details.
+// - name: Unique name of the resource in this scope including project
+// and location using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` Note: Redis instances are managed and addressed at regional
+// level so location_id here refers to a GCP region; however, users
+// may choose which specific zone (or collection of zones for
+// cross-zone instances) an instance should be provisioned in. Refer
+// to location_id and alternative_location_id fields for more details.
func (r *ProjectsLocationsInstancesService) Patch(name string, instance *Instance) *ProjectsLocationsInstancesPatchCall {
c := &ProjectsLocationsInstancesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3244,9 +3244,9 @@ type ProjectsLocationsInstancesRescheduleMaintenanceCall struct {
// RescheduleMaintenance: Reschedule maintenance for a given instance in
// a given project and location.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) RescheduleMaintenance(name string, reschedulemaintenancerequest *RescheduleMaintenanceRequest) *ProjectsLocationsInstancesRescheduleMaintenanceCall {
c := &ProjectsLocationsInstancesRescheduleMaintenanceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3389,9 +3389,9 @@ type ProjectsLocationsInstancesUpgradeCall struct {
// Upgrade: Upgrades Redis instance to the newer Redis version specified
// in the request.
//
-// - name: Redis instance resource name using the form:
-// `projects/{project_id}/locations/{location_id}/instances/{instance_i
-// d}` where `location_id` refers to a GCP region.
+// - name: Redis instance resource name using the form:
+// `projects/{project_id}/locations/{location_id}/instances/{instance_i
+// d}` where `location_id` refers to a GCP region.
func (r *ProjectsLocationsInstancesService) Upgrade(name string, upgradeinstancerequest *UpgradeInstanceRequest) *ProjectsLocationsInstancesUpgradeCall {
c := &ProjectsLocationsInstancesUpgradeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/remotebuildexecution/v1/remotebuildexecution-gen.go b/remotebuildexecution/v1/remotebuildexecution-gen.go
index 2590cd7069b..6d8aea69d58 100644
--- a/remotebuildexecution/v1/remotebuildexecution-gen.go
+++ b/remotebuildexecution/v1/remotebuildexecution-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/remote-build-execution/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/remotebuildexecution/v1"
-// ...
-// ctx := context.Background()
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx)
+// import "google.golang.org/api/remotebuildexecution/v1"
+// ...
+// ctx := context.Background()
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithAPIKey("AIza..."))
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package remotebuildexecution // import "google.golang.org/api/remotebuildexecution/v1"
@@ -2011,7 +2011,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest:
-// The request used for `CreateWorkerPool`.
+//
+// The request used for `CreateWorkerPool`.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest struct {
// Parent: Resource name of the instance in which to create the new
// worker pool. Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
@@ -2081,7 +2082,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteWorkerPoolRequest:
-// The request used for DeleteWorkerPool.
+//
+// The request used for DeleteWorkerPool.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteWorkerPoolRequest struct {
// Name: Name of the worker pool to delete. Format:
// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]`.
@@ -2532,7 +2534,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest:
-// The request used for UpdateWorkerPool.
+//
+// The request used for UpdateWorkerPool.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest struct {
// UpdateMask: The update mask applies to worker_pool. For the
// `FieldMask` definition, see
@@ -3499,8 +3502,8 @@ type MediaDownloadCall struct {
// Download: Downloads media. Download is supported on the URI
// `/v1/media/{+name}?alt=media`.
//
-// - resourceName: Name of the media that is being downloaded. See
-// ReadRequest.resource_name.
+// - resourceName: Name of the media that is being downloaded. See
+// ReadRequest.resource_name.
func (r *MediaService) Download(resourceName string) *MediaDownloadCall {
c := &MediaDownloadCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resourceName = resourceName
@@ -3665,8 +3668,8 @@ type MediaUploadCall struct {
// Upload: Uploads media. Upload is supported on the URI
// `/upload/v1/media/{+name}`.
//
-// - resourceName: Name of the media that is being downloaded. See
-// ReadRequest.resource_name.
+// - resourceName: Name of the media that is being downloaded. See
+// ReadRequest.resource_name.
func (r *MediaService) Upload(resourceName string, googlebytestreammedia *GoogleBytestreamMedia) *MediaUploadCall {
c := &MediaUploadCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resourceName = resourceName
diff --git a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go
index 8a72ed8bbfe..a3b7fd8f38e 100644
--- a/remotebuildexecution/v1alpha/remotebuildexecution-gen.go
+++ b/remotebuildexecution/v1alpha/remotebuildexecution-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/remote-build-execution/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/remotebuildexecution/v1alpha"
-// ...
-// ctx := context.Background()
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx)
+// import "google.golang.org/api/remotebuildexecution/v1alpha"
+// ...
+// ctx := context.Background()
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithAPIKey("AIza..."))
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package remotebuildexecution // import "google.golang.org/api/remotebuildexecution/v1alpha"
@@ -1979,7 +1979,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest:
-// The request used for `CreateWorkerPool`.
+//
+// The request used for `CreateWorkerPool`.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest struct {
// Parent: Resource name of the instance in which to create the new
// worker pool. Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
@@ -2049,7 +2050,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteWorkerPoolRequest:
-// The request used for DeleteWorkerPool.
+//
+// The request used for DeleteWorkerPool.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteWorkerPoolRequest struct {
// Name: Name of the worker pool to delete. Format:
// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]`.
@@ -2512,7 +2514,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest:
-// The request used for UpdateWorkerPool.
+//
+// The request used for UpdateWorkerPool.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest struct {
// UpdateMask: The update mask applies to worker_pool. For the
// `FieldMask` definition, see
@@ -3431,8 +3434,8 @@ type ProjectsInstancesCreateCall struct {
// While the long running operation is in progress, any call to
// `GetInstance` returns an instance in state `CREATING`.
//
-// - parent: Resource name of the project containing the instance.
-// Format: `projects/[PROJECT_ID]`.
+// - parent: Resource name of the project containing the instance.
+// Format: `projects/[PROJECT_ID]`.
func (r *ProjectsInstancesService) Create(parent string, googledevtoolsremotebuildexecutionadminv1alphacreateinstancerequest *GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateInstanceRequest) *ProjectsInstancesCreateCall {
c := &ProjectsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3576,8 +3579,8 @@ type ProjectsInstancesDeleteCall struct {
// completion. Deleting an instance with worker pools in it will delete
// these worker pools.
//
-// - name: Name of the instance to delete. Format:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
+// - name: Name of the instance to delete. Format:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
func (r *ProjectsInstancesService) Delete(name string) *ProjectsInstancesDeleteCall {
c := &ProjectsInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3710,8 +3713,8 @@ type ProjectsInstancesGetCall struct {
// Get: Returns the specified instance.
//
-// - name: Name of the instance to retrieve. Format:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
+// - name: Name of the instance to retrieve. Format:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
func (r *ProjectsInstancesService) Get(name string) *ProjectsInstancesGetCall {
c := &ProjectsInstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3860,8 +3863,8 @@ type ProjectsInstancesListCall struct {
// List: Lists instances in a project.
//
-// - parent: Resource name of the project. Format:
-// `projects/[PROJECT_ID]`.
+// - parent: Resource name of the project. Format:
+// `projects/[PROJECT_ID]`.
func (r *ProjectsInstancesService) List(parent string) *ProjectsInstancesListCall {
c := &ProjectsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4012,10 +4015,10 @@ type ProjectsInstancesPatchCall struct {
// operation which contains the updated instance in the response on
// completion.
//
-// - name: Output only. Instance resource name formatted as:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be
-// populated when creating an instance since it is provided in the
-// `instance_id` field.
+// - name: Output only. Instance resource name formatted as:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be
+// populated when creating an instance since it is provided in the
+// `instance_id` field.
func (r *ProjectsInstancesService) Patch(name string, googledevtoolsremotebuildexecutionadminv1alphainstance *GoogleDevtoolsRemotebuildexecutionAdminV1alphaInstance) *ProjectsInstancesPatchCall {
c := &ProjectsInstancesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4205,9 +4208,9 @@ type ProjectsInstancesWorkerpoolsCreateCall struct {
// progress, any call to `GetWorkerPool` returns a worker pool in state
// `CREATING`.
//
-// - parent: Resource name of the instance in which to create the new
-// worker pool. Format:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
+// - parent: Resource name of the instance in which to create the new
+// worker pool. Format:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
func (r *ProjectsInstancesWorkerpoolsService) Create(parent string, googledevtoolsremotebuildexecutionadminv1alphacreateworkerpoolrequest *GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest) *ProjectsInstancesWorkerpoolsCreateCall {
c := &ProjectsInstancesWorkerpoolsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4351,9 +4354,9 @@ type ProjectsInstancesWorkerpoolsDeleteCall struct {
// completion. While the long running operation is in progress, any call
// to `GetWorkerPool` returns a worker pool in state `DELETING`.
//
-// - name: Name of the worker pool to delete. Format:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]
-// `.
+// - name: Name of the worker pool to delete. Format:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]
+// `.
func (r *ProjectsInstancesWorkerpoolsService) Delete(name string) *ProjectsInstancesWorkerpoolsDeleteCall {
c := &ProjectsInstancesWorkerpoolsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4486,9 +4489,9 @@ type ProjectsInstancesWorkerpoolsGetCall struct {
// Get: Returns the specified worker pool.
//
-// - name: Name of the worker pool to retrieve. Format:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]
-// `.
+// - name: Name of the worker pool to retrieve. Format:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]
+// `.
func (r *ProjectsInstancesWorkerpoolsService) Get(name string) *ProjectsInstancesWorkerpoolsGetCall {
c := &ProjectsInstancesWorkerpoolsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4637,8 +4640,8 @@ type ProjectsInstancesWorkerpoolsListCall struct {
// List: Lists worker pools in an instance.
//
-// - parent: Resource name of the instance. Format:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
+// - parent: Resource name of the instance. Format:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
func (r *ProjectsInstancesWorkerpoolsService) List(parent string) *ProjectsInstancesWorkerpoolsListCall {
c := &ProjectsInstancesWorkerpoolsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4731,7 +4734,9 @@ func (c *ProjectsInstancesWorkerpoolsListCall) doRequest(alt string) (*http.Resp
// Do executes the "remotebuildexecution.projects.instances.workerpools.list" call.
// Exactly one of
// *GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsResponse
-// or error will be non-nil. Any non-2xx status code is an error.
+//
+// or error will be non-nil. Any non-2xx status code is an error.
+//
// Response headers are in either
// *GoogleDevtoolsRemotebuildexecutionAdminV1alphaListWorkerPoolsResponse
// .ServerResponse.Header or (if a response was returned at all) in
@@ -4818,10 +4823,10 @@ type ProjectsInstancesWorkerpoolsPatchCall struct {
// progress, any call to `GetWorkerPool` returns a worker pool in state
// `UPDATING`.
//
-// - name: WorkerPool resource name formatted as:
-// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]
-// `. name should not be populated when creating a worker pool since
-// it is provided in the `poolId` field.
+// - name: WorkerPool resource name formatted as:
+// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]
+// `. name should not be populated when creating a worker pool since
+// it is provided in the `poolId` field.
func (r *ProjectsInstancesWorkerpoolsService) Patch(name string, googledevtoolsremotebuildexecutionadminv1alphaupdateworkerpoolrequest *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest) *ProjectsInstancesWorkerpoolsPatchCall {
c := &ProjectsInstancesWorkerpoolsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/remotebuildexecution/v2/remotebuildexecution-gen.go b/remotebuildexecution/v2/remotebuildexecution-gen.go
index 12bfc0ce670..c0d2ebc1b03 100644
--- a/remotebuildexecution/v2/remotebuildexecution-gen.go
+++ b/remotebuildexecution/v2/remotebuildexecution-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/remote-build-execution/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/remotebuildexecution/v2"
-// ...
-// ctx := context.Background()
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx)
+// import "google.golang.org/api/remotebuildexecution/v2"
+// ...
+// ctx := context.Background()
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithAPIKey("AIza..."))
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// remotebuildexecutionService, err := remotebuildexecution.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package remotebuildexecution // import "google.golang.org/api/remotebuildexecution/v2"
@@ -2776,7 +2776,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest:
-// The request used for `CreateWorkerPool`.
+//
+// The request used for `CreateWorkerPool`.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaCreateWorkerPoolRequest struct {
// Parent: Resource name of the instance in which to create the new
// worker pool. Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
@@ -2846,7 +2847,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteWorkerPoolRequest:
-// The request used for DeleteWorkerPool.
+//
+// The request used for DeleteWorkerPool.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaDeleteWorkerPoolRequest struct {
// Name: Name of the worker pool to delete. Format:
// `projects/[PROJECT_ID]/instances/[INSTANCE_ID]/workerpools/[POOL_ID]`.
@@ -3297,7 +3299,8 @@ func (s *GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateInstanceRequest) Ma
}
// GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest:
-// The request used for UpdateWorkerPool.
+//
+// The request used for UpdateWorkerPool.
type GoogleDevtoolsRemotebuildexecutionAdminV1alphaUpdateWorkerPoolRequest struct {
// UpdateMask: The update mask applies to worker_pool. For the
// `FieldMask` definition, see
@@ -4216,14 +4219,14 @@ type ActionResultsGetCall struct {
// blobs SHOULD be increased if necessary and applicable. Errors: *
// `NOT_FOUND`: The requested `ActionResult` is not in the cache.
//
-// - hash: The hash. In the case of SHA-256, it will always be a
-// lowercase hex string exactly 64 characters long.
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
-// - sizeBytes: The size of the blob, in bytes.
+// - hash: The hash. In the case of SHA-256, it will always be a
+// lowercase hex string exactly 64 characters long.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
+// - sizeBytes: The size of the blob, in bytes.
func (r *ActionResultsService) Get(instanceName string, hash string, sizeBytes int64) *ActionResultsGetCall {
c := &ActionResultsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -4441,14 +4444,14 @@ type ActionResultsUpdateCall struct {
// `RESOURCE_EXHAUSTED`: There is insufficient storage space to add the
// entry to the cache.
//
-// - hash: The hash. In the case of SHA-256, it will always be a
-// lowercase hex string exactly 64 characters long.
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
-// - sizeBytes: The size of the blob, in bytes.
+// - hash: The hash. In the case of SHA-256, it will always be a
+// lowercase hex string exactly 64 characters long.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
+// - sizeBytes: The size of the blob, in bytes.
func (r *ActionResultsService) Update(instanceName string, hash string, sizeBytes int64, buildbazelremoteexecutionv2actionresult *BuildBazelRemoteExecutionV2ActionResult) *ActionResultsUpdateCall {
c := &ActionResultsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -4677,11 +4680,11 @@ type ActionsExecuteCall struct {
// times, potentially in parallel. These redundant executions MAY
// continue to run, even if the operation is completed.
//
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
func (r *ActionsService) Execute(instanceName string, buildbazelremoteexecutionv2executerequest *BuildBazelRemoteExecutionV2ExecuteRequest) *ActionsExecuteCall {
c := &ActionsExecuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -4832,11 +4835,11 @@ type BlobsBatchReadCall struct {
// the server supported limit. Every error on individual read will be
// returned in the corresponding digest status.
//
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
func (r *BlobsService) BatchRead(instanceName string, buildbazelremoteexecutionv2batchreadblobsrequest *BuildBazelRemoteExecutionV2BatchReadBlobsRequest) *BlobsBatchReadCall {
c := &BlobsBatchReadCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -4991,11 +4994,11 @@ type BlobsBatchUpdateCall struct {
// insufficient disk quota to store the blob. * `INVALID_ARGUMENT`: The
// Digest does not match the provided data.
//
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
func (r *BlobsService) BatchUpdate(instanceName string, buildbazelremoteexecutionv2batchupdateblobsrequest *BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest) *BlobsBatchUpdateCall {
c := &BlobsBatchUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -5143,11 +5146,11 @@ type BlobsFindMissingCall struct {
// Servers SHOULD increase the lifetimes of the referenced blobs if
// necessary and applicable. There are no method-specific errors.
//
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
func (r *BlobsService) FindMissing(instanceName string, buildbazelremoteexecutionv2findmissingblobsrequest *BuildBazelRemoteExecutionV2FindMissingBlobsRequest) *BlobsFindMissingCall {
c := &BlobsFindMissingCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -5306,14 +5309,14 @@ type BlobsGetTreeCall struct {
// portion present and omit the rest. Errors: * `NOT_FOUND`: The
// requested tree root is not present in the CAS.
//
-// - hash: The hash. In the case of SHA-256, it will always be a
-// lowercase hex string exactly 64 characters long.
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
-// - sizeBytes: The size of the blob, in bytes.
+// - hash: The hash. In the case of SHA-256, it will always be a
+// lowercase hex string exactly 64 characters long.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
+// - sizeBytes: The size of the blob, in bytes.
func (r *BlobsService) GetTree(instanceName string, hash string, sizeBytes int64) *BlobsGetTreeCall {
c := &BlobsGetTreeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
@@ -5686,11 +5689,11 @@ type V2GetCapabilitiesCall struct {
// ExecutionCapabilities. * CAS + Action Cache only endpoints should
// return CacheCapabilities.
//
-// - instanceName: The instance of the execution system to operate
-// against. A server may support multiple instances of the execution
-// system (with their own workers, storage, caches, etc.). The server
-// MAY require use of this field to select between them in an
-// implementation-defined fashion, otherwise it can be omitted.
+// - instanceName: The instance of the execution system to operate
+// against. A server may support multiple instances of the execution
+// system (with their own workers, storage, caches, etc.). The server
+// MAY require use of this field to select between them in an
+// implementation-defined fashion, otherwise it can be omitted.
func (r *V2Service) GetCapabilities(instanceName string) *V2GetCapabilitiesCall {
c := &V2GetCapabilitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.instanceName = instanceName
diff --git a/replicapool/v1beta1/replicapool-gen.go b/replicapool/v1beta1/replicapool-gen.go
index 26898d46585..080da53a9ef 100644
--- a/replicapool/v1beta1/replicapool-gen.go
+++ b/replicapool/v1beta1/replicapool-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/compute/docs/replica-pool/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/replicapool/v1beta1"
-// ...
-// ctx := context.Background()
-// replicapoolService, err := replicapool.NewService(ctx)
+// import "google.golang.org/api/replicapool/v1beta1"
+// ...
+// ctx := context.Background()
+// replicapoolService, err := replicapool.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// replicapoolService, err := replicapool.NewService(ctx, option.WithScopes(replicapool.ReplicapoolReadonlyScope))
+// replicapoolService, err := replicapool.NewService(ctx, option.WithScopes(replicapool.ReplicapoolReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// replicapoolService, err := replicapool.NewService(ctx, option.WithAPIKey("AIza..."))
+// replicapoolService, err := replicapool.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// replicapoolService, err := replicapool.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// replicapoolService, err := replicapool.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package replicapool // import "google.golang.org/api/replicapool/v1beta1"
diff --git a/replicapoolupdater/v1beta1/replicapoolupdater-gen.go b/replicapoolupdater/v1beta1/replicapoolupdater-gen.go
index e8886ef5ce4..24eb530145b 100644
--- a/replicapoolupdater/v1beta1/replicapoolupdater-gen.go
+++ b/replicapoolupdater/v1beta1/replicapoolupdater-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/compute/docs/instance-groups/manager/#applying_rolling_updates_using_the_updater_service
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/replicapoolupdater/v1beta1"
-// ...
-// ctx := context.Background()
-// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx)
+// import "google.golang.org/api/replicapoolupdater/v1beta1"
+// ...
+// ctx := context.Background()
+// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx, option.WithScopes(replicapoolupdater.ReplicapoolReadonlyScope))
+// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx, option.WithScopes(replicapoolupdater.ReplicapoolReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx, option.WithAPIKey("AIza..."))
+// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// replicapoolupdaterService, err := replicapoolupdater.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package replicapoolupdater // import "google.golang.org/api/replicapoolupdater/v1beta1"
diff --git a/reseller/v1/reseller-gen.go b/reseller/v1/reseller-gen.go
index aedce1759f5..31b4cee934a 100644
--- a/reseller/v1/reseller-gen.go
+++ b/reseller/v1/reseller-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/google-apps/reseller/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/reseller/v1"
-// ...
-// ctx := context.Background()
-// resellerService, err := reseller.NewService(ctx)
+// import "google.golang.org/api/reseller/v1"
+// ...
+// ctx := context.Background()
+// resellerService, err := reseller.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// resellerService, err := reseller.NewService(ctx, option.WithScopes(reseller.AppsOrderReadonlyScope))
+// resellerService, err := reseller.NewService(ctx, option.WithScopes(reseller.AppsOrderReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// resellerService, err := reseller.NewService(ctx, option.WithAPIKey("AIza..."))
+// resellerService, err := reseller.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// resellerService, err := reseller.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// resellerService, err := reseller.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package reseller // import "google.golang.org/api/reseller/v1"
@@ -958,12 +958,12 @@ type CustomersGetCall struct {
// see retrieving a customer account
// (/admin-sdk/reseller/v1/how-tos/manage_customers#get_customer).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
func (r *CustomersService) Get(customerId string) *CustomersGetCall {
c := &CustomersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -1274,12 +1274,12 @@ type CustomersPatchCall struct {
// domain to unlock Essentials features
// (https://support.google.com/a/answer/9122284).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
func (r *CustomersService) Patch(customerId string, customer *Customer) *CustomersPatchCall {
c := &CustomersPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -1424,12 +1424,12 @@ type CustomersUpdateCall struct {
// information, see update a customer's settings
// (/admin-sdk/reseller/v1/how-tos/manage_customers#update_customer).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
func (r *CustomersService) Update(customerId string, customer *Customer) *CustomersUpdateCall {
c := &CustomersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -1963,18 +1963,18 @@ type SubscriptionsActivateCall struct {
// suspended for any other reason, such as for abuse or a pending ToS
// acceptance, this call will not reactivate the customer subscription.
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) Activate(customerId string, subscriptionId string) *SubscriptionsActivateCall {
c := &SubscriptionsActivateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -2122,18 +2122,18 @@ type SubscriptionsChangePlanCall struct {
// (/admin-sdk/reseller/v1/how-tos/manage_subscriptions#update_subscripti
// on_plan).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) ChangePlan(customerId string, subscriptionId string, changeplanrequest *ChangePlanRequest) *SubscriptionsChangePlanCall {
c := &SubscriptionsChangePlanCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -2287,18 +2287,18 @@ type SubscriptionsChangeRenewalSettingsCall struct {
// For more information, see the description in manage subscriptions
// (/admin-sdk/reseller/v1/how-tos/manage_subscriptions#update_renewal).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) ChangeRenewalSettings(customerId string, subscriptionId string, renewalsettings *RenewalSettings) *SubscriptionsChangeRenewalSettingsCall {
c := &SubscriptionsChangeRenewalSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -2453,18 +2453,18 @@ type SubscriptionsChangeSeatsCall struct {
// (/admin-sdk/reseller/v1/how-tos/manage_subscriptions#update_subscripti
// on_seat).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) ChangeSeats(customerId string, subscriptionId string, seats *Seats) *SubscriptionsChangeSeatsCall {
c := &SubscriptionsChangeSeatsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -2614,20 +2614,20 @@ type SubscriptionsDeleteCall struct {
// Delete: Cancels, suspends, or transfers a subscription to direct.
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - deletionType: The `deletionType` query string enables the
-// cancellation, downgrade, or suspension of a subscription.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - deletionType: The `deletionType` query string enables the
+// cancellation, downgrade, or suspension of a subscription.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) Delete(customerId string, subscriptionId string, deletionType string) *SubscriptionsDeleteCall {
c := &SubscriptionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -2765,18 +2765,18 @@ type SubscriptionsGetCall struct {
// (/admin-sdk/reseller/v1/how-tos/manage_subscriptions#get_subscription)
// .
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) Get(customerId string, subscriptionId string) *SubscriptionsGetCall {
c := &SubscriptionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -2946,12 +2946,12 @@ type SubscriptionsInsertCall struct {
// (/admin-sdk/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscr
// iption).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
func (r *SubscriptionsService) Insert(customerId string, subscription *Subscription) *SubscriptionsInsertCall {
c := &SubscriptionsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -3351,18 +3351,18 @@ type SubscriptionsStartPaidServiceCall struct {
// subscription. For more information, see manage subscriptions
// (/admin-sdk/reseller/v1/how-tos/manage_subscriptions#paid_service).
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) StartPaidService(customerId string, subscriptionId string) *SubscriptionsStartPaidServiceCall {
c := &SubscriptionsStartPaidServiceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
@@ -3513,18 +3513,18 @@ type SubscriptionsSuspendCall struct {
// for short periods of time as suspensions over 60 days may result in
// the subscription being cancelled.
//
-// - customerId: This can be either the customer's primary domain name
-// or the customer's unique identifier. If the domain name for a
-// customer changes, the old domain name cannot be used to access the
-// customer, but the customer's unique identifier (as returned by the
-// API) can always be used. We recommend storing the unique identifier
-// in your systems where applicable.
-// - subscriptionId: This is a required property. The `subscriptionId`
-// is the subscription identifier and is unique for each customer.
-// Since a `subscriptionId` changes when a subscription is updated, we
-// recommend to not use this ID as a key for persistent data. And the
-// `subscriptionId` can be found using the retrieve all reseller
-// subscriptions method.
+// - customerId: This can be either the customer's primary domain name
+// or the customer's unique identifier. If the domain name for a
+// customer changes, the old domain name cannot be used to access the
+// customer, but the customer's unique identifier (as returned by the
+// API) can always be used. We recommend storing the unique identifier
+// in your systems where applicable.
+// - subscriptionId: This is a required property. The `subscriptionId`
+// is the subscription identifier and is unique for each customer.
+// Since a `subscriptionId` changes when a subscription is updated, we
+// recommend to not use this ID as a key for persistent data. And the
+// `subscriptionId` can be found using the retrieve all reseller
+// subscriptions method.
func (r *SubscriptionsService) Suspend(customerId string, subscriptionId string) *SubscriptionsSuspendCall {
c := &SubscriptionsSuspendCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.customerId = customerId
diff --git a/resourcesettings/v1/resourcesettings-gen.go b/resourcesettings/v1/resourcesettings-gen.go
index d5a5a954c61..5c6e7ab8737 100644
--- a/resourcesettings/v1/resourcesettings-gen.go
+++ b/resourcesettings/v1/resourcesettings-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/resource-manager/docs/resource-settings/overview
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/resourcesettings/v1"
-// ...
-// ctx := context.Background()
-// resourcesettingsService, err := resourcesettings.NewService(ctx)
+// import "google.golang.org/api/resourcesettings/v1"
+// ...
+// ctx := context.Background()
+// resourcesettingsService, err := resourcesettings.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// resourcesettingsService, err := resourcesettings.NewService(ctx, option.WithAPIKey("AIza..."))
+// resourcesettingsService, err := resourcesettings.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// resourcesettingsService, err := resourcesettings.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// resourcesettingsService, err := resourcesettings.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package resourcesettings // import "google.golang.org/api/resourcesettings/v1"
@@ -511,8 +511,8 @@ type FoldersSettingsGetCall struct {
// Get: Returns a specified setting. Returns a `google.rpc.Status` with
// `google.rpc.Code.NOT_FOUND` if the setting does not exist.
//
-// - name: The name of the setting to get. See Setting for naming
-// requirements.
+// - name: The name of the setting to get. See Setting for naming
+// requirements.
func (r *FoldersSettingsService) Get(name string) *FoldersSettingsGetCall {
c := &FoldersSettingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -523,13 +523,21 @@ func (r *FoldersSettingsService) Get(name string) *FoldersSettingsGetCall {
// request.
//
// Possible values:
-// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
+// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
// will default to the SETTING_VIEW_BASIC view.
-// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
+// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
// This is the default value (for both ListSettings and GetSetting).
-// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
+// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
// but nothing else.
-// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
+// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
// nothing else.
func (c *FoldersSettingsGetCall) View(view string) *FoldersSettingsGetCall {
c.urlParams_.Set("view", view)
@@ -694,10 +702,10 @@ type FoldersSettingsListCall struct {
// List: Lists all the settings that are available on the Cloud resource
// `parent`.
//
-// - parent: The project, folder, or organization that is the parent
-// resource for this setting. Must be in one of the following forms: *
-// `projects/{project_number}` * `projects/{project_id}` *
-// `folders/{folder_id}` * `organizations/{organization_id}`.
+// - parent: The project, folder, or organization that is the parent
+// resource for this setting. Must be in one of the following forms: *
+// `projects/{project_number}` * `projects/{project_id}` *
+// `folders/{folder_id}` * `organizations/{organization_id}`.
func (r *FoldersSettingsService) List(parent string) *FoldersSettingsListCall {
c := &FoldersSettingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -722,13 +730,21 @@ func (c *FoldersSettingsListCall) PageToken(pageToken string) *FoldersSettingsLi
// request.
//
// Possible values:
-// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
+// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
// will default to the SETTING_VIEW_BASIC view.
-// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
+// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
// This is the default value (for both ListSettings and GetSetting).
-// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
+// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
// but nothing else.
-// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
+// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
// nothing else.
func (c *FoldersSettingsListCall) View(view string) *FoldersSettingsListCall {
c.urlParams_.Set("view", view)
@@ -935,12 +951,12 @@ type FoldersSettingsPatchCall struct {
// Note: the supplied setting will perform a full overwrite of the
// `local_value` field.
//
-// - name: The resource name of the setting. Must be in one of the
-// following forms: *
-// `projects/{project_number}/settings/{setting_name}` *
-// `folders/{folder_id}/settings/{setting_name}` *
-// `organizations/{organization_id}/settings/{setting_name}` For
-// example, "/projects/123/settings/gcp-enableMyFeature".
+// - name: The resource name of the setting. Must be in one of the
+// following forms: *
+// `projects/{project_number}/settings/{setting_name}` *
+// `folders/{folder_id}/settings/{setting_name}` *
+// `organizations/{organization_id}/settings/{setting_name}` For
+// example, "/projects/123/settings/gcp-enableMyFeature".
func (r *FoldersSettingsService) Patch(name string, googlecloudresourcesettingsv1setting *GoogleCloudResourcesettingsV1Setting) *FoldersSettingsPatchCall {
c := &FoldersSettingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1084,8 +1100,8 @@ type OrganizationsSettingsGetCall struct {
// Get: Returns a specified setting. Returns a `google.rpc.Status` with
// `google.rpc.Code.NOT_FOUND` if the setting does not exist.
//
-// - name: The name of the setting to get. See Setting for naming
-// requirements.
+// - name: The name of the setting to get. See Setting for naming
+// requirements.
func (r *OrganizationsSettingsService) Get(name string) *OrganizationsSettingsGetCall {
c := &OrganizationsSettingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1096,13 +1112,21 @@ func (r *OrganizationsSettingsService) Get(name string) *OrganizationsSettingsGe
// request.
//
// Possible values:
-// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
+// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
// will default to the SETTING_VIEW_BASIC view.
-// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
+// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
// This is the default value (for both ListSettings and GetSetting).
-// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
+// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
// but nothing else.
-// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
+// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
// nothing else.
func (c *OrganizationsSettingsGetCall) View(view string) *OrganizationsSettingsGetCall {
c.urlParams_.Set("view", view)
@@ -1267,10 +1291,10 @@ type OrganizationsSettingsListCall struct {
// List: Lists all the settings that are available on the Cloud resource
// `parent`.
//
-// - parent: The project, folder, or organization that is the parent
-// resource for this setting. Must be in one of the following forms: *
-// `projects/{project_number}` * `projects/{project_id}` *
-// `folders/{folder_id}` * `organizations/{organization_id}`.
+// - parent: The project, folder, or organization that is the parent
+// resource for this setting. Must be in one of the following forms: *
+// `projects/{project_number}` * `projects/{project_id}` *
+// `folders/{folder_id}` * `organizations/{organization_id}`.
func (r *OrganizationsSettingsService) List(parent string) *OrganizationsSettingsListCall {
c := &OrganizationsSettingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1295,13 +1319,21 @@ func (c *OrganizationsSettingsListCall) PageToken(pageToken string) *Organizatio
// request.
//
// Possible values:
-// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
+// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
// will default to the SETTING_VIEW_BASIC view.
-// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
+// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
// This is the default value (for both ListSettings and GetSetting).
-// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
+// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
// but nothing else.
-// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
+// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
// nothing else.
func (c *OrganizationsSettingsListCall) View(view string) *OrganizationsSettingsListCall {
c.urlParams_.Set("view", view)
@@ -1508,12 +1540,12 @@ type OrganizationsSettingsPatchCall struct {
// Note: the supplied setting will perform a full overwrite of the
// `local_value` field.
//
-// - name: The resource name of the setting. Must be in one of the
-// following forms: *
-// `projects/{project_number}/settings/{setting_name}` *
-// `folders/{folder_id}/settings/{setting_name}` *
-// `organizations/{organization_id}/settings/{setting_name}` For
-// example, "/projects/123/settings/gcp-enableMyFeature".
+// - name: The resource name of the setting. Must be in one of the
+// following forms: *
+// `projects/{project_number}/settings/{setting_name}` *
+// `folders/{folder_id}/settings/{setting_name}` *
+// `organizations/{organization_id}/settings/{setting_name}` For
+// example, "/projects/123/settings/gcp-enableMyFeature".
func (r *OrganizationsSettingsService) Patch(name string, googlecloudresourcesettingsv1setting *GoogleCloudResourcesettingsV1Setting) *OrganizationsSettingsPatchCall {
c := &OrganizationsSettingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1657,8 +1689,8 @@ type ProjectsSettingsGetCall struct {
// Get: Returns a specified setting. Returns a `google.rpc.Status` with
// `google.rpc.Code.NOT_FOUND` if the setting does not exist.
//
-// - name: The name of the setting to get. See Setting for naming
-// requirements.
+// - name: The name of the setting to get. See Setting for naming
+// requirements.
func (r *ProjectsSettingsService) Get(name string) *ProjectsSettingsGetCall {
c := &ProjectsSettingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1669,13 +1701,21 @@ func (r *ProjectsSettingsService) Get(name string) *ProjectsSettingsGetCall {
// request.
//
// Possible values:
-// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
+// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
// will default to the SETTING_VIEW_BASIC view.
-// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
+// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
// This is the default value (for both ListSettings and GetSetting).
-// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
+// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
// but nothing else.
-// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
+// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
// nothing else.
func (c *ProjectsSettingsGetCall) View(view string) *ProjectsSettingsGetCall {
c.urlParams_.Set("view", view)
@@ -1840,10 +1880,10 @@ type ProjectsSettingsListCall struct {
// List: Lists all the settings that are available on the Cloud resource
// `parent`.
//
-// - parent: The project, folder, or organization that is the parent
-// resource for this setting. Must be in one of the following forms: *
-// `projects/{project_number}` * `projects/{project_id}` *
-// `folders/{folder_id}` * `organizations/{organization_id}`.
+// - parent: The project, folder, or organization that is the parent
+// resource for this setting. Must be in one of the following forms: *
+// `projects/{project_number}` * `projects/{project_id}` *
+// `folders/{folder_id}` * `organizations/{organization_id}`.
func (r *ProjectsSettingsService) List(parent string) *ProjectsSettingsListCall {
c := &ProjectsSettingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1868,13 +1908,21 @@ func (c *ProjectsSettingsListCall) PageToken(pageToken string) *ProjectsSettings
// request.
//
// Possible values:
-// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
+// "SETTING_VIEW_UNSPECIFIED" - The default / unset value. The API
+//
// will default to the SETTING_VIEW_BASIC view.
-// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
+// "SETTING_VIEW_BASIC" - Include Setting.metadata, but nothing else.
+//
// This is the default value (for both ListSettings and GetSetting).
-// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
+// "SETTING_VIEW_EFFECTIVE_VALUE" - Include Setting.effective_value,
+//
// but nothing else.
-// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
+// "SETTING_VIEW_LOCAL_VALUE" - Include Setting.local_value, but
+//
// nothing else.
func (c *ProjectsSettingsListCall) View(view string) *ProjectsSettingsListCall {
c.urlParams_.Set("view", view)
@@ -2081,12 +2129,12 @@ type ProjectsSettingsPatchCall struct {
// Note: the supplied setting will perform a full overwrite of the
// `local_value` field.
//
-// - name: The resource name of the setting. Must be in one of the
-// following forms: *
-// `projects/{project_number}/settings/{setting_name}` *
-// `folders/{folder_id}/settings/{setting_name}` *
-// `organizations/{organization_id}/settings/{setting_name}` For
-// example, "/projects/123/settings/gcp-enableMyFeature".
+// - name: The resource name of the setting. Must be in one of the
+// following forms: *
+// `projects/{project_number}/settings/{setting_name}` *
+// `folders/{folder_id}/settings/{setting_name}` *
+// `organizations/{organization_id}/settings/{setting_name}` For
+// example, "/projects/123/settings/gcp-enableMyFeature".
func (r *ProjectsSettingsService) Patch(name string, googlecloudresourcesettingsv1setting *GoogleCloudResourcesettingsV1Setting) *ProjectsSettingsPatchCall {
c := &ProjectsSettingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/retail/v2/retail-api.json b/retail/v2/retail-api.json
index 2dbb3c9b0af..bfc3b484a08 100644
--- a/retail/v2/retail-api.json
+++ b/retail/v2/retail-api.json
@@ -168,6 +168,56 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
+ "getAttributesConfig": {
+ "description": "Gets an AttributesConfig.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig",
+ "httpMethod": "GET",
+ "id": "retail.projects.locations.catalogs.getAttributesConfig",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. Full AttributesConfig resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2/{+name}",
+ "response": {
+ "$ref": "GoogleCloudRetailV2AttributesConfig"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
+ "getCompletionConfig": {
+ "description": "Gets a CompletionConfig.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionConfig",
+ "httpMethod": "GET",
+ "id": "retail.projects.locations.catalogs.getCompletionConfig",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. Full CompletionConfig resource name. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/completionConfig$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2/{+name}",
+ "response": {
+ "$ref": "GoogleCloudRetailV2CompletionConfig"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
"getDefaultBranch": {
"description": "Get which branch is currently default branch set by CatalogService.SetDefaultBranch method under a specified parent catalog.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:getDefaultBranch",
@@ -290,9 +340,137 @@
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
+ },
+ "updateAttributesConfig": {
+ "description": "Updates the AttributesConfig. The catalog attributes in the request will be updated in the catalog, or inserted if they do not exist. Existing catalog attributes not included in the request will remain unchanged. Attributes that are assigned to products, but do not exist at the catalog level, are always included in the response. The product attribute is assigned default values for missing catalog attribute fields, e.g., searchable and dynamic facetable options.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig",
+ "httpMethod": "PATCH",
+ "id": "retail.projects.locations.catalogs.updateAttributesConfig",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. Immutable. The fully qualified resource name of the attribute config. Format: `projects/*/locations/*/catalogs/*/attributesConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ "required": true,
+ "type": "string"
+ },
+ "updateMask": {
+ "description": "Indicates which fields in the provided AttributesConfig to update. The following is the only supported field: * AttributesConfig.catalog_attributes If not set, all supported fields are updated.",
+ "format": "google-fieldmask",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "path": "v2/{+name}",
+ "request": {
+ "$ref": "GoogleCloudRetailV2AttributesConfig"
+ },
+ "response": {
+ "$ref": "GoogleCloudRetailV2AttributesConfig"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
+ "updateCompletionConfig": {
+ "description": "Updates the CompletionConfigs.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionConfig",
+ "httpMethod": "PATCH",
+ "id": "retail.projects.locations.catalogs.updateCompletionConfig",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. Immutable. Fully qualified name `projects/*/locations/*/catalogs/*/completionConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/completionConfig$",
+ "required": true,
+ "type": "string"
+ },
+ "updateMask": {
+ "description": "Indicates which fields in the provided CompletionConfig to update. The following are the only supported fields: * CompletionConfig.matching_order * CompletionConfig.max_suggestions * CompletionConfig.min_prefix_length * CompletionConfig.auto_learning If not set, all supported fields are updated.",
+ "format": "google-fieldmask",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "path": "v2/{+name}",
+ "request": {
+ "$ref": "GoogleCloudRetailV2CompletionConfig"
+ },
+ "response": {
+ "$ref": "GoogleCloudRetailV2CompletionConfig"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
}
},
"resources": {
+ "attributesConfig": {
+ "methods": {
+ "addCatalogAttribute": {
+ "description": "Adds the specified CatalogAttribute to the AttributesConfig. If the CatalogAttribute to add already exists, an ALREADY_EXISTS error is returned.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:addCatalogAttribute",
+ "httpMethod": "POST",
+ "id": "retail.projects.locations.catalogs.attributesConfig.addCatalogAttribute",
+ "parameterOrder": [
+ "attributesConfig"
+ ],
+ "parameters": {
+ "attributesConfig": {
+ "description": "Required. Full AttributesConfig resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2/{+attributesConfig}:addCatalogAttribute",
+ "request": {
+ "$ref": "GoogleCloudRetailV2AddCatalogAttributeRequest"
+ },
+ "response": {
+ "$ref": "GoogleCloudRetailV2AttributesConfig"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
+ "removeCatalogAttribute": {
+ "description": "Removes the specified CatalogAttribute from the AttributesConfig. If the CatalogAttribute to remove does not exist, a NOT_FOUND error is returned.",
+ "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:removeCatalogAttribute",
+ "httpMethod": "POST",
+ "id": "retail.projects.locations.catalogs.attributesConfig.removeCatalogAttribute",
+ "parameterOrder": [
+ "attributesConfig"
+ ],
+ "parameters": {
+ "attributesConfig": {
+ "description": "Required. Full AttributesConfig resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2/{+attributesConfig}:removeCatalogAttribute",
+ "request": {
+ "$ref": "GoogleCloudRetailV2RemoveCatalogAttributeRequest"
+ },
+ "response": {
+ "$ref": "GoogleCloudRetailV2AttributesConfig"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ }
+ }
+ },
"branches": {
"resources": {
"operations": {
@@ -327,7 +505,7 @@
"products": {
"methods": {
"addFulfillmentPlaces": {
- "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces",
@@ -355,7 +533,7 @@
]
},
"addLocalInventories": {
- "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.addLocalInventories",
@@ -580,7 +758,7 @@
]
},
"removeFulfillmentPlaces": {
- "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces",
@@ -608,7 +786,7 @@
]
},
"removeLocalInventories": {
- "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories",
@@ -636,7 +814,7 @@
]
},
"setInventory": {
- "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.setInventory",
@@ -933,7 +1111,7 @@
]
},
"import": {
- "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+ "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.",
"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:import",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.userEvents.import",
@@ -1193,7 +1371,7 @@
}
}
},
- "revision": "20220722",
+ "revision": "20220811",
"rootUrl": "https://retail.googleapis.com/",
"schemas": {
"GoogleApiHttpBody": {
@@ -1346,6 +1524,17 @@
},
"type": "object"
},
+ "GoogleCloudRetailV2AddCatalogAttributeRequest": {
+ "description": "Request for CatalogService.AddCatalogAttribute method.",
+ "id": "GoogleCloudRetailV2AddCatalogAttributeRequest",
+ "properties": {
+ "catalogAttribute": {
+ "$ref": "GoogleCloudRetailV2CatalogAttribute",
+ "description": "Required. The CatalogAttribute to add."
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2AddFulfillmentPlacesMetadata": {
"description": "Metadata related to the progress of the AddFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.AddFulfillmentPlaces method.",
"id": "GoogleCloudRetailV2AddFulfillmentPlacesMetadata",
@@ -1425,6 +1614,39 @@
"properties": {},
"type": "object"
},
+ "GoogleCloudRetailV2AttributesConfig": {
+ "description": "Catalog level attribute config.",
+ "id": "GoogleCloudRetailV2AttributesConfig",
+ "properties": {
+ "attributeConfigLevel": {
+ "description": "Output only. The AttributeConfigLevel used for this catalog.",
+ "enum": [
+ "ATTRIBUTE_CONFIG_LEVEL_UNSPECIFIED",
+ "PRODUCT_LEVEL_ATTRIBUTE_CONFIG",
+ "CATALOG_LEVEL_ATTRIBUTE_CONFIG"
+ ],
+ "enumDescriptions": [
+ "Value used when unset. In this case, server behavior defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.",
+ "At this level, we honor the attribute configurations set in Product.attributes.",
+ "At this level, we honor the attribute configurations set in CatalogConfig.attribute_configs."
+ ],
+ "readOnly": true,
+ "type": "string"
+ },
+ "catalogAttributes": {
+ "additionalProperties": {
+ "$ref": "GoogleCloudRetailV2CatalogAttribute"
+ },
+ "description": "Enable attribute(s) config at catalog level. For example, indexable, dynamic_facetable, or searchable for each attribute. The key is catalog attribute's name. For example: `color`, `brands`, `attributes.custom_attribute`, such as `attributes.xyz`. The maximum number of catalog attributes allowed in a request is 1000.",
+ "type": "object"
+ },
+ "name": {
+ "description": "Required. Immutable. The fully qualified resource name of the attribute config. Format: `projects/*/locations/*/catalogs/*/attributesConfig`",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2Audience": {
"description": "An intended audience of the Product for whom it's sold.",
"id": "GoogleCloudRetailV2Audience",
@@ -1451,7 +1673,7 @@
"id": "GoogleCloudRetailV2BigQuerySource",
"properties": {
"dataSchema": {
- "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: The schema is available here: https://support.google.com/analytics/answer/3437719. * `user_event_ga4`: This feature is in private preview. Please contact the support team for importing Google Analytics 4 events. The schema is available here: https://support.google.com/analytics/answer/7029846. Supported values for auto-completion imports: * `suggestions` (default): One JSON completion suggestion per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One JSON allow suggestion per line.",
+ "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: The schema is available here: https://support.google.com/analytics/answer/3437719. * `user_event_ga4`: The schema is available here: https://support.google.com/analytics/answer/7029846. Supported values for auto-completion imports: * `suggestions` (default): One JSON completion suggestion per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One JSON allow suggestion per line.",
"type": "string"
},
"datasetId": {
@@ -1464,7 +1686,7 @@
},
"partitionDate": {
"$ref": "GoogleTypeDate",
- "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`."
+ "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format. Only supported in ImportProductsRequest."
},
"projectId": {
"description": "The project ID (can be project # or ID) that the BigQuery source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.",
@@ -1496,6 +1718,79 @@
},
"type": "object"
},
+ "GoogleCloudRetailV2CatalogAttribute": {
+ "description": "Catalog level attribute config for an attribute. For example, if customers want to enable/disable facet for a specific attribute.",
+ "id": "GoogleCloudRetailV2CatalogAttribute",
+ "properties": {
+ "dynamicFacetableOption": {
+ "description": "If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.",
+ "enum": [
+ "DYNAMIC_FACETABLE_OPTION_UNSPECIFIED",
+ "DYNAMIC_FACETABLE_ENABLED",
+ "DYNAMIC_FACETABLE_DISABLED"
+ ],
+ "enumDescriptions": [
+ "Value used when unset. Defaults to DYNAMIC_FACETABLE_ENABLED.",
+ "Dynamic facetable option enabled for an attribute.",
+ "Dynamic facetable option disabled for an attribute."
+ ],
+ "type": "string"
+ },
+ "inUse": {
+ "description": "Output only. Indicates whether this attribute has been used by any products. `True` if at least one Product is using this attribute in Product.attributes. Otherwise, this field is `False`. CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, CatalogService.ImportCatalogAttributes, or CatalogService.UpdateAttributesConfig APIs. This field is `False` for pre-loaded CatalogAttributes. Only pre-loaded CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined cannot be deleted; however, their configuration properties will reset to default values upon removal request. After catalog changes, it takes about 10 minutes for this field to update.",
+ "readOnly": true,
+ "type": "boolean"
+ },
+ "indexableOption": {
+ "description": "When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search.",
+ "enum": [
+ "INDEXABLE_OPTION_UNSPECIFIED",
+ "INDEXABLE_ENABLED",
+ "INDEXABLE_DISABLED"
+ ],
+ "enumDescriptions": [
+ "Value used when unset. Defaults to INDEXABLE_ENABLED.",
+ "Indexable option enabled for an attribute.",
+ "Indexable option disabled for an attribute."
+ ],
+ "type": "string"
+ },
+ "key": {
+ "description": "Required. Attribute name. For example: `color`, `brands`, `attributes.custom_attribute`, such as `attributes.xyz`. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named `attributes.abc_xyz` can be indexed, but an attribute named `attributes.abc-xyz` cannot be indexed.",
+ "type": "string"
+ },
+ "searchableOption": {
+ "description": "When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search. If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes.",
+ "enum": [
+ "SEARCHABLE_OPTION_UNSPECIFIED",
+ "SEARCHABLE_ENABLED",
+ "SEARCHABLE_DISABLED"
+ ],
+ "enumDescriptions": [
+ "Value used when unset. Defaults to SEARCHABLE_DISABLED.",
+ "Searchable option enabled for an attribute.",
+ "Searchable option disabled for an attribute."
+ ],
+ "type": "string"
+ },
+ "type": {
+ "description": "Output only. The type of this attribute. This is derived from the attribute in Product.attributes.",
+ "enum": [
+ "UNKNOWN",
+ "TEXTUAL",
+ "NUMERICAL"
+ ],
+ "enumDescriptions": [
+ "The type of the attribute is unknown. Used when type cannot be derived from attribute that is not in_use.",
+ "Textual attribute.",
+ "Numerical attribute."
+ ],
+ "readOnly": true,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2ColorInfo": {
"description": "The color information of a Product.",
"id": "GoogleCloudRetailV2ColorInfo",
@@ -1533,7 +1828,7 @@
"type": "array"
},
"recentSearchResults": {
- "description": "Matched recent searches of this user. The maximum number of recent searches is 10. This field is a restricted feature. Contact Retail Search support team if you are interested in enabling it. This feature is only available when CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The recent searches satisfy the follow rules: * They are ordered from latest to oldest. * They are matched with CompleteQueryRequest.query case insensitively. * They are transformed to lower cases. * They are UTF-8 safe. Recent searches are deduplicated. More recent searches will be reserved when duplication happens.",
+ "description": "Matched recent searches of this user. The maximum number of recent searches is 10. This field is a restricted feature. Contact Retail Search support team if you are interested in enabling it. This feature is only available when CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The recent searches satisfy the follow rules: * They are ordered from latest to oldest. * They are matched with CompleteQueryRequest.query case insensitively. * They are transformed to lower case. * They are UTF-8 safe. Recent searches are deduplicated. More recent searches will be reserved when duplication happens.",
"items": {
"$ref": "GoogleCloudRetailV2CompleteQueryResponseRecentSearchResult"
},
@@ -1571,6 +1866,65 @@
},
"type": "object"
},
+ "GoogleCloudRetailV2CompletionConfig": {
+ "description": "Catalog level autocomplete config for customers to customize autocomplete feature's settings.",
+ "id": "GoogleCloudRetailV2CompletionConfig",
+ "properties": {
+ "allowlistInputConfig": {
+ "$ref": "GoogleCloudRetailV2CompletionDataInputConfig",
+ "description": "Output only. The source data for the latest import of the autocomplete allowlist phrases.",
+ "readOnly": true
+ },
+ "autoLearning": {
+ "description": "If set to true, the auto learning function is enabled. Auto learning uses user data to generate suggestions using ML techniques. Default value is false. Only after enabling auto learning can users use `cloud-retail` data in CompleteQueryRequest.",
+ "type": "boolean"
+ },
+ "denylistInputConfig": {
+ "$ref": "GoogleCloudRetailV2CompletionDataInputConfig",
+ "description": "Output only. The source data for the latest import of the autocomplete denylist phrases.",
+ "readOnly": true
+ },
+ "lastAllowlistImportOperation": {
+ "description": "Output only. Name of the LRO corresponding to the latest allowlist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation.",
+ "readOnly": true,
+ "type": "string"
+ },
+ "lastDenylistImportOperation": {
+ "description": "Output only. Name of the LRO corresponding to the latest denylist import. Can use GetOperation API to retrieve the latest state of the Long Running Operation.",
+ "readOnly": true,
+ "type": "string"
+ },
+ "lastSuggestionsImportOperation": {
+ "description": "Output only. Name of the LRO corresponding to the latest suggestion terms list import. Can use GetOperation API to retrieve the latest state of the Long Running Operation.",
+ "readOnly": true,
+ "type": "string"
+ },
+ "matchingOrder": {
+ "description": "Specifies the matching order for autocomplete suggestions, e.g., a query consisting of 'sh' with 'out-of-order' specified would suggest \"women's shoes\", whereas a query of 'red s' with 'exact-prefix' specified would suggest \"red shoes\". Currently supported values: * 'out-of-order' * 'exact-prefix' Default value: 'exact-prefix'.",
+ "type": "string"
+ },
+ "maxSuggestions": {
+ "description": "The maximum number of autocomplete suggestions returned per term. Default value is 20. If left unset or set to 0, then will fallback to default value. Value range is 1 to 20.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "minPrefixLength": {
+ "description": "The minimum number of characters needed to be typed in order to get suggestions. Default value is 2. If left unset or set to 0, then will fallback to default value. Value range is 1 to 20.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "name": {
+ "description": "Required. Immutable. Fully qualified name `projects/*/locations/*/catalogs/*/completionConfig`",
+ "type": "string"
+ },
+ "suggestionsInputConfig": {
+ "$ref": "GoogleCloudRetailV2CompletionDataInputConfig",
+ "description": "Output only. The source data for the latest import of the autocomplete suggestion phrases.",
+ "readOnly": true
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2CompletionDataInputConfig": {
"description": "The input config source for completion data.",
"id": "GoogleCloudRetailV2CompletionDataInputConfig",
@@ -1651,11 +2005,11 @@
"type": "object"
},
"GoogleCloudRetailV2GcsSource": {
- "description": "Google Cloud Storage location for input content. format.",
+ "description": "Google Cloud Storage location for input content.",
"id": "GoogleCloudRetailV2GcsSource",
"properties": {
"dataSchema": {
- "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: Using https://support.google.com/analytics/answer/3437719. Supported values for control imports: * 'control' (default): One JSON Control per line. Supported values for catalog attribute imports: * 'catalog_attribute' (default): One CSV CatalogAttribute per line.",
+ "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: Using https://support.google.com/analytics/answer/3437719. Supported values for control imports: * `control` (default): One JSON Control per line. Supported values for catalog attribute imports: * `catalog_attribute` (default): One CSV CatalogAttribute per line.",
"type": "string"
},
"inputUris": {
@@ -1718,7 +2072,7 @@
"description": "Required. The desired input location of the data."
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
}
},
@@ -1743,14 +2097,14 @@
"id": "GoogleCloudRetailV2ImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2ImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2ImportMetadata",
"properties": {
"createTime": {
@@ -1764,7 +2118,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -1797,7 +2151,7 @@
"description": "Required. The desired input location of the data."
},
"notificationPubsubTopic": {
- "description": "Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that both `cloud-retail-customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on the topic. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`.",
+ "description": "Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that `service-@gcp-sa-retail.iam.gserviceaccount.com` has the `pubsub.topics.publish` IAM permission on the topic.",
"type": "string"
},
"reconciliationMode": {
@@ -1810,7 +2164,7 @@
"enumDescriptions": [
"Defaults to INCREMENTAL.",
"Inserts new products or updates existing products.",
- "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown."
+ "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location."
],
"type": "string"
},
@@ -1819,7 +2173,7 @@
"type": "string"
},
"updateMask": {
- "description": "Indicates which fields in the provided imported 'products' to update. If not set, will by default update all fields.",
+ "description": "Indicates which fields in the provided imported `products` to update. If not set, all fields are updated.",
"format": "google-fieldmask",
"type": "string"
}
@@ -1989,12 +2343,12 @@
"type": "object"
},
"pageSize": {
- "description": "Maximum number of results to return per page. Set this property to the number of prediction results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
+ "description": "Maximum number of results to return. Set this property to the number of prediction results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
"format": "int32",
"type": "integer"
},
"pageToken": {
- "description": "This field is not used for now, leave it unset.",
+ "description": "This field is not used; leave it unset.",
"type": "string"
},
"params": {
@@ -2176,7 +2530,7 @@
"type": "array"
},
"collectionMemberIds": {
- "description": "The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.",
+ "description": "The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.",
"items": {
"type": "string"
},
@@ -2531,6 +2885,17 @@
},
"type": "object"
},
+ "GoogleCloudRetailV2RemoveCatalogAttributeRequest": {
+ "description": "Request for CatalogService.RemoveCatalogAttribute method.",
+ "id": "GoogleCloudRetailV2RemoveCatalogAttributeRequest",
+ "properties": {
+ "key": {
+ "description": "Required. The attribute name key of the CatalogAttribute to remove.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata": {
"description": "Metadata related to the progress of the RemoveFulfillmentPlaces operation. Currently empty because there is no meaningful metadata populated from the ProductService.RemoveFulfillmentPlaces method.",
"id": "GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata",
@@ -2845,6 +3210,10 @@
"type": "string"
},
"type": "array"
+ },
+ "returnMinMax": {
+ "description": "Returns the min and max value for each numerical facet intervals. Ignored for textual facets.",
+ "type": "boolean"
}
},
"type": "object"
@@ -2861,8 +3230,8 @@
"DISABLED"
],
"enumDescriptions": [
- "Default value. Defaults to Mode.AUTO.",
- "Let CRS decide whether to use personalization.",
+ "Default value. In this case, server behavior defaults to Mode.AUTO.",
+ "Let CRS decide whether to use personalization based on quality of user event data.",
"Disable personalization."
],
"type": "string"
@@ -2882,7 +3251,7 @@
"AUTO"
],
"enumDescriptions": [
- "Unspecified query expansion condition. This defaults to Condition.DISABLED.",
+ "Unspecified query expansion condition. In this case, server behavior defaults to Condition.DISABLED.",
"Disabled query expansion. Only the exact search query is used, even if SearchResponse.total_size is zero.",
"Automatic query expansion built by Google Retail Search."
],
@@ -2907,7 +3276,7 @@
"AUTO"
],
"enumDescriptions": [
- "Unspecified spell correction mode. This defaults to Mode.AUTO.",
+ "Unspecified spell correction mode. In this case, server behavior defaults to Mode.AUTO.",
"Google Retail Search will try to find a spell suggestion if there is any and put in the SearchResponse.corrected_query. The spell suggestion will not be used as the search query.",
"Automatic spell correction built by Google Retail Search. Search will be based on the corrected query if found."
],
@@ -3011,6 +3380,16 @@
"$ref": "GoogleCloudRetailV2Interval",
"description": "Interval value for a facet, such as [10, 20) for facet \"price\"."
},
+ "maxValue": {
+ "description": "The maximum value in the FacetValue.interval. Only supported on numerical facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.",
+ "format": "double",
+ "type": "number"
+ },
+ "minValue": {
+ "description": "The minimum value in the FacetValue.interval. Only supported on numerical facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.",
+ "format": "double",
+ "type": "number"
+ },
"value": {
"description": "Text value of a facet, such as \"Black\" for facet \"colorFamilies\".",
"type": "string"
@@ -3055,6 +3434,13 @@
"description": "If a variant Product matches the search query, this map indicates which Product fields are matched. The key is the Product.name, the value is a field mask of the matched Product fields. If matched attributes cannot be determined, this map will be empty. For example, a key \"sku1\" with field mask \"products.color_info\" indicates there is a match between \"sku1\" ColorInfo and the query.",
"type": "object"
},
+ "personalLabels": {
+ "description": "Specifies previous events related to this product for this user based on UserEvent with same SearchRequest.visitor_id or UserInfo.user_id. This is set only when SearchRequest.PersonalizationSpec.mode is SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: * `purchased`: Indicates that this product has been purchased before.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
"product": {
"$ref": "GoogleCloudRetailV2Product",
"description": "The product data snippet in the search response. Only Product.name is guaranteed to be populated. Product.variants contains the product variants that match the search query. If there are multiple product variants matching the query, top 5 most relevant product variants are returned and ordered by relevancy. If relevancy can be deternmined, use matching_variant_fields to look up matched product variants fields. If relevancy cannot be determined, e.g. when searching \"shoe\" all products in a shoe product can be a match, 5 product variants are returned but order is meaningless."
@@ -3440,14 +3826,14 @@
"id": "GoogleCloudRetailV2alphaImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2alphaImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2alphaImportMetadata",
"properties": {
"createTime": {
@@ -3461,7 +3847,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -3473,6 +3859,10 @@
"format": "int64",
"type": "string"
},
+ "transformedUserEventsMetadata": {
+ "$ref": "GoogleCloudRetailV2alphaTransformedUserEventsMetadata",
+ "description": "Metadata related to transform user events."
+ },
"updateTime": {
"description": "Operation last update time. If the operation is done, this is also the finish time.",
"format": "google-datetime",
@@ -3522,7 +3912,7 @@
"type": "object"
},
"GoogleCloudRetailV2alphaModel": {
- "description": "Metadata that describes the training and serving parameters of a Model. A Model can be associated with a ServingConfig and then queried through the Predict api.",
+ "description": "Metadata that describes the training and serving parameters of a Model. A Model can be associated with a ServingConfig and then queried through the Predict API.",
"id": "GoogleCloudRetailV2alphaModel",
"properties": {
"createTime": {
@@ -3532,14 +3922,14 @@
"type": "string"
},
"dataState": {
- "description": "Output only. The state of data requirements for this model: DATA_OK and DATA_ERROR. Recommendation model cannot be trained if the data is in DATA_ERROR state. Recommendation model can have DATA_ERROR state even if serving state is ACTIVE: models were trained successfully before, but cannot be refreshed because model no longer has sufficient data for training.",
+ "description": "Output only. The state of data requirements for this model: `DATA_OK` and `DATA_ERROR`. Recommendation model cannot be trained if the data is in `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even if serving state is `ACTIVE`: models were trained successfully before, but cannot be refreshed because model no longer has sufficient data for training.",
"enum": [
"DATA_STATE_UNSPECIFIED",
"DATA_OK",
"DATA_ERROR"
],
"enumDescriptions": [
- "Unspecified default value - should never be explicitly set.",
+ "Unspecified default value, should never be explicitly set.",
"The model has sufficient training data.",
"The model does not have sufficient training data. Error messages can be queried via Stackdriver."
],
@@ -3547,18 +3937,18 @@
"type": "string"
},
"displayName": {
- "description": "Required. The display name of the model. Should be human readable, used to display Recommendation Models in the Retail Pantheon Dashboard. UTF-8 encoded string with limit of 1024 characters.",
+ "description": "Required. The display name of the model. Should be human readable, used to display Recommendation Models in the Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024 characters.",
"type": "string"
},
"filteringOption": {
- "description": "Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by attributes is enabled for the model.",
+ "description": "Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering by attributes is enabled for the model.",
"enum": [
"RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED",
"RECOMMENDATIONS_FILTERING_DISABLED",
"RECOMMENDATIONS_FILTERING_ENABLED"
],
"enumDescriptions": [
- "Value used when unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
+ "Value used when unset. In this case, server behavior defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
"Recommendation filtering is disabled.",
"Recommendation filtering is enabled."
],
@@ -3571,7 +3961,7 @@
"type": "string"
},
"name": {
- "description": "Required. The fully qualified resource name of the model. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
+ "description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
"type": "string"
},
"optimizationObjective": {
@@ -3583,7 +3973,7 @@
"description": "Optional. The page optimization config."
},
"periodicTuningState": {
- "description": "Optional. The state of periodic tuning. The period we use is 3 months - to do a one-off tune earlier use the TuneModel method. Default value is PERIODIC_TUNING_ENABLED.",
+ "description": "Optional. The state of periodic tuning. The period we use is 3 months - to do a one-off tune earlier use the `TuneModel` method. Default value is `PERIODIC_TUNING_ENABLED`.",
"enum": [
"PERIODIC_TUNING_STATE_UNSPECIFIED",
"PERIODIC_TUNING_DISABLED",
@@ -3591,10 +3981,10 @@
"PERIODIC_TUNING_ENABLED"
],
"enumDescriptions": [
- "Unspecified default value - should never be explicitly set.",
- "The model has periodic tuning disabled. Tuning can be reenabled by calling the EnableModelPeriodicTuning method or by calling the TuneModel method.",
- "The model cannot be tuned with periodic tuning OR the TuneModel method. Hide the options in customer UI and reject any requests through the backend self serve API.",
- "The model has periodic tuning enabled. Tuning can be disabled by calling the DisableModelPeriodicTuning method."
+ "Unspecified default value, should never be explicitly set.",
+ "The model has periodic tuning disabled. Tuning can be reenabled by calling the `EnableModelPeriodicTuning` method or by calling the `TuneModel` method.",
+ "The model cannot be tuned with periodic tuning OR the `TuneModel` method. Hide the options in customer UI and reject any requests through the backend self serve API.",
+ "The model has periodic tuning enabled. Tuning can be disabled by calling the `DisableModelPeriodicTuning` method."
],
"type": "string"
},
@@ -3607,7 +3997,7 @@
"type": "array"
},
"servingState": {
- "description": "Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.",
+ "description": "Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.",
"enum": [
"SERVING_STATE_UNSPECIFIED",
"INACTIVE",
@@ -3618,13 +4008,13 @@
"Unspecified serving state.",
"The model is not serving.",
"The model is serving and can be queried.",
- "The model is trained on tuned hyperparameters, and can be queried."
+ "The model is trained on tuned hyperparameters and can be queried."
],
"readOnly": true,
"type": "string"
},
"trainingState": {
- "description": "Optional. The training state that the model is in (e.g. TRAINING or PAUSED). Since part of the cost of running the service is frequency of training - this can be used to determine when to train model in order to control cost. If not specified: the default value for CreateModel method is TRAINING. the default value for UpdateModel method is to keep the state the same as before.",
+ "description": "Optional. The training state that the model is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train model in order to control cost. If not specified: the default value for `CreateModel` method is `TRAINING`. The default value for `UpdateModel` method is to keep the state the same as before.",
"enum": [
"TRAINING_STATE_UNSPECIFIED",
"PAUSED",
@@ -3643,7 +4033,7 @@
"type": "string"
},
"type": {
- "description": "Required. The type of model e.g. `home-page`. Currently supported values: `recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `page-optimization`, 'similar-items', 'buy-it-again', `recently-viewed`(readonly value).",
+ "description": "Required. The type of model e.g. `home-page`. Currently supported values: `recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `page-optimization`, `similar-items`, `buy-it-again`, and `recently-viewed`(readonly value).",
"type": "string"
},
"updateTime": {
@@ -3682,9 +4072,9 @@
"enumDescriptions": [
"Unspecified value for restriction.",
"Allow any ServingConfig to be show on any number of panels. Example: `Panel1 candidates`: pdp_ctr, pdp_cvr, home_page_ctr_no_diversity `Panel2 candidates`: home_page_ctr_no_diversity, home_page_ctr_diversity, pdp_cvr_no_diversity `Restriction` = NO_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: []",
- "Do not allow the same ServingConfig.name to be shown on multiple panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_SERVING_CONFIG_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *",
- "Do not allow multiple ServingConfigs with same Model.name to be show on on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) *",
- "Do not allow multiple ServingConfigs with same Model.type to be shown on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) *"
+ "Do not allow the same ServingConfig.name to be shown on multiple panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_SERVING_CONFIG_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *",
+ "Do not allow multiple ServingConfigs with same Model.name to be show on on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) *",
+ "Do not allow multiple ServingConfigs with same Model.type to be shown on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) *"
],
"type": "string"
}
@@ -3696,7 +4086,7 @@
"id": "GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate",
"properties": {
"servingConfigId": {
- "description": "This has to be a valid ServingConfig identifier. e.g. for a ServingConfig with full name: `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config` this would be 'my_candidate_config'",
+ "description": "This has to be a valid ServingConfig identifier. For example, for a ServingConfig with full name: `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`, this would be `my_candidate_config`.",
"type": "string"
}
},
@@ -3715,7 +4105,7 @@
},
"defaultCandidate": {
"$ref": "GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate",
- "description": "Required. The default candidate (in case the model fails at serving time, we can fall back to the default)."
+ "description": "Required. The default candidate. If the model fails at serving time, we fall back to the default."
},
"displayName": {
"description": "Optional. The name to display for the panel.",
@@ -3725,11 +4115,11 @@
"type": "object"
},
"GoogleCloudRetailV2alphaModelServingConfigList": {
- "description": "Represents an ordered combination of valid serving configs, which / may be used for PAGE_OPTIMIZATION recommendations.",
+ "description": "Represents an ordered combination of valid serving configs, which can be used for `PAGE_OPTIMIZATION` recommendations.",
"id": "GoogleCloudRetailV2alphaModelServingConfigList",
"properties": {
"servingConfigIds": {
- "description": "Optional. A set of valid serving configs that may be used for PAGE_OPTIMIZATION.",
+ "description": "Optional. A set of valid serving configs that may be used for `PAGE_OPTIMIZATION`.",
"items": {
"type": "string"
},
@@ -3870,6 +4260,23 @@
"properties": {},
"type": "object"
},
+ "GoogleCloudRetailV2alphaTransformedUserEventsMetadata": {
+ "description": "Metadata related to transform user events operation.",
+ "id": "GoogleCloudRetailV2alphaTransformedUserEventsMetadata",
+ "properties": {
+ "sourceEventsCount": {
+ "description": "Count of entries in the source user events BigQuery table.",
+ "format": "int64",
+ "type": "string"
+ },
+ "transformedEventsCount": {
+ "description": "Count of entries in the transformed user events BigQuery table, which could be different from the actually imported number of user events.",
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2alphaTuneModelMetadata": {
"description": "Metadata associated with a tune operation.",
"id": "GoogleCloudRetailV2alphaTuneModelMetadata",
@@ -4034,14 +4441,14 @@
"id": "GoogleCloudRetailV2betaImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2betaImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2betaImportMetadata",
"properties": {
"createTime": {
@@ -4055,7 +4462,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
diff --git a/retail/v2/retail-gen.go b/retail/v2/retail-gen.go
index e755f5b6aa9..4694093ef57 100644
--- a/retail/v2/retail-gen.go
+++ b/retail/v2/retail-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recommendations
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/retail/v2"
-// ...
-// ctx := context.Background()
-// retailService, err := retail.NewService(ctx)
+// import "google.golang.org/api/retail/v2"
+// ...
+// ctx := context.Background()
+// retailService, err := retail.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// retailService, err := retail.NewService(ctx, option.WithAPIKey("AIza..."))
+// retailService, err := retail.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// retailService, err := retail.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// retailService, err := retail.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package retail // import "google.golang.org/api/retail/v2"
@@ -169,6 +169,7 @@ type ProjectsLocationsService struct {
func NewProjectsLocationsCatalogsService(s *Service) *ProjectsLocationsCatalogsService {
rs := &ProjectsLocationsCatalogsService{s: s}
+ rs.AttributesConfig = NewProjectsLocationsCatalogsAttributesConfigService(s)
rs.Branches = NewProjectsLocationsCatalogsBranchesService(s)
rs.CompletionData = NewProjectsLocationsCatalogsCompletionDataService(s)
rs.Operations = NewProjectsLocationsCatalogsOperationsService(s)
@@ -181,6 +182,8 @@ func NewProjectsLocationsCatalogsService(s *Service) *ProjectsLocationsCatalogsS
type ProjectsLocationsCatalogsService struct {
s *Service
+ AttributesConfig *ProjectsLocationsCatalogsAttributesConfigService
+
Branches *ProjectsLocationsCatalogsBranchesService
CompletionData *ProjectsLocationsCatalogsCompletionDataService
@@ -194,6 +197,15 @@ type ProjectsLocationsCatalogsService struct {
UserEvents *ProjectsLocationsCatalogsUserEventsService
}
+func NewProjectsLocationsCatalogsAttributesConfigService(s *Service) *ProjectsLocationsCatalogsAttributesConfigService {
+ rs := &ProjectsLocationsCatalogsAttributesConfigService{s: s}
+ return rs
+}
+
+type ProjectsLocationsCatalogsAttributesConfigService struct {
+ s *Service
+}
+
func NewProjectsLocationsCatalogsBranchesService(s *Service) *ProjectsLocationsCatalogsBranchesService {
rs := &ProjectsLocationsCatalogsBranchesService{s: s}
rs.Operations = NewProjectsLocationsCatalogsBranchesOperationsService(s)
@@ -582,6 +594,36 @@ func (s *GoogleCloudRetailLoggingSourceLocation) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GoogleCloudRetailV2AddCatalogAttributeRequest: Request for
+// CatalogService.AddCatalogAttribute method.
+type GoogleCloudRetailV2AddCatalogAttributeRequest struct {
+ // CatalogAttribute: Required. The CatalogAttribute to add.
+ CatalogAttribute *GoogleCloudRetailV2CatalogAttribute `json:"catalogAttribute,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "CatalogAttribute") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "CatalogAttribute") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2AddCatalogAttributeRequest) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2AddCatalogAttributeRequest
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2AddFulfillmentPlacesMetadata: Metadata related to
// the progress of the AddFulfillmentPlaces operation. Currently empty
// because there is no meaningful metadata populated from the
@@ -721,6 +763,63 @@ func (s *GoogleCloudRetailV2AddLocalInventoriesRequest) MarshalJSON() ([]byte, e
type GoogleCloudRetailV2AddLocalInventoriesResponse struct {
}
+// GoogleCloudRetailV2AttributesConfig: Catalog level attribute config.
+type GoogleCloudRetailV2AttributesConfig struct {
+ // AttributeConfigLevel: Output only. The AttributeConfigLevel used for
+ // this catalog.
+ //
+ // Possible values:
+ // "ATTRIBUTE_CONFIG_LEVEL_UNSPECIFIED" - Value used when unset. In
+ // this case, server behavior defaults to
+ // CATALOG_LEVEL_ATTRIBUTE_CONFIG.
+ // "PRODUCT_LEVEL_ATTRIBUTE_CONFIG" - At this level, we honor the
+ // attribute configurations set in Product.attributes.
+ // "CATALOG_LEVEL_ATTRIBUTE_CONFIG" - At this level, we honor the
+ // attribute configurations set in CatalogConfig.attribute_configs.
+ AttributeConfigLevel string `json:"attributeConfigLevel,omitempty"`
+
+ // CatalogAttributes: Enable attribute(s) config at catalog level. For
+ // example, indexable, dynamic_facetable, or searchable for each
+ // attribute. The key is catalog attribute's name. For example: `color`,
+ // `brands`, `attributes.custom_attribute`, such as `attributes.xyz`.
+ // The maximum number of catalog attributes allowed in a request is
+ // 1000.
+ CatalogAttributes map[string]GoogleCloudRetailV2CatalogAttribute `json:"catalogAttributes,omitempty"`
+
+ // Name: Required. Immutable. The fully qualified resource name of the
+ // attribute config. Format:
+ // `projects/*/locations/*/catalogs/*/attributesConfig`
+ Name string `json:"name,omitempty"`
+
+ // ServerResponse contains the HTTP response code and headers from the
+ // server.
+ googleapi.ServerResponse `json:"-"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "AttributeConfigLevel") to unconditionally include in API requests.
+ // By default, fields with empty or default values are omitted from API
+ // requests. However, any non-pointer, non-interface field appearing in
+ // ForceSendFields will be sent to the server regardless of whether the
+ // field is empty or not. This may be used to include empty fields in
+ // Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "AttributeConfigLevel") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2AttributesConfig) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2AttributesConfig
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2Audience: An intended audience of the Product for
// whom it's sold.
type GoogleCloudRetailV2Audience struct {
@@ -782,9 +881,7 @@ type GoogleCloudRetailV2BigQuerySource struct {
// Supported values for user events imports: * `user_event` (default):
// One JSON UserEvent per line. * `user_event_ga360`: The schema is
// available here: https://support.google.com/analytics/answer/3437719.
- // * `user_event_ga4`: This feature is in private preview. Please
- // contact the support team for importing Google Analytics 4 events. The
- // schema is available here:
+ // * `user_event_ga4`: The schema is available here:
// https://support.google.com/analytics/answer/7029846. Supported values
// for auto-completion imports: * `suggestions` (default): One JSON
// completion suggestion per line. * `denylist`: One JSON deny
@@ -803,8 +900,7 @@ type GoogleCloudRetailV2BigQuerySource struct {
GcsStagingDir string `json:"gcsStagingDir,omitempty"`
// PartitionDate: BigQuery time partitioned table's _PARTITIONDATE in
- // YYYY-MM-DD format. Only supported when
- // ImportProductsRequest.reconciliation_mode is set to `FULL`.
+ // YYYY-MM-DD format. Only supported in ImportProductsRequest.
PartitionDate *GoogleTypeDate `json:"partitionDate,omitempty"`
// ProjectId: The project ID (can be project # or ID) that the BigQuery
@@ -880,6 +976,109 @@ func (s *GoogleCloudRetailV2Catalog) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GoogleCloudRetailV2CatalogAttribute: Catalog level attribute config
+// for an attribute. For example, if customers want to enable/disable
+// facet for a specific attribute.
+type GoogleCloudRetailV2CatalogAttribute struct {
+ // DynamicFacetableOption: If DYNAMIC_FACETABLE_ENABLED, attribute
+ // values are available for dynamic facet. Could only be
+ // DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is
+ // INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+ //
+ // Possible values:
+ // "DYNAMIC_FACETABLE_OPTION_UNSPECIFIED" - Value used when unset.
+ // Defaults to DYNAMIC_FACETABLE_ENABLED.
+ // "DYNAMIC_FACETABLE_ENABLED" - Dynamic facetable option enabled for
+ // an attribute.
+ // "DYNAMIC_FACETABLE_DISABLED" - Dynamic facetable option disabled
+ // for an attribute.
+ DynamicFacetableOption string `json:"dynamicFacetableOption,omitempty"`
+
+ // InUse: Output only. Indicates whether this attribute has been used by
+ // any products. `True` if at least one Product is using this attribute
+ // in Product.attributes. Otherwise, this field is `False`.
+ // CatalogAttribute can be pre-loaded by using
+ // CatalogService.AddCatalogAttribute,
+ // CatalogService.ImportCatalogAttributes, or
+ // CatalogService.UpdateAttributesConfig APIs. This field is `False` for
+ // pre-loaded CatalogAttributes. Only pre-loaded CatalogAttributes that
+ // are neither in use by products nor predefined can be deleted.
+ // CatalogAttributes that are either in use by products or are
+ // predefined cannot be deleted; however, their configuration properties
+ // will reset to default values upon removal request. After catalog
+ // changes, it takes about 10 minutes for this field to update.
+ InUse bool `json:"inUse,omitempty"`
+
+ // IndexableOption: When AttributesConfig.attribute_config_level is
+ // CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
+ // are indexed so that it can be filtered, faceted, or boosted in
+ // SearchService.Search.
+ //
+ // Possible values:
+ // "INDEXABLE_OPTION_UNSPECIFIED" - Value used when unset. Defaults to
+ // INDEXABLE_ENABLED.
+ // "INDEXABLE_ENABLED" - Indexable option enabled for an attribute.
+ // "INDEXABLE_DISABLED" - Indexable option disabled for an attribute.
+ IndexableOption string `json:"indexableOption,omitempty"`
+
+ // Key: Required. Attribute name. For example: `color`, `brands`,
+ // `attributes.custom_attribute`, such as `attributes.xyz`. To be
+ // indexable, the attribute name can contain only alpha-numeric
+ // characters and underscores. For example, an attribute named
+ // `attributes.abc_xyz` can be indexed, but an attribute named
+ // `attributes.abc-xyz` cannot be indexed.
+ Key string `json:"key,omitempty"`
+
+ // SearchableOption: When AttributesConfig.attribute_config_level is
+ // CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute
+ // values are searchable by text queries in SearchService.Search. If
+ // SEARCHABLE_ENABLED but attribute type is numerical, attribute values
+ // will not be searchable by text queries in SearchService.Search, as
+ // there are no text values associated to numerical attributes.
+ //
+ // Possible values:
+ // "SEARCHABLE_OPTION_UNSPECIFIED" - Value used when unset. Defaults
+ // to SEARCHABLE_DISABLED.
+ // "SEARCHABLE_ENABLED" - Searchable option enabled for an attribute.
+ // "SEARCHABLE_DISABLED" - Searchable option disabled for an
+ // attribute.
+ SearchableOption string `json:"searchableOption,omitempty"`
+
+ // Type: Output only. The type of this attribute. This is derived from
+ // the attribute in Product.attributes.
+ //
+ // Possible values:
+ // "UNKNOWN" - The type of the attribute is unknown. Used when type
+ // cannot be derived from attribute that is not in_use.
+ // "TEXTUAL" - Textual attribute.
+ // "NUMERICAL" - Numerical attribute.
+ Type string `json:"type,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "DynamicFacetableOption") to unconditionally include in API requests.
+ // By default, fields with empty or default values are omitted from API
+ // requests. However, any non-pointer, non-interface field appearing in
+ // ForceSendFields will be sent to the server regardless of whether the
+ // field is empty or not. This may be used to include empty fields in
+ // Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DynamicFacetableOption")
+ // to include in API requests with the JSON null value. By default,
+ // fields with empty values are omitted from API requests. However, any
+ // field with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2CatalogAttribute) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2CatalogAttribute
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2ColorInfo: The color information of a Product.
type GoogleCloudRetailV2ColorInfo struct {
// ColorFamilies: The standard color families. Strongly recommended to
@@ -949,7 +1148,7 @@ type GoogleCloudRetailV2CompleteQueryResponse struct {
// imported. The recent searches satisfy the follow rules: * They are
// ordered from latest to oldest. * They are matched with
// CompleteQueryRequest.query case insensitively. * They are transformed
- // to lower cases. * They are UTF-8 safe. Recent searches are
+ // to lower case. * They are UTF-8 safe. Recent searches are
// deduplicated. More recent searches will be reserved when duplication
// happens.
RecentSearchResults []*GoogleCloudRetailV2CompleteQueryResponseRecentSearchResult `json:"recentSearchResults,omitempty"`
@@ -1047,6 +1246,94 @@ func (s *GoogleCloudRetailV2CompleteQueryResponseRecentSearchResult) MarshalJSON
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GoogleCloudRetailV2CompletionConfig: Catalog level autocomplete
+// config for customers to customize autocomplete feature's settings.
+type GoogleCloudRetailV2CompletionConfig struct {
+ // AllowlistInputConfig: Output only. The source data for the latest
+ // import of the autocomplete allowlist phrases.
+ AllowlistInputConfig *GoogleCloudRetailV2CompletionDataInputConfig `json:"allowlistInputConfig,omitempty"`
+
+ // AutoLearning: If set to true, the auto learning function is enabled.
+ // Auto learning uses user data to generate suggestions using ML
+ // techniques. Default value is false. Only after enabling auto learning
+ // can users use `cloud-retail` data in CompleteQueryRequest.
+ AutoLearning bool `json:"autoLearning,omitempty"`
+
+ // DenylistInputConfig: Output only. The source data for the latest
+ // import of the autocomplete denylist phrases.
+ DenylistInputConfig *GoogleCloudRetailV2CompletionDataInputConfig `json:"denylistInputConfig,omitempty"`
+
+ // LastAllowlistImportOperation: Output only. Name of the LRO
+ // corresponding to the latest allowlist import. Can use GetOperation
+ // API to retrieve the latest state of the Long Running Operation.
+ LastAllowlistImportOperation string `json:"lastAllowlistImportOperation,omitempty"`
+
+ // LastDenylistImportOperation: Output only. Name of the LRO
+ // corresponding to the latest denylist import. Can use GetOperation API
+ // to retrieve the latest state of the Long Running Operation.
+ LastDenylistImportOperation string `json:"lastDenylistImportOperation,omitempty"`
+
+ // LastSuggestionsImportOperation: Output only. Name of the LRO
+ // corresponding to the latest suggestion terms list import. Can use
+ // GetOperation API to retrieve the latest state of the Long Running
+ // Operation.
+ LastSuggestionsImportOperation string `json:"lastSuggestionsImportOperation,omitempty"`
+
+ // MatchingOrder: Specifies the matching order for autocomplete
+ // suggestions, e.g., a query consisting of 'sh' with 'out-of-order'
+ // specified would suggest "women's shoes", whereas a query of 'red s'
+ // with 'exact-prefix' specified would suggest "red shoes". Currently
+ // supported values: * 'out-of-order' * 'exact-prefix' Default value:
+ // 'exact-prefix'.
+ MatchingOrder string `json:"matchingOrder,omitempty"`
+
+ // MaxSuggestions: The maximum number of autocomplete suggestions
+ // returned per term. Default value is 20. If left unset or set to 0,
+ // then will fallback to default value. Value range is 1 to 20.
+ MaxSuggestions int64 `json:"maxSuggestions,omitempty"`
+
+ // MinPrefixLength: The minimum number of characters needed to be typed
+ // in order to get suggestions. Default value is 2. If left unset or set
+ // to 0, then will fallback to default value. Value range is 1 to 20.
+ MinPrefixLength int64 `json:"minPrefixLength,omitempty"`
+
+ // Name: Required. Immutable. Fully qualified name
+ // `projects/*/locations/*/catalogs/*/completionConfig`
+ Name string `json:"name,omitempty"`
+
+ // SuggestionsInputConfig: Output only. The source data for the latest
+ // import of the autocomplete suggestion phrases.
+ SuggestionsInputConfig *GoogleCloudRetailV2CompletionDataInputConfig `json:"suggestionsInputConfig,omitempty"`
+
+ // ServerResponse contains the HTTP response code and headers from the
+ // server.
+ googleapi.ServerResponse `json:"-"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "AllowlistInputConfig") to unconditionally include in API requests.
+ // By default, fields with empty or default values are omitted from API
+ // requests. However, any non-pointer, non-interface field appearing in
+ // ForceSendFields will be sent to the server regardless of whether the
+ // field is empty or not. This may be used to include empty fields in
+ // Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "AllowlistInputConfig") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2CompletionConfig) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2CompletionConfig
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2CompletionDataInputConfig: The input config source
// for completion data.
type GoogleCloudRetailV2CompletionDataInputConfig struct {
@@ -1228,7 +1515,7 @@ func (s *GoogleCloudRetailV2FulfillmentInfo) MarshalJSON() ([]byte, error) {
}
// GoogleCloudRetailV2GcsSource: Google Cloud Storage location for input
-// content. format.
+// content.
type GoogleCloudRetailV2GcsSource struct {
// DataSchema: The schema to use when parsing the data from the source.
// Supported values for product imports: * `product` (default): One JSON
@@ -1239,9 +1526,9 @@ type GoogleCloudRetailV2GcsSource struct {
// Supported values for user events imports: * `user_event` (default):
// One JSON UserEvent per line. * `user_event_ga360`: Using
// https://support.google.com/analytics/answer/3437719. Supported values
- // for control imports: * 'control' (default): One JSON Control per
+ // for control imports: * `control` (default): One JSON Control per
// line. Supported values for catalog attribute imports: *
- // 'catalog_attribute' (default): One CSV CatalogAttribute per line.
+ // `catalog_attribute` (default): One CSV CatalogAttribute per line.
DataSchema string `json:"dataSchema,omitempty"`
// InputUris: Required. Google Cloud Storage URIs to input files. URI
@@ -1368,9 +1655,9 @@ type GoogleCloudRetailV2ImportCompletionDataRequest struct {
InputConfig *GoogleCloudRetailV2CompletionDataInputConfig `json:"inputConfig,omitempty"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -1434,7 +1721,7 @@ func (s *GoogleCloudRetailV2ImportCompletionDataResponse) MarshalJSON() ([]byte,
// for Import related errors.
type GoogleCloudRetailV2ImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -1463,7 +1750,7 @@ func (s *GoogleCloudRetailV2ImportErrorsConfig) MarshalJSON() ([]byte, error) {
}
// GoogleCloudRetailV2ImportMetadata: Metadata related to the progress
-// of the Import operation. This will be returned by the
+// of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2ImportMetadata struct {
// CreateTime: Operation create time.
@@ -1474,9 +1761,9 @@ type GoogleCloudRetailV2ImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -1525,14 +1812,12 @@ type GoogleCloudRetailV2ImportProductsRequest struct {
// NotificationPubsubTopic: Full Pub/Sub topic name for receiving
// notification. If this field is set, when the import is finished, a
- // notification will be sent to specified Pub/Sub topic. The message
- // data will be JSON string of a Operation. Format of the Pub/Sub topic
- // is `projects/{project}/topics/{topic}`. It has to be within the same
- // project as ImportProductsRequest.parent. Make sure that both
- // `cloud-retail-customer-data-access@system.gserviceaccount.com` and
- // `service-@gcp-sa-retail.iam.gserviceaccount.com` have the
- // `pubsub.topics.publish` IAM permission on the topic. Only supported
- // when ImportProductsRequest.reconciliation_mode is set to `FULL`.
+ // notification is sent to specified Pub/Sub topic. The message data is
+ // JSON string of a Operation. Format of the Pub/Sub topic is
+ // `projects/{project}/topics/{topic}`. It has to be within the same
+ // project as ImportProductsRequest.parent. Make sure that
+ // `service-@gcp-sa-retail.iam.gserviceaccount.com` has the
+ // `pubsub.topics.publish` IAM permission on the topic.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
// ReconciliationMode: The mode of reconciliation between existing
@@ -1544,19 +1829,14 @@ type GoogleCloudRetailV2ImportProductsRequest struct {
// "INCREMENTAL" - Inserts new products or updates existing products.
// "FULL" - Calculates diff and replaces the entire product dataset.
// Existing products may be deleted if they are not present in the
- // source location. Can only be set while using BigQuerySource. And the
- // BigQuery dataset must be created in the data location "us (multiple
- // regions in United States)", otherwise a PERMISSION_DENIED error is
- // thrown. Add the IAM permission "BigQuery Data Viewer" for
- // cloud-retail-customer-data-access@system.gserviceaccount.com before
- // using this feature otherwise an error is thrown.
+ // source location.
ReconciliationMode string `json:"reconciliationMode,omitempty"`
// RequestId: Deprecated. This field has no effect.
RequestId string `json:"requestId,omitempty"`
// UpdateMask: Indicates which fields in the provided imported
- // 'products' to update. If not set, will by default update all fields.
+ // `products` to update. If not set, all fields are updated.
UpdateMask string `json:"updateMask,omitempty"`
// ForceSendFields is a list of field names (e.g. "ErrorsConfig") to
@@ -1929,13 +2209,13 @@ type GoogleCloudRetailV2PredictRequest struct {
// for more details.
Labels map[string]string `json:"labels,omitempty"`
- // PageSize: Maximum number of results to return per page. Set this
- // property to the number of prediction results needed. If zero, the
- // service will choose a reasonable default. The maximum allowed value
- // is 100. Values above 100 will be coerced to 100.
+ // PageSize: Maximum number of results to return. Set this property to
+ // the number of prediction results needed. If zero, the service will
+ // choose a reasonable default. The maximum allowed value is 100. Values
+ // above 100 will be coerced to 100.
PageSize int64 `json:"pageSize,omitempty"`
- // PageToken: This field is not used for now, leave it unset.
+ // PageToken: This field is not used; leave it unset.
PageToken string `json:"pageToken,omitempty"`
// Params: Additional domain specific parameters for the predictions.
@@ -2294,7 +2574,7 @@ type GoogleCloudRetailV2Product struct {
// CollectionMemberIds: The id of the collection members when type is
// Type.COLLECTION. Non-existent product ids are allowed. The type of
- // the members must be either Type.PRIMARY or Type.VARIANT otherwise and
+ // the members must be either Type.PRIMARY or Type.VARIANT otherwise an
// INVALID_ARGUMENT error is thrown. Should not set it for other types.
// A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT
// error is return.
@@ -3047,6 +3327,36 @@ func (s *GoogleCloudRetailV2RejoinUserEventsResponse) MarshalJSON() ([]byte, err
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GoogleCloudRetailV2RemoveCatalogAttributeRequest: Request for
+// CatalogService.RemoveCatalogAttribute method.
+type GoogleCloudRetailV2RemoveCatalogAttributeRequest struct {
+ // Key: Required. The attribute name key of the CatalogAttribute to
+ // remove.
+ Key string `json:"key,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "Key") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "Key") to include in API
+ // requests with the JSON null value. By default, fields with empty
+ // values are omitted from API requests. However, any field with an
+ // empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2RemoveCatalogAttributeRequest) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2RemoveCatalogAttributeRequest
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2RemoveFulfillmentPlacesMetadata: Metadata related
// to the progress of the RemoveFulfillmentPlaces operation. Currently
// empty because there is no meaningful metadata populated from the
@@ -3679,6 +3989,10 @@ type GoogleCloudRetailV2SearchRequestFacetSpecFacetKey struct {
// customFulfillment5
RestrictedValues []string `json:"restrictedValues,omitempty"`
+ // ReturnMinMax: Returns the min and max value for each numerical facet
+ // intervals. Ignored for textual facets.
+ ReturnMinMax bool `json:"returnMinMax,omitempty"`
+
// ForceSendFields is a list of field names (e.g. "CaseInsensitive") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
@@ -3709,8 +4023,10 @@ type GoogleCloudRetailV2SearchRequestPersonalizationSpec struct {
// Mode: Defaults to Mode.AUTO.
//
// Possible values:
- // "MODE_UNSPECIFIED" - Default value. Defaults to Mode.AUTO.
- // "AUTO" - Let CRS decide whether to use personalization.
+ // "MODE_UNSPECIFIED" - Default value. In this case, server behavior
+ // defaults to Mode.AUTO.
+ // "AUTO" - Let CRS decide whether to use personalization based on
+ // quality of user event data.
// "DISABLED" - Disable personalization.
Mode string `json:"mode,omitempty"`
@@ -3744,8 +4060,8 @@ type GoogleCloudRetailV2SearchRequestQueryExpansionSpec struct {
// Default to Condition.DISABLED.
//
// Possible values:
- // "CONDITION_UNSPECIFIED" - Unspecified query expansion condition.
- // This defaults to Condition.DISABLED.
+ // "CONDITION_UNSPECIFIED" - Unspecified query expansion condition. In
+ // this case, server behavior defaults to Condition.DISABLED.
// "DISABLED" - Disabled query expansion. Only the exact search query
// is used, even if SearchResponse.total_size is zero.
// "AUTO" - Automatic query expansion built by Google Retail Search.
@@ -3786,8 +4102,8 @@ type GoogleCloudRetailV2SearchRequestSpellCorrectionSpec struct {
// replace the original search query. Default to Mode.AUTO.
//
// Possible values:
- // "MODE_UNSPECIFIED" - Unspecified spell correction mode. This
- // defaults to Mode.AUTO.
+ // "MODE_UNSPECIFIED" - Unspecified spell correction mode. In this
+ // case, server behavior defaults to Mode.AUTO.
// "SUGGESTION_ONLY" - Google Retail Search will try to find a spell
// suggestion if there is any and put in the
// SearchResponse.corrected_query. The spell suggestion will not be used
@@ -3940,6 +4256,16 @@ type GoogleCloudRetailV2SearchResponseFacetFacetValue struct {
// "price".
Interval *GoogleCloudRetailV2Interval `json:"interval,omitempty"`
+ // MaxValue: The maximum value in the FacetValue.interval. Only
+ // supported on numerical facets and returned if
+ // SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+ MaxValue float64 `json:"maxValue,omitempty"`
+
+ // MinValue: The minimum value in the FacetValue.interval. Only
+ // supported on numerical facets and returned if
+ // SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+ MinValue float64 `json:"minValue,omitempty"`
+
// Value: Text value of a facet, such as "Black" for facet
// "colorFamilies".
Value string `json:"value,omitempty"`
@@ -3967,6 +4293,22 @@ func (s *GoogleCloudRetailV2SearchResponseFacetFacetValue) MarshalJSON() ([]byte
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+func (s *GoogleCloudRetailV2SearchResponseFacetFacetValue) UnmarshalJSON(data []byte) error {
+ type NoMethod GoogleCloudRetailV2SearchResponseFacetFacetValue
+ var s1 struct {
+ MaxValue gensupport.JSONFloat64 `json:"maxValue"`
+ MinValue gensupport.JSONFloat64 `json:"minValue"`
+ *NoMethod
+ }
+ s1.NoMethod = (*NoMethod)(s)
+ if err := json.Unmarshal(data, &s1); err != nil {
+ return err
+ }
+ s.MaxValue = float64(s1.MaxValue)
+ s.MinValue = float64(s1.MinValue)
+ return nil
+}
+
// GoogleCloudRetailV2SearchResponseQueryExpansionInfo: Information
// describing query expansion including whether expansion has occurred.
type GoogleCloudRetailV2SearchResponseQueryExpansionInfo struct {
@@ -4020,6 +4362,14 @@ type GoogleCloudRetailV2SearchResponseSearchResult struct {
// ColorInfo and the query.
MatchingVariantFields map[string]string `json:"matchingVariantFields,omitempty"`
+ // PersonalLabels: Specifies previous events related to this product for
+ // this user based on UserEvent with same SearchRequest.visitor_id or
+ // UserInfo.user_id. This is set only when
+ // SearchRequest.PersonalizationSpec.mode is
+ // SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: *
+ // `purchased`: Indicates that this product has been purchased before.
+ PersonalLabels []string `json:"personalLabels,omitempty"`
+
// Product: The product data snippet in the search response. Only
// Product.name is guaranteed to be populated. Product.variants contains
// the product variants that match the search query. If there are
@@ -4846,7 +5196,7 @@ func (s *GoogleCloudRetailV2alphaImportCompletionDataResponse) MarshalJSON() ([]
// destination for Import related errors.
type GoogleCloudRetailV2alphaImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -4875,7 +5225,7 @@ func (s *GoogleCloudRetailV2alphaImportErrorsConfig) MarshalJSON() ([]byte, erro
}
// GoogleCloudRetailV2alphaImportMetadata: Metadata related to the
-// progress of the Import operation. This will be returned by the
+// progress of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2alphaImportMetadata struct {
// CreateTime: Operation create time.
@@ -4886,9 +5236,9 @@ type GoogleCloudRetailV2alphaImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -4898,6 +5248,10 @@ type GoogleCloudRetailV2alphaImportMetadata struct {
// SuccessCount: Count of entries that were processed successfully.
SuccessCount int64 `json:"successCount,omitempty,string"`
+ // TransformedUserEventsMetadata: Metadata related to transform user
+ // events.
+ TransformedUserEventsMetadata *GoogleCloudRetailV2alphaTransformedUserEventsMetadata `json:"transformedUserEventsMetadata,omitempty"`
+
// UpdateTime: Operation last update time. If the operation is done,
// this is also the finish time.
UpdateTime string `json:"updateTime,omitempty"`
@@ -5004,21 +5358,21 @@ func (s *GoogleCloudRetailV2alphaImportUserEventsResponse) MarshalJSON() ([]byte
// GoogleCloudRetailV2alphaModel: Metadata that describes the training
// and serving parameters of a Model. A Model can be associated with a
-// ServingConfig and then queried through the Predict api.
+// ServingConfig and then queried through the Predict API.
type GoogleCloudRetailV2alphaModel struct {
// CreateTime: Output only. Timestamp the Recommendation Model was
// created at.
CreateTime string `json:"createTime,omitempty"`
// DataState: Output only. The state of data requirements for this
- // model: DATA_OK and DATA_ERROR. Recommendation model cannot be trained
- // if the data is in DATA_ERROR state. Recommendation model can have
- // DATA_ERROR state even if serving state is ACTIVE: models were trained
- // successfully before, but cannot be refreshed because model no longer
- // has sufficient data for training.
+ // model: `DATA_OK` and `DATA_ERROR`. Recommendation model cannot be
+ // trained if the data is in `DATA_ERROR` state. Recommendation model
+ // can have `DATA_ERROR` state even if serving state is `ACTIVE`: models
+ // were trained successfully before, but cannot be refreshed because
+ // model no longer has sufficient data for training.
//
// Possible values:
- // "DATA_STATE_UNSPECIFIED" - Unspecified default value - should never
+ // "DATA_STATE_UNSPECIFIED" - Unspecified default value, should never
// be explicitly set.
// "DATA_OK" - The model has sufficient training data.
// "DATA_ERROR" - The model does not have sufficient training data.
@@ -5026,17 +5380,18 @@ type GoogleCloudRetailV2alphaModel struct {
DataState string `json:"dataState,omitempty"`
// DisplayName: Required. The display name of the model. Should be human
- // readable, used to display Recommendation Models in the Retail
- // Pantheon Dashboard. UTF-8 encoded string with limit of 1024
+ // readable, used to display Recommendation Models in the Retail Cloud
+ // Console Dashboard. UTF-8 encoded string with limit of 1024
// characters.
DisplayName string `json:"displayName,omitempty"`
- // FilteringOption: Optional. If RECOMMENDATIONS_FILTERING_ENABLED,
+ // FilteringOption: Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`,
// recommendation filtering by attributes is enabled for the model.
//
// Possible values:
// "RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED" - Value used when
- // unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.
+ // unset. In this case, server behavior defaults to
+ // RECOMMENDATIONS_FILTERING_DISABLED.
// "RECOMMENDATIONS_FILTERING_DISABLED" - Recommendation filtering is
// disabled.
// "RECOMMENDATIONS_FILTERING_ENABLED" - Recommendation filtering is
@@ -5049,8 +5404,8 @@ type GoogleCloudRetailV2alphaModel struct {
// Name: Required. The fully qualified resource name of the model.
// Format:
- // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id
- // }/models/{model_id} catalog_id has char limit of 50.
+ // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_i
+ // d}/models/{model_id}` catalog_id has char limit of 50.
// recommendation_model_id has char limit of 40.
Name string `json:"name,omitempty"`
@@ -5067,19 +5422,20 @@ type GoogleCloudRetailV2alphaModel struct {
// PeriodicTuningState: Optional. The state of periodic tuning. The
// period we use is 3 months - to do a one-off tune earlier use the
- // TuneModel method. Default value is PERIODIC_TUNING_ENABLED.
+ // `TuneModel` method. Default value is `PERIODIC_TUNING_ENABLED`.
//
// Possible values:
- // "PERIODIC_TUNING_STATE_UNSPECIFIED" - Unspecified default value -
+ // "PERIODIC_TUNING_STATE_UNSPECIFIED" - Unspecified default value,
// should never be explicitly set.
// "PERIODIC_TUNING_DISABLED" - The model has periodic tuning
// disabled. Tuning can be reenabled by calling the
- // EnableModelPeriodicTuning method or by calling the TuneModel method.
+ // `EnableModelPeriodicTuning` method or by calling the `TuneModel`
+ // method.
// "ALL_TUNING_DISABLED" - The model cannot be tuned with periodic
- // tuning OR the TuneModel method. Hide the options in customer UI and
+ // tuning OR the `TuneModel` method. Hide the options in customer UI and
// reject any requests through the backend self serve API.
// "PERIODIC_TUNING_ENABLED" - The model has periodic tuning enabled.
- // Tuning can be disabled by calling the DisableModelPeriodicTuning
+ // Tuning can be disabled by calling the `DisableModelPeriodicTuning`
// method.
PeriodicTuningState string `json:"periodicTuningState,omitempty"`
@@ -5087,23 +5443,24 @@ type GoogleCloudRetailV2alphaModel struct {
// associated with the PageOptimizationConfig.
ServingConfigLists []*GoogleCloudRetailV2alphaModelServingConfigList `json:"servingConfigLists,omitempty"`
- // ServingState: Output only. The serving state of the model: ACTIVE,
- // NOT_ACTIVE.
+ // ServingState: Output only. The serving state of the model: `ACTIVE`,
+ // `NOT_ACTIVE`.
//
// Possible values:
// "SERVING_STATE_UNSPECIFIED" - Unspecified serving state.
// "INACTIVE" - The model is not serving.
// "ACTIVE" - The model is serving and can be queried.
- // "TUNED" - The model is trained on tuned hyperparameters, and can be
+ // "TUNED" - The model is trained on tuned hyperparameters and can be
// queried.
ServingState string `json:"servingState,omitempty"`
// TrainingState: Optional. The training state that the model is in
- // (e.g. TRAINING or PAUSED). Since part of the cost of running the
+ // (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the
// service is frequency of training - this can be used to determine when
// to train model in order to control cost. If not specified: the
- // default value for CreateModel method is TRAINING. the default value
- // for UpdateModel method is to keep the state the same as before.
+ // default value for `CreateModel` method is `TRAINING`. The default
+ // value for `UpdateModel` method is to keep the state the same as
+ // before.
//
// Possible values:
// "TRAINING_STATE_UNSPECIFIED" - Unspecified training state.
@@ -5118,8 +5475,8 @@ type GoogleCloudRetailV2alphaModel struct {
// Type: Required. The type of model e.g. `home-page`. Currently
// supported values: `recommended-for-you`, `others-you-may-like`,
- // `frequently-bought-together`, `page-optimization`, 'similar-items',
- // 'buy-it-again', `recently-viewed`(readonly value).
+ // `frequently-bought-together`, `page-optimization`, `similar-items`,
+ // `buy-it-again`, and `recently-viewed`(readonly value).
Type string `json:"type,omitempty"`
// UpdateTime: Output only. Timestamp the Recommendation Model was last
@@ -5196,21 +5553,21 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfig struct {
// candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2
// candidates`: * home_page_ctr_no_diversity,
// home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` =
- // UNIQUE_SERVING_CONFIG_RESTRICTION `Valid combinations`: * * (pdp_ctr,
- // home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low)
- // * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) *
- // (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr,
- // home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) *
- // (home_page_ctr_no_diversity, home_page_ctr_diversity_low) *
- // (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid
- // combinations`: * * (home_page_ctr_no_diversity,
- // home_page_ctr_no_diversity) *
+ // `UNIQUE_SERVING_CONFIG_RESTRICTION` `Valid combinations`: * *
+ // (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr,
+ // home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) *
+ // (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr,
+ // home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low)
+ // * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity,
+ // home_page_ctr_diversity_low) * (home_page_ctr_no_diversity,
+ // pdp_cvr_no_diversity) * `Invalid combinations`: * *
+ // (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *
// "UNIQUE_MODEL_RESTRICTION" - Do not allow multiple ServingConfigs
// with same Model.name to be show on on different panels. Example:
// `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity *
// `Panel2 candidates`: * home_page_ctr_no_diversity,
// home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` =
- // UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr,
+ // `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr,
// home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) *
// (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) *
// (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr,
@@ -5223,7 +5580,7 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfig struct {
// Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr,
// home_page_ctr_no_diversity * `Panel2 candidates`: *
// home_page_ctr_no_diversity, home_page_ctr_diversity_low,
- // pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION
+ // pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
// `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) *
// (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr,
// home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low)
@@ -5263,10 +5620,10 @@ func (s *GoogleCloudRetailV2alphaModelPageOptimizationConfig) MarshalJSON() ([]b
// candidate to consider for a given panel. Currently only ServingConfig
// are valid candidates.
type GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate struct {
- // ServingConfigId: This has to be a valid ServingConfig identifier.
- // e.g. for a ServingConfig with full name:
+ // ServingConfigId: This has to be a valid ServingConfig identifier. For
+ // example, for a ServingConfig with full name:
// `projects/*/locations/global/catalogs/default_catalog/servingConfigs/m
- // y_candidate_config` this would be 'my_candidate_config'
+ // y_candidate_config`, this would be `my_candidate_config`.
ServingConfigId string `json:"servingConfigId,omitempty"`
// ForceSendFields is a list of field names (e.g. "ServingConfigId") to
@@ -5300,8 +5657,8 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel struct {
// = 10.
Candidates []*GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate `json:"candidates,omitempty"`
- // DefaultCandidate: Required. The default candidate (in case the model
- // fails at serving time, we can fall back to the default).
+ // DefaultCandidate: Required. The default candidate. If the model fails
+ // at serving time, we fall back to the default.
DefaultCandidate *GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate `json:"defaultCandidate,omitempty"`
// DisplayName: Optional. The name to display for the panel.
@@ -5331,11 +5688,11 @@ func (s *GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel) MarshalJSON()
}
// GoogleCloudRetailV2alphaModelServingConfigList: Represents an ordered
-// combination of valid serving configs, which / may be used for
-// PAGE_OPTIMIZATION recommendations.
+// combination of valid serving configs, which can be used for
+// `PAGE_OPTIMIZATION` recommendations.
type GoogleCloudRetailV2alphaModelServingConfigList struct {
// ServingConfigIds: Optional. A set of valid serving configs that may
- // be used for PAGE_OPTIMIZATION.
+ // be used for `PAGE_OPTIMIZATION`.
ServingConfigIds []string `json:"servingConfigIds,omitempty"`
// ForceSendFields is a list of field names (e.g. "ServingConfigIds") to
@@ -5586,6 +5943,42 @@ type GoogleCloudRetailV2alphaSetInventoryMetadata struct {
type GoogleCloudRetailV2alphaSetInventoryResponse struct {
}
+// GoogleCloudRetailV2alphaTransformedUserEventsMetadata: Metadata
+// related to transform user events operation.
+type GoogleCloudRetailV2alphaTransformedUserEventsMetadata struct {
+ // SourceEventsCount: Count of entries in the source user events
+ // BigQuery table.
+ SourceEventsCount int64 `json:"sourceEventsCount,omitempty,string"`
+
+ // TransformedEventsCount: Count of entries in the transformed user
+ // events BigQuery table, which could be different from the actually
+ // imported number of user events.
+ TransformedEventsCount int64 `json:"transformedEventsCount,omitempty,string"`
+
+ // ForceSendFields is a list of field names (e.g. "SourceEventsCount")
+ // to unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "SourceEventsCount") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2alphaTransformedUserEventsMetadata) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2alphaTuneModelMetadata: Metadata associated with a
// tune operation.
type GoogleCloudRetailV2alphaTuneModelMetadata struct {
@@ -5902,7 +6295,7 @@ func (s *GoogleCloudRetailV2betaImportCompletionDataResponse) MarshalJSON() ([]b
// destination for Import related errors.
type GoogleCloudRetailV2betaImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -5931,7 +6324,7 @@ func (s *GoogleCloudRetailV2betaImportErrorsConfig) MarshalJSON() ([]byte, error
}
// GoogleCloudRetailV2betaImportMetadata: Metadata related to the
-// progress of the Import operation. This will be returned by the
+// progress of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2betaImportMetadata struct {
// CreateTime: Operation create time.
@@ -5942,9 +6335,9 @@ type GoogleCloudRetailV2betaImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -6457,9 +6850,9 @@ type ProjectsLocationsCatalogsCompleteQueryCall struct {
// Search enabled. Please enable Retail Search on Cloud Console before
// using this feature.
//
-// - catalog: Catalog for which the completion is performed. Full
-// resource name of catalog, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: Catalog for which the completion is performed. Full
+// resource name of catalog, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) CompleteQuery(catalog string) *ProjectsLocationsCatalogsCompleteQueryCall {
c := &ProjectsLocationsCatalogsCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -6695,33 +7088,32 @@ func (c *ProjectsLocationsCatalogsCompleteQueryCall) Do(opts ...googleapi.CallOp
}
-// method id "retail.projects.locations.catalogs.getDefaultBranch":
+// method id "retail.projects.locations.catalogs.getAttributesConfig":
-type ProjectsLocationsCatalogsGetDefaultBranchCall struct {
+type ProjectsLocationsCatalogsGetAttributesConfigCall struct {
s *Service
- catalog string
+ name string
urlParams_ gensupport.URLParams
ifNoneMatch_ string
ctx_ context.Context
header_ http.Header
}
-// GetDefaultBranch: Get which branch is currently default branch set by
-// CatalogService.SetDefaultBranch method under a specified parent
-// catalog.
+// GetAttributesConfig: Gets an AttributesConfig.
//
-// - catalog: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
-func (r *ProjectsLocationsCatalogsService) GetDefaultBranch(catalog string) *ProjectsLocationsCatalogsGetDefaultBranchCall {
- c := &ProjectsLocationsCatalogsGetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
- c.catalog = catalog
+// - name: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
+func (r *ProjectsLocationsCatalogsService) GetAttributesConfig(name string) *ProjectsLocationsCatalogsGetAttributesConfigCall {
+ c := &ProjectsLocationsCatalogsGetAttributesConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
-func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+func (c *ProjectsLocationsCatalogsGetAttributesConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsGetAttributesConfigCall {
c.urlParams_.Set("fields", googleapi.CombineFields(s))
return c
}
@@ -6731,7 +7123,7 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Fields(s ...googleapi.Fi
// getting updates only after the object has changed since the last
// request. Use googleapi.IsNotModified to check whether the response
// error from Do is the result of In-None-Match.
-func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) IfNoneMatch(entityTag string) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+func (c *ProjectsLocationsCatalogsGetAttributesConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsCatalogsGetAttributesConfigCall {
c.ifNoneMatch_ = entityTag
return c
}
@@ -6739,21 +7131,21 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) IfNoneMatch(entityTag st
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
-func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+func (c *ProjectsLocationsCatalogsGetAttributesConfigCall) Context(ctx context.Context) *ProjectsLocationsCatalogsGetAttributesConfigCall {
c.ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
-func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Header() http.Header {
+func (c *ProjectsLocationsCatalogsGetAttributesConfigCall) Header() http.Header {
if c.header_ == nil {
c.header_ = make(http.Header)
}
return c.header_
}
-func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) doRequest(alt string) (*http.Response, error) {
+func (c *ProjectsLocationsCatalogsGetAttributesConfigCall) doRequest(alt string) (*http.Response, error) {
reqHeaders := make(http.Header)
reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
for k, v := range c.header_ {
@@ -6766,7 +7158,7 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) doRequest(alt string) (*
var body io.Reader = nil
c.urlParams_.Set("alt", alt)
c.urlParams_.Set("prettyPrint", "false")
- urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+catalog}:getDefaultBranch")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}")
urls += "?" + c.urlParams_.Encode()
req, err := http.NewRequest("GET", urls, body)
if err != nil {
@@ -6774,21 +7166,20 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) doRequest(alt string) (*
}
req.Header = reqHeaders
googleapi.Expand(req.URL, map[string]string{
- "catalog": c.catalog,
+ "name": c.name,
})
return gensupport.SendRequest(c.ctx_, c.s.client, req)
}
-// Do executes the "retail.projects.locations.catalogs.getDefaultBranch" call.
-// Exactly one of *GoogleCloudRetailV2GetDefaultBranchResponse or error
-// will be non-nil. Any non-2xx status code is an error. Response
-// headers are in either
-// *GoogleCloudRetailV2GetDefaultBranchResponse.ServerResponse.Header or
+// Do executes the "retail.projects.locations.catalogs.getAttributesConfig" call.
+// Exactly one of *GoogleCloudRetailV2AttributesConfig or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudRetailV2AttributesConfig.ServerResponse.Header or
// (if a response was returned at all) in
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
-func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2GetDefaultBranchResponse, error) {
+func (c *ProjectsLocationsCatalogsGetAttributesConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2AttributesConfig, error) {
gensupport.SetOptions(c.urlParams_, opts...)
res, err := c.doRequest("json")
if res != nil && res.StatusCode == http.StatusNotModified {
@@ -6807,7 +7198,7 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Do(opts ...googleapi.Cal
if err := googleapi.CheckResponse(res); err != nil {
return nil, err
}
- ret := &GoogleCloudRetailV2GetDefaultBranchResponse{
+ ret := &GoogleCloudRetailV2AttributesConfig{
ServerResponse: googleapi.ServerResponse{
Header: res.Header,
HTTPStatusCode: res.StatusCode,
@@ -6819,25 +7210,25 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Do(opts ...googleapi.Cal
}
return ret, nil
// {
- // "description": "Get which branch is currently default branch set by CatalogService.SetDefaultBranch method under a specified parent catalog.",
- // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:getDefaultBranch",
+ // "description": "Gets an AttributesConfig.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig",
// "httpMethod": "GET",
- // "id": "retail.projects.locations.catalogs.getDefaultBranch",
+ // "id": "retail.projects.locations.catalogs.getAttributesConfig",
// "parameterOrder": [
- // "catalog"
+ // "name"
// ],
// "parameters": {
- // "catalog": {
- // "description": "The parent catalog resource name, such as `projects/*/locations/global/catalogs/default_catalog`.",
+ // "name": {
+ // "description": "Required. Full AttributesConfig resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
// "location": "path",
- // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
// "required": true,
// "type": "string"
// }
// },
- // "path": "v2/{+catalog}:getDefaultBranch",
+ // "path": "v2/{+name}",
// "response": {
- // "$ref": "GoogleCloudRetailV2GetDefaultBranchResponse"
+ // "$ref": "GoogleCloudRetailV2AttributesConfig"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform"
@@ -6846,42 +7237,342 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Do(opts ...googleapi.Cal
}
-// method id "retail.projects.locations.catalogs.list":
+// method id "retail.projects.locations.catalogs.getCompletionConfig":
-type ProjectsLocationsCatalogsListCall struct {
+type ProjectsLocationsCatalogsGetCompletionConfigCall struct {
s *Service
- parent string
+ name string
urlParams_ gensupport.URLParams
ifNoneMatch_ string
ctx_ context.Context
header_ http.Header
}
-// List: Lists all the Catalogs associated with the project.
+// GetCompletionConfig: Gets a CompletionConfig.
//
-// - parent: The account resource name with an associated location. If
-// the caller does not have permission to list Catalogs under this
-// location, regardless of whether or not this location exists, a
-// PERMISSION_DENIED error is returned.
-func (r *ProjectsLocationsCatalogsService) List(parent string) *ProjectsLocationsCatalogsListCall {
- c := &ProjectsLocationsCatalogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
- c.parent = parent
+// - name: Full CompletionConfig resource name. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/completionConfig.
+func (r *ProjectsLocationsCatalogsService) GetCompletionConfig(name string) *ProjectsLocationsCatalogsGetCompletionConfigCall {
+ c := &ProjectsLocationsCatalogsGetCompletionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
return c
}
-// PageSize sets the optional parameter "pageSize": Maximum number of
-// Catalogs to return. If unspecified, defaults to 50. The maximum
-// allowed value is 1000. Values above 1000 will be coerced to 1000. If
-// this field is negative, an INVALID_ARGUMENT is returned.
-func (c *ProjectsLocationsCatalogsListCall) PageSize(pageSize int64) *ProjectsLocationsCatalogsListCall {
- c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsGetCompletionConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsGetCompletionConfigCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
return c
}
-// PageToken sets the optional parameter "pageToken": A page token
-// ListCatalogsResponse.next_page_token, received from a previous
-// CatalogService.ListCatalogs call. Provide this to retrieve the
-// subsequent page. When paginating, all other parameters provided to
+// IfNoneMatch sets the optional parameter which makes the operation
+// fail if the object's ETag matches the given value. This is useful for
+// getting updates only after the object has changed since the last
+// request. Use googleapi.IsNotModified to check whether the response
+// error from Do is the result of In-None-Match.
+func (c *ProjectsLocationsCatalogsGetCompletionConfigCall) IfNoneMatch(entityTag string) *ProjectsLocationsCatalogsGetCompletionConfigCall {
+ c.ifNoneMatch_ = entityTag
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsGetCompletionConfigCall) Context(ctx context.Context) *ProjectsLocationsCatalogsGetCompletionConfigCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsGetCompletionConfigCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsGetCompletionConfigCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ if c.ifNoneMatch_ != "" {
+ reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
+ }
+ var body io.Reader = nil
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("GET", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.getCompletionConfig" call.
+// Exactly one of *GoogleCloudRetailV2CompletionConfig or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudRetailV2CompletionConfig.ServerResponse.Header or
+// (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsGetCompletionConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2CompletionConfig, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2CompletionConfig{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Gets a CompletionConfig.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionConfig",
+ // "httpMethod": "GET",
+ // "id": "retail.projects.locations.catalogs.getCompletionConfig",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. Full CompletionConfig resource name. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/completionConfig$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+name}",
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2CompletionConfig"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// method id "retail.projects.locations.catalogs.getDefaultBranch":
+
+type ProjectsLocationsCatalogsGetDefaultBranchCall struct {
+ s *Service
+ catalog string
+ urlParams_ gensupport.URLParams
+ ifNoneMatch_ string
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// GetDefaultBranch: Get which branch is currently default branch set by
+// CatalogService.SetDefaultBranch method under a specified parent
+// catalog.
+//
+// - catalog: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
+func (r *ProjectsLocationsCatalogsService) GetDefaultBranch(catalog string) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+ c := &ProjectsLocationsCatalogsGetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.catalog = catalog
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// IfNoneMatch sets the optional parameter which makes the operation
+// fail if the object's ETag matches the given value. This is useful for
+// getting updates only after the object has changed since the last
+// request. Use googleapi.IsNotModified to check whether the response
+// error from Do is the result of In-None-Match.
+func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) IfNoneMatch(entityTag string) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+ c.ifNoneMatch_ = entityTag
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsGetDefaultBranchCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ if c.ifNoneMatch_ != "" {
+ reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
+ }
+ var body io.Reader = nil
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+catalog}:getDefaultBranch")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("GET", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "catalog": c.catalog,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.getDefaultBranch" call.
+// Exactly one of *GoogleCloudRetailV2GetDefaultBranchResponse or error
+// will be non-nil. Any non-2xx status code is an error. Response
+// headers are in either
+// *GoogleCloudRetailV2GetDefaultBranchResponse.ServerResponse.Header or
+// (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2GetDefaultBranchResponse, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2GetDefaultBranchResponse{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Get which branch is currently default branch set by CatalogService.SetDefaultBranch method under a specified parent catalog.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:getDefaultBranch",
+ // "httpMethod": "GET",
+ // "id": "retail.projects.locations.catalogs.getDefaultBranch",
+ // "parameterOrder": [
+ // "catalog"
+ // ],
+ // "parameters": {
+ // "catalog": {
+ // "description": "The parent catalog resource name, such as `projects/*/locations/global/catalogs/default_catalog`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+catalog}:getDefaultBranch",
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2GetDefaultBranchResponse"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// method id "retail.projects.locations.catalogs.list":
+
+type ProjectsLocationsCatalogsListCall struct {
+ s *Service
+ parent string
+ urlParams_ gensupport.URLParams
+ ifNoneMatch_ string
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// List: Lists all the Catalogs associated with the project.
+//
+// - parent: The account resource name with an associated location. If
+// the caller does not have permission to list Catalogs under this
+// location, regardless of whether or not this location exists, a
+// PERMISSION_DENIED error is returned.
+func (r *ProjectsLocationsCatalogsService) List(parent string) *ProjectsLocationsCatalogsListCall {
+ c := &ProjectsLocationsCatalogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.parent = parent
+ return c
+}
+
+// PageSize sets the optional parameter "pageSize": Maximum number of
+// Catalogs to return. If unspecified, defaults to 50. The maximum
+// allowed value is 1000. Values above 1000 will be coerced to 1000. If
+// this field is negative, an INVALID_ARGUMENT is returned.
+func (c *ProjectsLocationsCatalogsListCall) PageSize(pageSize int64) *ProjectsLocationsCatalogsListCall {
+ c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
+ return c
+}
+
+// PageToken sets the optional parameter "pageToken": A page token
+// ListCatalogsResponse.next_page_token, received from a previous
+// CatalogService.ListCatalogs call. Provide this to retrieve the
+// subsequent page. When paginating, all other parameters provided to
// CatalogService.ListCatalogs must match the call that provided the
// page token. Otherwise, an INVALID_ARGUMENT error is returned.
func (c *ProjectsLocationsCatalogsListCall) PageToken(pageToken string) *ProjectsLocationsCatalogsListCall {
@@ -6892,73 +7583,743 @@ func (c *ProjectsLocationsCatalogsListCall) PageToken(pageToken string) *Project
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
-func (c *ProjectsLocationsCatalogsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsListCall {
+func (c *ProjectsLocationsCatalogsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsListCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// IfNoneMatch sets the optional parameter which makes the operation
+// fail if the object's ETag matches the given value. This is useful for
+// getting updates only after the object has changed since the last
+// request. Use googleapi.IsNotModified to check whether the response
+// error from Do is the result of In-None-Match.
+func (c *ProjectsLocationsCatalogsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCatalogsListCall {
+ c.ifNoneMatch_ = entityTag
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsListCall) Context(ctx context.Context) *ProjectsLocationsCatalogsListCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsListCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsListCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ if c.ifNoneMatch_ != "" {
+ reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
+ }
+ var body io.Reader = nil
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/catalogs")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("GET", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "parent": c.parent,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.list" call.
+// Exactly one of *GoogleCloudRetailV2ListCatalogsResponse or error will
+// be non-nil. Any non-2xx status code is an error. Response headers are
+// in either
+// *GoogleCloudRetailV2ListCatalogsResponse.ServerResponse.Header or (if
+// a response was returned at all) in error.(*googleapi.Error).Header.
+// Use googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsCatalogsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2ListCatalogsResponse, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2ListCatalogsResponse{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Lists all the Catalogs associated with the project.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs",
+ // "httpMethod": "GET",
+ // "id": "retail.projects.locations.catalogs.list",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "pageSize": {
+ // "description": "Maximum number of Catalogs to return. If unspecified, defaults to 50. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an INVALID_ARGUMENT is returned.",
+ // "format": "int32",
+ // "location": "query",
+ // "type": "integer"
+ // },
+ // "pageToken": {
+ // "description": "A page token ListCatalogsResponse.next_page_token, received from a previous CatalogService.ListCatalogs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to CatalogService.ListCatalogs must match the call that provided the page token. Otherwise, an INVALID_ARGUMENT error is returned.",
+ // "location": "query",
+ // "type": "string"
+ // },
+ // "parent": {
+ // "description": "Required. The account resource name with an associated location. If the caller does not have permission to list Catalogs under this location, regardless of whether or not this location exists, a PERMISSION_DENIED error is returned.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+parent}/catalogs",
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2ListCatalogsResponse"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// Pages invokes f for each page of results.
+// A non-nil error returned from f will halt the iteration.
+// The provided context supersedes any context provided to the Context method.
+func (c *ProjectsLocationsCatalogsListCall) Pages(ctx context.Context, f func(*GoogleCloudRetailV2ListCatalogsResponse) error) error {
+ c.ctx_ = ctx
+ defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point
+ for {
+ x, err := c.Do()
+ if err != nil {
+ return err
+ }
+ if err := f(x); err != nil {
+ return err
+ }
+ if x.NextPageToken == "" {
+ return nil
+ }
+ c.PageToken(x.NextPageToken)
+ }
+}
+
+// method id "retail.projects.locations.catalogs.patch":
+
+type ProjectsLocationsCatalogsPatchCall struct {
+ s *Service
+ name string
+ googlecloudretailv2catalog *GoogleCloudRetailV2Catalog
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Patch: Updates the Catalogs.
+//
+// - name: Immutable. The fully qualified resource name of the catalog.
+func (r *ProjectsLocationsCatalogsService) Patch(name string, googlecloudretailv2catalog *GoogleCloudRetailV2Catalog) *ProjectsLocationsCatalogsPatchCall {
+ c := &ProjectsLocationsCatalogsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ c.googlecloudretailv2catalog = googlecloudretailv2catalog
+ return c
+}
+
+// UpdateMask sets the optional parameter "updateMask": Indicates which
+// fields in the provided Catalog to update. If an unsupported or
+// unknown field is provided, an INVALID_ARGUMENT error is returned.
+func (c *ProjectsLocationsCatalogsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsPatchCall {
+ c.urlParams_.Set("updateMask", updateMask)
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsPatchCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsPatchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsPatchCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsPatchCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsPatchCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2catalog)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("PATCH", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.patch" call.
+// Exactly one of *GoogleCloudRetailV2Catalog or error will be non-nil.
+// Any non-2xx status code is an error. Response headers are in either
+// *GoogleCloudRetailV2Catalog.ServerResponse.Header or (if a response
+// was returned at all) in error.(*googleapi.Error).Header. Use
+// googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsCatalogsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2Catalog, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2Catalog{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Updates the Catalogs.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}",
+ // "httpMethod": "PATCH",
+ // "id": "retail.projects.locations.catalogs.patch",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. Immutable. The fully qualified resource name of the catalog.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // },
+ // "updateMask": {
+ // "description": "Indicates which fields in the provided Catalog to update. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.",
+ // "format": "google-fieldmask",
+ // "location": "query",
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+name}",
+ // "request": {
+ // "$ref": "GoogleCloudRetailV2Catalog"
+ // },
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2Catalog"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// method id "retail.projects.locations.catalogs.setDefaultBranch":
+
+type ProjectsLocationsCatalogsSetDefaultBranchCall struct {
+ s *Service
+ catalog string
+ googlecloudretailv2setdefaultbranchrequest *GoogleCloudRetailV2SetDefaultBranchRequest
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// SetDefaultBranch: Set a specified branch id as default branch. API
+// methods such as SearchService.Search, ProductService.GetProduct,
+// ProductService.ListProducts will treat requests using
+// "default_branch" to the actual branch id set as default. For example,
+// if `projects/*/locations/*/catalogs/*/branches/1` is set as default,
+// setting SearchRequest.branch to
+// `projects/*/locations/*/catalogs/*/branches/default_branch` is
+// equivalent to setting SearchRequest.branch to
+// `projects/*/locations/*/catalogs/*/branches/1`. Using multiple
+// branches can be useful when developers would like to have a staging
+// branch to test and verify for future usage. When it becomes ready,
+// developers switch on the staging branch using this API while keeping
+// using `projects/*/locations/*/catalogs/*/branches/default_branch` as
+// SearchRequest.branch to route the traffic to this staging branch.
+// CAUTION: If you have live predict/search traffic, switching the
+// default branch could potentially cause outages if the ID space of the
+// new branch is very different from the old one. More specifically: *
+// PredictionService will only return product IDs from branch
+// {newBranch}. * SearchService will only return product IDs from branch
+// {newBranch} (if branch is not explicitly set). * UserEventService
+// will only join events with products from branch {newBranch}.
+//
+// - catalog: Full resource name of the catalog, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
+func (r *ProjectsLocationsCatalogsService) SetDefaultBranch(catalog string, googlecloudretailv2setdefaultbranchrequest *GoogleCloudRetailV2SetDefaultBranchRequest) *ProjectsLocationsCatalogsSetDefaultBranchCall {
+ c := &ProjectsLocationsCatalogsSetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.catalog = catalog
+ c.googlecloudretailv2setdefaultbranchrequest = googlecloudretailv2setdefaultbranchrequest
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsSetDefaultBranchCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsSetDefaultBranchCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2setdefaultbranchrequest)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+catalog}:setDefaultBranch")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("POST", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "catalog": c.catalog,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.setDefaultBranch" call.
+// Exactly one of *GoogleProtobufEmpty or error will be non-nil. Any
+// non-2xx status code is an error. Response headers are in either
+// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was
+// returned at all) in error.(*googleapi.Error).Header. Use
+// googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleProtobufEmpty{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Set a specified branch id as default branch. API methods such as SearchService.Search, ProductService.GetProduct, ProductService.ListProducts will treat requests using \"default_branch\" to the actual branch id set as default. For example, if `projects/*/locations/*/catalogs/*/branches/1` is set as default, setting SearchRequest.branch to `projects/*/locations/*/catalogs/*/branches/default_branch` is equivalent to setting SearchRequest.branch to `projects/*/locations/*/catalogs/*/branches/1`. Using multiple branches can be useful when developers would like to have a staging branch to test and verify for future usage. When it becomes ready, developers switch on the staging branch using this API while keeping using `projects/*/locations/*/catalogs/*/branches/default_branch` as SearchRequest.branch to route the traffic to this staging branch. CAUTION: If you have live predict/search traffic, switching the default branch could potentially cause outages if the ID space of the new branch is very different from the old one. More specifically: * PredictionService will only return product IDs from branch {newBranch}. * SearchService will only return product IDs from branch {newBranch} (if branch is not explicitly set). * UserEventService will only join events with products from branch {newBranch}.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:setDefaultBranch",
+ // "httpMethod": "POST",
+ // "id": "retail.projects.locations.catalogs.setDefaultBranch",
+ // "parameterOrder": [
+ // "catalog"
+ // ],
+ // "parameters": {
+ // "catalog": {
+ // "description": "Full resource name of the catalog, such as `projects/*/locations/global/catalogs/default_catalog`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+catalog}:setDefaultBranch",
+ // "request": {
+ // "$ref": "GoogleCloudRetailV2SetDefaultBranchRequest"
+ // },
+ // "response": {
+ // "$ref": "GoogleProtobufEmpty"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// method id "retail.projects.locations.catalogs.updateAttributesConfig":
+
+type ProjectsLocationsCatalogsUpdateAttributesConfigCall struct {
+ s *Service
+ name string
+ googlecloudretailv2attributesconfig *GoogleCloudRetailV2AttributesConfig
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// UpdateAttributesConfig: Updates the AttributesConfig. The catalog
+// attributes in the request will be updated in the catalog, or inserted
+// if they do not exist. Existing catalog attributes not included in the
+// request will remain unchanged. Attributes that are assigned to
+// products, but do not exist at the catalog level, are always included
+// in the response. The product attribute is assigned default values for
+// missing catalog attribute fields, e.g., searchable and dynamic
+// facetable options.
+//
+// - name: Immutable. The fully qualified resource name of the attribute
+// config. Format:
+// `projects/*/locations/*/catalogs/*/attributesConfig`.
+func (r *ProjectsLocationsCatalogsService) UpdateAttributesConfig(name string, googlecloudretailv2attributesconfig *GoogleCloudRetailV2AttributesConfig) *ProjectsLocationsCatalogsUpdateAttributesConfigCall {
+ c := &ProjectsLocationsCatalogsUpdateAttributesConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ c.googlecloudretailv2attributesconfig = googlecloudretailv2attributesconfig
+ return c
+}
+
+// UpdateMask sets the optional parameter "updateMask": Indicates which
+// fields in the provided AttributesConfig to update. The following is
+// the only supported field: * AttributesConfig.catalog_attributes If
+// not set, all supported fields are updated.
+func (c *ProjectsLocationsCatalogsUpdateAttributesConfigCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsUpdateAttributesConfigCall {
+ c.urlParams_.Set("updateMask", updateMask)
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsUpdateAttributesConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsUpdateAttributesConfigCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsUpdateAttributesConfigCall) Context(ctx context.Context) *ProjectsLocationsCatalogsUpdateAttributesConfigCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsUpdateAttributesConfigCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsUpdateAttributesConfigCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2attributesconfig)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("PATCH", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.updateAttributesConfig" call.
+// Exactly one of *GoogleCloudRetailV2AttributesConfig or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudRetailV2AttributesConfig.ServerResponse.Header or
+// (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsUpdateAttributesConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2AttributesConfig, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2AttributesConfig{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Updates the AttributesConfig. The catalog attributes in the request will be updated in the catalog, or inserted if they do not exist. Existing catalog attributes not included in the request will remain unchanged. Attributes that are assigned to products, but do not exist at the catalog level, are always included in the response. The product attribute is assigned default values for missing catalog attribute fields, e.g., searchable and dynamic facetable options.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig",
+ // "httpMethod": "PATCH",
+ // "id": "retail.projects.locations.catalogs.updateAttributesConfig",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. Immutable. The fully qualified resource name of the attribute config. Format: `projects/*/locations/*/catalogs/*/attributesConfig`",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ // "required": true,
+ // "type": "string"
+ // },
+ // "updateMask": {
+ // "description": "Indicates which fields in the provided AttributesConfig to update. The following is the only supported field: * AttributesConfig.catalog_attributes If not set, all supported fields are updated.",
+ // "format": "google-fieldmask",
+ // "location": "query",
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2/{+name}",
+ // "request": {
+ // "$ref": "GoogleCloudRetailV2AttributesConfig"
+ // },
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2AttributesConfig"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// method id "retail.projects.locations.catalogs.updateCompletionConfig":
+
+type ProjectsLocationsCatalogsUpdateCompletionConfigCall struct {
+ s *Service
+ name string
+ googlecloudretailv2completionconfig *GoogleCloudRetailV2CompletionConfig
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// UpdateCompletionConfig: Updates the CompletionConfigs.
+//
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/*/catalogs/*/completionConfig`.
+func (r *ProjectsLocationsCatalogsService) UpdateCompletionConfig(name string, googlecloudretailv2completionconfig *GoogleCloudRetailV2CompletionConfig) *ProjectsLocationsCatalogsUpdateCompletionConfigCall {
+ c := &ProjectsLocationsCatalogsUpdateCompletionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ c.googlecloudretailv2completionconfig = googlecloudretailv2completionconfig
+ return c
+}
+
+// UpdateMask sets the optional parameter "updateMask": Indicates which
+// fields in the provided CompletionConfig to update. The following are
+// the only supported fields: * CompletionConfig.matching_order *
+// CompletionConfig.max_suggestions * CompletionConfig.min_prefix_length
+// * CompletionConfig.auto_learning If not set, all supported fields are
+// updated.
+func (c *ProjectsLocationsCatalogsUpdateCompletionConfigCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsUpdateCompletionConfigCall {
+ c.urlParams_.Set("updateMask", updateMask)
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsUpdateCompletionConfigCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsUpdateCompletionConfigCall {
c.urlParams_.Set("fields", googleapi.CombineFields(s))
return c
}
-// IfNoneMatch sets the optional parameter which makes the operation
-// fail if the object's ETag matches the given value. This is useful for
-// getting updates only after the object has changed since the last
-// request. Use googleapi.IsNotModified to check whether the response
-// error from Do is the result of In-None-Match.
-func (c *ProjectsLocationsCatalogsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsCatalogsListCall {
- c.ifNoneMatch_ = entityTag
- return c
-}
-
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
-func (c *ProjectsLocationsCatalogsListCall) Context(ctx context.Context) *ProjectsLocationsCatalogsListCall {
+func (c *ProjectsLocationsCatalogsUpdateCompletionConfigCall) Context(ctx context.Context) *ProjectsLocationsCatalogsUpdateCompletionConfigCall {
c.ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
-func (c *ProjectsLocationsCatalogsListCall) Header() http.Header {
+func (c *ProjectsLocationsCatalogsUpdateCompletionConfigCall) Header() http.Header {
if c.header_ == nil {
c.header_ = make(http.Header)
}
return c.header_
}
-func (c *ProjectsLocationsCatalogsListCall) doRequest(alt string) (*http.Response, error) {
+func (c *ProjectsLocationsCatalogsUpdateCompletionConfigCall) doRequest(alt string) (*http.Response, error) {
reqHeaders := make(http.Header)
reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
for k, v := range c.header_ {
reqHeaders[k] = v
}
reqHeaders.Set("User-Agent", c.s.userAgent())
- if c.ifNoneMatch_ != "" {
- reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
- }
var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2completionconfig)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
c.urlParams_.Set("alt", alt)
c.urlParams_.Set("prettyPrint", "false")
- urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+parent}/catalogs")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}")
urls += "?" + c.urlParams_.Encode()
- req, err := http.NewRequest("GET", urls, body)
+ req, err := http.NewRequest("PATCH", urls, body)
if err != nil {
return nil, err
}
req.Header = reqHeaders
googleapi.Expand(req.URL, map[string]string{
- "parent": c.parent,
+ "name": c.name,
})
return gensupport.SendRequest(c.ctx_, c.s.client, req)
}
-// Do executes the "retail.projects.locations.catalogs.list" call.
-// Exactly one of *GoogleCloudRetailV2ListCatalogsResponse or error will
-// be non-nil. Any non-2xx status code is an error. Response headers are
-// in either
-// *GoogleCloudRetailV2ListCatalogsResponse.ServerResponse.Header or (if
-// a response was returned at all) in error.(*googleapi.Error).Header.
-// Use googleapi.IsNotModified to check whether the returned error was
-// because http.StatusNotModified was returned.
-func (c *ProjectsLocationsCatalogsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2ListCatalogsResponse, error) {
+// Do executes the "retail.projects.locations.catalogs.updateCompletionConfig" call.
+// Exactly one of *GoogleCloudRetailV2CompletionConfig or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudRetailV2CompletionConfig.ServerResponse.Header or
+// (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsUpdateCompletionConfigCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2CompletionConfig, error) {
gensupport.SetOptions(c.urlParams_, opts...)
res, err := c.doRequest("json")
if res != nil && res.StatusCode == http.StatusNotModified {
@@ -6977,7 +8338,7 @@ func (c *ProjectsLocationsCatalogsListCall) Do(opts ...googleapi.CallOption) (*G
if err := googleapi.CheckResponse(res); err != nil {
return nil, err
}
- ret := &GoogleCloudRetailV2ListCatalogsResponse{
+ ret := &GoogleCloudRetailV2CompletionConfig{
ServerResponse: googleapi.ServerResponse{
Header: res.Header,
HTTPStatusCode: res.StatusCode,
@@ -6989,36 +8350,34 @@ func (c *ProjectsLocationsCatalogsListCall) Do(opts ...googleapi.CallOption) (*G
}
return ret, nil
// {
- // "description": "Lists all the Catalogs associated with the project.",
- // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs",
- // "httpMethod": "GET",
- // "id": "retail.projects.locations.catalogs.list",
+ // "description": "Updates the CompletionConfigs.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/completionConfig",
+ // "httpMethod": "PATCH",
+ // "id": "retail.projects.locations.catalogs.updateCompletionConfig",
// "parameterOrder": [
- // "parent"
+ // "name"
// ],
// "parameters": {
- // "pageSize": {
- // "description": "Maximum number of Catalogs to return. If unspecified, defaults to 50. The maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If this field is negative, an INVALID_ARGUMENT is returned.",
- // "format": "int32",
- // "location": "query",
- // "type": "integer"
- // },
- // "pageToken": {
- // "description": "A page token ListCatalogsResponse.next_page_token, received from a previous CatalogService.ListCatalogs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to CatalogService.ListCatalogs must match the call that provided the page token. Otherwise, an INVALID_ARGUMENT error is returned.",
- // "location": "query",
- // "type": "string"
- // },
- // "parent": {
- // "description": "Required. The account resource name with an associated location. If the caller does not have permission to list Catalogs under this location, regardless of whether or not this location exists, a PERMISSION_DENIED error is returned.",
+ // "name": {
+ // "description": "Required. Immutable. Fully qualified name `projects/*/locations/*/catalogs/*/completionConfig`",
// "location": "path",
- // "pattern": "^projects/[^/]+/locations/[^/]+$",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/completionConfig$",
// "required": true,
// "type": "string"
+ // },
+ // "updateMask": {
+ // "description": "Indicates which fields in the provided CompletionConfig to update. The following are the only supported fields: * CompletionConfig.matching_order * CompletionConfig.max_suggestions * CompletionConfig.min_prefix_length * CompletionConfig.auto_learning If not set, all supported fields are updated.",
+ // "format": "google-fieldmask",
+ // "location": "query",
+ // "type": "string"
// }
// },
- // "path": "v2/{+parent}/catalogs",
+ // "path": "v2/{+name}",
+ // "request": {
+ // "$ref": "GoogleCloudRetailV2CompletionConfig"
+ // },
// "response": {
- // "$ref": "GoogleCloudRetailV2ListCatalogsResponse"
+ // "$ref": "GoogleCloudRetailV2CompletionConfig"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform"
@@ -7027,60 +8386,35 @@ func (c *ProjectsLocationsCatalogsListCall) Do(opts ...googleapi.CallOption) (*G
}
-// Pages invokes f for each page of results.
-// A non-nil error returned from f will halt the iteration.
-// The provided context supersedes any context provided to the Context method.
-func (c *ProjectsLocationsCatalogsListCall) Pages(ctx context.Context, f func(*GoogleCloudRetailV2ListCatalogsResponse) error) error {
- c.ctx_ = ctx
- defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point
- for {
- x, err := c.Do()
- if err != nil {
- return err
- }
- if err := f(x); err != nil {
- return err
- }
- if x.NextPageToken == "" {
- return nil
- }
- c.PageToken(x.NextPageToken)
- }
-}
-
-// method id "retail.projects.locations.catalogs.patch":
+// method id "retail.projects.locations.catalogs.attributesConfig.addCatalogAttribute":
-type ProjectsLocationsCatalogsPatchCall struct {
- s *Service
- name string
- googlecloudretailv2catalog *GoogleCloudRetailV2Catalog
- urlParams_ gensupport.URLParams
- ctx_ context.Context
- header_ http.Header
+type ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall struct {
+ s *Service
+ attributesConfig string
+ googlecloudretailv2addcatalogattributerequest *GoogleCloudRetailV2AddCatalogAttributeRequest
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
}
-// Patch: Updates the Catalogs.
+// AddCatalogAttribute: Adds the specified CatalogAttribute to the
+// AttributesConfig. If the CatalogAttribute to add already exists, an
+// ALREADY_EXISTS error is returned.
//
-// - name: Immutable. The fully qualified resource name of the catalog.
-func (r *ProjectsLocationsCatalogsService) Patch(name string, googlecloudretailv2catalog *GoogleCloudRetailV2Catalog) *ProjectsLocationsCatalogsPatchCall {
- c := &ProjectsLocationsCatalogsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
- c.name = name
- c.googlecloudretailv2catalog = googlecloudretailv2catalog
- return c
-}
-
-// UpdateMask sets the optional parameter "updateMask": Indicates which
-// fields in the provided Catalog to update. If an unsupported or
-// unknown field is provided, an INVALID_ARGUMENT error is returned.
-func (c *ProjectsLocationsCatalogsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsPatchCall {
- c.urlParams_.Set("updateMask", updateMask)
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
+func (r *ProjectsLocationsCatalogsAttributesConfigService) AddCatalogAttribute(attributesConfig string, googlecloudretailv2addcatalogattributerequest *GoogleCloudRetailV2AddCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall {
+ c := &ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.attributesConfig = attributesConfig
+ c.googlecloudretailv2addcatalogattributerequest = googlecloudretailv2addcatalogattributerequest
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
-func (c *ProjectsLocationsCatalogsPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsPatchCall {
+func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall {
c.urlParams_.Set("fields", googleapi.CombineFields(s))
return c
}
@@ -7088,21 +8422,21 @@ func (c *ProjectsLocationsCatalogsPatchCall) Fields(s ...googleapi.Field) *Proje
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
-func (c *ProjectsLocationsCatalogsPatchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsPatchCall {
+func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) Context(ctx context.Context) *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall {
c.ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
-func (c *ProjectsLocationsCatalogsPatchCall) Header() http.Header {
+func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) Header() http.Header {
if c.header_ == nil {
c.header_ = make(http.Header)
}
return c.header_
}
-func (c *ProjectsLocationsCatalogsPatchCall) doRequest(alt string) (*http.Response, error) {
+func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) doRequest(alt string) (*http.Response, error) {
reqHeaders := make(http.Header)
reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
for k, v := range c.header_ {
@@ -7110,34 +8444,35 @@ func (c *ProjectsLocationsCatalogsPatchCall) doRequest(alt string) (*http.Respon
}
reqHeaders.Set("User-Agent", c.s.userAgent())
var body io.Reader = nil
- body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2catalog)
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2addcatalogattributerequest)
if err != nil {
return nil, err
}
reqHeaders.Set("Content-Type", "application/json")
c.urlParams_.Set("alt", alt)
c.urlParams_.Set("prettyPrint", "false")
- urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+name}")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+attributesConfig}:addCatalogAttribute")
urls += "?" + c.urlParams_.Encode()
- req, err := http.NewRequest("PATCH", urls, body)
+ req, err := http.NewRequest("POST", urls, body)
if err != nil {
return nil, err
}
req.Header = reqHeaders
googleapi.Expand(req.URL, map[string]string{
- "name": c.name,
+ "attributesConfig": c.attributesConfig,
})
return gensupport.SendRequest(c.ctx_, c.s.client, req)
}
-// Do executes the "retail.projects.locations.catalogs.patch" call.
-// Exactly one of *GoogleCloudRetailV2Catalog or error will be non-nil.
-// Any non-2xx status code is an error. Response headers are in either
-// *GoogleCloudRetailV2Catalog.ServerResponse.Header or (if a response
-// was returned at all) in error.(*googleapi.Error).Header. Use
-// googleapi.IsNotModified to check whether the returned error was
-// because http.StatusNotModified was returned.
-func (c *ProjectsLocationsCatalogsPatchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2Catalog, error) {
+// Do executes the "retail.projects.locations.catalogs.attributesConfig.addCatalogAttribute" call.
+// Exactly one of *GoogleCloudRetailV2AttributesConfig or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudRetailV2AttributesConfig.ServerResponse.Header or
+// (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2AttributesConfig, error) {
gensupport.SetOptions(c.urlParams_, opts...)
res, err := c.doRequest("json")
if res != nil && res.StatusCode == http.StatusNotModified {
@@ -7156,7 +8491,7 @@ func (c *ProjectsLocationsCatalogsPatchCall) Do(opts ...googleapi.CallOption) (*
if err := googleapi.CheckResponse(res); err != nil {
return nil, err
}
- ret := &GoogleCloudRetailV2Catalog{
+ ret := &GoogleCloudRetailV2AttributesConfig{
ServerResponse: googleapi.ServerResponse{
Header: res.Header,
HTTPStatusCode: res.StatusCode,
@@ -7168,34 +8503,28 @@ func (c *ProjectsLocationsCatalogsPatchCall) Do(opts ...googleapi.CallOption) (*
}
return ret, nil
// {
- // "description": "Updates the Catalogs.",
- // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}",
- // "httpMethod": "PATCH",
- // "id": "retail.projects.locations.catalogs.patch",
+ // "description": "Adds the specified CatalogAttribute to the AttributesConfig. If the CatalogAttribute to add already exists, an ALREADY_EXISTS error is returned.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:addCatalogAttribute",
+ // "httpMethod": "POST",
+ // "id": "retail.projects.locations.catalogs.attributesConfig.addCatalogAttribute",
// "parameterOrder": [
- // "name"
+ // "attributesConfig"
// ],
// "parameters": {
- // "name": {
- // "description": "Required. Immutable. The fully qualified resource name of the catalog.",
+ // "attributesConfig": {
+ // "description": "Required. Full AttributesConfig resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
// "location": "path",
- // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
// "required": true,
// "type": "string"
- // },
- // "updateMask": {
- // "description": "Indicates which fields in the provided Catalog to update. If an unsupported or unknown field is provided, an INVALID_ARGUMENT error is returned.",
- // "format": "google-fieldmask",
- // "location": "query",
- // "type": "string"
// }
// },
- // "path": "v2/{+name}",
+ // "path": "v2/{+attributesConfig}:addCatalogAttribute",
// "request": {
- // "$ref": "GoogleCloudRetailV2Catalog"
+ // "$ref": "GoogleCloudRetailV2AddCatalogAttributeRequest"
// },
// "response": {
- // "$ref": "GoogleCloudRetailV2Catalog"
+ // "$ref": "GoogleCloudRetailV2AttributesConfig"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform"
@@ -7204,52 +8533,35 @@ func (c *ProjectsLocationsCatalogsPatchCall) Do(opts ...googleapi.CallOption) (*
}
-// method id "retail.projects.locations.catalogs.setDefaultBranch":
+// method id "retail.projects.locations.catalogs.attributesConfig.removeCatalogAttribute":
-type ProjectsLocationsCatalogsSetDefaultBranchCall struct {
- s *Service
- catalog string
- googlecloudretailv2setdefaultbranchrequest *GoogleCloudRetailV2SetDefaultBranchRequest
- urlParams_ gensupport.URLParams
- ctx_ context.Context
- header_ http.Header
+type ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall struct {
+ s *Service
+ attributesConfig string
+ googlecloudretailv2removecatalogattributerequest *GoogleCloudRetailV2RemoveCatalogAttributeRequest
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
}
-// SetDefaultBranch: Set a specified branch id as default branch. API
-// methods such as SearchService.Search, ProductService.GetProduct,
-// ProductService.ListProducts will treat requests using
-// "default_branch" to the actual branch id set as default. For example,
-// if `projects/*/locations/*/catalogs/*/branches/1` is set as default,
-// setting SearchRequest.branch to
-// `projects/*/locations/*/catalogs/*/branches/default_branch` is
-// equivalent to setting SearchRequest.branch to
-// `projects/*/locations/*/catalogs/*/branches/1`. Using multiple
-// branches can be useful when developers would like to have a staging
-// branch to test and verify for future usage. When it becomes ready,
-// developers switch on the staging branch using this API while keeping
-// using `projects/*/locations/*/catalogs/*/branches/default_branch` as
-// SearchRequest.branch to route the traffic to this staging branch.
-// CAUTION: If you have live predict/search traffic, switching the
-// default branch could potentially cause outages if the ID space of the
-// new branch is very different from the old one. More specifically: *
-// PredictionService will only return product IDs from branch
-// {newBranch}. * SearchService will only return product IDs from branch
-// {newBranch} (if branch is not explicitly set). * UserEventService
-// will only join events with products from branch {newBranch}.
+// RemoveCatalogAttribute: Removes the specified CatalogAttribute from
+// the AttributesConfig. If the CatalogAttribute to remove does not
+// exist, a NOT_FOUND error is returned.
//
-// - catalog: Full resource name of the catalog, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
-func (r *ProjectsLocationsCatalogsService) SetDefaultBranch(catalog string, googlecloudretailv2setdefaultbranchrequest *GoogleCloudRetailV2SetDefaultBranchRequest) *ProjectsLocationsCatalogsSetDefaultBranchCall {
- c := &ProjectsLocationsCatalogsSetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
- c.catalog = catalog
- c.googlecloudretailv2setdefaultbranchrequest = googlecloudretailv2setdefaultbranchrequest
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
+func (r *ProjectsLocationsCatalogsAttributesConfigService) RemoveCatalogAttribute(attributesConfig string, googlecloudretailv2removecatalogattributerequest *GoogleCloudRetailV2RemoveCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall {
+ c := &ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.attributesConfig = attributesConfig
+ c.googlecloudretailv2removecatalogattributerequest = googlecloudretailv2removecatalogattributerequest
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
-func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsSetDefaultBranchCall {
+func (c *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall {
c.urlParams_.Set("fields", googleapi.CombineFields(s))
return c
}
@@ -7257,21 +8569,21 @@ func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Fields(s ...googleapi.Fi
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
-func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Context(ctx context.Context) *ProjectsLocationsCatalogsSetDefaultBranchCall {
+func (c *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall) Context(ctx context.Context) *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall {
c.ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
-func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Header() http.Header {
+func (c *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall) Header() http.Header {
if c.header_ == nil {
c.header_ = make(http.Header)
}
return c.header_
}
-func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) doRequest(alt string) (*http.Response, error) {
+func (c *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall) doRequest(alt string) (*http.Response, error) {
reqHeaders := make(http.Header)
reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
for k, v := range c.header_ {
@@ -7279,14 +8591,14 @@ func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) doRequest(alt string) (*
}
reqHeaders.Set("User-Agent", c.s.userAgent())
var body io.Reader = nil
- body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2setdefaultbranchrequest)
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2removecatalogattributerequest)
if err != nil {
return nil, err
}
reqHeaders.Set("Content-Type", "application/json")
c.urlParams_.Set("alt", alt)
c.urlParams_.Set("prettyPrint", "false")
- urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+catalog}:setDefaultBranch")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2/{+attributesConfig}:removeCatalogAttribute")
urls += "?" + c.urlParams_.Encode()
req, err := http.NewRequest("POST", urls, body)
if err != nil {
@@ -7294,19 +8606,20 @@ func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) doRequest(alt string) (*
}
req.Header = reqHeaders
googleapi.Expand(req.URL, map[string]string{
- "catalog": c.catalog,
+ "attributesConfig": c.attributesConfig,
})
return gensupport.SendRequest(c.ctx_, c.s.client, req)
}
-// Do executes the "retail.projects.locations.catalogs.setDefaultBranch" call.
-// Exactly one of *GoogleProtobufEmpty or error will be non-nil. Any
-// non-2xx status code is an error. Response headers are in either
-// *GoogleProtobufEmpty.ServerResponse.Header or (if a response was
-// returned at all) in error.(*googleapi.Error).Header. Use
-// googleapi.IsNotModified to check whether the returned error was
-// because http.StatusNotModified was returned.
-func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Do(opts ...googleapi.CallOption) (*GoogleProtobufEmpty, error) {
+// Do executes the "retail.projects.locations.catalogs.attributesConfig.removeCatalogAttribute" call.
+// Exactly one of *GoogleCloudRetailV2AttributesConfig or error will be
+// non-nil. Any non-2xx status code is an error. Response headers are in
+// either *GoogleCloudRetailV2AttributesConfig.ServerResponse.Header or
+// (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2AttributesConfig, error) {
gensupport.SetOptions(c.urlParams_, opts...)
res, err := c.doRequest("json")
if res != nil && res.StatusCode == http.StatusNotModified {
@@ -7325,7 +8638,7 @@ func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Do(opts ...googleapi.Cal
if err := googleapi.CheckResponse(res); err != nil {
return nil, err
}
- ret := &GoogleProtobufEmpty{
+ ret := &GoogleCloudRetailV2AttributesConfig{
ServerResponse: googleapi.ServerResponse{
Header: res.Header,
HTTPStatusCode: res.StatusCode,
@@ -7337,28 +8650,28 @@ func (c *ProjectsLocationsCatalogsSetDefaultBranchCall) Do(opts ...googleapi.Cal
}
return ret, nil
// {
- // "description": "Set a specified branch id as default branch. API methods such as SearchService.Search, ProductService.GetProduct, ProductService.ListProducts will treat requests using \"default_branch\" to the actual branch id set as default. For example, if `projects/*/locations/*/catalogs/*/branches/1` is set as default, setting SearchRequest.branch to `projects/*/locations/*/catalogs/*/branches/default_branch` is equivalent to setting SearchRequest.branch to `projects/*/locations/*/catalogs/*/branches/1`. Using multiple branches can be useful when developers would like to have a staging branch to test and verify for future usage. When it becomes ready, developers switch on the staging branch using this API while keeping using `projects/*/locations/*/catalogs/*/branches/default_branch` as SearchRequest.branch to route the traffic to this staging branch. CAUTION: If you have live predict/search traffic, switching the default branch could potentially cause outages if the ID space of the new branch is very different from the old one. More specifically: * PredictionService will only return product IDs from branch {newBranch}. * SearchService will only return product IDs from branch {newBranch} (if branch is not explicitly set). * UserEventService will only join events with products from branch {newBranch}.",
- // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}:setDefaultBranch",
+ // "description": "Removes the specified CatalogAttribute from the AttributesConfig. If the CatalogAttribute to remove does not exist, a NOT_FOUND error is returned.",
+ // "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:removeCatalogAttribute",
// "httpMethod": "POST",
- // "id": "retail.projects.locations.catalogs.setDefaultBranch",
+ // "id": "retail.projects.locations.catalogs.attributesConfig.removeCatalogAttribute",
// "parameterOrder": [
- // "catalog"
+ // "attributesConfig"
// ],
// "parameters": {
- // "catalog": {
- // "description": "Full resource name of the catalog, such as `projects/*/locations/global/catalogs/default_catalog`.",
+ // "attributesConfig": {
+ // "description": "Required. Full AttributesConfig resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
// "location": "path",
- // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+$",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
// "required": true,
// "type": "string"
// }
// },
- // "path": "v2/{+catalog}:setDefaultBranch",
+ // "path": "v2/{+attributesConfig}:removeCatalogAttribute",
// "request": {
- // "$ref": "GoogleCloudRetailV2SetDefaultBranchRequest"
+ // "$ref": "GoogleCloudRetailV2RemoveCatalogAttributeRequest"
// },
// "response": {
- // "$ref": "GoogleProtobufEmpty"
+ // "$ref": "GoogleCloudRetailV2AttributesConfig"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform"
@@ -7533,15 +8846,18 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct {
// processed downstream. As a consequence, when a response is returned,
// the added place IDs are not immediately manifested in the Product
// queried by ProductService.GetProduct or ProductService.ListProducts.
-// This feature is only available for users who have Retail Search
-// enabled. Please enable Retail Search on Cloud Console before using
-// this feature.
+// The returned Operations will be obsolete after 1 day, and
+// GetOperation API will return NOT_FOUND afterwards. If conflicting
+// updates are issued, the Operations associated with the stale updates
+// will not be marked as done until being obsolete. This feature is only
+// available for users who have Retail Search enabled. Please enable
+// Retail Search on Cloud Console before using this feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) AddFulfillmentPlaces(product string, googlecloudretailv2addfulfillmentplacesrequest *GoogleCloudRetailV2AddFulfillmentPlacesRequest) *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall {
c := &ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -7640,7 +8956,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o
}
return ret, nil
// {
- // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces",
@@ -7691,15 +9007,19 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct {
// ProductService.GetProduct or ProductService.ListProducts. Local
// inventory information can only be modified using this method.
// ProductService.CreateProduct and ProductService.UpdateProduct has no
-// effect on local inventories. This feature is only available for users
-// who have Retail Search enabled. Please enable Retail Search on Cloud
-// Console before using this feature.
+// effect on local inventories. The returned Operations will be obsolete
+// after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+// If conflicting updates are issued, the Operations associated with the
+// stale updates will not be marked as done until being obsolete. This
+// feature is only available for users who have Retail Search enabled.
+// Please enable Retail Search on Cloud Console before using this
+// feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) AddLocalInventories(product string, googlecloudretailv2addlocalinventoriesrequest *GoogleCloudRetailV2AddLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall {
c := &ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -7798,7 +9118,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op
}
return ret, nil
// {
- // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories",
@@ -7841,9 +9161,9 @@ type ProjectsLocationsCatalogsBranchesProductsCreateCall struct {
// Create: Creates a Product.
//
-// - parent: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch`.
+// - parent: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Create(parent string, googlecloudretailv2product *GoogleCloudRetailV2Product) *ProjectsLocationsCatalogsBranchesProductsCreateCall {
c := &ProjectsLocationsCatalogsBranchesProductsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8002,16 +9322,16 @@ type ProjectsLocationsCatalogsBranchesProductsDeleteCall struct {
// Delete: Deletes a Product.
//
-// - name: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to delete the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned. If the Product to
-// delete does not exist, a NOT_FOUND error is returned. The Product
-// to delete can neither be a Product.Type.COLLECTION Product member
-// nor a Product.Type.PRIMARY Product with more than one variants.
-// Otherwise, an INVALID_ARGUMENT error is returned. All inventory
-// information for the named Product will be deleted.
+// - name: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to delete the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned. If the Product to
+// delete does not exist, a NOT_FOUND error is returned. The Product
+// to delete can neither be a Product.Type.COLLECTION Product member
+// nor a Product.Type.PRIMARY Product with more than one variants.
+// Otherwise, an INVALID_ARGUMENT error is returned. All inventory
+// information for the named Product will be deleted.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Delete(name string) *ProjectsLocationsCatalogsBranchesProductsDeleteCall {
c := &ProjectsLocationsCatalogsBranchesProductsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8144,12 +9464,12 @@ type ProjectsLocationsCatalogsBranchesProductsGetCall struct {
// Get: Gets a Product.
//
-// - name: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned. If the requested
-// Product does not exist, a NOT_FOUND error is returned.
+// - name: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned. If the requested
+// Product does not exist, a NOT_FOUND error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Get(name string) *ProjectsLocationsCatalogsBranchesProductsGetCall {
c := &ProjectsLocationsCatalogsBranchesProductsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8297,11 +9617,11 @@ type ProjectsLocationsCatalogsBranchesProductsImportCall struct {
// synchronous. Non-existing items are created. Note that it is possible
// for a subset of the Products to be successfully updated.
//
-// - parent:
-// `projects/1234/locations/global/catalogs/default_catalog/branches/de
-// fault_branch` If no updateMask is specified, requires
-// products.create permission. If updateMask is specified, requires
-// products.update permission.
+// - parent:
+// `projects/1234/locations/global/catalogs/default_catalog/branches/de
+// fault_branch` If no updateMask is specified, requires
+// products.create permission. If updateMask is specified, requires
+// products.update permission.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Import(parent string, googlecloudretailv2importproductsrequest *GoogleCloudRetailV2ImportProductsRequest) *ProjectsLocationsCatalogsBranchesProductsImportCall {
c := &ProjectsLocationsCatalogsBranchesProductsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8443,12 +9763,12 @@ type ProjectsLocationsCatalogsBranchesProductsListCall struct {
// List: Gets a list of Products.
//
-// - parent: The parent branch resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/0`.
-// Use `default_branch` as the branch ID, to list products under the
-// default branch. If the caller does not have permission to list
-// Products under this branch, regardless of whether or not this
-// branch exists, a PERMISSION_DENIED error is returned.
+// - parent: The parent branch resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/0`.
+// Use `default_branch` as the branch ID, to list products under the
+// default branch. If the caller does not have permission to list
+// Products under this branch, regardless of whether or not this
+// branch exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) List(parent string) *ProjectsLocationsCatalogsBranchesProductsListCall {
c := &ProjectsLocationsCatalogsBranchesProductsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8688,9 +10008,9 @@ type ProjectsLocationsCatalogsBranchesProductsPatchCall struct {
// Patch: Updates a Product.
//
-// - name: Immutable. Full resource name of the product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/product_id`.
+// - name: Immutable. Full resource name of the product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/product_id`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Patch(name string, googlecloudretailv2product *GoogleCloudRetailV2Product) *ProjectsLocationsCatalogsBranchesProductsPatchCall {
c := &ProjectsLocationsCatalogsBranchesProductsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8870,15 +10190,18 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct
// processed downstream. As a consequence, when a response is returned,
// the removed place IDs are not immediately manifested in the Product
// queried by ProductService.GetProduct or ProductService.ListProducts.
-// This feature is only available for users who have Retail Search
-// enabled. Please enable Retail Search on Cloud Console before using
-// this feature.
+// The returned Operations will be obsolete after 1 day, and
+// GetOperation API will return NOT_FOUND afterwards. If conflicting
+// updates are issued, the Operations associated with the stale updates
+// will not be marked as done until being obsolete. This feature is only
+// available for users who have Retail Search enabled. Please enable
+// Retail Search on Cloud Console before using this feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveFulfillmentPlaces(product string, googlecloudretailv2removefulfillmentplacesrequest *GoogleCloudRetailV2RemoveFulfillmentPlacesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall {
c := &ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -8977,7 +10300,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D
}
return ret, nil
// {
- // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces",
@@ -9026,15 +10349,19 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct
// queried by ProductService.GetProduct or ProductService.ListProducts.
// Local inventory information can only be removed using this method.
// ProductService.CreateProduct and ProductService.UpdateProduct has no
-// effect on local inventories. This feature is only available for users
-// who have Retail Search enabled. Please enable Retail Search on Cloud
-// Console before using this feature.
+// effect on local inventories. The returned Operations will be obsolete
+// after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+// If conflicting updates are issued, the Operations associated with the
+// stale updates will not be marked as done until being obsolete. This
+// feature is only available for users who have Retail Search enabled.
+// Please enable Retail Search on Cloud Console before using this
+// feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveLocalInventories(product string, googlecloudretailv2removelocalinventoriesrequest *GoogleCloudRetailV2RemoveLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall {
c := &ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -9133,7 +10460,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do
}
return ret, nil
// {
- // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories",
@@ -9194,13 +10521,17 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct {
// information will be preserved. Pre-existing inventory information can
// only be updated with ProductService.SetInventory,
// ProductService.AddFulfillmentPlaces, and
-// ProductService.RemoveFulfillmentPlaces. This feature is only
-// available for users who have Retail Search enabled. Please enable
-// Retail Search on Cloud Console before using this feature.
+// ProductService.RemoveFulfillmentPlaces. The returned Operations will
+// be obsolete after 1 day, and GetOperation API will return NOT_FOUND
+// afterwards. If conflicting updates are issued, the Operations
+// associated with the stale updates will not be marked as done until
+// being obsolete. This feature is only available for users who have
+// Retail Search enabled. Please enable Retail Search on Cloud Console
+// before using this feature.
//
-// - name: Immutable. Full resource name of the product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/product_id`.
+// - name: Immutable. Full resource name of the product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/product_id`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) SetInventory(name string, googlecloudretailv2setinventoryrequest *GoogleCloudRetailV2SetInventoryRequest) *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall {
c := &ProjectsLocationsCatalogsBranchesProductsSetInventoryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9299,7 +10630,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g
}
return ret, nil
// {
- // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.setInventory",
@@ -9348,8 +10679,8 @@ type ProjectsLocationsCatalogsCompletionDataImportCall struct {
// have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - parent: The catalog which the suggestions dataset belongs to.
-// Format: `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The catalog which the suggestions dataset belongs to.
+// Format: `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsCompletionDataService) Import(parent string, googlecloudretailv2importcompletiondatarequest *GoogleCloudRetailV2ImportCompletionDataRequest) *ProjectsLocationsCatalogsCompletionDataImportCall {
c := &ProjectsLocationsCatalogsCompletionDataImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9853,19 +11184,19 @@ type ProjectsLocationsCatalogsPlacementsPredictCall struct {
// Predict: Makes a recommendation prediction.
//
-// - placement: Full resource name of the format:
-// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
-// vingConfigs/*}` or
-// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
-// cements/*}`. We recommend using the `servingConfigs` resource.
-// `placements` is a legacy resource. The ID of the Recommendations AI
-// serving config or placement. Before you can request predictions
-// from your model, you must create at least one serving config or
-// placement for it. For more information, see [Managing serving
-// configurations]
-// (https://cloud.google.com/retail/docs/manage-configs). The full
-// list of available serving configs can be seen at
-// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
+// - placement: Full resource name of the format:
+// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
+// vingConfigs/*}` or
+// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
+// cements/*}`. We recommend using the `servingConfigs` resource.
+// `placements` is a legacy resource. The ID of the Recommendations AI
+// serving config or placement. Before you can request predictions
+// from your model, you must create at least one serving config or
+// placement for it. For more information, see [Managing serving
+// configurations]
+// (https://cloud.google.com/retail/docs/manage-configs). The full
+// list of available serving configs can be seen at
+// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
func (r *ProjectsLocationsCatalogsPlacementsService) Predict(placement string, googlecloudretailv2predictrequest *GoogleCloudRetailV2PredictRequest) *ProjectsLocationsCatalogsPlacementsPredictCall {
c := &ProjectsLocationsCatalogsPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -10010,15 +11341,15 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct {
// who have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - placement: The resource name of the Retail Search serving config,
-// such as
-// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
-// /default_serving_config` or the name of the legacy placement
-// resource, such as
-// `projects/*/locations/global/catalogs/default_catalog/placements/def
-// ault_search`. This field is used to identify the serving
-// configuration name and the set of models that will be used to make
-// the search.
+// - placement: The resource name of the Retail Search serving config,
+// such as
+// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
+// /default_serving_config` or the name of the legacy placement
+// resource, such as
+// `projects/*/locations/global/catalogs/default_catalog/placements/def
+// ault_search`. This field is used to identify the serving
+// configuration name and the set of models that will be used to make
+// the search.
func (r *ProjectsLocationsCatalogsPlacementsService) Search(placement string, googlecloudretailv2searchrequest *GoogleCloudRetailV2SearchRequest) *ProjectsLocationsCatalogsPlacementsSearchCall {
c := &ProjectsLocationsCatalogsPlacementsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -10182,19 +11513,19 @@ type ProjectsLocationsCatalogsServingConfigsPredictCall struct {
// Predict: Makes a recommendation prediction.
//
-// - placement: Full resource name of the format:
-// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
-// vingConfigs/*}` or
-// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
-// cements/*}`. We recommend using the `servingConfigs` resource.
-// `placements` is a legacy resource. The ID of the Recommendations AI
-// serving config or placement. Before you can request predictions
-// from your model, you must create at least one serving config or
-// placement for it. For more information, see [Managing serving
-// configurations]
-// (https://cloud.google.com/retail/docs/manage-configs). The full
-// list of available serving configs can be seen at
-// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
+// - placement: Full resource name of the format:
+// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
+// vingConfigs/*}` or
+// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
+// cements/*}`. We recommend using the `servingConfigs` resource.
+// `placements` is a legacy resource. The ID of the Recommendations AI
+// serving config or placement. Before you can request predictions
+// from your model, you must create at least one serving config or
+// placement for it. For more information, see [Managing serving
+// configurations]
+// (https://cloud.google.com/retail/docs/manage-configs). The full
+// list of available serving configs can be seen at
+// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
func (r *ProjectsLocationsCatalogsServingConfigsService) Predict(placement string, googlecloudretailv2predictrequest *GoogleCloudRetailV2PredictRequest) *ProjectsLocationsCatalogsServingConfigsPredictCall {
c := &ProjectsLocationsCatalogsServingConfigsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -10339,15 +11670,15 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct {
// who have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - placement: The resource name of the Retail Search serving config,
-// such as
-// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
-// /default_serving_config` or the name of the legacy placement
-// resource, such as
-// `projects/*/locations/global/catalogs/default_catalog/placements/def
-// ault_search`. This field is used to identify the serving
-// configuration name and the set of models that will be used to make
-// the search.
+// - placement: The resource name of the Retail Search serving config,
+// such as
+// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
+// /default_serving_config` or the name of the legacy placement
+// resource, such as
+// `projects/*/locations/global/catalogs/default_catalog/placements/def
+// ault_search`. This field is used to identify the serving
+// configuration name and the set of models that will be used to make
+// the search.
func (r *ProjectsLocationsCatalogsServingConfigsService) Search(placement string, googlecloudretailv2searchrequest *GoogleCloudRetailV2SearchRequest) *ProjectsLocationsCatalogsServingConfigsSearchCall {
c := &ProjectsLocationsCatalogsServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -10514,8 +11845,8 @@ type ProjectsLocationsCatalogsUserEventsCollectCall struct {
// domain. This method is used only by the Retail API JavaScript pixel
// and Google Tag Manager. Users should not call this method directly.
//
-// - parent: The parent catalog name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Collect(parent string) *ProjectsLocationsCatalogsUserEventsCollectCall {
c := &ProjectsLocationsCatalogsUserEventsCollectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10701,10 +12032,10 @@ type ProjectsLocationsCatalogsUserEventsImportCall struct {
// Import: Bulk import of User events. Request processing might be
// synchronous. Events that already exist are skipped. Use this method
-// for backfilling historical user events. Operation.response is of type
-// ImportResponse. Note that it is possible for a subset of the items to
-// be successfully inserted. Operation.metadata is of type
-// ImportMetadata.
+// for backfilling historical user events. `Operation.response` is of
+// type `ImportResponse`. Note that it is possible for a subset of the
+// items to be successfully inserted. `Operation.metadata` is of type
+// `ImportMetadata`.
//
// - parent: `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Import(parent string, googlecloudretailv2importusereventsrequest *GoogleCloudRetailV2ImportUserEventsRequest) *ProjectsLocationsCatalogsUserEventsImportCall {
@@ -10805,7 +12136,7 @@ func (c *ProjectsLocationsCatalogsUserEventsImportCall) Do(opts ...googleapi.Cal
}
return ret, nil
// {
- // "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+ // "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.",
// "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:import",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.userEvents.import",
@@ -10851,9 +12182,9 @@ type ProjectsLocationsCatalogsUserEventsPurgeCall struct {
// this operation could take hours or days to complete. To test a
// filter, use the list command first.
//
-// - parent: The resource name of the catalog under which the events are
-// created. The format is
-// `projects/${projectId}/locations/global/catalogs/${catalogId}`.
+// - parent: The resource name of the catalog under which the events are
+// created. The format is
+// `projects/${projectId}/locations/global/catalogs/${catalogId}`.
func (r *ProjectsLocationsCatalogsUserEventsService) Purge(parent string, googlecloudretailv2purgeusereventsrequest *GoogleCloudRetailV2PurgeUserEventsRequest) *ProjectsLocationsCatalogsUserEventsPurgeCall {
c := &ProjectsLocationsCatalogsUserEventsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11003,8 +12334,8 @@ type ProjectsLocationsCatalogsUserEventsRejoinCall struct {
// joined with the wrong product catalog. A rejoin operation can take
// hours or days to complete.
//
-// - parent: The parent catalog resource name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Rejoin(parent string, googlecloudretailv2rejoinusereventsrequest *GoogleCloudRetailV2RejoinUserEventsRequest) *ProjectsLocationsCatalogsUserEventsRejoinCall {
c := &ProjectsLocationsCatalogsUserEventsRejoinCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11146,8 +12477,8 @@ type ProjectsLocationsCatalogsUserEventsWriteCall struct {
// Write: Writes a single user event.
//
-// - parent: The parent catalog resource name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Write(parent string, googlecloudretailv2userevent *GoogleCloudRetailV2UserEvent) *ProjectsLocationsCatalogsUserEventsWriteCall {
c := &ProjectsLocationsCatalogsUserEventsWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/retail/v2alpha/retail-api.json b/retail/v2alpha/retail-api.json
index 122610e1d39..9c90b683b2c 100644
--- a/retail/v2alpha/retail-api.json
+++ b/retail/v2alpha/retail-api.json
@@ -441,6 +441,34 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
+ "batchRemoveCatalogAttributes": {
+ "description": "Removes all specified CatalogAttributes from the AttributesConfig.",
+ "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:batchRemoveCatalogAttributes",
+ "httpMethod": "POST",
+ "id": "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes",
+ "parameterOrder": [
+ "attributesConfig"
+ ],
+ "parameters": {
+ "attributesConfig": {
+ "description": "Required. The attributes config resource shared by all catalog attributes being deleted. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2alpha/{+attributesConfig}:batchRemoveCatalogAttributes",
+ "request": {
+ "$ref": "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest"
+ },
+ "response": {
+ "$ref": "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
"removeCatalogAttribute": {
"description": "Removes the specified CatalogAttribute from the AttributesConfig. If the CatalogAttribute to remove does not exist, a NOT_FOUND error is returned.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:removeCatalogAttribute",
@@ -533,7 +561,7 @@
"products": {
"methods": {
"addFulfillmentPlaces": {
- "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces",
@@ -561,7 +589,7 @@
]
},
"addLocalInventories": {
- "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.addLocalInventories",
@@ -819,7 +847,7 @@
]
},
"removeFulfillmentPlaces": {
- "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces",
@@ -847,7 +875,7 @@
]
},
"removeLocalInventories": {
- "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories",
@@ -875,7 +903,7 @@
]
},
"setInventory": {
- "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.setInventory",
@@ -1112,7 +1140,7 @@
],
"parameters": {
"dryRun": {
- "description": "Optional. Whether to run a dry_run to validate the request (without actually creating the model).",
+ "description": "Optional. Whether to run a dry run to validate the request (without actually creating the model).",
"location": "query",
"type": "boolean"
},
@@ -1145,7 +1173,7 @@
],
"parameters": {
"name": {
- "description": "Required. The resource name of the [Model] to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}",
+ "description": "Required. The resource name of the Model to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/models/[^/]+$",
"required": true,
@@ -1197,7 +1225,7 @@
]
},
"patch": {
- "description": "Update of model metadata. Only fields that currently can be updated are: filtering_option, periodic_tuning_state. If other values are provided, this API method will ignore them.",
+ "description": "Update of model metadata. Only fields that currently can be updated are: `filtering_option` and `periodic_tuning_state`. If other values are provided, this API method ignores them.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}",
"httpMethod": "PATCH",
"id": "retail.projects.locations.catalogs.models.patch",
@@ -1206,14 +1234,14 @@
],
"parameters": {
"name": {
- "description": "Required. The fully qualified resource name of the model. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
+ "description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/models/[^/]+$",
"required": true,
"type": "string"
},
"updateMask": {
- "description": "Optional. Indicates which fields in the provided 'model' to update. If not set, will by default update all fields.",
+ "description": "Optional. Indicates which fields in the provided 'model' to update. If not set, by default updates all fields.",
"format": "google-fieldmask",
"location": "query",
"type": "string"
@@ -1759,7 +1787,7 @@
]
},
"import": {
- "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+ "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.",
"flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:import",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.userEvents.import",
@@ -2019,7 +2047,7 @@
}
}
},
- "revision": "20220722",
+ "revision": "20220811",
"rootUrl": "https://retail.googleapis.com/",
"schemas": {
"GoogleApiHttpBody": {
@@ -2215,14 +2243,14 @@
"id": "GoogleCloudRetailV2ImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2ImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2ImportMetadata",
"properties": {
"createTime": {
@@ -2236,7 +2264,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -2498,7 +2526,7 @@
"CATALOG_LEVEL_ATTRIBUTE_CONFIG"
],
"enumDescriptions": [
- "Value used when unset. Defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.",
+ "Value used when unset. In this case, server behavior defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.",
"At this level, we honor the attribute configurations set in Product.attributes.",
"At this level, we honor the attribute configurations set in CatalogConfig.attribute_configs."
],
@@ -2540,6 +2568,41 @@
},
"type": "object"
},
+ "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest": {
+ "description": "Request for CatalogService.BatchRemoveCatalogAttributes method.",
+ "id": "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest",
+ "properties": {
+ "attributeKeys": {
+ "description": "Required. The attribute name keys of the CatalogAttributes to delete. A maximum of 1000 catalog attributes can be deleted in a batch.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse": {
+ "description": "Response of the CatalogService.BatchRemoveCatalogAttributes.",
+ "id": "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse",
+ "properties": {
+ "deletedCatalogAttributes": {
+ "description": "Catalog attributes that were deleted. Only attributes that are not in use by products can be deleted.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "resetCatalogAttributes": {
+ "description": "Catalog attributes that were reset. Attributes that are in use by products cannot be deleted, however their configuration properties will reset to default values upon removal request.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2alphaBigQueryOutputResult": {
"description": "A BigQuery output result.",
"id": "GoogleCloudRetailV2alphaBigQueryOutputResult",
@@ -2560,7 +2623,7 @@
"id": "GoogleCloudRetailV2alphaBigQuerySource",
"properties": {
"dataSchema": {
- "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: The schema is available here: https://support.google.com/analytics/answer/3437719. * `user_event_ga4`: This feature is in private preview. Please contact the support team for importing Google Analytics 4 events. The schema is available here: https://support.google.com/analytics/answer/7029846. Supported values for auto-completion imports: * `suggestions` (default): One JSON completion suggestion per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One JSON allow suggestion per line.",
+ "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: The schema is available here: https://support.google.com/analytics/answer/3437719. * `user_event_ga4`: The schema is available here: https://support.google.com/analytics/answer/7029846. Supported values for auto-completion imports: * `suggestions` (default): One JSON completion suggestion per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One JSON allow suggestion per line.",
"type": "string"
},
"datasetId": {
@@ -2573,7 +2636,7 @@
},
"partitionDate": {
"$ref": "GoogleTypeDate",
- "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`."
+ "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format. Only supported in ImportProductsRequest."
},
"projectId": {
"description": "The project ID (can be project # or ID) that the BigQuery source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.",
@@ -2627,6 +2690,20 @@
],
"type": "string"
},
+ "exactSearchableOption": {
+ "description": "If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable.",
+ "enum": [
+ "EXACT_SEARCHABLE_OPTION_UNSPECIFIED",
+ "EXACT_SEARCHABLE_ENABLED",
+ "EXACT_SEARCHABLE_DISABLED"
+ ],
+ "enumDescriptions": [
+ "Value used when unset. Defaults to EXACT_SEARCHABLE_DISABLED.",
+ "Exact searchable option enabled for an attribute.",
+ "Exact searchable option disabled for an attribute."
+ ],
+ "type": "string"
+ },
"inUse": {
"description": "Output only. Indicates whether this attribute has been used by any products. `True` if at least one Product is using this attribute in Product.attributes. Otherwise, this field is `False`. CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, CatalogService.ImportCatalogAttributes, or CatalogService.UpdateAttributesConfig APIs. This field is `False` for pre-loaded CatalogAttributes. Only pre-loaded CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined cannot be deleted; however, their configuration properties will reset to default values upon removal request. After catalog changes, it takes about 10 minutes for this field to update.",
"readOnly": true,
@@ -2658,7 +2735,7 @@
"RECOMMENDATIONS_FILTERING_ENABLED"
],
"enumDescriptions": [
- "Value used when unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
+ "Value used when unset. In this case, server behavior defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
"Recommendation filtering is disabled.",
"Recommendation filtering is enabled."
],
@@ -2733,7 +2810,7 @@
"type": "array"
},
"recentSearchResults": {
- "description": "Matched recent searches of this user. The maximum number of recent searches is 10. This field is a restricted feature. Contact Retail Search support team if you are interested in enabling it. This feature is only available when CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The recent searches satisfy the follow rules: * They are ordered from latest to oldest. * They are matched with CompleteQueryRequest.query case insensitively. * They are transformed to lower cases. * They are UTF-8 safe. Recent searches are deduplicated. More recent searches will be reserved when duplication happens.",
+ "description": "Matched recent searches of this user. The maximum number of recent searches is 10. This field is a restricted feature. Contact Retail Search support team if you are interested in enabling it. This feature is only available when CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The recent searches satisfy the follow rules: * They are ordered from latest to oldest. * They are matched with CompleteQueryRequest.query case insensitively. * They are transformed to lower case. * They are UTF-8 safe. Recent searches are deduplicated. More recent searches will be reserved when duplication happens.",
"items": {
"$ref": "GoogleCloudRetailV2alphaCompleteQueryResponseRecentSearchResult"
},
@@ -2809,12 +2886,12 @@
"type": "string"
},
"maxSuggestions": {
- "description": "The maximum number of autocomplete suggestions returned per term. The maximum allowed max suggestions is 20. Default value is 20. If left unset or set to 0, then will fallback to default value.",
+ "description": "The maximum number of autocomplete suggestions returned per term. Default value is 20. If left unset or set to 0, then will fallback to default value. Value range is 1 to 20.",
"format": "int32",
"type": "integer"
},
"minPrefixLength": {
- "description": "The minimum number of characters needed to be typed in order to get suggestions. Default value is 2. If left unset or set to 0, then will fallback to default value.",
+ "description": "The minimum number of characters needed to be typed in order to get suggestions. Default value is 2. If left unset or set to 0, then will fallback to default value. Value range is 1 to 20.",
"format": "int32",
"type": "integer"
},
@@ -3094,11 +3171,11 @@
"type": "object"
},
"GoogleCloudRetailV2alphaGcsSource": {
- "description": "Google Cloud Storage location for input content. format.",
+ "description": "Google Cloud Storage location for input content.",
"id": "GoogleCloudRetailV2alphaGcsSource",
"properties": {
"dataSchema": {
- "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: Using https://support.google.com/analytics/answer/3437719. Supported values for control imports: * 'control' (default): One JSON Control per line. Supported values for catalog attribute imports: * 'catalog_attribute' (default): One CSV CatalogAttribute per line.",
+ "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: Using https://support.google.com/analytics/answer/3437719. Supported values for control imports: * `control` (default): One JSON Control per line. Supported values for catalog attribute imports: * `catalog_attribute` (default): One CSV CatalogAttribute per line.",
"type": "string"
},
"inputUris": {
@@ -3161,7 +3238,7 @@
"description": "Required. The desired input location of the data."
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
}
},
@@ -3186,14 +3263,14 @@
"id": "GoogleCloudRetailV2alphaImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2alphaImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2alphaImportMetadata",
"properties": {
"createTime": {
@@ -3207,7 +3284,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -3219,6 +3296,10 @@
"format": "int64",
"type": "string"
},
+ "transformedUserEventsMetadata": {
+ "$ref": "GoogleCloudRetailV2alphaTransformedUserEventsMetadata",
+ "description": "Metadata related to transform user events."
+ },
"updateTime": {
"description": "Operation last update time. If the operation is done, this is also the finish time.",
"format": "google-datetime",
@@ -3240,7 +3321,7 @@
"description": "Required. The desired input location of the data."
},
"notificationPubsubTopic": {
- "description": "Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that both `cloud-retail-customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on the topic. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`.",
+ "description": "Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that `service-@gcp-sa-retail.iam.gserviceaccount.com` has the `pubsub.topics.publish` IAM permission on the topic.",
"type": "string"
},
"reconciliationMode": {
@@ -3253,7 +3334,7 @@
"enumDescriptions": [
"Defaults to INCREMENTAL.",
"Inserts new products or updates existing products.",
- "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown."
+ "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location."
],
"type": "string"
},
@@ -3262,11 +3343,11 @@
"type": "string"
},
"skipDefaultBranchProtection": {
- "description": "If true, will perform the FULL import even if it would delete a large proportion of the products in the default branch, which could potentially cause outages if you have live predict/search traffic. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`.",
+ "description": "If true, this performs the FULL import even if it would delete a large proportion of the products in the default branch, which could potentially cause outages if you have live predict/search traffic. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`.",
"type": "boolean"
},
"updateMask": {
- "description": "Indicates which fields in the provided imported 'products' to update. If not set, will by default update all fields.",
+ "description": "Indicates which fields in the provided imported `products` to update. If not set, all fields are updated.",
"format": "google-fieldmask",
"type": "string"
}
@@ -3488,7 +3569,7 @@
"type": "string"
},
"destinations": {
- "description": "String representing the destination to import for, all if left empty. List of possible values can be found here. [https://support.google.com/merchants/answer/7501026] List of allowed string values: \"Shopping_ads\", \"Buy_on_google_listings\", \"Display_ads\", \"Local_inventory _ads\", \"Free_listings\", \"Free_local_listings\" NOTE: The string values are case sensitive.",
+ "description": "String representing the destination to import for, all if left empty. List of possible values is given in [Included destination](https://support.google.com/merchants/answer/7501026). List of allowed string values: \"Shopping_ads\", \"Buy_on_google_listings\", \"Display_ads\", \"Local_inventory _ads\", \"Free_listings\", \"Free_local_listings\" NOTE: The string values are case sensitive.",
"items": {
"type": "string"
},
@@ -3525,7 +3606,7 @@
"type": "object"
},
"GoogleCloudRetailV2alphaModel": {
- "description": "Metadata that describes the training and serving parameters of a Model. A Model can be associated with a ServingConfig and then queried through the Predict api.",
+ "description": "Metadata that describes the training and serving parameters of a Model. A Model can be associated with a ServingConfig and then queried through the Predict API.",
"id": "GoogleCloudRetailV2alphaModel",
"properties": {
"createTime": {
@@ -3535,14 +3616,14 @@
"type": "string"
},
"dataState": {
- "description": "Output only. The state of data requirements for this model: DATA_OK and DATA_ERROR. Recommendation model cannot be trained if the data is in DATA_ERROR state. Recommendation model can have DATA_ERROR state even if serving state is ACTIVE: models were trained successfully before, but cannot be refreshed because model no longer has sufficient data for training.",
+ "description": "Output only. The state of data requirements for this model: `DATA_OK` and `DATA_ERROR`. Recommendation model cannot be trained if the data is in `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even if serving state is `ACTIVE`: models were trained successfully before, but cannot be refreshed because model no longer has sufficient data for training.",
"enum": [
"DATA_STATE_UNSPECIFIED",
"DATA_OK",
"DATA_ERROR"
],
"enumDescriptions": [
- "Unspecified default value - should never be explicitly set.",
+ "Unspecified default value, should never be explicitly set.",
"The model has sufficient training data.",
"The model does not have sufficient training data. Error messages can be queried via Stackdriver."
],
@@ -3550,18 +3631,18 @@
"type": "string"
},
"displayName": {
- "description": "Required. The display name of the model. Should be human readable, used to display Recommendation Models in the Retail Pantheon Dashboard. UTF-8 encoded string with limit of 1024 characters.",
+ "description": "Required. The display name of the model. Should be human readable, used to display Recommendation Models in the Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024 characters.",
"type": "string"
},
"filteringOption": {
- "description": "Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by attributes is enabled for the model.",
+ "description": "Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering by attributes is enabled for the model.",
"enum": [
"RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED",
"RECOMMENDATIONS_FILTERING_DISABLED",
"RECOMMENDATIONS_FILTERING_ENABLED"
],
"enumDescriptions": [
- "Value used when unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
+ "Value used when unset. In this case, server behavior defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
"Recommendation filtering is disabled.",
"Recommendation filtering is enabled."
],
@@ -3574,7 +3655,7 @@
"type": "string"
},
"name": {
- "description": "Required. The fully qualified resource name of the model. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
+ "description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
"type": "string"
},
"optimizationObjective": {
@@ -3586,7 +3667,7 @@
"description": "Optional. The page optimization config."
},
"periodicTuningState": {
- "description": "Optional. The state of periodic tuning. The period we use is 3 months - to do a one-off tune earlier use the TuneModel method. Default value is PERIODIC_TUNING_ENABLED.",
+ "description": "Optional. The state of periodic tuning. The period we use is 3 months - to do a one-off tune earlier use the `TuneModel` method. Default value is `PERIODIC_TUNING_ENABLED`.",
"enum": [
"PERIODIC_TUNING_STATE_UNSPECIFIED",
"PERIODIC_TUNING_DISABLED",
@@ -3594,10 +3675,10 @@
"PERIODIC_TUNING_ENABLED"
],
"enumDescriptions": [
- "Unspecified default value - should never be explicitly set.",
- "The model has periodic tuning disabled. Tuning can be reenabled by calling the EnableModelPeriodicTuning method or by calling the TuneModel method.",
- "The model cannot be tuned with periodic tuning OR the TuneModel method. Hide the options in customer UI and reject any requests through the backend self serve API.",
- "The model has periodic tuning enabled. Tuning can be disabled by calling the DisableModelPeriodicTuning method."
+ "Unspecified default value, should never be explicitly set.",
+ "The model has periodic tuning disabled. Tuning can be reenabled by calling the `EnableModelPeriodicTuning` method or by calling the `TuneModel` method.",
+ "The model cannot be tuned with periodic tuning OR the `TuneModel` method. Hide the options in customer UI and reject any requests through the backend self serve API.",
+ "The model has periodic tuning enabled. Tuning can be disabled by calling the `DisableModelPeriodicTuning` method."
],
"type": "string"
},
@@ -3610,7 +3691,7 @@
"type": "array"
},
"servingState": {
- "description": "Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.",
+ "description": "Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.",
"enum": [
"SERVING_STATE_UNSPECIFIED",
"INACTIVE",
@@ -3621,13 +3702,13 @@
"Unspecified serving state.",
"The model is not serving.",
"The model is serving and can be queried.",
- "The model is trained on tuned hyperparameters, and can be queried."
+ "The model is trained on tuned hyperparameters and can be queried."
],
"readOnly": true,
"type": "string"
},
"trainingState": {
- "description": "Optional. The training state that the model is in (e.g. TRAINING or PAUSED). Since part of the cost of running the service is frequency of training - this can be used to determine when to train model in order to control cost. If not specified: the default value for CreateModel method is TRAINING. the default value for UpdateModel method is to keep the state the same as before.",
+ "description": "Optional. The training state that the model is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train model in order to control cost. If not specified: the default value for `CreateModel` method is `TRAINING`. The default value for `UpdateModel` method is to keep the state the same as before.",
"enum": [
"TRAINING_STATE_UNSPECIFIED",
"PAUSED",
@@ -3646,7 +3727,7 @@
"type": "string"
},
"type": {
- "description": "Required. The type of model e.g. `home-page`. Currently supported values: `recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `page-optimization`, 'similar-items', 'buy-it-again', `recently-viewed`(readonly value).",
+ "description": "Required. The type of model e.g. `home-page`. Currently supported values: `recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `page-optimization`, `similar-items`, `buy-it-again`, and `recently-viewed`(readonly value).",
"type": "string"
},
"updateTime": {
@@ -3685,9 +3766,9 @@
"enumDescriptions": [
"Unspecified value for restriction.",
"Allow any ServingConfig to be show on any number of panels. Example: `Panel1 candidates`: pdp_ctr, pdp_cvr, home_page_ctr_no_diversity `Panel2 candidates`: home_page_ctr_no_diversity, home_page_ctr_diversity, pdp_cvr_no_diversity `Restriction` = NO_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: []",
- "Do not allow the same ServingConfig.name to be shown on multiple panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_SERVING_CONFIG_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *",
- "Do not allow multiple ServingConfigs with same Model.name to be show on on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) *",
- "Do not allow multiple ServingConfigs with same Model.type to be shown on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) *"
+ "Do not allow the same ServingConfig.name to be shown on multiple panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_SERVING_CONFIG_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *",
+ "Do not allow multiple ServingConfigs with same Model.name to be show on on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) *",
+ "Do not allow multiple ServingConfigs with same Model.type to be shown on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) *"
],
"type": "string"
}
@@ -3699,7 +3780,7 @@
"id": "GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate",
"properties": {
"servingConfigId": {
- "description": "This has to be a valid ServingConfig identifier. e.g. for a ServingConfig with full name: `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config` this would be 'my_candidate_config'",
+ "description": "This has to be a valid ServingConfig identifier. For example, for a ServingConfig with full name: `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`, this would be `my_candidate_config`.",
"type": "string"
}
},
@@ -3718,7 +3799,7 @@
},
"defaultCandidate": {
"$ref": "GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate",
- "description": "Required. The default candidate (in case the model fails at serving time, we can fall back to the default)."
+ "description": "Required. The default candidate. If the model fails at serving time, we fall back to the default."
},
"displayName": {
"description": "Optional. The name to display for the panel.",
@@ -3728,11 +3809,11 @@
"type": "object"
},
"GoogleCloudRetailV2alphaModelServingConfigList": {
- "description": "Represents an ordered combination of valid serving configs, which / may be used for PAGE_OPTIMIZATION recommendations.",
+ "description": "Represents an ordered combination of valid serving configs, which can be used for `PAGE_OPTIMIZATION` recommendations.",
"id": "GoogleCloudRetailV2alphaModelServingConfigList",
"properties": {
"servingConfigIds": {
- "description": "Optional. A set of valid serving configs that may be used for PAGE_OPTIMIZATION.",
+ "description": "Optional. A set of valid serving configs that may be used for `PAGE_OPTIMIZATION`.",
"items": {
"type": "string"
},
@@ -3777,12 +3858,12 @@
"type": "object"
},
"pageSize": {
- "description": "Maximum number of results to return per page. Set this property to the number of prediction results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
+ "description": "Maximum number of results to return. Set this property to the number of prediction results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
"format": "int32",
"type": "integer"
},
"pageToken": {
- "description": "This field is not used for now, leave it unset.",
+ "description": "This field is not used; leave it unset.",
"type": "string"
},
"params": {
@@ -3964,7 +4045,7 @@
"type": "array"
},
"collectionMemberIds": {
- "description": "The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.",
+ "description": "The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.",
"items": {
"type": "string"
},
@@ -4586,7 +4667,7 @@
"type": "object"
},
"GoogleCloudRetailV2alphaRuleFilterAction": {
- "description": "* Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided is combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query's existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter.",
+ "description": "* Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query's existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter.",
"id": "GoogleCloudRetailV2alphaRuleFilterAction",
"properties": {
"filter": {
@@ -4770,7 +4851,7 @@
"LOWEST"
],
"enumDescriptions": [
- "Default value. Defaults to RelevanceThreshold.HIGH.",
+ "Default value. In this case, server behavior defaults to RelevanceThreshold.HIGH.",
"High relevance threshold.",
"Medium relevance threshold.",
"Low relevance threshold.",
@@ -4943,6 +5024,10 @@
"type": "string"
},
"type": "array"
+ },
+ "returnMinMax": {
+ "description": "Returns the min and max value for each numerical facet intervals. Ignored for textual facets.",
+ "type": "boolean"
}
},
"type": "object"
@@ -4959,8 +5044,8 @@
"DISABLED"
],
"enumDescriptions": [
- "Default value. Defaults to Mode.AUTO.",
- "Let CRS decide whether to use personalization.",
+ "Default value. In this case, server behavior defaults to Mode.AUTO.",
+ "Let CRS decide whether to use personalization based on quality of user event data.",
"Disable personalization."
],
"type": "string"
@@ -4980,7 +5065,7 @@
"AUTO"
],
"enumDescriptions": [
- "Unspecified query expansion condition. This defaults to Condition.DISABLED.",
+ "Unspecified query expansion condition. In this case, server behavior defaults to Condition.DISABLED.",
"Disabled query expansion. Only the exact search query is used, even if SearchResponse.total_size is zero.",
"Automatic query expansion built by Google Retail Search."
],
@@ -5005,7 +5090,7 @@
"AUTO"
],
"enumDescriptions": [
- "Unspecified spell correction mode. This defaults to Mode.AUTO.",
+ "Unspecified spell correction mode. In this case, server behavior defaults to Mode.AUTO.",
"Google Retail Search will try to find a spell suggestion if there is any and put in the SearchResponse.corrected_query. The spell suggestion will not be used as the search query.",
"Automatic spell correction built by Google Retail Search. Search will be based on the corrected query if found."
],
@@ -5109,6 +5194,16 @@
"$ref": "GoogleCloudRetailV2alphaInterval",
"description": "Interval value for a facet, such as [10, 20) for facet \"price\"."
},
+ "maxValue": {
+ "description": "The maximum value in the FacetValue.interval. Only supported on numerical facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.",
+ "format": "double",
+ "type": "number"
+ },
+ "minValue": {
+ "description": "The minimum value in the FacetValue.interval. Only supported on numerical facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.",
+ "format": "double",
+ "type": "number"
+ },
"value": {
"description": "Text value of a facet, such as \"Black\" for facet \"colorFamilies\".",
"type": "string"
@@ -5153,6 +5248,13 @@
"description": "If a variant Product matches the search query, this map indicates which Product fields are matched. The key is the Product.name, the value is a field mask of the matched Product fields. If matched attributes cannot be determined, this map will be empty. For example, a key \"sku1\" with field mask \"products.color_info\" indicates there is a match between \"sku1\" ColorInfo and the query.",
"type": "object"
},
+ "personalLabels": {
+ "description": "Specifies previous events related to this product for this user based on UserEvent with same SearchRequest.visitor_id or UserInfo.user_id. This is set only when SearchRequest.PersonalizationSpec.mode is SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: * `purchased`: Indicates that this product has been purchased before.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
"product": {
"$ref": "GoogleCloudRetailV2alphaProduct",
"description": "The product data snippet in the search response. Only Product.name is guaranteed to be populated. Product.variants contains the product variants that match the search query. If there are multiple product variants matching the query, top 5 most relevant product variants are returned and ordered by relevancy. If relevancy can be deternmined, use matching_variant_fields to look up matched product variants fields. If relevancy cannot be determined, e.g. when searching \"shoe\" all products in a shoe product can be a match, 5 product variants are returned but order is meaningless."
@@ -5338,6 +5440,23 @@
"properties": {},
"type": "object"
},
+ "GoogleCloudRetailV2alphaTransformedUserEventsMetadata": {
+ "description": "Metadata related to transform user events operation.",
+ "id": "GoogleCloudRetailV2alphaTransformedUserEventsMetadata",
+ "properties": {
+ "sourceEventsCount": {
+ "description": "Count of entries in the source user events BigQuery table.",
+ "format": "int64",
+ "type": "string"
+ },
+ "transformedEventsCount": {
+ "description": "Count of entries in the transformed user events BigQuery table, which could be different from the actually imported number of user events.",
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2alphaTuneModelMetadata": {
"description": "Metadata associated with a tune operation.",
"id": "GoogleCloudRetailV2alphaTuneModelMetadata",
@@ -5665,14 +5784,14 @@
"id": "GoogleCloudRetailV2betaImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2betaImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2betaImportMetadata",
"properties": {
"createTime": {
@@ -5686,7 +5805,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
diff --git a/retail/v2alpha/retail-gen.go b/retail/v2alpha/retail-gen.go
index 7453c74a2c4..7bf91d811a9 100644
--- a/retail/v2alpha/retail-gen.go
+++ b/retail/v2alpha/retail-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recommendations
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/retail/v2alpha"
-// ...
-// ctx := context.Background()
-// retailService, err := retail.NewService(ctx)
+// import "google.golang.org/api/retail/v2alpha"
+// ...
+// ctx := context.Background()
+// retailService, err := retail.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// retailService, err := retail.NewService(ctx, option.WithAPIKey("AIza..."))
+// retailService, err := retail.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// retailService, err := retail.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// retailService, err := retail.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package retail // import "google.golang.org/api/retail/v2alpha"
@@ -683,7 +683,7 @@ func (s *GoogleCloudRetailV2ImportCompletionDataResponse) MarshalJSON() ([]byte,
// for Import related errors.
type GoogleCloudRetailV2ImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -712,7 +712,7 @@ func (s *GoogleCloudRetailV2ImportErrorsConfig) MarshalJSON() ([]byte, error) {
}
// GoogleCloudRetailV2ImportMetadata: Metadata related to the progress
-// of the Import operation. This will be returned by the
+// of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2ImportMetadata struct {
// CreateTime: Operation create time.
@@ -723,9 +723,9 @@ type GoogleCloudRetailV2ImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -1199,8 +1199,9 @@ type GoogleCloudRetailV2alphaAttributesConfig struct {
// this catalog.
//
// Possible values:
- // "ATTRIBUTE_CONFIG_LEVEL_UNSPECIFIED" - Value used when unset.
- // Defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.
+ // "ATTRIBUTE_CONFIG_LEVEL_UNSPECIFIED" - Value used when unset. In
+ // this case, server behavior defaults to
+ // CATALOG_LEVEL_ATTRIBUTE_CONFIG.
// "PRODUCT_LEVEL_ATTRIBUTE_CONFIG" - At this level, we honor the
// attribute configurations set in Product.attributes.
// "CATALOG_LEVEL_ATTRIBUTE_CONFIG" - At this level, we honor the
@@ -1299,6 +1300,79 @@ func (s *GoogleCloudRetailV2alphaAudience) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest: Request
+// for CatalogService.BatchRemoveCatalogAttributes method.
+type GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest struct {
+ // AttributeKeys: Required. The attribute name keys of the
+ // CatalogAttributes to delete. A maximum of 1000 catalog attributes can
+ // be deleted in a batch.
+ AttributeKeys []string `json:"attributeKeys,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "AttributeKeys") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "AttributeKeys") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
+// GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse:
+// Response of the CatalogService.BatchRemoveCatalogAttributes.
+type GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse struct {
+ // DeletedCatalogAttributes: Catalog attributes that were deleted. Only
+ // attributes that are not in use by products can be deleted.
+ DeletedCatalogAttributes []string `json:"deletedCatalogAttributes,omitempty"`
+
+ // ResetCatalogAttributes: Catalog attributes that were reset.
+ // Attributes that are in use by products cannot be deleted, however
+ // their configuration properties will reset to default values upon
+ // removal request.
+ ResetCatalogAttributes []string `json:"resetCatalogAttributes,omitempty"`
+
+ // ServerResponse contains the HTTP response code and headers from the
+ // server.
+ googleapi.ServerResponse `json:"-"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "DeletedCatalogAttributes") to unconditionally include in API
+ // requests. By default, fields with empty or default values are omitted
+ // from API requests. However, any non-pointer, non-interface field
+ // appearing in ForceSendFields will be sent to the server regardless of
+ // whether the field is empty or not. This may be used to include empty
+ // fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DeletedCatalogAttributes")
+ // to include in API requests with the JSON null value. By default,
+ // fields with empty values are omitted from API requests. However, any
+ // field with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2alphaBigQueryOutputResult: A BigQuery output
// result.
type GoogleCloudRetailV2alphaBigQueryOutputResult struct {
@@ -1343,9 +1417,7 @@ type GoogleCloudRetailV2alphaBigQuerySource struct {
// Supported values for user events imports: * `user_event` (default):
// One JSON UserEvent per line. * `user_event_ga360`: The schema is
// available here: https://support.google.com/analytics/answer/3437719.
- // * `user_event_ga4`: This feature is in private preview. Please
- // contact the support team for importing Google Analytics 4 events. The
- // schema is available here:
+ // * `user_event_ga4`: The schema is available here:
// https://support.google.com/analytics/answer/7029846. Supported values
// for auto-completion imports: * `suggestions` (default): One JSON
// completion suggestion per line. * `denylist`: One JSON deny
@@ -1364,8 +1436,7 @@ type GoogleCloudRetailV2alphaBigQuerySource struct {
GcsStagingDir string `json:"gcsStagingDir,omitempty"`
// PartitionDate: BigQuery time partitioned table's _PARTITIONDATE in
- // YYYY-MM-DD format. Only supported when
- // ImportProductsRequest.reconciliation_mode is set to `FULL`.
+ // YYYY-MM-DD format. Only supported in ImportProductsRequest.
PartitionDate *GoogleTypeDate `json:"partitionDate,omitempty"`
// ProjectId: The project ID (can be project # or ID) that the BigQuery
@@ -1466,6 +1537,20 @@ type GoogleCloudRetailV2alphaCatalogAttribute struct {
// for an attribute.
DynamicFacetableOption string `json:"dynamicFacetableOption,omitempty"`
+ // ExactSearchableOption: If EXACT_SEARCHABLE_ENABLED, attribute values
+ // will be exact searchable. This property only applies to textual
+ // custom attributes and requires indexable set to enabled to enable
+ // exact-searchable.
+ //
+ // Possible values:
+ // "EXACT_SEARCHABLE_OPTION_UNSPECIFIED" - Value used when unset.
+ // Defaults to EXACT_SEARCHABLE_DISABLED.
+ // "EXACT_SEARCHABLE_ENABLED" - Exact searchable option enabled for an
+ // attribute.
+ // "EXACT_SEARCHABLE_DISABLED" - Exact searchable option disabled for
+ // an attribute.
+ ExactSearchableOption string `json:"exactSearchableOption,omitempty"`
+
// InUse: Output only. Indicates whether this attribute has been used by
// any products. `True` if at least one Product is using this attribute
// in Product.attributes. Otherwise, this field is `False`.
@@ -1510,7 +1595,8 @@ type GoogleCloudRetailV2alphaCatalogAttribute struct {
//
// Possible values:
// "RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED" - Value used when
- // unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.
+ // unset. In this case, server behavior defaults to
+ // RECOMMENDATIONS_FILTERING_DISABLED.
// "RECOMMENDATIONS_FILTERING_DISABLED" - Recommendation filtering is
// disabled.
// "RECOMMENDATIONS_FILTERING_ENABLED" - Recommendation filtering is
@@ -1637,7 +1723,7 @@ type GoogleCloudRetailV2alphaCompleteQueryResponse struct {
// imported. The recent searches satisfy the follow rules: * They are
// ordered from latest to oldest. * They are matched with
// CompleteQueryRequest.query case insensitively. * They are transformed
- // to lower cases. * They are UTF-8 safe. Recent searches are
+ // to lower case. * They are UTF-8 safe. Recent searches are
// deduplicated. More recent searches will be reserved when duplication
// happens.
RecentSearchResults []*GoogleCloudRetailV2alphaCompleteQueryResponseRecentSearchResult `json:"recentSearchResults,omitempty"`
@@ -1777,14 +1863,13 @@ type GoogleCloudRetailV2alphaCompletionConfig struct {
MatchingOrder string `json:"matchingOrder,omitempty"`
// MaxSuggestions: The maximum number of autocomplete suggestions
- // returned per term. The maximum allowed max suggestions is 20. Default
- // value is 20. If left unset or set to 0, then will fallback to default
- // value.
+ // returned per term. Default value is 20. If left unset or set to 0,
+ // then will fallback to default value. Value range is 1 to 20.
MaxSuggestions int64 `json:"maxSuggestions,omitempty"`
// MinPrefixLength: The minimum number of characters needed to be typed
// in order to get suggestions. Default value is 2. If left unset or set
- // to 0, then will fallback to default value.
+ // to 0, then will fallback to default value. Value range is 1 to 20.
MinPrefixLength int64 `json:"minPrefixLength,omitempty"`
// Name: Required. Immutable. Fully qualified name
@@ -2363,7 +2448,7 @@ func (s *GoogleCloudRetailV2alphaFulfillmentInfo) MarshalJSON() ([]byte, error)
}
// GoogleCloudRetailV2alphaGcsSource: Google Cloud Storage location for
-// input content. format.
+// input content.
type GoogleCloudRetailV2alphaGcsSource struct {
// DataSchema: The schema to use when parsing the data from the source.
// Supported values for product imports: * `product` (default): One JSON
@@ -2374,9 +2459,9 @@ type GoogleCloudRetailV2alphaGcsSource struct {
// Supported values for user events imports: * `user_event` (default):
// One JSON UserEvent per line. * `user_event_ga360`: Using
// https://support.google.com/analytics/answer/3437719. Supported values
- // for control imports: * 'control' (default): One JSON Control per
+ // for control imports: * `control` (default): One JSON Control per
// line. Supported values for catalog attribute imports: *
- // 'catalog_attribute' (default): One CSV CatalogAttribute per line.
+ // `catalog_attribute` (default): One CSV CatalogAttribute per line.
DataSchema string `json:"dataSchema,omitempty"`
// InputUris: Required. Google Cloud Storage URIs to input files. URI
@@ -2503,9 +2588,9 @@ type GoogleCloudRetailV2alphaImportCompletionDataRequest struct {
InputConfig *GoogleCloudRetailV2alphaCompletionDataInputConfig `json:"inputConfig,omitempty"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -2569,7 +2654,7 @@ func (s *GoogleCloudRetailV2alphaImportCompletionDataResponse) MarshalJSON() ([]
// destination for Import related errors.
type GoogleCloudRetailV2alphaImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -2598,7 +2683,7 @@ func (s *GoogleCloudRetailV2alphaImportErrorsConfig) MarshalJSON() ([]byte, erro
}
// GoogleCloudRetailV2alphaImportMetadata: Metadata related to the
-// progress of the Import operation. This will be returned by the
+// progress of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2alphaImportMetadata struct {
// CreateTime: Operation create time.
@@ -2609,9 +2694,9 @@ type GoogleCloudRetailV2alphaImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -2621,6 +2706,10 @@ type GoogleCloudRetailV2alphaImportMetadata struct {
// SuccessCount: Count of entries that were processed successfully.
SuccessCount int64 `json:"successCount,omitempty,string"`
+ // TransformedUserEventsMetadata: Metadata related to transform user
+ // events.
+ TransformedUserEventsMetadata *GoogleCloudRetailV2alphaTransformedUserEventsMetadata `json:"transformedUserEventsMetadata,omitempty"`
+
// UpdateTime: Operation last update time. If the operation is done,
// this is also the finish time.
UpdateTime string `json:"updateTime,omitempty"`
@@ -2660,14 +2749,12 @@ type GoogleCloudRetailV2alphaImportProductsRequest struct {
// NotificationPubsubTopic: Full Pub/Sub topic name for receiving
// notification. If this field is set, when the import is finished, a
- // notification will be sent to specified Pub/Sub topic. The message
- // data will be JSON string of a Operation. Format of the Pub/Sub topic
- // is `projects/{project}/topics/{topic}`. It has to be within the same
- // project as ImportProductsRequest.parent. Make sure that both
- // `cloud-retail-customer-data-access@system.gserviceaccount.com` and
- // `service-@gcp-sa-retail.iam.gserviceaccount.com` have the
- // `pubsub.topics.publish` IAM permission on the topic. Only supported
- // when ImportProductsRequest.reconciliation_mode is set to `FULL`.
+ // notification is sent to specified Pub/Sub topic. The message data is
+ // JSON string of a Operation. Format of the Pub/Sub topic is
+ // `projects/{project}/topics/{topic}`. It has to be within the same
+ // project as ImportProductsRequest.parent. Make sure that
+ // `service-@gcp-sa-retail.iam.gserviceaccount.com` has the
+ // `pubsub.topics.publish` IAM permission on the topic.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
// ReconciliationMode: The mode of reconciliation between existing
@@ -2679,18 +2766,13 @@ type GoogleCloudRetailV2alphaImportProductsRequest struct {
// "INCREMENTAL" - Inserts new products or updates existing products.
// "FULL" - Calculates diff and replaces the entire product dataset.
// Existing products may be deleted if they are not present in the
- // source location. Can only be set while using BigQuerySource. And the
- // BigQuery dataset must be created in the data location "us (multiple
- // regions in United States)", otherwise a PERMISSION_DENIED error is
- // thrown. Add the IAM permission "BigQuery Data Viewer" for
- // cloud-retail-customer-data-access@system.gserviceaccount.com before
- // using this feature otherwise an error is thrown.
+ // source location.
ReconciliationMode string `json:"reconciliationMode,omitempty"`
// RequestId: Deprecated. This field has no effect.
RequestId string `json:"requestId,omitempty"`
- // SkipDefaultBranchProtection: If true, will perform the FULL import
+ // SkipDefaultBranchProtection: If true, this performs the FULL import
// even if it would delete a large proportion of the products in the
// default branch, which could potentially cause outages if you have
// live predict/search traffic. Only supported when
@@ -2698,7 +2780,7 @@ type GoogleCloudRetailV2alphaImportProductsRequest struct {
SkipDefaultBranchProtection bool `json:"skipDefaultBranchProtection,omitempty"`
// UpdateMask: Indicates which fields in the provided imported
- // 'products' to update. If not set, will by default update all fields.
+ // `products` to update. If not set, all fields are updated.
UpdateMask string `json:"updateMask,omitempty"`
// ForceSendFields is a list of field names (e.g. "ErrorsConfig") to
@@ -3159,11 +3241,12 @@ type GoogleCloudRetailV2alphaMerchantCenterLink struct {
BranchId string `json:"branchId,omitempty"`
// Destinations: String representing the destination to import for, all
- // if left empty. List of possible values can be found here.
- // [https://support.google.com/merchants/answer/7501026] List of allowed
- // string values: "Shopping_ads", "Buy_on_google_listings",
- // "Display_ads", "Local_inventory _ads", "Free_listings",
- // "Free_local_listings" NOTE: The string values are case sensitive.
+ // if left empty. List of possible values is given in Included
+ // destination (https://support.google.com/merchants/answer/7501026).
+ // List of allowed string values: "Shopping_ads",
+ // "Buy_on_google_listings", "Display_ads", "Local_inventory _ads",
+ // "Free_listings", "Free_local_listings" NOTE: The string values are
+ // case sensitive.
Destinations []string `json:"destinations,omitempty"`
// LanguageCode: Language of the title/description and other string
@@ -3242,21 +3325,21 @@ func (s *GoogleCloudRetailV2alphaMerchantCenterLinkingConfig) MarshalJSON() ([]b
// GoogleCloudRetailV2alphaModel: Metadata that describes the training
// and serving parameters of a Model. A Model can be associated with a
-// ServingConfig and then queried through the Predict api.
+// ServingConfig and then queried through the Predict API.
type GoogleCloudRetailV2alphaModel struct {
// CreateTime: Output only. Timestamp the Recommendation Model was
// created at.
CreateTime string `json:"createTime,omitempty"`
// DataState: Output only. The state of data requirements for this
- // model: DATA_OK and DATA_ERROR. Recommendation model cannot be trained
- // if the data is in DATA_ERROR state. Recommendation model can have
- // DATA_ERROR state even if serving state is ACTIVE: models were trained
- // successfully before, but cannot be refreshed because model no longer
- // has sufficient data for training.
+ // model: `DATA_OK` and `DATA_ERROR`. Recommendation model cannot be
+ // trained if the data is in `DATA_ERROR` state. Recommendation model
+ // can have `DATA_ERROR` state even if serving state is `ACTIVE`: models
+ // were trained successfully before, but cannot be refreshed because
+ // model no longer has sufficient data for training.
//
// Possible values:
- // "DATA_STATE_UNSPECIFIED" - Unspecified default value - should never
+ // "DATA_STATE_UNSPECIFIED" - Unspecified default value, should never
// be explicitly set.
// "DATA_OK" - The model has sufficient training data.
// "DATA_ERROR" - The model does not have sufficient training data.
@@ -3264,17 +3347,18 @@ type GoogleCloudRetailV2alphaModel struct {
DataState string `json:"dataState,omitempty"`
// DisplayName: Required. The display name of the model. Should be human
- // readable, used to display Recommendation Models in the Retail
- // Pantheon Dashboard. UTF-8 encoded string with limit of 1024
+ // readable, used to display Recommendation Models in the Retail Cloud
+ // Console Dashboard. UTF-8 encoded string with limit of 1024
// characters.
DisplayName string `json:"displayName,omitempty"`
- // FilteringOption: Optional. If RECOMMENDATIONS_FILTERING_ENABLED,
+ // FilteringOption: Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`,
// recommendation filtering by attributes is enabled for the model.
//
// Possible values:
// "RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED" - Value used when
- // unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.
+ // unset. In this case, server behavior defaults to
+ // RECOMMENDATIONS_FILTERING_DISABLED.
// "RECOMMENDATIONS_FILTERING_DISABLED" - Recommendation filtering is
// disabled.
// "RECOMMENDATIONS_FILTERING_ENABLED" - Recommendation filtering is
@@ -3287,8 +3371,8 @@ type GoogleCloudRetailV2alphaModel struct {
// Name: Required. The fully qualified resource name of the model.
// Format:
- // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id
- // }/models/{model_id} catalog_id has char limit of 50.
+ // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_i
+ // d}/models/{model_id}` catalog_id has char limit of 50.
// recommendation_model_id has char limit of 40.
Name string `json:"name,omitempty"`
@@ -3305,19 +3389,20 @@ type GoogleCloudRetailV2alphaModel struct {
// PeriodicTuningState: Optional. The state of periodic tuning. The
// period we use is 3 months - to do a one-off tune earlier use the
- // TuneModel method. Default value is PERIODIC_TUNING_ENABLED.
+ // `TuneModel` method. Default value is `PERIODIC_TUNING_ENABLED`.
//
// Possible values:
- // "PERIODIC_TUNING_STATE_UNSPECIFIED" - Unspecified default value -
+ // "PERIODIC_TUNING_STATE_UNSPECIFIED" - Unspecified default value,
// should never be explicitly set.
// "PERIODIC_TUNING_DISABLED" - The model has periodic tuning
// disabled. Tuning can be reenabled by calling the
- // EnableModelPeriodicTuning method or by calling the TuneModel method.
+ // `EnableModelPeriodicTuning` method or by calling the `TuneModel`
+ // method.
// "ALL_TUNING_DISABLED" - The model cannot be tuned with periodic
- // tuning OR the TuneModel method. Hide the options in customer UI and
+ // tuning OR the `TuneModel` method. Hide the options in customer UI and
// reject any requests through the backend self serve API.
// "PERIODIC_TUNING_ENABLED" - The model has periodic tuning enabled.
- // Tuning can be disabled by calling the DisableModelPeriodicTuning
+ // Tuning can be disabled by calling the `DisableModelPeriodicTuning`
// method.
PeriodicTuningState string `json:"periodicTuningState,omitempty"`
@@ -3325,23 +3410,24 @@ type GoogleCloudRetailV2alphaModel struct {
// associated with the PageOptimizationConfig.
ServingConfigLists []*GoogleCloudRetailV2alphaModelServingConfigList `json:"servingConfigLists,omitempty"`
- // ServingState: Output only. The serving state of the model: ACTIVE,
- // NOT_ACTIVE.
+ // ServingState: Output only. The serving state of the model: `ACTIVE`,
+ // `NOT_ACTIVE`.
//
// Possible values:
// "SERVING_STATE_UNSPECIFIED" - Unspecified serving state.
// "INACTIVE" - The model is not serving.
// "ACTIVE" - The model is serving and can be queried.
- // "TUNED" - The model is trained on tuned hyperparameters, and can be
+ // "TUNED" - The model is trained on tuned hyperparameters and can be
// queried.
ServingState string `json:"servingState,omitempty"`
// TrainingState: Optional. The training state that the model is in
- // (e.g. TRAINING or PAUSED). Since part of the cost of running the
+ // (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the
// service is frequency of training - this can be used to determine when
// to train model in order to control cost. If not specified: the
- // default value for CreateModel method is TRAINING. the default value
- // for UpdateModel method is to keep the state the same as before.
+ // default value for `CreateModel` method is `TRAINING`. The default
+ // value for `UpdateModel` method is to keep the state the same as
+ // before.
//
// Possible values:
// "TRAINING_STATE_UNSPECIFIED" - Unspecified training state.
@@ -3356,8 +3442,8 @@ type GoogleCloudRetailV2alphaModel struct {
// Type: Required. The type of model e.g. `home-page`. Currently
// supported values: `recommended-for-you`, `others-you-may-like`,
- // `frequently-bought-together`, `page-optimization`, 'similar-items',
- // 'buy-it-again', `recently-viewed`(readonly value).
+ // `frequently-bought-together`, `page-optimization`, `similar-items`,
+ // `buy-it-again`, and `recently-viewed`(readonly value).
Type string `json:"type,omitempty"`
// UpdateTime: Output only. Timestamp the Recommendation Model was last
@@ -3438,21 +3524,21 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfig struct {
// candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2
// candidates`: * home_page_ctr_no_diversity,
// home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` =
- // UNIQUE_SERVING_CONFIG_RESTRICTION `Valid combinations`: * * (pdp_ctr,
- // home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low)
- // * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) *
- // (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr,
- // home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) *
- // (home_page_ctr_no_diversity, home_page_ctr_diversity_low) *
- // (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid
- // combinations`: * * (home_page_ctr_no_diversity,
- // home_page_ctr_no_diversity) *
+ // `UNIQUE_SERVING_CONFIG_RESTRICTION` `Valid combinations`: * *
+ // (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr,
+ // home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) *
+ // (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr,
+ // home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low)
+ // * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity,
+ // home_page_ctr_diversity_low) * (home_page_ctr_no_diversity,
+ // pdp_cvr_no_diversity) * `Invalid combinations`: * *
+ // (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *
// "UNIQUE_MODEL_RESTRICTION" - Do not allow multiple ServingConfigs
// with same Model.name to be show on on different panels. Example:
// `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity *
// `Panel2 candidates`: * home_page_ctr_no_diversity,
// home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` =
- // UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr,
+ // `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr,
// home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) *
// (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) *
// (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr,
@@ -3465,7 +3551,7 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfig struct {
// Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr,
// home_page_ctr_no_diversity * `Panel2 candidates`: *
// home_page_ctr_no_diversity, home_page_ctr_diversity_low,
- // pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION
+ // pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
// `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) *
// (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr,
// home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low)
@@ -3505,10 +3591,10 @@ func (s *GoogleCloudRetailV2alphaModelPageOptimizationConfig) MarshalJSON() ([]b
// candidate to consider for a given panel. Currently only ServingConfig
// are valid candidates.
type GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate struct {
- // ServingConfigId: This has to be a valid ServingConfig identifier.
- // e.g. for a ServingConfig with full name:
+ // ServingConfigId: This has to be a valid ServingConfig identifier. For
+ // example, for a ServingConfig with full name:
// `projects/*/locations/global/catalogs/default_catalog/servingConfigs/m
- // y_candidate_config` this would be 'my_candidate_config'
+ // y_candidate_config`, this would be `my_candidate_config`.
ServingConfigId string `json:"servingConfigId,omitempty"`
// ForceSendFields is a list of field names (e.g. "ServingConfigId") to
@@ -3542,8 +3628,8 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel struct {
// = 10.
Candidates []*GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate `json:"candidates,omitempty"`
- // DefaultCandidate: Required. The default candidate (in case the model
- // fails at serving time, we can fall back to the default).
+ // DefaultCandidate: Required. The default candidate. If the model fails
+ // at serving time, we fall back to the default.
DefaultCandidate *GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate `json:"defaultCandidate,omitempty"`
// DisplayName: Optional. The name to display for the panel.
@@ -3573,11 +3659,11 @@ func (s *GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel) MarshalJSON()
}
// GoogleCloudRetailV2alphaModelServingConfigList: Represents an ordered
-// combination of valid serving configs, which / may be used for
-// PAGE_OPTIMIZATION recommendations.
+// combination of valid serving configs, which can be used for
+// `PAGE_OPTIMIZATION` recommendations.
type GoogleCloudRetailV2alphaModelServingConfigList struct {
// ServingConfigIds: Optional. A set of valid serving configs that may
- // be used for PAGE_OPTIMIZATION.
+ // be used for `PAGE_OPTIMIZATION`.
ServingConfigIds []string `json:"servingConfigIds,omitempty"`
// ForceSendFields is a list of field names (e.g. "ServingConfigIds") to
@@ -3682,13 +3768,13 @@ type GoogleCloudRetailV2alphaPredictRequest struct {
// for more details.
Labels map[string]string `json:"labels,omitempty"`
- // PageSize: Maximum number of results to return per page. Set this
- // property to the number of prediction results needed. If zero, the
- // service will choose a reasonable default. The maximum allowed value
- // is 100. Values above 100 will be coerced to 100.
+ // PageSize: Maximum number of results to return. Set this property to
+ // the number of prediction results needed. If zero, the service will
+ // choose a reasonable default. The maximum allowed value is 100. Values
+ // above 100 will be coerced to 100.
PageSize int64 `json:"pageSize,omitempty"`
- // PageToken: This field is not used for now, leave it unset.
+ // PageToken: This field is not used; leave it unset.
PageToken string `json:"pageToken,omitempty"`
// Params: Additional domain specific parameters for the predictions.
@@ -4048,7 +4134,7 @@ type GoogleCloudRetailV2alphaProduct struct {
// CollectionMemberIds: The id of the collection members when type is
// Type.COLLECTION. Non-existent product ids are allowed. The type of
- // the members must be either Type.PRIMARY or Type.VARIANT otherwise and
+ // the members must be either Type.PRIMARY or Type.VARIANT otherwise an
// INVALID_ARGUMENT error is thrown. Should not set it for other types.
// A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT
// error is return.
@@ -5319,10 +5405,10 @@ func (s *GoogleCloudRetailV2alphaRuleDoNotAssociateAction) MarshalJSON() ([]byte
// GoogleCloudRetailV2alphaRuleFilterAction: * Rule Condition: - No
// Condition.query_terms provided is a global match. - 1 or more
-// Condition.query_terms provided is combined with OR operator. * Action
-// Input: The request query and filter that are applied to the retrieved
-// products, in addition to any filters already provided with the
-// SearchRequest. The AND operator is used to combine the query's
+// Condition.query_terms provided are combined with OR operator. *
+// Action Input: The request query and filter that are applied to the
+// retrieved products, in addition to any filters already provided with
+// the SearchRequest. The AND operator is used to combine the query's
// existing filters with the filter rule(s). NOTE: May result in 0
// results when filters conflict. * Action Result: Filters the returned
// objects to be ONLY those that passed the filter.
@@ -5655,8 +5741,8 @@ type GoogleCloudRetailV2alphaSearchRequest struct {
// (https://cloud.google.com/retail/docs/result-size#relevance_thresholding).
//
// Possible values:
- // "RELEVANCE_THRESHOLD_UNSPECIFIED" - Default value. Defaults to
- // RelevanceThreshold.HIGH.
+ // "RELEVANCE_THRESHOLD_UNSPECIFIED" - Default value. In this case,
+ // server behavior defaults to RelevanceThreshold.HIGH.
// "HIGH" - High relevance threshold.
// "MEDIUM" - Medium relevance threshold.
// "LOW" - Low relevance threshold.
@@ -6052,6 +6138,10 @@ type GoogleCloudRetailV2alphaSearchRequestFacetSpecFacetKey struct {
// customFulfillment5
RestrictedValues []string `json:"restrictedValues,omitempty"`
+ // ReturnMinMax: Returns the min and max value for each numerical facet
+ // intervals. Ignored for textual facets.
+ ReturnMinMax bool `json:"returnMinMax,omitempty"`
+
// ForceSendFields is a list of field names (e.g. "CaseInsensitive") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
@@ -6082,8 +6172,10 @@ type GoogleCloudRetailV2alphaSearchRequestPersonalizationSpec struct {
// Mode: Defaults to Mode.AUTO.
//
// Possible values:
- // "MODE_UNSPECIFIED" - Default value. Defaults to Mode.AUTO.
- // "AUTO" - Let CRS decide whether to use personalization.
+ // "MODE_UNSPECIFIED" - Default value. In this case, server behavior
+ // defaults to Mode.AUTO.
+ // "AUTO" - Let CRS decide whether to use personalization based on
+ // quality of user event data.
// "DISABLED" - Disable personalization.
Mode string `json:"mode,omitempty"`
@@ -6118,8 +6210,8 @@ type GoogleCloudRetailV2alphaSearchRequestQueryExpansionSpec struct {
// Default to Condition.DISABLED.
//
// Possible values:
- // "CONDITION_UNSPECIFIED" - Unspecified query expansion condition.
- // This defaults to Condition.DISABLED.
+ // "CONDITION_UNSPECIFIED" - Unspecified query expansion condition. In
+ // this case, server behavior defaults to Condition.DISABLED.
// "DISABLED" - Disabled query expansion. Only the exact search query
// is used, even if SearchResponse.total_size is zero.
// "AUTO" - Automatic query expansion built by Google Retail Search.
@@ -6160,8 +6252,8 @@ type GoogleCloudRetailV2alphaSearchRequestSpellCorrectionSpec struct {
// replace the original search query. Default to Mode.AUTO.
//
// Possible values:
- // "MODE_UNSPECIFIED" - Unspecified spell correction mode. This
- // defaults to Mode.AUTO.
+ // "MODE_UNSPECIFIED" - Unspecified spell correction mode. In this
+ // case, server behavior defaults to Mode.AUTO.
// "SUGGESTION_ONLY" - Google Retail Search will try to find a spell
// suggestion if there is any and put in the
// SearchResponse.corrected_query. The spell suggestion will not be used
@@ -6314,6 +6406,16 @@ type GoogleCloudRetailV2alphaSearchResponseFacetFacetValue struct {
// "price".
Interval *GoogleCloudRetailV2alphaInterval `json:"interval,omitempty"`
+ // MaxValue: The maximum value in the FacetValue.interval. Only
+ // supported on numerical facets and returned if
+ // SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+ MaxValue float64 `json:"maxValue,omitempty"`
+
+ // MinValue: The minimum value in the FacetValue.interval. Only
+ // supported on numerical facets and returned if
+ // SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+ MinValue float64 `json:"minValue,omitempty"`
+
// Value: Text value of a facet, such as "Black" for facet
// "colorFamilies".
Value string `json:"value,omitempty"`
@@ -6341,6 +6443,22 @@ func (s *GoogleCloudRetailV2alphaSearchResponseFacetFacetValue) MarshalJSON() ([
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+func (s *GoogleCloudRetailV2alphaSearchResponseFacetFacetValue) UnmarshalJSON(data []byte) error {
+ type NoMethod GoogleCloudRetailV2alphaSearchResponseFacetFacetValue
+ var s1 struct {
+ MaxValue gensupport.JSONFloat64 `json:"maxValue"`
+ MinValue gensupport.JSONFloat64 `json:"minValue"`
+ *NoMethod
+ }
+ s1.NoMethod = (*NoMethod)(s)
+ if err := json.Unmarshal(data, &s1); err != nil {
+ return err
+ }
+ s.MaxValue = float64(s1.MaxValue)
+ s.MinValue = float64(s1.MinValue)
+ return nil
+}
+
// GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo: Information
// describing query expansion including whether expansion has occurred.
type GoogleCloudRetailV2alphaSearchResponseQueryExpansionInfo struct {
@@ -6394,6 +6512,14 @@ type GoogleCloudRetailV2alphaSearchResponseSearchResult struct {
// ColorInfo and the query.
MatchingVariantFields map[string]string `json:"matchingVariantFields,omitempty"`
+ // PersonalLabels: Specifies previous events related to this product for
+ // this user based on UserEvent with same SearchRequest.visitor_id or
+ // UserInfo.user_id. This is set only when
+ // SearchRequest.PersonalizationSpec.mode is
+ // SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: *
+ // `purchased`: Indicates that this product has been purchased before.
+ PersonalLabels []string `json:"personalLabels,omitempty"`
+
// Product: The product data snippet in the search response. Only
// Product.name is guaranteed to be populated. Product.variants contains
// the product variants that match the search query. If there are
@@ -6743,6 +6869,42 @@ func (s *GoogleCloudRetailV2alphaSetInventoryRequest) MarshalJSON() ([]byte, err
type GoogleCloudRetailV2alphaSetInventoryResponse struct {
}
+// GoogleCloudRetailV2alphaTransformedUserEventsMetadata: Metadata
+// related to transform user events operation.
+type GoogleCloudRetailV2alphaTransformedUserEventsMetadata struct {
+ // SourceEventsCount: Count of entries in the source user events
+ // BigQuery table.
+ SourceEventsCount int64 `json:"sourceEventsCount,omitempty,string"`
+
+ // TransformedEventsCount: Count of entries in the transformed user
+ // events BigQuery table, which could be different from the actually
+ // imported number of user events.
+ TransformedEventsCount int64 `json:"transformedEventsCount,omitempty,string"`
+
+ // ForceSendFields is a list of field names (e.g. "SourceEventsCount")
+ // to unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "SourceEventsCount") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2alphaTransformedUserEventsMetadata) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2alphaTuneModelMetadata: Metadata associated with a
// tune operation.
type GoogleCloudRetailV2alphaTuneModelMetadata struct {
@@ -7397,7 +7559,7 @@ func (s *GoogleCloudRetailV2betaImportCompletionDataResponse) MarshalJSON() ([]b
// destination for Import related errors.
type GoogleCloudRetailV2betaImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -7426,7 +7588,7 @@ func (s *GoogleCloudRetailV2betaImportErrorsConfig) MarshalJSON() ([]byte, error
}
// GoogleCloudRetailV2betaImportMetadata: Metadata related to the
-// progress of the Import operation. This will be returned by the
+// progress of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2betaImportMetadata struct {
// CreateTime: Operation create time.
@@ -7437,9 +7599,9 @@ type GoogleCloudRetailV2betaImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -7952,9 +8114,9 @@ type ProjectsLocationsCatalogsCompleteQueryCall struct {
// Search enabled. Please enable Retail Search on Cloud Console before
// using this feature.
//
-// - catalog: Catalog for which the completion is performed. Full
-// resource name of catalog, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: Catalog for which the completion is performed. Full
+// resource name of catalog, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) CompleteQuery(catalog string) *ProjectsLocationsCatalogsCompleteQueryCall {
c := &ProjectsLocationsCatalogsCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -8203,9 +8365,9 @@ type ProjectsLocationsCatalogsGetAttributesConfigCall struct {
// GetAttributesConfig: Gets an AttributesConfig.
//
-// - name: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - name: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsService) GetAttributesConfig(name string) *ProjectsLocationsCatalogsGetAttributesConfigCall {
c := &ProjectsLocationsCatalogsGetAttributesConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8353,9 +8515,9 @@ type ProjectsLocationsCatalogsGetCompletionConfigCall struct {
// GetCompletionConfig: Gets a CompletionConfig.
//
-// - name: Full CompletionConfig resource name. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/completionConfig.
+// - name: Full CompletionConfig resource name. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/completionConfig.
func (r *ProjectsLocationsCatalogsService) GetCompletionConfig(name string) *ProjectsLocationsCatalogsGetCompletionConfigCall {
c := &ProjectsLocationsCatalogsGetCompletionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8505,8 +8667,8 @@ type ProjectsLocationsCatalogsGetDefaultBranchCall struct {
// CatalogService.SetDefaultBranch method under a specified parent
// catalog.
//
-// - catalog: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) GetDefaultBranch(catalog string) *ProjectsLocationsCatalogsGetDefaultBranchCall {
c := &ProjectsLocationsCatalogsGetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -8654,10 +8816,10 @@ type ProjectsLocationsCatalogsListCall struct {
// List: Lists all the Catalogs associated with the project.
//
-// - parent: The account resource name with an associated location. If
-// the caller does not have permission to list Catalogs under this
-// location, regardless of whether or not this location exists, a
-// PERMISSION_DENIED error is returned.
+// - parent: The account resource name with an associated location. If
+// the caller does not have permission to list Catalogs under this
+// location, regardless of whether or not this location exists, a
+// PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsService) List(parent string) *ProjectsLocationsCatalogsListCall {
c := &ProjectsLocationsCatalogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9033,8 +9195,8 @@ type ProjectsLocationsCatalogsSetDefaultBranchCall struct {
// {newBranch} (if branch is not explicitly set). * UserEventService
// will only join events with products from branch {newBranch}.
//
-// - catalog: Full resource name of the catalog, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: Full resource name of the catalog, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) SetDefaultBranch(catalog string, googlecloudretailv2alphasetdefaultbranchrequest *GoogleCloudRetailV2alphaSetDefaultBranchRequest) *ProjectsLocationsCatalogsSetDefaultBranchCall {
c := &ProjectsLocationsCatalogsSetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -9183,9 +9345,9 @@ type ProjectsLocationsCatalogsUpdateAttributesConfigCall struct {
// missing catalog attribute fields, e.g., searchable and dynamic
// facetable options.
//
-// - name: Immutable. The fully qualified resource name of the attribute
-// config. Format:
-// `projects/*/locations/*/catalogs/*/attributesConfig`.
+// - name: Immutable. The fully qualified resource name of the attribute
+// config. Format:
+// `projects/*/locations/*/catalogs/*/attributesConfig`.
func (r *ProjectsLocationsCatalogsService) UpdateAttributesConfig(name string, googlecloudretailv2alphaattributesconfig *GoogleCloudRetailV2alphaAttributesConfig) *ProjectsLocationsCatalogsUpdateAttributesConfigCall {
c := &ProjectsLocationsCatalogsUpdateAttributesConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9344,8 +9506,8 @@ type ProjectsLocationsCatalogsUpdateCompletionConfigCall struct {
// UpdateCompletionConfig: Updates the CompletionConfigs.
//
-// - name: Immutable. Fully qualified name
-// `projects/*/locations/*/catalogs/*/completionConfig`.
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/*/catalogs/*/completionConfig`.
func (r *ProjectsLocationsCatalogsService) UpdateCompletionConfig(name string, googlecloudretailv2alphacompletionconfig *GoogleCloudRetailV2alphaCompletionConfig) *ProjectsLocationsCatalogsUpdateCompletionConfigCall {
c := &ProjectsLocationsCatalogsUpdateCompletionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9508,9 +9670,9 @@ type ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall struct {
// AttributesConfig. If the CatalogAttribute to add already exists, an
// ALREADY_EXISTS error is returned.
//
-// - attributesConfig: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsAttributesConfigService) AddCatalogAttribute(attributesConfig string, googlecloudretailv2alphaaddcatalogattributerequest *GoogleCloudRetailV2alphaAddCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall {
c := &ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.attributesConfig = attributesConfig
@@ -9641,6 +9803,155 @@ func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) Do(op
}
+// method id "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes":
+
+type ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall struct {
+ s *Service
+ attributesConfig string
+ googlecloudretailv2alphabatchremovecatalogattributesrequest *GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// BatchRemoveCatalogAttributes: Removes all specified CatalogAttributes
+// from the AttributesConfig.
+//
+// - attributesConfig: The attributes config resource shared by all
+// catalog attributes being deleted. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
+func (r *ProjectsLocationsCatalogsAttributesConfigService) BatchRemoveCatalogAttributes(attributesConfig string, googlecloudretailv2alphabatchremovecatalogattributesrequest *GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest) *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall {
+ c := &ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.attributesConfig = attributesConfig
+ c.googlecloudretailv2alphabatchremovecatalogattributesrequest = googlecloudretailv2alphabatchremovecatalogattributesrequest
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Context(ctx context.Context) *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2alphabatchremovecatalogattributesrequest)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2alpha/{+attributesConfig}:batchRemoveCatalogAttributes")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("POST", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "attributesConfig": c.attributesConfig,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes" call.
+// Exactly one of
+// *GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse or
+// error will be non-nil. Any non-2xx status code is an error. Response
+// headers are in either
+// *GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse.ServerRe
+// sponse.Header or (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Removes all specified CatalogAttributes from the AttributesConfig.",
+ // "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:batchRemoveCatalogAttributes",
+ // "httpMethod": "POST",
+ // "id": "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes",
+ // "parameterOrder": [
+ // "attributesConfig"
+ // ],
+ // "parameters": {
+ // "attributesConfig": {
+ // "description": "Required. The attributes config resource shared by all catalog attributes being deleted. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2alpha/{+attributesConfig}:batchRemoveCatalogAttributes",
+ // "request": {
+ // "$ref": "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesRequest"
+ // },
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2alphaBatchRemoveCatalogAttributesResponse"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
// method id "retail.projects.locations.catalogs.attributesConfig.removeCatalogAttribute":
type ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall struct {
@@ -9656,9 +9967,9 @@ type ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall struct
// the AttributesConfig. If the CatalogAttribute to remove does not
// exist, a NOT_FOUND error is returned.
//
-// - attributesConfig: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsAttributesConfigService) RemoveCatalogAttribute(attributesConfig string, googlecloudretailv2alpharemovecatalogattributerequest *GoogleCloudRetailV2alphaRemoveCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall {
c := &ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.attributesConfig = attributesConfig
@@ -9805,9 +10116,9 @@ type ProjectsLocationsCatalogsAttributesConfigReplaceCatalogAttributeCall struct
// CatalogAttribute.key. If the CatalogAttribute to replace does not
// exist, a NOT_FOUND error is returned.
//
-// - attributesConfig: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsAttributesConfigService) ReplaceCatalogAttribute(attributesConfig string, googlecloudretailv2alphareplacecatalogattributerequest *GoogleCloudRetailV2alphaReplaceCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigReplaceCatalogAttributeCall {
c := &ProjectsLocationsCatalogsAttributesConfigReplaceCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.attributesConfig = attributesConfig
@@ -10104,15 +10415,18 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct {
// processed downstream. As a consequence, when a response is returned,
// the added place IDs are not immediately manifested in the Product
// queried by ProductService.GetProduct or ProductService.ListProducts.
-// This feature is only available for users who have Retail Search
-// enabled. Please enable Retail Search on Cloud Console before using
-// this feature.
+// The returned Operations will be obsolete after 1 day, and
+// GetOperation API will return NOT_FOUND afterwards. If conflicting
+// updates are issued, the Operations associated with the stale updates
+// will not be marked as done until being obsolete. This feature is only
+// available for users who have Retail Search enabled. Please enable
+// Retail Search on Cloud Console before using this feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) AddFulfillmentPlaces(product string, googlecloudretailv2alphaaddfulfillmentplacesrequest *GoogleCloudRetailV2alphaAddFulfillmentPlacesRequest) *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall {
c := &ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -10211,7 +10525,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o
}
return ret, nil
// {
- // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces",
@@ -10262,15 +10576,19 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct {
// ProductService.GetProduct or ProductService.ListProducts. Local
// inventory information can only be modified using this method.
// ProductService.CreateProduct and ProductService.UpdateProduct has no
-// effect on local inventories. This feature is only available for users
-// who have Retail Search enabled. Please enable Retail Search on Cloud
-// Console before using this feature.
+// effect on local inventories. The returned Operations will be obsolete
+// after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+// If conflicting updates are issued, the Operations associated with the
+// stale updates will not be marked as done until being obsolete. This
+// feature is only available for users who have Retail Search enabled.
+// Please enable Retail Search on Cloud Console before using this
+// feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) AddLocalInventories(product string, googlecloudretailv2alphaaddlocalinventoriesrequest *GoogleCloudRetailV2alphaAddLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall {
c := &ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -10369,7 +10687,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op
}
return ret, nil
// {
- // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories",
@@ -10412,9 +10730,9 @@ type ProjectsLocationsCatalogsBranchesProductsCreateCall struct {
// Create: Creates a Product.
//
-// - parent: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch`.
+// - parent: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Create(parent string, googlecloudretailv2alphaproduct *GoogleCloudRetailV2alphaProduct) *ProjectsLocationsCatalogsBranchesProductsCreateCall {
c := &ProjectsLocationsCatalogsBranchesProductsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10573,16 +10891,16 @@ type ProjectsLocationsCatalogsBranchesProductsDeleteCall struct {
// Delete: Deletes a Product.
//
-// - name: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to delete the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned. If the Product to
-// delete does not exist, a NOT_FOUND error is returned. The Product
-// to delete can neither be a Product.Type.COLLECTION Product member
-// nor a Product.Type.PRIMARY Product with more than one variants.
-// Otherwise, an INVALID_ARGUMENT error is returned. All inventory
-// information for the named Product will be deleted.
+// - name: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to delete the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned. If the Product to
+// delete does not exist, a NOT_FOUND error is returned. The Product
+// to delete can neither be a Product.Type.COLLECTION Product member
+// nor a Product.Type.PRIMARY Product with more than one variants.
+// Otherwise, an INVALID_ARGUMENT error is returned. All inventory
+// information for the named Product will be deleted.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Delete(name string) *ProjectsLocationsCatalogsBranchesProductsDeleteCall {
c := &ProjectsLocationsCatalogsBranchesProductsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10715,12 +11033,12 @@ type ProjectsLocationsCatalogsBranchesProductsGetCall struct {
// Get: Gets a Product.
//
-// - name: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned. If the requested
-// Product does not exist, a NOT_FOUND error is returned.
+// - name: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned. If the requested
+// Product does not exist, a NOT_FOUND error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Get(name string) *ProjectsLocationsCatalogsBranchesProductsGetCall {
c := &ProjectsLocationsCatalogsBranchesProductsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10868,11 +11186,11 @@ type ProjectsLocationsCatalogsBranchesProductsImportCall struct {
// synchronous. Non-existing items are created. Note that it is possible
// for a subset of the Products to be successfully updated.
//
-// - parent:
-// `projects/1234/locations/global/catalogs/default_catalog/branches/de
-// fault_branch` If no updateMask is specified, requires
-// products.create permission. If updateMask is specified, requires
-// products.update permission.
+// - parent:
+// `projects/1234/locations/global/catalogs/default_catalog/branches/de
+// fault_branch` If no updateMask is specified, requires
+// products.create permission. If updateMask is specified, requires
+// products.update permission.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Import(parent string, googlecloudretailv2alphaimportproductsrequest *GoogleCloudRetailV2alphaImportProductsRequest) *ProjectsLocationsCatalogsBranchesProductsImportCall {
c := &ProjectsLocationsCatalogsBranchesProductsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11014,12 +11332,12 @@ type ProjectsLocationsCatalogsBranchesProductsListCall struct {
// List: Gets a list of Products.
//
-// - parent: The parent branch resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/0`.
-// Use `default_branch` as the branch ID, to list products under the
-// default branch. If the caller does not have permission to list
-// Products under this branch, regardless of whether or not this
-// branch exists, a PERMISSION_DENIED error is returned.
+// - parent: The parent branch resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/0`.
+// Use `default_branch` as the branch ID, to list products under the
+// default branch. If the caller does not have permission to list
+// Products under this branch, regardless of whether or not this
+// branch exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) List(parent string) *ProjectsLocationsCatalogsBranchesProductsListCall {
c := &ProjectsLocationsCatalogsBranchesProductsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11274,9 +11592,9 @@ type ProjectsLocationsCatalogsBranchesProductsPatchCall struct {
// Patch: Updates a Product.
//
-// - name: Immutable. Full resource name of the product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/product_id`.
+// - name: Immutable. Full resource name of the product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/product_id`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Patch(name string, googlecloudretailv2alphaproduct *GoogleCloudRetailV2alphaProduct) *ProjectsLocationsCatalogsBranchesProductsPatchCall {
c := &ProjectsLocationsCatalogsBranchesProductsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11459,10 +11777,10 @@ type ProjectsLocationsCatalogsBranchesProductsPurgeCall struct {
// complete. To get a sample of Products that would be deleted, set
// PurgeProductsRequest.force to false.
//
-// - parent: The resource name of the branch under which the products
-// are created. The format is
-// `projects/${projectId}/locations/global/catalogs/${catalogId}/branch
-// es/${branchId}`.
+// - parent: The resource name of the branch under which the products
+// are created. The format is
+// `projects/${projectId}/locations/global/catalogs/${catalogId}/branch
+// es/${branchId}`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Purge(parent string, googlecloudretailv2alphapurgeproductsrequest *GoogleCloudRetailV2alphaPurgeProductsRequest) *ProjectsLocationsCatalogsBranchesProductsPurgeCall {
c := &ProjectsLocationsCatalogsBranchesProductsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11609,15 +11927,18 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct
// processed downstream. As a consequence, when a response is returned,
// the removed place IDs are not immediately manifested in the Product
// queried by ProductService.GetProduct or ProductService.ListProducts.
-// This feature is only available for users who have Retail Search
-// enabled. Please enable Retail Search on Cloud Console before using
-// this feature.
+// The returned Operations will be obsolete after 1 day, and
+// GetOperation API will return NOT_FOUND afterwards. If conflicting
+// updates are issued, the Operations associated with the stale updates
+// will not be marked as done until being obsolete. This feature is only
+// available for users who have Retail Search enabled. Please enable
+// Retail Search on Cloud Console before using this feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveFulfillmentPlaces(product string, googlecloudretailv2alpharemovefulfillmentplacesrequest *GoogleCloudRetailV2alphaRemoveFulfillmentPlacesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall {
c := &ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -11716,7 +12037,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D
}
return ret, nil
// {
- // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces",
@@ -11765,15 +12086,19 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct
// queried by ProductService.GetProduct or ProductService.ListProducts.
// Local inventory information can only be removed using this method.
// ProductService.CreateProduct and ProductService.UpdateProduct has no
-// effect on local inventories. This feature is only available for users
-// who have Retail Search enabled. Please enable Retail Search on Cloud
-// Console before using this feature.
+// effect on local inventories. The returned Operations will be obsolete
+// after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+// If conflicting updates are issued, the Operations associated with the
+// stale updates will not be marked as done until being obsolete. This
+// feature is only available for users who have Retail Search enabled.
+// Please enable Retail Search on Cloud Console before using this
+// feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveLocalInventories(product string, googlecloudretailv2alpharemovelocalinventoriesrequest *GoogleCloudRetailV2alphaRemoveLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall {
c := &ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -11872,7 +12197,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do
}
return ret, nil
// {
- // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories",
@@ -11933,13 +12258,17 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct {
// information will be preserved. Pre-existing inventory information can
// only be updated with ProductService.SetInventory,
// ProductService.AddFulfillmentPlaces, and
-// ProductService.RemoveFulfillmentPlaces. This feature is only
-// available for users who have Retail Search enabled. Please enable
-// Retail Search on Cloud Console before using this feature.
+// ProductService.RemoveFulfillmentPlaces. The returned Operations will
+// be obsolete after 1 day, and GetOperation API will return NOT_FOUND
+// afterwards. If conflicting updates are issued, the Operations
+// associated with the stale updates will not be marked as done until
+// being obsolete. This feature is only available for users who have
+// Retail Search enabled. Please enable Retail Search on Cloud Console
+// before using this feature.
//
-// - name: Immutable. Full resource name of the product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/product_id`.
+// - name: Immutable. Full resource name of the product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/product_id`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) SetInventory(name string, googlecloudretailv2alphasetinventoryrequest *GoogleCloudRetailV2alphaSetInventoryRequest) *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall {
c := &ProjectsLocationsCatalogsBranchesProductsSetInventoryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12038,7 +12367,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g
}
return ret, nil
// {
- // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.setInventory",
@@ -12087,8 +12416,8 @@ type ProjectsLocationsCatalogsCompletionDataImportCall struct {
// have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - parent: The catalog which the suggestions dataset belongs to.
-// Format: `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The catalog which the suggestions dataset belongs to.
+// Format: `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsCompletionDataService) Import(parent string, googlecloudretailv2alphaimportcompletiondatarequest *GoogleCloudRetailV2alphaImportCompletionDataRequest) *ProjectsLocationsCatalogsCompletionDataImportCall {
c := &ProjectsLocationsCatalogsCompletionDataImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12231,9 +12560,9 @@ type ProjectsLocationsCatalogsControlsCreateCall struct {
// Create: Creates a Control. If the Control to create already exists,
// an ALREADY_EXISTS error is returned.
//
-// - parent: Full resource name of parent catalog. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}`.
+// - parent: Full resource name of parent catalog. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}`.
func (r *ProjectsLocationsCatalogsControlsService) Create(parent string, googlecloudretailv2alphacontrol *GoogleCloudRetailV2alphaControl) *ProjectsLocationsCatalogsControlsCreateCall {
c := &ProjectsLocationsCatalogsControlsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12389,9 +12718,9 @@ type ProjectsLocationsCatalogsControlsDeleteCall struct {
// Delete: Deletes a Control. If the Control to delete does not exist, a
// NOT_FOUND error is returned.
//
-// - name: The resource name of the Control to delete. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/controls/{control_id}`.
+// - name: The resource name of the Control to delete. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/controls/{control_id}`.
func (r *ProjectsLocationsCatalogsControlsService) Delete(name string) *ProjectsLocationsCatalogsControlsDeleteCall {
c := &ProjectsLocationsCatalogsControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12524,9 +12853,9 @@ type ProjectsLocationsCatalogsControlsGetCall struct {
// Get: Gets a Control.
//
-// - name: The resource name of the Control to delete. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/controls/{control_id}`.
+// - name: The resource name of the Control to delete. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/controls/{control_id}`.
func (r *ProjectsLocationsCatalogsControlsService) Get(name string) *ProjectsLocationsCatalogsControlsGetCall {
c := &ProjectsLocationsCatalogsControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12672,9 +13001,9 @@ type ProjectsLocationsCatalogsControlsListCall struct {
// List: Lists all Controls linked to this catalog.
//
-// - parent: The catalog resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}`.
+// - parent: The catalog resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}`.
func (r *ProjectsLocationsCatalogsControlsService) List(parent string) *ProjectsLocationsCatalogsControlsListCall {
c := &ProjectsLocationsCatalogsControlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12886,8 +13215,8 @@ type ProjectsLocationsCatalogsControlsPatchCall struct {
// field, if so an INVALID_ARGUMENT is returned. If the Control to
// delete does not exist, a NOT_FOUND error is returned.
//
-// - name: Immutable. Fully qualified name
-// `projects/*/locations/global/catalogs/*/controls/*`.
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/global/catalogs/*/controls/*`.
func (r *ProjectsLocationsCatalogsControlsService) Patch(name string, googlecloudretailv2alphacontrol *GoogleCloudRetailV2alphaControl) *ProjectsLocationsCatalogsControlsPatchCall {
c := &ProjectsLocationsCatalogsControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13044,10 +13373,10 @@ type ProjectsLocationsCatalogsModelsCreateCall struct {
// Create: Creates a new model.
//
-// - parent: The parent resource under which to create the model.
-// Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}.
+// - parent: The parent resource under which to create the model.
+// Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}.
func (r *ProjectsLocationsCatalogsModelsService) Create(parent string, googlecloudretailv2alphamodel *GoogleCloudRetailV2alphaModel) *ProjectsLocationsCatalogsModelsCreateCall {
c := &ProjectsLocationsCatalogsModelsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13055,7 +13384,7 @@ func (r *ProjectsLocationsCatalogsModelsService) Create(parent string, googleclo
return c
}
-// DryRun sets the optional parameter "dryRun": Whether to run a dry_run
+// DryRun sets the optional parameter "dryRun": Whether to run a dry run
// to validate the request (without actually creating the model).
func (c *ProjectsLocationsCatalogsModelsCreateCall) DryRun(dryRun bool) *ProjectsLocationsCatalogsModelsCreateCall {
c.urlParams_.Set("dryRun", fmt.Sprint(dryRun))
@@ -13162,7 +13491,7 @@ func (c *ProjectsLocationsCatalogsModelsCreateCall) Do(opts ...googleapi.CallOpt
// ],
// "parameters": {
// "dryRun": {
- // "description": "Optional. Whether to run a dry_run to validate the request (without actually creating the model).",
+ // "description": "Optional. Whether to run a dry run to validate the request (without actually creating the model).",
// "location": "query",
// "type": "boolean"
// },
@@ -13200,9 +13529,9 @@ type ProjectsLocationsCatalogsModelsDeleteCall struct {
// Delete: Deletes an existing model.
//
-// - name: The resource name of the [Model] to delete. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/models/{model_id}.
+// - name: The resource name of the Model to delete. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/models/{model_id}.
func (r *ProjectsLocationsCatalogsModelsService) Delete(name string) *ProjectsLocationsCatalogsModelsDeleteCall {
c := &ProjectsLocationsCatalogsModelsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13304,7 +13633,7 @@ func (c *ProjectsLocationsCatalogsModelsDeleteCall) Do(opts ...googleapi.CallOpt
// ],
// "parameters": {
// "name": {
- // "description": "Required. The resource name of the [Model] to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}",
+ // "description": "Required. The resource name of the Model to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/models/[^/]+$",
// "required": true,
@@ -13335,9 +13664,9 @@ type ProjectsLocationsCatalogsModelsListCall struct {
// List: Lists all the models linked to this event store.
//
-// - parent: The parent for which to list models. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}.
+// - parent: The parent for which to list models. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}.
func (r *ProjectsLocationsCatalogsModelsService) List(parent string) *ProjectsLocationsCatalogsModelsListCall {
c := &ProjectsLocationsCatalogsModelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13532,13 +13861,13 @@ type ProjectsLocationsCatalogsModelsPatchCall struct {
}
// Patch: Update of model metadata. Only fields that currently can be
-// updated are: filtering_option, periodic_tuning_state. If other values
-// are provided, this API method will ignore them.
+// updated are: `filtering_option` and `periodic_tuning_state`. If other
+// values are provided, this API method ignores them.
//
-// - name: The fully qualified resource name of the model. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/models/{model_id} catalog_id has char limit of 50.
-// recommendation_model_id has char limit of 40.
+// - name: The fully qualified resource name of the model. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/models/{model_id}` catalog_id has char limit of 50.
+// recommendation_model_id has char limit of 40.
func (r *ProjectsLocationsCatalogsModelsService) Patch(name string, googlecloudretailv2alphamodel *GoogleCloudRetailV2alphaModel) *ProjectsLocationsCatalogsModelsPatchCall {
c := &ProjectsLocationsCatalogsModelsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13547,8 +13876,8 @@ func (r *ProjectsLocationsCatalogsModelsService) Patch(name string, googlecloudr
}
// UpdateMask sets the optional parameter "updateMask": Indicates which
-// fields in the provided 'model' to update. If not set, will by default
-// update all fields.
+// fields in the provided 'model' to update. If not set, by default
+// updates all fields.
func (c *ProjectsLocationsCatalogsModelsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsCatalogsModelsPatchCall {
c.urlParams_.Set("updateMask", updateMask)
return c
@@ -13645,7 +13974,7 @@ func (c *ProjectsLocationsCatalogsModelsPatchCall) Do(opts ...googleapi.CallOpti
}
return ret, nil
// {
- // "description": "Update of model metadata. Only fields that currently can be updated are: filtering_option, periodic_tuning_state. If other values are provided, this API method will ignore them.",
+ // "description": "Update of model metadata. Only fields that currently can be updated are: `filtering_option` and `periodic_tuning_state`. If other values are provided, this API method ignores them.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/models/{modelsId}",
// "httpMethod": "PATCH",
// "id": "retail.projects.locations.catalogs.models.patch",
@@ -13654,14 +13983,14 @@ func (c *ProjectsLocationsCatalogsModelsPatchCall) Do(opts ...googleapi.CallOpti
// ],
// "parameters": {
// "name": {
- // "description": "Required. The fully qualified resource name of the model. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
+ // "description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/models/[^/]+$",
// "required": true,
// "type": "string"
// },
// "updateMask": {
- // "description": "Optional. Indicates which fields in the provided 'model' to update. If not set, will by default update all fields.",
+ // "description": "Optional. Indicates which fields in the provided 'model' to update. If not set, by default updates all fields.",
// "format": "google-fieldmask",
// "location": "query",
// "type": "string"
@@ -13694,9 +14023,9 @@ type ProjectsLocationsCatalogsModelsPauseCall struct {
// Pause: Pauses the training of an existing model.
//
-// - name: The name of the model to pause. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/models/{model_id}.
+// - name: The name of the model to pause. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/models/{model_id}.
func (r *ProjectsLocationsCatalogsModelsService) Pause(name string, googlecloudretailv2alphapausemodelrequest *GoogleCloudRetailV2alphaPauseModelRequest) *ProjectsLocationsCatalogsModelsPauseCall {
c := &ProjectsLocationsCatalogsModelsPauseCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13838,9 +14167,9 @@ type ProjectsLocationsCatalogsModelsResumeCall struct {
// Resume: Resumes the training of an existing model.
//
-// - name: The name of the model to resume. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/models/{model_id}.
+// - name: The name of the model to resume. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/models/{model_id}.
func (r *ProjectsLocationsCatalogsModelsService) Resume(name string, googlecloudretailv2alpharesumemodelrequest *GoogleCloudRetailV2alphaResumeModelRequest) *ProjectsLocationsCatalogsModelsResumeCall {
c := &ProjectsLocationsCatalogsModelsResumeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13982,9 +14311,9 @@ type ProjectsLocationsCatalogsModelsTuneCall struct {
// Tune: Tunes an existing model.
//
-// - name: The resource name of the model to tune. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/models/{model_id}.
+// - name: The resource name of the model to tune. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/models/{model_id}.
func (r *ProjectsLocationsCatalogsModelsService) Tune(name string, googlecloudretailv2alphatunemodelrequest *GoogleCloudRetailV2alphaTuneModelRequest) *ProjectsLocationsCatalogsModelsTuneCall {
c := &ProjectsLocationsCatalogsModelsTuneCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -14488,19 +14817,19 @@ type ProjectsLocationsCatalogsPlacementsPredictCall struct {
// Predict: Makes a recommendation prediction.
//
-// - placement: Full resource name of the format:
-// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
-// vingConfigs/*}` or
-// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
-// cements/*}`. We recommend using the `servingConfigs` resource.
-// `placements` is a legacy resource. The ID of the Recommendations AI
-// serving config or placement. Before you can request predictions
-// from your model, you must create at least one serving config or
-// placement for it. For more information, see [Managing serving
-// configurations]
-// (https://cloud.google.com/retail/docs/manage-configs). The full
-// list of available serving configs can be seen at
-// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
+// - placement: Full resource name of the format:
+// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
+// vingConfigs/*}` or
+// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
+// cements/*}`. We recommend using the `servingConfigs` resource.
+// `placements` is a legacy resource. The ID of the Recommendations AI
+// serving config or placement. Before you can request predictions
+// from your model, you must create at least one serving config or
+// placement for it. For more information, see [Managing serving
+// configurations]
+// (https://cloud.google.com/retail/docs/manage-configs). The full
+// list of available serving configs can be seen at
+// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
func (r *ProjectsLocationsCatalogsPlacementsService) Predict(placement string, googlecloudretailv2alphapredictrequest *GoogleCloudRetailV2alphaPredictRequest) *ProjectsLocationsCatalogsPlacementsPredictCall {
c := &ProjectsLocationsCatalogsPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -14645,15 +14974,15 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct {
// who have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - placement: The resource name of the Retail Search serving config,
-// such as
-// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
-// /default_serving_config` or the name of the legacy placement
-// resource, such as
-// `projects/*/locations/global/catalogs/default_catalog/placements/def
-// ault_search`. This field is used to identify the serving
-// configuration name and the set of models that will be used to make
-// the search.
+// - placement: The resource name of the Retail Search serving config,
+// such as
+// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
+// /default_serving_config` or the name of the legacy placement
+// resource, such as
+// `projects/*/locations/global/catalogs/default_catalog/placements/def
+// ault_search`. This field is used to identify the serving
+// configuration name and the set of models that will be used to make
+// the search.
func (r *ProjectsLocationsCatalogsPlacementsService) Search(placement string, googlecloudretailv2alphasearchrequest *GoogleCloudRetailV2alphaSearchRequest) *ProjectsLocationsCatalogsPlacementsSearchCall {
c := &ProjectsLocationsCatalogsPlacementsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -14823,9 +15152,9 @@ type ProjectsLocationsCatalogsServingConfigsAddControlCall struct {
// a FAILED_PRECONDITION error if the addition could exceed maximum
// number of control allowed for that type of control.
//
-// - servingConfig: The source ServingConfig resource name . Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - servingConfig: The source ServingConfig resource name . Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) AddControl(servingConfig string, googlecloudretailv2alphaaddcontrolrequest *GoogleCloudRetailV2alphaAddControlRequest) *ProjectsLocationsCatalogsServingConfigsAddControlCall {
c := &ProjectsLocationsCatalogsServingConfigsAddControlCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.servingConfig = servingConfig
@@ -14970,9 +15299,9 @@ type ProjectsLocationsCatalogsServingConfigsCreateCall struct {
// allowed in a Catalog, otherwise a FAILED_PRECONDITION error is
// returned.
//
-// - parent: Full resource name of parent. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}`.
+// - parent: Full resource name of parent. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}`.
func (r *ProjectsLocationsCatalogsServingConfigsService) Create(parent string, googlecloudretailv2alphaservingconfig *GoogleCloudRetailV2alphaServingConfig) *ProjectsLocationsCatalogsServingConfigsCreateCall {
c := &ProjectsLocationsCatalogsServingConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15129,9 +15458,9 @@ type ProjectsLocationsCatalogsServingConfigsDeleteCall struct {
// Delete: Deletes a ServingConfig. Returns a NotFound error if the
// ServingConfig does not exist.
//
-// - name: The resource name of the ServingConfig to delete. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - name: The resource name of the ServingConfig to delete. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) Delete(name string) *ProjectsLocationsCatalogsServingConfigsDeleteCall {
c := &ProjectsLocationsCatalogsServingConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15265,9 +15594,9 @@ type ProjectsLocationsCatalogsServingConfigsGetCall struct {
// Get: Gets a ServingConfig. Returns a NotFound error if the
// ServingConfig does not exist.
//
-// - name: The resource name of the ServingConfig to get. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - name: The resource name of the ServingConfig to get. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) Get(name string) *ProjectsLocationsCatalogsServingConfigsGetCall {
c := &ProjectsLocationsCatalogsServingConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15414,9 +15743,9 @@ type ProjectsLocationsCatalogsServingConfigsListCall struct {
// List: Lists all ServingConfigs linked to this catalog.
//
-// - parent: The catalog resource name. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}.
+// - parent: The catalog resource name. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) List(parent string) *ProjectsLocationsCatalogsServingConfigsListCall {
c := &ProjectsLocationsCatalogsServingConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15612,8 +15941,8 @@ type ProjectsLocationsCatalogsServingConfigsPatchCall struct {
// Patch: Updates a ServingConfig.
//
-// - name: Immutable. Fully qualified name
-// `projects/*/locations/global/catalogs/*/servingConfig/*`.
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/global/catalogs/*/servingConfig/*`.
func (r *ProjectsLocationsCatalogsServingConfigsService) Patch(name string, googlecloudretailv2alphaservingconfig *GoogleCloudRetailV2alphaServingConfig) *ProjectsLocationsCatalogsServingConfigsPatchCall {
c := &ProjectsLocationsCatalogsServingConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15771,19 +16100,19 @@ type ProjectsLocationsCatalogsServingConfigsPredictCall struct {
// Predict: Makes a recommendation prediction.
//
-// - placement: Full resource name of the format:
-// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
-// vingConfigs/*}` or
-// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
-// cements/*}`. We recommend using the `servingConfigs` resource.
-// `placements` is a legacy resource. The ID of the Recommendations AI
-// serving config or placement. Before you can request predictions
-// from your model, you must create at least one serving config or
-// placement for it. For more information, see [Managing serving
-// configurations]
-// (https://cloud.google.com/retail/docs/manage-configs). The full
-// list of available serving configs can be seen at
-// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
+// - placement: Full resource name of the format:
+// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
+// vingConfigs/*}` or
+// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
+// cements/*}`. We recommend using the `servingConfigs` resource.
+// `placements` is a legacy resource. The ID of the Recommendations AI
+// serving config or placement. Before you can request predictions
+// from your model, you must create at least one serving config or
+// placement for it. For more information, see [Managing serving
+// configurations]
+// (https://cloud.google.com/retail/docs/manage-configs). The full
+// list of available serving configs can be seen at
+// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
func (r *ProjectsLocationsCatalogsServingConfigsService) Predict(placement string, googlecloudretailv2alphapredictrequest *GoogleCloudRetailV2alphaPredictRequest) *ProjectsLocationsCatalogsServingConfigsPredictCall {
c := &ProjectsLocationsCatalogsServingConfigsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -15928,9 +16257,9 @@ type ProjectsLocationsCatalogsServingConfigsRemoveControlCall struct {
// control is removed from the ServingConfig. Returns a NOT_FOUND error
// if the Control is not enabled for the ServingConfig.
//
-// - servingConfig: The source ServingConfig resource name . Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - servingConfig: The source ServingConfig resource name . Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) RemoveControl(servingConfig string, googlecloudretailv2alpharemovecontrolrequest *GoogleCloudRetailV2alphaRemoveControlRequest) *ProjectsLocationsCatalogsServingConfigsRemoveControlCall {
c := &ProjectsLocationsCatalogsServingConfigsRemoveControlCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.servingConfig = servingConfig
@@ -16075,15 +16404,15 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct {
// who have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - placement: The resource name of the Retail Search serving config,
-// such as
-// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
-// /default_serving_config` or the name of the legacy placement
-// resource, such as
-// `projects/*/locations/global/catalogs/default_catalog/placements/def
-// ault_search`. This field is used to identify the serving
-// configuration name and the set of models that will be used to make
-// the search.
+// - placement: The resource name of the Retail Search serving config,
+// such as
+// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
+// /default_serving_config` or the name of the legacy placement
+// resource, such as
+// `projects/*/locations/global/catalogs/default_catalog/placements/def
+// ault_search`. This field is used to identify the serving
+// configuration name and the set of models that will be used to make
+// the search.
func (r *ProjectsLocationsCatalogsServingConfigsService) Search(placement string, googlecloudretailv2alphasearchrequest *GoogleCloudRetailV2alphaSearchRequest) *ProjectsLocationsCatalogsServingConfigsSearchCall {
c := &ProjectsLocationsCatalogsServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -16250,8 +16579,8 @@ type ProjectsLocationsCatalogsUserEventsCollectCall struct {
// domain. This method is used only by the Retail API JavaScript pixel
// and Google Tag Manager. Users should not call this method directly.
//
-// - parent: The parent catalog name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Collect(parent string) *ProjectsLocationsCatalogsUserEventsCollectCall {
c := &ProjectsLocationsCatalogsUserEventsCollectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16437,10 +16766,10 @@ type ProjectsLocationsCatalogsUserEventsImportCall struct {
// Import: Bulk import of User events. Request processing might be
// synchronous. Events that already exist are skipped. Use this method
-// for backfilling historical user events. Operation.response is of type
-// ImportResponse. Note that it is possible for a subset of the items to
-// be successfully inserted. Operation.metadata is of type
-// ImportMetadata.
+// for backfilling historical user events. `Operation.response` is of
+// type `ImportResponse`. Note that it is possible for a subset of the
+// items to be successfully inserted. `Operation.metadata` is of type
+// `ImportMetadata`.
//
// - parent: `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Import(parent string, googlecloudretailv2alphaimportusereventsrequest *GoogleCloudRetailV2alphaImportUserEventsRequest) *ProjectsLocationsCatalogsUserEventsImportCall {
@@ -16541,7 +16870,7 @@ func (c *ProjectsLocationsCatalogsUserEventsImportCall) Do(opts ...googleapi.Cal
}
return ret, nil
// {
- // "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+ // "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.",
// "flatPath": "v2alpha/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:import",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.userEvents.import",
@@ -16587,9 +16916,9 @@ type ProjectsLocationsCatalogsUserEventsPurgeCall struct {
// this operation could take hours or days to complete. To test a
// filter, use the list command first.
//
-// - parent: The resource name of the catalog under which the events are
-// created. The format is
-// `projects/${projectId}/locations/global/catalogs/${catalogId}`.
+// - parent: The resource name of the catalog under which the events are
+// created. The format is
+// `projects/${projectId}/locations/global/catalogs/${catalogId}`.
func (r *ProjectsLocationsCatalogsUserEventsService) Purge(parent string, googlecloudretailv2alphapurgeusereventsrequest *GoogleCloudRetailV2alphaPurgeUserEventsRequest) *ProjectsLocationsCatalogsUserEventsPurgeCall {
c := &ProjectsLocationsCatalogsUserEventsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16739,8 +17068,8 @@ type ProjectsLocationsCatalogsUserEventsRejoinCall struct {
// joined with the wrong product catalog. A rejoin operation can take
// hours or days to complete.
//
-// - parent: The parent catalog resource name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Rejoin(parent string, googlecloudretailv2alpharejoinusereventsrequest *GoogleCloudRetailV2alphaRejoinUserEventsRequest) *ProjectsLocationsCatalogsUserEventsRejoinCall {
c := &ProjectsLocationsCatalogsUserEventsRejoinCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16882,8 +17211,8 @@ type ProjectsLocationsCatalogsUserEventsWriteCall struct {
// Write: Writes a single user event.
//
-// - parent: The parent catalog resource name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Write(parent string, googlecloudretailv2alphauserevent *GoogleCloudRetailV2alphaUserEvent) *ProjectsLocationsCatalogsUserEventsWriteCall {
c := &ProjectsLocationsCatalogsUserEventsWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/retail/v2beta/retail-api.json b/retail/v2beta/retail-api.json
index b7b6aa45b8f..94fd3424619 100644
--- a/retail/v2beta/retail-api.json
+++ b/retail/v2beta/retail-api.json
@@ -441,6 +441,34 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
+ "batchRemoveCatalogAttributes": {
+ "description": "Removes all specified CatalogAttributes from the AttributesConfig.",
+ "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:batchRemoveCatalogAttributes",
+ "httpMethod": "POST",
+ "id": "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes",
+ "parameterOrder": [
+ "attributesConfig"
+ ],
+ "parameters": {
+ "attributesConfig": {
+ "description": "Required. The attributes config resource shared by all catalog attributes being deleted. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v2beta/{+attributesConfig}:batchRemoveCatalogAttributes",
+ "request": {
+ "$ref": "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest"
+ },
+ "response": {
+ "$ref": "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
"removeCatalogAttribute": {
"description": "Removes the specified CatalogAttribute from the AttributesConfig. If the CatalogAttribute to remove does not exist, a NOT_FOUND error is returned.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:removeCatalogAttribute",
@@ -533,7 +561,7 @@
"products": {
"methods": {
"addFulfillmentPlaces": {
- "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces",
@@ -561,7 +589,7 @@
]
},
"addLocalInventories": {
- "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.addLocalInventories",
@@ -786,7 +814,7 @@
]
},
"removeFulfillmentPlaces": {
- "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces",
@@ -814,7 +842,7 @@
]
},
"removeLocalInventories": {
- "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories",
@@ -842,7 +870,7 @@
]
},
"setInventory": {
- "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.branches.products.setInventory",
@@ -1510,7 +1538,7 @@
]
},
"import": {
- "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+ "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.",
"flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:import",
"httpMethod": "POST",
"id": "retail.projects.locations.catalogs.userEvents.import",
@@ -1770,7 +1798,7 @@
}
}
},
- "revision": "20220722",
+ "revision": "20220811",
"rootUrl": "https://retail.googleapis.com/",
"schemas": {
"GoogleApiHttpBody": {
@@ -1966,14 +1994,14 @@
"id": "GoogleCloudRetailV2ImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2ImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2ImportMetadata",
"properties": {
"createTime": {
@@ -1987,7 +2015,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -2277,14 +2305,14 @@
"id": "GoogleCloudRetailV2alphaImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2alphaImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2alphaImportMetadata",
"properties": {
"createTime": {
@@ -2298,7 +2326,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -2310,6 +2338,10 @@
"format": "int64",
"type": "string"
},
+ "transformedUserEventsMetadata": {
+ "$ref": "GoogleCloudRetailV2alphaTransformedUserEventsMetadata",
+ "description": "Metadata related to transform user events."
+ },
"updateTime": {
"description": "Operation last update time. If the operation is done, this is also the finish time.",
"format": "google-datetime",
@@ -2359,7 +2391,7 @@
"type": "object"
},
"GoogleCloudRetailV2alphaModel": {
- "description": "Metadata that describes the training and serving parameters of a Model. A Model can be associated with a ServingConfig and then queried through the Predict api.",
+ "description": "Metadata that describes the training and serving parameters of a Model. A Model can be associated with a ServingConfig and then queried through the Predict API.",
"id": "GoogleCloudRetailV2alphaModel",
"properties": {
"createTime": {
@@ -2369,14 +2401,14 @@
"type": "string"
},
"dataState": {
- "description": "Output only. The state of data requirements for this model: DATA_OK and DATA_ERROR. Recommendation model cannot be trained if the data is in DATA_ERROR state. Recommendation model can have DATA_ERROR state even if serving state is ACTIVE: models were trained successfully before, but cannot be refreshed because model no longer has sufficient data for training.",
+ "description": "Output only. The state of data requirements for this model: `DATA_OK` and `DATA_ERROR`. Recommendation model cannot be trained if the data is in `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even if serving state is `ACTIVE`: models were trained successfully before, but cannot be refreshed because model no longer has sufficient data for training.",
"enum": [
"DATA_STATE_UNSPECIFIED",
"DATA_OK",
"DATA_ERROR"
],
"enumDescriptions": [
- "Unspecified default value - should never be explicitly set.",
+ "Unspecified default value, should never be explicitly set.",
"The model has sufficient training data.",
"The model does not have sufficient training data. Error messages can be queried via Stackdriver."
],
@@ -2384,18 +2416,18 @@
"type": "string"
},
"displayName": {
- "description": "Required. The display name of the model. Should be human readable, used to display Recommendation Models in the Retail Pantheon Dashboard. UTF-8 encoded string with limit of 1024 characters.",
+ "description": "Required. The display name of the model. Should be human readable, used to display Recommendation Models in the Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024 characters.",
"type": "string"
},
"filteringOption": {
- "description": "Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by attributes is enabled for the model.",
+ "description": "Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering by attributes is enabled for the model.",
"enum": [
"RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED",
"RECOMMENDATIONS_FILTERING_DISABLED",
"RECOMMENDATIONS_FILTERING_ENABLED"
],
"enumDescriptions": [
- "Value used when unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
+ "Value used when unset. In this case, server behavior defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
"Recommendation filtering is disabled.",
"Recommendation filtering is enabled."
],
@@ -2408,7 +2440,7 @@
"type": "string"
},
"name": {
- "description": "Required. The fully qualified resource name of the model. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
+ "description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` catalog_id has char limit of 50. recommendation_model_id has char limit of 40.",
"type": "string"
},
"optimizationObjective": {
@@ -2420,7 +2452,7 @@
"description": "Optional. The page optimization config."
},
"periodicTuningState": {
- "description": "Optional. The state of periodic tuning. The period we use is 3 months - to do a one-off tune earlier use the TuneModel method. Default value is PERIODIC_TUNING_ENABLED.",
+ "description": "Optional. The state of periodic tuning. The period we use is 3 months - to do a one-off tune earlier use the `TuneModel` method. Default value is `PERIODIC_TUNING_ENABLED`.",
"enum": [
"PERIODIC_TUNING_STATE_UNSPECIFIED",
"PERIODIC_TUNING_DISABLED",
@@ -2428,10 +2460,10 @@
"PERIODIC_TUNING_ENABLED"
],
"enumDescriptions": [
- "Unspecified default value - should never be explicitly set.",
- "The model has periodic tuning disabled. Tuning can be reenabled by calling the EnableModelPeriodicTuning method or by calling the TuneModel method.",
- "The model cannot be tuned with periodic tuning OR the TuneModel method. Hide the options in customer UI and reject any requests through the backend self serve API.",
- "The model has periodic tuning enabled. Tuning can be disabled by calling the DisableModelPeriodicTuning method."
+ "Unspecified default value, should never be explicitly set.",
+ "The model has periodic tuning disabled. Tuning can be reenabled by calling the `EnableModelPeriodicTuning` method or by calling the `TuneModel` method.",
+ "The model cannot be tuned with periodic tuning OR the `TuneModel` method. Hide the options in customer UI and reject any requests through the backend self serve API.",
+ "The model has periodic tuning enabled. Tuning can be disabled by calling the `DisableModelPeriodicTuning` method."
],
"type": "string"
},
@@ -2444,7 +2476,7 @@
"type": "array"
},
"servingState": {
- "description": "Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.",
+ "description": "Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.",
"enum": [
"SERVING_STATE_UNSPECIFIED",
"INACTIVE",
@@ -2455,13 +2487,13 @@
"Unspecified serving state.",
"The model is not serving.",
"The model is serving and can be queried.",
- "The model is trained on tuned hyperparameters, and can be queried."
+ "The model is trained on tuned hyperparameters and can be queried."
],
"readOnly": true,
"type": "string"
},
"trainingState": {
- "description": "Optional. The training state that the model is in (e.g. TRAINING or PAUSED). Since part of the cost of running the service is frequency of training - this can be used to determine when to train model in order to control cost. If not specified: the default value for CreateModel method is TRAINING. the default value for UpdateModel method is to keep the state the same as before.",
+ "description": "Optional. The training state that the model is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train model in order to control cost. If not specified: the default value for `CreateModel` method is `TRAINING`. The default value for `UpdateModel` method is to keep the state the same as before.",
"enum": [
"TRAINING_STATE_UNSPECIFIED",
"PAUSED",
@@ -2480,7 +2512,7 @@
"type": "string"
},
"type": {
- "description": "Required. The type of model e.g. `home-page`. Currently supported values: `recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `page-optimization`, 'similar-items', 'buy-it-again', `recently-viewed`(readonly value).",
+ "description": "Required. The type of model e.g. `home-page`. Currently supported values: `recommended-for-you`, `others-you-may-like`, `frequently-bought-together`, `page-optimization`, `similar-items`, `buy-it-again`, and `recently-viewed`(readonly value).",
"type": "string"
},
"updateTime": {
@@ -2519,9 +2551,9 @@
"enumDescriptions": [
"Unspecified value for restriction.",
"Allow any ServingConfig to be show on any number of panels. Example: `Panel1 candidates`: pdp_ctr, pdp_cvr, home_page_ctr_no_diversity `Panel2 candidates`: home_page_ctr_no_diversity, home_page_ctr_diversity, pdp_cvr_no_diversity `Restriction` = NO_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: []",
- "Do not allow the same ServingConfig.name to be shown on multiple panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_SERVING_CONFIG_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *",
- "Do not allow multiple ServingConfigs with same Model.name to be show on on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) *",
- "Do not allow multiple ServingConfigs with same Model.type to be shown on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) *"
+ "Do not allow the same ServingConfig.name to be shown on multiple panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_SERVING_CONFIG_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *",
+ "Do not allow multiple ServingConfigs with same Model.name to be show on on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) *",
+ "Do not allow multiple ServingConfigs with same Model.type to be shown on different panels. Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2 candidates`: * home_page_ctr_no_diversity, home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low) * (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid combinations`: * * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_no_diversity) * (home_page_ctr_no_diversity, home_page_ctr_diversity) *"
],
"type": "string"
}
@@ -2533,7 +2565,7 @@
"id": "GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate",
"properties": {
"servingConfigId": {
- "description": "This has to be a valid ServingConfig identifier. e.g. for a ServingConfig with full name: `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config` this would be 'my_candidate_config'",
+ "description": "This has to be a valid ServingConfig identifier. For example, for a ServingConfig with full name: `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`, this would be `my_candidate_config`.",
"type": "string"
}
},
@@ -2552,7 +2584,7 @@
},
"defaultCandidate": {
"$ref": "GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate",
- "description": "Required. The default candidate (in case the model fails at serving time, we can fall back to the default)."
+ "description": "Required. The default candidate. If the model fails at serving time, we fall back to the default."
},
"displayName": {
"description": "Optional. The name to display for the panel.",
@@ -2562,11 +2594,11 @@
"type": "object"
},
"GoogleCloudRetailV2alphaModelServingConfigList": {
- "description": "Represents an ordered combination of valid serving configs, which / may be used for PAGE_OPTIMIZATION recommendations.",
+ "description": "Represents an ordered combination of valid serving configs, which can be used for `PAGE_OPTIMIZATION` recommendations.",
"id": "GoogleCloudRetailV2alphaModelServingConfigList",
"properties": {
"servingConfigIds": {
- "description": "Optional. A set of valid serving configs that may be used for PAGE_OPTIMIZATION.",
+ "description": "Optional. A set of valid serving configs that may be used for `PAGE_OPTIMIZATION`.",
"items": {
"type": "string"
},
@@ -2707,6 +2739,23 @@
"properties": {},
"type": "object"
},
+ "GoogleCloudRetailV2alphaTransformedUserEventsMetadata": {
+ "description": "Metadata related to transform user events operation.",
+ "id": "GoogleCloudRetailV2alphaTransformedUserEventsMetadata",
+ "properties": {
+ "sourceEventsCount": {
+ "description": "Count of entries in the source user events BigQuery table.",
+ "format": "int64",
+ "type": "string"
+ },
+ "transformedEventsCount": {
+ "description": "Count of entries in the transformed user events BigQuery table, which could be different from the actually imported number of user events.",
+ "format": "int64",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2alphaTuneModelMetadata": {
"description": "Metadata associated with a tune operation.",
"id": "GoogleCloudRetailV2alphaTuneModelMetadata",
@@ -2854,7 +2903,7 @@
"CATALOG_LEVEL_ATTRIBUTE_CONFIG"
],
"enumDescriptions": [
- "Value used when unset. Defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.",
+ "Value used when unset. In this case, server behavior defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.",
"At this level, we honor the attribute configurations set in Product.attributes.",
"At this level, we honor the attribute configurations set in CatalogConfig.attribute_configs."
],
@@ -2896,6 +2945,41 @@
},
"type": "object"
},
+ "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest": {
+ "description": "Request for CatalogService.BatchRemoveCatalogAttributes method.",
+ "id": "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest",
+ "properties": {
+ "attributeKeys": {
+ "description": "Required. The attribute name keys of the CatalogAttributes to delete. A maximum of 1000 catalog attributes can be deleted in a batch.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse": {
+ "description": "Response of the CatalogService.BatchRemoveCatalogAttributes.",
+ "id": "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse",
+ "properties": {
+ "deletedCatalogAttributes": {
+ "description": "Catalog attributes that were deleted. Only attributes that are not in use by products can be deleted.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "resetCatalogAttributes": {
+ "description": "Catalog attributes that were reset. Attributes that are in use by products cannot be deleted, however their configuration properties will reset to default values upon removal request.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
"GoogleCloudRetailV2betaBigQueryOutputResult": {
"description": "A BigQuery output result.",
"id": "GoogleCloudRetailV2betaBigQueryOutputResult",
@@ -2916,7 +3000,7 @@
"id": "GoogleCloudRetailV2betaBigQuerySource",
"properties": {
"dataSchema": {
- "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: The schema is available here: https://support.google.com/analytics/answer/3437719. * `user_event_ga4`: This feature is in private preview. Please contact the support team for importing Google Analytics 4 events. The schema is available here: https://support.google.com/analytics/answer/7029846. Supported values for auto-completion imports: * `suggestions` (default): One JSON completion suggestion per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One JSON allow suggestion per line.",
+ "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: The schema is available here: https://support.google.com/analytics/answer/3437719. * `user_event_ga4`: The schema is available here: https://support.google.com/analytics/answer/7029846. Supported values for auto-completion imports: * `suggestions` (default): One JSON completion suggestion per line. * `denylist`: One JSON deny suggestion per line. * `allowlist`: One JSON allow suggestion per line.",
"type": "string"
},
"datasetId": {
@@ -2929,7 +3013,7 @@
},
"partitionDate": {
"$ref": "GoogleTypeDate",
- "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`."
+ "description": "BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format. Only supported in ImportProductsRequest."
},
"projectId": {
"description": "The project ID (can be project # or ID) that the BigQuery source is in with a length limit of 128 characters. If not specified, inherits the project ID from the parent request.",
@@ -2983,6 +3067,20 @@
],
"type": "string"
},
+ "exactSearchableOption": {
+ "description": "If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable.",
+ "enum": [
+ "EXACT_SEARCHABLE_OPTION_UNSPECIFIED",
+ "EXACT_SEARCHABLE_ENABLED",
+ "EXACT_SEARCHABLE_DISABLED"
+ ],
+ "enumDescriptions": [
+ "Value used when unset. Defaults to EXACT_SEARCHABLE_DISABLED.",
+ "Exact searchable option enabled for an attribute.",
+ "Exact searchable option disabled for an attribute."
+ ],
+ "type": "string"
+ },
"inUse": {
"description": "Output only. Indicates whether this attribute has been used by any products. `True` if at least one Product is using this attribute in Product.attributes. Otherwise, this field is `False`. CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, CatalogService.ImportCatalogAttributes, or CatalogService.UpdateAttributesConfig APIs. This field is `False` for pre-loaded CatalogAttributes. Only pre-loaded CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined cannot be deleted; however, their configuration properties will reset to default values upon removal request. After catalog changes, it takes about 10 minutes for this field to update.",
"readOnly": true,
@@ -3014,7 +3112,7 @@
"RECOMMENDATIONS_FILTERING_ENABLED"
],
"enumDescriptions": [
- "Value used when unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
+ "Value used when unset. In this case, server behavior defaults to RECOMMENDATIONS_FILTERING_DISABLED.",
"Recommendation filtering is disabled.",
"Recommendation filtering is enabled."
],
@@ -3089,7 +3187,7 @@
"type": "array"
},
"recentSearchResults": {
- "description": "Matched recent searches of this user. The maximum number of recent searches is 10. This field is a restricted feature. Contact Retail Search support team if you are interested in enabling it. This feature is only available when CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The recent searches satisfy the follow rules: * They are ordered from latest to oldest. * They are matched with CompleteQueryRequest.query case insensitively. * They are transformed to lower cases. * They are UTF-8 safe. Recent searches are deduplicated. More recent searches will be reserved when duplication happens.",
+ "description": "Matched recent searches of this user. The maximum number of recent searches is 10. This field is a restricted feature. Contact Retail Search support team if you are interested in enabling it. This feature is only available when CompleteQueryRequest.visitor_id field is set and UserEvent is imported. The recent searches satisfy the follow rules: * They are ordered from latest to oldest. * They are matched with CompleteQueryRequest.query case insensitively. * They are transformed to lower case. * They are UTF-8 safe. Recent searches are deduplicated. More recent searches will be reserved when duplication happens.",
"items": {
"$ref": "GoogleCloudRetailV2betaCompleteQueryResponseRecentSearchResult"
},
@@ -3165,12 +3263,12 @@
"type": "string"
},
"maxSuggestions": {
- "description": "The maximum number of autocomplete suggestions returned per term. The maximum allowed max suggestions is 20. Default value is 20. If left unset or set to 0, then will fallback to default value.",
+ "description": "The maximum number of autocomplete suggestions returned per term. Default value is 20. If left unset or set to 0, then will fallback to default value. Value range is 1 to 20.",
"format": "int32",
"type": "integer"
},
"minPrefixLength": {
- "description": "The minimum number of characters needed to be typed in order to get suggestions. Default value is 2. If left unset or set to 0, then will fallback to default value.",
+ "description": "The minimum number of characters needed to be typed in order to get suggestions. Default value is 2. If left unset or set to 0, then will fallback to default value. Value range is 1 to 20.",
"format": "int32",
"type": "integer"
},
@@ -3439,11 +3537,11 @@
"type": "object"
},
"GoogleCloudRetailV2betaGcsSource": {
- "description": "Google Cloud Storage location for input content. format.",
+ "description": "Google Cloud Storage location for input content.",
"id": "GoogleCloudRetailV2betaGcsSource",
"properties": {
"dataSchema": {
- "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: Using https://support.google.com/analytics/answer/3437719. Supported values for control imports: * 'control' (default): One JSON Control per line. Supported values for catalog attribute imports: * 'catalog_attribute' (default): One CSV CatalogAttribute per line.",
+ "description": "The schema to use when parsing the data from the source. Supported values for product imports: * `product` (default): One JSON Product per line. Each product must have a valid Product.id. * `product_merchant_center`: See [Importing catalog data from Merchant Center](https://cloud.google.com/retail/recommendations-ai/docs/upload-catalog#mc). Supported values for user events imports: * `user_event` (default): One JSON UserEvent per line. * `user_event_ga360`: Using https://support.google.com/analytics/answer/3437719. Supported values for control imports: * `control` (default): One JSON Control per line. Supported values for catalog attribute imports: * `catalog_attribute` (default): One CSV CatalogAttribute per line.",
"type": "string"
},
"inputUris": {
@@ -3506,7 +3604,7 @@
"description": "Required. The desired input location of the data."
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
}
},
@@ -3531,14 +3629,14 @@
"id": "GoogleCloudRetailV2betaImportErrorsConfig",
"properties": {
"gcsPrefix": {
- "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors will be written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
+ "description": "Google Cloud Storage prefix for import errors. This must be an empty, existing Cloud Storage directory. Import errors are written to sharded files in this directory, one per line, as a JSON-encoded `google.rpc.Status` message.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudRetailV2betaImportMetadata": {
- "description": "Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.",
+ "description": "Metadata related to the progress of the Import operation. This is returned by the google.longrunning.Operation.metadata field.",
"id": "GoogleCloudRetailV2betaImportMetadata",
"properties": {
"createTime": {
@@ -3552,7 +3650,7 @@
"type": "string"
},
"notificationPubsubTopic": {
- "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
+ "description": "Pub/Sub topic for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.",
"type": "string"
},
"requestId": {
@@ -3585,7 +3683,7 @@
"description": "Required. The desired input location of the data."
},
"notificationPubsubTopic": {
- "description": "Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification will be sent to specified Pub/Sub topic. The message data will be JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that both `cloud-retail-customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on the topic. Only supported when ImportProductsRequest.reconciliation_mode is set to `FULL`.",
+ "description": "Full Pub/Sub topic name for receiving notification. If this field is set, when the import is finished, a notification is sent to specified Pub/Sub topic. The message data is JSON string of a Operation. Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has to be within the same project as ImportProductsRequest.parent. Make sure that `service-@gcp-sa-retail.iam.gserviceaccount.com` has the `pubsub.topics.publish` IAM permission on the topic.",
"type": "string"
},
"reconciliationMode": {
@@ -3598,7 +3696,7 @@
"enumDescriptions": [
"Defaults to INCREMENTAL.",
"Inserts new products or updates existing products.",
- "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location. Can only be set while using BigQuerySource. And the BigQuery dataset must be created in the data location \"us (multiple regions in United States)\", otherwise a PERMISSION_DENIED error is thrown. Add the IAM permission \"BigQuery Data Viewer\" for cloud-retail-customer-data-access@system.gserviceaccount.com before using this feature otherwise an error is thrown."
+ "Calculates diff and replaces the entire product dataset. Existing products may be deleted if they are not present in the source location."
],
"type": "string"
},
@@ -3607,7 +3705,7 @@
"type": "string"
},
"updateMask": {
- "description": "Indicates which fields in the provided imported 'products' to update. If not set, will by default update all fields.",
+ "description": "Indicates which fields in the provided imported `products` to update. If not set, all fields are updated.",
"format": "google-fieldmask",
"type": "string"
}
@@ -3806,7 +3904,7 @@
"type": "string"
},
"destinations": {
- "description": "String representing the destination to import for, all if left empty. List of possible values can be found here. [https://support.google.com/merchants/answer/7501026] List of allowed string values: \"Shopping_ads\", \"Buy_on_google_listings\", \"Display_ads\", \"Local_inventory _ads\", \"Free_listings\", \"Free_local_listings\" NOTE: The string values are case sensitive.",
+ "description": "String representing the destination to import for, all if left empty. List of possible values is given in [Included destination](https://support.google.com/merchants/answer/7501026). List of allowed string values: \"Shopping_ads\", \"Buy_on_google_listings\", \"Display_ads\", \"Local_inventory _ads\", \"Free_listings\", \"Free_local_listings\" NOTE: The string values are case sensitive.",
"items": {
"type": "string"
},
@@ -3872,12 +3970,12 @@
"type": "object"
},
"pageSize": {
- "description": "Maximum number of results to return per page. Set this property to the number of prediction results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
+ "description": "Maximum number of results to return. Set this property to the number of prediction results needed. If zero, the service will choose a reasonable default. The maximum allowed value is 100. Values above 100 will be coerced to 100.",
"format": "int32",
"type": "integer"
},
"pageToken": {
- "description": "This field is not used for now, leave it unset.",
+ "description": "This field is not used; leave it unset.",
"type": "string"
},
"params": {
@@ -4059,7 +4157,7 @@
"type": "array"
},
"collectionMemberIds": {
- "description": "The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.",
+ "description": "The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.",
"items": {
"type": "string"
},
@@ -4614,7 +4712,7 @@
"type": "object"
},
"GoogleCloudRetailV2betaRuleFilterAction": {
- "description": "* Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided is combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query's existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter.",
+ "description": "* Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query's existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter.",
"id": "GoogleCloudRetailV2betaRuleFilterAction",
"properties": {
"filter": {
@@ -4953,6 +5051,10 @@
"type": "string"
},
"type": "array"
+ },
+ "returnMinMax": {
+ "description": "Returns the min and max value for each numerical facet intervals. Ignored for textual facets.",
+ "type": "boolean"
}
},
"type": "object"
@@ -4969,8 +5071,8 @@
"DISABLED"
],
"enumDescriptions": [
- "Default value. Defaults to Mode.AUTO.",
- "Let CRS decide whether to use personalization.",
+ "Default value. In this case, server behavior defaults to Mode.AUTO.",
+ "Let CRS decide whether to use personalization based on quality of user event data.",
"Disable personalization."
],
"type": "string"
@@ -4990,7 +5092,7 @@
"AUTO"
],
"enumDescriptions": [
- "Unspecified query expansion condition. This defaults to Condition.DISABLED.",
+ "Unspecified query expansion condition. In this case, server behavior defaults to Condition.DISABLED.",
"Disabled query expansion. Only the exact search query is used, even if SearchResponse.total_size is zero.",
"Automatic query expansion built by Google Retail Search."
],
@@ -5015,7 +5117,7 @@
"AUTO"
],
"enumDescriptions": [
- "Unspecified spell correction mode. This defaults to Mode.AUTO.",
+ "Unspecified spell correction mode. In this case, server behavior defaults to Mode.AUTO.",
"Google Retail Search will try to find a spell suggestion if there is any and put in the SearchResponse.corrected_query. The spell suggestion will not be used as the search query.",
"Automatic spell correction built by Google Retail Search. Search will be based on the corrected query if found."
],
@@ -5119,6 +5221,16 @@
"$ref": "GoogleCloudRetailV2betaInterval",
"description": "Interval value for a facet, such as [10, 20) for facet \"price\"."
},
+ "maxValue": {
+ "description": "The maximum value in the FacetValue.interval. Only supported on numerical facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.",
+ "format": "double",
+ "type": "number"
+ },
+ "minValue": {
+ "description": "The minimum value in the FacetValue.interval. Only supported on numerical facets and returned if SearchRequest.FacetSpec.FacetKey.return_min_max is true.",
+ "format": "double",
+ "type": "number"
+ },
"value": {
"description": "Text value of a facet, such as \"Black\" for facet \"colorFamilies\".",
"type": "string"
@@ -5163,6 +5275,13 @@
"description": "If a variant Product matches the search query, this map indicates which Product fields are matched. The key is the Product.name, the value is a field mask of the matched Product fields. If matched attributes cannot be determined, this map will be empty. For example, a key \"sku1\" with field mask \"products.color_info\" indicates there is a match between \"sku1\" ColorInfo and the query.",
"type": "object"
},
+ "personalLabels": {
+ "description": "Specifies previous events related to this product for this user based on UserEvent with same SearchRequest.visitor_id or UserInfo.user_id. This is set only when SearchRequest.PersonalizationSpec.mode is SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: * `purchased`: Indicates that this product has been purchased before.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
"product": {
"$ref": "GoogleCloudRetailV2betaProduct",
"description": "The product data snippet in the search response. Only Product.name is guaranteed to be populated. Product.variants contains the product variants that match the search query. If there are multiple product variants matching the query, top 5 most relevant product variants are returned and ordered by relevancy. If relevancy can be deternmined, use matching_variant_fields to look up matched product variants fields. If relevancy cannot be determined, e.g. when searching \"shoe\" all products in a shoe product can be a match, 5 product variants are returned but order is meaningless."
diff --git a/retail/v2beta/retail-gen.go b/retail/v2beta/retail-gen.go
index fa685ba0b64..9169317a0a6 100644
--- a/retail/v2beta/retail-gen.go
+++ b/retail/v2beta/retail-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/recommendations
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/retail/v2beta"
-// ...
-// ctx := context.Background()
-// retailService, err := retail.NewService(ctx)
+// import "google.golang.org/api/retail/v2beta"
+// ...
+// ctx := context.Background()
+// retailService, err := retail.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// retailService, err := retail.NewService(ctx, option.WithAPIKey("AIza..."))
+// retailService, err := retail.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// retailService, err := retail.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// retailService, err := retail.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package retail // import "google.golang.org/api/retail/v2beta"
@@ -671,7 +671,7 @@ func (s *GoogleCloudRetailV2ImportCompletionDataResponse) MarshalJSON() ([]byte,
// for Import related errors.
type GoogleCloudRetailV2ImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -700,7 +700,7 @@ func (s *GoogleCloudRetailV2ImportErrorsConfig) MarshalJSON() ([]byte, error) {
}
// GoogleCloudRetailV2ImportMetadata: Metadata related to the progress
-// of the Import operation. This will be returned by the
+// of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2ImportMetadata struct {
// CreateTime: Operation create time.
@@ -711,9 +711,9 @@ type GoogleCloudRetailV2ImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -1255,7 +1255,7 @@ func (s *GoogleCloudRetailV2alphaImportCompletionDataResponse) MarshalJSON() ([]
// destination for Import related errors.
type GoogleCloudRetailV2alphaImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -1284,7 +1284,7 @@ func (s *GoogleCloudRetailV2alphaImportErrorsConfig) MarshalJSON() ([]byte, erro
}
// GoogleCloudRetailV2alphaImportMetadata: Metadata related to the
-// progress of the Import operation. This will be returned by the
+// progress of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2alphaImportMetadata struct {
// CreateTime: Operation create time.
@@ -1295,9 +1295,9 @@ type GoogleCloudRetailV2alphaImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -1307,6 +1307,10 @@ type GoogleCloudRetailV2alphaImportMetadata struct {
// SuccessCount: Count of entries that were processed successfully.
SuccessCount int64 `json:"successCount,omitempty,string"`
+ // TransformedUserEventsMetadata: Metadata related to transform user
+ // events.
+ TransformedUserEventsMetadata *GoogleCloudRetailV2alphaTransformedUserEventsMetadata `json:"transformedUserEventsMetadata,omitempty"`
+
// UpdateTime: Operation last update time. If the operation is done,
// this is also the finish time.
UpdateTime string `json:"updateTime,omitempty"`
@@ -1413,21 +1417,21 @@ func (s *GoogleCloudRetailV2alphaImportUserEventsResponse) MarshalJSON() ([]byte
// GoogleCloudRetailV2alphaModel: Metadata that describes the training
// and serving parameters of a Model. A Model can be associated with a
-// ServingConfig and then queried through the Predict api.
+// ServingConfig and then queried through the Predict API.
type GoogleCloudRetailV2alphaModel struct {
// CreateTime: Output only. Timestamp the Recommendation Model was
// created at.
CreateTime string `json:"createTime,omitempty"`
// DataState: Output only. The state of data requirements for this
- // model: DATA_OK and DATA_ERROR. Recommendation model cannot be trained
- // if the data is in DATA_ERROR state. Recommendation model can have
- // DATA_ERROR state even if serving state is ACTIVE: models were trained
- // successfully before, but cannot be refreshed because model no longer
- // has sufficient data for training.
+ // model: `DATA_OK` and `DATA_ERROR`. Recommendation model cannot be
+ // trained if the data is in `DATA_ERROR` state. Recommendation model
+ // can have `DATA_ERROR` state even if serving state is `ACTIVE`: models
+ // were trained successfully before, but cannot be refreshed because
+ // model no longer has sufficient data for training.
//
// Possible values:
- // "DATA_STATE_UNSPECIFIED" - Unspecified default value - should never
+ // "DATA_STATE_UNSPECIFIED" - Unspecified default value, should never
// be explicitly set.
// "DATA_OK" - The model has sufficient training data.
// "DATA_ERROR" - The model does not have sufficient training data.
@@ -1435,17 +1439,18 @@ type GoogleCloudRetailV2alphaModel struct {
DataState string `json:"dataState,omitempty"`
// DisplayName: Required. The display name of the model. Should be human
- // readable, used to display Recommendation Models in the Retail
- // Pantheon Dashboard. UTF-8 encoded string with limit of 1024
+ // readable, used to display Recommendation Models in the Retail Cloud
+ // Console Dashboard. UTF-8 encoded string with limit of 1024
// characters.
DisplayName string `json:"displayName,omitempty"`
- // FilteringOption: Optional. If RECOMMENDATIONS_FILTERING_ENABLED,
+ // FilteringOption: Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`,
// recommendation filtering by attributes is enabled for the model.
//
// Possible values:
// "RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED" - Value used when
- // unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.
+ // unset. In this case, server behavior defaults to
+ // RECOMMENDATIONS_FILTERING_DISABLED.
// "RECOMMENDATIONS_FILTERING_DISABLED" - Recommendation filtering is
// disabled.
// "RECOMMENDATIONS_FILTERING_ENABLED" - Recommendation filtering is
@@ -1458,8 +1463,8 @@ type GoogleCloudRetailV2alphaModel struct {
// Name: Required. The fully qualified resource name of the model.
// Format:
- // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id
- // }/models/{model_id} catalog_id has char limit of 50.
+ // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_i
+ // d}/models/{model_id}` catalog_id has char limit of 50.
// recommendation_model_id has char limit of 40.
Name string `json:"name,omitempty"`
@@ -1476,19 +1481,20 @@ type GoogleCloudRetailV2alphaModel struct {
// PeriodicTuningState: Optional. The state of periodic tuning. The
// period we use is 3 months - to do a one-off tune earlier use the
- // TuneModel method. Default value is PERIODIC_TUNING_ENABLED.
+ // `TuneModel` method. Default value is `PERIODIC_TUNING_ENABLED`.
//
// Possible values:
- // "PERIODIC_TUNING_STATE_UNSPECIFIED" - Unspecified default value -
+ // "PERIODIC_TUNING_STATE_UNSPECIFIED" - Unspecified default value,
// should never be explicitly set.
// "PERIODIC_TUNING_DISABLED" - The model has periodic tuning
// disabled. Tuning can be reenabled by calling the
- // EnableModelPeriodicTuning method or by calling the TuneModel method.
+ // `EnableModelPeriodicTuning` method or by calling the `TuneModel`
+ // method.
// "ALL_TUNING_DISABLED" - The model cannot be tuned with periodic
- // tuning OR the TuneModel method. Hide the options in customer UI and
+ // tuning OR the `TuneModel` method. Hide the options in customer UI and
// reject any requests through the backend self serve API.
// "PERIODIC_TUNING_ENABLED" - The model has periodic tuning enabled.
- // Tuning can be disabled by calling the DisableModelPeriodicTuning
+ // Tuning can be disabled by calling the `DisableModelPeriodicTuning`
// method.
PeriodicTuningState string `json:"periodicTuningState,omitempty"`
@@ -1496,23 +1502,24 @@ type GoogleCloudRetailV2alphaModel struct {
// associated with the PageOptimizationConfig.
ServingConfigLists []*GoogleCloudRetailV2alphaModelServingConfigList `json:"servingConfigLists,omitempty"`
- // ServingState: Output only. The serving state of the model: ACTIVE,
- // NOT_ACTIVE.
+ // ServingState: Output only. The serving state of the model: `ACTIVE`,
+ // `NOT_ACTIVE`.
//
// Possible values:
// "SERVING_STATE_UNSPECIFIED" - Unspecified serving state.
// "INACTIVE" - The model is not serving.
// "ACTIVE" - The model is serving and can be queried.
- // "TUNED" - The model is trained on tuned hyperparameters, and can be
+ // "TUNED" - The model is trained on tuned hyperparameters and can be
// queried.
ServingState string `json:"servingState,omitempty"`
// TrainingState: Optional. The training state that the model is in
- // (e.g. TRAINING or PAUSED). Since part of the cost of running the
+ // (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the
// service is frequency of training - this can be used to determine when
// to train model in order to control cost. If not specified: the
- // default value for CreateModel method is TRAINING. the default value
- // for UpdateModel method is to keep the state the same as before.
+ // default value for `CreateModel` method is `TRAINING`. The default
+ // value for `UpdateModel` method is to keep the state the same as
+ // before.
//
// Possible values:
// "TRAINING_STATE_UNSPECIFIED" - Unspecified training state.
@@ -1527,8 +1534,8 @@ type GoogleCloudRetailV2alphaModel struct {
// Type: Required. The type of model e.g. `home-page`. Currently
// supported values: `recommended-for-you`, `others-you-may-like`,
- // `frequently-bought-together`, `page-optimization`, 'similar-items',
- // 'buy-it-again', `recently-viewed`(readonly value).
+ // `frequently-bought-together`, `page-optimization`, `similar-items`,
+ // `buy-it-again`, and `recently-viewed`(readonly value).
Type string `json:"type,omitempty"`
// UpdateTime: Output only. Timestamp the Recommendation Model was last
@@ -1605,21 +1612,21 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfig struct {
// candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity * `Panel2
// candidates`: * home_page_ctr_no_diversity,
// home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` =
- // UNIQUE_SERVING_CONFIG_RESTRICTION `Valid combinations`: * * (pdp_ctr,
- // home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity_low)
- // * (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) *
- // (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr,
- // home_page_ctr_diversity_low) * (pdp_cvr, pdp_cvr_no_diversity) *
- // (home_page_ctr_no_diversity, home_page_ctr_diversity_low) *
- // (home_page_ctr_no_diversity, pdp_cvr_no_diversity) * `Invalid
- // combinations`: * * (home_page_ctr_no_diversity,
- // home_page_ctr_no_diversity) *
+ // `UNIQUE_SERVING_CONFIG_RESTRICTION` `Valid combinations`: * *
+ // (pdp_ctr, home_page_ctr_no_diversity) * (pdp_ctr,
+ // home_page_ctr_diversity_low) * (pdp_ctr, pdp_cvr_no_diversity) *
+ // (pdp_ctr, pdp_cvr_no_diversity) * (pdp_cvr,
+ // home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low)
+ // * (pdp_cvr, pdp_cvr_no_diversity) * (home_page_ctr_no_diversity,
+ // home_page_ctr_diversity_low) * (home_page_ctr_no_diversity,
+ // pdp_cvr_no_diversity) * `Invalid combinations`: * *
+ // (home_page_ctr_no_diversity, home_page_ctr_no_diversity) *
// "UNIQUE_MODEL_RESTRICTION" - Do not allow multiple ServingConfigs
// with same Model.name to be show on on different panels. Example:
// `Panel1 candidates`: * pdp_ctr, pdp_cvr, home_page_ctr_no_diversity *
// `Panel2 candidates`: * home_page_ctr_no_diversity,
// home_page_ctr_diversity_low, pdp_cvr_no_diversity * `Restriction` =
- // UNIQUE_MODEL_RESTRICTION `Valid combinations`: * * (pdp_ctr,
+ // `UNIQUE_MODEL_RESTRICTION` `Valid combinations`: * * (pdp_ctr,
// home_page_ctr_no_diversity) * (pdp_ctr, home_page_ctr_diversity) *
// (pdp_ctr, pdp_cvr_no_diversity) * (pdp_ctr, pdp_cvr_no_diversity) *
// (pdp_cvr, home_page_ctr_no_diversity) * (pdp_cvr,
@@ -1632,7 +1639,7 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfig struct {
// Example: `Panel1 candidates`: * pdp_ctr, pdp_cvr,
// home_page_ctr_no_diversity * `Panel2 candidates`: *
// home_page_ctr_no_diversity, home_page_ctr_diversity_low,
- // pdp_cvr_no_diversity * `Restriction` = UNIQUE_MODEL_RESTRICTION
+ // pdp_cvr_no_diversity * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
// `Valid combinations`: * * (pdp_ctr, home_page_ctr_no_diversity) *
// (pdp_ctr, home_page_ctr_diversity) * (pdp_cvr,
// home_page_ctr_no_diversity) * (pdp_cvr, home_page_ctr_diversity_low)
@@ -1672,10 +1679,10 @@ func (s *GoogleCloudRetailV2alphaModelPageOptimizationConfig) MarshalJSON() ([]b
// candidate to consider for a given panel. Currently only ServingConfig
// are valid candidates.
type GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate struct {
- // ServingConfigId: This has to be a valid ServingConfig identifier.
- // e.g. for a ServingConfig with full name:
+ // ServingConfigId: This has to be a valid ServingConfig identifier. For
+ // example, for a ServingConfig with full name:
// `projects/*/locations/global/catalogs/default_catalog/servingConfigs/m
- // y_candidate_config` this would be 'my_candidate_config'
+ // y_candidate_config`, this would be `my_candidate_config`.
ServingConfigId string `json:"servingConfigId,omitempty"`
// ForceSendFields is a list of field names (e.g. "ServingConfigId") to
@@ -1709,8 +1716,8 @@ type GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel struct {
// = 10.
Candidates []*GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate `json:"candidates,omitempty"`
- // DefaultCandidate: Required. The default candidate (in case the model
- // fails at serving time, we can fall back to the default).
+ // DefaultCandidate: Required. The default candidate. If the model fails
+ // at serving time, we fall back to the default.
DefaultCandidate *GoogleCloudRetailV2alphaModelPageOptimizationConfigCandidate `json:"defaultCandidate,omitempty"`
// DisplayName: Optional. The name to display for the panel.
@@ -1740,11 +1747,11 @@ func (s *GoogleCloudRetailV2alphaModelPageOptimizationConfigPanel) MarshalJSON()
}
// GoogleCloudRetailV2alphaModelServingConfigList: Represents an ordered
-// combination of valid serving configs, which / may be used for
-// PAGE_OPTIMIZATION recommendations.
+// combination of valid serving configs, which can be used for
+// `PAGE_OPTIMIZATION` recommendations.
type GoogleCloudRetailV2alphaModelServingConfigList struct {
// ServingConfigIds: Optional. A set of valid serving configs that may
- // be used for PAGE_OPTIMIZATION.
+ // be used for `PAGE_OPTIMIZATION`.
ServingConfigIds []string `json:"servingConfigIds,omitempty"`
// ForceSendFields is a list of field names (e.g. "ServingConfigIds") to
@@ -1995,6 +2002,42 @@ type GoogleCloudRetailV2alphaSetInventoryMetadata struct {
type GoogleCloudRetailV2alphaSetInventoryResponse struct {
}
+// GoogleCloudRetailV2alphaTransformedUserEventsMetadata: Metadata
+// related to transform user events operation.
+type GoogleCloudRetailV2alphaTransformedUserEventsMetadata struct {
+ // SourceEventsCount: Count of entries in the source user events
+ // BigQuery table.
+ SourceEventsCount int64 `json:"sourceEventsCount,omitempty,string"`
+
+ // TransformedEventsCount: Count of entries in the transformed user
+ // events BigQuery table, which could be different from the actually
+ // imported number of user events.
+ TransformedEventsCount int64 `json:"transformedEventsCount,omitempty,string"`
+
+ // ForceSendFields is a list of field names (e.g. "SourceEventsCount")
+ // to unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "SourceEventsCount") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2alphaTransformedUserEventsMetadata) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2alphaTransformedUserEventsMetadata
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2alphaTuneModelMetadata: Metadata associated with a
// tune operation.
type GoogleCloudRetailV2alphaTuneModelMetadata struct {
@@ -2275,8 +2318,9 @@ type GoogleCloudRetailV2betaAttributesConfig struct {
// this catalog.
//
// Possible values:
- // "ATTRIBUTE_CONFIG_LEVEL_UNSPECIFIED" - Value used when unset.
- // Defaults to CATALOG_LEVEL_ATTRIBUTE_CONFIG.
+ // "ATTRIBUTE_CONFIG_LEVEL_UNSPECIFIED" - Value used when unset. In
+ // this case, server behavior defaults to
+ // CATALOG_LEVEL_ATTRIBUTE_CONFIG.
// "PRODUCT_LEVEL_ATTRIBUTE_CONFIG" - At this level, we honor the
// attribute configurations set in Product.attributes.
// "CATALOG_LEVEL_ATTRIBUTE_CONFIG" - At this level, we honor the
@@ -2375,6 +2419,79 @@ func (s *GoogleCloudRetailV2betaAudience) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest: Request
+// for CatalogService.BatchRemoveCatalogAttributes method.
+type GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest struct {
+ // AttributeKeys: Required. The attribute name keys of the
+ // CatalogAttributes to delete. A maximum of 1000 catalog attributes can
+ // be deleted in a batch.
+ AttributeKeys []string `json:"attributeKeys,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "AttributeKeys") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "AttributeKeys") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
+// GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse: Response
+// of the CatalogService.BatchRemoveCatalogAttributes.
+type GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse struct {
+ // DeletedCatalogAttributes: Catalog attributes that were deleted. Only
+ // attributes that are not in use by products can be deleted.
+ DeletedCatalogAttributes []string `json:"deletedCatalogAttributes,omitempty"`
+
+ // ResetCatalogAttributes: Catalog attributes that were reset.
+ // Attributes that are in use by products cannot be deleted, however
+ // their configuration properties will reset to default values upon
+ // removal request.
+ ResetCatalogAttributes []string `json:"resetCatalogAttributes,omitempty"`
+
+ // ServerResponse contains the HTTP response code and headers from the
+ // server.
+ googleapi.ServerResponse `json:"-"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "DeletedCatalogAttributes") to unconditionally include in API
+ // requests. By default, fields with empty or default values are omitted
+ // from API requests. However, any non-pointer, non-interface field
+ // appearing in ForceSendFields will be sent to the server regardless of
+ // whether the field is empty or not. This may be used to include empty
+ // fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DeletedCatalogAttributes")
+ // to include in API requests with the JSON null value. By default,
+ // fields with empty values are omitted from API requests. However, any
+ // field with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse) MarshalJSON() ([]byte, error) {
+ type NoMethod GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GoogleCloudRetailV2betaBigQueryOutputResult: A BigQuery output
// result.
type GoogleCloudRetailV2betaBigQueryOutputResult struct {
@@ -2419,9 +2536,7 @@ type GoogleCloudRetailV2betaBigQuerySource struct {
// Supported values for user events imports: * `user_event` (default):
// One JSON UserEvent per line. * `user_event_ga360`: The schema is
// available here: https://support.google.com/analytics/answer/3437719.
- // * `user_event_ga4`: This feature is in private preview. Please
- // contact the support team for importing Google Analytics 4 events. The
- // schema is available here:
+ // * `user_event_ga4`: The schema is available here:
// https://support.google.com/analytics/answer/7029846. Supported values
// for auto-completion imports: * `suggestions` (default): One JSON
// completion suggestion per line. * `denylist`: One JSON deny
@@ -2440,8 +2555,7 @@ type GoogleCloudRetailV2betaBigQuerySource struct {
GcsStagingDir string `json:"gcsStagingDir,omitempty"`
// PartitionDate: BigQuery time partitioned table's _PARTITIONDATE in
- // YYYY-MM-DD format. Only supported when
- // ImportProductsRequest.reconciliation_mode is set to `FULL`.
+ // YYYY-MM-DD format. Only supported in ImportProductsRequest.
PartitionDate *GoogleTypeDate `json:"partitionDate,omitempty"`
// ProjectId: The project ID (can be project # or ID) that the BigQuery
@@ -2542,6 +2656,20 @@ type GoogleCloudRetailV2betaCatalogAttribute struct {
// for an attribute.
DynamicFacetableOption string `json:"dynamicFacetableOption,omitempty"`
+ // ExactSearchableOption: If EXACT_SEARCHABLE_ENABLED, attribute values
+ // will be exact searchable. This property only applies to textual
+ // custom attributes and requires indexable set to enabled to enable
+ // exact-searchable.
+ //
+ // Possible values:
+ // "EXACT_SEARCHABLE_OPTION_UNSPECIFIED" - Value used when unset.
+ // Defaults to EXACT_SEARCHABLE_DISABLED.
+ // "EXACT_SEARCHABLE_ENABLED" - Exact searchable option enabled for an
+ // attribute.
+ // "EXACT_SEARCHABLE_DISABLED" - Exact searchable option disabled for
+ // an attribute.
+ ExactSearchableOption string `json:"exactSearchableOption,omitempty"`
+
// InUse: Output only. Indicates whether this attribute has been used by
// any products. `True` if at least one Product is using this attribute
// in Product.attributes. Otherwise, this field is `False`.
@@ -2586,7 +2714,8 @@ type GoogleCloudRetailV2betaCatalogAttribute struct {
//
// Possible values:
// "RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED" - Value used when
- // unset. Defaults to RECOMMENDATIONS_FILTERING_DISABLED.
+ // unset. In this case, server behavior defaults to
+ // RECOMMENDATIONS_FILTERING_DISABLED.
// "RECOMMENDATIONS_FILTERING_DISABLED" - Recommendation filtering is
// disabled.
// "RECOMMENDATIONS_FILTERING_ENABLED" - Recommendation filtering is
@@ -2712,7 +2841,7 @@ type GoogleCloudRetailV2betaCompleteQueryResponse struct {
// imported. The recent searches satisfy the follow rules: * They are
// ordered from latest to oldest. * They are matched with
// CompleteQueryRequest.query case insensitively. * They are transformed
- // to lower cases. * They are UTF-8 safe. Recent searches are
+ // to lower case. * They are UTF-8 safe. Recent searches are
// deduplicated. More recent searches will be reserved when duplication
// happens.
RecentSearchResults []*GoogleCloudRetailV2betaCompleteQueryResponseRecentSearchResult `json:"recentSearchResults,omitempty"`
@@ -2852,14 +2981,13 @@ type GoogleCloudRetailV2betaCompletionConfig struct {
MatchingOrder string `json:"matchingOrder,omitempty"`
// MaxSuggestions: The maximum number of autocomplete suggestions
- // returned per term. The maximum allowed max suggestions is 20. Default
- // value is 20. If left unset or set to 0, then will fallback to default
- // value.
+ // returned per term. Default value is 20. If left unset or set to 0,
+ // then will fallback to default value. Value range is 1 to 20.
MaxSuggestions int64 `json:"maxSuggestions,omitempty"`
// MinPrefixLength: The minimum number of characters needed to be typed
// in order to get suggestions. Default value is 2. If left unset or set
- // to 0, then will fallback to default value.
+ // to 0, then will fallback to default value. Value range is 1 to 20.
MinPrefixLength int64 `json:"minPrefixLength,omitempty"`
// Name: Required. Immutable. Fully qualified name
@@ -3406,7 +3534,7 @@ func (s *GoogleCloudRetailV2betaFulfillmentInfo) MarshalJSON() ([]byte, error) {
}
// GoogleCloudRetailV2betaGcsSource: Google Cloud Storage location for
-// input content. format.
+// input content.
type GoogleCloudRetailV2betaGcsSource struct {
// DataSchema: The schema to use when parsing the data from the source.
// Supported values for product imports: * `product` (default): One JSON
@@ -3417,9 +3545,9 @@ type GoogleCloudRetailV2betaGcsSource struct {
// Supported values for user events imports: * `user_event` (default):
// One JSON UserEvent per line. * `user_event_ga360`: Using
// https://support.google.com/analytics/answer/3437719. Supported values
- // for control imports: * 'control' (default): One JSON Control per
+ // for control imports: * `control` (default): One JSON Control per
// line. Supported values for catalog attribute imports: *
- // 'catalog_attribute' (default): One CSV CatalogAttribute per line.
+ // `catalog_attribute` (default): One CSV CatalogAttribute per line.
DataSchema string `json:"dataSchema,omitempty"`
// InputUris: Required. Google Cloud Storage URIs to input files. URI
@@ -3546,9 +3674,9 @@ type GoogleCloudRetailV2betaImportCompletionDataRequest struct {
InputConfig *GoogleCloudRetailV2betaCompletionDataInputConfig `json:"inputConfig,omitempty"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -3612,7 +3740,7 @@ func (s *GoogleCloudRetailV2betaImportCompletionDataResponse) MarshalJSON() ([]b
// destination for Import related errors.
type GoogleCloudRetailV2betaImportErrorsConfig struct {
// GcsPrefix: Google Cloud Storage prefix for import errors. This must
- // be an empty, existing Cloud Storage directory. Import errors will be
+ // be an empty, existing Cloud Storage directory. Import errors are
// written to sharded files in this directory, one per line, as a
// JSON-encoded `google.rpc.Status` message.
GcsPrefix string `json:"gcsPrefix,omitempty"`
@@ -3641,7 +3769,7 @@ func (s *GoogleCloudRetailV2betaImportErrorsConfig) MarshalJSON() ([]byte, error
}
// GoogleCloudRetailV2betaImportMetadata: Metadata related to the
-// progress of the Import operation. This will be returned by the
+// progress of the Import operation. This is returned by the
// google.longrunning.Operation.metadata field.
type GoogleCloudRetailV2betaImportMetadata struct {
// CreateTime: Operation create time.
@@ -3652,9 +3780,9 @@ type GoogleCloudRetailV2betaImportMetadata struct {
FailureCount int64 `json:"failureCount,omitempty,string"`
// NotificationPubsubTopic: Pub/Sub topic for receiving notification. If
- // this field is set, when the import is finished, a notification will
- // be sent to specified Pub/Sub topic. The message data will be JSON
- // string of a Operation. Format of the Pub/Sub topic is
+ // this field is set, when the import is finished, a notification is
+ // sent to specified Pub/Sub topic. The message data is JSON string of a
+ // Operation. Format of the Pub/Sub topic is
// `projects/{project}/topics/{topic}`.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
@@ -3703,14 +3831,12 @@ type GoogleCloudRetailV2betaImportProductsRequest struct {
// NotificationPubsubTopic: Full Pub/Sub topic name for receiving
// notification. If this field is set, when the import is finished, a
- // notification will be sent to specified Pub/Sub topic. The message
- // data will be JSON string of a Operation. Format of the Pub/Sub topic
- // is `projects/{project}/topics/{topic}`. It has to be within the same
- // project as ImportProductsRequest.parent. Make sure that both
- // `cloud-retail-customer-data-access@system.gserviceaccount.com` and
- // `service-@gcp-sa-retail.iam.gserviceaccount.com` have the
- // `pubsub.topics.publish` IAM permission on the topic. Only supported
- // when ImportProductsRequest.reconciliation_mode is set to `FULL`.
+ // notification is sent to specified Pub/Sub topic. The message data is
+ // JSON string of a Operation. Format of the Pub/Sub topic is
+ // `projects/{project}/topics/{topic}`. It has to be within the same
+ // project as ImportProductsRequest.parent. Make sure that
+ // `service-@gcp-sa-retail.iam.gserviceaccount.com` has the
+ // `pubsub.topics.publish` IAM permission on the topic.
NotificationPubsubTopic string `json:"notificationPubsubTopic,omitempty"`
// ReconciliationMode: The mode of reconciliation between existing
@@ -3722,19 +3848,14 @@ type GoogleCloudRetailV2betaImportProductsRequest struct {
// "INCREMENTAL" - Inserts new products or updates existing products.
// "FULL" - Calculates diff and replaces the entire product dataset.
// Existing products may be deleted if they are not present in the
- // source location. Can only be set while using BigQuerySource. And the
- // BigQuery dataset must be created in the data location "us (multiple
- // regions in United States)", otherwise a PERMISSION_DENIED error is
- // thrown. Add the IAM permission "BigQuery Data Viewer" for
- // cloud-retail-customer-data-access@system.gserviceaccount.com before
- // using this feature otherwise an error is thrown.
+ // source location.
ReconciliationMode string `json:"reconciliationMode,omitempty"`
// RequestId: Deprecated. This field has no effect.
RequestId string `json:"requestId,omitempty"`
// UpdateMask: Indicates which fields in the provided imported
- // 'products' to update. If not set, will by default update all fields.
+ // `products` to update. If not set, all fields are updated.
UpdateMask string `json:"updateMask,omitempty"`
// ForceSendFields is a list of field names (e.g. "ErrorsConfig") to
@@ -4151,11 +4272,12 @@ type GoogleCloudRetailV2betaMerchantCenterLink struct {
BranchId string `json:"branchId,omitempty"`
// Destinations: String representing the destination to import for, all
- // if left empty. List of possible values can be found here.
- // [https://support.google.com/merchants/answer/7501026] List of allowed
- // string values: "Shopping_ads", "Buy_on_google_listings",
- // "Display_ads", "Local_inventory _ads", "Free_listings",
- // "Free_local_listings" NOTE: The string values are case sensitive.
+ // if left empty. List of possible values is given in Included
+ // destination (https://support.google.com/merchants/answer/7501026).
+ // List of allowed string values: "Shopping_ads",
+ // "Buy_on_google_listings", "Display_ads", "Local_inventory _ads",
+ // "Free_listings", "Free_local_listings" NOTE: The string values are
+ // case sensitive.
Destinations []string `json:"destinations,omitempty"`
// LanguageCode: Language of the title/description and other string
@@ -4305,13 +4427,13 @@ type GoogleCloudRetailV2betaPredictRequest struct {
// for more details.
Labels map[string]string `json:"labels,omitempty"`
- // PageSize: Maximum number of results to return per page. Set this
- // property to the number of prediction results needed. If zero, the
- // service will choose a reasonable default. The maximum allowed value
- // is 100. Values above 100 will be coerced to 100.
+ // PageSize: Maximum number of results to return. Set this property to
+ // the number of prediction results needed. If zero, the service will
+ // choose a reasonable default. The maximum allowed value is 100. Values
+ // above 100 will be coerced to 100.
PageSize int64 `json:"pageSize,omitempty"`
- // PageToken: This field is not used for now, leave it unset.
+ // PageToken: This field is not used; leave it unset.
PageToken string `json:"pageToken,omitempty"`
// Params: Additional domain specific parameters for the predictions.
@@ -4670,7 +4792,7 @@ type GoogleCloudRetailV2betaProduct struct {
// CollectionMemberIds: The id of the collection members when type is
// Type.COLLECTION. Non-existent product ids are allowed. The type of
- // the members must be either Type.PRIMARY or Type.VARIANT otherwise and
+ // the members must be either Type.PRIMARY or Type.VARIANT otherwise an
// INVALID_ARGUMENT error is thrown. Should not set it for other types.
// A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT
// error is return.
@@ -5808,10 +5930,10 @@ func (s *GoogleCloudRetailV2betaRuleDoNotAssociateAction) MarshalJSON() ([]byte,
// GoogleCloudRetailV2betaRuleFilterAction: * Rule Condition: - No
// Condition.query_terms provided is a global match. - 1 or more
-// Condition.query_terms provided is combined with OR operator. * Action
-// Input: The request query and filter that are applied to the retrieved
-// products, in addition to any filters already provided with the
-// SearchRequest. The AND operator is used to combine the query's
+// Condition.query_terms provided are combined with OR operator. *
+// Action Input: The request query and filter that are applied to the
+// retrieved products, in addition to any filters already provided with
+// the SearchRequest. The AND operator is used to combine the query's
// existing filters with the filter rule(s). NOTE: May result in 0
// results when filters conflict. * Action Result: Filters the returned
// objects to be ONLY those that passed the filter.
@@ -6526,6 +6648,10 @@ type GoogleCloudRetailV2betaSearchRequestFacetSpecFacetKey struct {
// customFulfillment5
RestrictedValues []string `json:"restrictedValues,omitempty"`
+ // ReturnMinMax: Returns the min and max value for each numerical facet
+ // intervals. Ignored for textual facets.
+ ReturnMinMax bool `json:"returnMinMax,omitempty"`
+
// ForceSendFields is a list of field names (e.g. "CaseInsensitive") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
@@ -6556,8 +6682,10 @@ type GoogleCloudRetailV2betaSearchRequestPersonalizationSpec struct {
// Mode: Defaults to Mode.AUTO.
//
// Possible values:
- // "MODE_UNSPECIFIED" - Default value. Defaults to Mode.AUTO.
- // "AUTO" - Let CRS decide whether to use personalization.
+ // "MODE_UNSPECIFIED" - Default value. In this case, server behavior
+ // defaults to Mode.AUTO.
+ // "AUTO" - Let CRS decide whether to use personalization based on
+ // quality of user event data.
// "DISABLED" - Disable personalization.
Mode string `json:"mode,omitempty"`
@@ -6591,8 +6719,8 @@ type GoogleCloudRetailV2betaSearchRequestQueryExpansionSpec struct {
// Default to Condition.DISABLED.
//
// Possible values:
- // "CONDITION_UNSPECIFIED" - Unspecified query expansion condition.
- // This defaults to Condition.DISABLED.
+ // "CONDITION_UNSPECIFIED" - Unspecified query expansion condition. In
+ // this case, server behavior defaults to Condition.DISABLED.
// "DISABLED" - Disabled query expansion. Only the exact search query
// is used, even if SearchResponse.total_size is zero.
// "AUTO" - Automatic query expansion built by Google Retail Search.
@@ -6633,8 +6761,8 @@ type GoogleCloudRetailV2betaSearchRequestSpellCorrectionSpec struct {
// replace the original search query. Default to Mode.AUTO.
//
// Possible values:
- // "MODE_UNSPECIFIED" - Unspecified spell correction mode. This
- // defaults to Mode.AUTO.
+ // "MODE_UNSPECIFIED" - Unspecified spell correction mode. In this
+ // case, server behavior defaults to Mode.AUTO.
// "SUGGESTION_ONLY" - Google Retail Search will try to find a spell
// suggestion if there is any and put in the
// SearchResponse.corrected_query. The spell suggestion will not be used
@@ -6787,6 +6915,16 @@ type GoogleCloudRetailV2betaSearchResponseFacetFacetValue struct {
// "price".
Interval *GoogleCloudRetailV2betaInterval `json:"interval,omitempty"`
+ // MaxValue: The maximum value in the FacetValue.interval. Only
+ // supported on numerical facets and returned if
+ // SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+ MaxValue float64 `json:"maxValue,omitempty"`
+
+ // MinValue: The minimum value in the FacetValue.interval. Only
+ // supported on numerical facets and returned if
+ // SearchRequest.FacetSpec.FacetKey.return_min_max is true.
+ MinValue float64 `json:"minValue,omitempty"`
+
// Value: Text value of a facet, such as "Black" for facet
// "colorFamilies".
Value string `json:"value,omitempty"`
@@ -6814,6 +6952,22 @@ func (s *GoogleCloudRetailV2betaSearchResponseFacetFacetValue) MarshalJSON() ([]
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+func (s *GoogleCloudRetailV2betaSearchResponseFacetFacetValue) UnmarshalJSON(data []byte) error {
+ type NoMethod GoogleCloudRetailV2betaSearchResponseFacetFacetValue
+ var s1 struct {
+ MaxValue gensupport.JSONFloat64 `json:"maxValue"`
+ MinValue gensupport.JSONFloat64 `json:"minValue"`
+ *NoMethod
+ }
+ s1.NoMethod = (*NoMethod)(s)
+ if err := json.Unmarshal(data, &s1); err != nil {
+ return err
+ }
+ s.MaxValue = float64(s1.MaxValue)
+ s.MinValue = float64(s1.MinValue)
+ return nil
+}
+
// GoogleCloudRetailV2betaSearchResponseQueryExpansionInfo: Information
// describing query expansion including whether expansion has occurred.
type GoogleCloudRetailV2betaSearchResponseQueryExpansionInfo struct {
@@ -6867,6 +7021,14 @@ type GoogleCloudRetailV2betaSearchResponseSearchResult struct {
// ColorInfo and the query.
MatchingVariantFields map[string]string `json:"matchingVariantFields,omitempty"`
+ // PersonalLabels: Specifies previous events related to this product for
+ // this user based on UserEvent with same SearchRequest.visitor_id or
+ // UserInfo.user_id. This is set only when
+ // SearchRequest.PersonalizationSpec.mode is
+ // SearchRequest.PersonalizationSpec.Mode.AUTO. Possible values: *
+ // `purchased`: Indicates that this product has been purchased before.
+ PersonalLabels []string `json:"personalLabels,omitempty"`
+
// Product: The product data snippet in the search response. Only
// Product.name is guaranteed to be populated. Product.variants contains
// the product variants that match the search query. If there are
@@ -7801,9 +7963,9 @@ type ProjectsLocationsCatalogsCompleteQueryCall struct {
// Search enabled. Please enable Retail Search on Cloud Console before
// using this feature.
//
-// - catalog: Catalog for which the completion is performed. Full
-// resource name of catalog, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: Catalog for which the completion is performed. Full
+// resource name of catalog, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) CompleteQuery(catalog string) *ProjectsLocationsCatalogsCompleteQueryCall {
c := &ProjectsLocationsCatalogsCompleteQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -8052,9 +8214,9 @@ type ProjectsLocationsCatalogsGetAttributesConfigCall struct {
// GetAttributesConfig: Gets an AttributesConfig.
//
-// - name: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - name: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsService) GetAttributesConfig(name string) *ProjectsLocationsCatalogsGetAttributesConfigCall {
c := &ProjectsLocationsCatalogsGetAttributesConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8201,9 +8363,9 @@ type ProjectsLocationsCatalogsGetCompletionConfigCall struct {
// GetCompletionConfig: Gets a CompletionConfig.
//
-// - name: Full CompletionConfig resource name. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/completionConfig.
+// - name: Full CompletionConfig resource name. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/completionConfig.
func (r *ProjectsLocationsCatalogsService) GetCompletionConfig(name string) *ProjectsLocationsCatalogsGetCompletionConfigCall {
c := &ProjectsLocationsCatalogsGetCompletionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8352,8 +8514,8 @@ type ProjectsLocationsCatalogsGetDefaultBranchCall struct {
// CatalogService.SetDefaultBranch method under a specified parent
// catalog.
//
-// - catalog: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) GetDefaultBranch(catalog string) *ProjectsLocationsCatalogsGetDefaultBranchCall {
c := &ProjectsLocationsCatalogsGetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -8426,7 +8588,9 @@ func (c *ProjectsLocationsCatalogsGetDefaultBranchCall) doRequest(alt string) (*
// error will be non-nil. Any non-2xx status code is an error. Response
// headers are in either
// *GoogleCloudRetailV2betaGetDefaultBranchResponse.ServerResponse.Header
-// or (if a response was returned at all) in
+//
+// or (if a response was returned at all) in
+//
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
@@ -8501,10 +8665,10 @@ type ProjectsLocationsCatalogsListCall struct {
// List: Lists all the Catalogs associated with the project.
//
-// - parent: The account resource name with an associated location. If
-// the caller does not have permission to list Catalogs under this
-// location, regardless of whether or not this location exists, a
-// PERMISSION_DENIED error is returned.
+// - parent: The account resource name with an associated location. If
+// the caller does not have permission to list Catalogs under this
+// location, regardless of whether or not this location exists, a
+// PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsService) List(parent string) *ProjectsLocationsCatalogsListCall {
c := &ProjectsLocationsCatalogsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8880,8 +9044,8 @@ type ProjectsLocationsCatalogsSetDefaultBranchCall struct {
// {newBranch} (if branch is not explicitly set). * UserEventService
// will only join events with products from branch {newBranch}.
//
-// - catalog: Full resource name of the catalog, such as
-// `projects/*/locations/global/catalogs/default_catalog`.
+// - catalog: Full resource name of the catalog, such as
+// `projects/*/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsService) SetDefaultBranch(catalog string, googlecloudretailv2betasetdefaultbranchrequest *GoogleCloudRetailV2betaSetDefaultBranchRequest) *ProjectsLocationsCatalogsSetDefaultBranchCall {
c := &ProjectsLocationsCatalogsSetDefaultBranchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.catalog = catalog
@@ -9030,9 +9194,9 @@ type ProjectsLocationsCatalogsUpdateAttributesConfigCall struct {
// missing catalog attribute fields, e.g., searchable and dynamic
// facetable options.
//
-// - name: Immutable. The fully qualified resource name of the attribute
-// config. Format:
-// `projects/*/locations/*/catalogs/*/attributesConfig`.
+// - name: Immutable. The fully qualified resource name of the attribute
+// config. Format:
+// `projects/*/locations/*/catalogs/*/attributesConfig`.
func (r *ProjectsLocationsCatalogsService) UpdateAttributesConfig(name string, googlecloudretailv2betaattributesconfig *GoogleCloudRetailV2betaAttributesConfig) *ProjectsLocationsCatalogsUpdateAttributesConfigCall {
c := &ProjectsLocationsCatalogsUpdateAttributesConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9190,8 +9354,8 @@ type ProjectsLocationsCatalogsUpdateCompletionConfigCall struct {
// UpdateCompletionConfig: Updates the CompletionConfigs.
//
-// - name: Immutable. Fully qualified name
-// `projects/*/locations/*/catalogs/*/completionConfig`.
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/*/catalogs/*/completionConfig`.
func (r *ProjectsLocationsCatalogsService) UpdateCompletionConfig(name string, googlecloudretailv2betacompletionconfig *GoogleCloudRetailV2betaCompletionConfig) *ProjectsLocationsCatalogsUpdateCompletionConfigCall {
c := &ProjectsLocationsCatalogsUpdateCompletionConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9353,9 +9517,9 @@ type ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall struct {
// AttributesConfig. If the CatalogAttribute to add already exists, an
// ALREADY_EXISTS error is returned.
//
-// - attributesConfig: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsAttributesConfigService) AddCatalogAttribute(attributesConfig string, googlecloudretailv2betaaddcatalogattributerequest *GoogleCloudRetailV2betaAddCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall {
c := &ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.attributesConfig = attributesConfig
@@ -9485,6 +9649,155 @@ func (c *ProjectsLocationsCatalogsAttributesConfigAddCatalogAttributeCall) Do(op
}
+// method id "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes":
+
+type ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall struct {
+ s *Service
+ attributesConfig string
+ googlecloudretailv2betabatchremovecatalogattributesrequest *GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// BatchRemoveCatalogAttributes: Removes all specified CatalogAttributes
+// from the AttributesConfig.
+//
+// - attributesConfig: The attributes config resource shared by all
+// catalog attributes being deleted. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
+func (r *ProjectsLocationsCatalogsAttributesConfigService) BatchRemoveCatalogAttributes(attributesConfig string, googlecloudretailv2betabatchremovecatalogattributesrequest *GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest) *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall {
+ c := &ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.attributesConfig = attributesConfig
+ c.googlecloudretailv2betabatchremovecatalogattributesrequest = googlecloudretailv2betabatchremovecatalogattributesrequest
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Fields(s ...googleapi.Field) *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Context(ctx context.Context) *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.googlecloudretailv2betabatchremovecatalogattributesrequest)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v2beta/{+attributesConfig}:batchRemoveCatalogAttributes")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("POST", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "attributesConfig": c.attributesConfig,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes" call.
+// Exactly one of
+// *GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse or error
+// will be non-nil. Any non-2xx status code is an error. Response
+// headers are in either
+// *GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse.ServerRes
+// ponse.Header or (if a response was returned at all) in
+// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
+// whether the returned error was because http.StatusNotModified was
+// returned.
+func (c *ProjectsLocationsCatalogsAttributesConfigBatchRemoveCatalogAttributesCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Removes all specified CatalogAttributes from the AttributesConfig.",
+ // "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/attributesConfig:batchRemoveCatalogAttributes",
+ // "httpMethod": "POST",
+ // "id": "retail.projects.locations.catalogs.attributesConfig.batchRemoveCatalogAttributes",
+ // "parameterOrder": [
+ // "attributesConfig"
+ // ],
+ // "parameters": {
+ // "attributesConfig": {
+ // "description": "Required. The attributes config resource shared by all catalog attributes being deleted. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/catalogs/[^/]+/attributesConfig$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v2beta/{+attributesConfig}:batchRemoveCatalogAttributes",
+ // "request": {
+ // "$ref": "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesRequest"
+ // },
+ // "response": {
+ // "$ref": "GoogleCloudRetailV2betaBatchRemoveCatalogAttributesResponse"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
// method id "retail.projects.locations.catalogs.attributesConfig.removeCatalogAttribute":
type ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall struct {
@@ -9500,9 +9813,9 @@ type ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall struct
// the AttributesConfig. If the CatalogAttribute to remove does not
// exist, a NOT_FOUND error is returned.
//
-// - attributesConfig: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsAttributesConfigService) RemoveCatalogAttribute(attributesConfig string, googlecloudretailv2betaremovecatalogattributerequest *GoogleCloudRetailV2betaRemoveCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall {
c := &ProjectsLocationsCatalogsAttributesConfigRemoveCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.attributesConfig = attributesConfig
@@ -9648,9 +9961,9 @@ type ProjectsLocationsCatalogsAttributesConfigReplaceCatalogAttributeCall struct
// CatalogAttribute.key. If the CatalogAttribute to replace does not
// exist, a NOT_FOUND error is returned.
//
-// - attributesConfig: Full AttributesConfig resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/attributesConfig`.
+// - attributesConfig: Full AttributesConfig resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/attributesConfig`.
func (r *ProjectsLocationsCatalogsAttributesConfigService) ReplaceCatalogAttribute(attributesConfig string, googlecloudretailv2betareplacecatalogattributerequest *GoogleCloudRetailV2betaReplaceCatalogAttributeRequest) *ProjectsLocationsCatalogsAttributesConfigReplaceCatalogAttributeCall {
c := &ProjectsLocationsCatalogsAttributesConfigReplaceCatalogAttributeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.attributesConfig = attributesConfig
@@ -9946,15 +10259,18 @@ type ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall struct {
// processed downstream. As a consequence, when a response is returned,
// the added place IDs are not immediately manifested in the Product
// queried by ProductService.GetProduct or ProductService.ListProducts.
-// This feature is only available for users who have Retail Search
-// enabled. Please enable Retail Search on Cloud Console before using
-// this feature.
+// The returned Operations will be obsolete after 1 day, and
+// GetOperation API will return NOT_FOUND afterwards. If conflicting
+// updates are issued, the Operations associated with the stale updates
+// will not be marked as done until being obsolete. This feature is only
+// available for users who have Retail Search enabled. Please enable
+// Retail Search on Cloud Console before using this feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) AddFulfillmentPlaces(product string, googlecloudretailv2betaaddfulfillmentplacesrequest *GoogleCloudRetailV2betaAddFulfillmentPlacesRequest) *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall {
c := &ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -10053,7 +10369,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddFulfillmentPlacesCall) Do(o
}
return ret, nil
// {
- // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Incrementally adds place IDs to Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addFulfillmentPlaces",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.addFulfillmentPlaces",
@@ -10104,15 +10420,19 @@ type ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall struct {
// ProductService.GetProduct or ProductService.ListProducts. Local
// inventory information can only be modified using this method.
// ProductService.CreateProduct and ProductService.UpdateProduct has no
-// effect on local inventories. This feature is only available for users
-// who have Retail Search enabled. Please enable Retail Search on Cloud
-// Console before using this feature.
+// effect on local inventories. The returned Operations will be obsolete
+// after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+// If conflicting updates are issued, the Operations associated with the
+// stale updates will not be marked as done until being obsolete. This
+// feature is only available for users who have Retail Search enabled.
+// Please enable Retail Search on Cloud Console before using this
+// feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) AddLocalInventories(product string, googlecloudretailv2betaaddlocalinventoriesrequest *GoogleCloudRetailV2betaAddLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall {
c := &ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -10211,7 +10531,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsAddLocalInventoriesCall) Do(op
}
return ret, nil
// {
- // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Updates local inventory information for a Product at a list of places, while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be modified using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:addLocalInventories",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.addLocalInventories",
@@ -10254,9 +10574,9 @@ type ProjectsLocationsCatalogsBranchesProductsCreateCall struct {
// Create: Creates a Product.
//
-// - parent: The parent catalog resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch`.
+// - parent: The parent catalog resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Create(parent string, googlecloudretailv2betaproduct *GoogleCloudRetailV2betaProduct) *ProjectsLocationsCatalogsBranchesProductsCreateCall {
c := &ProjectsLocationsCatalogsBranchesProductsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10415,16 +10735,16 @@ type ProjectsLocationsCatalogsBranchesProductsDeleteCall struct {
// Delete: Deletes a Product.
//
-// - name: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to delete the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned. If the Product to
-// delete does not exist, a NOT_FOUND error is returned. The Product
-// to delete can neither be a Product.Type.COLLECTION Product member
-// nor a Product.Type.PRIMARY Product with more than one variants.
-// Otherwise, an INVALID_ARGUMENT error is returned. All inventory
-// information for the named Product will be deleted.
+// - name: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to delete the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned. If the Product to
+// delete does not exist, a NOT_FOUND error is returned. The Product
+// to delete can neither be a Product.Type.COLLECTION Product member
+// nor a Product.Type.PRIMARY Product with more than one variants.
+// Otherwise, an INVALID_ARGUMENT error is returned. All inventory
+// information for the named Product will be deleted.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Delete(name string) *ProjectsLocationsCatalogsBranchesProductsDeleteCall {
c := &ProjectsLocationsCatalogsBranchesProductsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10557,12 +10877,12 @@ type ProjectsLocationsCatalogsBranchesProductsGetCall struct {
// Get: Gets a Product.
//
-// - name: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned. If the requested
-// Product does not exist, a NOT_FOUND error is returned.
+// - name: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned. If the requested
+// Product does not exist, a NOT_FOUND error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Get(name string) *ProjectsLocationsCatalogsBranchesProductsGetCall {
c := &ProjectsLocationsCatalogsBranchesProductsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10710,11 +11030,11 @@ type ProjectsLocationsCatalogsBranchesProductsImportCall struct {
// synchronous. Non-existing items are created. Note that it is possible
// for a subset of the Products to be successfully updated.
//
-// - parent:
-// `projects/1234/locations/global/catalogs/default_catalog/branches/de
-// fault_branch` If no updateMask is specified, requires
-// products.create permission. If updateMask is specified, requires
-// products.update permission.
+// - parent:
+// `projects/1234/locations/global/catalogs/default_catalog/branches/de
+// fault_branch` If no updateMask is specified, requires
+// products.create permission. If updateMask is specified, requires
+// products.update permission.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Import(parent string, googlecloudretailv2betaimportproductsrequest *GoogleCloudRetailV2betaImportProductsRequest) *ProjectsLocationsCatalogsBranchesProductsImportCall {
c := &ProjectsLocationsCatalogsBranchesProductsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10856,12 +11176,12 @@ type ProjectsLocationsCatalogsBranchesProductsListCall struct {
// List: Gets a list of Products.
//
-// - parent: The parent branch resource name, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/0`.
-// Use `default_branch` as the branch ID, to list products under the
-// default branch. If the caller does not have permission to list
-// Products under this branch, regardless of whether or not this
-// branch exists, a PERMISSION_DENIED error is returned.
+// - parent: The parent branch resource name, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/0`.
+// Use `default_branch` as the branch ID, to list products under the
+// default branch. If the caller does not have permission to list
+// Products under this branch, regardless of whether or not this
+// branch exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) List(parent string) *ProjectsLocationsCatalogsBranchesProductsListCall {
c := &ProjectsLocationsCatalogsBranchesProductsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11102,9 +11422,9 @@ type ProjectsLocationsCatalogsBranchesProductsPatchCall struct {
// Patch: Updates a Product.
//
-// - name: Immutable. Full resource name of the product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/product_id`.
+// - name: Immutable. Full resource name of the product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/product_id`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) Patch(name string, googlecloudretailv2betaproduct *GoogleCloudRetailV2betaProduct) *ProjectsLocationsCatalogsBranchesProductsPatchCall {
c := &ProjectsLocationsCatalogsBranchesProductsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11284,15 +11604,18 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall struct
// processed downstream. As a consequence, when a response is returned,
// the removed place IDs are not immediately manifested in the Product
// queried by ProductService.GetProduct or ProductService.ListProducts.
-// This feature is only available for users who have Retail Search
-// enabled. Please enable Retail Search on Cloud Console before using
-// this feature.
+// The returned Operations will be obsolete after 1 day, and
+// GetOperation API will return NOT_FOUND afterwards. If conflicting
+// updates are issued, the Operations associated with the stale updates
+// will not be marked as done until being obsolete. This feature is only
+// available for users who have Retail Search enabled. Please enable
+// Retail Search on Cloud Console before using this feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveFulfillmentPlaces(product string, googlecloudretailv2betaremovefulfillmentplacesrequest *GoogleCloudRetailV2betaRemoveFulfillmentPlacesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall {
c := &ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -11391,7 +11714,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveFulfillmentPlacesCall) D
}
return ret, nil
// {
- // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Incrementally removes place IDs from a Product.fulfillment_info.place_ids. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeFulfillmentPlaces",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.removeFulfillmentPlaces",
@@ -11440,15 +11763,19 @@ type ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall struct
// queried by ProductService.GetProduct or ProductService.ListProducts.
// Local inventory information can only be removed using this method.
// ProductService.CreateProduct and ProductService.UpdateProduct has no
-// effect on local inventories. This feature is only available for users
-// who have Retail Search enabled. Please enable Retail Search on Cloud
-// Console before using this feature.
+// effect on local inventories. The returned Operations will be obsolete
+// after 1 day, and GetOperation API will return NOT_FOUND afterwards.
+// If conflicting updates are issued, the Operations associated with the
+// stale updates will not be marked as done until being obsolete. This
+// feature is only available for users who have Retail Search enabled.
+// Please enable Retail Search on Cloud Console before using this
+// feature.
//
-// - product: Full resource name of Product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/some_product_id`. If the caller does not have
-// permission to access the Product, regardless of whether or not it
-// exists, a PERMISSION_DENIED error is returned.
+// - product: Full resource name of Product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/some_product_id`. If the caller does not have
+// permission to access the Product, regardless of whether or not it
+// exists, a PERMISSION_DENIED error is returned.
func (r *ProjectsLocationsCatalogsBranchesProductsService) RemoveLocalInventories(product string, googlecloudretailv2betaremovelocalinventoriesrequest *GoogleCloudRetailV2betaRemoveLocalInventoriesRequest) *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall {
c := &ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.product = product
@@ -11547,7 +11874,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsRemoveLocalInventoriesCall) Do
}
return ret, nil
// {
- // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Remove local inventory information for a Product at a list of places at a removal timestamp. This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. Local inventory information can only be removed using this method. ProductService.CreateProduct and ProductService.UpdateProduct has no effect on local inventories. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:removeLocalInventories",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.removeLocalInventories",
@@ -11608,13 +11935,17 @@ type ProjectsLocationsCatalogsBranchesProductsSetInventoryCall struct {
// information will be preserved. Pre-existing inventory information can
// only be updated with ProductService.SetInventory,
// ProductService.AddFulfillmentPlaces, and
-// ProductService.RemoveFulfillmentPlaces. This feature is only
-// available for users who have Retail Search enabled. Please enable
-// Retail Search on Cloud Console before using this feature.
+// ProductService.RemoveFulfillmentPlaces. The returned Operations will
+// be obsolete after 1 day, and GetOperation API will return NOT_FOUND
+// afterwards. If conflicting updates are issued, the Operations
+// associated with the stale updates will not be marked as done until
+// being obsolete. This feature is only available for users who have
+// Retail Search enabled. Please enable Retail Search on Cloud Console
+// before using this feature.
//
-// - name: Immutable. Full resource name of the product, such as
-// `projects/*/locations/global/catalogs/default_catalog/branches/defau
-// lt_branch/products/product_id`.
+// - name: Immutable. Full resource name of the product, such as
+// `projects/*/locations/global/catalogs/default_catalog/branches/defau
+// lt_branch/products/product_id`.
func (r *ProjectsLocationsCatalogsBranchesProductsService) SetInventory(name string, googlecloudretailv2betasetinventoryrequest *GoogleCloudRetailV2betaSetInventoryRequest) *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall {
c := &ProjectsLocationsCatalogsBranchesProductsSetInventoryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11713,7 +12044,7 @@ func (c *ProjectsLocationsCatalogsBranchesProductsSetInventoryCall) Do(opts ...g
}
return ret, nil
// {
- // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
+ // "description": "Updates inventory information for a Product while respecting the last update timestamps of each inventory field. This process is asynchronous and does not require the Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the Product queried by ProductService.GetProduct or ProductService.ListProducts. When inventory is updated with ProductService.CreateProduct and ProductService.UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the ProductService.CreateProduct or ProductService.UpdateProduct request. If no inventory fields are set in CreateProductRequest.product, then any pre-existing inventory information for this product will be used. If no inventory fields are set in SetInventoryRequest.set_mask, then any existing inventory information will be preserved. Pre-existing inventory information can only be updated with ProductService.SetInventory, ProductService.AddFulfillmentPlaces, and ProductService.RemoveFulfillmentPlaces. The returned Operations will be obsolete after 1 day, and GetOperation API will return NOT_FOUND afterwards. If conflicting updates are issued, the Operations associated with the stale updates will not be marked as done until being obsolete. This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.",
// "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/branches/{branchesId}/products/{productsId}:setInventory",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.branches.products.setInventory",
@@ -11762,8 +12093,8 @@ type ProjectsLocationsCatalogsCompletionDataImportCall struct {
// have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - parent: The catalog which the suggestions dataset belongs to.
-// Format: `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The catalog which the suggestions dataset belongs to.
+// Format: `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsCompletionDataService) Import(parent string, googlecloudretailv2betaimportcompletiondatarequest *GoogleCloudRetailV2betaImportCompletionDataRequest) *ProjectsLocationsCatalogsCompletionDataImportCall {
c := &ProjectsLocationsCatalogsCompletionDataImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11906,9 +12237,9 @@ type ProjectsLocationsCatalogsControlsCreateCall struct {
// Create: Creates a Control. If the Control to create already exists,
// an ALREADY_EXISTS error is returned.
//
-// - parent: Full resource name of parent catalog. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}`.
+// - parent: Full resource name of parent catalog. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}`.
func (r *ProjectsLocationsCatalogsControlsService) Create(parent string, googlecloudretailv2betacontrol *GoogleCloudRetailV2betaControl) *ProjectsLocationsCatalogsControlsCreateCall {
c := &ProjectsLocationsCatalogsControlsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12064,9 +12395,9 @@ type ProjectsLocationsCatalogsControlsDeleteCall struct {
// Delete: Deletes a Control. If the Control to delete does not exist, a
// NOT_FOUND error is returned.
//
-// - name: The resource name of the Control to delete. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/controls/{control_id}`.
+// - name: The resource name of the Control to delete. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/controls/{control_id}`.
func (r *ProjectsLocationsCatalogsControlsService) Delete(name string) *ProjectsLocationsCatalogsControlsDeleteCall {
c := &ProjectsLocationsCatalogsControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12199,9 +12530,9 @@ type ProjectsLocationsCatalogsControlsGetCall struct {
// Get: Gets a Control.
//
-// - name: The resource name of the Control to delete. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}/controls/{control_id}`.
+// - name: The resource name of the Control to delete. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}/controls/{control_id}`.
func (r *ProjectsLocationsCatalogsControlsService) Get(name string) *ProjectsLocationsCatalogsControlsGetCall {
c := &ProjectsLocationsCatalogsControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12347,9 +12678,9 @@ type ProjectsLocationsCatalogsControlsListCall struct {
// List: Lists all Controls linked to this catalog.
//
-// - parent: The catalog resource name. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}`.
+// - parent: The catalog resource name. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}`.
func (r *ProjectsLocationsCatalogsControlsService) List(parent string) *ProjectsLocationsCatalogsControlsListCall {
c := &ProjectsLocationsCatalogsControlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12561,8 +12892,8 @@ type ProjectsLocationsCatalogsControlsPatchCall struct {
// field, if so an INVALID_ARGUMENT is returned. If the Control to
// delete does not exist, a NOT_FOUND error is returned.
//
-// - name: Immutable. Fully qualified name
-// `projects/*/locations/global/catalogs/*/controls/*`.
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/global/catalogs/*/controls/*`.
func (r *ProjectsLocationsCatalogsControlsService) Patch(name string, googlecloudretailv2betacontrol *GoogleCloudRetailV2betaControl) *ProjectsLocationsCatalogsControlsPatchCall {
c := &ProjectsLocationsCatalogsControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13081,19 +13412,19 @@ type ProjectsLocationsCatalogsPlacementsPredictCall struct {
// Predict: Makes a recommendation prediction.
//
-// - placement: Full resource name of the format:
-// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
-// vingConfigs/*}` or
-// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
-// cements/*}`. We recommend using the `servingConfigs` resource.
-// `placements` is a legacy resource. The ID of the Recommendations AI
-// serving config or placement. Before you can request predictions
-// from your model, you must create at least one serving config or
-// placement for it. For more information, see [Managing serving
-// configurations]
-// (https://cloud.google.com/retail/docs/manage-configs). The full
-// list of available serving configs can be seen at
-// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
+// - placement: Full resource name of the format:
+// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
+// vingConfigs/*}` or
+// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
+// cements/*}`. We recommend using the `servingConfigs` resource.
+// `placements` is a legacy resource. The ID of the Recommendations AI
+// serving config or placement. Before you can request predictions
+// from your model, you must create at least one serving config or
+// placement for it. For more information, see [Managing serving
+// configurations]
+// (https://cloud.google.com/retail/docs/manage-configs). The full
+// list of available serving configs can be seen at
+// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
func (r *ProjectsLocationsCatalogsPlacementsService) Predict(placement string, googlecloudretailv2betapredictrequest *GoogleCloudRetailV2betaPredictRequest) *ProjectsLocationsCatalogsPlacementsPredictCall {
c := &ProjectsLocationsCatalogsPlacementsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -13238,15 +13569,15 @@ type ProjectsLocationsCatalogsPlacementsSearchCall struct {
// who have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - placement: The resource name of the Retail Search serving config,
-// such as
-// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
-// /default_serving_config` or the name of the legacy placement
-// resource, such as
-// `projects/*/locations/global/catalogs/default_catalog/placements/def
-// ault_search`. This field is used to identify the serving
-// configuration name and the set of models that will be used to make
-// the search.
+// - placement: The resource name of the Retail Search serving config,
+// such as
+// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
+// /default_serving_config` or the name of the legacy placement
+// resource, such as
+// `projects/*/locations/global/catalogs/default_catalog/placements/def
+// ault_search`. This field is used to identify the serving
+// configuration name and the set of models that will be used to make
+// the search.
func (r *ProjectsLocationsCatalogsPlacementsService) Search(placement string, googlecloudretailv2betasearchrequest *GoogleCloudRetailV2betaSearchRequest) *ProjectsLocationsCatalogsPlacementsSearchCall {
c := &ProjectsLocationsCatalogsPlacementsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -13416,9 +13747,9 @@ type ProjectsLocationsCatalogsServingConfigsAddControlCall struct {
// a FAILED_PRECONDITION error if the addition could exceed maximum
// number of control allowed for that type of control.
//
-// - servingConfig: The source ServingConfig resource name . Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - servingConfig: The source ServingConfig resource name . Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) AddControl(servingConfig string, googlecloudretailv2betaaddcontrolrequest *GoogleCloudRetailV2betaAddControlRequest) *ProjectsLocationsCatalogsServingConfigsAddControlCall {
c := &ProjectsLocationsCatalogsServingConfigsAddControlCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.servingConfig = servingConfig
@@ -13563,9 +13894,9 @@ type ProjectsLocationsCatalogsServingConfigsCreateCall struct {
// allowed in a Catalog, otherwise a FAILED_PRECONDITION error is
// returned.
//
-// - parent: Full resource name of parent. Format:
-// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
-// _id}`.
+// - parent: Full resource name of parent. Format:
+// `projects/{project_number}/locations/{location_id}/catalogs/{catalog
+// _id}`.
func (r *ProjectsLocationsCatalogsServingConfigsService) Create(parent string, googlecloudretailv2betaservingconfig *GoogleCloudRetailV2betaServingConfig) *ProjectsLocationsCatalogsServingConfigsCreateCall {
c := &ProjectsLocationsCatalogsServingConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13722,9 +14053,9 @@ type ProjectsLocationsCatalogsServingConfigsDeleteCall struct {
// Delete: Deletes a ServingConfig. Returns a NotFound error if the
// ServingConfig does not exist.
//
-// - name: The resource name of the ServingConfig to delete. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - name: The resource name of the ServingConfig to delete. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) Delete(name string) *ProjectsLocationsCatalogsServingConfigsDeleteCall {
c := &ProjectsLocationsCatalogsServingConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13858,9 +14189,9 @@ type ProjectsLocationsCatalogsServingConfigsGetCall struct {
// Get: Gets a ServingConfig. Returns a NotFound error if the
// ServingConfig does not exist.
//
-// - name: The resource name of the ServingConfig to get. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - name: The resource name of the ServingConfig to get. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) Get(name string) *ProjectsLocationsCatalogsServingConfigsGetCall {
c := &ProjectsLocationsCatalogsServingConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -14007,9 +14338,9 @@ type ProjectsLocationsCatalogsServingConfigsListCall struct {
// List: Lists all ServingConfigs linked to this catalog.
//
-// - parent: The catalog resource name. Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}.
+// - parent: The catalog resource name. Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) List(parent string) *ProjectsLocationsCatalogsServingConfigsListCall {
c := &ProjectsLocationsCatalogsServingConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14205,8 +14536,8 @@ type ProjectsLocationsCatalogsServingConfigsPatchCall struct {
// Patch: Updates a ServingConfig.
//
-// - name: Immutable. Fully qualified name
-// `projects/*/locations/global/catalogs/*/servingConfig/*`.
+// - name: Immutable. Fully qualified name
+// `projects/*/locations/global/catalogs/*/servingConfig/*`.
func (r *ProjectsLocationsCatalogsServingConfigsService) Patch(name string, googlecloudretailv2betaservingconfig *GoogleCloudRetailV2betaServingConfig) *ProjectsLocationsCatalogsServingConfigsPatchCall {
c := &ProjectsLocationsCatalogsServingConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -14364,19 +14695,19 @@ type ProjectsLocationsCatalogsServingConfigsPredictCall struct {
// Predict: Makes a recommendation prediction.
//
-// - placement: Full resource name of the format:
-// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
-// vingConfigs/*}` or
-// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
-// cements/*}`. We recommend using the `servingConfigs` resource.
-// `placements` is a legacy resource. The ID of the Recommendations AI
-// serving config or placement. Before you can request predictions
-// from your model, you must create at least one serving config or
-// placement for it. For more information, see [Managing serving
-// configurations]
-// (https://cloud.google.com/retail/docs/manage-configs). The full
-// list of available serving configs can be seen at
-// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
+// - placement: Full resource name of the format:
+// `{placement=projects/*/locations/global/catalogs/default_catalog/ser
+// vingConfigs/*}` or
+// `{placement=projects/*/locations/global/catalogs/default_catalog/pla
+// cements/*}`. We recommend using the `servingConfigs` resource.
+// `placements` is a legacy resource. The ID of the Recommendations AI
+// serving config or placement. Before you can request predictions
+// from your model, you must create at least one serving config or
+// placement for it. For more information, see [Managing serving
+// configurations]
+// (https://cloud.google.com/retail/docs/manage-configs). The full
+// list of available serving configs can be seen at
+// https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs.
func (r *ProjectsLocationsCatalogsServingConfigsService) Predict(placement string, googlecloudretailv2betapredictrequest *GoogleCloudRetailV2betaPredictRequest) *ProjectsLocationsCatalogsServingConfigsPredictCall {
c := &ProjectsLocationsCatalogsServingConfigsPredictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -14521,9 +14852,9 @@ type ProjectsLocationsCatalogsServingConfigsRemoveControlCall struct {
// control is removed from the ServingConfig. Returns a NOT_FOUND error
// if the Control is not enabled for the ServingConfig.
//
-// - servingConfig: The source ServingConfig resource name . Format:
-// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
-// id}/servingConfigs/{serving_config_id}.
+// - servingConfig: The source ServingConfig resource name . Format:
+// projects/{project_number}/locations/{location_id}/catalogs/{catalog_
+// id}/servingConfigs/{serving_config_id}.
func (r *ProjectsLocationsCatalogsServingConfigsService) RemoveControl(servingConfig string, googlecloudretailv2betaremovecontrolrequest *GoogleCloudRetailV2betaRemoveControlRequest) *ProjectsLocationsCatalogsServingConfigsRemoveControlCall {
c := &ProjectsLocationsCatalogsServingConfigsRemoveControlCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.servingConfig = servingConfig
@@ -14668,15 +14999,15 @@ type ProjectsLocationsCatalogsServingConfigsSearchCall struct {
// who have Retail Search enabled. Please enable Retail Search on Cloud
// Console before using this feature.
//
-// - placement: The resource name of the Retail Search serving config,
-// such as
-// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
-// /default_serving_config` or the name of the legacy placement
-// resource, such as
-// `projects/*/locations/global/catalogs/default_catalog/placements/def
-// ault_search`. This field is used to identify the serving
-// configuration name and the set of models that will be used to make
-// the search.
+// - placement: The resource name of the Retail Search serving config,
+// such as
+// `projects/*/locations/global/catalogs/default_catalog/servingConfigs
+// /default_serving_config` or the name of the legacy placement
+// resource, such as
+// `projects/*/locations/global/catalogs/default_catalog/placements/def
+// ault_search`. This field is used to identify the serving
+// configuration name and the set of models that will be used to make
+// the search.
func (r *ProjectsLocationsCatalogsServingConfigsService) Search(placement string, googlecloudretailv2betasearchrequest *GoogleCloudRetailV2betaSearchRequest) *ProjectsLocationsCatalogsServingConfigsSearchCall {
c := &ProjectsLocationsCatalogsServingConfigsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.placement = placement
@@ -14843,8 +15174,8 @@ type ProjectsLocationsCatalogsUserEventsCollectCall struct {
// domain. This method is used only by the Retail API JavaScript pixel
// and Google Tag Manager. Users should not call this method directly.
//
-// - parent: The parent catalog name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Collect(parent string) *ProjectsLocationsCatalogsUserEventsCollectCall {
c := &ProjectsLocationsCatalogsUserEventsCollectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15030,10 +15361,10 @@ type ProjectsLocationsCatalogsUserEventsImportCall struct {
// Import: Bulk import of User events. Request processing might be
// synchronous. Events that already exist are skipped. Use this method
-// for backfilling historical user events. Operation.response is of type
-// ImportResponse. Note that it is possible for a subset of the items to
-// be successfully inserted. Operation.metadata is of type
-// ImportMetadata.
+// for backfilling historical user events. `Operation.response` is of
+// type `ImportResponse`. Note that it is possible for a subset of the
+// items to be successfully inserted. `Operation.metadata` is of type
+// `ImportMetadata`.
//
// - parent: `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Import(parent string, googlecloudretailv2betaimportusereventsrequest *GoogleCloudRetailV2betaImportUserEventsRequest) *ProjectsLocationsCatalogsUserEventsImportCall {
@@ -15134,7 +15465,7 @@ func (c *ProjectsLocationsCatalogsUserEventsImportCall) Do(opts ...googleapi.Cal
}
return ret, nil
// {
- // "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+ // "description": "Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`.",
// "flatPath": "v2beta/projects/{projectsId}/locations/{locationsId}/catalogs/{catalogsId}/userEvents:import",
// "httpMethod": "POST",
// "id": "retail.projects.locations.catalogs.userEvents.import",
@@ -15180,9 +15511,9 @@ type ProjectsLocationsCatalogsUserEventsPurgeCall struct {
// this operation could take hours or days to complete. To test a
// filter, use the list command first.
//
-// - parent: The resource name of the catalog under which the events are
-// created. The format is
-// `projects/${projectId}/locations/global/catalogs/${catalogId}`.
+// - parent: The resource name of the catalog under which the events are
+// created. The format is
+// `projects/${projectId}/locations/global/catalogs/${catalogId}`.
func (r *ProjectsLocationsCatalogsUserEventsService) Purge(parent string, googlecloudretailv2betapurgeusereventsrequest *GoogleCloudRetailV2betaPurgeUserEventsRequest) *ProjectsLocationsCatalogsUserEventsPurgeCall {
c := &ProjectsLocationsCatalogsUserEventsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15332,8 +15663,8 @@ type ProjectsLocationsCatalogsUserEventsRejoinCall struct {
// joined with the wrong product catalog. A rejoin operation can take
// hours or days to complete.
//
-// - parent: The parent catalog resource name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Rejoin(parent string, googlecloudretailv2betarejoinusereventsrequest *GoogleCloudRetailV2betaRejoinUserEventsRequest) *ProjectsLocationsCatalogsUserEventsRejoinCall {
c := &ProjectsLocationsCatalogsUserEventsRejoinCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15475,8 +15806,8 @@ type ProjectsLocationsCatalogsUserEventsWriteCall struct {
// Write: Writes a single user event.
//
-// - parent: The parent catalog resource name, such as
-// `projects/1234/locations/global/catalogs/default_catalog`.
+// - parent: The parent catalog resource name, such as
+// `projects/1234/locations/global/catalogs/default_catalog`.
func (r *ProjectsLocationsCatalogsUserEventsService) Write(parent string, googlecloudretailv2betauserevent *GoogleCloudRetailV2betaUserEvent) *ProjectsLocationsCatalogsUserEventsWriteCall {
c := &ProjectsLocationsCatalogsUserEventsWriteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/run/v1/run-api.json b/run/v1/run-api.json
index 226e2ca9e92..3a5ce724a4d 100644
--- a/run/v1/run-api.json
+++ b/run/v1/run-api.json
@@ -159,7 +159,7 @@
],
"parameters": {
"name": {
- "description": "The name of the configuration to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ "description": "The name of the configuration to retrieve. For Cloud Run, replace {namespace_id} with the project ID or number.",
"location": "path",
"pattern": "^namespaces/[^/]+/configurations/[^/]+$",
"required": true,
@@ -189,12 +189,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -204,25 +204,25 @@
"type": "string"
},
"limit": {
- "description": "Optional. The maximum number of records that should be returned.",
+ "description": "Optional. The maximum number of the records that should be returned.",
"format": "int32",
"location": "query",
"type": "integer"
},
"parent": {
- "description": "The namespace from which the configurations should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ "description": "The namespace from which the configurations should be listed. For Cloud Run, replace {namespace_id} with the project ID or number.",
"location": "path",
"pattern": "^namespaces/[^/]+$",
"required": true,
"type": "string"
},
"resourceVersion": {
- "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -304,7 +304,7 @@
"type": "string"
},
"propagationPolicy": {
- "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.",
"location": "query",
"type": "string"
}
@@ -343,7 +343,7 @@
]
},
"list": {
- "description": "List domain mappings.",
+ "description": "List all domain mappings.",
"flatPath": "apis/domains.cloudrun.com/v1/namespaces/{namespacesId}/domainmappings",
"httpMethod": "GET",
"id": "run.namespaces.domainmappings.list",
@@ -407,6 +407,34 @@
},
"executions": {
"methods": {
+ "cancel": {
+ "description": "Cancel an execution.",
+ "flatPath": "apis/run.googleapis.com/v1/namespaces/{namespacesId}/executions/{executionsId}:cancel",
+ "httpMethod": "POST",
+ "id": "run.namespaces.executions.cancel",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. The name of the execution to cancel. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID",
+ "location": "path",
+ "pattern": "^namespaces/[^/]+/executions/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "apis/run.googleapis.com/v1/{+name}:cancel",
+ "request": {
+ "$ref": "CancelExecutionRequest"
+ },
+ "response": {
+ "$ref": "Execution"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ },
"delete": {
"description": "Delete an execution.",
"flatPath": "apis/run.googleapis.com/v1/namespaces/{namespacesId}/executions/{executionsId}",
@@ -434,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 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, and deletes in the background. Please see http://kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
"location": "query",
"type": "string"
}
@@ -487,12 +515,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Optional. Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Optional. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -502,7 +530,7 @@
"type": "string"
},
"limit": {
- "description": "Optional. The maximum number of records that should be returned.",
+ "description": "Optional. The maximum number of the records that should be returned.",
"format": "int32",
"location": "query",
"type": "integer"
@@ -515,12 +543,12 @@
"type": "string"
},
"resourceVersion": {
- "description": "Optional. The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Optional. Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -645,12 +673,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Optional. Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Optional. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -673,12 +701,12 @@
"type": "string"
},
"resourceVersion": {
- "description": "Optional. The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Optional. Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -701,7 +729,7 @@
],
"parameters": {
"name": {
- "description": "Required. The name of the service being replaced. 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 job being replaced. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID",
"location": "path",
"pattern": "^namespaces/[^/]+/jobs/[^/]+$",
"required": true,
@@ -783,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 kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ "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.",
"location": "query",
"type": "string"
}
@@ -977,7 +1005,7 @@
"services": {
"methods": {
"create": {
- "description": "Create a service.",
+ "description": "Creates a new Service. Service creation will trigger a new deployment. Use GetService, and check service.status to determine if the Service is ready.",
"flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services",
"httpMethod": "POST",
"id": "run.namespaces.services.create",
@@ -991,7 +1019,7 @@
"type": "string"
},
"parent": {
- "description": "The namespace in which the service 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": "The resource's parent. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
"location": "path",
"pattern": "^namespaces/[^/]+$",
"required": true,
@@ -1010,7 +1038,7 @@
]
},
"delete": {
- "description": "Delete a service. This will cause the Service to stop serving traffic and will delete the child entities like Routes, Configurations and Revisions.",
+ "description": "Deletes the provided service. This will cause the Service to stop serving traffic and will delete all associated Revisions.",
"flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services/{servicesId}",
"httpMethod": "DELETE",
"id": "run.namespaces.services.delete",
@@ -1019,7 +1047,7 @@
],
"parameters": {
"apiVersion": {
- "description": "Cloud Run currently ignores this parameter.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
@@ -1029,19 +1057,19 @@
"type": "string"
},
"kind": {
- "description": "Cloud Run currently ignores this parameter.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
"name": {
- "description": "The name of the service 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": "The fully qualified name of the service to delete. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
"location": "path",
"pattern": "^namespaces/[^/]+/services/[^/]+$",
"required": true,
"type": "string"
},
"propagationPolicy": {
- "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
}
@@ -1055,7 +1083,7 @@
]
},
"get": {
- "description": "Get information about a service.",
+ "description": "Gets information about a service.",
"flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services/{servicesId}",
"httpMethod": "GET",
"id": "run.namespaces.services.get",
@@ -1064,7 +1092,7 @@
],
"parameters": {
"name": {
- "description": "The name of the service 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": "The fully qualified name of the service to retrieve. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
"location": "path",
"pattern": "^namespaces/[^/]+/services/[^/]+$",
"required": true,
@@ -1080,7 +1108,7 @@
]
},
"list": {
- "description": "List services.",
+ "description": "Lists services for the given project and region.",
"flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services",
"httpMethod": "GET",
"id": "run.namespaces.services.list",
@@ -1094,12 +1122,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -1115,19 +1143,19 @@
"type": "integer"
},
"parent": {
- "description": "The namespace from which the services 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": "The parent from where the resources should be listed. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
"location": "path",
"pattern": "^namespaces/[^/]+$",
"required": true,
"type": "string"
},
"resourceVersion": {
- "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -1141,7 +1169,7 @@
]
},
"replaceService": {
- "description": "Replace a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
+ "description": "Replaces a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
"flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services/{servicesId}",
"httpMethod": "PUT",
"id": "run.namespaces.services.replaceService",
@@ -1155,7 +1183,7 @@
"type": "string"
},
"name": {
- "description": "The name of the service being replaced. 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": "The fully qualified name of the service to replace. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
"location": "path",
"pattern": "^namespaces/[^/]+/services/[^/]+$",
"required": true,
@@ -1217,12 +1245,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Optional. Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Optional. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -1245,12 +1273,12 @@
"type": "string"
},
"resourceVersion": {
- "description": "Optional. The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Optional. Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Optional. Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -1406,7 +1434,7 @@
],
"parameters": {
"name": {
- "description": "The name of the configuration to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ "description": "The name of the configuration to retrieve. For Cloud Run, replace {namespace_id} with the project ID or number.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/configurations/[^/]+$",
"required": true,
@@ -1436,12 +1464,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -1451,25 +1479,25 @@
"type": "string"
},
"limit": {
- "description": "Optional. The maximum number of records that should be returned.",
+ "description": "Optional. The maximum number of the records that should be returned.",
"format": "int32",
"location": "query",
"type": "integer"
},
"parent": {
- "description": "The namespace from which the configurations should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ "description": "The namespace from which the configurations should be listed. For Cloud Run, replace {namespace_id} with the project ID or number.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
"type": "string"
},
"resourceVersion": {
- "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Not supported by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -1551,7 +1579,7 @@
"type": "string"
},
"propagationPolicy": {
- "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.",
"location": "query",
"type": "string"
}
@@ -1590,7 +1618,7 @@
]
},
"list": {
- "description": "List domain mappings.",
+ "description": "List all domain mappings.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/domainmappings",
"httpMethod": "GET",
"id": "run.projects.locations.domainmappings.list",
@@ -1777,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 kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ "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.",
"location": "query",
"type": "string"
}
@@ -1971,7 +1999,7 @@
"services": {
"methods": {
"create": {
- "description": "Create a service.",
+ "description": "Creates a new Service. Service creation will trigger a new deployment. Use GetService, and check service.status to determine if the Service is ready.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services",
"httpMethod": "POST",
"id": "run.projects.locations.services.create",
@@ -1985,7 +2013,7 @@
"type": "string"
},
"parent": {
- "description": "The namespace in which the service 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": "The resource's parent. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
@@ -2004,7 +2032,7 @@
]
},
"delete": {
- "description": "Delete a service. This will cause the Service to stop serving traffic and will delete the child entities like Routes, Configurations and Revisions.",
+ "description": "Deletes the provided service. This will cause the Service to stop serving traffic and will delete all associated Revisions.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}",
"httpMethod": "DELETE",
"id": "run.projects.locations.services.delete",
@@ -2013,7 +2041,7 @@
],
"parameters": {
"apiVersion": {
- "description": "Cloud Run currently ignores this parameter.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
@@ -2023,19 +2051,19 @@
"type": "string"
},
"kind": {
- "description": "Cloud Run currently ignores this parameter.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
"name": {
- "description": "The name of the service 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": "The fully qualified name of the service to delete. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$",
"required": true,
"type": "string"
},
"propagationPolicy": {
- "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
}
@@ -2049,7 +2077,7 @@
]
},
"get": {
- "description": "Get information about a service.",
+ "description": "Gets information about a service.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}",
"httpMethod": "GET",
"id": "run.projects.locations.services.get",
@@ -2058,7 +2086,7 @@
],
"parameters": {
"name": {
- "description": "The name of the service 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": "The fully qualified name of the service to retrieve. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$",
"required": true,
@@ -2074,7 +2102,7 @@
]
},
"getIamPolicy": {
- "description": "Get the IAM Access Control policy currently in effect for the given Cloud Run service. This result does not include any inherited policies.",
+ "description": "Gets the IAM Access Control policy currently in effect for the given Cloud Run service. This result does not include any inherited policies.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:getIamPolicy",
"httpMethod": "GET",
"id": "run.projects.locations.services.getIamPolicy",
@@ -2105,7 +2133,7 @@
]
},
"list": {
- "description": "List services.",
+ "description": "Lists services for the given project and region.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services",
"httpMethod": "GET",
"id": "run.projects.locations.services.list",
@@ -2119,12 +2147,12 @@
"type": "string"
},
"fieldSelector": {
- "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
"includeUninitialized": {
- "description": "Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "boolean"
},
@@ -2140,19 +2168,19 @@
"type": "integer"
},
"parent": {
- "description": "The namespace from which the services 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": "The parent from where the resources should be listed. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
"type": "string"
},
"resourceVersion": {
- "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "string"
},
"watch": {
- "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ "description": "Not supported, and ignored by Cloud Run.",
"location": "query",
"type": "boolean"
}
@@ -2166,7 +2194,7 @@
]
},
"replaceService": {
- "description": "Replace a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
+ "description": "Replaces a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}",
"httpMethod": "PUT",
"id": "run.projects.locations.services.replaceService",
@@ -2180,7 +2208,7 @@
"type": "string"
},
"name": {
- "description": "The name of the service being replaced. 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": "The fully qualified name of the service to replace. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$",
"required": true,
@@ -2261,7 +2289,7 @@
}
}
},
- "revision": "20220710",
+ "revision": "20220814",
"rootUrl": "https://run.googleapis.com/",
"schemas": {
"Addressable": {
@@ -2346,7 +2374,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
@@ -2359,8 +2387,14 @@
},
"type": "object"
},
+ "CancelExecutionRequest": {
+ "description": "Request message for cancelling an execution.",
+ "id": "CancelExecutionRequest",
+ "properties": {},
+ "type": "object"
+ },
"ConfigMapEnvSource": {
- "description": "Not supported by Cloud Run ConfigMapEnvSource selects a ConfigMap to populate the environment variables with. The contents of the target ConfigMap's Data field will represent the key-value pairs as environment variables.",
+ "description": "Not supported by Cloud Run. ConfigMapEnvSource selects a ConfigMap to populate the environment variables with. The contents of the target ConfigMap's Data field will represent the key-value pairs as environment variables.",
"id": "ConfigMapEnvSource",
"properties": {
"localObjectReference": {
@@ -2372,18 +2406,18 @@
"type": "string"
},
"optional": {
- "description": "(Optional) Specify whether the ConfigMap must be defined",
+ "description": "Specify whether the ConfigMap must be defined.",
"type": "boolean"
}
},
"type": "object"
},
"ConfigMapKeySelector": {
- "description": "Not supported by Cloud Run Selects a key from a ConfigMap.",
+ "description": "Not supported by Cloud Run. Selects a key from a ConfigMap.",
"id": "ConfigMapKeySelector",
"properties": {
"key": {
- "description": "The key to select.",
+ "description": "Required. The key to select.",
"type": "string"
},
"localObjectReference": {
@@ -2391,18 +2425,18 @@
"description": "This field should not be used directly as it is meant to be inlined directly into the message. Use the \"name\" field instead."
},
"name": {
- "description": "The ConfigMap to select from.",
+ "description": "Required. The ConfigMap to select from.",
"type": "string"
},
"optional": {
- "description": "(Optional) Specify whether the ConfigMap or its key must be defined",
+ "description": "Specify whether the ConfigMap or its key must be defined",
"type": "boolean"
}
},
"type": "object"
},
"ConfigMapVolumeSource": {
- "description": "Not supported by Cloud Run Adapts a ConfigMap into a volume. The contents of the target ConfigMap's Data field will be presented in a volume as files using the keys in the Data field as the file names, unless the items element is populated with specific mappings of keys to paths.",
+ "description": "Not supported by Cloud Run. Adapts a ConfigMap into a volume. The contents of the target ConfigMap's Data field will be presented in a volume as files using the keys in the Data field as the file names, unless the items element is populated with specific mappings of keys to paths.",
"id": "ConfigMapVolumeSource",
"properties": {
"defaultMode": {
@@ -2429,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/serving/blob/main/docs/spec/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. See also: https://github.com/knative/specs/blob/main/specs/serving/overview.md#configuration",
"id": "Configuration",
"properties": {
"apiVersion": {
@@ -2471,14 +2505,14 @@
"id": "ConfigurationStatus",
"properties": {
"conditions": {
- "description": "Conditions communicates information about ongoing/complete reconciliation processes that bring the \"spec\" inline with the observed state of the world.",
+ "description": "Conditions communicate information about ongoing/complete reconciliation processes that bring the \"spec\" inline with the observed state of the world.",
"items": {
"$ref": "GoogleCloudRunV1Condition"
},
"type": "array"
},
"latestCreatedRevisionName": {
- "description": "LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, for that use LatestReadyRevisionName.",
+ "description": "LatestCreatedRevisionName is the last revision that was created from this Configuration. It might not be ready yet, so for the latest ready revision, use LatestReadyRevisionName.",
"type": "string"
},
"latestReadyRevisionName": {
@@ -2498,50 +2532,51 @@
"id": "Container",
"properties": {
"args": {
- "description": "(Optional) Arguments to the entrypoint. The docker image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell",
+ "description": "Arguments to the entrypoint. The docker image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell",
"items": {
"type": "string"
},
"type": "array"
},
"command": {
+ "description": "Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell",
"items": {
"type": "string"
},
"type": "array"
},
"env": {
- "description": "(Optional) List of environment variables to set in the container.",
+ "description": "List of environment variables to set in the container.",
"items": {
"$ref": "EnvVar"
},
"type": "array"
},
"envFrom": {
- "description": "(Optional) List of sources to populate environment variables in the container. The keys defined within a source must be a C_IDENTIFIER. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Cannot be updated.",
+ "description": "Not supported by Cloud Run.",
"items": {
"$ref": "EnvFromSource"
},
"type": "array"
},
"image": {
- "description": "Only supports containers from Google Container Registry or Artifact Registry URL of the Container image. More info: https://kubernetes.io/docs/concepts/containers/images",
+ "description": "Required. URL of the Container image in Google Container Registry or Google Artifact Registry. More info: https://kubernetes.io/docs/concepts/containers/images",
"type": "string"
},
"imagePullPolicy": {
- "description": "(Optional) 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. More info: https://kubernetes.io/docs/concepts/containers/images#updating-images",
"type": "string"
},
"livenessProbe": {
"$ref": "Probe",
- "description": "(Optional) 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. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes"
},
"name": {
- "description": "(Optional) Name of the container specified as a DNS_LABEL. Currently unused in Cloud Run. 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. Currently unused in Cloud Run. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names",
"type": "string"
},
"ports": {
- "description": "(Optional) List of ports to expose from the container. Only a single port can be specified. The specified ports must be listening on all interfaces (0.0.0.0) within the container to be accessible. If omitted, a port number will be chosen and passed to the container through the PORT environment variable for the container to listen on.",
+ "description": "List of ports to expose from the container. Only a single port can be specified. The specified ports must be listening on all interfaces (0.0.0.0) within the container to be accessible. If omitted, a port number will be chosen and passed to the container through the PORT environment variable for the container to listen on.",
"items": {
"$ref": "ContainerPort"
},
@@ -2549,37 +2584,37 @@
},
"readinessProbe": {
"$ref": "Probe",
- "description": "(Optional) Periodic probe of container service readiness. Container will be removed from service endpoints if the probe fails. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes"
+ "description": "Not supported by Cloud Run."
},
"resources": {
"$ref": "ResourceRequirements",
- "description": "(Optional) Compute Resources required by this container. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
+ "description": "Compute Resources required by this container. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
},
"securityContext": {
"$ref": "SecurityContext",
- "description": "(Optional) Security options the pod should run with. More info: https://kubernetes.io/docs/concepts/policy/security-context/ More info: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/"
+ "description": "Not supported by Cloud Run."
},
"startupProbe": {
"$ref": "Probe",
- "description": "(Optional) Startup probe of application within the container. All other probes are disabled if a startup probe is provided, until it succeeds. Container will not be added to service endpoints if the probe fails. 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. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes"
},
"terminationMessagePath": {
- "description": "(Optional) 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.",
+ "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.",
"type": "string"
},
"terminationMessagePolicy": {
- "description": "(Optional) Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.",
+ "description": "Indicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure. FallbackToLogsOnError will use the last chunk of container log output if the termination message file is empty and the container exited with an error. The log output is limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to File. Cannot be updated.",
"type": "string"
},
"volumeMounts": {
- "description": "(Optional) Volume to mount into the container's filesystem. Only supports SecretVolumeSources. Pod volumes to mount into the container's filesystem.",
+ "description": "Volume to mount into the container's filesystem. Only supports SecretVolumeSources. Pod volumes to mount into the container's filesystem.",
"items": {
"$ref": "VolumeMount"
},
"type": "array"
},
"workingDir": {
- "description": "(Optional) Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image.",
+ "description": "Container's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image.",
"type": "string"
}
},
@@ -2590,16 +2625,16 @@
"id": "ContainerPort",
"properties": {
"containerPort": {
- "description": "(Optional) Port number the container listens on. This must be a valid port number, 0 \u003c x \u003c 65536.",
+ "description": "Port number the container listens on. This must be a valid port number, 0 \u003c x \u003c 65536.",
"format": "int32",
"type": "integer"
},
"name": {
- "description": "(Optional) If specified, used to specify which protocol to use. Allowed values are \"http1\" and \"h2c\".",
+ "description": "If specified, used to specify which protocol to use. Allowed values are \"http1\" and \"h2c\".",
"type": "string"
},
"protocol": {
- "description": "(Optional) Protocol for port. Must be \"TCP\". Defaults to \"TCP\".",
+ "description": "Protocol for port. Must be \"TCP\". Defaults to \"TCP\".",
"type": "string"
}
},
@@ -2646,7 +2681,7 @@
"enumDescriptions": [
"",
"Do not provision an HTTPS certificate.",
- "Automatically provisions an HTTPS certificate via GoogleCA or LetsEncrypt."
+ "Automatically provisions an HTTPS certificate via GoogleCA."
],
"type": "string"
},
@@ -2689,27 +2724,27 @@
"type": "array"
},
"url": {
- "description": "Optional. Cloud Run fully managed: not supported Cloud Run on GKE: supported Holds the URL that will serve the traffic of the DomainMapping.",
+ "description": "Optional. Not supported by Cloud Run.",
"type": "string"
}
},
"type": "object"
},
"EnvFromSource": {
- "description": "Not supported by Cloud Run EnvFromSource represents the source of a set of ConfigMaps",
+ "description": "Not supported by Cloud Run. EnvFromSource represents the source of a set of ConfigMaps",
"id": "EnvFromSource",
"properties": {
"configMapRef": {
"$ref": "ConfigMapEnvSource",
- "description": "(Optional) The ConfigMap to select from"
+ "description": "The ConfigMap to select from"
},
"prefix": {
- "description": "(Optional) An optional identifier to prepend to each key in the ConfigMap. Must be a C_IDENTIFIER.",
+ "description": "An optional identifier to prepend to each key in the ConfigMap. Must be a C_IDENTIFIER.",
"type": "string"
},
"secretRef": {
"$ref": "SecretEnvSource",
- "description": "(Optional) The Secret to select from"
+ "description": "The Secret to select from"
}
},
"type": "object"
@@ -2719,16 +2754,16 @@
"id": "EnvVar",
"properties": {
"name": {
- "description": "Name of the environment variable. Must be a C_IDENTIFIER.",
+ "description": "Required. Name of the environment variable. Must be a C_IDENTIFIER.",
"type": "string"
},
"value": {
- "description": "(Optional) Variable references $(VAR_NAME) are expanded using the previous defined environment variables in the container and any route environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to \"\".",
+ "description": "Variable references $(VAR_NAME) are expanded using the previous defined environment variables in the container and any route environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to \"\".",
"type": "string"
},
"valueFrom": {
"$ref": "EnvVarSource",
- "description": "(Optional) Source for the environment variable's value. Only supports secret_key_ref. Source for the environment variable's value. Cannot be used if value is not empty."
+ "description": "Source for the environment variable's value. Only supports secret_key_ref. Cannot be used if value is not empty."
}
},
"type": "object"
@@ -2739,21 +2774,21 @@
"properties": {
"configMapKeyRef": {
"$ref": "ConfigMapKeySelector",
- "description": "(Optional) Not supported by Cloud Run Selects a key of a ConfigMap."
+ "description": "Not supported by Cloud Run. Selects a key of a ConfigMap."
},
"secretKeyRef": {
"$ref": "SecretKeySelector",
- "description": "(Optional) Selects a key (version) of a secret in Secret Manager."
+ "description": "Selects a key (version) of a secret in Secret Manager."
}
},
"type": "object"
},
"ExecAction": {
- "description": "Not supported by Cloud Run ExecAction describes a \"run in container\" action.",
+ "description": "Not supported by Cloud Run. ExecAction describes a \"run in container\" action.",
"id": "ExecAction",
"properties": {
"command": {
- "description": "(Optional) Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.",
+ "description": "Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.",
"items": {
"type": "string"
},
@@ -2763,28 +2798,28 @@
"type": "object"
},
"Execution": {
- "description": "Execution represents the configuration of a single execution. A execution an immutable resource that references a container image which is run to completion.",
+ "description": "Execution represents the configuration of a single execution. An execution is an immutable resource that references a container image which is run to completion.",
"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 +optional",
+ "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",
"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 +optional",
+ "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",
"type": "string"
},
"metadata": {
"$ref": "ObjectMeta",
- "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata +optional"
+ "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata"
},
"spec": {
"$ref": "ExecutionSpec",
- "description": "Optional. Specification of the desired behavior of an execution. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status +optional"
+ "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"
},
"status": {
"$ref": "ExecutionStatus",
- "description": "Output only. Current status of an execution. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status +optional",
+ "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",
"readOnly": true
}
},
@@ -2816,12 +2851,12 @@
"id": "ExecutionSpec",
"properties": {
"parallelism": {
- "description": "Optional. Specifies the maximum desired number of tasks the execution should run at given time. Must be \u003c= task_count. When the job is run, if this field is 0 or unset, the maximum possible value will be used for that execution. The actual number of tasks running in steady state will be less than this number when there are fewer tasks waiting to be completed remaining, i.e. when the work left to do is less than max parallelism. +optional",
+ "description": "Optional. Specifies the maximum desired number of tasks the execution should run at given time. Must be \u003c= task_count. When the job is run, if this field is 0 or unset, the maximum possible value will be used for that execution. The actual number of tasks running in steady state will be less than this number when there are fewer tasks waiting to be completed, i.e. when the work left to do is less than max parallelism.",
"format": "int32",
"type": "integer"
},
"taskCount": {
- "description": "Optional. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ +optional",
+ "description": "Optional. Specifies the desired number of tasks the execution should run. Setting to 1 means that parallelism is limited to 1 and the success of that task signals the success of the execution.",
"format": "int32",
"type": "integer"
},
@@ -2833,28 +2868,28 @@
"type": "object"
},
"ExecutionStatus": {
- "description": "ExecutionStatus represents the current state of a Execution.",
+ "description": "ExecutionStatus represents the current state of an Execution.",
"id": "ExecutionStatus",
"properties": {
"cancelledCount": {
- "description": "Optional. The number of tasks which reached phase Cancelled. +optional",
+ "description": "Optional. The number of tasks which reached phase Cancelled.",
"format": "int32",
"type": "integer"
},
"completionTime": {
- "description": "Optional. Represents time when the execution was completed. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC. +optional",
+ "description": "Optional. Represents the time that the execution was completed. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC. +optional",
"format": "google-datetime",
"type": "string"
},
"conditions": {
- "description": "Optional. The latest available observations of an execution's current state. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ +optional",
+ "description": "Optional. The latest available observations of an execution's current state.",
"items": {
"$ref": "GoogleCloudRunV1Condition"
},
"type": "array"
},
"failedCount": {
- "description": "Optional. The number of tasks which reached phase Failed. +optional",
+ "description": "Optional. The number of tasks which reached phase Failed.",
"format": "int32",
"type": "integer"
},
@@ -2868,22 +2903,22 @@
"type": "integer"
},
"retriedCount": {
- "description": "Optional. The number of tasks which have retried at least once. +optional",
+ "description": "Optional. The number of tasks which have retried at least once.",
"format": "int32",
"type": "integer"
},
"runningCount": {
- "description": "Optional. The number of actively running tasks. +optional",
+ "description": "Optional. The number of actively running tasks.",
"format": "int32",
"type": "integer"
},
"startTime": {
- "description": "Optional. Represents time when the execution started to run. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC. +optional",
+ "description": "Optional. Represents the time that the execution started to run. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC.",
"format": "google-datetime",
"type": "string"
},
"succeededCount": {
- "description": "Optional. The number of tasks which reached phase Succeeded. +optional",
+ "description": "Optional. The number of tasks which reached phase Succeeded.",
"format": "int32",
"type": "integer"
}
@@ -2929,7 +2964,7 @@
"type": "object"
},
"GRPCAction": {
- "description": "Not supported by Cloud Run GRPCAction describes an action involving a GRPC port.",
+ "description": "GRPCAction describes an action involving a GRPC port.",
"id": "GRPCAction",
"properties": {
"port": {
@@ -2945,7 +2980,7 @@
"type": "object"
},
"GoogleCloudRunV1Condition": {
- "description": "Condition defines a generic condition for a Resource.",
+ "description": "Conditions show the status of reconciliation progress on a given resource. Most resource use a top-level condition type \"Ready\" or \"Completed\" to show overall status with other conditions to checkpoint each stage of reconciliation. Note that if metadata.Generation does not equal status.ObservedGeneration, the conditions shown may not be relevant for the current spec.",
"id": "GoogleCloudRunV1Condition",
"properties": {
"lastTransitionTime": {
@@ -2958,11 +2993,11 @@
"type": "string"
},
"reason": {
- "description": "Optional. One-word CamelCase reason for the condition's last transition.",
+ "description": "Optional. One-word CamelCase reason for the condition's last transition. These are intended to be stable, unique values which the client may use to trigger error handling logic, whereas messages which may be changed later by the server.",
"type": "string"
},
"severity": {
- "description": "Optional. How to interpret failures of this condition, one of Error, Warning, Info",
+ "description": "Optional. How to interpret this condition. One of Error, Warning, or Info. Conditions of severity Info do not contribute to resource readiness.",
"type": "string"
},
"status": {
@@ -2970,7 +3005,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\": True when the Resource is ready.",
+ "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.",
"type": "string"
}
},
@@ -3004,33 +3039,33 @@
"type": "object"
},
"HTTPGetAction": {
- "description": "Not supported by Cloud Run HTTPGetAction describes an action based on HTTP Get requests.",
+ "description": "HTTPGetAction describes an action based on HTTP Get requests.",
"id": "HTTPGetAction",
"properties": {
"host": {
- "description": "(Optional) Host name to connect to, defaults to the pod IP. You probably want to set \"Host\" in httpHeaders instead.",
+ "description": "Not supported by Cloud Run.",
"type": "string"
},
"httpHeaders": {
- "description": "(Optional) Custom headers to set in the request. HTTP allows repeated headers.",
+ "description": "Custom headers to set in the request. HTTP allows repeated headers.",
"items": {
"$ref": "HTTPHeader"
},
"type": "array"
},
"path": {
- "description": "(Optional) Path to access on the HTTP server.",
+ "description": "Path to access on the HTTP server.",
"type": "string"
},
"scheme": {
- "description": "(Optional) Scheme to use for connecting to the host. Defaults to HTTP.",
+ "description": "Not supported by Cloud Run.",
"type": "string"
}
},
"type": "object"
},
"HTTPHeader": {
- "description": "Not supported by Cloud Run HTTPHeader describes a custom header to be used in HTTP probes",
+ "description": "HTTPHeader describes a custom header to be used in HTTP probes",
"id": "HTTPHeader",
"properties": {
"name": {
@@ -3045,28 +3080,28 @@
"type": "object"
},
"Job": {
- "description": "Job represents the configuration of a single job. A job an immutable resource that references a container image which is run to completion.",
+ "description": "Job represents the configuration of a single job, which references a container image which is run to completion.",
"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 +optional",
+ "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",
"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 +optional",
+ "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",
"type": "string"
},
"metadata": {
"$ref": "ObjectMeta",
- "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata +optional"
+ "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata"
},
"spec": {
"$ref": "JobSpec",
- "description": "Optional. Specification of the desired behavior of a job. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status +optional"
+ "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"
},
"status": {
"$ref": "JobStatus",
- "description": "Output only. Current status of a job. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status +optional",
+ "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",
"readOnly": true
}
},
@@ -3088,7 +3123,7 @@
"id": "JobStatus",
"properties": {
"conditions": {
- "description": "The latest available observations of a job's current state. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/",
+ "description": "The latest available observations of a job's current state. More info: https://kubernetes.io/docs/concepts/workloads/controllers/job/",
"items": {
"$ref": "GoogleCloudRunV1Condition"
},
@@ -3300,19 +3335,19 @@
"type": "object"
},
"ListMeta": {
- "description": "ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.",
+ "description": "Metadata for synthetic resources like List. In Cloud Run, all List Resources Responses will have a ListMeta instead of ObjectMeta.",
"id": "ListMeta",
"properties": {
"continue": {
- "description": "continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response.",
+ "description": "Continuation token is a value emitted when the count of items is larger than the user/system limit. To retrieve the next page of items, pass the value of `continue` as the next request's `page_token`.",
"type": "string"
},
"resourceVersion": {
- "description": "String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency +optional",
+ "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",
"type": "string"
},
"selfLink": {
- "description": "SelfLink is a URL representing this object. Populated by the system. Read-only. +optional",
+ "description": "URL representing this object.",
"type": "string"
}
},
@@ -3389,7 +3424,7 @@
"id": "ListServicesResponse",
"properties": {
"apiVersion": {
- "description": "The API version for this call such as \"serving.knative.dev/v1\".",
+ "description": "The API version for this call; returns \"serving.knative.dev/v1\".",
"type": "string"
},
"items": {
@@ -3400,7 +3435,7 @@
"type": "array"
},
"kind": {
- "description": "The kind of this resource, in this case \"ServiceList\".",
+ "description": "The kind of this resource; returns \"ServiceList\".",
"type": "string"
},
"metadata": {
@@ -3408,7 +3443,7 @@
"description": "Metadata associated with this Service list."
},
"unreachable": {
- "description": "Locations that could not be reached.",
+ "description": "For calls against the global endpoint, returns the list of Cloud locations that could not be reached. For regional calls, this field is not used.",
"items": {
"type": "string"
},
@@ -3451,11 +3486,11 @@
"type": "object"
},
"LocalObjectReference": {
- "description": "Not supported by Cloud Run LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.",
+ "description": "Not supported by Cloud Run. LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.",
"id": "LocalObjectReference",
"properties": {
"name": {
- "description": "(Optional) Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
+ "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
"type": "string"
}
},
@@ -3503,41 +3538,41 @@
"additionalProperties": {
"type": "string"
},
- "description": "(Optional) Annotations is an 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. 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/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/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",
"type": "object"
},
"clusterName": {
- "description": "(Optional) Not supported by Cloud Run The name of the cluster which the object belongs to. This is used to distinguish resources with same name and namespace in different clusters. This field is not set anywhere right now and apiserver is going to ignore it if set in create or update request.",
+ "description": "Not supported by Cloud Run",
"type": "string"
},
"creationTimestamp": {
- "description": "(Optional) CreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC. Populated by the system. Read-only. Null for lists. 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. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata",
"format": "google-datetime",
"type": "string"
},
"deletionGracePeriodSeconds": {
- "description": "(Optional) Not supported by Cloud Run Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.",
+ "description": "Not supported by Cloud Run",
"format": "int32",
"type": "integer"
},
"deletionTimestamp": {
- "description": "(Optional) Not supported by Cloud Run DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource is expected to be deleted (no longer visible from resource lists, and not reachable by name) after the time in this field, once the finalizers list is empty. As long as the finalizers list contains items, deletion is blocked. Once the deletionTimestamp is set, this value may not be unset or be set further into the future, although it may be shortened or the resource may be deleted prior to this time. For example, a user may request that a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) to the container and after cleanup, remove the pod from the API. In the presence of network partitions, this object may still exist after this timestamp, until an administrator or automated process can determine the resource is fully terminated. If not set, graceful deletion of the object has not been requested. Populated by the system when a graceful deletion is requested. Read-only. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata",
+ "description": "The read-only soft deletion timestamp for this resource. In Cloud Run, users are not able to set this field. Instead, they must call the corresponding Delete API.",
"format": "google-datetime",
"type": "string"
},
"finalizers": {
- "description": "(Optional) Not supported by Cloud Run Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. +patchStrategy=merge",
+ "description": "Not supported by Cloud Run",
"items": {
"type": "string"
},
"type": "array"
},
"generateName": {
- "description": "(Optional) Not supported by Cloud Run GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server. If this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header). Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency string generateName = 2;",
+ "description": "Not supported by Cloud Run",
"type": "string"
},
"generation": {
- "description": "(Optional) A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.",
+ "description": "A system-provided sequence number representing a specific generation of the desired state.",
"format": "int32",
"type": "integer"
},
@@ -3545,65 +3580,65 @@
"additionalProperties": {
"type": "string"
},
- "description": "(Optional) 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. More info: https://kubernetes.io/docs/user-guide/labels",
"type": "object"
},
"name": {
- "description": "Name must be unique within a namespace, within a Cloud Run region. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/user-guide/identifiers#names +optional",
+ "description": "The immutable name of the resource. In Cloud Run, name is required when creating top-level resources (Service, Job), and must be unique within a Cloud Run project/region. More info: https://kubernetes.io/docs/user-guide/identifiers#names If ObjectMeta is part of a CreateServiceRequest, name must contain fewer than 50 characters. Otherwise,",
"type": "string"
},
"namespace": {
- "description": "Namespace defines the space within each name must be unique, within a Cloud Run region. In Cloud Run the namespace must be equal to either the project ID or project number.",
+ "description": "Defines the space within each name must be unique within a Cloud Run region. In Cloud Run, it must be project ID or number.",
"type": "string"
},
"ownerReferences": {
- "description": "(Optional) Not supported by Cloud Run List of objects that own this object. If ALL objects in the list have been deleted, this object will be garbage collected.",
+ "description": "Not supported by Cloud Run",
"items": {
"$ref": "OwnerReference"
},
"type": "array"
},
"resourceVersion": {
- "description": "Optional. An opaque 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. They may only be valid for a particular resource or set of resources. Populated by the system. Read-only. Value must be treated as opaque by clients or omitted. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
+ "description": "Optional. 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",
"type": "string"
},
"selfLink": {
- "description": "(Optional) SelfLink is a URL representing this object. Populated by the system. Read-only. string selfLink = 4;",
+ "description": "URL representing this object.",
"type": "string"
},
"uid": {
- "description": "(Optional) UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations. Populated by the system. Read-only. More info: https://kubernetes.io/docs/user-guide/identifiers#uids",
+ "description": "Unique, system-generated identifier for this resource. More info: https://kubernetes.io/docs/user-guide/identifiers#uids",
"type": "string"
}
},
"type": "object"
},
"OwnerReference": {
- "description": "OwnerReference contains enough information to let you identify an owning object. Currently, an owning object must be in the same namespace, so there is no namespace field.",
+ "description": "This is not supported or used by Cloud Run.",
"id": "OwnerReference",
"properties": {
"apiVersion": {
- "description": "API version of the referent.",
+ "description": "This is not supported or used by Cloud Run.",
"type": "string"
},
"blockOwnerDeletion": {
- "description": "If true, AND if the owner has the \"foregroundDeletion\" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. Defaults to false. To set this field, a user needs \"delete\" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned. +optional",
+ "description": "This is not supported or used by Cloud Run.",
"type": "boolean"
},
"controller": {
- "description": "If true, this reference points to the managing controller. +optional",
+ "description": "This is not supported or used by Cloud Run.",
"type": "boolean"
},
"kind": {
- "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
+ "description": "This is not supported or used by Cloud Run.",
"type": "string"
},
"name": {
- "description": "Name of the referent. More info: https://kubernetes.io/docs/user-guide/identifiers#names",
+ "description": "This is not supported or used by Cloud Run.",
"type": "string"
},
"uid": {
- "description": "UID of the referent. More info: https://kubernetes.io/docs/user-guide/identifiers#uids",
+ "description": "This is not supported or used by Cloud Run.",
"type": "string"
}
},
@@ -3641,47 +3676,47 @@
"type": "object"
},
"Probe": {
- "description": "Not supported by Cloud Run Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.",
+ "description": "Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.",
"id": "Probe",
"properties": {
"exec": {
"$ref": "ExecAction",
- "description": "(Optional) Not supported by Cloud Run One and only one of the following should be specified. Exec specifies the action to take. A field inlined from the Handler message."
+ "description": "Not supported by Cloud Run."
},
"failureThreshold": {
- "description": "(Optional) Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1.",
+ "description": "Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1.",
"format": "int32",
"type": "integer"
},
"grpc": {
"$ref": "GRPCAction",
- "description": "(Optional) GRPCAction specifies an action involving a GRPC port. A field inlined from the Handler message."
+ "description": "GRPCAction specifies an action involving a GRPC port."
},
"httpGet": {
"$ref": "HTTPGetAction",
- "description": "(Optional) HTTPGet specifies the http request to perform. A field inlined from the Handler message."
+ "description": "HTTPGet specifies the http request to perform."
},
"initialDelaySeconds": {
- "description": "(Optional) 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. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes",
"format": "int32",
"type": "integer"
},
"periodSeconds": {
- "description": "(Optional) How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Maximum value for liveness probe is 3600. Maximum value for startup probe is 240. Must be greater or equal than timeout_seconds.",
+ "description": "How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Maximum value for liveness probe is 3600. Maximum value for startup probe is 240. Must be greater or equal than timeout_seconds.",
"format": "int32",
"type": "integer"
},
"successThreshold": {
- "description": "(Optional) Minimum consecutive successes for the probe to be considered successful after having failed. Must be 1 if set.",
+ "description": "Minimum consecutive successes for the probe to be considered successful after having failed. Must be 1 if set.",
"format": "int32",
"type": "integer"
},
"tcpSocket": {
"$ref": "TCPSocketAction",
- "description": "(Optional) TCPSocket specifies an action involving a TCP port. TCP hooks not yet supported A field inlined from the Handler message."
+ "description": "TCPSocket specifies an action involving a TCP port."
},
"timeoutSeconds": {
- "description": "(Optional) 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. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes",
"format": "int32",
"type": "integer"
}
@@ -3727,21 +3762,21 @@
"additionalProperties": {
"type": "string"
},
- "description": "(Optional) 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": "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",
"type": "object"
},
"requests": {
"additionalProperties": {
"type": "string"
},
- "description": "(Optional) 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": "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",
"type": "object"
}
},
"type": "object"
},
"Revision": {
- "description": "Revision is an immutable snapshot of code and configuration. A revision references a container image. Revisions are created by updates to a Configuration. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision",
+ "description": "Revision is an immutable snapshot of code and configuration. A revision references a container image. Revisions are created by updates to a Configuration. See also: https://github.com/knative/specs/blob/main/specs/serving/overview.md#revision",
"id": "Revision",
"properties": {
"apiVersion": {
@@ -3772,23 +3807,23 @@
"id": "RevisionSpec",
"properties": {
"containerConcurrency": {
- "description": "ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container instance of the Revision. Cloud Run fully managed: supported, defaults to 80 Cloud Run for Anthos: supported, defaults to 0, which means concurrency to the application is not limited, and the system decides the target concurrency for the autoscaler.",
+ "description": "ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container instance of the Revision. Cloud Run: supported, defaults to 80",
"format": "int32",
"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/serving/blob/main/docs/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. The runtime contract is documented here: https://github.com/knative/specs/blob/main/specs/serving/runtime-contract.md",
"items": {
"$ref": "Container"
},
"type": "array"
},
"enableServiceLinks": {
- "description": "Indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links. Cloud Run fully managed: Not supported. Cloud Run for Anthos: supported, defaults to true.",
+ "description": "Not supported by Cloud Run.",
"type": "boolean"
},
"imagePullSecrets": {
- "description": "ImagePullSecrets is a list of references to secrets in the same namespace to use for pulling any images in pods that reference this ServiceAccount. ImagePullSecrets are distinct from Secrets because Secrets can be mounted in the pod, but ImagePullSecrets are only accessed by the kubelet. More info: https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod Cloud Run fully managed: Not supported. Cloud Run for Anthos: supported.",
+ "description": "Not supported by Cloud Run.",
"items": {
"$ref": "LocalObjectReference"
},
@@ -3799,7 +3834,7 @@
"type": "string"
},
"timeoutSeconds": {
- "description": "TimeoutSeconds holds the max duration the instance is allowed for responding to a request. Cloud Run fully managed: defaults to 300 seconds (5 minutes). Maximum allowed value is 3600 seconds (1 hour). Cloud Run for Anthos: defaults to 300 seconds (5 minutes). Maximum allowed value is configurable by the cluster operator.",
+ "description": "TimeoutSeconds holds the max duration the instance is allowed for responding to a request. Cloud Run: defaults to 300 seconds (5 minutes). Maximum allowed value is 3600 seconds (1 hour).",
"format": "int32",
"type": "integer"
},
@@ -3859,7 +3894,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/serving/blob/main/docs/spec/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. 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.",
"id": "Route",
"properties": {
"apiVersion": {
@@ -3920,7 +3955,7 @@
"type": "integer"
},
"traffic": {
- "description": "Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.",
+ "description": "Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that was last observed.",
"items": {
"$ref": "TrafficTarget"
},
@@ -3940,7 +3975,7 @@
"type": "object"
},
"SecretEnvSource": {
- "description": "Not supported by Cloud Run SecretEnvSource selects a Secret to populate the environment variables with. The contents of the target Secret's Data field will represent the key-value pairs as environment variables.",
+ "description": "Not supported by Cloud Run. SecretEnvSource selects a Secret to populate the environment variables with. The contents of the target Secret's Data field will represent the key-value pairs as environment variables.",
"id": "SecretEnvSource",
"properties": {
"localObjectReference": {
@@ -3952,7 +3987,7 @@
"type": "string"
},
"optional": {
- "description": "(Optional) Specify whether the Secret must be defined",
+ "description": "Specify whether the Secret must be defined",
"type": "boolean"
}
},
@@ -3963,7 +3998,7 @@
"id": "SecretKeySelector",
"properties": {
"key": {
- "description": "A Cloud Secret Manager secret version. Must be 'latest' for the latest version or an integer for a specific version. The key of the secret to select from. Must be a valid secret key.",
+ "description": "Required. A Cloud Secret Manager secret version. Must be 'latest' for the latest version or an integer for a specific version. The key of the secret to select from. Must be a valid secret key.",
"type": "string"
},
"localObjectReference": {
@@ -3975,14 +4010,14 @@
"type": "string"
},
"optional": {
- "description": "(Optional) Specify whether the Secret or its key must be defined",
+ "description": "Specify whether the Secret or its key must be defined.",
"type": "boolean"
}
},
"type": "object"
},
"SecretVolumeSource": {
- "description": "The secret's value will be presented as the content of a file whose name is defined in the item path. If no items are defined, the name of the file is the secret_name. The contents of the target Secret's Data field will be presented in a volume as files using the keys in the Data field as the file names.",
+ "description": "A volume representing a secret stored in Google Secret Manager. The secret's value will be presented as the content of a file whose name is defined in the item path. If no items are defined, the name of the file is the secret_name. The contents of the target Secret's Data field will be presented in a volume as files using the keys in the Data field as the file names.",
"id": "SecretVolumeSource",
"properties": {
"defaultMode": {
@@ -3991,14 +4026,14 @@
"type": "integer"
},
"items": {
- "description": "(Optional) If unspecified, the volume will expose a file whose name is the secret_name. If specified, the key will be used as the version to fetch from Cloud Secret Manager and the path will be the name of the file exposed in the volume. When items are defined, they must specify a key and a path. If unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified that is not present in the Secret, the volume setup will error unless it is marked optional.",
+ "description": "A list of secret versions to mount in the volume. If no items are specified, the volume will expose a file with the same name as the secret name. The contents of the file will be the data in the latest version of the secret. If items are specified, the key will be used as the version to fetch from Cloud Secret Manager and the path will be the name of the file exposed in the volume. When items are defined, they must specify both a key and a path.",
"items": {
"$ref": "KeyToPath"
},
"type": "array"
},
"optional": {
- "description": "(Optional) Specify whether the Secret or its keys must be defined.",
+ "description": "Not supported by Cloud Run.",
"type": "boolean"
},
"secretName": {
@@ -4009,11 +4044,11 @@
"type": "object"
},
"SecurityContext": {
- "description": "Not supported by Cloud Run SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext. When both are set, the values in SecurityContext take precedence.",
+ "description": "Not supported by Cloud Run. SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext. When both are set, the values in SecurityContext take precedence.",
"id": "SecurityContext",
"properties": {
"runAsUser": {
- "description": "(Optional) The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in PodSecurityContext. If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.",
+ "description": "The UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in PodSecurityContext. If set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.",
"format": "int32",
"type": "integer"
}
@@ -4025,24 +4060,24 @@
"id": "Service",
"properties": {
"apiVersion": {
- "description": "The API version for this call such as \"serving.knative.dev/v1\".",
+ "description": "The API version for this call. It must be \"serving.knative.dev/v1\".",
"type": "string"
},
"kind": {
- "description": "The kind of resource, in this case \"Service\".",
+ "description": "The kind of resource. It must be \"Service\".",
"type": "string"
},
"metadata": {
"$ref": "ObjectMeta",
- "description": "Metadata associated with this Service, including name, namespace, labels, and annotations. Cloud Run (fully managed) uses the following annotation keys to configure features on a Service: * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal."
+ "description": "Metadata associated with this Service, including name, namespace, labels, and annotations. 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. The following Cloud Run-specific annotations are accepted in Service.metadata.annotations. * `run.googleapis.com/binary-authorization-breakglass` * `run.googleapis.com/binary-authorization` * `run.googleapis.com/client-name` * `run.googleapis.com/custom-audiences` * `run.googleapis.com/description` * `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` * `run.googleapis.com/ingress` sets the ingress settings for the Service. See [the ingress settings documentation](/run/docs/securing/ingress) for details on configuring ingress settings. * `run.googleapis.com/ingress-status` is output-only and contains the currently active ingress settings for the Service. `run.googleapis.com/ingress-status` may differ from `run.googleapis.com/ingress` while the system is processing a change to `run.googleapis.com/ingress` or if the system failed to process a change to `run.googleapis.com/ingress`. When the system has processed all changes successfully `run.googleapis.com/ingress-status` and `run.googleapis.com/ingress` are equal."
},
"spec": {
"$ref": "ServiceSpec",
- "description": "Spec holds the desired state of the Service (from the client)."
+ "description": "Holds the desired state of the Service (from the client)."
},
"status": {
"$ref": "ServiceStatus",
- "description": "Status communicates the observed state of the Service (from the controller)."
+ "description": "Communicates the system-controlled state of the Service."
}
},
"type": "object"
@@ -4053,10 +4088,10 @@
"properties": {
"template": {
"$ref": "RevisionTemplate",
- "description": "Template holds the latest specification for the Revision to be stamped out."
+ "description": "Holds the latest specification for the Revision to be stamped out."
},
"traffic": {
- "description": "Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations.",
+ "description": "Specifies how to distribute traffic over a collection of Knative Revisions and Configurations to the Service's main URL.",
"items": {
"$ref": "TrafficTarget"
},
@@ -4071,37 +4106,37 @@
"properties": {
"address": {
"$ref": "Addressable",
- "description": "From RouteStatus. Similar to url, information on where the service is available on HTTP."
+ "description": "Similar to url, information on where the service is available on HTTP."
},
"conditions": {
- "description": "Conditions communicates information about ongoing/complete reconciliation processes that bring the \"spec\" inline with the observed state of the world. Service-specific conditions include: * \"ConfigurationsReady\": true when the underlying Configuration is ready. * \"RoutesReady\": true when the underlying Route is ready. * \"Ready\": true when both the underlying Route and Configuration are ready.",
+ "description": "Communicates information about ongoing/complete reconciliation processes that bring the `spec` inline with the observed state of the world. Service-specific conditions include: * `ConfigurationsReady`: `True` when the underlying Configuration is ready. * `RoutesReady`: `True` when the underlying Route is ready. * `Ready`: `True` when all underlying resources are ready.",
"items": {
"$ref": "GoogleCloudRunV1Condition"
},
"type": "array"
},
"latestCreatedRevisionName": {
- "description": "From ConfigurationStatus. LatestCreatedRevisionName is the last revision that was created from this Service's Configuration. It might not be ready yet, for that use LatestReadyRevisionName.",
+ "description": "Name of the last revision that was created from this Service's Configuration. It might not be ready yet, for that use LatestReadyRevisionName.",
"type": "string"
},
"latestReadyRevisionName": {
- "description": "From ConfigurationStatus. LatestReadyRevisionName holds the name of the latest Revision stamped out from this Service's Configuration that has had its \"Ready\" condition become \"True\".",
+ "description": "Name of the latest Revision from this Service's Configuration that has had its `Ready` condition become `True`.",
"type": "string"
},
"observedGeneration": {
- "description": "ObservedGeneration is the 'Generation' of the Route that was last processed by the controller. Clients polling for completed reconciliation should poll until observedGeneration = metadata.generation and the Ready condition's status is True or False.",
+ "description": "Returns the generation last fully processed by the system. This will only match metadata.generation when reconciliation is complete. Clients polling for completed reconciliation should poll until observedGeneration = metadata.generation and the Ready condition's status is True or False.",
"format": "int32",
"type": "integer"
},
"traffic": {
- "description": "From RouteStatus. Traffic holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.",
+ "description": "Holds the configured traffic distribution. These entries will always contain RevisionName references. When ConfigurationName appears in the spec, this will hold the LatestReadyRevisionName that we last observed.",
"items": {
"$ref": "TrafficTarget"
},
"type": "array"
},
"url": {
- "description": "From RouteStatus. URL holds the url that will distribute traffic over the provided traffic targets. It generally has the form https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app",
+ "description": "URL that will distribute traffic over the provided traffic targets. It generally has the form https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app",
"type": "string"
}
},
@@ -4124,32 +4159,32 @@
"type": "object"
},
"Status": {
- "description": "Status is a return value for calls that don't return other objects",
+ "description": "Status is a return value for calls that don't return other objects.",
"id": "Status",
"properties": {
"code": {
- "description": "Suggested HTTP return code for this status, 0 if not set. +optional",
+ "description": "Suggested HTTP return code for this status, 0 if not set.",
"format": "int32",
"type": "integer"
},
"details": {
"$ref": "StatusDetails",
- "description": "Extended data associated with the reason. Each reason may define its own extended details. This field is optional and the data returned is not guaranteed to conform to any schema except that defined by the reason type. +optional"
+ "description": "Extended data associated with the reason. Each reason may define its own extended details. This field is optional and the data returned is not guaranteed to conform to any schema except that defined by the reason type."
},
"message": {
- "description": "A human-readable description of the status of this operation. +optional",
+ "description": "A human-readable description of the status of this operation.",
"type": "string"
},
"metadata": {
"$ref": "ListMeta",
- "description": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds +optional"
+ "description": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds"
},
"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. +optional",
+ "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 +optional",
+ "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",
"type": "string"
}
},
@@ -4160,15 +4195,15 @@
"id": "StatusCause",
"properties": {
"field": {
- "description": "The field of the resource that has caused this error, as named by its JSON serialization. May include dot and postfix notation for nested attributes. Arrays are zero-indexed. Fields may appear more than once in an array of causes due to fields having multiple errors. Optional. Examples: \"name\" - the field \"name\" on the current resource \"items[0].name\" - the field \"name\" on the first array entry in \"items\" +optional",
+ "description": "The field of the resource that has caused this error, as named by its JSON serialization. May include dot and postfix notation for nested attributes. Arrays are zero-indexed. Fields may appear more than once in an array of causes due to fields having multiple errors. Examples: \"name\" - the field \"name\" on the current resource \"items[0].name\" - the field \"name\" on the first array entry in \"items\"",
"type": "string"
},
"message": {
- "description": "A human-readable description of the cause of the error. This field may be presented as-is to a reader. +optional",
+ "description": "A human-readable description of the cause of the error. This field may be presented as-is to a reader.",
"type": "string"
},
"reason": {
- "description": "A machine-readable description of the cause of the error. If this value is empty there is no information available. +optional",
+ "description": "A machine-readable description of the cause of the error. If this value is empty there is no information available.",
"type": "string"
}
},
@@ -4179,46 +4214,46 @@
"id": "StatusDetails",
"properties": {
"causes": {
- "description": "The Causes array includes more details associated with the StatusReason failure. Not all StatusReasons may provide detailed causes. +optional",
+ "description": "The Causes array includes more details associated with the StatusReason failure. Not all StatusReasons may provide detailed causes.",
"items": {
"$ref": "StatusCause"
},
"type": "array"
},
"group": {
- "description": "The group attribute of the resource associated with the status StatusReason. +optional",
+ "description": "The group attribute of the resource associated with the status StatusReason.",
"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 +optional",
+ "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",
"type": "string"
},
"name": {
- "description": "The name attribute of the resource associated with the status StatusReason (when there is a single name which can be described). +optional",
+ "description": "The name attribute of the resource associated with the status StatusReason (when there is a single name which can be described).",
"type": "string"
},
"retryAfterSeconds": {
- "description": "If specified, the time in seconds before the operation should be retried. Some errors may indicate the client must take an alternate action - for those errors this field may indicate how long to wait before taking the alternate action. +optional",
+ "description": "If specified, the time in seconds before the operation should be retried. Some errors may indicate the client must take an alternate action - for those errors this field may indicate how long to wait before taking the alternate action.",
"format": "int32",
"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 +optional",
+ "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",
"type": "string"
}
},
"type": "object"
},
"TCPSocketAction": {
- "description": "Not supported by Cloud Run TCPSocketAction describes an action based on opening a socket",
+ "description": "TCPSocketAction describes an action based on opening a socket",
"id": "TCPSocketAction",
"properties": {
"host": {
- "description": "(Optional) Optional: Host name to connect to, defaults to the pod IP.",
+ "description": "Not supported by Cloud Run.",
"type": "string"
},
"port": {
- "description": "Number or name of the port to access on the container. Number must be in the range 1 to 65535. Name must be an IANA_SVC_NAME. This field is currently limited to integer types only because of proto's inability to properly support the IntOrString golang type.",
+ "description": "Port number to access on the container. Number must be in the range 1 to 65535.",
"format": "int32",
"type": "integer"
}
@@ -4230,24 +4265,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 +optional",
+ "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",
"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 +optional",
+ "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",
"type": "string"
},
"metadata": {
"$ref": "ObjectMeta",
- "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata +optional"
+ "description": "Optional. Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata"
},
"spec": {
"$ref": "TaskSpec",
- "description": "Optional. Specification of the desired behavior of an execution. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status +optional"
+ "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"
},
"status": {
"$ref": "TaskStatus",
- "description": "Output only. Current status of an execution. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status +optional",
+ "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",
"readOnly": true
}
},
@@ -4286,16 +4321,16 @@
"type": "integer"
},
"serviceAccountName": {
- "description": "Optional. Email address of the IAM service account associated with the task of a job execution. The service account represents the identity of the running task, and determines what permissions the task has. If not provided, the task will use the project's default service account. +optional",
+ "description": "Optional. Email address of the IAM service account associated with the task of a job execution. The service account represents the identity of the running task, and determines what permissions the task has. If not provided, the task will use the project's default service account.",
"type": "string"
},
"timeoutSeconds": {
- "description": "Optional. Optional duration in seconds the task may be active before the system will actively try to mark it failed and kill associated containers. This applies per attempt of a task, meaning each retry can run for the full timeout. +optional",
+ "description": "Optional. Duration in seconds the task may be active before the system will actively try to mark it failed and kill associated containers. This applies per attempt of a task, meaning each retry can run for the full timeout.",
"format": "int64",
"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 +optional",
+ "description": "Optional. List of volumes that can be mounted by containers belonging to the task. More info: https://kubernetes.io/docs/concepts/storage/volumes",
"items": {
"$ref": "Volume"
},
@@ -4305,16 +4340,16 @@
"type": "object"
},
"TaskStatus": {
- "description": "TaskStatus represents the status of a task of a job execution.",
+ "description": "TaskStatus represents the status of a task.",
"id": "TaskStatus",
"properties": {
"completionTime": {
- "description": "Optional. Represents time when the task was completed. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC. +optional",
+ "description": "Optional. Represents time when the task was completed. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC.",
"format": "google-datetime",
"type": "string"
},
"conditions": {
- "description": "Optional. The latest available observations of a task's current state. More info: https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ +optional",
+ "description": "Optional. The latest available observations of a task's current state. More info: https://kubernetes.io/docs/concepts/workloads/controllers/job/",
"items": {
"$ref": "GoogleCloudRunV1Condition"
},
@@ -4327,24 +4362,24 @@
},
"lastAttemptResult": {
"$ref": "TaskAttemptResult",
- "description": "Optional. Result of the last attempt of this task. +optional"
+ "description": "Optional. Result of the last attempt of this task."
},
"logUri": {
"description": "Optional. URI where logs for this task can be found in Cloud Console.",
"type": "string"
},
"observedGeneration": {
- "description": "Optional. The 'generation' of the execution that was last processed by the controller.",
+ "description": "Optional. The 'generation' of the task that was last processed by the controller.",
"format": "int32",
"type": "integer"
},
"retried": {
- "description": "Optional. The number of times this task was retried. Instances are retried when they fail up to the maxRetries limit. +optional",
+ "description": "Optional. The number of times this task was retried. Instances are retried when they fail up to the maxRetries limit.",
"format": "int32",
"type": "integer"
},
"startTime": {
- "description": "Optional. Represents time when the task started to run. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC. +optional",
+ "description": "Optional. Represents time when the task started to run. It is not guaranteed to be set in happens-before order across separate operations. It is represented in RFC3339 form and is in UTC.",
"format": "google-datetime",
"type": "string"
}
@@ -4357,7 +4392,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 +optional"
+ "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"
}
},
"type": "object"
@@ -4395,7 +4430,7 @@
"id": "TrafficTarget",
"properties": {
"configurationName": {
- "description": "ConfigurationName of a configuration to whose latest revision we will send this portion of traffic. When the \"status.latestReadyRevisionName\" of the referenced configuration changes, we will automatically migrate traffic from the prior \"latest ready\" revision to the new one. This field is never set in Route's status, only its spec. This is mutually exclusive with RevisionName. Cloud Run currently supports a single ConfigurationName.",
+ "description": "ConfigurationName of a configuration to whose latest revision which will be sent this portion of traffic. When the \"status.latestReadyRevisionName\" of the referenced configuration changes, traffic will automatically migrate from the prior \"latest ready\" revision to the new one. This field is never set in Route's status, only its spec. This is mutually exclusive with RevisionName. Cloud Run currently supports a single ConfigurationName.",
"type": "string"
},
"latestRevision": {
@@ -4427,14 +4462,16 @@
"id": "Volume",
"properties": {
"configMap": {
- "$ref": "ConfigMapVolumeSource"
+ "$ref": "ConfigMapVolumeSource",
+ "description": "Adapts a ConfigMap into a volume. The contents of the target ConfigMap's Data field will be presented in a volume as files using the keys in the Data field as the file names, unless the items element is populated with specific mappings of keys to paths."
},
"name": {
"description": "Volume's name. In Cloud Run Fully Managed, the name 'cloudsql' is reserved.",
"type": "string"
},
"secret": {
- "$ref": "SecretVolumeSource"
+ "$ref": "SecretVolumeSource",
+ "description": "The secret's value will be presented as the content of a file whose name is defined in the item path. If no items are defined, the name of the file is the secretName."
}
},
"type": "object"
@@ -4444,19 +4481,19 @@
"id": "VolumeMount",
"properties": {
"mountPath": {
- "description": "Path within the container at which the volume should be mounted. Must not contain ':'.",
+ "description": "Required. Path within the container at which the volume should be mounted. Must not contain ':'.",
"type": "string"
},
"name": {
- "description": "The name of the volume. There must be a corresponding Volume with the same name.",
+ "description": "Required. The name of the volume. There must be a corresponding Volume with the same name.",
"type": "string"
},
"readOnly": {
- "description": "(Optional) Only true is accepted. Defaults to true.",
+ "description": "Only true is accepted for Secret Volumes. Defaults to true for Secrets Volumes.",
"type": "boolean"
},
"subPath": {
- "description": "(Optional) Path within the volume from which the container's volume should be mounted. Defaults to \"\" (volume's root).",
+ "description": "Path within the volume from which the container's volume should be mounted. Defaults to \"\" (volume's root).",
"type": "string"
}
},
diff --git a/run/v1/run-gen.go b/run/v1/run-gen.go
index 18a79e478f4..e3d9a6cb01b 100644
--- a/run/v1/run-gen.go
+++ b/run/v1/run-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/run/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/run/v1"
-// ...
-// ctx := context.Background()
-// runService, err := run.NewService(ctx)
+// import "google.golang.org/api/run/v1"
+// ...
+// ctx := context.Background()
+// runService, err := run.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
+// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package run // import "google.golang.org/api/run/v1"
@@ -555,16 +555,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -608,7 +612,11 @@ func (s *Binding) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// ConfigMapEnvSource: Not supported by Cloud Run ConfigMapEnvSource
+// CancelExecutionRequest: Request message for cancelling an execution.
+type CancelExecutionRequest struct {
+}
+
+// ConfigMapEnvSource: Not supported by Cloud Run. ConfigMapEnvSource
// selects a ConfigMap to populate the environment variables with. The
// contents of the target ConfigMap's Data field will represent the
// key-value pairs as environment variables.
@@ -621,7 +629,7 @@ type ConfigMapEnvSource struct {
// Name: The ConfigMap to select from.
Name string `json:"name,omitempty"`
- // Optional: (Optional) Specify whether the ConfigMap must be defined
+ // Optional: Specify whether the ConfigMap must be defined.
Optional bool `json:"optional,omitempty"`
// ForceSendFields is a list of field names (e.g.
@@ -649,10 +657,10 @@ func (s *ConfigMapEnvSource) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// ConfigMapKeySelector: Not supported by Cloud Run Selects a key from a
-// ConfigMap.
+// ConfigMapKeySelector: Not supported by Cloud Run. Selects a key from
+// a ConfigMap.
type ConfigMapKeySelector struct {
- // Key: The key to select.
+ // Key: Required. The key to select.
Key string `json:"key,omitempty"`
// LocalObjectReference: This field should not be used directly as it is
@@ -660,11 +668,10 @@ type ConfigMapKeySelector struct {
// instead.
LocalObjectReference *LocalObjectReference `json:"localObjectReference,omitempty"`
- // Name: The ConfigMap to select from.
+ // Name: Required. The ConfigMap to select from.
Name string `json:"name,omitempty"`
- // Optional: (Optional) Specify whether the ConfigMap or its key must be
- // defined
+ // Optional: Specify whether the ConfigMap or its key must be defined
Optional bool `json:"optional,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
@@ -690,7 +697,7 @@ func (s *ConfigMapKeySelector) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// ConfigMapVolumeSource: Not supported by Cloud Run Adapts a ConfigMap
+// ConfigMapVolumeSource: Not supported by Cloud Run. Adapts a ConfigMap
// into a volume. The contents of the target ConfigMap's Data field will
// be presented in a volume as files using the keys in the Data field as
// the file names, unless the items element is populated with specific
@@ -756,7 +763,7 @@ func (s *ConfigMapVolumeSource) MarshalJSON() ([]byte, error) {
// 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/serving/blob/main/docs/spec/overview.md#configuration
+// https://github.com/knative/specs/blob/main/specs/serving/overview.md#configuration
type Configuration struct {
// ApiVersion: The API version for this call such as
// "serving.knative.dev/v1".
@@ -837,14 +844,15 @@ func (s *ConfigurationSpec) MarshalJSON() ([]byte, error) {
// ConfigurationStatus: ConfigurationStatus communicates the observed
// state of the Configuration (from the controller).
type ConfigurationStatus struct {
- // Conditions: Conditions communicates information about
- // ongoing/complete reconciliation processes that bring the "spec"
- // inline with the observed state of the world.
+ // Conditions: Conditions communicate information about ongoing/complete
+ // reconciliation processes that bring the "spec" inline with the
+ // observed state of the world.
Conditions []*GoogleCloudRunV1Condition `json:"conditions,omitempty"`
// LatestCreatedRevisionName: LatestCreatedRevisionName is the last
// revision that was created from this Configuration. It might not be
- // ready yet, for that use LatestReadyRevisionName.
+ // ready yet, so for the latest ready revision, use
+ // LatestReadyRevisionName.
LatestCreatedRevisionName string `json:"latestCreatedRevisionName,omitempty"`
// LatestReadyRevisionName: LatestReadyRevisionName holds the name of
@@ -889,111 +897,105 @@ func (s *ConfigurationStatus) MarshalJSON() ([]byte, error) {
// arguments to supply to it. Note that additional arguments may be
// supplied by the system to the container at runtime.
type Container struct {
- // Args: (Optional) Arguments to the entrypoint. The docker image's CMD
- // is used if this is not provided. Variable references $(VAR_NAME) are
- // expanded using the container's environment. If a variable cannot be
- // resolved, the reference in the input string will be unchanged. The
- // $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME).
- // Escaped references will never be expanded, regardless of whether the
- // variable exists or not. More info:
+ // Args: Arguments to the entrypoint. The docker image's CMD is used if
+ // this is not provided. Variable references $(VAR_NAME) are expanded
+ // using the container's environment. If a variable cannot be resolved,
+ // the reference in the input string will be unchanged. The $(VAR_NAME)
+ // syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped
+ // references will never be expanded, regardless of whether the variable
+ // exists or not. More info:
// https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
Args []string `json:"args,omitempty"`
+ // Command: Entrypoint array. Not executed within a shell. The docker
+ // image's ENTRYPOINT is used if this is not provided. Variable
+ // references $(VAR_NAME) are expanded using the container's
+ // environment. If a variable cannot be resolved, the reference in the
+ // input string will be unchanged. The $(VAR_NAME) syntax can be escaped
+ // with a double $$, ie: $$(VAR_NAME). Escaped references will never be
+ // expanded, regardless of whether the variable exists or not. More
+ // info:
+ // https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
Command []string `json:"command,omitempty"`
- // Env: (Optional) List of environment variables to set in the
- // container.
+ // Env: List of environment variables to set in the container.
Env []*EnvVar `json:"env,omitempty"`
- // EnvFrom: (Optional) List of sources to populate environment variables
- // in the container. The keys defined within a source must be a
- // C_IDENTIFIER. All invalid keys will be reported as an event when the
- // container is starting. When a key exists in multiple sources, the
- // value associated with the last source will take precedence. Values
- // defined by an Env with a duplicate key will take precedence. Cannot
- // be updated.
+ // EnvFrom: Not supported by Cloud Run.
EnvFrom []*EnvFromSource `json:"envFrom,omitempty"`
- // Image: Only supports containers from Google Container Registry or
- // Artifact Registry URL of the Container image. More info:
+ // Image: Required. URL of the Container image in Google Container
+ // Registry or Google Artifact Registry. More info:
// https://kubernetes.io/docs/concepts/containers/images
Image string `json:"image,omitempty"`
- // ImagePullPolicy: (Optional) Image pull policy. One of Always, Never,
+ // 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
ImagePullPolicy string `json:"imagePullPolicy,omitempty"`
- // LivenessProbe: (Optional) Periodic probe of container liveness.
- // Container will be restarted if the probe fails. More info:
+ // 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
LivenessProbe *Probe `json:"livenessProbe,omitempty"`
- // Name: (Optional) Name of the container specified as a DNS_LABEL.
- // Currently unused in Cloud Run. More info:
+ // Name: Name of the container specified as a DNS_LABEL. Currently
+ // unused in Cloud Run. More info:
// https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names
Name string `json:"name,omitempty"`
- // Ports: (Optional) List of ports to expose from the container. Only a
- // single port can be specified. The specified ports must be listening
- // on all interfaces (0.0.0.0) within the container to be accessible. If
+ // Ports: List of ports to expose from the container. Only a single port
+ // can be specified. The specified ports must be listening on all
+ // interfaces (0.0.0.0) within the container to be accessible. If
// omitted, a port number will be chosen and passed to the container
// through the PORT environment variable for the container to listen on.
Ports []*ContainerPort `json:"ports,omitempty"`
- // ReadinessProbe: (Optional) Periodic probe of container service
- // readiness. Container will be removed from service endpoints if the
- // probe fails. More info:
- // https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
+ // ReadinessProbe: Not supported by Cloud Run.
ReadinessProbe *Probe `json:"readinessProbe,omitempty"`
- // Resources: (Optional) Compute Resources required by this container.
- // More info:
+ // Resources: Compute Resources required by this container. More info:
// https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
Resources *ResourceRequirements `json:"resources,omitempty"`
- // SecurityContext: (Optional) Security options the pod should run with.
- // More info:
- // https://kubernetes.io/docs/concepts/policy/security-context/ More
- // info:
- // https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
+ // SecurityContext: Not supported by Cloud Run.
SecurityContext *SecurityContext `json:"securityContext,omitempty"`
- // StartupProbe: (Optional) Startup probe of application within the
- // container. All other probes are disabled if a startup probe is
- // provided, until it succeeds. Container will not be added to service
- // endpoints if the probe fails. More info:
+ // StartupProbe: 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
StartupProbe *Probe `json:"startupProbe,omitempty"`
- // TerminationMessagePath: (Optional) 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
+ // TerminationMessagePath: 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.
TerminationMessagePath string `json:"terminationMessagePath,omitempty"`
- // TerminationMessagePolicy: (Optional) Indicate how the termination
- // message should be populated. File will use the contents of
- // terminationMessagePath to populate the container status message on
- // both success and failure. FallbackToLogsOnError will use the last
- // chunk of container log output if the termination message file is
- // empty and the container exited with an error. The log output is
- // limited to 2048 bytes or 80 lines, whichever is smaller. Defaults to
- // File. Cannot be updated.
+ // TerminationMessagePolicy: Indicate how the termination message should
+ // be populated. File will use the contents of terminationMessagePath to
+ // populate the container status message on both success and failure.
+ // FallbackToLogsOnError will use the last chunk of container log output
+ // if the termination message file is empty and the container exited
+ // with an error. The log output is limited to 2048 bytes or 80 lines,
+ // whichever is smaller. Defaults to File. Cannot be updated.
TerminationMessagePolicy string `json:"terminationMessagePolicy,omitempty"`
- // VolumeMounts: (Optional) Volume to mount into the container's
- // filesystem. Only supports SecretVolumeSources. Pod volumes to mount
- // into the container's filesystem.
+ // VolumeMounts: Volume to mount into the container's filesystem. Only
+ // supports SecretVolumeSources. Pod volumes to mount into the
+ // container's filesystem.
VolumeMounts []*VolumeMount `json:"volumeMounts,omitempty"`
- // WorkingDir: (Optional) Container's working directory. If not
- // specified, the container runtime's default will be used, which might
- // be configured in the container image.
+ // WorkingDir: Container's working directory. If not specified, the
+ // container runtime's default will be used, which might be configured
+ // in the container image.
WorkingDir string `json:"workingDir,omitempty"`
// ForceSendFields is a list of field names (e.g. "Args") to
@@ -1022,16 +1024,15 @@ func (s *Container) MarshalJSON() ([]byte, error) {
// ContainerPort: ContainerPort represents a network port in a single
// container.
type ContainerPort struct {
- // ContainerPort: (Optional) Port number the container listens on. This
- // must be a valid port number, 0 < x < 65536.
+ // ContainerPort: Port number the container listens on. This must be a
+ // valid port number, 0 < x < 65536.
ContainerPort int64 `json:"containerPort,omitempty"`
- // Name: (Optional) If specified, used to specify which protocol to use.
- // Allowed values are "http1" and "h2c".
+ // Name: If specified, used to specify which protocol to use. Allowed
+ // values are "http1" and "h2c".
Name string `json:"name,omitempty"`
- // Protocol: (Optional) Protocol for port. Must be "TCP". Defaults to
- // "TCP".
+ // Protocol: Protocol for port. Must be "TCP". Defaults to "TCP".
Protocol string `json:"protocol,omitempty"`
// ForceSendFields is a list of field names (e.g. "ContainerPort") to
@@ -1111,7 +1112,7 @@ type DomainMappingSpec struct {
// "CERTIFICATE_MODE_UNSPECIFIED"
// "NONE" - Do not provision an HTTPS certificate.
// "AUTOMATIC" - Automatically provisions an HTTPS certificate via
- // GoogleCA or LetsEncrypt.
+ // GoogleCA.
CertificateMode string `json:"certificateMode,omitempty"`
// ForceOverride: If set, the mapping will override any mapping set
@@ -1171,9 +1172,7 @@ type DomainMappingStatus struct {
// mapping.
ResourceRecords []*ResourceRecord `json:"resourceRecords,omitempty"`
- // Url: Optional. Cloud Run fully managed: not supported Cloud Run on
- // GKE: supported Holds the URL that will serve the traffic of the
- // DomainMapping.
+ // Url: Optional. Not supported by Cloud Run.
Url string `json:"url,omitempty"`
// ForceSendFields is a list of field names (e.g. "Conditions") to
@@ -1199,17 +1198,17 @@ func (s *DomainMappingStatus) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// EnvFromSource: Not supported by Cloud Run EnvFromSource represents
+// EnvFromSource: Not supported by Cloud Run. EnvFromSource represents
// the source of a set of ConfigMaps
type EnvFromSource struct {
- // ConfigMapRef: (Optional) The ConfigMap to select from
+ // ConfigMapRef: The ConfigMap to select from
ConfigMapRef *ConfigMapEnvSource `json:"configMapRef,omitempty"`
- // Prefix: (Optional) An optional identifier to prepend to each key in
- // the ConfigMap. Must be a C_IDENTIFIER.
+ // Prefix: An optional identifier to prepend to each key in the
+ // ConfigMap. Must be a C_IDENTIFIER.
Prefix string `json:"prefix,omitempty"`
- // SecretRef: (Optional) The Secret to select from
+ // SecretRef: The Secret to select from
SecretRef *SecretEnvSource `json:"secretRef,omitempty"`
// ForceSendFields is a list of field names (e.g. "ConfigMapRef") to
@@ -1238,21 +1237,21 @@ func (s *EnvFromSource) MarshalJSON() ([]byte, error) {
// EnvVar: EnvVar represents an environment variable present in a
// Container.
type EnvVar struct {
- // Name: Name of the environment variable. Must be a C_IDENTIFIER.
+ // Name: Required. Name of the environment variable. Must be a
+ // C_IDENTIFIER.
Name string `json:"name,omitempty"`
- // Value: (Optional) Variable references $(VAR_NAME) are expanded using
- // the previous defined environment variables in the container and any
- // route environment variables. If a variable cannot be resolved, the
+ // Value: Variable references $(VAR_NAME) are expanded using the
+ // previous defined environment variables in the container and any route
+ // environment variables. If a variable cannot be resolved, the
// reference in the input string will be unchanged. The $(VAR_NAME)
// syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped
// references will never be expanded, regardless of whether the variable
// exists or not. Defaults to "".
Value string `json:"value,omitempty"`
- // ValueFrom: (Optional) Source for the environment variable's value.
- // Only supports secret_key_ref. Source for the environment variable's
- // value. Cannot be used if value is not empty.
+ // ValueFrom: Source for the environment variable's value. Only supports
+ // secret_key_ref. Cannot be used if value is not empty.
ValueFrom *EnvVarSource `json:"valueFrom,omitempty"`
// ForceSendFields is a list of field names (e.g. "Name") to
@@ -1281,12 +1280,11 @@ func (s *EnvVar) MarshalJSON() ([]byte, error) {
// EnvVarSource: EnvVarSource represents a source for the value of an
// EnvVar.
type EnvVarSource struct {
- // ConfigMapKeyRef: (Optional) Not supported by Cloud Run Selects a key
- // of a ConfigMap.
+ // ConfigMapKeyRef: Not supported by Cloud Run. Selects a key of a
+ // ConfigMap.
ConfigMapKeyRef *ConfigMapKeySelector `json:"configMapKeyRef,omitempty"`
- // SecretKeyRef: (Optional) Selects a key (version) of a secret in
- // Secret Manager.
+ // SecretKeyRef: Selects a key (version) of a secret in Secret Manager.
SecretKeyRef *SecretKeySelector `json:"secretKeyRef,omitempty"`
// ForceSendFields is a list of field names (e.g. "ConfigMapKeyRef") to
@@ -1313,11 +1311,11 @@ func (s *EnvVarSource) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// ExecAction: Not supported by Cloud Run ExecAction describes a "run in
-// container" action.
+// ExecAction: Not supported by Cloud Run. ExecAction describes a "run
+// in container" action.
type ExecAction struct {
- // Command: (Optional) Command is the command line to execute inside the
- // container, the working directory for the command is root ('/') in the
+ // Command: Command is the command line to execute inside the container,
+ // the working directory for the command is root ('/') in the
// container's filesystem. The command is simply exec'd, it is not run
// inside a shell, so traditional shell instructions ('|', etc) won't
// work. To use a shell, you need to explicitly call out to that shell.
@@ -1349,7 +1347,7 @@ func (s *ExecAction) MarshalJSON() ([]byte, error) {
}
// Execution: Execution represents the configuration of a single
-// execution. A execution an immutable resource that references a
+// execution. An execution is an immutable resource that references a
// container image which is run to completion.
type Execution struct {
// ApiVersion: Optional. APIVersion defines the versioned schema of this
@@ -1357,7 +1355,6 @@ type Execution struct {
// 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
- // +optional
ApiVersion string `json:"apiVersion,omitempty"`
// Kind: Optional. Kind is a string value representing the REST resource
@@ -1365,23 +1362,19 @@ type Execution struct {
// 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
- // +optional
Kind string `json:"kind,omitempty"`
// Metadata: Optional. Standard object's metadata. More info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#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/api-conventions.md#spec-and-status
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
Spec *ExecutionSpec `json:"spec,omitempty"`
// Status: Output only. Current status of an execution. More info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
Status *ExecutionStatus `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -1455,16 +1448,14 @@ type ExecutionSpec struct {
// the job is run, if this field is 0 or unset, the maximum possible
// value will be used for that execution. The actual number of tasks
// running in steady state will be less than this number when there are
- // fewer tasks waiting to be completed remaining, i.e. when the work
- // left to do is less than max parallelism. +optional
+ // fewer tasks waiting to be completed, i.e. when the work left to do is
+ // less than max parallelism.
Parallelism int64 `json:"parallelism,omitempty"`
// TaskCount: Optional. Specifies the desired number of tasks the
// execution should run. Setting to 1 means that parallelism is limited
// to 1 and the success of that task signals the success of the
- // execution. More info:
- // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
- // +optional
+ // execution.
TaskCount int64 `json:"taskCount,omitempty"`
// Template: Optional. Describes the task(s) that will be created when
@@ -1494,27 +1485,25 @@ func (s *ExecutionSpec) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// ExecutionStatus: ExecutionStatus represents the current state of a
+// ExecutionStatus: ExecutionStatus represents the current state of an
// Execution.
type ExecutionStatus struct {
// CancelledCount: Optional. The number of tasks which reached phase
- // Cancelled. +optional
+ // Cancelled.
CancelledCount int64 `json:"cancelledCount,omitempty"`
- // CompletionTime: Optional. Represents time when the execution was
+ // CompletionTime: Optional. Represents the time that the execution was
// completed. It is not guaranteed to be set in happens-before order
// across separate operations. It is represented in RFC3339 form and is
// in UTC. +optional
CompletionTime string `json:"completionTime,omitempty"`
// Conditions: Optional. The latest available observations of an
- // execution's current state. More info:
- // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
- // +optional
+ // execution's current state.
Conditions []*GoogleCloudRunV1Condition `json:"conditions,omitempty"`
// FailedCount: Optional. The number of tasks which reached phase
- // Failed. +optional
+ // Failed.
FailedCount int64 `json:"failedCount,omitempty"`
// LogUri: Optional. URI where logs for this execution can be found in
@@ -1526,21 +1515,19 @@ type ExecutionStatus struct {
ObservedGeneration int64 `json:"observedGeneration,omitempty"`
// RetriedCount: Optional. The number of tasks which have retried at
- // least once. +optional
+ // least once.
RetriedCount int64 `json:"retriedCount,omitempty"`
// RunningCount: Optional. The number of actively running tasks.
- // +optional
RunningCount int64 `json:"runningCount,omitempty"`
- // StartTime: Optional. Represents time when the execution started to
- // run. It is not guaranteed to be set in happens-before order across
+ // StartTime: Optional. Represents the time that the execution started
+ // to run. It is not guaranteed to be set in happens-before order across
// separate operations. It is represented in RFC3339 form and is in UTC.
- // +optional
StartTime string `json:"startTime,omitempty"`
// SucceededCount: Optional. The number of tasks which reached phase
- // Succeeded. +optional
+ // Succeeded.
SucceededCount int64 `json:"succeededCount,omitempty"`
// ForceSendFields is a list of field names (e.g. "CancelledCount") to
@@ -1671,8 +1658,7 @@ func (s *Expr) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// GRPCAction: Not supported by Cloud Run GRPCAction describes an action
-// involving a GRPC port.
+// GRPCAction: GRPCAction describes an action involving a GRPC port.
type GRPCAction struct {
// Port: Port number of the gRPC service. Number must be in the range 1
// to 65535.
@@ -1707,8 +1693,13 @@ func (s *GRPCAction) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// GoogleCloudRunV1Condition: Condition defines a generic condition for
-// a Resource.
+// GoogleCloudRunV1Condition: Conditions show the status of
+// reconciliation progress on a given resource. Most resource use a
+// top-level condition type "Ready" or "Completed" to show overall
+// status with other conditions to checkpoint each stage of
+// reconciliation. Note that if metadata.Generation does not equal
+// status.ObservedGeneration, the conditions shown may not be relevant
+// for the current spec.
type GoogleCloudRunV1Condition struct {
// LastTransitionTime: Optional. Last time the condition transitioned
// from one status to another.
@@ -1719,11 +1710,14 @@ type GoogleCloudRunV1Condition struct {
Message string `json:"message,omitempty"`
// Reason: Optional. One-word CamelCase reason for the condition's last
- // transition.
+ // transition. These are intended to be stable, unique values which the
+ // client may use to trigger error handling logic, whereas messages
+ // which may be changed later by the server.
Reason string `json:"reason,omitempty"`
- // Severity: Optional. How to interpret failures of this condition, one
- // of Error, Warning, Info
+ // Severity: Optional. How to interpret this condition. One of Error,
+ // Warning, or Info. Conditions of severity Info do not contribute to
+ // resource readiness.
Severity string `json:"severity,omitempty"`
// Status: Status of the condition, one of True, False, Unknown.
@@ -1732,8 +1726,8 @@ type GoogleCloudRunV1Condition struct {
// 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": True when the
- // Resource is ready.
+ // 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")
@@ -1804,22 +1798,20 @@ func (s *GoogleRpcStatus) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// HTTPGetAction: Not supported by Cloud Run HTTPGetAction describes an
-// action based on HTTP Get requests.
+// HTTPGetAction: HTTPGetAction describes an action based on HTTP Get
+// requests.
type HTTPGetAction struct {
- // Host: (Optional) Host name to connect to, defaults to the pod IP. You
- // probably want to set "Host" in httpHeaders instead.
+ // Host: Not supported by Cloud Run.
Host string `json:"host,omitempty"`
- // HttpHeaders: (Optional) Custom headers to set in the request. HTTP
- // allows repeated headers.
+ // HttpHeaders: Custom headers to set in the request. HTTP allows
+ // repeated headers.
HttpHeaders []*HTTPHeader `json:"httpHeaders,omitempty"`
- // Path: (Optional) Path to access on the HTTP server.
+ // Path: Path to access on the HTTP server.
Path string `json:"path,omitempty"`
- // Scheme: (Optional) Scheme to use for connecting to the host. Defaults
- // to HTTP.
+ // Scheme: Not supported by Cloud Run.
Scheme string `json:"scheme,omitempty"`
// ForceSendFields is a list of field names (e.g. "Host") to
@@ -1845,8 +1837,8 @@ func (s *HTTPGetAction) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// HTTPHeader: Not supported by Cloud Run HTTPHeader describes a custom
-// header to be used in HTTP probes
+// HTTPHeader: HTTPHeader describes a custom header to be used in HTTP
+// probes
type HTTPHeader struct {
// Name: The header field name
Name string `json:"name,omitempty"`
@@ -1877,16 +1869,14 @@ func (s *HTTPHeader) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// Job: Job represents the configuration of a single job. A job an
-// immutable resource that references a container image which is run to
-// completion.
+// Job: Job represents the configuration of a single job, which
+// references a container image which is run to completion.
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
- // +optional
ApiVersion string `json:"apiVersion,omitempty"`
// Kind: Optional. Kind is a string value representing the REST resource
@@ -1894,23 +1884,19 @@ type Job struct {
// 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
- // +optional
Kind string `json:"kind,omitempty"`
// Metadata: Optional. Standard object's metadata. More info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#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/api-conventions.md#spec-and-status
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
Spec *JobSpec `json:"spec,omitempty"`
// Status: Output only. Current status of a job. More info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
Status *JobStatus `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -1973,7 +1959,7 @@ func (s *JobSpec) MarshalJSON() ([]byte, error) {
type JobStatus struct {
// Conditions: The latest available observations of a job's current
// state. More info:
- // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
+ // https://kubernetes.io/docs/concepts/workloads/controllers/job/
Conditions []*GoogleCloudRunV1Condition `json:"conditions,omitempty"`
// ExecutionCount: Number of executions created for this job.
@@ -2315,31 +2301,24 @@ func (s *ListLocationsResponse) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// ListMeta: ListMeta describes metadata that synthetic resources must
-// have, including lists and various status objects. A resource may have
-// only one of {ObjectMeta, ListMeta}.
+// ListMeta: Metadata for synthetic resources like List. In Cloud Run,
+// all List Resources Responses will have a ListMeta instead of
+// ObjectMeta.
type ListMeta struct {
- // Continue: continue may be set if the user set a limit on the number
- // of items returned, and indicates that the server has more data
- // available. The value is opaque and may be used to issue another
- // request to the endpoint that served this list to retrieve the next
- // set of available objects. Continuing a list may not be possible if
- // the server configuration has changed or more than a few minutes have
- // passed. The resourceVersion field returned when using this continue
- // value will be identical to the value in the first response.
+ // Continue: Continuation token is a value emitted when the count of
+ // items is larger than the user/system limit. To retrieve the next page
+ // of items, pass the value of `continue` as the next request's
+ // `page_token`.
Continue string `json:"continue,omitempty"`
- // ResourceVersion: String that identifies the server's internal version
- // of this object that can be used by clients to determine when objects
- // have changed. Value must be treated as opaque by clients and passed
- // unmodified back to the server. Populated by the system. Read-only.
- // More info:
+ // ResourceVersion: 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
- // +optional
ResourceVersion string `json:"resourceVersion,omitempty"`
- // SelfLink: SelfLink is a URL representing this object. Populated by
- // the system. Read-only. +optional
+ // SelfLink: URL representing this object.
SelfLink string `json:"selfLink,omitempty"`
// ForceSendFields is a list of field names (e.g. "Continue") to
@@ -2458,20 +2437,22 @@ func (s *ListRoutesResponse) MarshalJSON() ([]byte, error) {
// ListServicesResponse: A list of Service resources.
type ListServicesResponse struct {
- // ApiVersion: The API version for this call such as
+ // ApiVersion: The API version for this call; returns
// "serving.knative.dev/v1".
ApiVersion string `json:"apiVersion,omitempty"`
// Items: List of Services.
Items []*Service `json:"items,omitempty"`
- // Kind: The kind of this resource, in this case "ServiceList".
+ // Kind: The kind of this resource; returns "ServiceList".
Kind string `json:"kind,omitempty"`
// Metadata: Metadata associated with this Service list.
Metadata *ListMeta `json:"metadata,omitempty"`
- // Unreachable: Locations that could not be reached.
+ // Unreachable: For calls against the global endpoint, returns the list
+ // of Cloud locations that could not be reached. For regional calls,
+ // this field is not used.
Unreachable []string `json:"unreachable,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -2546,11 +2527,11 @@ func (s *ListTasksResponse) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// LocalObjectReference: Not supported by Cloud Run LocalObjectReference
-// contains enough information to let you locate the referenced object
-// inside the same namespace.
+// LocalObjectReference: Not supported by Cloud Run.
+// LocalObjectReference contains enough information to let you locate
+// the referenced object inside the same namespace.
type LocalObjectReference struct {
- // Name: (Optional) Name of the referent. More info:
+ // Name: Name of the referent. More info:
// https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
Name string `json:"name,omitempty"`
@@ -2627,133 +2608,100 @@ func (s *Location) MarshalJSON() ([]byte, error) {
// metadata that all persisted resources must have, which includes all
// objects users must create.
type ObjectMeta struct {
- // Annotations: (Optional) Annotations is an unstructured key value map
- // stored with a resource that may be set by external tools to store and
- // retrieve arbitrary metadata. They are not queryable and should be
- // preserved when modifying objects. More info:
+ // Annotations: 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/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/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
Annotations map[string]string `json:"annotations,omitempty"`
- // ClusterName: (Optional) Not supported by Cloud Run The name of the
- // cluster which the object belongs to. This is used to distinguish
- // resources with same name and namespace in different clusters. This
- // field is not set anywhere right now and apiserver is going to ignore
- // it if set in create or update request.
+ // ClusterName: Not supported by Cloud Run
ClusterName string `json:"clusterName,omitempty"`
- // CreationTimestamp: (Optional) CreationTimestamp is a timestamp
- // representing the server time when this object was created. It is not
- // guaranteed to be set in happens-before order across separate
- // operations. Clients may not set this value. It is represented in
- // RFC3339 form and is in UTC. Populated by the system. Read-only. Null
- // for lists. More info:
+ // 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
CreationTimestamp string `json:"creationTimestamp,omitempty"`
- // DeletionGracePeriodSeconds: (Optional) Not supported by Cloud Run
- // Number of seconds allowed for this object to gracefully terminate
- // before it will be removed from the system. Only set when
- // deletionTimestamp is also set. May only be shortened. Read-only.
+ // DeletionGracePeriodSeconds: Not supported by Cloud Run
DeletionGracePeriodSeconds int64 `json:"deletionGracePeriodSeconds,omitempty"`
- // DeletionTimestamp: (Optional) Not supported by Cloud Run
- // DeletionTimestamp is RFC 3339 date and time at which this resource
- // will be deleted. This field is set by the server when a graceful
- // deletion is requested by the user, and is not directly settable by a
- // client. The resource is expected to be deleted (no longer visible
- // from resource lists, and not reachable by name) after the time in
- // this field, once the finalizers list is empty. As long as the
- // finalizers list contains items, deletion is blocked. Once the
- // deletionTimestamp is set, this value may not be unset or be set
- // further into the future, although it may be shortened or the resource
- // may be deleted prior to this time. For example, a user may request
- // that a pod is deleted in 30 seconds. The Kubelet will react by
- // sending a graceful termination signal to the containers in the pod.
- // After that 30 seconds, the Kubelet will send a hard termination
- // signal (SIGKILL) to the container and after cleanup, remove the pod
- // from the API. In the presence of network partitions, this object may
- // still exist after this timestamp, until an administrator or automated
- // process can determine the resource is fully terminated. If not set,
- // graceful deletion of the object has not been requested. Populated by
- // the system when a graceful deletion is requested. Read-only. More
- // info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
+ // DeletionTimestamp: The read-only soft deletion timestamp for this
+ // resource. In Cloud Run, users are not able to set this field.
+ // Instead, they must call the corresponding Delete API.
DeletionTimestamp string `json:"deletionTimestamp,omitempty"`
- // Finalizers: (Optional) Not supported by Cloud Run Must be empty
- // before the object is deleted from the registry. Each entry is an
- // identifier for the responsible component that will remove the entry
- // from the list. If the deletionTimestamp of the object is non-nil,
- // entries in this list can only be removed. +patchStrategy=merge
+ // Finalizers: Not supported by Cloud Run
Finalizers []string `json:"finalizers,omitempty"`
- // GenerateName: (Optional) Not supported by Cloud Run GenerateName is
- // an optional prefix, used by the server, to generate a unique name
- // ONLY IF the Name field has not been provided. If this field is used,
- // the name returned to the client will be different than the name
- // passed. This value will also be combined with a unique suffix. The
- // provided value has the same validation rules as the Name field, and
- // may be truncated by the length of the suffix required to make the
- // value unique on the server. If this field is specified and the
- // generated name exists, the server will NOT return a 409 - instead, it
- // will either return 201 Created or 500 with Reason ServerTimeout
- // indicating a unique name could not be found in the time allotted, and
- // the client should retry (optionally after the time indicated in the
- // Retry-After header). Applied only if Name is not specified. More
- // info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency
- // string generateName = 2;
+ // GenerateName: Not supported by Cloud Run
GenerateName string `json:"generateName,omitempty"`
- // Generation: (Optional) A sequence number representing a specific
- // generation of the desired state. Populated by the system. Read-only.
+ // Generation: A system-provided sequence number representing a specific
+ // generation of the desired state.
Generation int64 `json:"generation,omitempty"`
- // Labels: (Optional) 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:
+ // 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
Labels map[string]string `json:"labels,omitempty"`
- // Name: Name must be unique within a namespace, within a Cloud Run
- // region. Is required when creating resources, although some resources
- // may allow a client to request the generation of an appropriate name
- // automatically. Name is primarily intended for creation idempotence
- // and configuration definition. Cannot be updated. More info:
- // https://kubernetes.io/docs/user-guide/identifiers#names +optional
+ // Name: The immutable name of the resource. In Cloud Run, name is
+ // required when creating top-level resources (Service, Job), and must
+ // be unique within a Cloud Run project/region. More info:
+ // https://kubernetes.io/docs/user-guide/identifiers#names If ObjectMeta
+ // is part of a CreateServiceRequest, name must contain fewer than 50
+ // characters. Otherwise,
Name string `json:"name,omitempty"`
- // Namespace: Namespace defines the space within each name must be
- // unique, within a Cloud Run region. In Cloud Run the namespace must be
- // equal to either the project ID or project number.
+ // Namespace: Defines the space within each name must be unique within a
+ // Cloud Run region. In Cloud Run, it must be project ID or number.
Namespace string `json:"namespace,omitempty"`
- // OwnerReferences: (Optional) Not supported by Cloud Run List of
- // objects that own this object. If ALL objects in the list have been
- // deleted, this object will be garbage collected.
+ // OwnerReferences: Not supported by Cloud Run
OwnerReferences []*OwnerReference `json:"ownerReferences,omitempty"`
- // ResourceVersion: Optional. An opaque 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. They may only be valid for a particular resource
- // or set of resources. Populated by the system. Read-only. Value must
- // be treated as opaque by clients or omitted. More info:
+ // ResourceVersion: Optional. 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
ResourceVersion string `json:"resourceVersion,omitempty"`
- // SelfLink: (Optional) SelfLink is a URL representing this object.
- // Populated by the system. Read-only. string selfLink = 4;
+ // SelfLink: URL representing this object.
SelfLink string `json:"selfLink,omitempty"`
- // Uid: (Optional) UID is the unique in time and space value for this
- // object. It is typically generated by the server on successful
- // creation of a resource and is not allowed to change on PUT
- // operations. Populated by the system. Read-only. More info:
- // https://kubernetes.io/docs/user-guide/identifiers#uids
+ // Uid: Unique, system-generated identifier for this resource. More
+ // info: https://kubernetes.io/docs/user-guide/identifiers#uids
Uid string `json:"uid,omitempty"`
// ForceSendFields is a list of field names (e.g. "Annotations") to
@@ -2779,35 +2727,24 @@ func (s *ObjectMeta) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// OwnerReference: OwnerReference contains enough information to let you
-// identify an owning object. Currently, an owning object must be in the
-// same namespace, so there is no namespace field.
+// OwnerReference: This is not supported or used by Cloud Run.
type OwnerReference struct {
- // ApiVersion: API version of the referent.
+ // ApiVersion: This is not supported or used by Cloud Run.
ApiVersion string `json:"apiVersion,omitempty"`
- // BlockOwnerDeletion: If true, AND if the owner has the
- // "foregroundDeletion" finalizer, then the owner cannot be deleted from
- // the key-value store until this reference is removed. Defaults to
- // false. To set this field, a user needs "delete" permission of the
- // owner, otherwise 422 (Unprocessable Entity) will be returned.
- // +optional
+ // BlockOwnerDeletion: This is not supported or used by Cloud Run.
BlockOwnerDeletion bool `json:"blockOwnerDeletion,omitempty"`
- // Controller: If true, this reference points to the managing
- // controller. +optional
+ // Controller: This is not supported or used by Cloud Run.
Controller bool `json:"controller,omitempty"`
- // Kind: Kind of the referent. More info:
- // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+ // Kind: This is not supported or used by Cloud Run.
Kind string `json:"kind,omitempty"`
- // Name: Name of the referent. More info:
- // https://kubernetes.io/docs/user-guide/identifiers#names
+ // Name: This is not supported or used by Cloud Run.
Name string `json:"name,omitempty"`
- // Uid: UID of the referent. More info:
- // https://kubernetes.io/docs/user-guide/identifiers#uids
+ // Uid: This is not supported or used by Cloud Run.
Uid string `json:"uid,omitempty"`
// ForceSendFields is a list of field names (e.g. "ApiVersion") to
@@ -2943,54 +2880,47 @@ func (s *Policy) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// Probe: Not supported by Cloud Run Probe describes a health check to
-// be performed against a container to determine whether it is alive or
-// ready to receive traffic.
+// Probe: Probe describes a health check to be performed against a
+// container to determine whether it is alive or ready to receive
+// traffic.
type Probe struct {
- // Exec: (Optional) Not supported by Cloud Run One and only one of the
- // following should be specified. Exec specifies the action to take. A
- // field inlined from the Handler message.
+ // Exec: Not supported by Cloud Run.
Exec *ExecAction `json:"exec,omitempty"`
- // FailureThreshold: (Optional) Minimum consecutive failures for the
- // probe to be considered failed after having succeeded. Defaults to 3.
- // Minimum value is 1.
+ // FailureThreshold: Minimum consecutive failures for the probe to be
+ // considered failed after having succeeded. Defaults to 3. Minimum
+ // value is 1.
FailureThreshold int64 `json:"failureThreshold,omitempty"`
- // Grpc: (Optional) GRPCAction specifies an action involving a GRPC
- // port. A field inlined from the Handler message.
+ // Grpc: GRPCAction specifies an action involving a GRPC port.
Grpc *GRPCAction `json:"grpc,omitempty"`
- // HttpGet: (Optional) HTTPGet specifies the http request to perform. A
- // field inlined from the Handler message.
+ // HttpGet: HTTPGet specifies the http request to perform.
HttpGet *HTTPGetAction `json:"httpGet,omitempty"`
- // InitialDelaySeconds: (Optional) 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:
+ // 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
InitialDelaySeconds int64 `json:"initialDelaySeconds,omitempty"`
- // PeriodSeconds: (Optional) How often (in seconds) to perform the
- // probe. Default to 10 seconds. Minimum value is 1. Maximum value for
- // liveness probe is 3600. Maximum value for startup probe is 240. Must
- // be greater or equal than timeout_seconds.
+ // PeriodSeconds: How often (in seconds) to perform the probe. Default
+ // to 10 seconds. Minimum value is 1. Maximum value for liveness probe
+ // is 3600. Maximum value for startup probe is 240. Must be greater or
+ // equal than timeout_seconds.
PeriodSeconds int64 `json:"periodSeconds,omitempty"`
- // SuccessThreshold: (Optional) Minimum consecutive successes for the
- // probe to be considered successful after having failed. Must be 1 if
- // set.
+ // SuccessThreshold: Minimum consecutive successes for the probe to be
+ // considered successful after having failed. Must be 1 if set.
SuccessThreshold int64 `json:"successThreshold,omitempty"`
- // TcpSocket: (Optional) TCPSocket specifies an action involving a TCP
- // port. TCP hooks not yet supported A field inlined from the Handler
- // message.
+ // TcpSocket: TCPSocket specifies an action involving a TCP port.
TcpSocket *TCPSocketAction `json:"tcpSocket,omitempty"`
- // TimeoutSeconds: (Optional) 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:
+ // 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
TimeoutSeconds int64 `json:"timeoutSeconds,omitempty"`
@@ -3063,17 +2993,17 @@ func (s *ResourceRecord) MarshalJSON() ([]byte, error) {
// ResourceRequirements: ResourceRequirements describes the compute
// resource requirements.
type ResourceRequirements struct {
- // Limits: (Optional) 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:
+ // 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 map[string]string `json:"limits,omitempty"`
- // Requests: (Optional) 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:
+ // 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 map[string]string `json:"requests,omitempty"`
@@ -3103,7 +3033,7 @@ func (s *ResourceRequirements) MarshalJSON() ([]byte, error) {
// Revision: Revision is an immutable snapshot of code and
// configuration. A revision references a container image. Revisions are
// created by updates to a Configuration. See also:
-// https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision
+// https://github.com/knative/specs/blob/main/specs/serving/overview.md#revision
type Revision struct {
// ApiVersion: The API version for this call such as
// "serving.knative.dev/v1".
@@ -3155,10 +3085,7 @@ func (s *Revision) MarshalJSON() ([]byte, error) {
type RevisionSpec struct {
// ContainerConcurrency: ContainerConcurrency specifies the maximum
// allowed in-flight (concurrent) requests per container instance of the
- // Revision. Cloud Run fully managed: supported, defaults to 80 Cloud
- // Run for Anthos: supported, defaults to 0, which means concurrency to
- // the application is not limited, and the system decides the target
- // concurrency for the autoscaler.
+ // Revision. Cloud Run: supported, defaults to 80
ContainerConcurrency int64 `json:"containerConcurrency,omitempty"`
// Containers: Containers holds the single container that defines the
@@ -3166,23 +3093,13 @@ type RevisionSpec struct {
// 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/serving/blob/main/docs/runtime-contract.md
+ // https://github.com/knative/specs/blob/main/specs/serving/runtime-contract.md
Containers []*Container `json:"containers,omitempty"`
- // EnableServiceLinks: Indicates whether information about services
- // should be injected into pod's environment variables, matching the
- // syntax of Docker links. Cloud Run fully managed: Not supported. Cloud
- // Run for Anthos: supported, defaults to true.
+ // EnableServiceLinks: Not supported by Cloud Run.
EnableServiceLinks bool `json:"enableServiceLinks,omitempty"`
- // ImagePullSecrets: ImagePullSecrets is a list of references to secrets
- // in the same namespace to use for pulling any images in pods that
- // reference this ServiceAccount. ImagePullSecrets are distinct from
- // Secrets because Secrets can be mounted in the pod, but
- // ImagePullSecrets are only accessed by the kubelet. More info:
- // https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
- // Cloud Run fully managed: Not supported. Cloud Run for Anthos:
- // supported.
+ // ImagePullSecrets: Not supported by Cloud Run.
ImagePullSecrets []*LocalObjectReference `json:"imagePullSecrets,omitempty"`
// ServiceAccountName: Email address of the IAM service account
@@ -3193,11 +3110,8 @@ type RevisionSpec struct {
ServiceAccountName string `json:"serviceAccountName,omitempty"`
// TimeoutSeconds: TimeoutSeconds holds the max duration the instance is
- // allowed for responding to a request. Cloud Run fully managed:
- // defaults to 300 seconds (5 minutes). Maximum allowed value is 3600
- // seconds (1 hour). Cloud Run for Anthos: defaults to 300 seconds (5
- // minutes). Maximum allowed value is configurable by the cluster
- // operator.
+ // allowed for responding to a request. Cloud Run: defaults to 300
+ // seconds (5 minutes). Maximum allowed value is 3600 seconds (1 hour).
TimeoutSeconds int64 `json:"timeoutSeconds,omitempty"`
Volumes []*Volume `json:"volumes,omitempty"`
@@ -3337,7 +3251,7 @@ func (s *RevisionTemplate) MarshalJSON() ([]byte, error) {
// 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/serving/blob/main/docs/spec/overview.md#route
+// 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.
@@ -3444,7 +3358,7 @@ type RouteStatus struct {
// Traffic: Traffic holds the configured traffic distribution. These
// entries will always contain RevisionName references. When
// ConfigurationName appears in the spec, this will hold the
- // LatestReadyRevisionName that we last observed.
+ // LatestReadyRevisionName that was last observed.
Traffic []*TrafficTarget `json:"traffic,omitempty"`
// Url: URL holds the url that will distribute traffic over the provided
@@ -3479,8 +3393,8 @@ func (s *RouteStatus) MarshalJSON() ([]byte, error) {
type RunJobRequest struct {
}
-// SecretEnvSource: Not supported by Cloud Run SecretEnvSource selects a
-// Secret to populate the environment variables with. The contents of
+// SecretEnvSource: Not supported by Cloud Run. SecretEnvSource selects
+// a Secret to populate the environment variables with. The contents of
// the target Secret's Data field will represent the key-value pairs as
// environment variables.
type SecretEnvSource struct {
@@ -3492,7 +3406,7 @@ type SecretEnvSource struct {
// Name: The Secret to select from.
Name string `json:"name,omitempty"`
- // Optional: (Optional) Specify whether the Secret must be defined
+ // Optional: Specify whether the Secret must be defined
Optional bool `json:"optional,omitempty"`
// ForceSendFields is a list of field names (e.g.
@@ -3522,9 +3436,9 @@ func (s *SecretEnvSource) MarshalJSON() ([]byte, error) {
// SecretKeySelector: SecretKeySelector selects a key of a Secret.
type SecretKeySelector struct {
- // Key: A Cloud Secret Manager secret version. Must be 'latest' for the
- // latest version or an integer for a specific version. The key of the
- // secret to select from. Must be a valid secret key.
+ // Key: Required. A Cloud Secret Manager secret version. Must be
+ // 'latest' for the latest version or an integer for a specific version.
+ // The key of the secret to select from. Must be a valid secret key.
Key string `json:"key,omitempty"`
// LocalObjectReference: This field should not be used directly as it is
@@ -3541,8 +3455,7 @@ type SecretKeySelector struct {
// secret in the pod's namespace to select from.
Name string `json:"name,omitempty"`
- // Optional: (Optional) Specify whether the Secret or its key must be
- // defined
+ // Optional: Specify whether the Secret or its key must be defined.
Optional bool `json:"optional,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
@@ -3568,10 +3481,11 @@ func (s *SecretKeySelector) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// SecretVolumeSource: The secret's value will be presented as the
-// content of a file whose name is defined in the item path. If no items
-// are defined, the name of the file is the secret_name. The contents of
-// the target Secret's Data field will be presented in a volume as files
+// SecretVolumeSource: A volume representing a secret stored in Google
+// Secret Manager. The secret's value will be presented as the content
+// of a file whose name is defined in the item path. If no items are
+// defined, the name of the file is the secret_name. The contents of the
+// target Secret's Data field will be presented in a volume as files
// using the keys in the Data field as the file names.
type SecretVolumeSource struct {
// DefaultMode: Integer representation of mode bits to use on created
@@ -3589,21 +3503,16 @@ type SecretVolumeSource struct {
// bits set.
DefaultMode int64 `json:"defaultMode,omitempty"`
- // Items: (Optional) If unspecified, the volume will expose a file whose
- // name is the secret_name. If specified, the key will be used as the
- // version to fetch from Cloud Secret Manager and the path will be the
- // name of the file exposed in the volume. When items are defined, they
- // must specify a key and a path. If unspecified, each key-value pair in
- // the Data field of the referenced Secret will be projected into the
- // volume as a file whose name is the key and content is the value. If
- // specified, the listed keys will be projected into the specified
- // paths, and unlisted keys will not be present. If a key is specified
- // that is not present in the Secret, the volume setup will error unless
- // it is marked optional.
+ // Items: A list of secret versions to mount in the volume. If no items
+ // are specified, the volume will expose a file with the same name as
+ // the secret name. The contents of the file will be the data in the
+ // latest version of the secret. If items are specified, the key will be
+ // used as the version to fetch from Cloud Secret Manager and the path
+ // will be the name of the file exposed in the volume. When items are
+ // defined, they must specify both a key and a path.
Items []*KeyToPath `json:"items,omitempty"`
- // Optional: (Optional) Specify whether the Secret or its keys must be
- // defined.
+ // Optional: Not supported by Cloud Run.
Optional bool `json:"optional,omitempty"`
// SecretName: The name of the secret in Cloud Secret Manager. By
@@ -3638,15 +3547,15 @@ func (s *SecretVolumeSource) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// SecurityContext: Not supported by Cloud Run SecurityContext holds
+// SecurityContext: Not supported by Cloud Run. SecurityContext holds
// security configuration that will be applied to a container. Some
// fields are present in both SecurityContext and PodSecurityContext.
// When both are set, the values in SecurityContext take precedence.
type SecurityContext struct {
- // RunAsUser: (Optional) The UID to run the entrypoint of the container
- // process. Defaults to user specified in image metadata if unspecified.
- // May also be set in PodSecurityContext. If set in both SecurityContext
- // and PodSecurityContext, the value specified in SecurityContext takes
+ // RunAsUser: The UID to run the entrypoint of the container process.
+ // Defaults to user specified in image metadata if unspecified. May also
+ // be set in PodSecurityContext. If set in both SecurityContext and
+ // PodSecurityContext, the value specified in SecurityContext takes
// precedence.
RunAsUser int64 `json:"runAsUser,omitempty"`
@@ -3685,16 +3594,25 @@ func (s *SecurityContext) MarshalJSON() ([]byte, error) {
// conditions as its own. See also:
// https://github.com/knative/serving/blob/main/docs/spec/overview.md#service
type Service struct {
- // ApiVersion: The API version for this call such as
+ // ApiVersion: The API version for this call. It must be
// "serving.knative.dev/v1".
ApiVersion string `json:"apiVersion,omitempty"`
- // Kind: The kind of resource, in this case "Service".
+ // Kind: The kind of resource. It must be "Service".
Kind string `json:"kind,omitempty"`
// Metadata: Metadata associated with this Service, including name,
- // namespace, labels, and annotations. Cloud Run (fully managed) uses
- // the following annotation keys to configure features on a Service: *
+ // namespace, labels, and annotations. 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. The following Cloud Run-specific annotations are
+ // accepted in Service.metadata.annotations. *
+ // `run.googleapis.com/binary-authorization-breakglass` *
+ // `run.googleapis.com/binary-authorization` *
+ // `run.googleapis.com/client-name` *
+ // `run.googleapis.com/custom-audiences` *
+ // `run.googleapis.com/description` *
+ // `run.googleapis.com/gc-traffic-tags` * `run.googleapis.com/ingress` *
// `run.googleapis.com/ingress` sets the ingress settings for the
// Service. See the ingress settings documentation
// (/run/docs/securing/ingress) for details on configuring ingress
@@ -3708,11 +3626,10 @@ type Service struct {
// `run.googleapis.com/ingress` are equal.
Metadata *ObjectMeta `json:"metadata,omitempty"`
- // Spec: Spec holds the desired state of the Service (from the client).
+ // Spec: Holds the desired state of the Service (from the client).
Spec *ServiceSpec `json:"spec,omitempty"`
- // Status: Status communicates the observed state of the Service (from
- // the controller).
+ // Status: Communicates the system-controlled state of the Service.
Status *ServiceStatus `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -3746,12 +3663,12 @@ func (s *Service) MarshalJSON() ([]byte, error) {
// the client), which is used to manipulate the underlying Route and
// Configuration(s).
type ServiceSpec struct {
- // Template: Template holds the latest specification for the Revision to
- // be stamped out.
+ // Template: Holds the latest specification for the Revision to be
+ // stamped out.
Template *RevisionTemplate `json:"template,omitempty"`
- // Traffic: Traffic specifies how to distribute traffic over a
- // collection of Knative Revisions and Configurations.
+ // Traffic: Specifies how to distribute traffic over a collection of
+ // Knative Revisions and Configurations to the Service's main URL.
Traffic []*TrafficTarget `json:"traffic,omitempty"`
// ForceSendFields is a list of field names (e.g. "Template") to
@@ -3779,46 +3696,44 @@ func (s *ServiceSpec) MarshalJSON() ([]byte, error) {
// ServiceStatus: The current state of the Service. Output only.
type ServiceStatus struct {
- // Address: From RouteStatus. Similar to url, information on where the
- // service is available on HTTP.
+ // Address: Similar to url, information on where the service is
+ // available on HTTP.
Address *Addressable `json:"address,omitempty"`
- // Conditions: Conditions communicates information about
- // ongoing/complete reconciliation processes that bring the "spec"
- // inline with the observed state of the world. Service-specific
- // conditions include: * "ConfigurationsReady": true when the underlying
- // Configuration is ready. * "RoutesReady": true when the underlying
- // Route is ready. * "Ready": true when both the underlying Route and
- // Configuration are ready.
+ // Conditions: Communicates information about ongoing/complete
+ // reconciliation processes that bring the `spec` inline with the
+ // observed state of the world. Service-specific conditions include: *
+ // `ConfigurationsReady`: `True` when the underlying Configuration is
+ // ready. * `RoutesReady`: `True` when the underlying Route is ready. *
+ // `Ready`: `True` when all underlying resources are ready.
Conditions []*GoogleCloudRunV1Condition `json:"conditions,omitempty"`
- // LatestCreatedRevisionName: From ConfigurationStatus.
- // LatestCreatedRevisionName is the last revision that was created from
- // this Service's Configuration. It might not be ready yet, for that use
- // LatestReadyRevisionName.
+ // LatestCreatedRevisionName: Name of the last revision that was created
+ // from this Service's Configuration. It might not be ready yet, for
+ // that use LatestReadyRevisionName.
LatestCreatedRevisionName string `json:"latestCreatedRevisionName,omitempty"`
- // LatestReadyRevisionName: From ConfigurationStatus.
- // LatestReadyRevisionName holds the name of the latest Revision stamped
- // out from this Service's Configuration that has had its "Ready"
- // condition become "True".
+ // LatestReadyRevisionName: Name of the latest Revision from this
+ // Service's Configuration that has had its `Ready` condition become
+ // `True`.
LatestReadyRevisionName string `json:"latestReadyRevisionName,omitempty"`
- // ObservedGeneration: ObservedGeneration is the 'Generation' of the
- // Route that was last processed by the controller. Clients polling for
- // completed reconciliation should poll until observedGeneration =
+ // ObservedGeneration: Returns the generation last fully processed by
+ // the system. This will only match metadata.generation when
+ // reconciliation is complete. Clients polling for completed
+ // reconciliation should poll until observedGeneration =
// metadata.generation and the Ready condition's status is True or
// False.
ObservedGeneration int64 `json:"observedGeneration,omitempty"`
- // Traffic: From RouteStatus. Traffic holds the configured traffic
- // distribution. These entries will always contain RevisionName
- // references. When ConfigurationName appears in the spec, this will
- // hold the LatestReadyRevisionName that we last observed.
+ // Traffic: Holds the configured traffic distribution. These entries
+ // will always contain RevisionName references. When ConfigurationName
+ // appears in the spec, this will hold the LatestReadyRevisionName that
+ // we last observed.
Traffic []*TrafficTarget `json:"traffic,omitempty"`
- // Url: From RouteStatus. URL holds the url that will distribute traffic
- // over the provided traffic targets. It generally has the form
+ // Url: URL that will distribute traffic over the provided traffic
+ // targets. It generally has the form
// https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app
Url string `json:"url,omitempty"`
@@ -3883,37 +3798,34 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) {
}
// Status: Status is a return value for calls that don't return other
-// objects
+// objects.
type Status struct {
// Code: Suggested HTTP return code for this status, 0 if not set.
- // +optional
Code int64 `json:"code,omitempty"`
// Details: Extended data associated with the reason. Each reason may
// define its own extended details. This field is optional and the data
// returned is not guaranteed to conform to any schema except that
- // defined by the reason type. +optional
+ // defined by the reason type.
Details *StatusDetails `json:"details,omitempty"`
// Message: A human-readable description of the status of this
- // operation. +optional
+ // 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
- // +optional
Metadata *ListMeta `json:"metadata,omitempty"`
// Reason: 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. +optional
+ // 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
- // +optional
Status string `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -3951,17 +3863,17 @@ type StatusCause struct {
// by its JSON serialization. May include dot and postfix notation for
// nested attributes. Arrays are zero-indexed. Fields may appear more
// than once in an array of causes due to fields having multiple errors.
- // Optional. Examples: "name" - the field "name" on the current resource
+ // Examples: "name" - the field "name" on the current resource
// "items[0].name" - the field "name" on the first array entry in
- // "items" +optional
+ // "items"
Field string `json:"field,omitempty"`
// Message: A human-readable description of the cause of the error. This
- // field may be presented as-is to a reader. +optional
+ // field may be presented as-is to a reader.
Message string `json:"message,omitempty"`
// Reason: A machine-readable description of the cause of the error. If
- // this value is empty there is no information available. +optional
+ // this value is empty there is no information available.
Reason string `json:"reason,omitempty"`
// ForceSendFields is a list of field names (e.g. "Field") to
@@ -3996,34 +3908,32 @@ func (s *StatusCause) MarshalJSON() ([]byte, error) {
type StatusDetails struct {
// Causes: The Causes array includes more details associated with the
// StatusReason failure. Not all StatusReasons may provide detailed
- // causes. +optional
+ // causes.
Causes []*StatusCause `json:"causes,omitempty"`
// Group: The group attribute of the resource associated with the status
- // StatusReason. +optional
+ // StatusReason.
Group string `json:"group,omitempty"`
// 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
- // +optional
Kind string `json:"kind,omitempty"`
// Name: The name attribute of the resource associated with the status
// StatusReason (when there is a single name which can be described).
- // +optional
Name string `json:"name,omitempty"`
// RetryAfterSeconds: If specified, the time in seconds before the
// operation should be retried. Some errors may indicate the client must
// take an alternate action - for those errors this field may indicate
- // how long to wait before taking the alternate action. +optional
+ // how long to wait before taking the alternate action.
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 +optional
+ // https://kubernetes.io/docs/user-guide/identifiers#uids
Uid string `json:"uid,omitempty"`
// ForceSendFields is a list of field names (e.g. "Causes") to
@@ -4049,17 +3959,14 @@ func (s *StatusDetails) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// TCPSocketAction: Not supported by Cloud Run TCPSocketAction describes
-// an action based on opening a socket
+// TCPSocketAction: TCPSocketAction describes an action based on opening
+// a socket
type TCPSocketAction struct {
- // Host: (Optional) Optional: Host name to connect to, defaults to the
- // pod IP.
+ // Host: Not supported by Cloud Run.
Host string `json:"host,omitempty"`
- // Port: Number or name of the port to access on the container. Number
- // must be in the range 1 to 65535. Name must be an IANA_SVC_NAME. This
- // field is currently limited to integer types only because of proto's
- // inability to properly support the IntOrString golang type.
+ // Port: Port number to access on the container. Number must be in the
+ // range 1 to 65535.
Port int64 `json:"port,omitempty"`
// ForceSendFields is a list of field names (e.g. "Host") to
@@ -4092,7 +3999,6 @@ type Task struct {
// 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
- // +optional
ApiVersion string `json:"apiVersion,omitempty"`
// Kind: Optional. Kind is a string value representing the REST resource
@@ -4100,23 +4006,19 @@ type Task struct {
// 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
- // +optional
Kind string `json:"kind,omitempty"`
// Metadata: Optional. Standard object's metadata. More info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
- // +optional
+ // https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#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/api-conventions.md#spec-and-status
- // +optional
+ // 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 *TaskSpec `json:"spec,omitempty"`
- // Status: Output only. Current status of an execution. More info:
- // https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
- // +optional
+ // 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 *TaskStatus `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
@@ -4195,18 +4097,18 @@ type TaskSpec struct {
// account associated with the task of a job execution. The service
// account represents the identity of the running task, and determines
// what permissions the task has. If not provided, the task will use the
- // project's default service account. +optional
+ // project's default service account.
ServiceAccountName string `json:"serviceAccountName,omitempty"`
- // TimeoutSeconds: Optional. Optional duration in seconds the task may
- // be active before the system will actively try to mark it failed and
- // kill associated containers. This applies per attempt of a task,
- // meaning each retry can run for the full timeout. +optional
+ // TimeoutSeconds: Optional. Duration in seconds the task may be active
+ // before the system will actively try to mark it failed and kill
+ // associated containers. This applies per attempt of a task, meaning
+ // each retry can run for the full timeout.
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 +optional
+ // https://kubernetes.io/docs/concepts/storage/volumes
Volumes []*Volume `json:"volumes,omitempty"`
// ForceSendFields is a list of field names (e.g. "Containers") to
@@ -4232,19 +4134,17 @@ func (s *TaskSpec) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
-// TaskStatus: TaskStatus represents the status of a task of a job
-// execution.
+// TaskStatus: TaskStatus represents the status of a task.
type TaskStatus struct {
// CompletionTime: Optional. Represents time when the task was
// completed. It is not guaranteed to be set in happens-before order
// across separate operations. It is represented in RFC3339 form and is
- // in UTC. +optional
+ // in UTC.
CompletionTime string `json:"completionTime,omitempty"`
// Conditions: Optional. The latest available observations of a task's
// current state. More info:
- // https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
- // +optional
+ // https://kubernetes.io/docs/concepts/workloads/controllers/job/
Conditions []*GoogleCloudRunV1Condition `json:"conditions,omitempty"`
// Index: Required. Index of the task, unique per execution, and
@@ -4252,26 +4152,23 @@ type TaskStatus struct {
Index int64 `json:"index,omitempty"`
// LastAttemptResult: Optional. Result of the last attempt of this task.
- // +optional
LastAttemptResult *TaskAttemptResult `json:"lastAttemptResult,omitempty"`
// LogUri: Optional. URI where logs for this task can be found in Cloud
// Console.
LogUri string `json:"logUri,omitempty"`
- // ObservedGeneration: Optional. The 'generation' of the execution that
- // was last processed by the controller.
+ // ObservedGeneration: Optional. The 'generation' of the task that was
+ // last processed by the controller.
ObservedGeneration int64 `json:"observedGeneration,omitempty"`
// Retried: Optional. The number of times this task was retried.
// Instances are retried when they fail up to the maxRetries limit.
- // +optional
Retried int64 `json:"retried,omitempty"`
// StartTime: Optional. Represents time when the task started to run. It
// is not guaranteed to be set in happens-before order across separate
// operations. It is represented in RFC3339 form and is in UTC.
- // +optional
StartTime string `json:"startTime,omitempty"`
// ForceSendFields is a list of field names (e.g. "CompletionTime") to
@@ -4304,7 +4201,6 @@ 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
- // +optional
Spec *TaskSpec `json:"spec,omitempty"`
// ForceSendFields is a list of field names (e.g. "Spec") to
@@ -4400,9 +4296,9 @@ func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error) {
// table for a Route.
type TrafficTarget struct {
// ConfigurationName: ConfigurationName of a configuration to whose
- // latest revision we will send this portion of traffic. When the
+ // latest revision which will be sent this portion of traffic. When the
// "status.latestReadyRevisionName" of the referenced configuration
- // changes, we will automatically migrate traffic from the prior "latest
+ // changes, traffic will automatically migrate from the prior "latest
// ready" revision to the new one. This field is never set in Route's
// status, only its spec. This is mutually exclusive with RevisionName.
// Cloud Run currently supports a single ConfigurationName.
@@ -4460,12 +4356,19 @@ func (s *TrafficTarget) MarshalJSON() ([]byte, error) {
// Volume: Volume represents a named volume in a container.
type Volume struct {
+ // ConfigMap: Adapts a ConfigMap into a volume. The contents of the
+ // target ConfigMap's Data field will be presented in a volume as files
+ // using the keys in the Data field as the file names, unless the items
+ // element is populated with specific mappings of keys to paths.
ConfigMap *ConfigMapVolumeSource `json:"configMap,omitempty"`
// Name: Volume's name. In Cloud Run Fully Managed, the name 'cloudsql'
// is reserved.
Name string `json:"name,omitempty"`
+ // Secret: The secret's value will be presented as the content of a file
+ // whose name is defined in the item path. If no items are defined, the
+ // name of the file is the secretName.
Secret *SecretVolumeSource `json:"secret,omitempty"`
// ForceSendFields is a list of field names (e.g. "ConfigMap") to
@@ -4494,19 +4397,20 @@ func (s *Volume) MarshalJSON() ([]byte, error) {
// VolumeMount: VolumeMount describes a mounting of a Volume within a
// container.
type VolumeMount struct {
- // MountPath: Path within the container at which the volume should be
- // mounted. Must not contain ':'.
+ // MountPath: Required. Path within the container at which the volume
+ // should be mounted. Must not contain ':'.
MountPath string `json:"mountPath,omitempty"`
- // Name: The name of the volume. There must be a corresponding Volume
- // with the same name.
+ // Name: Required. The name of the volume. There must be a corresponding
+ // Volume with the same name.
Name string `json:"name,omitempty"`
- // ReadOnly: (Optional) Only true is accepted. Defaults to true.
+ // ReadOnly: Only true is accepted for Secret Volumes. Defaults to true
+ // for Secrets Volumes.
ReadOnly bool `json:"readOnly,omitempty"`
- // SubPath: (Optional) Path within the volume from which the container's
- // volume should be mounted. Defaults to "" (volume's root).
+ // SubPath: Path within the volume from which the container's volume
+ // should be mounted. Defaults to "" (volume's root).
SubPath string `json:"subPath,omitempty"`
// ForceSendFields is a list of field names (e.g. "MountPath") to
@@ -4545,8 +4449,8 @@ type NamespacesAuthorizeddomainsListCall struct {
// List: List authorized domains.
//
-// - parent: Name of the parent Project resource. Example:
-// `projects/myproject`.
+// - parent: Name of the parent Project resource. Example:
+// `projects/myproject`.
func (r *NamespacesAuthorizeddomainsService) List(parent string) *NamespacesAuthorizeddomainsListCall {
c := &NamespacesAuthorizeddomainsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4738,9 +4642,8 @@ type NamespacesConfigurationsGetCall struct {
// Get: Get information about a configuration.
//
-// - name: The name of the configuration to retrieve. For Cloud Run
-// (fully managed), replace {namespace_id} with the project ID or
-// number.
+// - name: The name of the configuration to retrieve. For Cloud Run,
+// replace {namespace_id} with the project ID or number.
func (r *NamespacesConfigurationsService) Get(name string) *NamespacesConfigurationsGetCall {
c := &NamespacesConfigurationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4855,7 +4758,7 @@ func (c *NamespacesConfigurationsGetCall) Do(opts ...googleapi.CallOption) (*Con
// ],
// "parameters": {
// "name": {
- // "description": "The name of the configuration to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ // "description": "The name of the configuration to retrieve. For Cloud Run, replace {namespace_id} with the project ID or number.",
// "location": "path",
// "pattern": "^namespaces/[^/]+/configurations/[^/]+$",
// "required": true,
@@ -4886,9 +4789,9 @@ type NamespacesConfigurationsListCall struct {
// List: List configurations.
//
-// - parent: The namespace from which the configurations should be
-// listed. For Cloud Run (fully managed), replace {namespace_id} with
-// the project ID or number.
+// - parent: The namespace from which the configurations should be
+// listed. For Cloud Run, replace {namespace_id} with the project ID
+// or number.
func (r *NamespacesConfigurationsService) List(parent string) *NamespacesConfigurationsListCall {
c := &NamespacesConfigurationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4902,17 +4805,15 @@ func (c *NamespacesConfigurationsListCall) Continue(continue_ string) *Namespace
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported by Cloud Run.
func (c *NamespacesConfigurationsListCall) FieldSelector(fieldSelector string) *NamespacesConfigurationsListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported by Cloud Run.
func (c *NamespacesConfigurationsListCall) IncludeUninitialized(includeUninitialized bool) *NamespacesConfigurationsListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -4926,24 +4827,22 @@ func (c *NamespacesConfigurationsListCall) LabelSelector(labelSelector string) *
return c
}
-// Limit sets the optional parameter "limit": The maximum number of
+// Limit sets the optional parameter "limit": The maximum number of the
// records that should be returned.
func (c *NamespacesConfigurationsListCall) Limit(limit int64) *NamespacesConfigurationsListCall {
c.urlParams_.Set("limit", fmt.Sprint(limit))
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported by Cloud Run.
func (c *NamespacesConfigurationsListCall) ResourceVersion(resourceVersion string) *NamespacesConfigurationsListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
-// by Cloud Run.
+// Watch sets the optional parameter "watch": Not supported by Cloud
+// Run.
func (c *NamespacesConfigurationsListCall) Watch(watch bool) *NamespacesConfigurationsListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
return c
@@ -5062,12 +4961,12 @@ func (c *NamespacesConfigurationsListCall) Do(opts ...googleapi.CallOption) (*Li
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -5077,25 +4976,25 @@ func (c *NamespacesConfigurationsListCall) Do(opts ...googleapi.CallOption) (*Li
// "type": "string"
// },
// "limit": {
- // "description": "Optional. The maximum number of records that should be returned.",
+ // "description": "Optional. The maximum number of the records that should be returned.",
// "format": "int32",
// "location": "query",
// "type": "integer"
// },
// "parent": {
- // "description": "The namespace from which the configurations should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ // "description": "The namespace from which the configurations should be listed. For Cloud Run, replace {namespace_id} with the project ID or number.",
// "location": "path",
// "pattern": "^namespaces/[^/]+$",
// "required": true,
// "type": "string"
// },
// "resourceVersion": {
- // "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -5124,10 +5023,10 @@ type NamespacesDomainmappingsCreateCall struct {
// Create: Create a new domain mapping.
//
-// - parent: 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.
+// - parent: 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.
func (r *NamespacesDomainmappingsService) Create(parent string, domainmapping *DomainMapping) *NamespacesDomainmappingsCreateCall {
c := &NamespacesDomainmappingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5281,10 +5180,10 @@ type NamespacesDomainmappingsDeleteCall struct {
// Delete: Delete a domain mapping.
//
-// - name: 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.
+// - name: 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.
func (r *NamespacesDomainmappingsService) Delete(name string) *NamespacesDomainmappingsDeleteCall {
c := &NamespacesDomainmappingsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5316,8 +5215,8 @@ func (c *NamespacesDomainmappingsDeleteCall) Kind(kind string) *NamespacesDomain
// 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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
-// for more information.
+// kubernetes.io/docs/concepts/architecture/garbage-collection/ for more
+// information.
func (c *NamespacesDomainmappingsDeleteCall) PropagationPolicy(propagationPolicy string) *NamespacesDomainmappingsDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
return c
@@ -5440,7 +5339,7 @@ func (c *NamespacesDomainmappingsDeleteCall) 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 kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.",
// "location": "query",
// "type": "string"
// }
@@ -5469,10 +5368,10 @@ type NamespacesDomainmappingsGetCall struct {
// Get: Get information about a domain mapping.
//
-// - name: 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.
+// - name: 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.
func (r *NamespacesDomainmappingsService) Get(name string) *NamespacesDomainmappingsGetCall {
c := &NamespacesDomainmappingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5616,12 +5515,12 @@ type NamespacesDomainmappingsListCall struct {
header_ http.Header
}
-// List: List domain mappings.
+// List: List all domain mappings.
//
-// - parent: 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.
+// - parent: 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.
func (r *NamespacesDomainmappingsService) List(parent string) *NamespacesDomainmappingsListCall {
c := &NamespacesDomainmappingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5781,7 +5680,7 @@ func (c *NamespacesDomainmappingsListCall) Do(opts ...googleapi.CallOption) (*Li
}
return ret, nil
// {
- // "description": "List domain mappings.",
+ // "description": "List all domain mappings.",
// "flatPath": "apis/domains.cloudrun.com/v1/namespaces/{namespacesId}/domainmappings",
// "httpMethod": "GET",
// "id": "run.namespaces.domainmappings.list",
@@ -5844,6 +5743,150 @@ func (c *NamespacesDomainmappingsListCall) Do(opts ...googleapi.CallOption) (*Li
}
+// method id "run.namespaces.executions.cancel":
+
+type NamespacesExecutionsCancelCall struct {
+ s *APIService
+ name string
+ cancelexecutionrequest *CancelExecutionRequest
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Cancel: Cancel an execution.
+//
+// - name: The name of the execution to cancel. Replace {namespace} with
+// the project ID or number. It takes the form namespaces/{namespace}.
+// For example: namespaces/PROJECT_ID.
+func (r *NamespacesExecutionsService) Cancel(name string, cancelexecutionrequest *CancelExecutionRequest) *NamespacesExecutionsCancelCall {
+ c := &NamespacesExecutionsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ c.cancelexecutionrequest = cancelexecutionrequest
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *NamespacesExecutionsCancelCall) Fields(s ...googleapi.Field) *NamespacesExecutionsCancelCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *NamespacesExecutionsCancelCall) Context(ctx context.Context) *NamespacesExecutionsCancelCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *NamespacesExecutionsCancelCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *NamespacesExecutionsCancelCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.cancelexecutionrequest)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "apis/run.googleapis.com/v1/{+name}:cancel")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("POST", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "run.namespaces.executions.cancel" call.
+// Exactly one of *Execution or error will be non-nil. Any non-2xx
+// status code is an error. Response headers are in either
+// *Execution.ServerResponse.Header or (if a response was returned at
+// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified
+// to check whether the returned error was because
+// http.StatusNotModified was returned.
+func (c *NamespacesExecutionsCancelCall) Do(opts ...googleapi.CallOption) (*Execution, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &Execution{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Cancel an execution.",
+ // "flatPath": "apis/run.googleapis.com/v1/namespaces/{namespacesId}/executions/{executionsId}:cancel",
+ // "httpMethod": "POST",
+ // "id": "run.namespaces.executions.cancel",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. The name of the execution to cancel. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID",
+ // "location": "path",
+ // "pattern": "^namespaces/[^/]+/executions/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "apis/run.googleapis.com/v1/{+name}:cancel",
+ // "request": {
+ // "$ref": "CancelExecutionRequest"
+ // },
+ // "response": {
+ // "$ref": "Execution"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
// method id "run.namespaces.executions.delete":
type NamespacesExecutionsDeleteCall struct {
@@ -5856,9 +5899,9 @@ type NamespacesExecutionsDeleteCall struct {
// Delete: Delete an execution.
//
-// - name: The name of the execution to delete. Replace {namespace} with
-// the project ID or number. It takes the form namespaces/{namespace}.
-// For example: namespaces/PROJECT_ID.
+// - name: The name of the execution to delete. Replace {namespace} with
+// the project ID or number. It takes the form namespaces/{namespace}.
+// For example: namespaces/PROJECT_ID.
func (r *NamespacesExecutionsService) Delete(name string) *NamespacesExecutionsDeleteCall {
c := &NamespacesExecutionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5882,7 +5925,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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
+// http://kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
// for more information.
func (c *NamespacesExecutionsDeleteCall) PropagationPolicy(propagationPolicy string) *NamespacesExecutionsDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
@@ -6001,7 +6044,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 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, and deletes in the background. Please see http://kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
// "location": "query",
// "type": "string"
// }
@@ -6030,9 +6073,9 @@ type NamespacesExecutionsGetCall struct {
// Get: Get information about an execution.
//
-// - name: The name of the execution to retrieve. Replace {namespace}
-// with the project ID or number. It takes the form
-// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
+// - name: The name of the execution to retrieve. Replace {namespace}
+// with the project ID or number. It takes the form
+// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
func (r *NamespacesExecutionsService) Get(name string) *NamespacesExecutionsGetCall {
c := &NamespacesExecutionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6178,9 +6221,9 @@ type NamespacesExecutionsListCall struct {
// List: List executions.
//
-// - parent: The namespace from which the executions should be listed.
-// Replace {namespace} with the project ID or number. It takes the
-// form namespaces/{namespace}. For example: namespaces/PROJECT_ID.
+// - parent: The namespace from which the executions should be listed.
+// Replace {namespace} with the project ID or number. It takes the
+// form namespaces/{namespace}. For example: namespaces/PROJECT_ID.
func (r *NamespacesExecutionsService) List(parent string) *NamespacesExecutionsListCall {
c := &NamespacesExecutionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6194,17 +6237,15 @@ func (c *NamespacesExecutionsListCall) Continue(continue_ string) *NamespacesExe
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported by Cloud Run.
func (c *NamespacesExecutionsListCall) FieldSelector(fieldSelector string) *NamespacesExecutionsListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported by Cloud Run.
func (c *NamespacesExecutionsListCall) IncludeUninitialized(includeUninitialized bool) *NamespacesExecutionsListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -6218,24 +6259,22 @@ func (c *NamespacesExecutionsListCall) LabelSelector(labelSelector string) *Name
return c
}
-// Limit sets the optional parameter "limit": The maximum number of
+// Limit sets the optional parameter "limit": The maximum number of the
// records that should be returned.
func (c *NamespacesExecutionsListCall) Limit(limit int64) *NamespacesExecutionsListCall {
c.urlParams_.Set("limit", fmt.Sprint(limit))
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported by Cloud Run.
func (c *NamespacesExecutionsListCall) ResourceVersion(resourceVersion string) *NamespacesExecutionsListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
-// by Cloud Run.
+// Watch sets the optional parameter "watch": Not supported by Cloud
+// Run.
func (c *NamespacesExecutionsListCall) Watch(watch bool) *NamespacesExecutionsListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
return c
@@ -6354,12 +6393,12 @@ func (c *NamespacesExecutionsListCall) Do(opts ...googleapi.CallOption) (*ListEx
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Optional. Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Optional. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -6369,7 +6408,7 @@ func (c *NamespacesExecutionsListCall) Do(opts ...googleapi.CallOption) (*ListEx
// "type": "string"
// },
// "limit": {
- // "description": "Optional. The maximum number of records that should be returned.",
+ // "description": "Optional. The maximum number of the records that should be returned.",
// "format": "int32",
// "location": "query",
// "type": "integer"
@@ -6382,12 +6421,12 @@ func (c *NamespacesExecutionsListCall) Do(opts ...googleapi.CallOption) (*ListEx
// "type": "string"
// },
// "resourceVersion": {
- // "description": "Optional. The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Optional. Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -6416,9 +6455,9 @@ type NamespacesJobsCreateCall struct {
// Create: Create a job.
//
-// - parent: The namespace in which the job should be created. Replace
-// {namespace} with the project ID or number. It takes the form
-// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
+// - parent: The namespace in which the job should be created. Replace
+// {namespace} with the project ID or number. It takes the form
+// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
func (r *NamespacesJobsService) Create(parent string, job *Job) *NamespacesJobsCreateCall {
c := &NamespacesJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6559,9 +6598,9 @@ type NamespacesJobsDeleteCall struct {
// Delete: Delete a job.
//
-// - name: The name of the job to delete. Replace {namespace} with the
-// project ID or number. It takes the form namespaces/{namespace}. For
-// example: namespaces/PROJECT_ID.
+// - name: The name of the job to delete. Replace {namespace} with the
+// project ID or number. It takes the form namespaces/{namespace}. For
+// example: namespaces/PROJECT_ID.
func (r *NamespacesJobsService) Delete(name string) *NamespacesJobsDeleteCall {
c := &NamespacesJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6733,9 +6772,9 @@ type NamespacesJobsGetCall struct {
// Get: Get information about a job.
//
-// - name: The name of the job to retrieve. Replace {namespace} with the
-// project ID or number. It takes the form namespaces/{namespace}. For
-// example: namespaces/PROJECT_ID.
+// - name: The name of the job to retrieve. Replace {namespace} with the
+// project ID or number. It takes the form namespaces/{namespace}. For
+// example: namespaces/PROJECT_ID.
func (r *NamespacesJobsService) Get(name string) *NamespacesJobsGetCall {
c := &NamespacesJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6881,9 +6920,9 @@ type NamespacesJobsListCall struct {
// List: List jobs.
//
-// - parent: The namespace from which the jobs should be listed. Replace
-// {namespace} with the project ID or number. It takes the form
-// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
+// - parent: The namespace from which the jobs should be listed. Replace
+// {namespace} with the project ID or number. It takes the form
+// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
func (r *NamespacesJobsService) List(parent string) *NamespacesJobsListCall {
c := &NamespacesJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6897,17 +6936,15 @@ func (c *NamespacesJobsListCall) Continue(continue_ string) *NamespacesJobsListC
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported by Cloud Run.
func (c *NamespacesJobsListCall) FieldSelector(fieldSelector string) *NamespacesJobsListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported by Cloud Run.
func (c *NamespacesJobsListCall) IncludeUninitialized(includeUninitialized bool) *NamespacesJobsListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -6928,17 +6965,15 @@ func (c *NamespacesJobsListCall) Limit(limit int64) *NamespacesJobsListCall {
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported by Cloud Run.
func (c *NamespacesJobsListCall) ResourceVersion(resourceVersion string) *NamespacesJobsListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
-// by Cloud Run.
+// Watch sets the optional parameter "watch": Not supported by Cloud
+// Run.
func (c *NamespacesJobsListCall) Watch(watch bool) *NamespacesJobsListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
return c
@@ -7057,12 +7092,12 @@ func (c *NamespacesJobsListCall) Do(opts ...googleapi.CallOption) (*ListJobsResp
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Optional. Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Optional. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -7085,12 +7120,12 @@ func (c *NamespacesJobsListCall) Do(opts ...googleapi.CallOption) (*ListJobsResp
// "type": "string"
// },
// "resourceVersion": {
- // "description": "Optional. The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Optional. Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -7123,9 +7158,9 @@ type NamespacesJobsReplaceJobCall struct {
// metadata.resourceVersion to enforce update from last read for
// optimistic concurrency control.
//
-// - name: The name of the service being replaced. Replace {namespace}
-// with the project ID or number. It takes the form
-// namespaces/{namespace}. For example: namespaces/PROJECT_ID.
+// - name: The name of the job being replaced. Replace {namespace} with
+// the project ID or number. It takes the form namespaces/{namespace}.
+// For example: namespaces/PROJECT_ID.
func (r *NamespacesJobsService) ReplaceJob(name string, job *Job) *NamespacesJobsReplaceJobCall {
c := &NamespacesJobsReplaceJobCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7233,7 +7268,7 @@ func (c *NamespacesJobsReplaceJobCall) Do(opts ...googleapi.CallOption) (*Job, e
// ],
// "parameters": {
// "name": {
- // "description": "Required. The name of the service being replaced. 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 job being replaced. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID",
// "location": "path",
// "pattern": "^namespaces/[^/]+/jobs/[^/]+$",
// "required": true,
@@ -7267,9 +7302,9 @@ type NamespacesJobsRunCall struct {
// Run: Trigger creation of a new execution of this job.
//
-// - name: The name of the job to run. Replace {namespace} with the
-// project ID or number. It takes the form namespaces/{namespace}. For
-// example: namespaces/PROJECT_ID.
+// - name: The name of the job to run. Replace {namespace} with the
+// project ID or number. It takes the form namespaces/{namespace}. For
+// example: namespaces/PROJECT_ID.
func (r *NamespacesJobsService) Run(name string, runjobrequest *RunJobRequest) *NamespacesJobsRunCall {
c := &NamespacesJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7410,10 +7445,10 @@ type NamespacesRevisionsDeleteCall struct {
// Delete: Delete a revision.
//
-// - name: The name of the revision 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.
+// - name: The name of the revision 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.
func (r *NamespacesRevisionsService) Delete(name string) *NamespacesRevisionsDeleteCall {
c := &NamespacesRevisionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7445,7 +7480,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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
+// https://kubernetes.io/docs/concepts/architecture/garbage-collection/
// for more information.
func (c *NamespacesRevisionsDeleteCall) PropagationPolicy(propagationPolicy string) *NamespacesRevisionsDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
@@ -7569,7 +7604,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 kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ // "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.",
// "location": "query",
// "type": "string"
// }
@@ -7598,10 +7633,10 @@ type NamespacesRevisionsGetCall struct {
// Get: Get information about a revision.
//
-// - name: The name of the revision 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.
+// - name: The name of the revision 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.
func (r *NamespacesRevisionsService) Get(name string) *NamespacesRevisionsGetCall {
c := &NamespacesRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7747,10 +7782,10 @@ type NamespacesRevisionsListCall struct {
// List: List revisions.
//
-// - parent: The namespace from which the revisions 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.
+// - parent: The namespace from which the revisions 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.
func (r *NamespacesRevisionsService) List(parent string) *NamespacesRevisionsListCall {
c := &NamespacesRevisionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7986,10 +8021,10 @@ type NamespacesRoutesGetCall struct {
// Get: Get information about a route.
//
-// - name: The name of the route 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.
+// - name: The name of the route 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.
func (r *NamespacesRoutesService) Get(name string) *NamespacesRoutesGetCall {
c := &NamespacesRoutesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8135,10 +8170,10 @@ type NamespacesRoutesListCall struct {
// List: List routes.
//
-// - parent: The namespace from which the routes 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.
+// - parent: The namespace from which the routes 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.
func (r *NamespacesRoutesService) List(parent string) *NamespacesRoutesListCall {
c := &NamespacesRoutesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8372,12 +8407,14 @@ type NamespacesServicesCreateCall struct {
header_ http.Header
}
-// Create: Create a service.
+// Create: Creates a new Service. Service creation will trigger a new
+// deployment. Use GetService, and check service.status to determine if
+// the Service is ready.
//
-// - parent: The namespace in which the service 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.
+// - parent: The resource's parent. In Cloud Run, it may be one of the
+// following: * `namespaces/{project_id_or_number}` *
+// `projects/{project_id_or_number}/locations/{region}` *
+// `projects/{project_id_or_number}/regions/{region}`.
func (r *NamespacesServicesService) Create(parent string, service *Service) *NamespacesServicesCreateCall {
c := &NamespacesServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8484,7 +8521,7 @@ func (c *NamespacesServicesCreateCall) Do(opts ...googleapi.CallOption) (*Servic
}
return ret, nil
// {
- // "description": "Create a service.",
+ // "description": "Creates a new Service. Service creation will trigger a new deployment. Use GetService, and check service.status to determine if the Service is ready.",
// "flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services",
// "httpMethod": "POST",
// "id": "run.namespaces.services.create",
@@ -8498,7 +8535,7 @@ func (c *NamespacesServicesCreateCall) Do(opts ...googleapi.CallOption) (*Servic
// "type": "string"
// },
// "parent": {
- // "description": "The namespace in which the service 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": "The resource's parent. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
// "location": "path",
// "pattern": "^namespaces/[^/]+$",
// "required": true,
@@ -8529,22 +8566,24 @@ type NamespacesServicesDeleteCall struct {
header_ http.Header
}
-// Delete: Delete a service. This will cause the Service to stop serving
-// traffic and will delete the child entities like Routes,
-// Configurations and Revisions.
+// Delete: Deletes the provided service. This will cause the Service to
+// stop serving traffic and will delete all associated Revisions.
//
-// - name: The name of the service 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.
+// - name: The fully qualified name of the service to delete. It can be
+// any of the following forms: *
+// `namespaces/{project_id_or_number}/services/{service_name}` *
+// `projects/{project_id_or_number}/locations/{region}/services/{servic
+// e_name}` *
+// `projects/{project_id_or_number}/regions/{region}/services/{service_
+// name}`.
func (r *NamespacesServicesService) Delete(name string) *NamespacesServicesDeleteCall {
c := &NamespacesServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
return c
}
-// ApiVersion sets the optional parameter "apiVersion": Cloud Run
-// currently ignores this parameter.
+// ApiVersion sets the optional parameter "apiVersion": Not supported,
+// and ignored by Cloud Run.
func (c *NamespacesServicesDeleteCall) ApiVersion(apiVersion string) *NamespacesServicesDeleteCall {
c.urlParams_.Set("apiVersion", apiVersion)
return c
@@ -8558,18 +8597,15 @@ func (c *NamespacesServicesDeleteCall) DryRun(dryRun string) *NamespacesServices
return c
}
-// Kind sets the optional parameter "kind": Cloud Run currently ignores
-// this parameter.
+// Kind sets the optional parameter "kind": Not supported, and ignored
+// by Cloud Run.
func (c *NamespacesServicesDeleteCall) Kind(kind string) *NamespacesServicesDeleteCall {
c.urlParams_.Set("kind", kind)
return c
}
// 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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
-// for more information.
+// Not supported, and ignored by Cloud Run.
func (c *NamespacesServicesDeleteCall) PropagationPolicy(propagationPolicy string) *NamespacesServicesDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
return c
@@ -8661,7 +8697,7 @@ func (c *NamespacesServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Status
}
return ret, nil
// {
- // "description": "Delete a service. This will cause the Service to stop serving traffic and will delete the child entities like Routes, Configurations and Revisions.",
+ // "description": "Deletes the provided service. This will cause the Service to stop serving traffic and will delete all associated Revisions.",
// "flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services/{servicesId}",
// "httpMethod": "DELETE",
// "id": "run.namespaces.services.delete",
@@ -8670,7 +8706,7 @@ func (c *NamespacesServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Status
// ],
// "parameters": {
// "apiVersion": {
- // "description": "Cloud Run currently ignores this parameter.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
@@ -8680,19 +8716,19 @@ func (c *NamespacesServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Status
// "type": "string"
// },
// "kind": {
- // "description": "Cloud Run currently ignores this parameter.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "name": {
- // "description": "The name of the service 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": "The fully qualified name of the service to delete. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
// "location": "path",
// "pattern": "^namespaces/[^/]+/services/[^/]+$",
// "required": true,
// "type": "string"
// },
// "propagationPolicy": {
- // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// }
@@ -8719,12 +8755,15 @@ type NamespacesServicesGetCall struct {
header_ http.Header
}
-// Get: Get information about a service.
+// Get: Gets information about a service.
//
-// - name: The name of the service 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.
+// - name: The fully qualified name of the service to retrieve. It can
+// be any of the following forms: *
+// `namespaces/{project_id_or_number}/services/{service_name}` *
+// `projects/{project_id_or_number}/locations/{region}/services/{servic
+// e_name}` *
+// `projects/{project_id_or_number}/regions/{region}/services/{service_
+// name}`.
func (r *NamespacesServicesService) Get(name string) *NamespacesServicesGetCall {
c := &NamespacesServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8830,7 +8869,7 @@ func (c *NamespacesServicesGetCall) Do(opts ...googleapi.CallOption) (*Service,
}
return ret, nil
// {
- // "description": "Get information about a service.",
+ // "description": "Gets information about a service.",
// "flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services/{servicesId}",
// "httpMethod": "GET",
// "id": "run.namespaces.services.get",
@@ -8839,7 +8878,7 @@ func (c *NamespacesServicesGetCall) Do(opts ...googleapi.CallOption) (*Service,
// ],
// "parameters": {
// "name": {
- // "description": "The name of the service 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": "The fully qualified name of the service to retrieve. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
// "location": "path",
// "pattern": "^namespaces/[^/]+/services/[^/]+$",
// "required": true,
@@ -8868,12 +8907,13 @@ type NamespacesServicesListCall struct {
header_ http.Header
}
-// List: List services.
+// List: Lists services for the given project and region.
//
-// - parent: The namespace from which the services 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.
+// - parent: The parent from where the resources should be listed. In
+// Cloud Run, it may be one of the following: *
+// `namespaces/{project_id_or_number}` *
+// `projects/{project_id_or_number}/locations/{region}` *
+// `projects/{project_id_or_number}/regions/{region}`.
func (r *NamespacesServicesService) List(parent string) *NamespacesServicesListCall {
c := &NamespacesServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8887,17 +8927,15 @@ func (c *NamespacesServicesListCall) Continue(continue_ string) *NamespacesServi
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported, and ignored by Cloud Run.
func (c *NamespacesServicesListCall) FieldSelector(fieldSelector string) *NamespacesServicesListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported, and ignored by Cloud Run.
func (c *NamespacesServicesListCall) IncludeUninitialized(includeUninitialized bool) *NamespacesServicesListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -8918,16 +8956,14 @@ func (c *NamespacesServicesListCall) Limit(limit int64) *NamespacesServicesListC
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported, and ignored by Cloud Run.
func (c *NamespacesServicesListCall) ResourceVersion(resourceVersion string) *NamespacesServicesListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
+// Watch sets the optional parameter "watch": Not supported, and ignored
// by Cloud Run.
func (c *NamespacesServicesListCall) Watch(watch bool) *NamespacesServicesListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
@@ -9033,7 +9069,7 @@ func (c *NamespacesServicesListCall) Do(opts ...googleapi.CallOption) (*ListServ
}
return ret, nil
// {
- // "description": "List services.",
+ // "description": "Lists services for the given project and region.",
// "flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services",
// "httpMethod": "GET",
// "id": "run.namespaces.services.list",
@@ -9047,12 +9083,12 @@ func (c *NamespacesServicesListCall) Do(opts ...googleapi.CallOption) (*ListServ
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -9068,19 +9104,19 @@ func (c *NamespacesServicesListCall) Do(opts ...googleapi.CallOption) (*ListServ
// "type": "integer"
// },
// "parent": {
- // "description": "The namespace from which the services 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": "The parent from where the resources should be listed. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
// "location": "path",
// "pattern": "^namespaces/[^/]+$",
// "required": true,
// "type": "string"
// },
// "resourceVersion": {
- // "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -9107,16 +9143,19 @@ type NamespacesServicesReplaceServiceCall struct {
header_ http.Header
}
-// ReplaceService: Replace a service. Only the spec and metadata labels
+// ReplaceService: Replaces a service. Only the spec and metadata labels
// and annotations are modifiable. After the Update request, Cloud Run
// will work to make the 'status' match the requested 'spec'. May
// provide metadata.resourceVersion to enforce update from last read for
// optimistic concurrency control.
//
-// - name: The name of the service being replaced. For Cloud Run (fully
-// managed), replace {namespace} with the project ID or number. It
-// takes the form namespaces/{namespace}. For example:
-// namespaces/PROJECT_ID.
+// - name: The fully qualified name of the service to replace. It can be
+// any of the following forms: *
+// `namespaces/{project_id_or_number}/services/{service_name}` *
+// `projects/{project_id_or_number}/locations/{region}/services/{servic
+// e_name}` *
+// `projects/{project_id_or_number}/regions/{region}/services/{service_
+// name}`.
func (r *NamespacesServicesService) ReplaceService(name string, service *Service) *NamespacesServicesReplaceServiceCall {
c := &NamespacesServicesReplaceServiceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9223,7 +9262,7 @@ func (c *NamespacesServicesReplaceServiceCall) Do(opts ...googleapi.CallOption)
}
return ret, nil
// {
- // "description": "Replace a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
+ // "description": "Replaces a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
// "flatPath": "apis/serving.knative.dev/v1/namespaces/{namespacesId}/services/{servicesId}",
// "httpMethod": "PUT",
// "id": "run.namespaces.services.replaceService",
@@ -9237,7 +9276,7 @@ func (c *NamespacesServicesReplaceServiceCall) Do(opts ...googleapi.CallOption)
// "type": "string"
// },
// "name": {
- // "description": "The name of the service being replaced. 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": "The fully qualified name of the service to replace. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
// "location": "path",
// "pattern": "^namespaces/[^/]+/services/[^/]+$",
// "required": true,
@@ -9271,9 +9310,9 @@ type NamespacesTasksGetCall struct {
// Get: Get information about a task.
//
-// - name: The name of the task to retrieve. Replace {namespace} with
-// the project ID or number. It takes the form namespaces/{namespace}.
-// For example: namespaces/PROJECT_ID.
+// - name: The name of the task to retrieve. Replace {namespace} with
+// the project ID or number. It takes the form namespaces/{namespace}.
+// For example: namespaces/PROJECT_ID.
func (r *NamespacesTasksService) Get(name string) *NamespacesTasksGetCall {
c := &NamespacesTasksGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9419,9 +9458,9 @@ type NamespacesTasksListCall struct {
// List: List tasks.
//
-// - parent: The namespace from which the tasks should be listed.
-// Replace {namespace} with the project ID or number. It takes the
-// form namespaces/{namespace}. For example: namespaces/PROJECT_ID.
+// - parent: The namespace from which the tasks should be listed.
+// Replace {namespace} with the project ID or number. It takes the
+// form namespaces/{namespace}. For example: namespaces/PROJECT_ID.
func (r *NamespacesTasksService) List(parent string) *NamespacesTasksListCall {
c := &NamespacesTasksListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9435,17 +9474,15 @@ func (c *NamespacesTasksListCall) Continue(continue_ string) *NamespacesTasksLis
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported by Cloud Run.
func (c *NamespacesTasksListCall) FieldSelector(fieldSelector string) *NamespacesTasksListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported by Cloud Run.
func (c *NamespacesTasksListCall) IncludeUninitialized(includeUninitialized bool) *NamespacesTasksListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -9466,17 +9503,15 @@ func (c *NamespacesTasksListCall) Limit(limit int64) *NamespacesTasksListCall {
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported by Cloud Run.
func (c *NamespacesTasksListCall) ResourceVersion(resourceVersion string) *NamespacesTasksListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
-// by Cloud Run.
+// Watch sets the optional parameter "watch": Not supported by Cloud
+// Run.
func (c *NamespacesTasksListCall) Watch(watch bool) *NamespacesTasksListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
return c
@@ -9595,12 +9630,12 @@ func (c *NamespacesTasksListCall) Do(opts ...googleapi.CallOption) (*ListTasksRe
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Optional. Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Optional. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -9623,12 +9658,12 @@ func (c *NamespacesTasksListCall) Do(opts ...googleapi.CallOption) (*ListTasksRe
// "type": "string"
// },
// "resourceVersion": {
- // "description": "Optional. The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Optional. Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Optional. Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -9657,8 +9692,8 @@ type ProjectsAuthorizeddomainsListCall struct {
// List: List authorized domains.
//
-// - parent: Name of the parent Project resource. Example:
-// `projects/myproject`.
+// - parent: Name of the parent Project resource. Example:
+// `projects/myproject`.
func (r *ProjectsAuthorizeddomainsService) List(parent string) *ProjectsAuthorizeddomainsListCall {
c := &ProjectsAuthorizeddomainsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9851,8 +9886,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10059,8 +10094,8 @@ type ProjectsLocationsAuthorizeddomainsListCall struct {
// List: List authorized domains.
//
-// - parent: Name of the parent Project resource. Example:
-// `projects/myproject`.
+// - parent: Name of the parent Project resource. Example:
+// `projects/myproject`.
func (r *ProjectsLocationsAuthorizeddomainsService) List(parent string) *ProjectsLocationsAuthorizeddomainsListCall {
c := &ProjectsLocationsAuthorizeddomainsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10252,9 +10287,8 @@ type ProjectsLocationsConfigurationsGetCall struct {
// Get: Get information about a configuration.
//
-// - name: The name of the configuration to retrieve. For Cloud Run
-// (fully managed), replace {namespace_id} with the project ID or
-// number.
+// - name: The name of the configuration to retrieve. For Cloud Run,
+// replace {namespace_id} with the project ID or number.
func (r *ProjectsLocationsConfigurationsService) Get(name string) *ProjectsLocationsConfigurationsGetCall {
c := &ProjectsLocationsConfigurationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10369,7 +10403,7 @@ func (c *ProjectsLocationsConfigurationsGetCall) Do(opts ...googleapi.CallOption
// ],
// "parameters": {
// "name": {
- // "description": "The name of the configuration to retrieve. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ // "description": "The name of the configuration to retrieve. For Cloud Run, replace {namespace_id} with the project ID or number.",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+/configurations/[^/]+$",
// "required": true,
@@ -10400,9 +10434,9 @@ type ProjectsLocationsConfigurationsListCall struct {
// List: List configurations.
//
-// - parent: The namespace from which the configurations should be
-// listed. For Cloud Run (fully managed), replace {namespace_id} with
-// the project ID or number.
+// - parent: The namespace from which the configurations should be
+// listed. For Cloud Run, replace {namespace_id} with the project ID
+// or number.
func (r *ProjectsLocationsConfigurationsService) List(parent string) *ProjectsLocationsConfigurationsListCall {
c := &ProjectsLocationsConfigurationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10416,17 +10450,15 @@ func (c *ProjectsLocationsConfigurationsListCall) Continue(continue_ string) *Pr
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported by Cloud Run.
func (c *ProjectsLocationsConfigurationsListCall) FieldSelector(fieldSelector string) *ProjectsLocationsConfigurationsListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported by Cloud Run.
func (c *ProjectsLocationsConfigurationsListCall) IncludeUninitialized(includeUninitialized bool) *ProjectsLocationsConfigurationsListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -10440,24 +10472,22 @@ func (c *ProjectsLocationsConfigurationsListCall) LabelSelector(labelSelector st
return c
}
-// Limit sets the optional parameter "limit": The maximum number of
+// Limit sets the optional parameter "limit": The maximum number of the
// records that should be returned.
func (c *ProjectsLocationsConfigurationsListCall) Limit(limit int64) *ProjectsLocationsConfigurationsListCall {
c.urlParams_.Set("limit", fmt.Sprint(limit))
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported by Cloud Run.
func (c *ProjectsLocationsConfigurationsListCall) ResourceVersion(resourceVersion string) *ProjectsLocationsConfigurationsListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
-// by Cloud Run.
+// Watch sets the optional parameter "watch": Not supported by Cloud
+// Run.
func (c *ProjectsLocationsConfigurationsListCall) Watch(watch bool) *ProjectsLocationsConfigurationsListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
return c
@@ -10576,12 +10606,12 @@ func (c *ProjectsLocationsConfigurationsListCall) Do(opts ...googleapi.CallOptio
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -10591,25 +10621,25 @@ func (c *ProjectsLocationsConfigurationsListCall) Do(opts ...googleapi.CallOptio
// "type": "string"
// },
// "limit": {
- // "description": "Optional. The maximum number of records that should be returned.",
+ // "description": "Optional. The maximum number of the records that should be returned.",
// "format": "int32",
// "location": "query",
// "type": "integer"
// },
// "parent": {
- // "description": "The namespace from which the configurations should be listed. For Cloud Run (fully managed), replace {namespace_id} with the project ID or number.",
+ // "description": "The namespace from which the configurations should be listed. For Cloud Run, replace {namespace_id} with the project ID or number.",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+$",
// "required": true,
// "type": "string"
// },
// "resourceVersion": {
- // "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Not supported by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -10638,10 +10668,10 @@ type ProjectsLocationsDomainmappingsCreateCall struct {
// Create: Create a new domain mapping.
//
-// - parent: 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.
+// - parent: 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.
func (r *ProjectsLocationsDomainmappingsService) Create(parent string, domainmapping *DomainMapping) *ProjectsLocationsDomainmappingsCreateCall {
c := &ProjectsLocationsDomainmappingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10795,10 +10825,10 @@ type ProjectsLocationsDomainmappingsDeleteCall struct {
// Delete: Delete a domain mapping.
//
-// - name: 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.
+// - name: 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.
func (r *ProjectsLocationsDomainmappingsService) Delete(name string) *ProjectsLocationsDomainmappingsDeleteCall {
c := &ProjectsLocationsDomainmappingsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10830,8 +10860,8 @@ func (c *ProjectsLocationsDomainmappingsDeleteCall) Kind(kind string) *ProjectsL
// 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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
-// for more information.
+// kubernetes.io/docs/concepts/architecture/garbage-collection/ for more
+// information.
func (c *ProjectsLocationsDomainmappingsDeleteCall) PropagationPolicy(propagationPolicy string) *ProjectsLocationsDomainmappingsDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
return c
@@ -10954,7 +10984,7 @@ func (c *ProjectsLocationsDomainmappingsDeleteCall) Do(opts ...googleapi.CallOpt
// "type": "string"
// },
// "propagationPolicy": {
- // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/architecture/garbage-collection/ for more information.",
// "location": "query",
// "type": "string"
// }
@@ -10983,10 +11013,10 @@ type ProjectsLocationsDomainmappingsGetCall struct {
// Get: Get information about a domain mapping.
//
-// - name: 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.
+// - name: 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.
func (r *ProjectsLocationsDomainmappingsService) Get(name string) *ProjectsLocationsDomainmappingsGetCall {
c := &ProjectsLocationsDomainmappingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11130,12 +11160,12 @@ type ProjectsLocationsDomainmappingsListCall struct {
header_ http.Header
}
-// List: List domain mappings.
+// List: List all domain mappings.
//
-// - parent: 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.
+// - parent: 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.
func (r *ProjectsLocationsDomainmappingsService) List(parent string) *ProjectsLocationsDomainmappingsListCall {
c := &ProjectsLocationsDomainmappingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11295,7 +11325,7 @@ func (c *ProjectsLocationsDomainmappingsListCall) Do(opts ...googleapi.CallOptio
}
return ret, nil
// {
- // "description": "List domain mappings.",
+ // "description": "List all domain mappings.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/domainmappings",
// "httpMethod": "GET",
// "id": "run.projects.locations.domainmappings.list",
@@ -11373,10 +11403,10 @@ type ProjectsLocationsJobsGetIamPolicyCall struct {
// for the given job. This result does not include any inherited
// policies.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsJobsService) GetIamPolicy(resource string) *ProjectsLocationsJobsGetIamPolicyCall {
c := &ProjectsLocationsJobsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -11547,10 +11577,10 @@ type ProjectsLocationsJobsSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Access control policy for the specified
// job. Overwrites any existing policy.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsJobsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsJobsSetIamPolicyCall {
c := &ProjectsLocationsJobsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -11694,10 +11724,10 @@ type ProjectsLocationsJobsTestIamPermissionsCall struct {
// specified job. There are no permissions required for making this API
// call.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsJobsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsJobsTestIamPermissionsCall {
c := &ProjectsLocationsJobsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -11838,10 +11868,10 @@ type ProjectsLocationsRevisionsDeleteCall struct {
// Delete: Delete a revision.
//
-// - name: The name of the revision 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.
+// - name: The name of the revision 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.
func (r *ProjectsLocationsRevisionsService) Delete(name string) *ProjectsLocationsRevisionsDeleteCall {
c := &ProjectsLocationsRevisionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11873,7 +11903,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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
+// https://kubernetes.io/docs/concepts/architecture/garbage-collection/
// for more information.
func (c *ProjectsLocationsRevisionsDeleteCall) PropagationPolicy(propagationPolicy string) *ProjectsLocationsRevisionsDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
@@ -11997,7 +12027,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 kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ // "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.",
// "location": "query",
// "type": "string"
// }
@@ -12026,10 +12056,10 @@ type ProjectsLocationsRevisionsGetCall struct {
// Get: Get information about a revision.
//
-// - name: The name of the revision 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.
+// - name: The name of the revision 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.
func (r *ProjectsLocationsRevisionsService) Get(name string) *ProjectsLocationsRevisionsGetCall {
c := &ProjectsLocationsRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12175,10 +12205,10 @@ type ProjectsLocationsRevisionsListCall struct {
// List: List revisions.
//
-// - parent: The namespace from which the revisions 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.
+// - parent: The namespace from which the revisions 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.
func (r *ProjectsLocationsRevisionsService) List(parent string) *ProjectsLocationsRevisionsListCall {
c := &ProjectsLocationsRevisionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12414,10 +12444,10 @@ type ProjectsLocationsRoutesGetCall struct {
// Get: Get information about a route.
//
-// - name: The name of the route 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.
+// - name: The name of the route 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.
func (r *ProjectsLocationsRoutesService) Get(name string) *ProjectsLocationsRoutesGetCall {
c := &ProjectsLocationsRoutesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12563,10 +12593,10 @@ type ProjectsLocationsRoutesListCall struct {
// List: List routes.
//
-// - parent: The namespace from which the routes 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.
+// - parent: The namespace from which the routes 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.
func (r *ProjectsLocationsRoutesService) List(parent string) *ProjectsLocationsRoutesListCall {
c := &ProjectsLocationsRoutesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12800,12 +12830,14 @@ type ProjectsLocationsServicesCreateCall struct {
header_ http.Header
}
-// Create: Create a service.
+// Create: Creates a new Service. Service creation will trigger a new
+// deployment. Use GetService, and check service.status to determine if
+// the Service is ready.
//
-// - parent: The namespace in which the service 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.
+// - parent: The resource's parent. In Cloud Run, it may be one of the
+// following: * `namespaces/{project_id_or_number}` *
+// `projects/{project_id_or_number}/locations/{region}` *
+// `projects/{project_id_or_number}/regions/{region}`.
func (r *ProjectsLocationsServicesService) Create(parent string, service *Service) *ProjectsLocationsServicesCreateCall {
c := &ProjectsLocationsServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12912,7 +12944,7 @@ func (c *ProjectsLocationsServicesCreateCall) Do(opts ...googleapi.CallOption) (
}
return ret, nil
// {
- // "description": "Create a service.",
+ // "description": "Creates a new Service. Service creation will trigger a new deployment. Use GetService, and check service.status to determine if the Service is ready.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services",
// "httpMethod": "POST",
// "id": "run.projects.locations.services.create",
@@ -12926,7 +12958,7 @@ func (c *ProjectsLocationsServicesCreateCall) Do(opts ...googleapi.CallOption) (
// "type": "string"
// },
// "parent": {
- // "description": "The namespace in which the service 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": "The resource's parent. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+$",
// "required": true,
@@ -12957,22 +12989,24 @@ type ProjectsLocationsServicesDeleteCall struct {
header_ http.Header
}
-// Delete: Delete a service. This will cause the Service to stop serving
-// traffic and will delete the child entities like Routes,
-// Configurations and Revisions.
+// Delete: Deletes the provided service. This will cause the Service to
+// stop serving traffic and will delete all associated Revisions.
//
-// - name: The name of the service 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.
+// - name: The fully qualified name of the service to delete. It can be
+// any of the following forms: *
+// `namespaces/{project_id_or_number}/services/{service_name}` *
+// `projects/{project_id_or_number}/locations/{region}/services/{servic
+// e_name}` *
+// `projects/{project_id_or_number}/regions/{region}/services/{service_
+// name}`.
func (r *ProjectsLocationsServicesService) Delete(name string) *ProjectsLocationsServicesDeleteCall {
c := &ProjectsLocationsServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
return c
}
-// ApiVersion sets the optional parameter "apiVersion": Cloud Run
-// currently ignores this parameter.
+// ApiVersion sets the optional parameter "apiVersion": Not supported,
+// and ignored by Cloud Run.
func (c *ProjectsLocationsServicesDeleteCall) ApiVersion(apiVersion string) *ProjectsLocationsServicesDeleteCall {
c.urlParams_.Set("apiVersion", apiVersion)
return c
@@ -12986,18 +13020,15 @@ func (c *ProjectsLocationsServicesDeleteCall) DryRun(dryRun string) *ProjectsLoc
return c
}
-// Kind sets the optional parameter "kind": Cloud Run currently ignores
-// this parameter.
+// Kind sets the optional parameter "kind": Not supported, and ignored
+// by Cloud Run.
func (c *ProjectsLocationsServicesDeleteCall) Kind(kind string) *ProjectsLocationsServicesDeleteCall {
c.urlParams_.Set("kind", kind)
return c
}
// 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
-// kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/
-// for more information.
+// Not supported, and ignored by Cloud Run.
func (c *ProjectsLocationsServicesDeleteCall) PropagationPolicy(propagationPolicy string) *ProjectsLocationsServicesDeleteCall {
c.urlParams_.Set("propagationPolicy", propagationPolicy)
return c
@@ -13089,7 +13120,7 @@ func (c *ProjectsLocationsServicesDeleteCall) Do(opts ...googleapi.CallOption) (
}
return ret, nil
// {
- // "description": "Delete a service. This will cause the Service to stop serving traffic and will delete the child entities like Routes, Configurations and Revisions.",
+ // "description": "Deletes the provided service. This will cause the Service to stop serving traffic and will delete all associated Revisions.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}",
// "httpMethod": "DELETE",
// "id": "run.projects.locations.services.delete",
@@ -13098,7 +13129,7 @@ func (c *ProjectsLocationsServicesDeleteCall) Do(opts ...googleapi.CallOption) (
// ],
// "parameters": {
// "apiVersion": {
- // "description": "Cloud Run currently ignores this parameter.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
@@ -13108,19 +13139,19 @@ func (c *ProjectsLocationsServicesDeleteCall) Do(opts ...googleapi.CallOption) (
// "type": "string"
// },
// "kind": {
- // "description": "Cloud Run currently ignores this parameter.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "name": {
- // "description": "The name of the service 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": "The fully qualified name of the service to delete. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$",
// "required": true,
// "type": "string"
// },
// "propagationPolicy": {
- // "description": "Specifies the propagation policy of delete. Cloud Run currently ignores this setting, and deletes in the background. Please see kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for more information.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// }
@@ -13147,12 +13178,15 @@ type ProjectsLocationsServicesGetCall struct {
header_ http.Header
}
-// Get: Get information about a service.
+// Get: Gets information about a service.
//
-// - name: The name of the service 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.
+// - name: The fully qualified name of the service to retrieve. It can
+// be any of the following forms: *
+// `namespaces/{project_id_or_number}/services/{service_name}` *
+// `projects/{project_id_or_number}/locations/{region}/services/{servic
+// e_name}` *
+// `projects/{project_id_or_number}/regions/{region}/services/{service_
+// name}`.
func (r *ProjectsLocationsServicesService) Get(name string) *ProjectsLocationsServicesGetCall {
c := &ProjectsLocationsServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13258,7 +13292,7 @@ func (c *ProjectsLocationsServicesGetCall) Do(opts ...googleapi.CallOption) (*Se
}
return ret, nil
// {
- // "description": "Get information about a service.",
+ // "description": "Gets information about a service.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}",
// "httpMethod": "GET",
// "id": "run.projects.locations.services.get",
@@ -13267,7 +13301,7 @@ func (c *ProjectsLocationsServicesGetCall) Do(opts ...googleapi.CallOption) (*Se
// ],
// "parameters": {
// "name": {
- // "description": "The name of the service 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": "The fully qualified name of the service to retrieve. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$",
// "required": true,
@@ -13296,14 +13330,14 @@ type ProjectsLocationsServicesGetIamPolicyCall struct {
header_ http.Header
}
-// GetIamPolicy: Get the IAM Access Control policy currently in effect
+// GetIamPolicy: Gets the IAM Access Control policy currently in effect
// for the given Cloud Run service. This result does not include any
// inherited policies.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsServicesService) GetIamPolicy(resource string) *ProjectsLocationsServicesGetIamPolicyCall {
c := &ProjectsLocationsServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -13427,7 +13461,7 @@ func (c *ProjectsLocationsServicesGetIamPolicyCall) Do(opts ...googleapi.CallOpt
}
return ret, nil
// {
- // "description": "Get the IAM Access Control policy currently in effect for the given Cloud Run service. This result does not include any inherited policies.",
+ // "description": "Gets the IAM Access Control policy currently in effect for the given Cloud Run service. This result does not include any inherited policies.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}:getIamPolicy",
// "httpMethod": "GET",
// "id": "run.projects.locations.services.getIamPolicy",
@@ -13471,12 +13505,13 @@ type ProjectsLocationsServicesListCall struct {
header_ http.Header
}
-// List: List services.
+// List: Lists services for the given project and region.
//
-// - parent: The namespace from which the services 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.
+// - parent: The parent from where the resources should be listed. In
+// Cloud Run, it may be one of the following: *
+// `namespaces/{project_id_or_number}` *
+// `projects/{project_id_or_number}/locations/{region}` *
+// `projects/{project_id_or_number}/regions/{region}`.
func (r *ProjectsLocationsServicesService) List(parent string) *ProjectsLocationsServicesListCall {
c := &ProjectsLocationsServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13490,17 +13525,15 @@ func (c *ProjectsLocationsServicesListCall) Continue(continue_ string) *Projects
return c
}
-// FieldSelector sets the optional parameter "fieldSelector": Allows to
-// filter resources based on a specific value for a field name. Send
-// this in a query string format. i.e. 'metadata.name%3Dlorem'. Not
-// currently used by Cloud Run.
+// FieldSelector sets the optional parameter "fieldSelector": Not
+// supported, and ignored by Cloud Run.
func (c *ProjectsLocationsServicesListCall) FieldSelector(fieldSelector string) *ProjectsLocationsServicesListCall {
c.urlParams_.Set("fieldSelector", fieldSelector)
return c
}
// IncludeUninitialized sets the optional parameter
-// "includeUninitialized": Not currently used by Cloud Run.
+// "includeUninitialized": Not supported, and ignored by Cloud Run.
func (c *ProjectsLocationsServicesListCall) IncludeUninitialized(includeUninitialized bool) *ProjectsLocationsServicesListCall {
c.urlParams_.Set("includeUninitialized", fmt.Sprint(includeUninitialized))
return c
@@ -13521,16 +13554,14 @@ func (c *ProjectsLocationsServicesListCall) Limit(limit int64) *ProjectsLocation
return c
}
-// ResourceVersion sets the optional parameter "resourceVersion": The
-// baseline resource version from which the list or watch operation
-// should start. Not currently used by Cloud Run.
+// ResourceVersion sets the optional parameter "resourceVersion": Not
+// supported, and ignored by Cloud Run.
func (c *ProjectsLocationsServicesListCall) ResourceVersion(resourceVersion string) *ProjectsLocationsServicesListCall {
c.urlParams_.Set("resourceVersion", resourceVersion)
return c
}
-// Watch sets the optional parameter "watch": Flag that indicates that
-// the client expects to watch this resource as well. Not currently used
+// Watch sets the optional parameter "watch": Not supported, and ignored
// by Cloud Run.
func (c *ProjectsLocationsServicesListCall) Watch(watch bool) *ProjectsLocationsServicesListCall {
c.urlParams_.Set("watch", fmt.Sprint(watch))
@@ -13636,7 +13667,7 @@ func (c *ProjectsLocationsServicesListCall) Do(opts ...googleapi.CallOption) (*L
}
return ret, nil
// {
- // "description": "List services.",
+ // "description": "Lists services for the given project and region.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services",
// "httpMethod": "GET",
// "id": "run.projects.locations.services.list",
@@ -13650,12 +13681,12 @@ func (c *ProjectsLocationsServicesListCall) Do(opts ...googleapi.CallOption) (*L
// "type": "string"
// },
// "fieldSelector": {
- // "description": "Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "includeUninitialized": {
- // "description": "Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "boolean"
// },
@@ -13671,19 +13702,19 @@ func (c *ProjectsLocationsServicesListCall) Do(opts ...googleapi.CallOption) (*L
// "type": "integer"
// },
// "parent": {
- // "description": "The namespace from which the services 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": "The parent from where the resources should be listed. In Cloud Run, it may be one of the following: * `namespaces/{project_id_or_number}` * `projects/{project_id_or_number}/locations/{region}` * `projects/{project_id_or_number}/regions/{region}`",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+$",
// "required": true,
// "type": "string"
// },
// "resourceVersion": {
- // "description": "The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "string"
// },
// "watch": {
- // "description": "Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.",
+ // "description": "Not supported, and ignored by Cloud Run.",
// "location": "query",
// "type": "boolean"
// }
@@ -13710,16 +13741,19 @@ type ProjectsLocationsServicesReplaceServiceCall struct {
header_ http.Header
}
-// ReplaceService: Replace a service. Only the spec and metadata labels
+// ReplaceService: Replaces a service. Only the spec and metadata labels
// and annotations are modifiable. After the Update request, Cloud Run
// will work to make the 'status' match the requested 'spec'. May
// provide metadata.resourceVersion to enforce update from last read for
// optimistic concurrency control.
//
-// - name: The name of the service being replaced. For Cloud Run (fully
-// managed), replace {namespace} with the project ID or number. It
-// takes the form namespaces/{namespace}. For example:
-// namespaces/PROJECT_ID.
+// - name: The fully qualified name of the service to replace. It can be
+// any of the following forms: *
+// `namespaces/{project_id_or_number}/services/{service_name}` *
+// `projects/{project_id_or_number}/locations/{region}/services/{servic
+// e_name}` *
+// `projects/{project_id_or_number}/regions/{region}/services/{service_
+// name}`.
func (r *ProjectsLocationsServicesService) ReplaceService(name string, service *Service) *ProjectsLocationsServicesReplaceServiceCall {
c := &ProjectsLocationsServicesReplaceServiceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13826,7 +13860,7 @@ func (c *ProjectsLocationsServicesReplaceServiceCall) Do(opts ...googleapi.CallO
}
return ret, nil
// {
- // "description": "Replace a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
+ // "description": "Replaces a service. Only the spec and metadata labels and annotations are modifiable. After the Update request, Cloud Run will work to make the 'status' match the requested 'spec'. May provide metadata.resourceVersion to enforce update from last read for optimistic concurrency control.",
// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/services/{servicesId}",
// "httpMethod": "PUT",
// "id": "run.projects.locations.services.replaceService",
@@ -13840,7 +13874,7 @@ func (c *ProjectsLocationsServicesReplaceServiceCall) Do(opts ...googleapi.CallO
// "type": "string"
// },
// "name": {
- // "description": "The name of the service being replaced. 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": "The fully qualified name of the service to replace. It can be any of the following forms: * `namespaces/{project_id_or_number}/services/{service_name}` * `projects/{project_id_or_number}/locations/{region}/services/{service_name}` * `projects/{project_id_or_number}/regions/{region}/services/{service_name}`",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+/services/[^/]+$",
// "required": true,
@@ -13875,10 +13909,10 @@ type ProjectsLocationsServicesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Access control policy for the specified
// Service. Overwrites any existing policy.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsServicesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsServicesSetIamPolicyCall {
c := &ProjectsLocationsServicesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -14022,10 +14056,10 @@ type ProjectsLocationsServicesTestIamPermissionsCall struct {
// specified Project. There are no permissions required for making this
// API call.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsServicesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsServicesTestIamPermissionsCall {
c := &ProjectsLocationsServicesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
diff --git a/run/v1alpha1/run-gen.go b/run/v1alpha1/run-gen.go
index ea57c1bead1..32cd79e05c9 100644
--- a/run/v1alpha1/run-gen.go
+++ b/run/v1alpha1/run-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/run/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/run/v1alpha1"
-// ...
-// ctx := context.Background()
-// runService, err := run.NewService(ctx)
+// import "google.golang.org/api/run/v1alpha1"
+// ...
+// ctx := context.Background()
+// runService, err := run.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
+// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package run // import "google.golang.org/api/run/v1alpha1"
@@ -2068,8 +2068,8 @@ type NamespacesJobsCreateCall struct {
// Create: Create a job.
//
-// - parent: The namespace in which the job should be created. Replace
-// {namespace_id} with the project ID or number.
+// - parent: The namespace in which the job should be created. Replace
+// {namespace_id} with the project ID or number.
func (r *NamespacesJobsService) Create(parent string, job *Job) *NamespacesJobsCreateCall {
c := &NamespacesJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2210,8 +2210,8 @@ type NamespacesJobsDeleteCall struct {
// Delete: Delete a job.
//
-// - name: The name of the job to delete. For Cloud Run (fully managed),
-// replace {namespace_id} with the project ID or number.
+// - name: The name of the job to delete. For Cloud Run (fully managed),
+// replace {namespace_id} with the project ID or number.
func (r *NamespacesJobsService) Delete(name string) *NamespacesJobsDeleteCall {
c := &NamespacesJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2383,8 +2383,8 @@ type NamespacesJobsGetCall struct {
// Get: Get information about a job.
//
-// - name: The name of the job to retrieve. For Cloud Run (fully
-// managed), replace {namespace_id} with the project ID or number.
+// - name: The name of the job to retrieve. For Cloud Run (fully
+// managed), replace {namespace_id} with the project ID or number.
func (r *NamespacesJobsService) Get(name string) *NamespacesJobsGetCall {
c := &NamespacesJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2530,8 +2530,8 @@ type NamespacesJobsListCall struct {
// List: List jobs.
//
-// - parent: The namespace from which the jobs should be listed. Replace
-// {namespace_id} with the project ID or number.
+// - parent: The namespace from which the jobs should be listed. Replace
+// {namespace_id} with the project ID or number.
func (r *NamespacesJobsService) List(parent string) *NamespacesJobsListCall {
c := &NamespacesJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/run/v1beta1/run-gen.go b/run/v1beta1/run-gen.go
index 87f5388f448..28401abcaec 100644
--- a/run/v1beta1/run-gen.go
+++ b/run/v1beta1/run-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/run/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/run/v1beta1"
-// ...
-// ctx := context.Background()
-// runService, err := run.NewService(ctx)
+// import "google.golang.org/api/run/v1beta1"
+// ...
+// ctx := context.Background()
+// runService, err := run.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
+// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package run // import "google.golang.org/api/run/v1beta1"
@@ -1410,8 +1410,8 @@ type NamespacesCustomresourcedefinitionsGetCall struct {
// Get: Rpc to get information about a CustomResourceDefinition.
//
-// - name: The name of the CustomResourceDefinition being retrieved. If
-// needed, replace {namespace_id} with the project ID.
+// - name: The name of the CustomResourceDefinition being retrieved. If
+// needed, replace {namespace_id} with the project ID.
func (r *NamespacesCustomresourcedefinitionsService) Get(name string) *NamespacesCustomresourcedefinitionsGetCall {
c := &NamespacesCustomresourcedefinitionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1557,8 +1557,8 @@ type ProjectsLocationsCustomresourcedefinitionsGetCall struct {
// Get: Rpc to get information about a CustomResourceDefinition.
//
-// - name: The name of the CustomResourceDefinition being retrieved. If
-// needed, replace {namespace_id} with the project ID.
+// - name: The name of the CustomResourceDefinition being retrieved. If
+// needed, replace {namespace_id} with the project ID.
func (r *ProjectsLocationsCustomresourcedefinitionsService) Get(name string) *ProjectsLocationsCustomresourcedefinitionsGetCall {
c := &ProjectsLocationsCustomresourcedefinitionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1704,8 +1704,8 @@ type ProjectsLocationsCustomresourcedefinitionsListCall struct {
// List: Rpc to list custom resource definitions.
//
-// - parent: The project ID or project number from which the storages
-// should be listed.
+// - parent: The project ID or project number from which the storages
+// should be listed.
func (r *ProjectsLocationsCustomresourcedefinitionsService) List(parent string) *ProjectsLocationsCustomresourcedefinitionsListCall {
c := &ProjectsLocationsCustomresourcedefinitionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/run/v2/run-api.json b/run/v2/run-api.json
index fb137c514e4..9713929d91e 100644
--- a/run/v2/run-api.json
+++ b/run/v2/run-api.json
@@ -696,7 +696,7 @@
],
"parameters": {
"parent": {
- "description": "Required. The location and project in which this service should be created. Format: projects/{projectnumber}/locations/{location}",
+ "description": "Required. The location and project in which this service should be created. Format: projects/{projectnumber}/locations/{location} Only lowercase, digits, and hyphens; must begin with letter, and may not end with hyphen; must contain fewer than 50 characters.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
@@ -1064,7 +1064,7 @@
}
}
},
- "revision": "20220710",
+ "revision": "20220807",
"rootUrl": "https://run.googleapis.com/",
"schemas": {
"GoogleCloudRunV2BinaryAuthorization": {
@@ -2809,7 +2809,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/run/v2/run-gen.go b/run/v2/run-gen.go
index 85eb0a2c3bf..49d3557f260 100644
--- a/run/v2/run-gen.go
+++ b/run/v2/run-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/run/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/run/v2"
-// ...
-// ctx := context.Background()
-// runService, err := run.NewService(ctx)
+// import "google.golang.org/api/run/v2"
+// ...
+// ctx := context.Background()
+// runService, err := run.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
+// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package run // import "google.golang.org/api/run/v2"
@@ -2652,16 +2652,20 @@ type GoogleIamV1Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -3146,8 +3150,8 @@ type ProjectsLocationsJobsCreateCall struct {
// Create: Create a Job.
//
-// - parent: The location and project in which this Job should be
-// created. Format: projects/{projectnumber}/locations/{location}.
+// - parent: The location and project in which this Job should be
+// created. Format: projects/{projectnumber}/locations/{location}.
func (r *ProjectsLocationsJobsService) Create(parent string, googlecloudrunv2job *GoogleCloudRunV2Job) *ProjectsLocationsJobsCreateCall {
c := &ProjectsLocationsJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3314,8 +3318,8 @@ type ProjectsLocationsJobsDeleteCall struct {
// Delete: Deletes a Job.
//
-// - name: The full name of the Job. Format:
-// projects/{projectnumber}/locations/{location}/jobs/{job}.
+// - name: The full name of the Job. Format:
+// projects/{projectnumber}/locations/{location}/jobs/{job}.
func (r *ProjectsLocationsJobsService) Delete(name string) *ProjectsLocationsJobsDeleteCall {
c := &ProjectsLocationsJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3489,8 +3493,8 @@ type ProjectsLocationsJobsGetCall struct {
// Get: Gets information about a Job.
//
-// - name: The full name of the Job. Format:
-// projects/{projectnumber}/locations/{location}/jobs/{job}.
+// - name: The full name of the Job. Format:
+// projects/{projectnumber}/locations/{location}/jobs/{job}.
func (r *ProjectsLocationsJobsService) Get(name string) *ProjectsLocationsJobsGetCall {
c := &ProjectsLocationsJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3638,10 +3642,10 @@ type ProjectsLocationsJobsGetIamPolicyCall struct {
// for the given Job. This result does not include any inherited
// policies.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsJobsService) GetIamPolicy(resource string) *ProjectsLocationsJobsGetIamPolicyCall {
c := &ProjectsLocationsJobsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3811,8 +3815,8 @@ type ProjectsLocationsJobsListCall struct {
// List: List Jobs.
//
-// - parent: The location and project to list resources on. Format:
-// projects/{projectnumber}/locations/{location}.
+// - parent: The location and project to list resources on. Format:
+// projects/{projectnumber}/locations/{location}.
func (r *ProjectsLocationsJobsService) List(parent string) *ProjectsLocationsJobsListCall {
c := &ProjectsLocationsJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4017,8 +4021,8 @@ type ProjectsLocationsJobsPatchCall struct {
// Patch: Updates a Job.
//
-// - name: The fully qualified name of this Job. Format:
-// projects/{project}/locations/{location}/jobs/{job}.
+// - name: The fully qualified name of this Job. Format:
+// projects/{project}/locations/{location}/jobs/{job}.
func (r *ProjectsLocationsJobsService) Patch(name string, googlecloudrunv2job *GoogleCloudRunV2Job) *ProjectsLocationsJobsPatchCall {
c := &ProjectsLocationsJobsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4187,8 +4191,8 @@ type ProjectsLocationsJobsRunCall struct {
// Run: Triggers creation of a new Execution of this Job.
//
-// - name: The full name of the Job. Format:
-// projects/{projectnumber}/locations/{location}/jobs/{job}.
+// - name: The full name of the Job. Format:
+// projects/{projectnumber}/locations/{location}/jobs/{job}.
func (r *ProjectsLocationsJobsService) Run(name string, googlecloudrunv2runjobrequest *GoogleCloudRunV2RunJobRequest) *ProjectsLocationsJobsRunCall {
c := &ProjectsLocationsJobsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4331,10 +4335,10 @@ type ProjectsLocationsJobsSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Access control policy for the specified
// Job. Overwrites any existing policy.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsJobsService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsJobsSetIamPolicyCall {
c := &ProjectsLocationsJobsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4478,10 +4482,10 @@ type ProjectsLocationsJobsTestIamPermissionsCall struct {
// specified Project. There are no permissions required for making this
// API call.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsJobsService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsJobsTestIamPermissionsCall {
c := &ProjectsLocationsJobsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4623,9 +4627,9 @@ type ProjectsLocationsJobsExecutionsDeleteCall struct {
// Delete: Delete an Execution.
//
-// - name: The name of the Execution to delete. Format:
-// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
-// tion}.
+// - name: The name of the Execution to delete. Format:
+// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
+// tion}.
func (r *ProjectsLocationsJobsExecutionsService) Delete(name string) *ProjectsLocationsJobsExecutionsDeleteCall {
c := &ProjectsLocationsJobsExecutionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4784,9 +4788,9 @@ type ProjectsLocationsJobsExecutionsGetCall struct {
// Get: Gets information about a Execution.
//
-// - name: The full name of the Execution. Format:
-// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
-// tion}.
+// - name: The full name of the Execution. Format:
+// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
+// tion}.
func (r *ProjectsLocationsJobsExecutionsService) Get(name string) *ProjectsLocationsJobsExecutionsGetCall {
c := &ProjectsLocationsJobsExecutionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4932,9 +4936,9 @@ type ProjectsLocationsJobsExecutionsListCall struct {
// List: List Executions from a Job.
//
-// - parent: The Execution from which the Executions should be listed.
-// To list all Executions across Jobs, use "-" instead of Job name.
-// Format: projects/{project}/locations/{location}/jobs/{job}.
+// - parent: The Execution from which the Executions should be listed.
+// To list all Executions across Jobs, use "-" instead of Job name.
+// Format: projects/{project}/locations/{location}/jobs/{job}.
func (r *ProjectsLocationsJobsExecutionsService) List(parent string) *ProjectsLocationsJobsExecutionsListCall {
c := &ProjectsLocationsJobsExecutionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5140,9 +5144,9 @@ type ProjectsLocationsJobsExecutionsTasksGetCall struct {
// Get: Gets information about a Task.
//
-// - name: The full name of the Task. Format:
-// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
-// tion}/tasks/{task}.
+// - name: The full name of the Task. Format:
+// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
+// tion}/tasks/{task}.
func (r *ProjectsLocationsJobsExecutionsTasksService) Get(name string) *ProjectsLocationsJobsExecutionsTasksGetCall {
c := &ProjectsLocationsJobsExecutionsTasksGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5288,12 +5292,12 @@ type ProjectsLocationsJobsExecutionsTasksListCall struct {
// List: List Tasks from an Execution of a Job.
//
-// - parent: The Execution from which the Tasks should be listed. To
-// list all Tasks across Executions of a Job, use "-" instead of
-// Execution name. To list all Tasks across Jobs, use "-" instead of
-// Job name. Format:
-// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
-// tion}.
+// - parent: The Execution from which the Tasks should be listed. To
+// list all Tasks across Executions of a Job, use "-" instead of
+// Execution name. To list all Tasks across Jobs, use "-" instead of
+// Job name. Format:
+// projects/{project}/locations/{location}/jobs/{job}/executions/{execu
+// tion}.
func (r *ProjectsLocationsJobsExecutionsTasksService) List(parent string) *ProjectsLocationsJobsExecutionsTasksListCall {
c := &ProjectsLocationsJobsExecutionsTasksListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6002,8 +6006,10 @@ type ProjectsLocationsServicesCreateCall struct {
// Create: Creates a new Service in a given project and location.
//
-// - parent: The location and project in which this service should be
-// created. Format: projects/{projectnumber}/locations/{location}.
+// - parent: The location and project in which this service should be
+// created. Format: projects/{projectnumber}/locations/{location} Only
+// lowercase, digits, and hyphens; must begin with letter, and may not
+// end with hyphen; must contain fewer than 50 characters.
func (r *ProjectsLocationsServicesService) Create(parent string, googlecloudrunv2service *GoogleCloudRunV2Service) *ProjectsLocationsServicesCreateCall {
c := &ProjectsLocationsServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6127,7 +6133,7 @@ func (c *ProjectsLocationsServicesCreateCall) Do(opts ...googleapi.CallOption) (
// ],
// "parameters": {
// "parent": {
- // "description": "Required. The location and project in which this service should be created. Format: projects/{projectnumber}/locations/{location}",
+ // "description": "Required. The location and project in which this service should be created. Format: projects/{projectnumber}/locations/{location} Only lowercase, digits, and hyphens; must begin with letter, and may not end with hyphen; must contain fewer than 50 characters.",
// "location": "path",
// "pattern": "^projects/[^/]+/locations/[^/]+$",
// "required": true,
@@ -6171,8 +6177,8 @@ type ProjectsLocationsServicesDeleteCall struct {
// Delete: Deletes a Service. This will cause the Service to stop
// serving traffic and will delete all revisions.
//
-// - name: The full name of the Service. Format:
-// projects/{projectnumber}/locations/{location}/services/{service}.
+// - name: The full name of the Service. Format:
+// projects/{projectnumber}/locations/{location}/services/{service}.
func (r *ProjectsLocationsServicesService) Delete(name string) *ProjectsLocationsServicesDeleteCall {
c := &ProjectsLocationsServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6331,8 +6337,8 @@ type ProjectsLocationsServicesGetCall struct {
// Get: Gets information about a Service.
//
-// - name: The full name of the Service. Format:
-// projects/{projectnumber}/locations/{location}/services/{service}.
+// - name: The full name of the Service. Format:
+// projects/{projectnumber}/locations/{location}/services/{service}.
func (r *ProjectsLocationsServicesService) Get(name string) *ProjectsLocationsServicesGetCall {
c := &ProjectsLocationsServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6480,10 +6486,10 @@ type ProjectsLocationsServicesGetIamPolicyCall struct {
// for the given Cloud Run Service. This result does not include any
// inherited policies.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsServicesService) GetIamPolicy(resource string) *ProjectsLocationsServicesGetIamPolicyCall {
c := &ProjectsLocationsServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6653,9 +6659,9 @@ type ProjectsLocationsServicesListCall struct {
// List: List Services.
//
-// - parent: The location and project to list resources on. Location
-// must be a valid GCP region, and may not be the "-" wildcard.
-// Format: projects/{projectnumber}/locations/{location}.
+// - parent: The location and project to list resources on. Location
+// must be a valid GCP region, and may not be the "-" wildcard.
+// Format: projects/{projectnumber}/locations/{location}.
func (r *ProjectsLocationsServicesService) List(parent string) *ProjectsLocationsServicesListCall {
c := &ProjectsLocationsServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6861,11 +6867,11 @@ type ProjectsLocationsServicesPatchCall struct {
// Patch: Updates a Service.
//
-// - name: The fully qualified name of this Service. In
-// CreateServiceRequest, this field is ignored, and instead composed
-// from CreateServiceRequest.parent and
-// CreateServiceRequest.service_id. Format:
-// projects/{project}/locations/{location}/services/{service_id}.
+// - name: The fully qualified name of this Service. In
+// CreateServiceRequest, this field is ignored, and instead composed
+// from CreateServiceRequest.parent and
+// CreateServiceRequest.service_id. Format:
+// projects/{project}/locations/{location}/services/{service_id}.
func (r *ProjectsLocationsServicesService) Patch(name string, googlecloudrunv2service *GoogleCloudRunV2Service) *ProjectsLocationsServicesPatchCall {
c := &ProjectsLocationsServicesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7035,10 +7041,10 @@ type ProjectsLocationsServicesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Access control policy for the specified
// Service. Overwrites any existing policy.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsServicesService) SetIamPolicy(resource string, googleiamv1setiampolicyrequest *GoogleIamV1SetIamPolicyRequest) *ProjectsLocationsServicesSetIamPolicyCall {
c := &ProjectsLocationsServicesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7182,10 +7188,10 @@ type ProjectsLocationsServicesTestIamPermissionsCall struct {
// specified Project. There are no permissions required for making this
// API call.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsServicesService) TestIamPermissions(resource string, googleiamv1testiampermissionsrequest *GoogleIamV1TestIamPermissionsRequest) *ProjectsLocationsServicesTestIamPermissionsCall {
c := &ProjectsLocationsServicesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7327,9 +7333,9 @@ type ProjectsLocationsServicesRevisionsDeleteCall struct {
// Delete: Delete a Revision.
//
-// - name: The name of the Revision to delete. Format:
-// projects/{project}/locations/{location}/services/{service}/revisions
-// /{revision}.
+// - name: The name of the Revision to delete. Format:
+// projects/{project}/locations/{location}/services/{service}/revisions
+// /{revision}.
func (r *ProjectsLocationsServicesRevisionsService) Delete(name string) *ProjectsLocationsServicesRevisionsDeleteCall {
c := &ProjectsLocationsServicesRevisionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7488,9 +7494,9 @@ type ProjectsLocationsServicesRevisionsGetCall struct {
// Get: Gets information about a Revision.
//
-// - name: The full name of the Revision. Format:
-// projects/{project}/locations/{location}/services/{service}/revisions
-// /{revision}.
+// - name: The full name of the Revision. Format:
+// projects/{project}/locations/{location}/services/{service}/revisions
+// /{revision}.
func (r *ProjectsLocationsServicesRevisionsService) Get(name string) *ProjectsLocationsServicesRevisionsGetCall {
c := &ProjectsLocationsServicesRevisionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7636,10 +7642,10 @@ type ProjectsLocationsServicesRevisionsListCall struct {
// List: List Revisions from a given Service, or from a given location.
//
-// - parent: The Service from which the Revisions should be listed. To
-// list all Revisions across Services, use "-" instead of Service
-// name. Format:
-// projects/{project}/locations/{location}/services/{service}.
+// - parent: The Service from which the Revisions should be listed. To
+// list all Revisions across Services, use "-" instead of Service
+// name. Format:
+// projects/{project}/locations/{location}/services/{service}.
func (r *ProjectsLocationsServicesRevisionsService) List(parent string) *ProjectsLocationsServicesRevisionsListCall {
c := &ProjectsLocationsServicesRevisionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/runtimeconfig/v1/runtimeconfig-gen.go b/runtimeconfig/v1/runtimeconfig-gen.go
index 046f32815e0..f52ddc5540f 100644
--- a/runtimeconfig/v1/runtimeconfig-gen.go
+++ b/runtimeconfig/v1/runtimeconfig-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/deployment-manager/runtime-configurator/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/runtimeconfig/v1"
-// ...
-// ctx := context.Background()
-// runtimeconfigService, err := runtimeconfig.NewService(ctx)
+// import "google.golang.org/api/runtimeconfig/v1"
+// ...
+// ctx := context.Background()
+// runtimeconfigService, err := runtimeconfig.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithScopes(runtimeconfig.CloudruntimeconfigScope))
+// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithScopes(runtimeconfig.CloudruntimeconfigScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithAPIKey("AIza..."))
+// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package runtimeconfig // import "google.golang.org/api/runtimeconfig/v1"
diff --git a/runtimeconfig/v1beta1/runtimeconfig-api.json b/runtimeconfig/v1beta1/runtimeconfig-api.json
index 219383a16cb..9d3dbf8baaf 100644
--- a/runtimeconfig/v1beta1/runtimeconfig-api.json
+++ b/runtimeconfig/v1beta1/runtimeconfig-api.json
@@ -805,7 +805,7 @@
}
}
},
- "revision": "20220502",
+ "revision": "20220808",
"rootUrl": "https://runtimeconfig.googleapis.com/",
"schemas": {
"Binding": {
@@ -817,7 +817,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/runtimeconfig/v1beta1/runtimeconfig-gen.go b/runtimeconfig/v1beta1/runtimeconfig-gen.go
index 500efc15e3a..7a3fe57e382 100644
--- a/runtimeconfig/v1beta1/runtimeconfig-gen.go
+++ b/runtimeconfig/v1beta1/runtimeconfig-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/deployment-manager/runtime-configurator/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/runtimeconfig/v1beta1"
-// ...
-// ctx := context.Background()
-// runtimeconfigService, err := runtimeconfig.NewService(ctx)
+// import "google.golang.org/api/runtimeconfig/v1beta1"
+// ...
+// ctx := context.Background()
+// runtimeconfigService, err := runtimeconfig.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithScopes(runtimeconfig.CloudruntimeconfigScope))
+// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithScopes(runtimeconfig.CloudruntimeconfigScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithAPIKey("AIza..."))
+// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// runtimeconfigService, err := runtimeconfig.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package runtimeconfig // import "google.golang.org/api/runtimeconfig/v1beta1"
@@ -222,16 +222,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1104,9 +1108,9 @@ type ProjectsConfigsCreateCall struct {
// Create: Creates a new RuntimeConfig resource. The configuration name
// must be unique within project.
//
-// - parent: The project ID
-// (https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
-// for this request, in the format `projects/[PROJECT_ID]`.
+// - parent: The project ID
+// (https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
+// for this request, in the format `projects/[PROJECT_ID]`.
func (r *ProjectsConfigsService) Create(parent string, runtimeconfig *RuntimeConfig) *ProjectsConfigsCreateCall {
c := &ProjectsConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1265,8 +1269,8 @@ type ProjectsConfigsDeleteCall struct {
// Delete: Deletes a RuntimeConfig resource.
//
-// - name: The RuntimeConfig resource to delete, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - name: The RuntimeConfig resource to delete, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsService) Delete(name string) *ProjectsConfigsDeleteCall {
c := &ProjectsConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1400,8 +1404,8 @@ type ProjectsConfigsGetCall struct {
// Get: Gets information about a RuntimeConfig resource.
//
-// - name: The name of the RuntimeConfig resource to retrieve, in the
-// format: `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - name: The name of the RuntimeConfig resource to retrieve, in the
+// format: `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsService) Get(name string) *ProjectsConfigsGetCall {
c := &ProjectsConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1550,10 +1554,10 @@ type ProjectsConfigsGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsConfigsService) GetIamPolicy(resource string) *ProjectsConfigsGetIamPolicyCall {
c := &ProjectsConfigsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -1724,9 +1728,9 @@ type ProjectsConfigsListCall struct {
// List: Lists all the RuntimeConfig resources within project.
//
-// - parent: The project ID
-// (https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
-// for this request, in the format `projects/[PROJECT_ID]`.
+// - parent: The project ID
+// (https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
+// for this request, in the format `projects/[PROJECT_ID]`.
func (r *ProjectsConfigsService) List(parent string) *ProjectsConfigsListCall {
c := &ProjectsConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1923,10 +1927,10 @@ type ProjectsConfigsSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsConfigsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsConfigsSetIamPolicyCall {
c := &ProjectsConfigsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2074,10 +2078,10 @@ type ProjectsConfigsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsConfigsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsConfigsTestIamPermissionsCall {
c := &ProjectsConfigsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2221,8 +2225,8 @@ type ProjectsConfigsUpdateCall struct {
// Update: Updates a RuntimeConfig resource. The configuration must
// exist beforehand.
//
-// - name: The name of the RuntimeConfig resource to update, in the
-// format: `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - name: The name of the RuntimeConfig resource to update, in the
+// format: `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsService) Update(name string, runtimeconfig *RuntimeConfig) *ProjectsConfigsUpdateCall {
c := &ProjectsConfigsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2519,10 +2523,10 @@ type ProjectsConfigsOperationsTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsConfigsOperationsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsConfigsOperationsTestIamPermissionsCall {
c := &ProjectsConfigsOperationsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2671,10 +2675,10 @@ type ProjectsConfigsVariablesCreateCall struct {
// (/deployment-manager/runtime-configurator/set-and-get-variables)
// documentation.
//
-// - parent: The path to the RutimeConfig resource that this variable
-// should belong to. The configuration must exist beforehand; the path
-// must be in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - parent: The path to the RutimeConfig resource that this variable
+// should belong to. The configuration must exist beforehand; the path
+// must be in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsVariablesService) Create(parent string, variable *Variable) *ProjectsConfigsVariablesCreateCall {
c := &ProjectsConfigsVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2837,9 +2841,9 @@ type ProjectsConfigsVariablesDeleteCall struct {
// deleted. You must set a `recursive` to true if you delete variables
// by prefix.
//
-// - name: The name of the variable to delete, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAM
-// E]`.
+// - name: The name of the variable to delete, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAM
+// E]`.
func (r *ProjectsConfigsVariablesService) Delete(name string) *ProjectsConfigsVariablesDeleteCall {
c := &ProjectsConfigsVariablesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2985,9 +2989,9 @@ type ProjectsConfigsVariablesGetCall struct {
// Get: Gets information about a single variable.
//
-// - name: The name of the variable to return, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIBLE_NAME
-// ]`.
+// - name: The name of the variable to return, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIBLE_NAME
+// ]`.
func (r *ProjectsConfigsVariablesService) Get(name string) *ProjectsConfigsVariablesGetCall {
c := &ProjectsConfigsVariablesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3137,10 +3141,10 @@ type ProjectsConfigsVariablesListCall struct {
// unless `return_values` is true, in which case only variables that
// user has IAM permission to GetVariable will be returned.
//
-// - parent: The path to the RuntimeConfig resource for which you want
-// to list variables. The configuration must exist beforehand; the
-// path must be in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - parent: The path to the RuntimeConfig resource for which you want
+// to list variables. The configuration must exist beforehand; the
+// path must be in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsVariablesService) List(parent string) *ProjectsConfigsVariablesListCall {
c := &ProjectsConfigsVariablesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3368,10 +3372,10 @@ type ProjectsConfigsVariablesTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsConfigsVariablesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsConfigsVariablesTestIamPermissionsCall {
c := &ProjectsConfigsVariablesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3514,9 +3518,9 @@ type ProjectsConfigsVariablesUpdateCall struct {
// Update: Updates an existing variable with a new value.
//
-// - name: The name of the variable to update, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAM
-// E]`.
+// - name: The name of the variable to update, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAM
+// E]`.
func (r *ProjectsConfigsVariablesService) Update(name string, variable *Variable) *ProjectsConfigsVariablesUpdateCall {
c := &ProjectsConfigsVariablesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3669,8 +3673,8 @@ type ProjectsConfigsVariablesWatchCall struct {
// (/deployment-manager/runtime-configurator/watching-a-variable)
// documentation.
//
-// - name: The name of the variable to watch, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - name: The name of the variable to watch, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsVariablesService) Watch(name string, watchvariablerequest *WatchVariableRequest) *ProjectsConfigsVariablesWatchCall {
c := &ProjectsConfigsVariablesWatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3818,9 +3822,9 @@ type ProjectsConfigsWaitersCreateCall struct {
// the failed Waiter resource will still exist and must be deleted prior
// to subsequent creation attempts.
//
-// - parent: The path to the configuration that will own the waiter. The
-// configuration must exist beforehand; the path must be in the
-// format: `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - parent: The path to the configuration that will own the waiter. The
+// configuration must exist beforehand; the path must be in the
+// format: `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsWaitersService) Create(parent string, waiter *Waiter) *ProjectsConfigsWaitersCreateCall {
c := &ProjectsConfigsWaitersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3979,8 +3983,8 @@ type ProjectsConfigsWaitersDeleteCall struct {
// Delete: Deletes the waiter with the specified name.
//
-// - name: The Waiter resource to delete, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`.
+// - name: The Waiter resource to delete, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`.
func (r *ProjectsConfigsWaitersService) Delete(name string) *ProjectsConfigsWaitersDeleteCall {
c := &ProjectsConfigsWaitersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4114,9 +4118,9 @@ type ProjectsConfigsWaitersGetCall struct {
// Get: Gets information about a single waiter.
//
-// - name: The fully-qualified name of the Waiter resource object to
-// retrieve, in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`.
+// - name: The fully-qualified name of the Waiter resource object to
+// retrieve, in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`.
func (r *ProjectsConfigsWaitersService) Get(name string) *ProjectsConfigsWaitersGetCall {
c := &ProjectsConfigsWaitersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4263,10 +4267,10 @@ type ProjectsConfigsWaitersListCall struct {
// List: List waiters within the given configuration.
//
-// - parent: The path to the configuration for which you want to get a
-// list of waiters. The configuration must exist beforehand; the path
-// must be in the format:
-// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
+// - parent: The path to the configuration for which you want to get a
+// list of waiters. The configuration must exist beforehand; the path
+// must be in the format:
+// `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
func (r *ProjectsConfigsWaitersService) List(parent string) *ProjectsConfigsWaitersListCall {
c := &ProjectsConfigsWaitersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4466,10 +4470,10 @@ type ProjectsConfigsWaitersTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsConfigsWaitersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsConfigsWaitersTestIamPermissionsCall {
c := &ProjectsConfigsWaitersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
diff --git a/safebrowsing/v4/safebrowsing-gen.go b/safebrowsing/v4/safebrowsing-gen.go
index d9afe7dfa4f..a1b5b915808 100644
--- a/safebrowsing/v4/safebrowsing-gen.go
+++ b/safebrowsing/v4/safebrowsing-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/safe-browsing/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/safebrowsing/v4"
-// ...
-// ctx := context.Background()
-// safebrowsingService, err := safebrowsing.NewService(ctx)
+// import "google.golang.org/api/safebrowsing/v4"
+// ...
+// ctx := context.Background()
+// safebrowsingService, err := safebrowsing.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// safebrowsingService, err := safebrowsing.NewService(ctx, option.WithAPIKey("AIza..."))
+// safebrowsingService, err := safebrowsing.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// safebrowsingService, err := safebrowsing.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// safebrowsingService, err := safebrowsing.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package safebrowsing // import "google.golang.org/api/safebrowsing/v4"
diff --git a/sasportal/v1alpha1/sasportal-gen.go b/sasportal/v1alpha1/sasportal-gen.go
index 0eee996f249..90aead59349 100644
--- a/sasportal/v1alpha1/sasportal-gen.go
+++ b/sasportal/v1alpha1/sasportal-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/spectrum-access-system/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sasportal/v1alpha1"
-// ...
-// ctx := context.Background()
-// sasportalService, err := sasportal.NewService(ctx)
+// import "google.golang.org/api/sasportal/v1alpha1"
+// ...
+// ctx := context.Background()
+// sasportalService, err := sasportal.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// sasportalService, err := sasportal.NewService(ctx, option.WithScopes(sasportal.UserinfoEmailScope))
+// sasportalService, err := sasportal.NewService(ctx, option.WithScopes(sasportal.UserinfoEmailScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// sasportalService, err := sasportal.NewService(ctx, option.WithAPIKey("AIza..."))
+// sasportalService, err := sasportal.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// sasportalService, err := sasportal.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// sasportalService, err := sasportal.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sasportal // import "google.golang.org/api/sasportal/v1alpha1"
@@ -2425,8 +2425,8 @@ type CustomersDeploymentsCreateCall struct {
// Create: Creates a new deployment.
//
-// - parent: The parent resource name where the deployment is to be
-// created.
+// - parent: The parent resource name where the deployment is to be
+// created.
func (r *CustomersDeploymentsService) Create(parent string, sasportaldeployment *SasPortalDeployment) *CustomersDeploymentsCreateCall {
c := &CustomersDeploymentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2849,8 +2849,8 @@ type CustomersDeploymentsListCall struct {
// List: Lists deployments.
//
-// - parent: The parent resource name, for example, "nodes/1",
-// customer/1/nodes/2.
+// - parent: The parent resource name, for example, "nodes/1",
+// customer/1/nodes/2.
func (r *CustomersDeploymentsService) List(parent string) *CustomersDeploymentsListCall {
c := &CustomersDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6142,8 +6142,8 @@ type CustomersNodesDeploymentsCreateCall struct {
// Create: Creates a new deployment.
//
-// - parent: The parent resource name where the deployment is to be
-// created.
+// - parent: The parent resource name where the deployment is to be
+// created.
func (r *CustomersNodesDeploymentsService) Create(parent string, sasportaldeployment *SasPortalDeployment) *CustomersNodesDeploymentsCreateCall {
c := &CustomersNodesDeploymentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6286,8 +6286,8 @@ type CustomersNodesDeploymentsListCall struct {
// List: Lists deployments.
//
-// - parent: The parent resource name, for example, "nodes/1",
-// customer/1/nodes/2.
+// - parent: The parent resource name, for example, "nodes/1",
+// customer/1/nodes/2.
func (r *CustomersNodesDeploymentsService) List(parent string) *CustomersNodesDeploymentsListCall {
c := &CustomersNodesDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9035,8 +9035,8 @@ type NodesDeploymentsListCall struct {
// List: Lists deployments.
//
-// - parent: The parent resource name, for example, "nodes/1",
-// customer/1/nodes/2.
+// - parent: The parent resource name, for example, "nodes/1",
+// customer/1/nodes/2.
func (r *NodesDeploymentsService) List(parent string) *NodesDeploymentsListCall {
c := &NodesDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12328,8 +12328,8 @@ type NodesNodesDeploymentsCreateCall struct {
// Create: Creates a new deployment.
//
-// - parent: The parent resource name where the deployment is to be
-// created.
+// - parent: The parent resource name where the deployment is to be
+// created.
func (r *NodesNodesDeploymentsService) Create(parent string, sasportaldeployment *SasPortalDeployment) *NodesNodesDeploymentsCreateCall {
c := &NodesNodesDeploymentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12472,8 +12472,8 @@ type NodesNodesDeploymentsListCall struct {
// List: Lists deployments.
//
-// - parent: The parent resource name, for example, "nodes/1",
-// customer/1/nodes/2.
+// - parent: The parent resource name, for example, "nodes/1",
+// customer/1/nodes/2.
func (r *NodesNodesDeploymentsService) List(parent string) *NodesNodesDeploymentsListCall {
c := &NodesNodesDeploymentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/script/v1/script-gen.go b/script/v1/script-gen.go
index 2423825b4aa..5d997fc768b 100644
--- a/script/v1/script-gen.go
+++ b/script/v1/script-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/apps-script/api/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/script/v1"
-// ...
-// ctx := context.Background()
-// scriptService, err := script.NewService(ctx)
+// import "google.golang.org/api/script/v1"
+// ...
+// ctx := context.Background()
+// scriptService, err := script.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// scriptService, err := script.NewService(ctx, option.WithScopes(script.UserinfoEmailScope))
+// scriptService, err := script.NewService(ctx, option.WithScopes(script.UserinfoEmailScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// scriptService, err := script.NewService(ctx, option.WithAPIKey("AIza..."))
+// scriptService, err := script.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// scriptService, err := script.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// scriptService, err := script.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package script // import "google.golang.org/api/script/v1"
@@ -1822,15 +1822,16 @@ func (c *ProcessesListCall) UserProcessFilterStartTime(userProcessFilterStartTim
// processes to those having one of the specified process statuses.
//
// Possible values:
-// "PROCESS_STATUS_UNSPECIFIED" - Unspecified status.
-// "RUNNING" - The process is currently running.
-// "PAUSED" - The process has paused.
-// "COMPLETED" - The process has completed.
-// "CANCELED" - The process was cancelled.
-// "FAILED" - The process failed.
-// "TIMED_OUT" - The process timed out.
-// "UNKNOWN" - Process status unknown.
-// "DELAYED" - The process is delayed, waiting for quota.
+//
+// "PROCESS_STATUS_UNSPECIFIED" - Unspecified status.
+// "RUNNING" - The process is currently running.
+// "PAUSED" - The process has paused.
+// "COMPLETED" - The process has completed.
+// "CANCELED" - The process was cancelled.
+// "FAILED" - The process failed.
+// "TIMED_OUT" - The process timed out.
+// "UNKNOWN" - Process status unknown.
+// "DELAYED" - The process is delayed, waiting for quota.
func (c *ProcessesListCall) UserProcessFilterStatuses(userProcessFilterStatuses ...string) *ProcessesListCall {
c.urlParams_.SetMulti("userProcessFilter.statuses", append([]string{}, userProcessFilterStatuses...))
return c
@@ -1841,18 +1842,23 @@ func (c *ProcessesListCall) UserProcessFilterStatuses(userProcessFilterStatuses
// processes to those having one of the specified process types.
//
// Possible values:
-// "PROCESS_TYPE_UNSPECIFIED" - Unspecified type.
-// "ADD_ON" - The process was started from an add-on entry point.
-// "EXECUTION_API" - The process was started using the Apps Script
+//
+// "PROCESS_TYPE_UNSPECIFIED" - Unspecified type.
+// "ADD_ON" - The process was started from an add-on entry point.
+// "EXECUTION_API" - The process was started using the Apps Script
+//
// API.
-// "TIME_DRIVEN" - The process was started from a time-based trigger.
-// "TRIGGER" - The process was started from an event-based trigger.
-// "WEBAPP" - The process was started from a web app entry point.
-// "EDITOR" - The process was started using the Apps Script IDE.
-// "SIMPLE_TRIGGER" - The process was started from a G Suite simple
+//
+// "TIME_DRIVEN" - The process was started from a time-based trigger.
+// "TRIGGER" - The process was started from an event-based trigger.
+// "WEBAPP" - The process was started from a web app entry point.
+// "EDITOR" - The process was started using the Apps Script IDE.
+// "SIMPLE_TRIGGER" - The process was started from a G Suite simple
+//
// trigger.
-// "MENU" - The process was started from a G Suite menu item.
-// "BATCH_TASK" - The process was started as a task in a batch job.
+//
+// "MENU" - The process was started from a G Suite menu item.
+// "BATCH_TASK" - The process was started as a task in a batch job.
func (c *ProcessesListCall) UserProcessFilterTypes(userProcessFilterTypes ...string) *ProcessesListCall {
c.urlParams_.SetMulti("userProcessFilter.types", append([]string{}, userProcessFilterTypes...))
return c
@@ -1864,11 +1870,12 @@ func (c *ProcessesListCall) UserProcessFilterTypes(userProcessFilterTypes ...str
// levels.
//
// Possible values:
-// "USER_ACCESS_LEVEL_UNSPECIFIED" - User access level unspecified
-// "NONE" - The user has no access.
-// "READ" - The user has read-only access.
-// "WRITE" - The user has write access.
-// "OWNER" - The user is an owner.
+//
+// "USER_ACCESS_LEVEL_UNSPECIFIED" - User access level unspecified
+// "NONE" - The user has no access.
+// "READ" - The user has read-only access.
+// "WRITE" - The user has write access.
+// "OWNER" - The user is an owner.
func (c *ProcessesListCall) UserProcessFilterUserAccessLevels(userProcessFilterUserAccessLevels ...string) *ProcessesListCall {
c.urlParams_.SetMulti("userProcessFilter.userAccessLevels", append([]string{}, userProcessFilterUserAccessLevels...))
return c
@@ -2209,15 +2216,16 @@ func (c *ProcessesListScriptProcessesCall) ScriptProcessFilterStartTime(scriptPr
// processes to those having one of the specified process statuses.
//
// Possible values:
-// "PROCESS_STATUS_UNSPECIFIED" - Unspecified status.
-// "RUNNING" - The process is currently running.
-// "PAUSED" - The process has paused.
-// "COMPLETED" - The process has completed.
-// "CANCELED" - The process was cancelled.
-// "FAILED" - The process failed.
-// "TIMED_OUT" - The process timed out.
-// "UNKNOWN" - Process status unknown.
-// "DELAYED" - The process is delayed, waiting for quota.
+//
+// "PROCESS_STATUS_UNSPECIFIED" - Unspecified status.
+// "RUNNING" - The process is currently running.
+// "PAUSED" - The process has paused.
+// "COMPLETED" - The process has completed.
+// "CANCELED" - The process was cancelled.
+// "FAILED" - The process failed.
+// "TIMED_OUT" - The process timed out.
+// "UNKNOWN" - Process status unknown.
+// "DELAYED" - The process is delayed, waiting for quota.
func (c *ProcessesListScriptProcessesCall) ScriptProcessFilterStatuses(scriptProcessFilterStatuses ...string) *ProcessesListScriptProcessesCall {
c.urlParams_.SetMulti("scriptProcessFilter.statuses", append([]string{}, scriptProcessFilterStatuses...))
return c
@@ -2228,18 +2236,23 @@ func (c *ProcessesListScriptProcessesCall) ScriptProcessFilterStatuses(scriptPro
// processes to those having one of the specified process types.
//
// Possible values:
-// "PROCESS_TYPE_UNSPECIFIED" - Unspecified type.
-// "ADD_ON" - The process was started from an add-on entry point.
-// "EXECUTION_API" - The process was started using the Apps Script
+//
+// "PROCESS_TYPE_UNSPECIFIED" - Unspecified type.
+// "ADD_ON" - The process was started from an add-on entry point.
+// "EXECUTION_API" - The process was started using the Apps Script
+//
// API.
-// "TIME_DRIVEN" - The process was started from a time-based trigger.
-// "TRIGGER" - The process was started from an event-based trigger.
-// "WEBAPP" - The process was started from a web app entry point.
-// "EDITOR" - The process was started using the Apps Script IDE.
-// "SIMPLE_TRIGGER" - The process was started from a G Suite simple
+//
+// "TIME_DRIVEN" - The process was started from a time-based trigger.
+// "TRIGGER" - The process was started from an event-based trigger.
+// "WEBAPP" - The process was started from a web app entry point.
+// "EDITOR" - The process was started using the Apps Script IDE.
+// "SIMPLE_TRIGGER" - The process was started from a G Suite simple
+//
// trigger.
-// "MENU" - The process was started from a G Suite menu item.
-// "BATCH_TASK" - The process was started as a task in a batch job.
+//
+// "MENU" - The process was started from a G Suite menu item.
+// "BATCH_TASK" - The process was started as a task in a batch job.
func (c *ProcessesListScriptProcessesCall) ScriptProcessFilterTypes(scriptProcessFilterTypes ...string) *ProcessesListScriptProcessesCall {
c.urlParams_.SetMulti("scriptProcessFilter.types", append([]string{}, scriptProcessFilterTypes...))
return c
@@ -2251,11 +2264,12 @@ func (c *ProcessesListScriptProcessesCall) ScriptProcessFilterTypes(scriptProces
// levels.
//
// Possible values:
-// "USER_ACCESS_LEVEL_UNSPECIFIED" - User access level unspecified
-// "NONE" - The user has no access.
-// "READ" - The user has read-only access.
-// "WRITE" - The user has write access.
-// "OWNER" - The user is an owner.
+//
+// "USER_ACCESS_LEVEL_UNSPECIFIED" - User access level unspecified
+// "NONE" - The user has no access.
+// "READ" - The user has read-only access.
+// "WRITE" - The user has write access.
+// "OWNER" - The user is an owner.
func (c *ProcessesListScriptProcessesCall) ScriptProcessFilterUserAccessLevels(scriptProcessFilterUserAccessLevels ...string) *ProcessesListScriptProcessesCall {
c.urlParams_.SetMulti("scriptProcessFilter.userAccessLevels", append([]string{}, scriptProcessFilterUserAccessLevels...))
return c
@@ -2978,10 +2992,13 @@ func (c *ProjectsGetMetricsCall) MetricsFilterDeploymentId(metricsFilterDeployme
// Required field indicating what granularity of metrics are returned.
//
// Possible values:
-// "UNSPECIFIED_GRANULARITY" - Default metric granularity used to
+//
+// "UNSPECIFIED_GRANULARITY" - Default metric granularity used to
+//
// query no metrics.
-// "WEEKLY" - Represents weekly metrics.
-// "DAILY" - Represents daily metrics over a period of 7 days.
+//
+// "WEEKLY" - Represents weekly metrics.
+// "DAILY" - Represents daily metrics over a period of 7 days.
func (c *ProjectsGetMetricsCall) MetricsGranularity(metricsGranularity string) *ProjectsGetMetricsCall {
c.urlParams_.Set("metricsGranularity", metricsGranularity)
return c
@@ -4579,8 +4596,8 @@ type ScriptsRunCall struct {
// that the Cloud Platform project used to authorize the request is not
// the same as the one used by the script.
//
-// - scriptId: The script ID of the script to be executed. Find the
-// script ID on the **Project settings** page under "IDs.".
+// - scriptId: The script ID of the script to be executed. Find the
+// script ID on the **Project settings** page under "IDs.".
func (r *ScriptsService) Run(scriptId string, executionrequest *ExecutionRequest) *ScriptsRunCall {
c := &ScriptsRunCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.scriptId = scriptId
diff --git a/searchconsole/v1/searchconsole-api.json b/searchconsole/v1/searchconsole-api.json
index 1f99214d7f2..80ce11f5311 100644
--- a/searchconsole/v1/searchconsole-api.json
+++ b/searchconsole/v1/searchconsole-api.json
@@ -400,7 +400,7 @@
}
}
},
- "revision": "20220303",
+ "revision": "20220816",
"rootUrl": "https://searchconsole.googleapis.com/",
"schemas": {
"AmpInspectionResult": {
@@ -419,7 +419,7 @@
"enumDescriptions": [
"Unknown verdict.",
"Equivalent to \"Valid\" for the page or item in Search Console.",
- "Equivalent to \"Valid with warnings\" for the page or item in Search Console.",
+ "Reserved, no longer in use.",
"Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.",
"Equivalent to \"Excluded\" for the page or item in Search Console."
],
@@ -515,7 +515,7 @@
"enumDescriptions": [
"Unknown verdict.",
"Equivalent to \"Valid\" for the page or item in Search Console.",
- "Equivalent to \"Valid with warnings\" for the page or item in Search Console.",
+ "Reserved, no longer in use.",
"Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.",
"Equivalent to \"Excluded\" for the page or item in Search Console."
],
@@ -815,7 +815,7 @@
"enumDescriptions": [
"Unknown verdict.",
"Equivalent to \"Valid\" for the page or item in Search Console.",
- "Equivalent to \"Valid with warnings\" for the page or item in Search Console.",
+ "Reserved, no longer in use.",
"Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.",
"Equivalent to \"Excluded\" for the page or item in Search Console."
],
@@ -924,7 +924,7 @@
"enumDescriptions": [
"Unknown verdict.",
"Equivalent to \"Valid\" for the page or item in Search Console.",
- "Equivalent to \"Valid with warnings\" for the page or item in Search Console.",
+ "Reserved, no longer in use.",
"Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.",
"Equivalent to \"Excluded\" for the page or item in Search Console."
],
@@ -1014,7 +1014,7 @@
"enumDescriptions": [
"Unknown verdict.",
"Equivalent to \"Valid\" for the page or item in Search Console.",
- "Equivalent to \"Valid with warnings\" for the page or item in Search Console.",
+ "Reserved, no longer in use.",
"Equivalent to \"Error\" or \"Invalid\" for the page or item in Search Console.",
"Equivalent to \"Excluded\" for the page or item in Search Console."
],
diff --git a/searchconsole/v1/searchconsole-gen.go b/searchconsole/v1/searchconsole-gen.go
index 37e878f82f4..f9036a22e45 100644
--- a/searchconsole/v1/searchconsole-gen.go
+++ b/searchconsole/v1/searchconsole-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/webmaster-tools/search-console-api/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/searchconsole/v1"
-// ...
-// ctx := context.Background()
-// searchconsoleService, err := searchconsole.NewService(ctx)
+// import "google.golang.org/api/searchconsole/v1"
+// ...
+// ctx := context.Background()
+// searchconsoleService, err := searchconsole.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// searchconsoleService, err := searchconsole.NewService(ctx, option.WithScopes(searchconsole.WebmastersReadonlyScope))
+// searchconsoleService, err := searchconsole.NewService(ctx, option.WithScopes(searchconsole.WebmastersReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// searchconsoleService, err := searchconsole.NewService(ctx, option.WithAPIKey("AIza..."))
+// searchconsoleService, err := searchconsole.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// searchconsoleService, err := searchconsole.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// searchconsoleService, err := searchconsole.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package searchconsole // import "google.golang.org/api/searchconsole/v1"
@@ -235,8 +235,7 @@ type AmpInspectionResult struct {
// "VERDICT_UNSPECIFIED" - Unknown verdict.
// "PASS" - Equivalent to "Valid" for the page or item in Search
// Console.
- // "PARTIAL" - Equivalent to "Valid with warnings" for the page or
- // item in Search Console.
+ // "PARTIAL" - Reserved, no longer in use.
// "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in
// Search Console.
// "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
@@ -304,8 +303,7 @@ type AmpInspectionResult struct {
// "VERDICT_UNSPECIFIED" - Unknown verdict.
// "PASS" - Equivalent to "Valid" for the page or item in Search
// Console.
- // "PARTIAL" - Equivalent to "Valid with warnings" for the page or
- // item in Search Console.
+ // "PARTIAL" - Reserved, no longer in use.
// "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in
// Search Console.
// "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
@@ -698,8 +696,7 @@ type IndexStatusInspectionResult struct {
// "VERDICT_UNSPECIFIED" - Unknown verdict.
// "PASS" - Equivalent to "Valid" for the page or item in Search
// Console.
- // "PARTIAL" - Equivalent to "Valid with warnings" for the page or
- // item in Search Console.
+ // "PARTIAL" - Reserved, no longer in use.
// "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in
// Search Console.
// "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
@@ -896,8 +893,7 @@ type MobileUsabilityInspectionResult struct {
// "VERDICT_UNSPECIFIED" - Unknown verdict.
// "PASS" - Equivalent to "Valid" for the page or item in Search
// Console.
- // "PARTIAL" - Equivalent to "Valid with warnings" for the page or
- // item in Search Console.
+ // "PARTIAL" - Reserved, no longer in use.
// "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in
// Search Console.
// "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
@@ -1031,8 +1027,7 @@ type RichResultsInspectionResult struct {
// "VERDICT_UNSPECIFIED" - Unknown verdict.
// "PASS" - Equivalent to "Valid" for the page or item in Search
// Console.
- // "PARTIAL" - Equivalent to "Valid with warnings" for the page or
- // item in Search Console.
+ // "PARTIAL" - Reserved, no longer in use.
// "FAIL" - Equivalent to "Error" or "Invalid" for the page or item in
// Search Console.
// "NEUTRAL" - Equivalent to "Excluded" for the page or item in Search
@@ -1690,8 +1685,8 @@ type SearchanalyticsQueryCall struct {
// date range query grouped by date for any metric, and see which day
// rows are returned.
//
-// - siteUrl: The site's URL, including protocol. For example:
-// `http://www.example.com/`.
+// - siteUrl: The site's URL, including protocol. For example:
+// `http://www.example.com/`.
func (r *SearchanalyticsService) Query(siteUrl string, searchanalyticsqueryrequest *SearchAnalyticsQueryRequest) *SearchanalyticsQueryCall {
c := &SearchanalyticsQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -1835,10 +1830,10 @@ type SitemapsDeleteCall struct {
// Google from crawling this sitemap or the URLs that were previously
// crawled in the deleted sitemap.
//
-// - feedpath: The URL of the actual sitemap. For example:
-// `http://www.example.com/sitemap.xml`.
-// - siteUrl: The site's URL, including protocol. For example:
-// `http://www.example.com/`.
+// - feedpath: The URL of the actual sitemap. For example:
+// `http://www.example.com/sitemap.xml`.
+// - siteUrl: The site's URL, including protocol. For example:
+// `http://www.example.com/`.
func (r *SitemapsService) Delete(siteUrl string, feedpath string) *SitemapsDeleteCall {
c := &SitemapsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -1952,10 +1947,10 @@ type SitemapsGetCall struct {
// Get: Retrieves information about a specific sitemap.
//
-// - feedpath: The URL of the actual sitemap. For example:
-// `http://www.example.com/sitemap.xml`.
-// - siteUrl: The site's URL, including protocol. For example:
-// `http://www.example.com/`.
+// - feedpath: The URL of the actual sitemap. For example:
+// `http://www.example.com/sitemap.xml`.
+// - siteUrl: The site's URL, including protocol. For example:
+// `http://www.example.com/`.
func (r *SitemapsService) Get(siteUrl string, feedpath string) *SitemapsGetCall {
c := &SitemapsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -2112,8 +2107,8 @@ type SitemapsListCall struct {
// submitted for this site, or included in the sitemap index file (if
// `sitemapIndex` is specified in the request).
//
-// - siteUrl: The site's URL, including protocol. For example:
-// `http://www.example.com/`.
+// - siteUrl: The site's URL, including protocol. For example:
+// `http://www.example.com/`.
func (r *SitemapsService) List(siteUrl string) *SitemapsListCall {
c := &SitemapsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -2272,10 +2267,10 @@ type SitemapsSubmitCall struct {
// Submit: Submits a sitemap for a site.
//
-// - feedpath: The URL of the actual sitemap. For example:
-// `http://www.example.com/sitemap.xml`.
-// - siteUrl: The site's URL, including protocol. For example:
-// `http://www.example.com/`.
+// - feedpath: The URL of the actual sitemap. For example:
+// `http://www.example.com/sitemap.xml`.
+// - siteUrl: The site's URL, including protocol. For example:
+// `http://www.example.com/`.
func (r *SitemapsService) Submit(siteUrl string, feedpath string) *SitemapsSubmitCall {
c := &SitemapsSubmitCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -2491,8 +2486,8 @@ type SitesDeleteCall struct {
// Delete: Removes a site from the set of the user's Search Console
// sites.
//
-// - siteUrl: The URI of the property as defined in Search Console.
-// **Examples:** `http://www.example.com/` or `sc-domain:example.com`.
+// - siteUrl: The URI of the property as defined in Search Console.
+// **Examples:** `http://www.example.com/` or `sc-domain:example.com`.
func (r *SitesService) Delete(siteUrl string) *SitesDeleteCall {
c := &SitesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -2596,8 +2591,8 @@ type SitesGetCall struct {
// Get: Retrieves information about specific site.
//
-// - siteUrl: The URI of the property as defined in Search Console.
-// **Examples:** `http://www.example.com/` or `sc-domain:example.com`.
+// - siteUrl: The URI of the property as defined in Search Console.
+// **Examples:** `http://www.example.com/` or `sc-domain:example.com`.
func (r *SitesService) Get(siteUrl string) *SitesGetCall {
c := &SitesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
diff --git a/secretmanager/v1/secretmanager-api.json b/secretmanager/v1/secretmanager-api.json
index 589ed9aada1..ce498b2e0dd 100644
--- a/secretmanager/v1/secretmanager-api.json
+++ b/secretmanager/v1/secretmanager-api.json
@@ -643,7 +643,7 @@
}
}
},
- "revision": "20220617",
+ "revision": "20220812",
"rootUrl": "https://secretmanager.googleapis.com/",
"schemas": {
"AccessSecretVersionResponse": {
@@ -752,7 +752,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
@@ -1061,6 +1061,13 @@
"description": "A Secret is a logical secret whose value and versions can be accessed. A Secret is made up of zero or more SecretVersions that represent the secret data.",
"id": "Secret",
"properties": {
+ "annotations": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Optional. Custom metadata about the secret. Annotations are distinct from various forms of labels. Annotations exist to allow client tools to store their own state information without requiring a database. Annotation keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, begin and end with an alphanumeric character ([a-z0-9A-Z]), and may have dashes (-), underscores (_), dots (.), and alphanumerics in between these symbols. The total size of annotation keys and values must be less than 16KiB.",
+ "type": "object"
+ },
"createTime": {
"description": "Output only. The time at which the Secret was created.",
"format": "google-datetime",
diff --git a/secretmanager/v1/secretmanager-gen.go b/secretmanager/v1/secretmanager-gen.go
index d0a43a91081..3f19842ae7b 100644
--- a/secretmanager/v1/secretmanager-gen.go
+++ b/secretmanager/v1/secretmanager-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/secret-manager/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/secretmanager/v1"
-// ...
-// ctx := context.Background()
-// secretmanagerService, err := secretmanager.NewService(ctx)
+// import "google.golang.org/api/secretmanager/v1"
+// ...
+// ctx := context.Background()
+// secretmanagerService, err := secretmanager.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// secretmanagerService, err := secretmanager.NewService(ctx, option.WithAPIKey("AIza..."))
+// secretmanagerService, err := secretmanager.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// secretmanagerService, err := secretmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// secretmanagerService, err := secretmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package secretmanager // import "google.golang.org/api/secretmanager/v1"
@@ -435,16 +435,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1194,6 +1198,17 @@ func (s *Rotation) MarshalJSON() ([]byte, error) {
// accessed. A Secret is made up of zero or more SecretVersions that
// represent the secret data.
type Secret struct {
+ // Annotations: Optional. Custom metadata about the secret. Annotations
+ // are distinct from various forms of labels. Annotations exist to allow
+ // client tools to store their own state information without requiring a
+ // database. Annotation keys must be between 1 and 63 characters long,
+ // have a UTF-8 encoding of maximum 128 bytes, begin and end with an
+ // alphanumeric character ([a-z0-9A-Z]), and may have dashes (-),
+ // underscores (_), dots (.), and alphanumerics in between these
+ // symbols. The total size of annotation keys and values must be less
+ // than 16KiB.
+ Annotations map[string]string `json:"annotations,omitempty"`
+
// CreateTime: Output only. The time at which the Secret was created.
CreateTime string `json:"createTime,omitempty"`
@@ -1250,7 +1265,7 @@ type Secret struct {
// server.
googleapi.ServerResponse `json:"-"`
- // ForceSendFields is a list of field names (e.g. "CreateTime") to
+ // ForceSendFields is a list of field names (e.g. "Annotations") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -1258,10 +1273,10 @@ type Secret struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CreateTime") to include in
- // API requests with the JSON null value. By default, fields with empty
- // values are omitted from API requests. However, any field with an
- // empty value appearing in NullFields will be sent to the server as
+ // NullFields is a list of field names (e.g. "Annotations") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
@@ -1741,8 +1756,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1950,8 +1965,8 @@ type ProjectsSecretsAddVersionCall struct {
// AddVersion: Creates a new SecretVersion containing secret data and
// attaches it to an existing Secret.
//
-// - parent: The resource name of the Secret to associate with the
-// SecretVersion in the format `projects/*/secrets/*`.
+// - parent: The resource name of the Secret to associate with the
+// SecretVersion in the format `projects/*/secrets/*`.
func (r *ProjectsSecretsService) AddVersion(parent string, addsecretversionrequest *AddSecretVersionRequest) *ProjectsSecretsAddVersionCall {
c := &ProjectsSecretsAddVersionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2093,8 +2108,8 @@ type ProjectsSecretsCreateCall struct {
// Create: Creates a new Secret containing no SecretVersions.
//
-// - parent: The resource name of the project to associate with the
-// Secret, in the format `projects/*`.
+// - parent: The resource name of the project to associate with the
+// Secret, in the format `projects/*`.
func (r *ProjectsSecretsService) Create(parent string, secret *Secret) *ProjectsSecretsCreateCall {
c := &ProjectsSecretsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2250,8 +2265,8 @@ type ProjectsSecretsDeleteCall struct {
// Delete: Deletes a Secret.
//
-// - name: The resource name of the Secret to delete in the format
-// `projects/*/secrets/*`.
+// - name: The resource name of the Secret to delete in the format
+// `projects/*/secrets/*`.
func (r *ProjectsSecretsService) Delete(name string) *ProjectsSecretsDeleteCall {
c := &ProjectsSecretsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2397,8 +2412,8 @@ type ProjectsSecretsGetCall struct {
// Get: Gets metadata for a given Secret.
//
-// - name: The resource name of the Secret, in the format
-// `projects/*/secrets/*`.
+// - name: The resource name of the Secret, in the format
+// `projects/*/secrets/*`.
func (r *ProjectsSecretsService) Get(name string) *ProjectsSecretsGetCall {
c := &ProjectsSecretsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2545,10 +2560,10 @@ type ProjectsSecretsGetIamPolicyCall struct {
// GetIamPolicy: Gets the access control policy for a secret. Returns
// empty policy if the secret exists and does not have a policy set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSecretsService) GetIamPolicy(resource string) *ProjectsSecretsGetIamPolicyCall {
c := &ProjectsSecretsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2718,8 +2733,8 @@ type ProjectsSecretsListCall struct {
// List: Lists Secrets.
//
-// - parent: The resource name of the project associated with the
-// Secrets, in the format `projects/*`.
+// - parent: The resource name of the project associated with the
+// Secrets, in the format `projects/*`.
func (r *ProjectsSecretsService) List(parent string) *ProjectsSecretsListCall {
c := &ProjectsSecretsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2928,8 +2943,8 @@ type ProjectsSecretsPatchCall struct {
// Patch: Updates metadata of an existing Secret.
//
-// - name: Output only. The resource name of the Secret in the format
-// `projects/*/secrets/*`.
+// - name: Output only. The resource name of the Secret in the format
+// `projects/*/secrets/*`.
func (r *ProjectsSecretsService) Patch(name string, secret *Secret) *ProjectsSecretsPatchCall {
c := &ProjectsSecretsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3086,10 +3101,10 @@ type ProjectsSecretsSetIamPolicyCall struct {
// Replaces any existing policy. Permissions on SecretVersions are
// enforced according to the policy set on the associated Secret.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSecretsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsSecretsSetIamPolicyCall {
c := &ProjectsSecretsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3236,10 +3251,10 @@ type ProjectsSecretsTestIamPermissionsCall struct {
// command-line tools, not for authorization checking. This operation
// may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSecretsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsSecretsTestIamPermissionsCall {
c := &ProjectsSecretsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3383,10 +3398,10 @@ type ProjectsSecretsVersionsAccessCall struct {
// `projects/*/secrets/*/versions/latest` is an alias to the most
// recently created SecretVersion.
//
-// - name: The resource name of the SecretVersion in the format
-// `projects/*/secrets/*/versions/*`.
-// `projects/*/secrets/*/versions/latest` is an alias to the most
-// recently created SecretVersion.
+// - name: The resource name of the SecretVersion in the format
+// `projects/*/secrets/*/versions/*`.
+// `projects/*/secrets/*/versions/latest` is an alias to the most
+// recently created SecretVersion.
func (r *ProjectsSecretsVersionsService) Access(name string) *ProjectsSecretsVersionsAccessCall {
c := &ProjectsSecretsVersionsAccessCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3533,8 +3548,8 @@ type ProjectsSecretsVersionsDestroyCall struct {
// Destroy: Destroys a SecretVersion. Sets the state of the
// SecretVersion to DESTROYED and irrevocably destroys the secret data.
//
-// - name: The resource name of the SecretVersion to destroy in the
-// format `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion to destroy in the
+// format `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Destroy(name string, destroysecretversionrequest *DestroySecretVersionRequest) *ProjectsSecretsVersionsDestroyCall {
c := &ProjectsSecretsVersionsDestroyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3677,8 +3692,8 @@ type ProjectsSecretsVersionsDisableCall struct {
// Disable: Disables a SecretVersion. Sets the state of the
// SecretVersion to DISABLED.
//
-// - name: The resource name of the SecretVersion to disable in the
-// format `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion to disable in the
+// format `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Disable(name string, disablesecretversionrequest *DisableSecretVersionRequest) *ProjectsSecretsVersionsDisableCall {
c := &ProjectsSecretsVersionsDisableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3821,8 +3836,8 @@ type ProjectsSecretsVersionsEnableCall struct {
// Enable: Enables a SecretVersion. Sets the state of the SecretVersion
// to ENABLED.
//
-// - name: The resource name of the SecretVersion to enable in the
-// format `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion to enable in the
+// format `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Enable(name string, enablesecretversionrequest *EnableSecretVersionRequest) *ProjectsSecretsVersionsEnableCall {
c := &ProjectsSecretsVersionsEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3966,10 +3981,10 @@ type ProjectsSecretsVersionsGetCall struct {
// `projects/*/secrets/*/versions/latest` is an alias to the most
// recently created SecretVersion.
//
-// - name: The resource name of the SecretVersion in the format
-// `projects/*/secrets/*/versions/*`.
-// `projects/*/secrets/*/versions/latest` is an alias to the most
-// recently created SecretVersion.
+// - name: The resource name of the SecretVersion in the format
+// `projects/*/secrets/*/versions/*`.
+// `projects/*/secrets/*/versions/latest` is an alias to the most
+// recently created SecretVersion.
func (r *ProjectsSecretsVersionsService) Get(name string) *ProjectsSecretsVersionsGetCall {
c := &ProjectsSecretsVersionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4115,8 +4130,8 @@ type ProjectsSecretsVersionsListCall struct {
// List: Lists SecretVersions. This call does not return secret data.
//
-// - parent: The resource name of the Secret associated with the
-// SecretVersions to list, in the format `projects/*/secrets/*`.
+// - parent: The resource name of the Secret associated with the
+// SecretVersions to list, in the format `projects/*/secrets/*`.
func (r *ProjectsSecretsVersionsService) List(parent string) *ProjectsSecretsVersionsListCall {
c := &ProjectsSecretsVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/secretmanager/v1beta1/secretmanager-api.json b/secretmanager/v1beta1/secretmanager-api.json
index 1cdc6f863a7..d06abeee304 100644
--- a/secretmanager/v1beta1/secretmanager-api.json
+++ b/secretmanager/v1beta1/secretmanager-api.json
@@ -628,7 +628,7 @@
}
}
},
- "revision": "20220506",
+ "revision": "20220812",
"rootUrl": "https://secretmanager.googleapis.com/",
"schemas": {
"AccessSecretVersionResponse": {
@@ -720,7 +720,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/secretmanager/v1beta1/secretmanager-gen.go b/secretmanager/v1beta1/secretmanager-gen.go
index ba3fa07c97b..e3ead2f6b60 100644
--- a/secretmanager/v1beta1/secretmanager-gen.go
+++ b/secretmanager/v1beta1/secretmanager-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/secret-manager/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/secretmanager/v1beta1"
-// ...
-// ctx := context.Background()
-// secretmanagerService, err := secretmanager.NewService(ctx)
+// import "google.golang.org/api/secretmanager/v1beta1"
+// ...
+// ctx := context.Background()
+// secretmanagerService, err := secretmanager.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// secretmanagerService, err := secretmanager.NewService(ctx, option.WithAPIKey("AIza..."))
+// secretmanagerService, err := secretmanager.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// secretmanagerService, err := secretmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// secretmanagerService, err := secretmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package secretmanager // import "google.golang.org/api/secretmanager/v1beta1"
@@ -370,16 +370,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1285,8 +1289,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1494,8 +1498,8 @@ type ProjectsSecretsAddVersionCall struct {
// AddVersion: Creates a new SecretVersion containing secret data and
// attaches it to an existing Secret.
//
-// - parent: The resource name of the Secret to associate with the
-// SecretVersion in the format `projects/*/secrets/*`.
+// - parent: The resource name of the Secret to associate with the
+// SecretVersion in the format `projects/*/secrets/*`.
func (r *ProjectsSecretsService) AddVersion(parent string, addsecretversionrequest *AddSecretVersionRequest) *ProjectsSecretsAddVersionCall {
c := &ProjectsSecretsAddVersionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1637,8 +1641,8 @@ type ProjectsSecretsCreateCall struct {
// Create: Creates a new Secret containing no SecretVersions.
//
-// - parent: The resource name of the project to associate with the
-// Secret, in the format `projects/*`.
+// - parent: The resource name of the project to associate with the
+// Secret, in the format `projects/*`.
func (r *ProjectsSecretsService) Create(parent string, secret *Secret) *ProjectsSecretsCreateCall {
c := &ProjectsSecretsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1794,8 +1798,8 @@ type ProjectsSecretsDeleteCall struct {
// Delete: Deletes a Secret.
//
-// - name: The resource name of the Secret to delete in the format
-// `projects/*/secrets/*`.
+// - name: The resource name of the Secret to delete in the format
+// `projects/*/secrets/*`.
func (r *ProjectsSecretsService) Delete(name string) *ProjectsSecretsDeleteCall {
c := &ProjectsSecretsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1928,8 +1932,8 @@ type ProjectsSecretsGetCall struct {
// Get: Gets metadata for a given Secret.
//
-// - name: The resource name of the Secret, in the format
-// `projects/*/secrets/*`.
+// - name: The resource name of the Secret, in the format
+// `projects/*/secrets/*`.
func (r *ProjectsSecretsService) Get(name string) *ProjectsSecretsGetCall {
c := &ProjectsSecretsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2076,10 +2080,10 @@ type ProjectsSecretsGetIamPolicyCall struct {
// GetIamPolicy: Gets the access control policy for a secret. Returns
// empty policy if the secret exists and does not have a policy set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSecretsService) GetIamPolicy(resource string) *ProjectsSecretsGetIamPolicyCall {
c := &ProjectsSecretsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2249,8 +2253,8 @@ type ProjectsSecretsListCall struct {
// List: Lists Secrets.
//
-// - parent: The resource name of the project associated with the
-// Secrets, in the format `projects/*`.
+// - parent: The resource name of the project associated with the
+// Secrets, in the format `projects/*`.
func (r *ProjectsSecretsService) List(parent string) *ProjectsSecretsListCall {
c := &ProjectsSecretsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2444,8 +2448,8 @@ type ProjectsSecretsPatchCall struct {
// Patch: Updates metadata of an existing Secret.
//
-// - name: Output only. The resource name of the Secret in the format
-// `projects/*/secrets/*`.
+// - name: Output only. The resource name of the Secret in the format
+// `projects/*/secrets/*`.
func (r *ProjectsSecretsService) Patch(name string, secret *Secret) *ProjectsSecretsPatchCall {
c := &ProjectsSecretsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2602,10 +2606,10 @@ type ProjectsSecretsSetIamPolicyCall struct {
// Replaces any existing policy. Permissions on SecretVersions are
// enforced according to the policy set on the associated Secret.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSecretsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsSecretsSetIamPolicyCall {
c := &ProjectsSecretsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2752,10 +2756,10 @@ type ProjectsSecretsTestIamPermissionsCall struct {
// command-line tools, not for authorization checking. This operation
// may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsSecretsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsSecretsTestIamPermissionsCall {
c := &ProjectsSecretsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2899,8 +2903,8 @@ type ProjectsSecretsVersionsAccessCall struct {
// `projects/*/secrets/*/versions/latest` is an alias to the `latest`
// SecretVersion.
//
-// - name: The resource name of the SecretVersion in the format
-// `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion in the format
+// `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Access(name string) *ProjectsSecretsVersionsAccessCall {
c := &ProjectsSecretsVersionsAccessCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3047,8 +3051,8 @@ type ProjectsSecretsVersionsDestroyCall struct {
// Destroy: Destroys a SecretVersion. Sets the state of the
// SecretVersion to DESTROYED and irrevocably destroys the secret data.
//
-// - name: The resource name of the SecretVersion to destroy in the
-// format `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion to destroy in the
+// format `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Destroy(name string, destroysecretversionrequest *DestroySecretVersionRequest) *ProjectsSecretsVersionsDestroyCall {
c := &ProjectsSecretsVersionsDestroyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3191,8 +3195,8 @@ type ProjectsSecretsVersionsDisableCall struct {
// Disable: Disables a SecretVersion. Sets the state of the
// SecretVersion to DISABLED.
//
-// - name: The resource name of the SecretVersion to disable in the
-// format `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion to disable in the
+// format `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Disable(name string, disablesecretversionrequest *DisableSecretVersionRequest) *ProjectsSecretsVersionsDisableCall {
c := &ProjectsSecretsVersionsDisableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3335,8 +3339,8 @@ type ProjectsSecretsVersionsEnableCall struct {
// Enable: Enables a SecretVersion. Sets the state of the SecretVersion
// to ENABLED.
//
-// - name: The resource name of the SecretVersion to enable in the
-// format `projects/*/secrets/*/versions/*`.
+// - name: The resource name of the SecretVersion to enable in the
+// format `projects/*/secrets/*/versions/*`.
func (r *ProjectsSecretsVersionsService) Enable(name string, enablesecretversionrequest *EnableSecretVersionRequest) *ProjectsSecretsVersionsEnableCall {
c := &ProjectsSecretsVersionsEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3480,10 +3484,10 @@ type ProjectsSecretsVersionsGetCall struct {
// `projects/*/secrets/*/versions/latest` is an alias to the `latest`
// SecretVersion.
//
-// - name: The resource name of the SecretVersion in the format
-// `projects/*/secrets/*/versions/*`.
-// `projects/*/secrets/*/versions/latest` is an alias to the `latest`
-// SecretVersion.
+// - name: The resource name of the SecretVersion in the format
+// `projects/*/secrets/*/versions/*`.
+// `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+// SecretVersion.
func (r *ProjectsSecretsVersionsService) Get(name string) *ProjectsSecretsVersionsGetCall {
c := &ProjectsSecretsVersionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3629,8 +3633,8 @@ type ProjectsSecretsVersionsListCall struct {
// List: Lists SecretVersions. This call does not return secret data.
//
-// - parent: The resource name of the Secret associated with the
-// SecretVersions to list, in the format `projects/*/secrets/*`.
+// - parent: The resource name of the Secret associated with the
+// SecretVersions to list, in the format `projects/*/secrets/*`.
func (r *ProjectsSecretsVersionsService) List(parent string) *ProjectsSecretsVersionsListCall {
c := &ProjectsSecretsVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/securitycenter/v1/securitycenter-api.json b/securitycenter/v1/securitycenter-api.json
index ed04cad30b1..bf4e1d97e0b 100644
--- a/securitycenter/v1/securitycenter-api.json
+++ b/securitycenter/v1/securitycenter-api.json
@@ -3058,7 +3058,7 @@
}
}
},
- "revision": "20220720",
+ "revision": "20220817",
"rootUrl": "https://securitycenter.googleapis.com/",
"schemas": {
"Access": {
@@ -3078,7 +3078,22 @@
"type": "string"
},
"principalEmail": {
- "description": "Associated email, such as \"foo@google.com\".",
+ "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
+ "type": "string"
+ },
+ "principalSubject": {
+ "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "type": "string"
+ },
+ "serviceAccountDelegationInfo": {
+ "description": "Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
+ "items": {
+ "$ref": "ServiceAccountDelegationInfo"
+ },
+ "type": "array"
+ },
+ "serviceAccountKeyName": {
+ "description": "The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\" ",
"type": "string"
},
"serviceName": {
@@ -3263,7 +3278,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
@@ -3571,6 +3586,36 @@
},
"type": "object"
},
+ "Database": {
+ "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.",
+ "id": "Database",
+ "properties": {
+ "displayName": {
+ "description": "The human readable name of the database the user connected to.",
+ "type": "string"
+ },
+ "grantees": {
+ "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "name": {
+ "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)",
+ "type": "string"
+ },
+ "query": {
+ "description": "The SQL statement associated with the relevant access.",
+ "type": "string"
+ },
+ "userName": {
+ "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"Detection": {
"description": "Memory hash detection contributing to the binary family match.",
"id": "Detection",
@@ -3753,6 +3798,10 @@
"format": "google-datetime",
"type": "string"
},
+ "database": {
+ "$ref": "Database",
+ "description": "Database associated with the finding."
+ },
"description": {
"description": "Contains more detail about the finding.",
"type": "string"
@@ -5024,7 +5073,9 @@
"DATA_DESTRUCTION",
"DOMAIN_POLICY_MODIFICATION",
"IMPAIR_DEFENSES",
- "NETWORK_SERVICE_DISCOVERY"
+ "NETWORK_SERVICE_DISCOVERY",
+ "ACCESS_TOKEN_MANIPULATION",
+ "ABUSE_ELEVATION_CONTROL_MECHANISM"
],
"enumDescriptions": [
"Unspecified value.",
@@ -5059,7 +5110,9 @@
"T1485",
"T1484",
"T1562",
- "T1046"
+ "T1046",
+ "T1134",
+ "T1548"
],
"type": "string"
},
@@ -5139,7 +5192,9 @@
"DATA_DESTRUCTION",
"DOMAIN_POLICY_MODIFICATION",
"IMPAIR_DEFENSES",
- "NETWORK_SERVICE_DISCOVERY"
+ "NETWORK_SERVICE_DISCOVERY",
+ "ACCESS_TOKEN_MANIPULATION",
+ "ABUSE_ELEVATION_CONTROL_MECHANISM"
],
"enumDescriptions": [
"Unspecified value.",
@@ -5174,7 +5229,9 @@
"T1485",
"T1484",
"T1562",
- "T1046"
+ "T1046",
+ "T1134",
+ "T1548"
],
"type": "string"
},
@@ -5594,6 +5651,21 @@
},
"type": "object"
},
+ "ServiceAccountDelegationInfo": {
+ "description": "Identity delegation history of an authenticated service account.",
+ "id": "ServiceAccountDelegationInfo",
+ "properties": {
+ "principalEmail": {
+ "description": "The email address of a Google account. .",
+ "type": "string"
+ },
+ "principalSubject": {
+ "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"SetFindingStateRequest": {
"description": "Request message for updating a finding's state.",
"id": "SetFindingStateRequest",
diff --git a/securitycenter/v1/securitycenter-gen.go b/securitycenter/v1/securitycenter-gen.go
index 18555f41e5d..d77d9718b5c 100644
--- a/securitycenter/v1/securitycenter-gen.go
+++ b/securitycenter/v1/securitycenter-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/security-command-center
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/securitycenter/v1"
-// ...
-// ctx := context.Background()
-// securitycenterService, err := securitycenter.NewService(ctx)
+// import "google.golang.org/api/securitycenter/v1"
+// ...
+// ctx := context.Background()
+// securitycenterService, err := securitycenter.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package securitycenter // import "google.golang.org/api/securitycenter/v1"
@@ -459,9 +459,41 @@ type Access struct {
// "SetIamPolicy".
MethodName string `json:"methodName,omitempty"`
- // PrincipalEmail: Associated email, such as "foo@google.com".
+ // PrincipalEmail: Associated email, such as "foo@google.com". The email
+ // address of the authenticated user (or service account on behalf of
+ // third party principal) making the request. For third party identity
+ // callers, the `principal_subject` field is populated instead of this
+ // field. For privacy reasons, the principal email address is sometimes
+ // redacted. For more information, see Caller identities in audit logs
+ // (https://cloud.google.com/logging/docs/audit#user-id).
PrincipalEmail string `json:"principalEmail,omitempty"`
+ // PrincipalSubject: A string representing the principal_subject
+ // associated with the identity. As compared to `principal_email`,
+ // supports principals that aren't associated with email addresses, such
+ // as third party principals. For most identities, the format will be
+ // `principal://iam.googleapis.com/{identity pool
+ // name}/subject/{subject)` except for some GKE identities
+ // (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the
+ // legacy format `serviceAccount:{identity pool name}[{subject}]`
+ PrincipalSubject string `json:"principalSubject,omitempty"`
+
+ // ServiceAccountDelegationInfo: Identity delegation history of an
+ // authenticated service account that makes the request. It contains
+ // information on the real authorities that try to access GCP resources
+ // by delegating on a service account. When multiple authorities are
+ // present, they are guaranteed to be sorted based on the original
+ // ordering of the identity delegation events.
+ ServiceAccountDelegationInfo []*ServiceAccountDelegationInfo `json:"serviceAccountDelegationInfo,omitempty"`
+
+ // ServiceAccountKeyName: The name of the service account key used to
+ // create or exchange credentials for authenticating the service account
+ // making the request. This is a scheme-less URI full resource name. For
+ // example:
+ // "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/
+ // keys/{key}"
+ ServiceAccountKeyName string `json:"serviceAccountKeyName,omitempty"`
+
// ServiceName: This is the API service that the service account made a
// call to, e.g. "iam.googleapis.com"
ServiceName string `json:"serviceName,omitempty"`
@@ -777,16 +809,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1256,6 +1292,57 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error {
return nil
}
+// Database: Represents database access information, such as queries. A
+// database may be a sub-resource of an instance (as in the case of
+// CloudSQL instances or Cloud Spanner instances), or the database
+// instance itself. Some database resources may not have the full
+// resource name populated because these resource types are not yet
+// supported by Cloud Asset Inventory (e.g. CloudSQL databases). In
+// these cases only the display name will be provided.
+type Database struct {
+ // DisplayName: The human readable name of the database the user
+ // connected to.
+ DisplayName string `json:"displayName,omitempty"`
+
+ // Grantees: The target usernames/roles/groups of a SQL privilege grant
+ // (not an IAM policy change).
+ Grantees []string `json:"grantees,omitempty"`
+
+ // Name: The full resource name of the database the user connected to,
+ // if it is supported by CAI.
+ // (https://google.aip.dev/122#full-resource-names)
+ Name string `json:"name,omitempty"`
+
+ // Query: The SQL statement associated with the relevant access.
+ Query string `json:"query,omitempty"`
+
+ // UserName: The username used to connect to the DB. This may not
+ // necessarily be an IAM principal, and has no required format.
+ UserName string `json:"userName,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "DisplayName") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DisplayName") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *Database) MarshalJSON() ([]byte, error) {
+ type NoMethod Database
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// Detection: Memory hash detection contributing to the binary family
// match.
type Detection struct {
@@ -1580,6 +1667,9 @@ type Finding struct {
// Command Center.
CreateTime string `json:"createTime,omitempty"`
+ // Database: Database associated with the finding.
+ Database *Database `json:"database,omitempty"`
+
// Description: Contains more detail about the finding.
Description string `json:"description,omitempty"`
@@ -3666,6 +3756,8 @@ type MitreAttack struct {
// "DOMAIN_POLICY_MODIFICATION" - T1484
// "IMPAIR_DEFENSES" - T1562
// "NETWORK_SERVICE_DISCOVERY" - T1046
+ // "ACCESS_TOKEN_MANIPULATION" - T1134
+ // "ABUSE_ELEVATION_CONTROL_MECHANISM" - T1548
AdditionalTechniques []string `json:"additionalTechniques,omitempty"`
// PrimaryTactic: The MITRE ATT&CK tactic most closely represented by
@@ -3731,6 +3823,8 @@ type MitreAttack struct {
// "DOMAIN_POLICY_MODIFICATION" - T1484
// "IMPAIR_DEFENSES" - T1562
// "NETWORK_SERVICE_DISCOVERY" - T1046
+ // "ACCESS_TOKEN_MANIPULATION" - T1134
+ // "ABUSE_ELEVATION_CONTROL_MECHANISM" - T1548
PrimaryTechniques []string `json:"primaryTechniques,omitempty"`
// Version: The MITRE ATT&CK version referenced by the above fields.
@@ -4485,6 +4579,46 @@ func (s *SecurityMarks) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// ServiceAccountDelegationInfo: Identity delegation history of an
+// authenticated service account.
+type ServiceAccountDelegationInfo struct {
+ // PrincipalEmail: The email address of a Google account. .
+ PrincipalEmail string `json:"principalEmail,omitempty"`
+
+ // PrincipalSubject: A string representing the principal_subject
+ // associated with the identity. As compared to `principal_email`,
+ // supports principals that aren't associated with email addresses, such
+ // as third party principals. For most identities, the format will be
+ // `principal://iam.googleapis.com/{identity pool
+ // name}/subject/{subject)` except for some GKE identities
+ // (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the
+ // legacy format `serviceAccount:{identity pool name}[{subject}]`
+ PrincipalSubject string `json:"principalSubject,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "PrincipalEmail") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "PrincipalEmail") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *ServiceAccountDelegationInfo) MarshalJSON() ([]byte, error) {
+ type NoMethod ServiceAccountDelegationInfo
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// SetFindingStateRequest: Request message for updating a finding's
// state.
type SetFindingStateRequest struct {
@@ -4917,9 +5051,9 @@ type FoldersAssetsGroupCall struct {
// Group: Filters an organization's assets and groups them by their
// specified properties.
//
-// - parent: Name of the organization to groupBy. Its format is
-// "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Name of the organization to groupBy. Its format is
+// "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *FoldersAssetsService) Group(parent string, groupassetsrequest *GroupAssetsRequest) *FoldersAssetsGroupCall {
c := &FoldersAssetsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5082,9 +5216,9 @@ type FoldersAssetsListCall struct {
// List: Lists an organization's assets.
//
-// - parent: Name of the organization assets should belong to. Its
-// format is "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Name of the organization assets should belong to. Its
+// format is "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *FoldersAssetsService) List(parent string) *FoldersAssetsListCall {
c := &FoldersAssetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5413,12 +5547,12 @@ type FoldersAssetsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *FoldersAssetsService) UpdateSecurityMarks(name string, securitymarks *SecurityMarks) *FoldersAssetsUpdateSecurityMarksCall {
c := &FoldersAssetsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5591,9 +5725,9 @@ type FoldersBigQueryExportsCreateCall struct {
// Create: Creates a big query export.
//
-// - parent: Resource name of the new big query export's parent. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// or "projects/[project_id]".
+// - parent: Resource name of the new big query export's parent. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// or "projects/[project_id]".
func (r *FoldersBigQueryExportsService) Create(parent string, googlecloudsecuritycenterv1bigqueryexport *GoogleCloudSecuritycenterV1BigQueryExport) *FoldersBigQueryExportsCreateCall {
c := &FoldersBigQueryExportsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5751,10 +5885,10 @@ type FoldersBigQueryExportsDeleteCall struct {
// Delete: Deletes an existing big query export.
//
-// - name: Name of the big query export to delete. Its format is
-// organizations/{organization}/bigQueryExports/{export_id},
-// folders/{folder}/bigQueryExports/{export_id}, or
-// projects/{project}/bigQueryExports/{export_id}.
+// - name: Name of the big query export to delete. Its format is
+// organizations/{organization}/bigQueryExports/{export_id},
+// folders/{folder}/bigQueryExports/{export_id}, or
+// projects/{project}/bigQueryExports/{export_id}.
func (r *FoldersBigQueryExportsService) Delete(name string) *FoldersBigQueryExportsDeleteCall {
c := &FoldersBigQueryExportsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5887,10 +6021,10 @@ type FoldersBigQueryExportsGetCall struct {
// Get: Gets a big query export.
//
-// - name: Name of the big query export to retrieve. Its format is
-// organizations/{organization}/bigQueryExports/{export_id},
-// folders/{folder}/bigQueryExports/{export_id}, or
-// projects/{project}/bigQueryExports/{export_id}.
+// - name: Name of the big query export to retrieve. Its format is
+// organizations/{organization}/bigQueryExports/{export_id},
+// folders/{folder}/bigQueryExports/{export_id}, or
+// projects/{project}/bigQueryExports/{export_id}.
func (r *FoldersBigQueryExportsService) Get(name string) *FoldersBigQueryExportsGetCall {
c := &FoldersBigQueryExportsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6042,9 +6176,9 @@ type FoldersBigQueryExportsListCall struct {
// BigQuery exports immediately under the folder plus the ones created
// under the projects within the folder are returned.
//
-// - parent: The parent, which owns the collection of BigQuery exports.
-// Its format is "organizations/[organization_id]",
-// "folders/[folder_id]", "projects/[project_id]".
+// - parent: The parent, which owns the collection of BigQuery exports.
+// Its format is "organizations/[organization_id]",
+// "folders/[folder_id]", "projects/[project_id]".
func (r *FoldersBigQueryExportsService) List(parent string) *FoldersBigQueryExportsListCall {
c := &FoldersBigQueryExportsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6241,14 +6375,14 @@ type FoldersBigQueryExportsPatchCall struct {
// Patch: Updates a BigQuery export.
//
-// - name: The relative resource name of this export. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name.
-// Example format:
-// "organizations/{organization_id}/bigQueryExports/{export_id}"
-// Example format: "folders/{folder_id}/bigQueryExports/{export_id}"
-// Example format: "projects/{project_id}/bigQueryExports/{export_id}"
-// This field is provided in responses, and is ignored when provided
-// in create requests.
+// - name: The relative resource name of this export. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name.
+// Example format:
+// "organizations/{organization_id}/bigQueryExports/{export_id}"
+// Example format: "folders/{folder_id}/bigQueryExports/{export_id}"
+// Example format: "projects/{project_id}/bigQueryExports/{export_id}"
+// This field is provided in responses, and is ignored when provided
+// in create requests.
func (r *FoldersBigQueryExportsService) Patch(name string, googlecloudsecuritycenterv1bigqueryexport *GoogleCloudSecuritycenterV1BigQueryExport) *FoldersBigQueryExportsPatchCall {
c := &FoldersBigQueryExportsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6408,9 +6542,9 @@ type FoldersFindingsBulkMuteCall struct {
// project. The findings matched by the filter will be muted after the
// LRO is done.
//
-// - parent: The parent, at which bulk action needs to be applied. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// "projects/[project_id]".
+// - parent: The parent, at which bulk action needs to be applied. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// "projects/[project_id]".
func (r *FoldersFindingsService) BulkMute(parent string, bulkmutefindingsrequest *BulkMuteFindingsRequest) *FoldersFindingsBulkMuteCall {
c := &FoldersFindingsBulkMuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6552,9 +6686,9 @@ type FoldersMuteConfigsCreateCall struct {
// Create: Creates a mute config.
//
-// - parent: Resource name of the new mute configs's parent. Its format
-// is "organizations/[organization_id]", "folders/[folder_id]", or
-// "projects/[project_id]".
+// - parent: Resource name of the new mute configs's parent. Its format
+// is "organizations/[organization_id]", "folders/[folder_id]", or
+// "projects/[project_id]".
func (r *FoldersMuteConfigsService) Create(parent string, googlecloudsecuritycenterv1muteconfig *GoogleCloudSecuritycenterV1MuteConfig) *FoldersMuteConfigsCreateCall {
c := &FoldersMuteConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6711,10 +6845,10 @@ type FoldersMuteConfigsDeleteCall struct {
// Delete: Deletes an existing mute config.
//
-// - name: Name of the mute config to delete. Its format is
-// organizations/{organization}/muteConfigs/{config_id},
-// folders/{folder}/muteConfigs/{config_id}, or
-// projects/{project}/muteConfigs/{config_id}.
+// - name: Name of the mute config to delete. Its format is
+// organizations/{organization}/muteConfigs/{config_id},
+// folders/{folder}/muteConfigs/{config_id}, or
+// projects/{project}/muteConfigs/{config_id}.
func (r *FoldersMuteConfigsService) Delete(name string) *FoldersMuteConfigsDeleteCall {
c := &FoldersMuteConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6847,10 +6981,10 @@ type FoldersMuteConfigsGetCall struct {
// Get: Gets a mute config.
//
-// - name: Name of the mute config to retrieve. Its format is
-// organizations/{organization}/muteConfigs/{config_id},
-// folders/{folder}/muteConfigs/{config_id}, or
-// projects/{project}/muteConfigs/{config_id}.
+// - name: Name of the mute config to retrieve. Its format is
+// organizations/{organization}/muteConfigs/{config_id},
+// folders/{folder}/muteConfigs/{config_id}, or
+// projects/{project}/muteConfigs/{config_id}.
func (r *FoldersMuteConfigsService) Get(name string) *FoldersMuteConfigsGetCall {
c := &FoldersMuteConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6997,9 +7131,9 @@ type FoldersMuteConfigsListCall struct {
// List: Lists mute configs.
//
-// - parent: The parent, which owns the collection of mute configs. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// "projects/[project_id]".
+// - parent: The parent, which owns the collection of mute configs. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// "projects/[project_id]".
func (r *FoldersMuteConfigsService) List(parent string) *FoldersMuteConfigsListCall {
c := &FoldersMuteConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7196,10 +7330,10 @@ type FoldersMuteConfigsPatchCall struct {
// Patch: Updates a mute config.
//
-// - name: This field will be ignored if provided on config creation.
-// Format "organizations/{organization}/muteConfigs/{mute_config}"
-// "folders/{folder}/muteConfigs/{mute_config}"
-// "projects/{project}/muteConfigs/{mute_config}".
+// - name: This field will be ignored if provided on config creation.
+// Format "organizations/{organization}/muteConfigs/{mute_config}"
+// "folders/{folder}/muteConfigs/{mute_config}"
+// "projects/{project}/muteConfigs/{mute_config}".
func (r *FoldersMuteConfigsService) Patch(name string, googlecloudsecuritycenterv1muteconfig *GoogleCloudSecuritycenterV1MuteConfig) *FoldersMuteConfigsPatchCall {
c := &FoldersMuteConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7355,9 +7489,9 @@ type FoldersSourcesListCall struct {
// List: Lists all sources belonging to an organization.
//
-// - parent: Resource name of the parent of sources to list. Its format
-// should be "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Resource name of the parent of sources to list. Its format
+// should be "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *FoldersSourcesService) List(parent string) *FoldersSourcesListCall {
c := &FoldersSourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7557,13 +7691,13 @@ type FoldersSourcesFindingsGroupCall struct {
// /v1/folders/{folder_id}/sources/-/findings,
// /v1/projects/{project_id}/sources/-/findings
//
-// - parent: Name of the source to groupBy. Its format is
-// "organizations/[organization_id]/sources/[source_id]",
-// folders/[folder_id]/sources/[source_id], or
-// projects/[project_id]/sources/[source_id]. To groupBy across all
-// sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-,
-// folders/{folder_id}/sources/-, or projects/{project_id}/sources/-.
+// - parent: Name of the source to groupBy. Its format is
+// "organizations/[organization_id]/sources/[source_id]",
+// folders/[folder_id]/sources/[source_id], or
+// projects/[project_id]/sources/[source_id]. To groupBy across all
+// sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-,
+// folders/{folder_id}/sources/-, or projects/{project_id}/sources/-.
func (r *FoldersSourcesFindingsService) Group(parent string, groupfindingsrequest *GroupFindingsRequest) *FoldersSourcesFindingsGroupCall {
c := &FoldersSourcesFindingsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7728,13 +7862,13 @@ type FoldersSourcesFindingsListCall struct {
// sources provide a `-` as the source id. Example:
// /v1/organizations/{organization_id}/sources/-/findings
//
-// - parent: Name of the source the findings belong to. Its format is
-// "organizations/[organization_id]/sources/[source_id],
-// folders/[folder_id]/sources/[source_id], or
-// projects/[project_id]/sources/[source_id]". To list across all
-// sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-,
-// folders/{folder_id}/sources/- or projects/{projects_id}/sources/-.
+// - parent: Name of the source the findings belong to. Its format is
+// "organizations/[organization_id]/sources/[source_id],
+// folders/[folder_id]/sources/[source_id], or
+// projects/[project_id]/sources/[source_id]". To list across all
+// sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-,
+// folders/{folder_id}/sources/- or projects/{projects_id}/sources/-.
func (r *FoldersSourcesFindingsService) List(parent string) *FoldersSourcesFindingsListCall {
c := &FoldersSourcesFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8055,11 +8189,11 @@ type FoldersSourcesFindingsPatchCall struct {
// Patch: Creates or updates a finding. The corresponding source must
// exist for a finding creation to succeed.
//
-// - name: The relative resource name of this finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}".
+// - name: The relative resource name of this finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}".
func (r *FoldersSourcesFindingsService) Patch(name string, finding *Finding) *FoldersSourcesFindingsPatchCall {
c := &FoldersSourcesFindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8218,13 +8352,13 @@ type FoldersSourcesFindingsSetMuteCall struct {
// SetMute: Updates the mute state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}",
-// "folders/{folder_id}/sources/{source_id}/finding/{finding_id}",
-// "projects/{project_id}/sources/{source_id}/finding/{finding_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}",
+// "folders/{folder_id}/sources/{source_id}/finding/{finding_id}",
+// "projects/{project_id}/sources/{source_id}/finding/{finding_id}".
func (r *FoldersSourcesFindingsService) SetMute(name string, setmuterequest *SetMuteRequest) *FoldersSourcesFindingsSetMuteCall {
c := &FoldersSourcesFindingsSetMuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8366,11 +8500,11 @@ type FoldersSourcesFindingsSetStateCall struct {
// SetState: Updates the state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}".
func (r *FoldersSourcesFindingsService) SetState(name string, setfindingstaterequest *SetFindingStateRequest) *FoldersSourcesFindingsSetStateCall {
c := &FoldersSourcesFindingsSetStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8512,12 +8646,12 @@ type FoldersSourcesFindingsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *FoldersSourcesFindingsService) UpdateSecurityMarks(name string, securitymarks *SecurityMarks) *FoldersSourcesFindingsUpdateSecurityMarksCall {
c := &FoldersSourcesFindingsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8690,10 +8824,10 @@ type FoldersSourcesFindingsExternalSystemsPatchCall struct {
// Patch: Updates external system. This is for a given finding.
//
-// - name: External System Name e.g. jira, demisto, etc. e.g.:
-// `organizations/1234/sources/5678/findings/123456/externalSystems/jir
-// a` `folders/1234/sources/5678/findings/123456/externalSystems/jira`
-// `projects/1234/sources/5678/findings/123456/externalSystems/jira`.
+// - name: External System Name e.g. jira, demisto, etc. e.g.:
+// `organizations/1234/sources/5678/findings/123456/externalSystems/jir
+// a` `folders/1234/sources/5678/findings/123456/externalSystems/jira`
+// `projects/1234/sources/5678/findings/123456/externalSystems/jira`.
func (r *FoldersSourcesFindingsExternalSystemsService) Patch(name string, googlecloudsecuritycenterv1externalsystem *GoogleCloudSecuritycenterV1ExternalSystem) *FoldersSourcesFindingsExternalSystemsPatchCall {
c := &FoldersSourcesFindingsExternalSystemsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8851,9 +8985,9 @@ type OrganizationsGetOrganizationSettingsCall struct {
// GetOrganizationSettings: Gets the settings for an organization.
//
-// - name: Name of the organization to get organization settings for.
-// Its format is
-// "organizations/[organization_id]/organizationSettings".
+// - name: Name of the organization to get organization settings for.
+// Its format is
+// "organizations/[organization_id]/organizationSettings".
func (r *OrganizationsService) GetOrganizationSettings(name string) *OrganizationsGetOrganizationSettingsCall {
c := &OrganizationsGetOrganizationSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8999,9 +9133,9 @@ type OrganizationsUpdateOrganizationSettingsCall struct {
// UpdateOrganizationSettings: Updates an organization's settings.
//
-// - name: The relative resource name of the settings. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example: "organizations/{organization_id}/organizationSettings".
+// - name: The relative resource name of the settings. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example: "organizations/{organization_id}/organizationSettings".
func (r *OrganizationsService) UpdateOrganizationSettings(name string, organizationsettings *OrganizationSettings) *OrganizationsUpdateOrganizationSettingsCall {
c := &OrganizationsUpdateOrganizationSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9158,9 +9292,9 @@ type OrganizationsAssetsGroupCall struct {
// Group: Filters an organization's assets and groups them by their
// specified properties.
//
-// - parent: Name of the organization to groupBy. Its format is
-// "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Name of the organization to groupBy. Its format is
+// "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *OrganizationsAssetsService) Group(parent string, groupassetsrequest *GroupAssetsRequest) *OrganizationsAssetsGroupCall {
c := &OrganizationsAssetsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9323,9 +9457,9 @@ type OrganizationsAssetsListCall struct {
// List: Lists an organization's assets.
//
-// - parent: Name of the organization assets should belong to. Its
-// format is "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Name of the organization assets should belong to. Its
+// format is "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *OrganizationsAssetsService) List(parent string) *OrganizationsAssetsListCall {
c := &OrganizationsAssetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9657,8 +9791,8 @@ type OrganizationsAssetsRunDiscoveryCall struct {
// frequency for an organization. If it is called too frequently the
// caller will receive a TOO_MANY_REQUESTS error.
//
-// - parent: Name of the organization to run asset discovery for. Its
-// format is "organizations/[organization_id]".
+// - parent: Name of the organization to run asset discovery for. Its
+// format is "organizations/[organization_id]".
func (r *OrganizationsAssetsService) RunDiscovery(parent string, runassetdiscoveryrequest *RunAssetDiscoveryRequest) *OrganizationsAssetsRunDiscoveryCall {
c := &OrganizationsAssetsRunDiscoveryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9800,12 +9934,12 @@ type OrganizationsAssetsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *OrganizationsAssetsService) UpdateSecurityMarks(name string, securitymarks *SecurityMarks) *OrganizationsAssetsUpdateSecurityMarksCall {
c := &OrganizationsAssetsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9978,9 +10112,9 @@ type OrganizationsBigQueryExportsCreateCall struct {
// Create: Creates a big query export.
//
-// - parent: Resource name of the new big query export's parent. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// or "projects/[project_id]".
+// - parent: Resource name of the new big query export's parent. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// or "projects/[project_id]".
func (r *OrganizationsBigQueryExportsService) Create(parent string, googlecloudsecuritycenterv1bigqueryexport *GoogleCloudSecuritycenterV1BigQueryExport) *OrganizationsBigQueryExportsCreateCall {
c := &OrganizationsBigQueryExportsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10138,10 +10272,10 @@ type OrganizationsBigQueryExportsDeleteCall struct {
// Delete: Deletes an existing big query export.
//
-// - name: Name of the big query export to delete. Its format is
-// organizations/{organization}/bigQueryExports/{export_id},
-// folders/{folder}/bigQueryExports/{export_id}, or
-// projects/{project}/bigQueryExports/{export_id}.
+// - name: Name of the big query export to delete. Its format is
+// organizations/{organization}/bigQueryExports/{export_id},
+// folders/{folder}/bigQueryExports/{export_id}, or
+// projects/{project}/bigQueryExports/{export_id}.
func (r *OrganizationsBigQueryExportsService) Delete(name string) *OrganizationsBigQueryExportsDeleteCall {
c := &OrganizationsBigQueryExportsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10274,10 +10408,10 @@ type OrganizationsBigQueryExportsGetCall struct {
// Get: Gets a big query export.
//
-// - name: Name of the big query export to retrieve. Its format is
-// organizations/{organization}/bigQueryExports/{export_id},
-// folders/{folder}/bigQueryExports/{export_id}, or
-// projects/{project}/bigQueryExports/{export_id}.
+// - name: Name of the big query export to retrieve. Its format is
+// organizations/{organization}/bigQueryExports/{export_id},
+// folders/{folder}/bigQueryExports/{export_id}, or
+// projects/{project}/bigQueryExports/{export_id}.
func (r *OrganizationsBigQueryExportsService) Get(name string) *OrganizationsBigQueryExportsGetCall {
c := &OrganizationsBigQueryExportsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10429,9 +10563,9 @@ type OrganizationsBigQueryExportsListCall struct {
// BigQuery exports immediately under the folder plus the ones created
// under the projects within the folder are returned.
//
-// - parent: The parent, which owns the collection of BigQuery exports.
-// Its format is "organizations/[organization_id]",
-// "folders/[folder_id]", "projects/[project_id]".
+// - parent: The parent, which owns the collection of BigQuery exports.
+// Its format is "organizations/[organization_id]",
+// "folders/[folder_id]", "projects/[project_id]".
func (r *OrganizationsBigQueryExportsService) List(parent string) *OrganizationsBigQueryExportsListCall {
c := &OrganizationsBigQueryExportsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10628,14 +10762,14 @@ type OrganizationsBigQueryExportsPatchCall struct {
// Patch: Updates a BigQuery export.
//
-// - name: The relative resource name of this export. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name.
-// Example format:
-// "organizations/{organization_id}/bigQueryExports/{export_id}"
-// Example format: "folders/{folder_id}/bigQueryExports/{export_id}"
-// Example format: "projects/{project_id}/bigQueryExports/{export_id}"
-// This field is provided in responses, and is ignored when provided
-// in create requests.
+// - name: The relative resource name of this export. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name.
+// Example format:
+// "organizations/{organization_id}/bigQueryExports/{export_id}"
+// Example format: "folders/{folder_id}/bigQueryExports/{export_id}"
+// Example format: "projects/{project_id}/bigQueryExports/{export_id}"
+// This field is provided in responses, and is ignored when provided
+// in create requests.
func (r *OrganizationsBigQueryExportsService) Patch(name string, googlecloudsecuritycenterv1bigqueryexport *GoogleCloudSecuritycenterV1BigQueryExport) *OrganizationsBigQueryExportsPatchCall {
c := &OrganizationsBigQueryExportsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10795,9 +10929,9 @@ type OrganizationsFindingsBulkMuteCall struct {
// project. The findings matched by the filter will be muted after the
// LRO is done.
//
-// - parent: The parent, at which bulk action needs to be applied. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// "projects/[project_id]".
+// - parent: The parent, at which bulk action needs to be applied. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// "projects/[project_id]".
func (r *OrganizationsFindingsService) BulkMute(parent string, bulkmutefindingsrequest *BulkMuteFindingsRequest) *OrganizationsFindingsBulkMuteCall {
c := &OrganizationsFindingsBulkMuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10939,9 +11073,9 @@ type OrganizationsMuteConfigsCreateCall struct {
// Create: Creates a mute config.
//
-// - parent: Resource name of the new mute configs's parent. Its format
-// is "organizations/[organization_id]", "folders/[folder_id]", or
-// "projects/[project_id]".
+// - parent: Resource name of the new mute configs's parent. Its format
+// is "organizations/[organization_id]", "folders/[folder_id]", or
+// "projects/[project_id]".
func (r *OrganizationsMuteConfigsService) Create(parent string, googlecloudsecuritycenterv1muteconfig *GoogleCloudSecuritycenterV1MuteConfig) *OrganizationsMuteConfigsCreateCall {
c := &OrganizationsMuteConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11098,10 +11232,10 @@ type OrganizationsMuteConfigsDeleteCall struct {
// Delete: Deletes an existing mute config.
//
-// - name: Name of the mute config to delete. Its format is
-// organizations/{organization}/muteConfigs/{config_id},
-// folders/{folder}/muteConfigs/{config_id}, or
-// projects/{project}/muteConfigs/{config_id}.
+// - name: Name of the mute config to delete. Its format is
+// organizations/{organization}/muteConfigs/{config_id},
+// folders/{folder}/muteConfigs/{config_id}, or
+// projects/{project}/muteConfigs/{config_id}.
func (r *OrganizationsMuteConfigsService) Delete(name string) *OrganizationsMuteConfigsDeleteCall {
c := &OrganizationsMuteConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11234,10 +11368,10 @@ type OrganizationsMuteConfigsGetCall struct {
// Get: Gets a mute config.
//
-// - name: Name of the mute config to retrieve. Its format is
-// organizations/{organization}/muteConfigs/{config_id},
-// folders/{folder}/muteConfigs/{config_id}, or
-// projects/{project}/muteConfigs/{config_id}.
+// - name: Name of the mute config to retrieve. Its format is
+// organizations/{organization}/muteConfigs/{config_id},
+// folders/{folder}/muteConfigs/{config_id}, or
+// projects/{project}/muteConfigs/{config_id}.
func (r *OrganizationsMuteConfigsService) Get(name string) *OrganizationsMuteConfigsGetCall {
c := &OrganizationsMuteConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11384,9 +11518,9 @@ type OrganizationsMuteConfigsListCall struct {
// List: Lists mute configs.
//
-// - parent: The parent, which owns the collection of mute configs. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// "projects/[project_id]".
+// - parent: The parent, which owns the collection of mute configs. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// "projects/[project_id]".
func (r *OrganizationsMuteConfigsService) List(parent string) *OrganizationsMuteConfigsListCall {
c := &OrganizationsMuteConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11583,10 +11717,10 @@ type OrganizationsMuteConfigsPatchCall struct {
// Patch: Updates a mute config.
//
-// - name: This field will be ignored if provided on config creation.
-// Format "organizations/{organization}/muteConfigs/{mute_config}"
-// "folders/{folder}/muteConfigs/{mute_config}"
-// "projects/{project}/muteConfigs/{mute_config}".
+// - name: This field will be ignored if provided on config creation.
+// Format "organizations/{organization}/muteConfigs/{mute_config}"
+// "folders/{folder}/muteConfigs/{mute_config}"
+// "projects/{project}/muteConfigs/{mute_config}".
func (r *OrganizationsMuteConfigsService) Patch(name string, googlecloudsecuritycenterv1muteconfig *GoogleCloudSecuritycenterV1MuteConfig) *OrganizationsMuteConfigsPatchCall {
c := &OrganizationsMuteConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11742,9 +11876,9 @@ type OrganizationsNotificationConfigsCreateCall struct {
// Create: Creates a notification config.
//
-// - parent: Resource name of the new notification config's parent. Its
-// format is "organizations/[organization_id]" or
-// "projects/[project_id]".
+// - parent: Resource name of the new notification config's parent. Its
+// format is "organizations/[organization_id]" or
+// "projects/[project_id]".
func (r *OrganizationsNotificationConfigsService) Create(parent string, notificationconfig *NotificationConfig) *OrganizationsNotificationConfigsCreateCall {
c := &OrganizationsNotificationConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11899,8 +12033,8 @@ type OrganizationsNotificationConfigsDeleteCall struct {
// Delete: Deletes a notification config.
//
-// - name: Name of the notification config to delete. Its format is
-// "organizations/[organization_id]/notificationConfigs/[config_id]".
+// - name: Name of the notification config to delete. Its format is
+// "organizations/[organization_id]/notificationConfigs/[config_id]".
func (r *OrganizationsNotificationConfigsService) Delete(name string) *OrganizationsNotificationConfigsDeleteCall {
c := &OrganizationsNotificationConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12033,8 +12167,8 @@ type OrganizationsNotificationConfigsGetCall struct {
// Get: Gets a notification config.
//
-// - name: Name of the notification config to get. Its format is
-// "organizations/[organization_id]/notificationConfigs/[config_id]".
+// - name: Name of the notification config to get. Its format is
+// "organizations/[organization_id]/notificationConfigs/[config_id]".
func (r *OrganizationsNotificationConfigsService) Get(name string) *OrganizationsNotificationConfigsGetCall {
c := &OrganizationsNotificationConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12180,9 +12314,9 @@ type OrganizationsNotificationConfigsListCall struct {
// List: Lists notification configs.
//
-// - parent: Name of the organization to list notification configs. Its
-// format is "organizations/[organization_id]" or
-// "projects/[project_id]".
+// - parent: Name of the organization to list notification configs. Its
+// format is "organizations/[organization_id]" or
+// "projects/[project_id]".
func (r *OrganizationsNotificationConfigsService) List(parent string) *OrganizationsNotificationConfigsListCall {
c := &OrganizationsNotificationConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12378,11 +12512,11 @@ type OrganizationsNotificationConfigsPatchCall struct {
// Patch: Updates a notification config. The following update fields
// are allowed: description, pubsub_topic, streaming_config.filter
//
-// - name: The relative resource name of this notification config. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/notificationConfigs/notify_public_b
-// ucket".
+// - name: The relative resource name of this notification config. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/notificationConfigs/notify_public_b
+// ucket".
func (r *OrganizationsNotificationConfigsService) Patch(name string, notificationconfig *NotificationConfig) *OrganizationsNotificationConfigsPatchCall {
c := &OrganizationsNotificationConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13175,8 +13309,8 @@ type OrganizationsSourcesCreateCall struct {
// Create: Creates a source.
//
-// - parent: Resource name of the new source's parent. Its format should
-// be "organizations/[organization_id]".
+// - parent: Resource name of the new source's parent. Its format should
+// be "organizations/[organization_id]".
func (r *OrganizationsSourcesService) Create(parent string, source *Source) *OrganizationsSourcesCreateCall {
c := &OrganizationsSourcesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13318,8 +13452,8 @@ type OrganizationsSourcesGetCall struct {
// Get: Gets a source.
//
-// - name: Relative resource name of the source. Its format is
-// "organizations/[organization_id]/source/[source_id]".
+// - name: Relative resource name of the source. Its format is
+// "organizations/[organization_id]/source/[source_id]".
func (r *OrganizationsSourcesService) Get(name string) *OrganizationsSourcesGetCall {
c := &OrganizationsSourcesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13465,10 +13599,10 @@ type OrganizationsSourcesGetIamPolicyCall struct {
// GetIamPolicy: Gets the access control policy on the specified Source.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *OrganizationsSourcesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *OrganizationsSourcesGetIamPolicyCall {
c := &OrganizationsSourcesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -13610,9 +13744,9 @@ type OrganizationsSourcesListCall struct {
// List: Lists all sources belonging to an organization.
//
-// - parent: Resource name of the parent of sources to list. Its format
-// should be "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Resource name of the parent of sources to list. Its format
+// should be "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *OrganizationsSourcesService) List(parent string) *OrganizationsSourcesListCall {
c := &OrganizationsSourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13807,9 +13941,9 @@ type OrganizationsSourcesPatchCall struct {
// Patch: Updates a source.
//
-// - name: The relative resource name of this source. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example: "organizations/{organization_id}/sources/{source_id}".
+// - name: The relative resource name of this source. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example: "organizations/{organization_id}/sources/{source_id}".
func (r *OrganizationsSourcesService) Patch(name string, source *Source) *OrganizationsSourcesPatchCall {
c := &OrganizationsSourcesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13965,10 +14099,10 @@ type OrganizationsSourcesSetIamPolicyCall struct {
// SetIamPolicy: Sets the access control policy on the specified Source.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *OrganizationsSourcesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *OrganizationsSourcesSetIamPolicyCall {
c := &OrganizationsSourcesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -14111,10 +14245,10 @@ type OrganizationsSourcesTestIamPermissionsCall struct {
// TestIamPermissions: Returns the permissions that a caller has on the
// specified source.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *OrganizationsSourcesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *OrganizationsSourcesTestIamPermissionsCall {
c := &OrganizationsSourcesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -14257,8 +14391,8 @@ type OrganizationsSourcesFindingsCreateCall struct {
// Create: Creates a finding. The corresponding source must exist for
// finding creation to succeed.
//
-// - parent: Resource name of the new finding's parent. Its format
-// should be "organizations/[organization_id]/sources/[source_id]".
+// - parent: Resource name of the new finding's parent. Its format
+// should be "organizations/[organization_id]/sources/[source_id]".
func (r *OrganizationsSourcesFindingsService) Create(parent string, finding *Finding) *OrganizationsSourcesFindingsCreateCall {
c := &OrganizationsSourcesFindingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14419,13 +14553,13 @@ type OrganizationsSourcesFindingsGroupCall struct {
// /v1/folders/{folder_id}/sources/-/findings,
// /v1/projects/{project_id}/sources/-/findings
//
-// - parent: Name of the source to groupBy. Its format is
-// "organizations/[organization_id]/sources/[source_id]",
-// folders/[folder_id]/sources/[source_id], or
-// projects/[project_id]/sources/[source_id]. To groupBy across all
-// sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-,
-// folders/{folder_id}/sources/-, or projects/{project_id}/sources/-.
+// - parent: Name of the source to groupBy. Its format is
+// "organizations/[organization_id]/sources/[source_id]",
+// folders/[folder_id]/sources/[source_id], or
+// projects/[project_id]/sources/[source_id]. To groupBy across all
+// sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-,
+// folders/{folder_id}/sources/-, or projects/{project_id}/sources/-.
func (r *OrganizationsSourcesFindingsService) Group(parent string, groupfindingsrequest *GroupFindingsRequest) *OrganizationsSourcesFindingsGroupCall {
c := &OrganizationsSourcesFindingsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14590,13 +14724,13 @@ type OrganizationsSourcesFindingsListCall struct {
// sources provide a `-` as the source id. Example:
// /v1/organizations/{organization_id}/sources/-/findings
//
-// - parent: Name of the source the findings belong to. Its format is
-// "organizations/[organization_id]/sources/[source_id],
-// folders/[folder_id]/sources/[source_id], or
-// projects/[project_id]/sources/[source_id]". To list across all
-// sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-,
-// folders/{folder_id}/sources/- or projects/{projects_id}/sources/-.
+// - parent: Name of the source the findings belong to. Its format is
+// "organizations/[organization_id]/sources/[source_id],
+// folders/[folder_id]/sources/[source_id], or
+// projects/[project_id]/sources/[source_id]". To list across all
+// sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-,
+// folders/{folder_id}/sources/- or projects/{projects_id}/sources/-.
func (r *OrganizationsSourcesFindingsService) List(parent string) *OrganizationsSourcesFindingsListCall {
c := &OrganizationsSourcesFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14917,11 +15051,11 @@ type OrganizationsSourcesFindingsPatchCall struct {
// Patch: Creates or updates a finding. The corresponding source must
// exist for a finding creation to succeed.
//
-// - name: The relative resource name of this finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}".
+// - name: The relative resource name of this finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}".
func (r *OrganizationsSourcesFindingsService) Patch(name string, finding *Finding) *OrganizationsSourcesFindingsPatchCall {
c := &OrganizationsSourcesFindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15080,13 +15214,13 @@ type OrganizationsSourcesFindingsSetMuteCall struct {
// SetMute: Updates the mute state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}",
-// "folders/{folder_id}/sources/{source_id}/finding/{finding_id}",
-// "projects/{project_id}/sources/{source_id}/finding/{finding_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}",
+// "folders/{folder_id}/sources/{source_id}/finding/{finding_id}",
+// "projects/{project_id}/sources/{source_id}/finding/{finding_id}".
func (r *OrganizationsSourcesFindingsService) SetMute(name string, setmuterequest *SetMuteRequest) *OrganizationsSourcesFindingsSetMuteCall {
c := &OrganizationsSourcesFindingsSetMuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15228,11 +15362,11 @@ type OrganizationsSourcesFindingsSetStateCall struct {
// SetState: Updates the state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}".
func (r *OrganizationsSourcesFindingsService) SetState(name string, setfindingstaterequest *SetFindingStateRequest) *OrganizationsSourcesFindingsSetStateCall {
c := &OrganizationsSourcesFindingsSetStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15374,12 +15508,12 @@ type OrganizationsSourcesFindingsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *OrganizationsSourcesFindingsService) UpdateSecurityMarks(name string, securitymarks *SecurityMarks) *OrganizationsSourcesFindingsUpdateSecurityMarksCall {
c := &OrganizationsSourcesFindingsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15552,10 +15686,10 @@ type OrganizationsSourcesFindingsExternalSystemsPatchCall struct {
// Patch: Updates external system. This is for a given finding.
//
-// - name: External System Name e.g. jira, demisto, etc. e.g.:
-// `organizations/1234/sources/5678/findings/123456/externalSystems/jir
-// a` `folders/1234/sources/5678/findings/123456/externalSystems/jira`
-// `projects/1234/sources/5678/findings/123456/externalSystems/jira`.
+// - name: External System Name e.g. jira, demisto, etc. e.g.:
+// `organizations/1234/sources/5678/findings/123456/externalSystems/jir
+// a` `folders/1234/sources/5678/findings/123456/externalSystems/jira`
+// `projects/1234/sources/5678/findings/123456/externalSystems/jira`.
func (r *OrganizationsSourcesFindingsExternalSystemsService) Patch(name string, googlecloudsecuritycenterv1externalsystem *GoogleCloudSecuritycenterV1ExternalSystem) *OrganizationsSourcesFindingsExternalSystemsPatchCall {
c := &OrganizationsSourcesFindingsExternalSystemsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -15714,9 +15848,9 @@ type ProjectsAssetsGroupCall struct {
// Group: Filters an organization's assets and groups them by their
// specified properties.
//
-// - parent: Name of the organization to groupBy. Its format is
-// "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Name of the organization to groupBy. Its format is
+// "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *ProjectsAssetsService) Group(parent string, groupassetsrequest *GroupAssetsRequest) *ProjectsAssetsGroupCall {
c := &ProjectsAssetsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15879,9 +16013,9 @@ type ProjectsAssetsListCall struct {
// List: Lists an organization's assets.
//
-// - parent: Name of the organization assets should belong to. Its
-// format is "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Name of the organization assets should belong to. Its
+// format is "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *ProjectsAssetsService) List(parent string) *ProjectsAssetsListCall {
c := &ProjectsAssetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16210,12 +16344,12 @@ type ProjectsAssetsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *ProjectsAssetsService) UpdateSecurityMarks(name string, securitymarks *SecurityMarks) *ProjectsAssetsUpdateSecurityMarksCall {
c := &ProjectsAssetsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -16388,9 +16522,9 @@ type ProjectsBigQueryExportsCreateCall struct {
// Create: Creates a big query export.
//
-// - parent: Resource name of the new big query export's parent. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// or "projects/[project_id]".
+// - parent: Resource name of the new big query export's parent. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// or "projects/[project_id]".
func (r *ProjectsBigQueryExportsService) Create(parent string, googlecloudsecuritycenterv1bigqueryexport *GoogleCloudSecuritycenterV1BigQueryExport) *ProjectsBigQueryExportsCreateCall {
c := &ProjectsBigQueryExportsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16548,10 +16682,10 @@ type ProjectsBigQueryExportsDeleteCall struct {
// Delete: Deletes an existing big query export.
//
-// - name: Name of the big query export to delete. Its format is
-// organizations/{organization}/bigQueryExports/{export_id},
-// folders/{folder}/bigQueryExports/{export_id}, or
-// projects/{project}/bigQueryExports/{export_id}.
+// - name: Name of the big query export to delete. Its format is
+// organizations/{organization}/bigQueryExports/{export_id},
+// folders/{folder}/bigQueryExports/{export_id}, or
+// projects/{project}/bigQueryExports/{export_id}.
func (r *ProjectsBigQueryExportsService) Delete(name string) *ProjectsBigQueryExportsDeleteCall {
c := &ProjectsBigQueryExportsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -16684,10 +16818,10 @@ type ProjectsBigQueryExportsGetCall struct {
// Get: Gets a big query export.
//
-// - name: Name of the big query export to retrieve. Its format is
-// organizations/{organization}/bigQueryExports/{export_id},
-// folders/{folder}/bigQueryExports/{export_id}, or
-// projects/{project}/bigQueryExports/{export_id}.
+// - name: Name of the big query export to retrieve. Its format is
+// organizations/{organization}/bigQueryExports/{export_id},
+// folders/{folder}/bigQueryExports/{export_id}, or
+// projects/{project}/bigQueryExports/{export_id}.
func (r *ProjectsBigQueryExportsService) Get(name string) *ProjectsBigQueryExportsGetCall {
c := &ProjectsBigQueryExportsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -16839,9 +16973,9 @@ type ProjectsBigQueryExportsListCall struct {
// BigQuery exports immediately under the folder plus the ones created
// under the projects within the folder are returned.
//
-// - parent: The parent, which owns the collection of BigQuery exports.
-// Its format is "organizations/[organization_id]",
-// "folders/[folder_id]", "projects/[project_id]".
+// - parent: The parent, which owns the collection of BigQuery exports.
+// Its format is "organizations/[organization_id]",
+// "folders/[folder_id]", "projects/[project_id]".
func (r *ProjectsBigQueryExportsService) List(parent string) *ProjectsBigQueryExportsListCall {
c := &ProjectsBigQueryExportsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17038,14 +17172,14 @@ type ProjectsBigQueryExportsPatchCall struct {
// Patch: Updates a BigQuery export.
//
-// - name: The relative resource name of this export. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name.
-// Example format:
-// "organizations/{organization_id}/bigQueryExports/{export_id}"
-// Example format: "folders/{folder_id}/bigQueryExports/{export_id}"
-// Example format: "projects/{project_id}/bigQueryExports/{export_id}"
-// This field is provided in responses, and is ignored when provided
-// in create requests.
+// - name: The relative resource name of this export. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name.
+// Example format:
+// "organizations/{organization_id}/bigQueryExports/{export_id}"
+// Example format: "folders/{folder_id}/bigQueryExports/{export_id}"
+// Example format: "projects/{project_id}/bigQueryExports/{export_id}"
+// This field is provided in responses, and is ignored when provided
+// in create requests.
func (r *ProjectsBigQueryExportsService) Patch(name string, googlecloudsecuritycenterv1bigqueryexport *GoogleCloudSecuritycenterV1BigQueryExport) *ProjectsBigQueryExportsPatchCall {
c := &ProjectsBigQueryExportsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17205,9 +17339,9 @@ type ProjectsFindingsBulkMuteCall struct {
// project. The findings matched by the filter will be muted after the
// LRO is done.
//
-// - parent: The parent, at which bulk action needs to be applied. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// "projects/[project_id]".
+// - parent: The parent, at which bulk action needs to be applied. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// "projects/[project_id]".
func (r *ProjectsFindingsService) BulkMute(parent string, bulkmutefindingsrequest *BulkMuteFindingsRequest) *ProjectsFindingsBulkMuteCall {
c := &ProjectsFindingsBulkMuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17349,9 +17483,9 @@ type ProjectsMuteConfigsCreateCall struct {
// Create: Creates a mute config.
//
-// - parent: Resource name of the new mute configs's parent. Its format
-// is "organizations/[organization_id]", "folders/[folder_id]", or
-// "projects/[project_id]".
+// - parent: Resource name of the new mute configs's parent. Its format
+// is "organizations/[organization_id]", "folders/[folder_id]", or
+// "projects/[project_id]".
func (r *ProjectsMuteConfigsService) Create(parent string, googlecloudsecuritycenterv1muteconfig *GoogleCloudSecuritycenterV1MuteConfig) *ProjectsMuteConfigsCreateCall {
c := &ProjectsMuteConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17508,10 +17642,10 @@ type ProjectsMuteConfigsDeleteCall struct {
// Delete: Deletes an existing mute config.
//
-// - name: Name of the mute config to delete. Its format is
-// organizations/{organization}/muteConfigs/{config_id},
-// folders/{folder}/muteConfigs/{config_id}, or
-// projects/{project}/muteConfigs/{config_id}.
+// - name: Name of the mute config to delete. Its format is
+// organizations/{organization}/muteConfigs/{config_id},
+// folders/{folder}/muteConfigs/{config_id}, or
+// projects/{project}/muteConfigs/{config_id}.
func (r *ProjectsMuteConfigsService) Delete(name string) *ProjectsMuteConfigsDeleteCall {
c := &ProjectsMuteConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17644,10 +17778,10 @@ type ProjectsMuteConfigsGetCall struct {
// Get: Gets a mute config.
//
-// - name: Name of the mute config to retrieve. Its format is
-// organizations/{organization}/muteConfigs/{config_id},
-// folders/{folder}/muteConfigs/{config_id}, or
-// projects/{project}/muteConfigs/{config_id}.
+// - name: Name of the mute config to retrieve. Its format is
+// organizations/{organization}/muteConfigs/{config_id},
+// folders/{folder}/muteConfigs/{config_id}, or
+// projects/{project}/muteConfigs/{config_id}.
func (r *ProjectsMuteConfigsService) Get(name string) *ProjectsMuteConfigsGetCall {
c := &ProjectsMuteConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17794,9 +17928,9 @@ type ProjectsMuteConfigsListCall struct {
// List: Lists mute configs.
//
-// - parent: The parent, which owns the collection of mute configs. Its
-// format is "organizations/[organization_id]", "folders/[folder_id]",
-// "projects/[project_id]".
+// - parent: The parent, which owns the collection of mute configs. Its
+// format is "organizations/[organization_id]", "folders/[folder_id]",
+// "projects/[project_id]".
func (r *ProjectsMuteConfigsService) List(parent string) *ProjectsMuteConfigsListCall {
c := &ProjectsMuteConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17993,10 +18127,10 @@ type ProjectsMuteConfigsPatchCall struct {
// Patch: Updates a mute config.
//
-// - name: This field will be ignored if provided on config creation.
-// Format "organizations/{organization}/muteConfigs/{mute_config}"
-// "folders/{folder}/muteConfigs/{mute_config}"
-// "projects/{project}/muteConfigs/{mute_config}".
+// - name: This field will be ignored if provided on config creation.
+// Format "organizations/{organization}/muteConfigs/{mute_config}"
+// "folders/{folder}/muteConfigs/{mute_config}"
+// "projects/{project}/muteConfigs/{mute_config}".
func (r *ProjectsMuteConfigsService) Patch(name string, googlecloudsecuritycenterv1muteconfig *GoogleCloudSecuritycenterV1MuteConfig) *ProjectsMuteConfigsPatchCall {
c := &ProjectsMuteConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -18152,9 +18286,9 @@ type ProjectsSourcesListCall struct {
// List: Lists all sources belonging to an organization.
//
-// - parent: Resource name of the parent of sources to list. Its format
-// should be "organizations/[organization_id], folders/[folder_id], or
-// projects/[project_id]".
+// - parent: Resource name of the parent of sources to list. Its format
+// should be "organizations/[organization_id], folders/[folder_id], or
+// projects/[project_id]".
func (r *ProjectsSourcesService) List(parent string) *ProjectsSourcesListCall {
c := &ProjectsSourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -18354,13 +18488,13 @@ type ProjectsSourcesFindingsGroupCall struct {
// /v1/folders/{folder_id}/sources/-/findings,
// /v1/projects/{project_id}/sources/-/findings
//
-// - parent: Name of the source to groupBy. Its format is
-// "organizations/[organization_id]/sources/[source_id]",
-// folders/[folder_id]/sources/[source_id], or
-// projects/[project_id]/sources/[source_id]. To groupBy across all
-// sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-,
-// folders/{folder_id}/sources/-, or projects/{project_id}/sources/-.
+// - parent: Name of the source to groupBy. Its format is
+// "organizations/[organization_id]/sources/[source_id]",
+// folders/[folder_id]/sources/[source_id], or
+// projects/[project_id]/sources/[source_id]. To groupBy across all
+// sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-,
+// folders/{folder_id}/sources/-, or projects/{project_id}/sources/-.
func (r *ProjectsSourcesFindingsService) Group(parent string, groupfindingsrequest *GroupFindingsRequest) *ProjectsSourcesFindingsGroupCall {
c := &ProjectsSourcesFindingsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -18525,13 +18659,13 @@ type ProjectsSourcesFindingsListCall struct {
// sources provide a `-` as the source id. Example:
// /v1/organizations/{organization_id}/sources/-/findings
//
-// - parent: Name of the source the findings belong to. Its format is
-// "organizations/[organization_id]/sources/[source_id],
-// folders/[folder_id]/sources/[source_id], or
-// projects/[project_id]/sources/[source_id]". To list across all
-// sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-,
-// folders/{folder_id}/sources/- or projects/{projects_id}/sources/-.
+// - parent: Name of the source the findings belong to. Its format is
+// "organizations/[organization_id]/sources/[source_id],
+// folders/[folder_id]/sources/[source_id], or
+// projects/[project_id]/sources/[source_id]". To list across all
+// sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-,
+// folders/{folder_id}/sources/- or projects/{projects_id}/sources/-.
func (r *ProjectsSourcesFindingsService) List(parent string) *ProjectsSourcesFindingsListCall {
c := &ProjectsSourcesFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -18852,11 +18986,11 @@ type ProjectsSourcesFindingsPatchCall struct {
// Patch: Creates or updates a finding. The corresponding source must
// exist for a finding creation to succeed.
//
-// - name: The relative resource name of this finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}".
+// - name: The relative resource name of this finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}".
func (r *ProjectsSourcesFindingsService) Patch(name string, finding *Finding) *ProjectsSourcesFindingsPatchCall {
c := &ProjectsSourcesFindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -19015,13 +19149,13 @@ type ProjectsSourcesFindingsSetMuteCall struct {
// SetMute: Updates the mute state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}",
-// "folders/{folder_id}/sources/{source_id}/finding/{finding_id}",
-// "projects/{project_id}/sources/{source_id}/finding/{finding_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}",
+// "folders/{folder_id}/sources/{source_id}/finding/{finding_id}",
+// "projects/{project_id}/sources/{source_id}/finding/{finding_id}".
func (r *ProjectsSourcesFindingsService) SetMute(name string, setmuterequest *SetMuteRequest) *ProjectsSourcesFindingsSetMuteCall {
c := &ProjectsSourcesFindingsSetMuteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -19163,11 +19297,11 @@ type ProjectsSourcesFindingsSetStateCall struct {
// SetState: Updates the state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}".
func (r *ProjectsSourcesFindingsService) SetState(name string, setfindingstaterequest *SetFindingStateRequest) *ProjectsSourcesFindingsSetStateCall {
c := &ProjectsSourcesFindingsSetStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -19309,12 +19443,12 @@ type ProjectsSourcesFindingsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *ProjectsSourcesFindingsService) UpdateSecurityMarks(name string, securitymarks *SecurityMarks) *ProjectsSourcesFindingsUpdateSecurityMarksCall {
c := &ProjectsSourcesFindingsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -19487,10 +19621,10 @@ type ProjectsSourcesFindingsExternalSystemsPatchCall struct {
// Patch: Updates external system. This is for a given finding.
//
-// - name: External System Name e.g. jira, demisto, etc. e.g.:
-// `organizations/1234/sources/5678/findings/123456/externalSystems/jir
-// a` `folders/1234/sources/5678/findings/123456/externalSystems/jira`
-// `projects/1234/sources/5678/findings/123456/externalSystems/jira`.
+// - name: External System Name e.g. jira, demisto, etc. e.g.:
+// `organizations/1234/sources/5678/findings/123456/externalSystems/jir
+// a` `folders/1234/sources/5678/findings/123456/externalSystems/jira`
+// `projects/1234/sources/5678/findings/123456/externalSystems/jira`.
func (r *ProjectsSourcesFindingsExternalSystemsService) Patch(name string, googlecloudsecuritycenterv1externalsystem *GoogleCloudSecuritycenterV1ExternalSystem) *ProjectsSourcesFindingsExternalSystemsPatchCall {
c := &ProjectsSourcesFindingsExternalSystemsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/securitycenter/v1beta1/securitycenter-api.json b/securitycenter/v1beta1/securitycenter-api.json
index 683a171a9ec..1ffc1f62e62 100644
--- a/securitycenter/v1beta1/securitycenter-api.json
+++ b/securitycenter/v1beta1/securitycenter-api.json
@@ -896,7 +896,7 @@
}
}
},
- "revision": "20220720",
+ "revision": "20220817",
"rootUrl": "https://securitycenter.googleapis.com/",
"schemas": {
"Access": {
@@ -916,7 +916,22 @@
"type": "string"
},
"principalEmail": {
- "description": "Associated email, such as \"foo@google.com\".",
+ "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
+ "type": "string"
+ },
+ "principalSubject": {
+ "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "type": "string"
+ },
+ "serviceAccountDelegationInfo": {
+ "description": "Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
+ "items": {
+ "$ref": "ServiceAccountDelegationInfo"
+ },
+ "type": "array"
+ },
+ "serviceAccountKeyName": {
+ "description": "The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\" ",
"type": "string"
},
"serviceName": {
@@ -1086,7 +1101,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
@@ -1385,6 +1400,36 @@
},
"type": "object"
},
+ "Database": {
+ "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.",
+ "id": "Database",
+ "properties": {
+ "displayName": {
+ "description": "The human readable name of the database the user connected to.",
+ "type": "string"
+ },
+ "grantees": {
+ "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "name": {
+ "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)",
+ "type": "string"
+ },
+ "query": {
+ "description": "The SQL statement associated with the relevant access.",
+ "type": "string"
+ },
+ "userName": {
+ "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"Detection": {
"description": "Memory hash detection contributing to the binary family match.",
"id": "Detection",
@@ -1567,6 +1612,10 @@
"format": "google-datetime",
"type": "string"
},
+ "database": {
+ "$ref": "Database",
+ "description": "Database associated with the finding."
+ },
"description": {
"description": "Contains more detail about the finding.",
"type": "string"
@@ -2807,7 +2856,9 @@
"DATA_DESTRUCTION",
"DOMAIN_POLICY_MODIFICATION",
"IMPAIR_DEFENSES",
- "NETWORK_SERVICE_DISCOVERY"
+ "NETWORK_SERVICE_DISCOVERY",
+ "ACCESS_TOKEN_MANIPULATION",
+ "ABUSE_ELEVATION_CONTROL_MECHANISM"
],
"enumDescriptions": [
"Unspecified value.",
@@ -2842,7 +2893,9 @@
"T1485",
"T1484",
"T1562",
- "T1046"
+ "T1046",
+ "T1134",
+ "T1548"
],
"type": "string"
},
@@ -2922,7 +2975,9 @@
"DATA_DESTRUCTION",
"DOMAIN_POLICY_MODIFICATION",
"IMPAIR_DEFENSES",
- "NETWORK_SERVICE_DISCOVERY"
+ "NETWORK_SERVICE_DISCOVERY",
+ "ACCESS_TOKEN_MANIPULATION",
+ "ABUSE_ELEVATION_CONTROL_MECHANISM"
],
"enumDescriptions": [
"Unspecified value.",
@@ -2957,7 +3012,9 @@
"T1485",
"T1484",
"T1562",
- "T1046"
+ "T1046",
+ "T1134",
+ "T1548"
],
"type": "string"
},
@@ -3288,6 +3345,21 @@
},
"type": "object"
},
+ "ServiceAccountDelegationInfo": {
+ "description": "Identity delegation history of an authenticated service account.",
+ "id": "ServiceAccountDelegationInfo",
+ "properties": {
+ "principalEmail": {
+ "description": "The email address of a Google account. .",
+ "type": "string"
+ },
+ "principalSubject": {
+ "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"SetFindingStateRequest": {
"description": "Request message for updating a finding's state.",
"id": "SetFindingStateRequest",
diff --git a/securitycenter/v1beta1/securitycenter-gen.go b/securitycenter/v1beta1/securitycenter-gen.go
index 45a0e501f7e..86ed2de4bf0 100644
--- a/securitycenter/v1beta1/securitycenter-gen.go
+++ b/securitycenter/v1beta1/securitycenter-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/security-command-center
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/securitycenter/v1beta1"
-// ...
-// ctx := context.Background()
-// securitycenterService, err := securitycenter.NewService(ctx)
+// import "google.golang.org/api/securitycenter/v1beta1"
+// ...
+// ctx := context.Background()
+// securitycenterService, err := securitycenter.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package securitycenter // import "google.golang.org/api/securitycenter/v1beta1"
@@ -207,9 +207,41 @@ type Access struct {
// "SetIamPolicy".
MethodName string `json:"methodName,omitempty"`
- // PrincipalEmail: Associated email, such as "foo@google.com".
+ // PrincipalEmail: Associated email, such as "foo@google.com". The email
+ // address of the authenticated user (or service account on behalf of
+ // third party principal) making the request. For third party identity
+ // callers, the `principal_subject` field is populated instead of this
+ // field. For privacy reasons, the principal email address is sometimes
+ // redacted. For more information, see Caller identities in audit logs
+ // (https://cloud.google.com/logging/docs/audit#user-id).
PrincipalEmail string `json:"principalEmail,omitempty"`
+ // PrincipalSubject: A string representing the principal_subject
+ // associated with the identity. As compared to `principal_email`,
+ // supports principals that aren't associated with email addresses, such
+ // as third party principals. For most identities, the format will be
+ // `principal://iam.googleapis.com/{identity pool
+ // name}/subject/{subject)` except for some GKE identities
+ // (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the
+ // legacy format `serviceAccount:{identity pool name}[{subject}]`
+ PrincipalSubject string `json:"principalSubject,omitempty"`
+
+ // ServiceAccountDelegationInfo: Identity delegation history of an
+ // authenticated service account that makes the request. It contains
+ // information on the real authorities that try to access GCP resources
+ // by delegating on a service account. When multiple authorities are
+ // present, they are guaranteed to be sorted based on the original
+ // ordering of the identity delegation events.
+ ServiceAccountDelegationInfo []*ServiceAccountDelegationInfo `json:"serviceAccountDelegationInfo,omitempty"`
+
+ // ServiceAccountKeyName: The name of the service account key used to
+ // create or exchange credentials for authenticating the service account
+ // making the request. This is a scheme-less URI full resource name. For
+ // example:
+ // "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/
+ // keys/{key}"
+ ServiceAccountKeyName string `json:"serviceAccountKeyName,omitempty"`
+
// ServiceName: This is the API service that the service account made a
// call to, e.g. "iam.googleapis.com"
ServiceName string `json:"serviceName,omitempty"`
@@ -508,16 +540,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -947,6 +983,57 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error {
return nil
}
+// Database: Represents database access information, such as queries. A
+// database may be a sub-resource of an instance (as in the case of
+// CloudSQL instances or Cloud Spanner instances), or the database
+// instance itself. Some database resources may not have the full
+// resource name populated because these resource types are not yet
+// supported by Cloud Asset Inventory (e.g. CloudSQL databases). In
+// these cases only the display name will be provided.
+type Database struct {
+ // DisplayName: The human readable name of the database the user
+ // connected to.
+ DisplayName string `json:"displayName,omitempty"`
+
+ // Grantees: The target usernames/roles/groups of a SQL privilege grant
+ // (not an IAM policy change).
+ Grantees []string `json:"grantees,omitempty"`
+
+ // Name: The full resource name of the database the user connected to,
+ // if it is supported by CAI.
+ // (https://google.aip.dev/122#full-resource-names)
+ Name string `json:"name,omitempty"`
+
+ // Query: The SQL statement associated with the relevant access.
+ Query string `json:"query,omitempty"`
+
+ // UserName: The username used to connect to the DB. This may not
+ // necessarily be an IAM principal, and has no required format.
+ UserName string `json:"userName,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "DisplayName") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DisplayName") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *Database) MarshalJSON() ([]byte, error) {
+ type NoMethod Database
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// Detection: Memory hash detection contributing to the binary family
// match.
type Detection struct {
@@ -1271,6 +1358,9 @@ type Finding struct {
// Command Center.
CreateTime string `json:"createTime,omitempty"`
+ // Database: Database associated with the finding.
+ Database *Database `json:"database,omitempty"`
+
// Description: Contains more detail about the finding.
Description string `json:"description,omitempty"`
@@ -3220,6 +3310,8 @@ type MitreAttack struct {
// "DOMAIN_POLICY_MODIFICATION" - T1484
// "IMPAIR_DEFENSES" - T1562
// "NETWORK_SERVICE_DISCOVERY" - T1046
+ // "ACCESS_TOKEN_MANIPULATION" - T1134
+ // "ABUSE_ELEVATION_CONTROL_MECHANISM" - T1548
AdditionalTechniques []string `json:"additionalTechniques,omitempty"`
// PrimaryTactic: The MITRE ATT&CK tactic most closely represented by
@@ -3285,6 +3377,8 @@ type MitreAttack struct {
// "DOMAIN_POLICY_MODIFICATION" - T1484
// "IMPAIR_DEFENSES" - T1562
// "NETWORK_SERVICE_DISCOVERY" - T1046
+ // "ACCESS_TOKEN_MANIPULATION" - T1134
+ // "ABUSE_ELEVATION_CONTROL_MECHANISM" - T1548
PrimaryTechniques []string `json:"primaryTechniques,omitempty"`
// Version: The MITRE ATT&CK version referenced by the above fields.
@@ -3910,6 +4004,46 @@ func (s *SecurityMarks) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// ServiceAccountDelegationInfo: Identity delegation history of an
+// authenticated service account.
+type ServiceAccountDelegationInfo struct {
+ // PrincipalEmail: The email address of a Google account. .
+ PrincipalEmail string `json:"principalEmail,omitempty"`
+
+ // PrincipalSubject: A string representing the principal_subject
+ // associated with the identity. As compared to `principal_email`,
+ // supports principals that aren't associated with email addresses, such
+ // as third party principals. For most identities, the format will be
+ // `principal://iam.googleapis.com/{identity pool
+ // name}/subject/{subject)` except for some GKE identities
+ // (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the
+ // legacy format `serviceAccount:{identity pool name}[{subject}]`
+ PrincipalSubject string `json:"principalSubject,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "PrincipalEmail") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "PrincipalEmail") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *ServiceAccountDelegationInfo) MarshalJSON() ([]byte, error) {
+ type NoMethod ServiceAccountDelegationInfo
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// SetFindingStateRequest: Request message for updating a finding's
// state.
type SetFindingStateRequest struct {
@@ -4260,9 +4394,9 @@ type OrganizationsGetOrganizationSettingsCall struct {
// GetOrganizationSettings: Gets the settings for an organization.
//
-// - name: Name of the organization to get organization settings for.
-// Its format is
-// "organizations/[organization_id]/organizationSettings".
+// - name: Name of the organization to get organization settings for.
+// Its format is
+// "organizations/[organization_id]/organizationSettings".
func (r *OrganizationsService) GetOrganizationSettings(name string) *OrganizationsGetOrganizationSettingsCall {
c := &OrganizationsGetOrganizationSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4408,9 +4542,9 @@ type OrganizationsUpdateOrganizationSettingsCall struct {
// UpdateOrganizationSettings: Updates an organization's settings.
//
-// - name: The relative resource name of the settings. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example: "organizations/{organization_id}/organizationSettings".
+// - name: The relative resource name of the settings. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example: "organizations/{organization_id}/organizationSettings".
func (r *OrganizationsService) UpdateOrganizationSettings(name string, organizationsettings *OrganizationSettings) *OrganizationsUpdateOrganizationSettingsCall {
c := &OrganizationsUpdateOrganizationSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4566,8 +4700,8 @@ type OrganizationsAssetsGroupCall struct {
// Group: Filters an organization's assets and groups them by their
// specified properties.
//
-// - parent: Name of the organization to groupBy. Its format is
-// "organizations/[organization_id]".
+// - parent: Name of the organization to groupBy. Its format is
+// "organizations/[organization_id]".
func (r *OrganizationsAssetsService) Group(parent string, groupassetsrequest *GroupAssetsRequest) *OrganizationsAssetsGroupCall {
c := &OrganizationsAssetsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4730,8 +4864,8 @@ type OrganizationsAssetsListCall struct {
// List: Lists an organization's assets.
//
-// - parent: Name of the organization assets should belong to. Its
-// format is "organizations/[organization_id]".
+// - parent: Name of the organization assets should belong to. Its
+// format is "organizations/[organization_id]".
func (r *OrganizationsAssetsService) List(parent string) *OrganizationsAssetsListCall {
c := &OrganizationsAssetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5033,8 +5167,8 @@ type OrganizationsAssetsRunDiscoveryCall struct {
// frequency for an organization. If it is called too frequently the
// caller will receive a TOO_MANY_REQUESTS error.
//
-// - parent: Name of the organization to run asset discovery for. Its
-// format is "organizations/[organization_id]".
+// - parent: Name of the organization to run asset discovery for. Its
+// format is "organizations/[organization_id]".
func (r *OrganizationsAssetsService) RunDiscovery(parent string, runassetdiscoveryrequest *RunAssetDiscoveryRequest) *OrganizationsAssetsRunDiscoveryCall {
c := &OrganizationsAssetsRunDiscoveryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5176,12 +5310,12 @@ type OrganizationsAssetsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *OrganizationsAssetsService) UpdateSecurityMarks(name string, googlecloudsecuritycenterv1beta1securitymarks *GoogleCloudSecuritycenterV1beta1SecurityMarks) *OrganizationsAssetsUpdateSecurityMarksCall {
c := &OrganizationsAssetsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5998,8 +6132,8 @@ type OrganizationsSourcesCreateCall struct {
// Create: Creates a source.
//
-// - parent: Resource name of the new source's parent. Its format should
-// be "organizations/[organization_id]".
+// - parent: Resource name of the new source's parent. Its format should
+// be "organizations/[organization_id]".
func (r *OrganizationsSourcesService) Create(parent string, source *Source) *OrganizationsSourcesCreateCall {
c := &OrganizationsSourcesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6141,8 +6275,8 @@ type OrganizationsSourcesGetCall struct {
// Get: Gets a source.
//
-// - name: Relative resource name of the source. Its format is
-// "organizations/[organization_id]/source/[source_id]".
+// - name: Relative resource name of the source. Its format is
+// "organizations/[organization_id]/source/[source_id]".
func (r *OrganizationsSourcesService) Get(name string) *OrganizationsSourcesGetCall {
c := &OrganizationsSourcesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6288,10 +6422,10 @@ type OrganizationsSourcesGetIamPolicyCall struct {
// GetIamPolicy: Gets the access control policy on the specified Source.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *OrganizationsSourcesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *OrganizationsSourcesGetIamPolicyCall {
c := &OrganizationsSourcesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6433,8 +6567,8 @@ type OrganizationsSourcesListCall struct {
// List: Lists all sources belonging to an organization.
//
-// - parent: Resource name of the parent of sources to list. Its format
-// should be "organizations/[organization_id]".
+// - parent: Resource name of the parent of sources to list. Its format
+// should be "organizations/[organization_id]".
func (r *OrganizationsSourcesService) List(parent string) *OrganizationsSourcesListCall {
c := &OrganizationsSourcesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6629,9 +6763,9 @@ type OrganizationsSourcesPatchCall struct {
// Patch: Updates a source.
//
-// - name: The relative resource name of this source. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example: "organizations/{organization_id}/sources/{source_id}".
+// - name: The relative resource name of this source. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example: "organizations/{organization_id}/sources/{source_id}".
func (r *OrganizationsSourcesService) Patch(name string, source *Source) *OrganizationsSourcesPatchCall {
c := &OrganizationsSourcesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6786,10 +6920,10 @@ type OrganizationsSourcesSetIamPolicyCall struct {
// SetIamPolicy: Sets the access control policy on the specified Source.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *OrganizationsSourcesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *OrganizationsSourcesSetIamPolicyCall {
c := &OrganizationsSourcesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6932,10 +7066,10 @@ type OrganizationsSourcesTestIamPermissionsCall struct {
// TestIamPermissions: Returns the permissions that a caller has on the
// specified source.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *OrganizationsSourcesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *OrganizationsSourcesTestIamPermissionsCall {
c := &OrganizationsSourcesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7078,8 +7212,8 @@ type OrganizationsSourcesFindingsCreateCall struct {
// Create: Creates a finding. The corresponding source must exist for
// finding creation to succeed.
//
-// - parent: Resource name of the new finding's parent. Its format
-// should be "organizations/[organization_id]/sources/[source_id]".
+// - parent: Resource name of the new finding's parent. Its format
+// should be "organizations/[organization_id]/sources/[source_id]".
func (r *OrganizationsSourcesFindingsService) Create(parent string, googlecloudsecuritycenterv1beta1finding *GoogleCloudSecuritycenterV1beta1Finding) *OrganizationsSourcesFindingsCreateCall {
c := &OrganizationsSourcesFindingsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7239,10 +7373,10 @@ type OrganizationsSourcesFindingsGroupCall struct {
// `-` as the source id. Example:
// /v1beta1/organizations/{organization_id}/sources/-/findings
//
-// - parent: Name of the source to groupBy. Its format is
-// "organizations/[organization_id]/sources/[source_id]". To groupBy
-// across all sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-.
+// - parent: Name of the source to groupBy. Its format is
+// "organizations/[organization_id]/sources/[source_id]". To groupBy
+// across all sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-.
func (r *OrganizationsSourcesFindingsService) Group(parent string, groupfindingsrequest *GroupFindingsRequest) *OrganizationsSourcesFindingsGroupCall {
c := &OrganizationsSourcesFindingsGroupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7407,10 +7541,10 @@ type OrganizationsSourcesFindingsListCall struct {
// sources provide a `-` as the source id. Example:
// /v1beta1/organizations/{organization_id}/sources/-/findings
//
-// - parent: Name of the source the findings belong to. Its format is
-// "organizations/[organization_id]/sources/[source_id]". To list
-// across all sources provide a source_id of `-`. For example:
-// organizations/{organization_id}/sources/-.
+// - parent: Name of the source the findings belong to. Its format is
+// "organizations/[organization_id]/sources/[source_id]". To list
+// across all sources provide a source_id of `-`. For example:
+// organizations/{organization_id}/sources/-.
func (r *OrganizationsSourcesFindingsService) List(parent string) *OrganizationsSourcesFindingsListCall {
c := &OrganizationsSourcesFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7678,11 +7812,11 @@ type OrganizationsSourcesFindingsPatchCall struct {
// Patch: Creates or updates a finding. The corresponding source must
// exist for a finding creation to succeed.
//
-// - name: The relative resource name of this finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}".
+// - name: The relative resource name of this finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}".
func (r *OrganizationsSourcesFindingsService) Patch(name string, googlecloudsecuritycenterv1beta1finding *GoogleCloudSecuritycenterV1beta1Finding) *OrganizationsSourcesFindingsPatchCall {
c := &OrganizationsSourcesFindingsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7839,11 +7973,11 @@ type OrganizationsSourcesFindingsSetStateCall struct {
// SetState: Updates the state of a finding.
//
-// - name: The relative resource name of the finding. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Example:
-// "organizations/{organization_id}/sources/{source_id}/finding/{findin
-// g_id}".
+// - name: The relative resource name of the finding. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Example:
+// "organizations/{organization_id}/sources/{source_id}/finding/{findin
+// g_id}".
func (r *OrganizationsSourcesFindingsService) SetState(name string, setfindingstaterequest *SetFindingStateRequest) *OrganizationsSourcesFindingsSetStateCall {
c := &OrganizationsSourcesFindingsSetStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7986,12 +8120,12 @@ type OrganizationsSourcesFindingsUpdateSecurityMarksCall struct {
// UpdateSecurityMarks: Updates security marks.
//
-// - name: The relative resource name of the SecurityMarks. See:
-// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-// Examples:
-// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
-// "organizations/{organization_id}/sources/{source_id}/findings/{findi
-// ng_id}/securityMarks".
+// - name: The relative resource name of the SecurityMarks. See:
+// https://cloud.google.com/apis/design/resource_names#relative_resource_name
+// Examples:
+// "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+// "organizations/{organization_id}/sources/{source_id}/findings/{findi
+// ng_id}/securityMarks".
func (r *OrganizationsSourcesFindingsService) UpdateSecurityMarks(name string, googlecloudsecuritycenterv1beta1securitymarks *GoogleCloudSecuritycenterV1beta1SecurityMarks) *OrganizationsSourcesFindingsUpdateSecurityMarksCall {
c := &OrganizationsSourcesFindingsUpdateSecurityMarksCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/securitycenter/v1beta2/securitycenter-api.json b/securitycenter/v1beta2/securitycenter-api.json
index 360ed1a51a1..cee64c96c4c 100644
--- a/securitycenter/v1beta2/securitycenter-api.json
+++ b/securitycenter/v1beta2/securitycenter-api.json
@@ -1981,7 +1981,7 @@
}
}
},
- "revision": "20220720",
+ "revision": "20220817",
"rootUrl": "https://securitycenter.googleapis.com/",
"schemas": {
"Access": {
@@ -2001,7 +2001,22 @@
"type": "string"
},
"principalEmail": {
- "description": "Associated email, such as \"foo@google.com\".",
+ "description": "Associated email, such as \"foo@google.com\". The email address of the authenticated user (or service account on behalf of third party principal) making the request. For third party identity callers, the `principal_subject` field is populated instead of this field. For privacy reasons, the principal email address is sometimes redacted. For more information, see [Caller identities in audit logs](https://cloud.google.com/logging/docs/audit#user-id).",
+ "type": "string"
+ },
+ "principalSubject": {
+ "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "type": "string"
+ },
+ "serviceAccountDelegationInfo": {
+ "description": "Identity delegation history of an authenticated service account that makes the request. It contains information on the real authorities that try to access GCP resources by delegating on a service account. When multiple authorities are present, they are guaranteed to be sorted based on the original ordering of the identity delegation events.",
+ "items": {
+ "$ref": "ServiceAccountDelegationInfo"
+ },
+ "type": "array"
+ },
+ "serviceAccountKeyName": {
+ "description": "The name of the service account key used to create or exchange credentials for authenticating the service account making the request. This is a scheme-less URI full resource name. For example: \"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\" ",
"type": "string"
},
"serviceName": {
@@ -2406,6 +2421,36 @@
},
"type": "object"
},
+ "Database": {
+ "description": "Represents database access information, such as queries. A database may be a sub-resource of an instance (as in the case of CloudSQL instances or Cloud Spanner instances), or the database instance itself. Some database resources may not have the full resource name populated because these resource types are not yet supported by Cloud Asset Inventory (e.g. CloudSQL databases). In these cases only the display name will be provided.",
+ "id": "Database",
+ "properties": {
+ "displayName": {
+ "description": "The human readable name of the database the user connected to.",
+ "type": "string"
+ },
+ "grantees": {
+ "description": "The target usernames/roles/groups of a SQL privilege grant (not an IAM policy change).",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "name": {
+ "description": "The full resource name of the database the user connected to, if it is supported by CAI. (https://google.aip.dev/122#full-resource-names)",
+ "type": "string"
+ },
+ "query": {
+ "description": "The SQL statement associated with the relevant access.",
+ "type": "string"
+ },
+ "userName": {
+ "description": "The username used to connect to the DB. This may not necessarily be an IAM principal, and has no required format.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"Details": {
"description": "Details of a subscription.",
"id": "Details",
@@ -2634,6 +2679,10 @@
"format": "google-datetime",
"type": "string"
},
+ "database": {
+ "$ref": "Database",
+ "description": "Database associated with the finding."
+ },
"description": {
"description": "Contains more detail about the finding.",
"type": "string"
@@ -3521,7 +3570,9 @@
"DATA_DESTRUCTION",
"DOMAIN_POLICY_MODIFICATION",
"IMPAIR_DEFENSES",
- "NETWORK_SERVICE_DISCOVERY"
+ "NETWORK_SERVICE_DISCOVERY",
+ "ACCESS_TOKEN_MANIPULATION",
+ "ABUSE_ELEVATION_CONTROL_MECHANISM"
],
"enumDescriptions": [
"Unspecified value.",
@@ -3556,7 +3607,9 @@
"T1485",
"T1484",
"T1562",
- "T1046"
+ "T1046",
+ "T1134",
+ "T1548"
],
"type": "string"
},
@@ -3636,7 +3689,9 @@
"DATA_DESTRUCTION",
"DOMAIN_POLICY_MODIFICATION",
"IMPAIR_DEFENSES",
- "NETWORK_SERVICE_DISCOVERY"
+ "NETWORK_SERVICE_DISCOVERY",
+ "ACCESS_TOKEN_MANIPULATION",
+ "ABUSE_ELEVATION_CONTROL_MECHANISM"
],
"enumDescriptions": [
"Unspecified value.",
@@ -3671,7 +3726,9 @@
"T1485",
"T1484",
"T1562",
- "T1046"
+ "T1046",
+ "T1134",
+ "T1548"
],
"type": "string"
},
@@ -4017,6 +4074,21 @@
},
"type": "object"
},
+ "ServiceAccountDelegationInfo": {
+ "description": "Identity delegation history of an authenticated service account.",
+ "id": "ServiceAccountDelegationInfo",
+ "properties": {
+ "principalEmail": {
+ "description": "The email address of a Google account. .",
+ "type": "string"
+ },
+ "principalSubject": {
+ "description": "A string representing the principal_subject associated with the identity. As compared to `principal_email`, supports principals that aren't associated with email addresses, such as third party principals. For most identities, the format will be `principal://iam.googleapis.com/{identity pool name}/subject/{subject)` except for some GKE identities (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the legacy format `serviceAccount:{identity pool name}[{subject}]`",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"Subject": {
"description": "Represents a Kubernetes Subject.",
"id": "Subject",
diff --git a/securitycenter/v1beta2/securitycenter-gen.go b/securitycenter/v1beta2/securitycenter-gen.go
index 9a70963760c..1e42ef66d42 100644
--- a/securitycenter/v1beta2/securitycenter-gen.go
+++ b/securitycenter/v1beta2/securitycenter-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/security-command-center
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/securitycenter/v1beta2"
-// ...
-// ctx := context.Background()
-// securitycenterService, err := securitycenter.NewService(ctx)
+// import "google.golang.org/api/securitycenter/v1beta2"
+// ...
+// ctx := context.Background()
+// securitycenterService, err := securitycenter.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package securitycenter // import "google.golang.org/api/securitycenter/v1beta2"
@@ -435,9 +435,41 @@ type Access struct {
// "SetIamPolicy".
MethodName string `json:"methodName,omitempty"`
- // PrincipalEmail: Associated email, such as "foo@google.com".
+ // PrincipalEmail: Associated email, such as "foo@google.com". The email
+ // address of the authenticated user (or service account on behalf of
+ // third party principal) making the request. For third party identity
+ // callers, the `principal_subject` field is populated instead of this
+ // field. For privacy reasons, the principal email address is sometimes
+ // redacted. For more information, see Caller identities in audit logs
+ // (https://cloud.google.com/logging/docs/audit#user-id).
PrincipalEmail string `json:"principalEmail,omitempty"`
+ // PrincipalSubject: A string representing the principal_subject
+ // associated with the identity. As compared to `principal_email`,
+ // supports principals that aren't associated with email addresses, such
+ // as third party principals. For most identities, the format will be
+ // `principal://iam.googleapis.com/{identity pool
+ // name}/subject/{subject)` except for some GKE identities
+ // (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the
+ // legacy format `serviceAccount:{identity pool name}[{subject}]`
+ PrincipalSubject string `json:"principalSubject,omitempty"`
+
+ // ServiceAccountDelegationInfo: Identity delegation history of an
+ // authenticated service account that makes the request. It contains
+ // information on the real authorities that try to access GCP resources
+ // by delegating on a service account. When multiple authorities are
+ // present, they are guaranteed to be sorted based on the original
+ // ordering of the identity delegation events.
+ ServiceAccountDelegationInfo []*ServiceAccountDelegationInfo `json:"serviceAccountDelegationInfo,omitempty"`
+
+ // ServiceAccountKeyName: The name of the service account key used to
+ // create or exchange credentials for authenticating the service account
+ // making the request. This is a scheme-less URI full resource name. For
+ // example:
+ // "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/
+ // keys/{key}"
+ ServiceAccountKeyName string `json:"serviceAccountKeyName,omitempty"`
+
// ServiceName: This is the API service that the service account made a
// call to, e.g. "iam.googleapis.com"
ServiceName string `json:"serviceName,omitempty"`
@@ -1009,6 +1041,57 @@ func (s *Cvssv3) UnmarshalJSON(data []byte) error {
return nil
}
+// Database: Represents database access information, such as queries. A
+// database may be a sub-resource of an instance (as in the case of
+// CloudSQL instances or Cloud Spanner instances), or the database
+// instance itself. Some database resources may not have the full
+// resource name populated because these resource types are not yet
+// supported by Cloud Asset Inventory (e.g. CloudSQL databases). In
+// these cases only the display name will be provided.
+type Database struct {
+ // DisplayName: The human readable name of the database the user
+ // connected to.
+ DisplayName string `json:"displayName,omitempty"`
+
+ // Grantees: The target usernames/roles/groups of a SQL privilege grant
+ // (not an IAM policy change).
+ Grantees []string `json:"grantees,omitempty"`
+
+ // Name: The full resource name of the database the user connected to,
+ // if it is supported by CAI.
+ // (https://google.aip.dev/122#full-resource-names)
+ Name string `json:"name,omitempty"`
+
+ // Query: The SQL statement associated with the relevant access.
+ Query string `json:"query,omitempty"`
+
+ // UserName: The username used to connect to the DB. This may not
+ // necessarily be an IAM principal, and has no required format.
+ UserName string `json:"userName,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "DisplayName") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DisplayName") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *Database) MarshalJSON() ([]byte, error) {
+ type NoMethod Database
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// Details: Details of a subscription.
type Details struct {
// EndTime: The time the subscription has or will end.
@@ -1359,6 +1442,9 @@ type Finding struct {
// Command Center.
CreateTime string `json:"createTime,omitempty"`
+ // Database: Database associated with the finding.
+ Database *Database `json:"database,omitempty"`
+
// Description: Contains more detail about the finding.
Description string `json:"description,omitempty"`
@@ -2626,6 +2712,8 @@ type MitreAttack struct {
// "DOMAIN_POLICY_MODIFICATION" - T1484
// "IMPAIR_DEFENSES" - T1562
// "NETWORK_SERVICE_DISCOVERY" - T1046
+ // "ACCESS_TOKEN_MANIPULATION" - T1134
+ // "ABUSE_ELEVATION_CONTROL_MECHANISM" - T1548
AdditionalTechniques []string `json:"additionalTechniques,omitempty"`
// PrimaryTactic: The MITRE ATT&CK tactic most closely represented by
@@ -2691,6 +2779,8 @@ type MitreAttack struct {
// "DOMAIN_POLICY_MODIFICATION" - T1484
// "IMPAIR_DEFENSES" - T1562
// "NETWORK_SERVICE_DISCOVERY" - T1046
+ // "ACCESS_TOKEN_MANIPULATION" - T1134
+ // "ABUSE_ELEVATION_CONTROL_MECHANISM" - T1548
PrimaryTechniques []string `json:"primaryTechniques,omitempty"`
// Version: The MITRE ATT&CK version referenced by the above fields.
@@ -3261,6 +3351,46 @@ func (s *SecurityMarks) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// ServiceAccountDelegationInfo: Identity delegation history of an
+// authenticated service account.
+type ServiceAccountDelegationInfo struct {
+ // PrincipalEmail: The email address of a Google account. .
+ PrincipalEmail string `json:"principalEmail,omitempty"`
+
+ // PrincipalSubject: A string representing the principal_subject
+ // associated with the identity. As compared to `principal_email`,
+ // supports principals that aren't associated with email addresses, such
+ // as third party principals. For most identities, the format will be
+ // `principal://iam.googleapis.com/{identity pool
+ // name}/subject/{subject)` except for some GKE identities
+ // (GKE_WORKLOAD, FREEFORM, GKE_HUB_WORKLOAD) that are still in the
+ // legacy format `serviceAccount:{identity pool name}[{subject}]`
+ PrincipalSubject string `json:"principalSubject,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "PrincipalEmail") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "PrincipalEmail") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *ServiceAccountDelegationInfo) MarshalJSON() ([]byte, error) {
+ type NoMethod ServiceAccountDelegationInfo
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// Subject: Represents a Kubernetes Subject.
type Subject struct {
// Kind: Authentication type for subject.
@@ -3538,13 +3668,13 @@ type FoldersGetContainerThreatDetectionSettingsCall struct {
// GetContainerThreatDetectionSettings: Get the
// ContainerThreatDetectionSettings resource.
//
-// - name: The name of the ContainerThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *FoldersService) GetContainerThreatDetectionSettings(name string) *FoldersGetContainerThreatDetectionSettingsCall {
c := &FoldersGetContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3691,11 +3821,11 @@ type FoldersGetEventThreatDetectionSettingsCall struct {
// GetEventThreatDetectionSettings: Get the EventThreatDetectionSettings
// resource.
//
-// - name: The name of the EventThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The name of the EventThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *FoldersService) GetEventThreatDetectionSettings(name string) *FoldersGetEventThreatDetectionSettingsCall {
c := &FoldersGetEventThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3841,10 +3971,10 @@ type FoldersGetOnboardingStateCall struct {
// GetOnboardingState: Retrieve the OnboardingState of a resource.
//
-// - name: The name of the OnboardingState to retrieve. Formats: *
-// organizations/{organization}/onboardingState *
-// folders/{folder}/onboardingState *
-// projects/{project}/onboardingState.
+// - name: The name of the OnboardingState to retrieve. Formats: *
+// organizations/{organization}/onboardingState *
+// folders/{folder}/onboardingState *
+// projects/{project}/onboardingState.
func (r *FoldersService) GetOnboardingState(name string) *FoldersGetOnboardingStateCall {
c := &FoldersGetOnboardingStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3991,11 +4121,11 @@ type FoldersGetRapidVulnerabilityDetectionSettingsCall struct {
// GetRapidVulnerabilityDetectionSettings: Get the
// RapidVulnerabilityDetectionSettings resource.
//
-// - name: The name of the RapidVulnerabilityDetectionSettings to
-// retrieve. Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The name of the RapidVulnerabilityDetectionSettings to
+// retrieve. Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *FoldersService) GetRapidVulnerabilityDetectionSettings(name string) *FoldersGetRapidVulnerabilityDetectionSettingsCall {
c := &FoldersGetRapidVulnerabilityDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4142,10 +4272,10 @@ type FoldersGetSecurityCenterSettingsCall struct {
// GetSecurityCenterSettings: Get the SecurityCenterSettings resource.
//
-// - name: The name of the SecurityCenterSettings to retrieve. Format:
-// organizations/{organization}/securityCenterSettings Format:
-// folders/{folder}/securityCenterSettings Format:
-// projects/{project}/securityCenterSettings.
+// - name: The name of the SecurityCenterSettings to retrieve. Format:
+// organizations/{organization}/securityCenterSettings Format:
+// folders/{folder}/securityCenterSettings Format:
+// projects/{project}/securityCenterSettings.
func (r *FoldersService) GetSecurityCenterSettings(name string) *FoldersGetSecurityCenterSettingsCall {
c := &FoldersGetSecurityCenterSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4292,11 +4422,11 @@ type FoldersGetSecurityHealthAnalyticsSettingsCall struct {
// GetSecurityHealthAnalyticsSettings: Get the
// SecurityHealthAnalyticsSettings resource.
//
-// - name: The name of the SecurityHealthAnalyticsSettings to retrieve.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The name of the SecurityHealthAnalyticsSettings to retrieve.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *FoldersService) GetSecurityHealthAnalyticsSettings(name string) *FoldersGetSecurityHealthAnalyticsSettingsCall {
c := &FoldersGetSecurityHealthAnalyticsSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4443,11 +4573,11 @@ type FoldersGetVirtualMachineThreatDetectionSettingsCall struct {
// GetVirtualMachineThreatDetectionSettings: Get the
// VirtualMachineThreatDetectionSettings resource.
//
-// - name: The name of the VirtualMachineThreatDetectionSettings to
-// retrieve. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The name of the VirtualMachineThreatDetectionSettings to
+// retrieve. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *FoldersService) GetVirtualMachineThreatDetectionSettings(name string) *FoldersGetVirtualMachineThreatDetectionSettingsCall {
c := &FoldersGetVirtualMachineThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4595,10 +4725,10 @@ type FoldersGetWebSecurityScannerSettingsCall struct {
// GetWebSecurityScannerSettings: Get the WebSecurityScannerSettings
// resource.
//
-// - name: The name of the WebSecurityScannerSettings to retrieve.
-// Formats: * organizations/{organization}/webSecurityScannerSettings
-// * folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - name: The name of the WebSecurityScannerSettings to retrieve.
+// Formats: * organizations/{organization}/webSecurityScannerSettings
+// - folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *FoldersService) GetWebSecurityScannerSettings(name string) *FoldersGetWebSecurityScannerSettingsCall {
c := &FoldersGetWebSecurityScannerSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4745,13 +4875,13 @@ type FoldersUpdateContainerThreatDetectionSettingsCall struct {
// UpdateContainerThreatDetectionSettings: Update the
// ContainerThreatDetectionSettings resource.
//
-// - name: The resource name of the ContainerThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The resource name of the ContainerThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *FoldersService) UpdateContainerThreatDetectionSettings(name string, containerthreatdetectionsettings *ContainerThreatDetectionSettings) *FoldersUpdateContainerThreatDetectionSettingsCall {
c := &FoldersUpdateContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4907,11 +5037,11 @@ type FoldersUpdateEventThreatDetectionSettingsCall struct {
// UpdateEventThreatDetectionSettings: Update the
// EventThreatDetectionSettings resource.
//
-// - name: The resource name of the EventThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The resource name of the EventThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *FoldersService) UpdateEventThreatDetectionSettings(name string, eventthreatdetectionsettings *EventThreatDetectionSettings) *FoldersUpdateEventThreatDetectionSettingsCall {
c := &FoldersUpdateEventThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5067,11 +5197,11 @@ type FoldersUpdateRapidVulnerabilityDetectionSettingsCall struct {
// UpdateRapidVulnerabilityDetectionSettings: Update the
// RapidVulnerabilityDetectionSettings resource.
//
-// - name: The resource name of the RapidVulnerabilityDetectionSettings.
-// Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The resource name of the RapidVulnerabilityDetectionSettings.
+// Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *FoldersService) UpdateRapidVulnerabilityDetectionSettings(name string, rapidvulnerabilitydetectionsettings *RapidVulnerabilityDetectionSettings) *FoldersUpdateRapidVulnerabilityDetectionSettingsCall {
c := &FoldersUpdateRapidVulnerabilityDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5228,11 +5358,11 @@ type FoldersUpdateSecurityHealthAnalyticsSettingsCall struct {
// UpdateSecurityHealthAnalyticsSettings: Update the
// SecurityHealthAnalyticsSettings resource.
//
-// - name: The resource name of the SecurityHealthAnalyticsSettings.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The resource name of the SecurityHealthAnalyticsSettings.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *FoldersService) UpdateSecurityHealthAnalyticsSettings(name string, securityhealthanalyticssettings *SecurityHealthAnalyticsSettings) *FoldersUpdateSecurityHealthAnalyticsSettingsCall {
c := &FoldersUpdateSecurityHealthAnalyticsSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5388,11 +5518,11 @@ type FoldersUpdateVirtualMachineThreatDetectionSettingsCall struct {
// UpdateVirtualMachineThreatDetectionSettings: Update the
// VirtualMachineThreatDetectionSettings resource.
//
-// - name: The resource name of the
-// VirtualMachineThreatDetectionSettings. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The resource name of the
+// VirtualMachineThreatDetectionSettings. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *FoldersService) UpdateVirtualMachineThreatDetectionSettings(name string, virtualmachinethreatdetectionsettings *VirtualMachineThreatDetectionSettings) *FoldersUpdateVirtualMachineThreatDetectionSettingsCall {
c := &FoldersUpdateVirtualMachineThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5550,9 +5680,9 @@ type FoldersUpdateWebSecurityScannerSettingsCall struct {
// WebSecurityScannerSettings resource.
//
// - name: The resource name of the WebSecurityScannerSettings. Formats:
-// * organizations/{organization}/webSecurityScannerSettings *
-// folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - organizations/{organization}/webSecurityScannerSettings *
+// folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *FoldersService) UpdateWebSecurityScannerSettings(name string, websecurityscannersettings *WebSecurityScannerSettings) *FoldersUpdateWebSecurityScannerSettingsCall {
c := &FoldersUpdateWebSecurityScannerSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5708,13 +5838,13 @@ type FoldersContainerThreatDetectionSettingsCalculateCall struct {
// Calculate: Calculates the effective ContainerThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the ContainerThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *FoldersContainerThreatDetectionSettingsService) Calculate(name string) *FoldersContainerThreatDetectionSettingsCalculateCall {
c := &FoldersContainerThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5861,11 +5991,11 @@ type FoldersEventThreatDetectionSettingsCalculateCall struct {
// Calculate: Calculates the effective EventThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the EventThreatDetectionSettings to calculate.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The name of the EventThreatDetectionSettings to calculate.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *FoldersEventThreatDetectionSettingsService) Calculate(name string) *FoldersEventThreatDetectionSettingsCalculateCall {
c := &FoldersEventThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6013,11 +6143,11 @@ type FoldersRapidVulnerabilityDetectionSettingsCalculateCall struct {
// RapidVulnerabilityDetectionSettings based on its level in the
// resource hierarchy and its settings.
//
-// - name: The name of the RapidVulnerabilityDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The name of the RapidVulnerabilityDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *FoldersRapidVulnerabilityDetectionSettingsService) Calculate(name string) *FoldersRapidVulnerabilityDetectionSettingsCalculateCall {
c := &FoldersRapidVulnerabilityDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6165,11 +6295,11 @@ type FoldersSecurityHealthAnalyticsSettingsCalculateCall struct {
// Calculate: Calculates the effective SecurityHealthAnalyticsSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the SecurityHealthAnalyticsSettings to calculate.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The name of the SecurityHealthAnalyticsSettings to calculate.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *FoldersSecurityHealthAnalyticsSettingsService) Calculate(name string) *FoldersSecurityHealthAnalyticsSettingsCalculateCall {
c := &FoldersSecurityHealthAnalyticsSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6317,11 +6447,11 @@ type FoldersVirtualMachineThreatDetectionSettingsCalculateCall struct {
// VirtualMachineThreatDetectionSettings based on its level in the
// resource hierarchy and its settings.
//
-// - name: The name of the VirtualMachineThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The name of the VirtualMachineThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *FoldersVirtualMachineThreatDetectionSettingsService) Calculate(name string) *FoldersVirtualMachineThreatDetectionSettingsCalculateCall {
c := &FoldersVirtualMachineThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6469,10 +6599,10 @@ type FoldersWebSecurityScannerSettingsCalculateCall struct {
// Calculate: Calculates the effective WebSecurityScannerSettings based
// on its level in the resource hierarchy and its settings.
//
-// - name: The name of the WebSecurityScannerSettings to calculate.
-// Formats: * organizations/{organization}/webSecurityScannerSettings
-// * folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - name: The name of the WebSecurityScannerSettings to calculate.
+// Formats: * organizations/{organization}/webSecurityScannerSettings
+// - folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *FoldersWebSecurityScannerSettingsService) Calculate(name string) *FoldersWebSecurityScannerSettingsCalculateCall {
c := &FoldersWebSecurityScannerSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6619,13 +6749,13 @@ type OrganizationsGetContainerThreatDetectionSettingsCall struct {
// GetContainerThreatDetectionSettings: Get the
// ContainerThreatDetectionSettings resource.
//
-// - name: The name of the ContainerThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *OrganizationsService) GetContainerThreatDetectionSettings(name string) *OrganizationsGetContainerThreatDetectionSettingsCall {
c := &OrganizationsGetContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6772,11 +6902,11 @@ type OrganizationsGetEventThreatDetectionSettingsCall struct {
// GetEventThreatDetectionSettings: Get the EventThreatDetectionSettings
// resource.
//
-// - name: The name of the EventThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The name of the EventThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *OrganizationsService) GetEventThreatDetectionSettings(name string) *OrganizationsGetEventThreatDetectionSettingsCall {
c := &OrganizationsGetEventThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6922,10 +7052,10 @@ type OrganizationsGetOnboardingStateCall struct {
// GetOnboardingState: Retrieve the OnboardingState of a resource.
//
-// - name: The name of the OnboardingState to retrieve. Formats: *
-// organizations/{organization}/onboardingState *
-// folders/{folder}/onboardingState *
-// projects/{project}/onboardingState.
+// - name: The name of the OnboardingState to retrieve. Formats: *
+// organizations/{organization}/onboardingState *
+// folders/{folder}/onboardingState *
+// projects/{project}/onboardingState.
func (r *OrganizationsService) GetOnboardingState(name string) *OrganizationsGetOnboardingStateCall {
c := &OrganizationsGetOnboardingStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7072,11 +7202,11 @@ type OrganizationsGetRapidVulnerabilityDetectionSettingsCall struct {
// GetRapidVulnerabilityDetectionSettings: Get the
// RapidVulnerabilityDetectionSettings resource.
//
-// - name: The name of the RapidVulnerabilityDetectionSettings to
-// retrieve. Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The name of the RapidVulnerabilityDetectionSettings to
+// retrieve. Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *OrganizationsService) GetRapidVulnerabilityDetectionSettings(name string) *OrganizationsGetRapidVulnerabilityDetectionSettingsCall {
c := &OrganizationsGetRapidVulnerabilityDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7223,10 +7353,10 @@ type OrganizationsGetSecurityCenterSettingsCall struct {
// GetSecurityCenterSettings: Get the SecurityCenterSettings resource.
//
-// - name: The name of the SecurityCenterSettings to retrieve. Format:
-// organizations/{organization}/securityCenterSettings Format:
-// folders/{folder}/securityCenterSettings Format:
-// projects/{project}/securityCenterSettings.
+// - name: The name of the SecurityCenterSettings to retrieve. Format:
+// organizations/{organization}/securityCenterSettings Format:
+// folders/{folder}/securityCenterSettings Format:
+// projects/{project}/securityCenterSettings.
func (r *OrganizationsService) GetSecurityCenterSettings(name string) *OrganizationsGetSecurityCenterSettingsCall {
c := &OrganizationsGetSecurityCenterSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7373,11 +7503,11 @@ type OrganizationsGetSecurityHealthAnalyticsSettingsCall struct {
// GetSecurityHealthAnalyticsSettings: Get the
// SecurityHealthAnalyticsSettings resource.
//
-// - name: The name of the SecurityHealthAnalyticsSettings to retrieve.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The name of the SecurityHealthAnalyticsSettings to retrieve.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *OrganizationsService) GetSecurityHealthAnalyticsSettings(name string) *OrganizationsGetSecurityHealthAnalyticsSettingsCall {
c := &OrganizationsGetSecurityHealthAnalyticsSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7523,8 +7653,8 @@ type OrganizationsGetSubscriptionCall struct {
// GetSubscription: Get the Subscription resource.
//
-// - name: The name of the subscription to retrieve. Format:
-// organizations/{organization}/subscription.
+// - name: The name of the subscription to retrieve. Format:
+// organizations/{organization}/subscription.
func (r *OrganizationsService) GetSubscription(name string) *OrganizationsGetSubscriptionCall {
c := &OrganizationsGetSubscriptionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7671,11 +7801,11 @@ type OrganizationsGetVirtualMachineThreatDetectionSettingsCall struct {
// GetVirtualMachineThreatDetectionSettings: Get the
// VirtualMachineThreatDetectionSettings resource.
//
-// - name: The name of the VirtualMachineThreatDetectionSettings to
-// retrieve. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The name of the VirtualMachineThreatDetectionSettings to
+// retrieve. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *OrganizationsService) GetVirtualMachineThreatDetectionSettings(name string) *OrganizationsGetVirtualMachineThreatDetectionSettingsCall {
c := &OrganizationsGetVirtualMachineThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7823,10 +7953,10 @@ type OrganizationsGetWebSecurityScannerSettingsCall struct {
// GetWebSecurityScannerSettings: Get the WebSecurityScannerSettings
// resource.
//
-// - name: The name of the WebSecurityScannerSettings to retrieve.
-// Formats: * organizations/{organization}/webSecurityScannerSettings
-// * folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - name: The name of the WebSecurityScannerSettings to retrieve.
+// Formats: * organizations/{organization}/webSecurityScannerSettings
+// - folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *OrganizationsService) GetWebSecurityScannerSettings(name string) *OrganizationsGetWebSecurityScannerSettingsCall {
c := &OrganizationsGetWebSecurityScannerSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7973,13 +8103,13 @@ type OrganizationsUpdateContainerThreatDetectionSettingsCall struct {
// UpdateContainerThreatDetectionSettings: Update the
// ContainerThreatDetectionSettings resource.
//
-// - name: The resource name of the ContainerThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The resource name of the ContainerThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *OrganizationsService) UpdateContainerThreatDetectionSettings(name string, containerthreatdetectionsettings *ContainerThreatDetectionSettings) *OrganizationsUpdateContainerThreatDetectionSettingsCall {
c := &OrganizationsUpdateContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8135,11 +8265,11 @@ type OrganizationsUpdateEventThreatDetectionSettingsCall struct {
// UpdateEventThreatDetectionSettings: Update the
// EventThreatDetectionSettings resource.
//
-// - name: The resource name of the EventThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The resource name of the EventThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *OrganizationsService) UpdateEventThreatDetectionSettings(name string, eventthreatdetectionsettings *EventThreatDetectionSettings) *OrganizationsUpdateEventThreatDetectionSettingsCall {
c := &OrganizationsUpdateEventThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8295,11 +8425,11 @@ type OrganizationsUpdateRapidVulnerabilityDetectionSettingsCall struct {
// UpdateRapidVulnerabilityDetectionSettings: Update the
// RapidVulnerabilityDetectionSettings resource.
//
-// - name: The resource name of the RapidVulnerabilityDetectionSettings.
-// Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The resource name of the RapidVulnerabilityDetectionSettings.
+// Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *OrganizationsService) UpdateRapidVulnerabilityDetectionSettings(name string, rapidvulnerabilitydetectionsettings *RapidVulnerabilityDetectionSettings) *OrganizationsUpdateRapidVulnerabilityDetectionSettingsCall {
c := &OrganizationsUpdateRapidVulnerabilityDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8456,11 +8586,11 @@ type OrganizationsUpdateSecurityHealthAnalyticsSettingsCall struct {
// UpdateSecurityHealthAnalyticsSettings: Update the
// SecurityHealthAnalyticsSettings resource.
//
-// - name: The resource name of the SecurityHealthAnalyticsSettings.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The resource name of the SecurityHealthAnalyticsSettings.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *OrganizationsService) UpdateSecurityHealthAnalyticsSettings(name string, securityhealthanalyticssettings *SecurityHealthAnalyticsSettings) *OrganizationsUpdateSecurityHealthAnalyticsSettingsCall {
c := &OrganizationsUpdateSecurityHealthAnalyticsSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8616,11 +8746,11 @@ type OrganizationsUpdateVirtualMachineThreatDetectionSettingsCall struct {
// UpdateVirtualMachineThreatDetectionSettings: Update the
// VirtualMachineThreatDetectionSettings resource.
//
-// - name: The resource name of the
-// VirtualMachineThreatDetectionSettings. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The resource name of the
+// VirtualMachineThreatDetectionSettings. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *OrganizationsService) UpdateVirtualMachineThreatDetectionSettings(name string, virtualmachinethreatdetectionsettings *VirtualMachineThreatDetectionSettings) *OrganizationsUpdateVirtualMachineThreatDetectionSettingsCall {
c := &OrganizationsUpdateVirtualMachineThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8778,9 +8908,9 @@ type OrganizationsUpdateWebSecurityScannerSettingsCall struct {
// WebSecurityScannerSettings resource.
//
// - name: The resource name of the WebSecurityScannerSettings. Formats:
-// * organizations/{organization}/webSecurityScannerSettings *
-// folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - organizations/{organization}/webSecurityScannerSettings *
+// folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *OrganizationsService) UpdateWebSecurityScannerSettings(name string, websecurityscannersettings *WebSecurityScannerSettings) *OrganizationsUpdateWebSecurityScannerSettingsCall {
c := &OrganizationsUpdateWebSecurityScannerSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8936,13 +9066,13 @@ type OrganizationsContainerThreatDetectionSettingsCalculateCall struct {
// Calculate: Calculates the effective ContainerThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the ContainerThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *OrganizationsContainerThreatDetectionSettingsService) Calculate(name string) *OrganizationsContainerThreatDetectionSettingsCalculateCall {
c := &OrganizationsContainerThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9089,11 +9219,11 @@ type OrganizationsEventThreatDetectionSettingsCalculateCall struct {
// Calculate: Calculates the effective EventThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the EventThreatDetectionSettings to calculate.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The name of the EventThreatDetectionSettings to calculate.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *OrganizationsEventThreatDetectionSettingsService) Calculate(name string) *OrganizationsEventThreatDetectionSettingsCalculateCall {
c := &OrganizationsEventThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9241,11 +9371,11 @@ type OrganizationsRapidVulnerabilityDetectionSettingsCalculateCall struct {
// RapidVulnerabilityDetectionSettings based on its level in the
// resource hierarchy and its settings.
//
-// - name: The name of the RapidVulnerabilityDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The name of the RapidVulnerabilityDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *OrganizationsRapidVulnerabilityDetectionSettingsService) Calculate(name string) *OrganizationsRapidVulnerabilityDetectionSettingsCalculateCall {
c := &OrganizationsRapidVulnerabilityDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9393,11 +9523,11 @@ type OrganizationsSecurityHealthAnalyticsSettingsCalculateCall struct {
// Calculate: Calculates the effective SecurityHealthAnalyticsSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the SecurityHealthAnalyticsSettings to calculate.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The name of the SecurityHealthAnalyticsSettings to calculate.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *OrganizationsSecurityHealthAnalyticsSettingsService) Calculate(name string) *OrganizationsSecurityHealthAnalyticsSettingsCalculateCall {
c := &OrganizationsSecurityHealthAnalyticsSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9545,11 +9675,11 @@ type OrganizationsVirtualMachineThreatDetectionSettingsCalculateCall struct {
// VirtualMachineThreatDetectionSettings based on its level in the
// resource hierarchy and its settings.
//
-// - name: The name of the VirtualMachineThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The name of the VirtualMachineThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *OrganizationsVirtualMachineThreatDetectionSettingsService) Calculate(name string) *OrganizationsVirtualMachineThreatDetectionSettingsCalculateCall {
c := &OrganizationsVirtualMachineThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9697,10 +9827,10 @@ type OrganizationsWebSecurityScannerSettingsCalculateCall struct {
// Calculate: Calculates the effective WebSecurityScannerSettings based
// on its level in the resource hierarchy and its settings.
//
-// - name: The name of the WebSecurityScannerSettings to calculate.
-// Formats: * organizations/{organization}/webSecurityScannerSettings
-// * folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - name: The name of the WebSecurityScannerSettings to calculate.
+// Formats: * organizations/{organization}/webSecurityScannerSettings
+// - folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *OrganizationsWebSecurityScannerSettingsService) Calculate(name string) *OrganizationsWebSecurityScannerSettingsCalculateCall {
c := &OrganizationsWebSecurityScannerSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -9847,13 +9977,13 @@ type ProjectsGetContainerThreatDetectionSettingsCall struct {
// GetContainerThreatDetectionSettings: Get the
// ContainerThreatDetectionSettings resource.
//
-// - name: The name of the ContainerThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *ProjectsService) GetContainerThreatDetectionSettings(name string) *ProjectsGetContainerThreatDetectionSettingsCall {
c := &ProjectsGetContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10000,11 +10130,11 @@ type ProjectsGetEventThreatDetectionSettingsCall struct {
// GetEventThreatDetectionSettings: Get the EventThreatDetectionSettings
// resource.
//
-// - name: The name of the EventThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The name of the EventThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *ProjectsService) GetEventThreatDetectionSettings(name string) *ProjectsGetEventThreatDetectionSettingsCall {
c := &ProjectsGetEventThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10150,10 +10280,10 @@ type ProjectsGetOnboardingStateCall struct {
// GetOnboardingState: Retrieve the OnboardingState of a resource.
//
-// - name: The name of the OnboardingState to retrieve. Formats: *
-// organizations/{organization}/onboardingState *
-// folders/{folder}/onboardingState *
-// projects/{project}/onboardingState.
+// - name: The name of the OnboardingState to retrieve. Formats: *
+// organizations/{organization}/onboardingState *
+// folders/{folder}/onboardingState *
+// projects/{project}/onboardingState.
func (r *ProjectsService) GetOnboardingState(name string) *ProjectsGetOnboardingStateCall {
c := &ProjectsGetOnboardingStateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10300,11 +10430,11 @@ type ProjectsGetRapidVulnerabilityDetectionSettingsCall struct {
// GetRapidVulnerabilityDetectionSettings: Get the
// RapidVulnerabilityDetectionSettings resource.
//
-// - name: The name of the RapidVulnerabilityDetectionSettings to
-// retrieve. Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The name of the RapidVulnerabilityDetectionSettings to
+// retrieve. Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *ProjectsService) GetRapidVulnerabilityDetectionSettings(name string) *ProjectsGetRapidVulnerabilityDetectionSettingsCall {
c := &ProjectsGetRapidVulnerabilityDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10451,10 +10581,10 @@ type ProjectsGetSecurityCenterSettingsCall struct {
// GetSecurityCenterSettings: Get the SecurityCenterSettings resource.
//
-// - name: The name of the SecurityCenterSettings to retrieve. Format:
-// organizations/{organization}/securityCenterSettings Format:
-// folders/{folder}/securityCenterSettings Format:
-// projects/{project}/securityCenterSettings.
+// - name: The name of the SecurityCenterSettings to retrieve. Format:
+// organizations/{organization}/securityCenterSettings Format:
+// folders/{folder}/securityCenterSettings Format:
+// projects/{project}/securityCenterSettings.
func (r *ProjectsService) GetSecurityCenterSettings(name string) *ProjectsGetSecurityCenterSettingsCall {
c := &ProjectsGetSecurityCenterSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10601,11 +10731,11 @@ type ProjectsGetSecurityHealthAnalyticsSettingsCall struct {
// GetSecurityHealthAnalyticsSettings: Get the
// SecurityHealthAnalyticsSettings resource.
//
-// - name: The name of the SecurityHealthAnalyticsSettings to retrieve.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The name of the SecurityHealthAnalyticsSettings to retrieve.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *ProjectsService) GetSecurityHealthAnalyticsSettings(name string) *ProjectsGetSecurityHealthAnalyticsSettingsCall {
c := &ProjectsGetSecurityHealthAnalyticsSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10752,11 +10882,11 @@ type ProjectsGetVirtualMachineThreatDetectionSettingsCall struct {
// GetVirtualMachineThreatDetectionSettings: Get the
// VirtualMachineThreatDetectionSettings resource.
//
-// - name: The name of the VirtualMachineThreatDetectionSettings to
-// retrieve. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The name of the VirtualMachineThreatDetectionSettings to
+// retrieve. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *ProjectsService) GetVirtualMachineThreatDetectionSettings(name string) *ProjectsGetVirtualMachineThreatDetectionSettingsCall {
c := &ProjectsGetVirtualMachineThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -10904,10 +11034,10 @@ type ProjectsGetWebSecurityScannerSettingsCall struct {
// GetWebSecurityScannerSettings: Get the WebSecurityScannerSettings
// resource.
//
-// - name: The name of the WebSecurityScannerSettings to retrieve.
-// Formats: * organizations/{organization}/webSecurityScannerSettings
-// * folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - name: The name of the WebSecurityScannerSettings to retrieve.
+// Formats: * organizations/{organization}/webSecurityScannerSettings
+// - folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *ProjectsService) GetWebSecurityScannerSettings(name string) *ProjectsGetWebSecurityScannerSettingsCall {
c := &ProjectsGetWebSecurityScannerSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11054,13 +11184,13 @@ type ProjectsUpdateContainerThreatDetectionSettingsCall struct {
// UpdateContainerThreatDetectionSettings: Update the
// ContainerThreatDetectionSettings resource.
//
-// - name: The resource name of the ContainerThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The resource name of the ContainerThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *ProjectsService) UpdateContainerThreatDetectionSettings(name string, containerthreatdetectionsettings *ContainerThreatDetectionSettings) *ProjectsUpdateContainerThreatDetectionSettingsCall {
c := &ProjectsUpdateContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11216,11 +11346,11 @@ type ProjectsUpdateEventThreatDetectionSettingsCall struct {
// UpdateEventThreatDetectionSettings: Update the
// EventThreatDetectionSettings resource.
//
-// - name: The resource name of the EventThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The resource name of the EventThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *ProjectsService) UpdateEventThreatDetectionSettings(name string, eventthreatdetectionsettings *EventThreatDetectionSettings) *ProjectsUpdateEventThreatDetectionSettingsCall {
c := &ProjectsUpdateEventThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11376,11 +11506,11 @@ type ProjectsUpdateRapidVulnerabilityDetectionSettingsCall struct {
// UpdateRapidVulnerabilityDetectionSettings: Update the
// RapidVulnerabilityDetectionSettings resource.
//
-// - name: The resource name of the RapidVulnerabilityDetectionSettings.
-// Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The resource name of the RapidVulnerabilityDetectionSettings.
+// Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *ProjectsService) UpdateRapidVulnerabilityDetectionSettings(name string, rapidvulnerabilitydetectionsettings *RapidVulnerabilityDetectionSettings) *ProjectsUpdateRapidVulnerabilityDetectionSettingsCall {
c := &ProjectsUpdateRapidVulnerabilityDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11537,11 +11667,11 @@ type ProjectsUpdateSecurityHealthAnalyticsSettingsCall struct {
// UpdateSecurityHealthAnalyticsSettings: Update the
// SecurityHealthAnalyticsSettings resource.
//
-// - name: The resource name of the SecurityHealthAnalyticsSettings.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The resource name of the SecurityHealthAnalyticsSettings.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *ProjectsService) UpdateSecurityHealthAnalyticsSettings(name string, securityhealthanalyticssettings *SecurityHealthAnalyticsSettings) *ProjectsUpdateSecurityHealthAnalyticsSettingsCall {
c := &ProjectsUpdateSecurityHealthAnalyticsSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11697,11 +11827,11 @@ type ProjectsUpdateVirtualMachineThreatDetectionSettingsCall struct {
// UpdateVirtualMachineThreatDetectionSettings: Update the
// VirtualMachineThreatDetectionSettings resource.
//
-// - name: The resource name of the
-// VirtualMachineThreatDetectionSettings. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The resource name of the
+// VirtualMachineThreatDetectionSettings. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *ProjectsService) UpdateVirtualMachineThreatDetectionSettings(name string, virtualmachinethreatdetectionsettings *VirtualMachineThreatDetectionSettings) *ProjectsUpdateVirtualMachineThreatDetectionSettingsCall {
c := &ProjectsUpdateVirtualMachineThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11859,9 +11989,9 @@ type ProjectsUpdateWebSecurityScannerSettingsCall struct {
// WebSecurityScannerSettings resource.
//
// - name: The resource name of the WebSecurityScannerSettings. Formats:
-// * organizations/{organization}/webSecurityScannerSettings *
-// folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - organizations/{organization}/webSecurityScannerSettings *
+// folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *ProjectsService) UpdateWebSecurityScannerSettings(name string, websecurityscannersettings *WebSecurityScannerSettings) *ProjectsUpdateWebSecurityScannerSettingsCall {
c := &ProjectsUpdateWebSecurityScannerSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12017,13 +12147,13 @@ type ProjectsContainerThreatDetectionSettingsCalculateCall struct {
// Calculate: Calculates the effective ContainerThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the ContainerThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *ProjectsContainerThreatDetectionSettingsService) Calculate(name string) *ProjectsContainerThreatDetectionSettingsCalculateCall {
c := &ProjectsContainerThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12170,11 +12300,11 @@ type ProjectsEventThreatDetectionSettingsCalculateCall struct {
// Calculate: Calculates the effective EventThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the EventThreatDetectionSettings to calculate.
-// Formats: *
-// organizations/{organization}/eventThreatDetectionSettings *
-// folders/{folder}/eventThreatDetectionSettings *
-// projects/{project}/eventThreatDetectionSettings.
+// - name: The name of the EventThreatDetectionSettings to calculate.
+// Formats: *
+// organizations/{organization}/eventThreatDetectionSettings *
+// folders/{folder}/eventThreatDetectionSettings *
+// projects/{project}/eventThreatDetectionSettings.
func (r *ProjectsEventThreatDetectionSettingsService) Calculate(name string) *ProjectsEventThreatDetectionSettingsCalculateCall {
c := &ProjectsEventThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12321,13 +12451,13 @@ type ProjectsLocationsClustersGetContainerThreatDetectionSettingsCall struct {
// GetContainerThreatDetectionSettings: Get the
// ContainerThreatDetectionSettings resource.
//
-// - name: The name of the ContainerThreatDetectionSettings to retrieve.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to retrieve.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *ProjectsLocationsClustersService) GetContainerThreatDetectionSettings(name string) *ProjectsLocationsClustersGetContainerThreatDetectionSettingsCall {
c := &ProjectsLocationsClustersGetContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12474,13 +12604,13 @@ type ProjectsLocationsClustersUpdateContainerThreatDetectionSettingsCall struct
// UpdateContainerThreatDetectionSettings: Update the
// ContainerThreatDetectionSettings resource.
//
-// - name: The resource name of the ContainerThreatDetectionSettings.
-// Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The resource name of the ContainerThreatDetectionSettings.
+// Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *ProjectsLocationsClustersService) UpdateContainerThreatDetectionSettings(name string, containerthreatdetectionsettings *ContainerThreatDetectionSettings) *ProjectsLocationsClustersUpdateContainerThreatDetectionSettingsCall {
c := &ProjectsLocationsClustersUpdateContainerThreatDetectionSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12636,13 +12766,13 @@ type ProjectsLocationsClustersContainerThreatDetectionSettingsCalculateCall stru
// Calculate: Calculates the effective ContainerThreatDetectionSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the ContainerThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/containerThreatDetectionSettings *
-// folders/{folder}/containerThreatDetectionSettings *
-// projects/{project}/containerThreatDetectionSettings *
-// projects/{project}/locations/{location}/clusters/{cluster}/container
-// ThreatDetectionSettings.
+// - name: The name of the ContainerThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/containerThreatDetectionSettings *
+// folders/{folder}/containerThreatDetectionSettings *
+// projects/{project}/containerThreatDetectionSettings *
+// projects/{project}/locations/{location}/clusters/{cluster}/container
+// ThreatDetectionSettings.
func (r *ProjectsLocationsClustersContainerThreatDetectionSettingsService) Calculate(name string) *ProjectsLocationsClustersContainerThreatDetectionSettingsCalculateCall {
c := &ProjectsLocationsClustersContainerThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12790,11 +12920,11 @@ type ProjectsRapidVulnerabilityDetectionSettingsCalculateCall struct {
// RapidVulnerabilityDetectionSettings based on its level in the
// resource hierarchy and its settings.
//
-// - name: The name of the RapidVulnerabilityDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/rapidVulnerabilityDetectionSettings *
-// folders/{folder}/rapidVulnerabilityDetectionSettings *
-// projects/{project}/rapidVulnerabilityDetectionSettings.
+// - name: The name of the RapidVulnerabilityDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/rapidVulnerabilityDetectionSettings *
+// folders/{folder}/rapidVulnerabilityDetectionSettings *
+// projects/{project}/rapidVulnerabilityDetectionSettings.
func (r *ProjectsRapidVulnerabilityDetectionSettingsService) Calculate(name string) *ProjectsRapidVulnerabilityDetectionSettingsCalculateCall {
c := &ProjectsRapidVulnerabilityDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -12942,11 +13072,11 @@ type ProjectsSecurityHealthAnalyticsSettingsCalculateCall struct {
// Calculate: Calculates the effective SecurityHealthAnalyticsSettings
// based on its level in the resource hierarchy and its settings.
//
-// - name: The name of the SecurityHealthAnalyticsSettings to calculate.
-// Formats: *
-// organizations/{organization}/securityHealthAnalyticsSettings *
-// folders/{folder}/securityHealthAnalyticsSettings *
-// projects/{project}/securityHealthAnalyticsSettings.
+// - name: The name of the SecurityHealthAnalyticsSettings to calculate.
+// Formats: *
+// organizations/{organization}/securityHealthAnalyticsSettings *
+// folders/{folder}/securityHealthAnalyticsSettings *
+// projects/{project}/securityHealthAnalyticsSettings.
func (r *ProjectsSecurityHealthAnalyticsSettingsService) Calculate(name string) *ProjectsSecurityHealthAnalyticsSettingsCalculateCall {
c := &ProjectsSecurityHealthAnalyticsSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13094,11 +13224,11 @@ type ProjectsVirtualMachineThreatDetectionSettingsCalculateCall struct {
// VirtualMachineThreatDetectionSettings based on its level in the
// resource hierarchy and its settings.
//
-// - name: The name of the VirtualMachineThreatDetectionSettings to
-// calculate. Formats: *
-// organizations/{organization}/virtualMachineThreatDetectionSettings
-// * folders/{folder}/virtualMachineThreatDetectionSettings *
-// projects/{project}/virtualMachineThreatDetectionSettings.
+// - name: The name of the VirtualMachineThreatDetectionSettings to
+// calculate. Formats: *
+// organizations/{organization}/virtualMachineThreatDetectionSettings
+// - folders/{folder}/virtualMachineThreatDetectionSettings *
+// projects/{project}/virtualMachineThreatDetectionSettings.
func (r *ProjectsVirtualMachineThreatDetectionSettingsService) Calculate(name string) *ProjectsVirtualMachineThreatDetectionSettingsCalculateCall {
c := &ProjectsVirtualMachineThreatDetectionSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -13246,10 +13376,10 @@ type ProjectsWebSecurityScannerSettingsCalculateCall struct {
// Calculate: Calculates the effective WebSecurityScannerSettings based
// on its level in the resource hierarchy and its settings.
//
-// - name: The name of the WebSecurityScannerSettings to calculate.
-// Formats: * organizations/{organization}/webSecurityScannerSettings
-// * folders/{folder}/webSecurityScannerSettings *
-// projects/{project}/webSecurityScannerSettings.
+// - name: The name of the WebSecurityScannerSettings to calculate.
+// Formats: * organizations/{organization}/webSecurityScannerSettings
+// - folders/{folder}/webSecurityScannerSettings *
+// projects/{project}/webSecurityScannerSettings.
func (r *ProjectsWebSecurityScannerSettingsService) Calculate(name string) *ProjectsWebSecurityScannerSettingsCalculateCall {
c := &ProjectsWebSecurityScannerSettingsCalculateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/securitycenter/v1p1alpha1/securitycenter-gen.go b/securitycenter/v1p1alpha1/securitycenter-gen.go
index 053cde96aa8..7fad0db56c6 100644
--- a/securitycenter/v1p1alpha1/securitycenter-gen.go
+++ b/securitycenter/v1p1alpha1/securitycenter-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/securitycenter/v1p1alpha1"
-// ...
-// ctx := context.Background()
-// securitycenterService, err := securitycenter.NewService(ctx)
+// import "google.golang.org/api/securitycenter/v1p1alpha1"
+// ...
+// ctx := context.Background()
+// securitycenterService, err := securitycenter.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package securitycenter // import "google.golang.org/api/securitycenter/v1p1alpha1"
diff --git a/securitycenter/v1p1beta1/securitycenter-gen.go b/securitycenter/v1p1beta1/securitycenter-gen.go
index 1a4a82f1d4a..dc5d8d16e98 100644
--- a/securitycenter/v1p1beta1/securitycenter-gen.go
+++ b/securitycenter/v1p1beta1/securitycenter-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://console.cloud.google.com/apis/api/securitycenter.googleapis.com/overview
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/securitycenter/v1p1beta1"
-// ...
-// ctx := context.Background()
-// securitycenterService, err := securitycenter.NewService(ctx)
+// import "google.golang.org/api/securitycenter/v1p1beta1"
+// ...
+// ctx := context.Background()
+// securitycenterService, err := securitycenter.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// securitycenterService, err := securitycenter.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package securitycenter // import "google.golang.org/api/securitycenter/v1p1beta1"
@@ -3578,7 +3578,9 @@ func (c *OrganizationsAssetsUpdateSecurityMarksCall) doRequest(alt string) (*htt
// error will be non-nil. Any non-2xx status code is an error. Response
// headers are in either
// *GoogleCloudSecuritycenterV1p1beta1SecurityMarks.ServerResponse.Header
-// or (if a response was returned at all) in
+//
+// or (if a response was returned at all) in
+//
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
@@ -7142,7 +7144,9 @@ func (c *OrganizationsSourcesFindingsUpdateSecurityMarksCall) doRequest(alt stri
// error will be non-nil. Any non-2xx status code is an error. Response
// headers are in either
// *GoogleCloudSecuritycenterV1p1beta1SecurityMarks.ServerResponse.Header
-// or (if a response was returned at all) in
+//
+// or (if a response was returned at all) in
+//
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
diff --git a/servicebroker/v1/servicebroker-gen.go b/servicebroker/v1/servicebroker-gen.go
index 063cefd0566..c818686d8a6 100644
--- a/servicebroker/v1/servicebroker-gen.go
+++ b/servicebroker/v1/servicebroker-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/kubernetes-engine/docs/concepts/add-on/service-broker
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicebroker/v1"
-// ...
-// ctx := context.Background()
-// servicebrokerService, err := servicebroker.NewService(ctx)
+// import "google.golang.org/api/servicebroker/v1"
+// ...
+// ctx := context.Background()
+// servicebrokerService, err := servicebroker.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicebrokerService, err := servicebroker.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicebrokerService, err := servicebroker.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicebrokerService, err := servicebroker.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicebrokerService, err := servicebroker.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicebroker // import "google.golang.org/api/servicebroker/v1"
@@ -247,7 +247,6 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) {
// which specifies access
// controls for Google Cloud resources.
//
-//
// A `Policy` is a collection of `bindings`. A `binding` binds one or
// more
// `members` to a single `role`. Members can be user accounts, service
@@ -268,52 +267,56 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) {
//
// **JSON example:**
//
-// {
-// "bindings": [
-// {
-// "role": "roles/resourcemanager.organizationAdmin",
-// "members": [
-// "user:mike@example.com",
-// "group:admins@example.com",
-// "domain:google.com",
+// {
+// "bindings": [
+// {
+// "role": "roles/resourcemanager.organizationAdmin",
+// "members": [
+// "user:mike@example.com",
+// "group:admins@example.com",
+// "domain:google.com",
//
// "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-// ]
-// },
-// {
-// "role": "roles/resourcemanager.organizationViewer",
-// "members": ["user:eve@example.com"],
-// "condition": {
-// "title": "expirable access",
-// "description": "Does not grant access after Sep 2020",
-// "expression": "request.time <
+//
+// ]
+// },
+// {
+// "role": "roles/resourcemanager.organizationViewer",
+// "members": ["user:eve@example.com"],
+// "condition": {
+// "title": "expirable access",
+// "description": "Does not grant access after Sep 2020",
+// "expression": "request.time <
+//
// timestamp('2020-10-01T00:00:00.000Z')",
-// }
-// }
-// ],
-// "etag": "BwWWja0YfJA=",
-// "version": 3
-// }
+//
+// }
+// }
+// ],
+// "etag": "BwWWja0YfJA=",
+// "version": 3
+// }
//
// **YAML example:**
//
-// bindings:
-// - members:
-// - user:mike@example.com
-// - group:admins@example.com
-// - domain:google.com
-// - serviceAccount:my-project-id@appspot.gserviceaccount.com
-// role: roles/resourcemanager.organizationAdmin
-// - members:
-// - user:eve@example.com
-// role: roles/resourcemanager.organizationViewer
-// condition:
-// title: expirable access
-// description: Does not grant access after Sep 2020
-// expression: request.time <
+// bindings:
+// - members:
+// - user:mike@example.com
+// - group:admins@example.com
+// - domain:google.com
+// - serviceAccount:my-project-id@appspot.gserviceaccount.com
+// role: roles/resourcemanager.organizationAdmin
+// - members:
+// - user:eve@example.com
+// role: roles/resourcemanager.organizationViewer
+// condition:
+// title: expirable access
+// description: Does not grant access after Sep 2020
+// expression: request.time <
+//
// timestamp('2020-10-01T00:00:00.000Z')
-// - etag: BwWWja0YfJA=
-// - version: 3
+// - etag: BwWWja0YfJA=
+// - version: 3
//
// For a description of IAM and its features, see the
// [IAM documentation](https://cloud.google.com/iam/docs/).
@@ -512,9 +515,9 @@ func (s *GoogleIamV1__TestIamPermissionsResponse) MarshalJSON() ([]byte, error)
// GoogleType__Expr: Represents an expression text. Example:
//
-// title: "User account presence"
-// description: "Determines whether the request has a user account"
-// expression: "size(request.user) > 0"
+// title: "User account presence"
+// description: "Determines whether the request has a user account"
+// expression: "size(request.user) > 0"
type GoogleType__Expr struct {
// Description: An optional description of the expression. This is a
// longer text which
diff --git a/servicebroker/v1alpha1/servicebroker-gen.go b/servicebroker/v1alpha1/servicebroker-gen.go
index ae39381f430..1cd4add1721 100644
--- a/servicebroker/v1alpha1/servicebroker-gen.go
+++ b/servicebroker/v1alpha1/servicebroker-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/kubernetes-engine/docs/concepts/add-on/service-broker
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicebroker/v1alpha1"
-// ...
-// ctx := context.Background()
-// servicebrokerService, err := servicebroker.NewService(ctx)
+// import "google.golang.org/api/servicebroker/v1alpha1"
+// ...
+// ctx := context.Background()
+// servicebrokerService, err := servicebroker.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicebrokerService, err := servicebroker.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicebrokerService, err := servicebroker.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicebrokerService, err := servicebroker.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicebrokerService, err := servicebroker.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicebroker // import "google.golang.org/api/servicebroker/v1alpha1"
@@ -1154,7 +1154,6 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) {
// which specifies access
// controls for Google Cloud resources.
//
-//
// A `Policy` is a collection of `bindings`. A `binding` binds one or
// more
// `members` to a single `role`. Members can be user accounts, service
@@ -1175,52 +1174,56 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) {
//
// **JSON example:**
//
-// {
-// "bindings": [
-// {
-// "role": "roles/resourcemanager.organizationAdmin",
-// "members": [
-// "user:mike@example.com",
-// "group:admins@example.com",
-// "domain:google.com",
+// {
+// "bindings": [
+// {
+// "role": "roles/resourcemanager.organizationAdmin",
+// "members": [
+// "user:mike@example.com",
+// "group:admins@example.com",
+// "domain:google.com",
//
// "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-// ]
-// },
-// {
-// "role": "roles/resourcemanager.organizationViewer",
-// "members": ["user:eve@example.com"],
-// "condition": {
-// "title": "expirable access",
-// "description": "Does not grant access after Sep 2020",
-// "expression": "request.time <
+//
+// ]
+// },
+// {
+// "role": "roles/resourcemanager.organizationViewer",
+// "members": ["user:eve@example.com"],
+// "condition": {
+// "title": "expirable access",
+// "description": "Does not grant access after Sep 2020",
+// "expression": "request.time <
+//
// timestamp('2020-10-01T00:00:00.000Z')",
-// }
-// }
-// ],
-// "etag": "BwWWja0YfJA=",
-// "version": 3
-// }
+//
+// }
+// }
+// ],
+// "etag": "BwWWja0YfJA=",
+// "version": 3
+// }
//
// **YAML example:**
//
-// bindings:
-// - members:
-// - user:mike@example.com
-// - group:admins@example.com
-// - domain:google.com
-// - serviceAccount:my-project-id@appspot.gserviceaccount.com
-// role: roles/resourcemanager.organizationAdmin
-// - members:
-// - user:eve@example.com
-// role: roles/resourcemanager.organizationViewer
-// condition:
-// title: expirable access
-// description: Does not grant access after Sep 2020
-// expression: request.time <
+// bindings:
+// - members:
+// - user:mike@example.com
+// - group:admins@example.com
+// - domain:google.com
+// - serviceAccount:my-project-id@appspot.gserviceaccount.com
+// role: roles/resourcemanager.organizationAdmin
+// - members:
+// - user:eve@example.com
+// role: roles/resourcemanager.organizationViewer
+// condition:
+// title: expirable access
+// description: Does not grant access after Sep 2020
+// expression: request.time <
+//
// timestamp('2020-10-01T00:00:00.000Z')
-// - etag: BwWWja0YfJA=
-// - version: 3
+// - etag: BwWWja0YfJA=
+// - version: 3
//
// For a description of IAM and its features, see the
// [IAM documentation](https://cloud.google.com/iam/docs/).
@@ -1419,9 +1422,9 @@ func (s *GoogleIamV1__TestIamPermissionsResponse) MarshalJSON() ([]byte, error)
// GoogleType__Expr: Represents an expression text. Example:
//
-// title: "User account presence"
-// description: "Determines whether the request has a user account"
-// expression: "size(request.user) > 0"
+// title: "User account presence"
+// description: "Determines whether the request has a user account"
+// expression: "size(request.user) > 0"
type GoogleType__Expr struct {
// Description: An optional description of the expression. This is a
// longer text which
@@ -1640,7 +1643,8 @@ func (r *ProjectsBrokersInstancesServiceBindingsService) List(parent string) *Pr
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// If unset or 0, all the results will be returned.
+//
+// If unset or 0, all the results will be returned.
func (c *ProjectsBrokersInstancesServiceBindingsListCall) PageSize(pageSize int64) *ProjectsBrokersInstancesServiceBindingsListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -1838,7 +1842,8 @@ func (r *ProjectsBrokersServiceInstancesService) List(parent string) *ProjectsBr
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// If unset or 0, all the results will be returned.
+//
+// If unset or 0, all the results will be returned.
func (c *ProjectsBrokersServiceInstancesListCall) PageSize(pageSize int64) *ProjectsBrokersServiceInstancesListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -2038,7 +2043,8 @@ func (r *ProjectsBrokersV2CatalogService) List(parent string) *ProjectsBrokersV2
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// If unset or 0, all the results will be returned.
+//
+// If unset or 0, all the results will be returned.
func (c *ProjectsBrokersV2CatalogListCall) PageSize(pageSize int64) *ProjectsBrokersV2CatalogListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
diff --git a/servicebroker/v1beta1/servicebroker-gen.go b/servicebroker/v1beta1/servicebroker-gen.go
index df77bc6f8ee..ae3722f101a 100644
--- a/servicebroker/v1beta1/servicebroker-gen.go
+++ b/servicebroker/v1beta1/servicebroker-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/kubernetes-engine/docs/concepts/add-on/service-broker
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicebroker/v1beta1"
-// ...
-// ctx := context.Background()
-// servicebrokerService, err := servicebroker.NewService(ctx)
+// import "google.golang.org/api/servicebroker/v1beta1"
+// ...
+// ctx := context.Background()
+// servicebrokerService, err := servicebroker.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicebrokerService, err := servicebroker.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicebrokerService, err := servicebroker.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicebrokerService, err := servicebroker.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicebrokerService, err := servicebroker.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicebroker // import "google.golang.org/api/servicebroker/v1beta1"
@@ -1270,7 +1270,6 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) {
// which specifies access
// controls for Google Cloud resources.
//
-//
// A `Policy` is a collection of `bindings`. A `binding` binds one or
// more
// `members` to a single `role`. Members can be user accounts, service
@@ -1291,52 +1290,56 @@ func (s *GoogleIamV1__Binding) MarshalJSON() ([]byte, error) {
//
// **JSON example:**
//
-// {
-// "bindings": [
-// {
-// "role": "roles/resourcemanager.organizationAdmin",
-// "members": [
-// "user:mike@example.com",
-// "group:admins@example.com",
-// "domain:google.com",
+// {
+// "bindings": [
+// {
+// "role": "roles/resourcemanager.organizationAdmin",
+// "members": [
+// "user:mike@example.com",
+// "group:admins@example.com",
+// "domain:google.com",
//
// "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-// ]
-// },
-// {
-// "role": "roles/resourcemanager.organizationViewer",
-// "members": ["user:eve@example.com"],
-// "condition": {
-// "title": "expirable access",
-// "description": "Does not grant access after Sep 2020",
-// "expression": "request.time <
+//
+// ]
+// },
+// {
+// "role": "roles/resourcemanager.organizationViewer",
+// "members": ["user:eve@example.com"],
+// "condition": {
+// "title": "expirable access",
+// "description": "Does not grant access after Sep 2020",
+// "expression": "request.time <
+//
// timestamp('2020-10-01T00:00:00.000Z')",
-// }
-// }
-// ],
-// "etag": "BwWWja0YfJA=",
-// "version": 3
-// }
+//
+// }
+// }
+// ],
+// "etag": "BwWWja0YfJA=",
+// "version": 3
+// }
//
// **YAML example:**
//
-// bindings:
-// - members:
-// - user:mike@example.com
-// - group:admins@example.com
-// - domain:google.com
-// - serviceAccount:my-project-id@appspot.gserviceaccount.com
-// role: roles/resourcemanager.organizationAdmin
-// - members:
-// - user:eve@example.com
-// role: roles/resourcemanager.organizationViewer
-// condition:
-// title: expirable access
-// description: Does not grant access after Sep 2020
-// expression: request.time <
+// bindings:
+// - members:
+// - user:mike@example.com
+// - group:admins@example.com
+// - domain:google.com
+// - serviceAccount:my-project-id@appspot.gserviceaccount.com
+// role: roles/resourcemanager.organizationAdmin
+// - members:
+// - user:eve@example.com
+// role: roles/resourcemanager.organizationViewer
+// condition:
+// title: expirable access
+// description: Does not grant access after Sep 2020
+// expression: request.time <
+//
// timestamp('2020-10-01T00:00:00.000Z')
-// - etag: BwWWja0YfJA=
-// - version: 3
+// - etag: BwWWja0YfJA=
+// - version: 3
//
// For a description of IAM and its features, see the
// [IAM documentation](https://cloud.google.com/iam/docs/).
@@ -1539,10 +1542,12 @@ func (s *GoogleIamV1__TestIamPermissionsResponse) MarshalJSON() ([]byte, error)
// request
// or the response type of an API method. For instance:
//
-// service Foo {
-// rpc Bar(google.protobuf.Empty) returns
+// service Foo {
+// rpc Bar(google.protobuf.Empty) returns
+//
// (google.protobuf.Empty);
-// }
+//
+// }
//
// The JSON representation for `Empty` is empty JSON object `{}`.
type GoogleProtobuf__Empty struct {
@@ -1553,9 +1558,9 @@ type GoogleProtobuf__Empty struct {
// GoogleType__Expr: Represents an expression text. Example:
//
-// title: "User account presence"
-// description: "Determines whether the request has a user account"
-// expression: "size(request.user) > 0"
+// title: "User account presence"
+// description: "Determines whether the request has a user account"
+// expression: "size(request.user) > 0"
type GoogleType__Expr struct {
// Description: An optional description of the expression. This is a
// longer text which
@@ -1897,7 +1902,8 @@ func (r *ProjectsBrokersService) List(parent string) *ProjectsBrokersListCall {
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// Acceptable values are 0 to 200, inclusive. (Default: 100)
+//
+// Acceptable values are 0 to 200, inclusive. (Default: 100)
func (c *ProjectsBrokersListCall) PageSize(pageSize int64) *ProjectsBrokersListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -2087,7 +2093,9 @@ type ProjectsBrokersInstancesGetCall struct {
// API
// resource path.
// i.e. both `projects/*/brokers/*/instances/*`
-// and `projects/*/brokers/*/v2/service_instances/*` are acceptable
+//
+// and `projects/*/brokers/*/v2/service_instances/*` are acceptable
+//
// paths.
func (r *ProjectsBrokersInstancesService) Get(name string) *ProjectsBrokersInstancesGetCall {
c := &ProjectsBrokersInstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
@@ -2429,7 +2437,8 @@ func (r *ProjectsBrokersInstancesService) List(parent string) *ProjectsBrokersIn
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// Acceptable values are 0 to 200, inclusive. (Default: 100)
+//
+// Acceptable values are 0 to 200, inclusive. (Default: 100)
func (c *ProjectsBrokersInstancesListCall) PageSize(pageSize int64) *ProjectsBrokersInstancesListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -2808,7 +2817,8 @@ func (r *ProjectsBrokersInstancesBindingsService) List(parent string) *ProjectsB
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// Acceptable values are 0 to 200, inclusive. (Default: 100)
+//
+// Acceptable values are 0 to 200, inclusive. (Default: 100)
func (c *ProjectsBrokersInstancesBindingsListCall) PageSize(pageSize int64) *ProjectsBrokersInstancesBindingsListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -3007,7 +3017,8 @@ func (r *ProjectsBrokersV2CatalogService) List(parent string) *ProjectsBrokersV2
// PageSize sets the optional parameter "pageSize": Specifies the number
// of results to return per page. If there are fewer
// elements than the specified number, returns all elements.
-// If unset or 0, all the results will be returned.
+//
+// If unset or 0, all the results will be returned.
func (c *ProjectsBrokersV2CatalogListCall) PageSize(pageSize int64) *ProjectsBrokersV2CatalogListCall {
c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
return c
@@ -3564,7 +3575,9 @@ type ProjectsBrokersV2ServiceInstancesGetCall struct {
// API
// resource path.
// i.e. both `projects/*/brokers/*/instances/*`
-// and `projects/*/brokers/*/v2/service_instances/*` are acceptable
+//
+// and `projects/*/brokers/*/v2/service_instances/*` are acceptable
+//
// paths.
func (r *ProjectsBrokersV2ServiceInstancesService) Get(name string) *ProjectsBrokersV2ServiceInstancesGetCall {
c := &ProjectsBrokersV2ServiceInstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json
index 431d39fb6ff..6e1377ed476 100644
--- a/serviceconsumermanagement/v1/serviceconsumermanagement-api.json
+++ b/serviceconsumermanagement/v1/serviceconsumermanagement-api.json
@@ -542,7 +542,7 @@
}
}
},
- "revision": "20220615",
+ "revision": "20220816",
"rootUrl": "https://serviceconsumermanagement.googleapis.com/",
"schemas": {
"AddTenantProjectRequest": {
@@ -1789,6 +1789,10 @@
"description": "OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for \"Read-only access to Google Calendar\" and \"Access to Cloud Platform\". Users can consent to a scope for an application, giving it permission to access that data on their behalf. OAuth scope specifications should be fairly coarse grained; a user will need to see and understand the text description of what your scope means. In most cases: use one or at most two OAuth scopes for an entire family of products. If your product has multiple APIs, you should probably be sharing the OAuth scope across all of those APIs. When you need finer grained OAuth consent screens: talk with your product management about how developers will use them in practice. Please note that even though each of the canonical scopes is enough for a request to be accepted and passed to the backend, a request can still fail due to the backend requiring additional scopes or permissions.",
"id": "OAuthRequirements",
"properties": {
+ "allowAnyScope": {
+ "description": "UNIMPLEMENTED: If enabled, ESF will allow OAuth credentials with any scope, more details in http://go/esf-oauth-any-scope. WARNING: Enabling this option will bring security risks. Customers enabling this feature accidentally may have the risk of losing authentication enforcement. Please reach out to api-auth@ and esf-team@ for approval and allowlisting before you enable this option. ",
+ "type": "boolean"
+ },
"canonicalScopes": {
"description": "The list of publicly documented OAuth scopes that are allowed access. An OAuth token containing any of these scopes will be accepted. Example: canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.read",
"type": "string"
diff --git a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go
index 78e80a0d549..0ee228f90e8 100644
--- a/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go
+++ b/serviceconsumermanagement/v1/serviceconsumermanagement-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/service-consumer-management/docs/overview
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/serviceconsumermanagement/v1"
-// ...
-// ctx := context.Background()
-// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx)
+// import "google.golang.org/api/serviceconsumermanagement/v1"
+// ...
+// ctx := context.Background()
+// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithAPIKey("AIza..."))
+// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package serviceconsumermanagement // import "google.golang.org/api/serviceconsumermanagement/v1"
@@ -2699,6 +2699,15 @@ func (s *MonitoringDestination) MarshalJSON() ([]byte, error) {
// accepted and passed to the backend, a request can still fail due to
// the backend requiring additional scopes or permissions.
type OAuthRequirements struct {
+ // AllowAnyScope: UNIMPLEMENTED: If enabled, ESF will allow OAuth
+ // credentials with any scope, more details in
+ // http://go/esf-oauth-any-scope. WARNING: Enabling this option will
+ // bring security risks. Customers enabling this feature accidentally
+ // may have the risk of losing authentication enforcement. Please reach
+ // out to api-auth@ and esf-team@ for approval and allowlisting before
+ // you enable this option.
+ AllowAnyScope bool `json:"allowAnyScope,omitempty"`
+
// CanonicalScopes: The list of publicly documented OAuth scopes that
// are allowed access. An OAuth token containing any of these scopes
// will be accepted. Example: canonical_scopes:
@@ -2706,7 +2715,7 @@ type OAuthRequirements struct {
// https://www.googleapis.com/auth/calendar.read
CanonicalScopes string `json:"canonicalScopes,omitempty"`
- // ForceSendFields is a list of field names (e.g. "CanonicalScopes") to
+ // ForceSendFields is a list of field names (e.g. "AllowAnyScope") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -2714,13 +2723,12 @@ type OAuthRequirements struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CanonicalScopes") to
- // include in API requests with the JSON null value. By default, fields
- // with empty values are omitted from API requests. However, any field
- // with an empty value appearing in NullFields will be sent to the
- // server as null. It is an 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. "AllowAnyScope") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
@@ -5139,9 +5147,9 @@ type ServicesSearchCall struct {
// Search: Search tenancy units for a managed service.
//
-// - parent: Service for which search is performed. services/{service}
-// {service} the name of a service, for example
-// 'service.googleapis.com'.
+// - parent: Service for which search is performed. services/{service}
+// {service} the name of a service, for example
+// 'service.googleapis.com'.
func (r *ServicesService) Search(parent string) *ServicesSearchCall {
c := &ServicesSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5364,8 +5372,8 @@ type ServicesTenancyUnitsAddProjectCall struct {
// `RemoveTenantProject` first to resolve them before you can make
// another call to `AddTenantProject` with the same tag. Operation.
//
-// - parent: Name of the tenancy unit. Such as
-// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+// - parent: Name of the tenancy unit. Such as
+// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
func (r *ServicesTenancyUnitsService) AddProject(parent string, addtenantprojectrequest *AddTenantProjectRequest) *ServicesTenancyUnitsAddProjectCall {
c := &ServicesTenancyUnitsAddProjectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5522,8 +5530,8 @@ type ServicesTenancyUnitsApplyProjectConfigCall struct {
// rollback of already applied configuration changes is attempted.
// Operation.
//
-// - name: Name of the tenancy unit. Such as
-// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+// - name: Name of the tenancy unit. Such as
+// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
func (r *ServicesTenancyUnitsService) ApplyProjectConfig(name string, applytenantprojectconfigrequest *ApplyTenantProjectConfigRequest) *ServicesTenancyUnitsApplyProjectConfigCall {
c := &ServicesTenancyUnitsApplyProjectConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5674,9 +5682,9 @@ type ServicesTenancyUnitsAttachProjectCall struct {
// that project. These two requirements are already met if the project
// is reserved by calling `AddTenantProject`. Operation.
//
-// - name: Name of the tenancy unit that the project will be attached
-// to. Such as
-// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+// - name: Name of the tenancy unit that the project will be attached
+// to. Such as
+// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
func (r *ServicesTenancyUnitsService) AttachProject(name string, attachtenantprojectrequest *AttachTenantProjectRequest) *ServicesTenancyUnitsAttachProjectCall {
c := &ServicesTenancyUnitsAttachProjectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5822,13 +5830,13 @@ type ServicesTenancyUnitsCreateCall struct {
// ListTenancyUnits has to be used to get a complete TenancyUnit with
// all fields populated.
//
-// - parent: services/{service}/{collection id}/{resource id}
-// {collection id} is the cloud resource collection type representing
-// the service consumer, for example 'projects', or 'organizations'.
-// {resource id} is the consumer numeric id, such as project number:
-// '123456'. {service} the name of a managed service, such as
-// 'service.googleapis.com'. Enables service binding using the new
-// tenancy unit.
+// - parent: services/{service}/{collection id}/{resource id}
+// {collection id} is the cloud resource collection type representing
+// the service consumer, for example 'projects', or 'organizations'.
+// {resource id} is the consumer numeric id, such as project number:
+// '123456'. {service} the name of a managed service, such as
+// 'service.googleapis.com'. Enables service binding using the new
+// tenancy unit.
func (r *ServicesTenancyUnitsService) Create(parent string, createtenancyunitrequest *CreateTenancyUnitRequest) *ServicesTenancyUnitsCreateCall {
c := &ServicesTenancyUnitsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6112,8 +6120,8 @@ type ServicesTenancyUnitsDeleteProjectCall struct {
// be added if there are existing resources in a DELETED state.
// Operation.
//
-// - name: Name of the tenancy unit. Such as
-// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+// - name: Name of the tenancy unit. Such as
+// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
func (r *ServicesTenancyUnitsService) DeleteProject(name string, deletetenantprojectrequest *DeleteTenantProjectRequest) *ServicesTenancyUnitsDeleteProjectCall {
c := &ServicesTenancyUnitsDeleteProjectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6259,12 +6267,12 @@ type ServicesTenancyUnitsListCall struct {
// creating VMs. Service producers must persist the tenant project's
// information after the project is created.
//
-// - parent: Managed service and service consumer. Required.
-// services/{service}/{collection id}/{resource id} {collection id} is
-// the cloud resource collection type representing the service
-// consumer, for example 'projects', or 'organizations'. {resource id}
-// is the consumer numeric id, such as project number: '123456'.
-// {service} the name of a service, such as 'service.googleapis.com'.
+// - parent: Managed service and service consumer. Required.
+// services/{service}/{collection id}/{resource id} {collection id} is
+// the cloud resource collection type representing the service
+// consumer, for example 'projects', or 'organizations'. {resource id}
+// is the consumer numeric id, such as project number: '123456'.
+// {service} the name of a service, such as 'service.googleapis.com'.
func (r *ServicesTenancyUnitsService) List(parent string) *ServicesTenancyUnitsListCall {
c := &ServicesTenancyUnitsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6477,8 +6485,8 @@ type ServicesTenancyUnitsRemoveProjectCall struct {
// state, resource metadata is permanently removed from the tenancy
// unit. Operation.
//
-// - name: Name of the tenancy unit. Such as
-// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+// - name: Name of the tenancy unit. Such as
+// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
func (r *ServicesTenancyUnitsService) RemoveProject(name string, removetenantprojectrequest *RemoveTenantProjectRequest) *ServicesTenancyUnitsRemoveProjectCall {
c := &ServicesTenancyUnitsRemoveProjectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6625,8 +6633,8 @@ type ServicesTenancyUnitsUndeleteProjectCall struct {
// update its configuration and then validate all managed service
// resources. Operation.
//
-// - name: Name of the tenancy unit. Such as
-// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
+// - name: Name of the tenancy unit. Such as
+// 'services/service.googleapis.com/projects/12345/tenancyUnits/abcd'.
func (r *ServicesTenancyUnitsService) UndeleteProject(name string, undeletetenantprojectrequest *UndeleteTenantProjectRequest) *ServicesTenancyUnitsUndeleteProjectCall {
c := &ServicesTenancyUnitsUndeleteProjectCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json
index 6e268e54531..3361d98a9a4 100644
--- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json
+++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-api.json
@@ -500,7 +500,7 @@
}
}
},
- "revision": "20220615",
+ "revision": "20220816",
"rootUrl": "https://serviceconsumermanagement.googleapis.com/",
"schemas": {
"Api": {
@@ -1623,6 +1623,10 @@
"description": "OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for \"Read-only access to Google Calendar\" and \"Access to Cloud Platform\". Users can consent to a scope for an application, giving it permission to access that data on their behalf. OAuth scope specifications should be fairly coarse grained; a user will need to see and understand the text description of what your scope means. In most cases: use one or at most two OAuth scopes for an entire family of products. If your product has multiple APIs, you should probably be sharing the OAuth scope across all of those APIs. When you need finer grained OAuth consent screens: talk with your product management about how developers will use them in practice. Please note that even though each of the canonical scopes is enough for a request to be accepted and passed to the backend, a request can still fail due to the backend requiring additional scopes or permissions.",
"id": "OAuthRequirements",
"properties": {
+ "allowAnyScope": {
+ "description": "UNIMPLEMENTED: If enabled, ESF will allow OAuth credentials with any scope, more details in http://go/esf-oauth-any-scope. WARNING: Enabling this option will bring security risks. Customers enabling this feature accidentally may have the risk of losing authentication enforcement. Please reach out to api-auth@ and esf-team@ for approval and allowlisting before you enable this option. ",
+ "type": "boolean"
+ },
"canonicalScopes": {
"description": "The list of publicly documented OAuth scopes that are allowed access. An OAuth token containing any of these scopes will be accepted. Example: canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.read",
"type": "string"
diff --git a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go
index 5ad752dd484..dadf0271e41 100644
--- a/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go
+++ b/serviceconsumermanagement/v1beta1/serviceconsumermanagement-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/service-consumer-management/docs/overview
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/serviceconsumermanagement/v1beta1"
-// ...
-// ctx := context.Background()
-// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx)
+// import "google.golang.org/api/serviceconsumermanagement/v1beta1"
+// ...
+// ctx := context.Background()
+// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithAPIKey("AIza..."))
+// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// serviceconsumermanagementService, err := serviceconsumermanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package serviceconsumermanagement // import "google.golang.org/api/serviceconsumermanagement/v1beta1"
@@ -2438,6 +2438,15 @@ func (s *MonitoringDestination) MarshalJSON() ([]byte, error) {
// accepted and passed to the backend, a request can still fail due to
// the backend requiring additional scopes or permissions.
type OAuthRequirements struct {
+ // AllowAnyScope: UNIMPLEMENTED: If enabled, ESF will allow OAuth
+ // credentials with any scope, more details in
+ // http://go/esf-oauth-any-scope. WARNING: Enabling this option will
+ // bring security risks. Customers enabling this feature accidentally
+ // may have the risk of losing authentication enforcement. Please reach
+ // out to api-auth@ and esf-team@ for approval and allowlisting before
+ // you enable this option.
+ AllowAnyScope bool `json:"allowAnyScope,omitempty"`
+
// CanonicalScopes: The list of publicly documented OAuth scopes that
// are allowed access. An OAuth token containing any of these scopes
// will be accepted. Example: canonical_scopes:
@@ -2445,7 +2454,7 @@ type OAuthRequirements struct {
// https://www.googleapis.com/auth/calendar.read
CanonicalScopes string `json:"canonicalScopes,omitempty"`
- // ForceSendFields is a list of field names (e.g. "CanonicalScopes") to
+ // ForceSendFields is a list of field names (e.g. "AllowAnyScope") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -2453,13 +2462,12 @@ type OAuthRequirements struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CanonicalScopes") to
- // include in API requests with the JSON null value. By default, fields
- // with empty values are omitted from API requests. However, any field
- // with an empty value appearing in NullFields will be sent to the
- // server as null. It is an 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. "AllowAnyScope") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
@@ -4363,10 +4371,10 @@ type ServicesConsumerQuotaMetricsGetCall struct {
// Get: Retrieves a summary of quota information for a specific quota
// metric.
//
-// - name: The resource name of the quota metric, returned by a
-// ListConsumerQuotaMetrics call. An example name would be:
-// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus`.
+// - name: The resource name of the quota metric, returned by a
+// ListConsumerQuotaMetrics call. An example name would be:
+// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus`.
func (r *ServicesConsumerQuotaMetricsService) Get(name string) *ServicesConsumerQuotaMetricsGetCall {
c := &ServicesConsumerQuotaMetricsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4377,10 +4385,14 @@ func (r *ServicesConsumerQuotaMetricsService) Get(name string) *ServicesConsumer
// detail for quota information in the response.
//
// Possible values:
-// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
+// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
// do not specify a quota view will typically default to the BASIC view.
-// "BASIC" - Only buckets with overrides are shown in the response.
-// "FULL" - Include per-location buckets even if they do not have
+//
+// "BASIC" - Only buckets with overrides are shown in the response.
+// "FULL" - Include per-location buckets even if they do not have
+//
// overrides. When the view is FULL, and a limit has regional or zonal
// quota, the limit will include buckets for all regions or zones that
// could support overrides, even if none are currently present. In some
@@ -4548,8 +4560,8 @@ type ServicesConsumerQuotaMetricsImportProducerOverridesCall struct {
// or limits. The name field in the quota override message should not be
// set.
//
-// - parent: The resource name of the consumer. An example name would
-// be: `services/compute.googleapis.com/projects/123`.
+// - parent: The resource name of the consumer. An example name would
+// be: `services/compute.googleapis.com/projects/123`.
func (r *ServicesConsumerQuotaMetricsService) ImportProducerOverrides(parent string, v1beta1importproduceroverridesrequest *V1Beta1ImportProducerOverridesRequest) *ServicesConsumerQuotaMetricsImportProducerOverridesCall {
c := &ServicesConsumerQuotaMetricsImportProducerOverridesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4696,8 +4708,8 @@ type ServicesConsumerQuotaMetricsListCall struct {
// configuration (quota unit, preciseness, default value), the current
// effective limit value, and all of the overrides applied to the limit.
//
-// - parent: Parent of the quotas resource. An example parent would be:
-// `services/serviceconsumermanagement.googleapis.com/projects/123`.
+// - parent: Parent of the quotas resource. An example parent would be:
+// `services/serviceconsumermanagement.googleapis.com/projects/123`.
func (r *ServicesConsumerQuotaMetricsService) List(parent string) *ServicesConsumerQuotaMetricsListCall {
c := &ServicesConsumerQuotaMetricsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4722,10 +4734,14 @@ func (c *ServicesConsumerQuotaMetricsListCall) PageToken(pageToken string) *Serv
// detail for quota information in the response.
//
// Possible values:
-// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
+// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
// do not specify a quota view will typically default to the BASIC view.
-// "BASIC" - Only buckets with overrides are shown in the response.
-// "FULL" - Include per-location buckets even if they do not have
+//
+// "BASIC" - Only buckets with overrides are shown in the response.
+// "FULL" - Include per-location buckets even if they do not have
+//
// overrides. When the view is FULL, and a limit has regional or zonal
// quota, the limit will include buckets for all regions or zones that
// could support overrides, even if none are currently present. In some
@@ -4924,11 +4940,11 @@ type ServicesConsumerQuotaMetricsLimitsGetCall struct {
// Get: Retrieves a summary of quota information for a specific quota
// limit.
//
-// - name: The resource name of the quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - name: The resource name of the quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsService) Get(name string) *ServicesConsumerQuotaMetricsLimitsGetCall {
c := &ServicesConsumerQuotaMetricsLimitsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4939,10 +4955,14 @@ func (r *ServicesConsumerQuotaMetricsLimitsService) Get(name string) *ServicesCo
// detail for quota information in the response.
//
// Possible values:
-// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
+// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
// do not specify a quota view will typically default to the BASIC view.
-// "BASIC" - Only buckets with overrides are shown in the response.
-// "FULL" - Include per-location buckets even if they do not have
+//
+// "BASIC" - Only buckets with overrides are shown in the response.
+// "FULL" - Include per-location buckets even if they do not have
+//
// overrides. When the view is FULL, and a limit has regional or zonal
// quota, the limit will include buckets for all regions or zones that
// could support overrides, even if none are currently present. In some
@@ -5114,11 +5134,11 @@ type ServicesConsumerQuotaMetricsLimitsProducerOverridesCreateCall struct {
// already present ("upsert" semantics), use ImportProducerOverrides
// instead.
//
-// - parent: The resource name of the parent quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - parent: The resource name of the parent quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsProducerOverridesService) Create(parent string, v1beta1quotaoverride *V1Beta1QuotaOverride) *ServicesConsumerQuotaMetricsLimitsProducerOverridesCreateCall {
c := &ServicesConsumerQuotaMetricsLimitsProducerOverridesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5142,11 +5162,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsProducerOverridesCreateCall) Force(fo
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsProducerOverridesCreateCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsProducerOverridesCreateCall {
@@ -5308,11 +5332,11 @@ type ServicesConsumerQuotaMetricsLimitsProducerOverridesDeleteCall struct {
// Delete: Deletes a producer override.
//
-// - name: The resource name of the override to delete. An example name
-// would be:
-// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/producerOver
-// rides/4a3f2c1d`.
+// - name: The resource name of the override to delete. An example name
+// would be:
+// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/producerOver
+// rides/4a3f2c1d`.
func (r *ServicesConsumerQuotaMetricsLimitsProducerOverridesService) Delete(name string) *ServicesConsumerQuotaMetricsLimitsProducerOverridesDeleteCall {
c := &ServicesConsumerQuotaMetricsLimitsProducerOverridesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5335,11 +5359,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsProducerOverridesDeleteCall) Force(fo
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsProducerOverridesDeleteCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsProducerOverridesDeleteCall {
@@ -5494,11 +5522,11 @@ type ServicesConsumerQuotaMetricsLimitsProducerOverridesListCall struct {
// List: Lists all producer overrides on this limit.
//
-// - parent: The resource name of the parent quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - parent: The resource name of the parent quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsProducerOverridesService) List(parent string) *ServicesConsumerQuotaMetricsLimitsProducerOverridesListCall {
c := &ServicesConsumerQuotaMetricsLimitsProducerOverridesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5691,11 +5719,11 @@ type ServicesConsumerQuotaMetricsLimitsProducerOverridesPatchCall struct {
// Patch: Updates a producer override.
//
-// - name: The resource name of the override to update. An example name
-// would be:
-// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/producerOver
-// rides/4a3f2c1d`.
+// - name: The resource name of the override to update. An example name
+// would be:
+// `services/compute.googleapis.com/projects/123/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/producerOver
+// rides/4a3f2c1d`.
func (r *ServicesConsumerQuotaMetricsLimitsProducerOverridesService) Patch(name string, v1beta1quotaoverride *V1Beta1QuotaOverride) *ServicesConsumerQuotaMetricsLimitsProducerOverridesPatchCall {
c := &ServicesConsumerQuotaMetricsLimitsProducerOverridesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5719,11 +5747,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsProducerOverridesPatchCall) Force(for
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsProducerOverridesPatchCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsProducerOverridesPatchCall {
diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go
index ab3ffac3be9..114cb639d7b 100644
--- a/servicecontrol/v1/servicecontrol-gen.go
+++ b/servicecontrol/v1/servicecontrol-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-control/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicecontrol/v1"
-// ...
-// ctx := context.Background()
-// servicecontrolService, err := servicecontrol.NewService(ctx)
+// import "google.golang.org/api/servicecontrol/v1"
+// ...
+// ctx := context.Background()
+// servicecontrolService, err := servicecontrol.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithScopes(servicecontrol.ServicecontrolScope))
+// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithScopes(servicecontrol.ServicecontrolScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicecontrol // import "google.golang.org/api/servicecontrol/v1"
@@ -3288,9 +3288,9 @@ type ServicesAllocateQuotaCall struct {
// the server may inject these errors to prohibit any hard dependency on
// the quota functionality.
//
-// - serviceName: Name of the service as specified in the service
-// configuration. For example, "pubsub.googleapis.com". See
-// google.api.Service for the definition of a service name.
+// - serviceName: Name of the service as specified in the service
+// configuration. For example, "pubsub.googleapis.com". See
+// google.api.Service for the definition of a service name.
func (r *ServicesService) AllocateQuota(serviceName string, allocatequotarequest *AllocateQuotaRequest) *ServicesAllocateQuotaCall {
c := &ServicesAllocateQuotaCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -3444,11 +3444,11 @@ type ServicesCheckCall struct {
// service. For more information, see Cloud IAM
// (https://cloud.google.com/iam).
//
-// - serviceName: The service name as specified in its service
-// configuration. For example, "pubsub.googleapis.com". See
-// google.api.Service
-// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
-// for the definition of a service name.
+// - serviceName: The service name as specified in its service
+// configuration. For example, "pubsub.googleapis.com". See
+// google.api.Service
+// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
+// for the definition of a service name.
func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall {
c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -3600,11 +3600,11 @@ type ServicesReportCall struct {
// the specified service. For more information, see Google Cloud IAM
// (https://cloud.google.com/iam).
//
-// - serviceName: The service name as specified in its service
-// configuration. For example, "pubsub.googleapis.com". See
-// google.api.Service
-// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
-// for the definition of a service name.
+// - serviceName: The service name as specified in its service
+// configuration. For example, "pubsub.googleapis.com". See
+// google.api.Service
+// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
+// for the definition of a service name.
func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall {
c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
diff --git a/servicecontrol/v2/servicecontrol-gen.go b/servicecontrol/v2/servicecontrol-gen.go
index a6ef6efd564..df627883dde 100644
--- a/servicecontrol/v2/servicecontrol-gen.go
+++ b/servicecontrol/v2/servicecontrol-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-control/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicecontrol/v2"
-// ...
-// ctx := context.Background()
-// servicecontrolService, err := servicecontrol.NewService(ctx)
+// import "google.golang.org/api/servicecontrol/v2"
+// ...
+// ctx := context.Background()
+// servicecontrolService, err := servicecontrol.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithScopes(servicecontrol.ServicecontrolScope))
+// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithScopes(servicecontrol.ServicecontrolScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicecontrolService, err := servicecontrol.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicecontrol // import "google.golang.org/api/servicecontrol/v2"
@@ -1731,11 +1731,11 @@ type ServicesCheckCall struct {
// Access Control
// (https://cloud.google.com/service-infrastructure/docs/service-control/access-control).
//
-// - serviceName: The service name as specified in its service
-// configuration. For example, "pubsub.googleapis.com". See
-// google.api.Service
-// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
-// for the definition of a service name.
+// - serviceName: The service name as specified in its service
+// configuration. For example, "pubsub.googleapis.com". See
+// google.api.Service
+// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
+// for the definition of a service name.
func (r *ServicesService) Check(serviceName string, checkrequest *CheckRequest) *ServicesCheckCall {
c := &ServicesCheckCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -1890,11 +1890,11 @@ type ServicesReportCall struct {
// service. For more information, see Service Control API Access Control
// (https://cloud.google.com/service-infrastructure/docs/service-control/access-control).
//
-// - serviceName: The service name as specified in its service
-// configuration. For example, "pubsub.googleapis.com". See
-// google.api.Service
-// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
-// for the definition of a service name.
+// - serviceName: The service name as specified in its service
+// configuration. For example, "pubsub.googleapis.com". See
+// google.api.Service
+// (https://cloud.google.com/service-management/reference/rpc/google.api#google.api.Service)
+// for the definition of a service name.
func (r *ServicesService) Report(serviceName string, reportrequest *ReportRequest) *ServicesReportCall {
c := &ServicesReportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
diff --git a/servicedirectory/v1/servicedirectory-api.json b/servicedirectory/v1/servicedirectory-api.json
index 991f19c7cb7..9d2cad006f6 100644
--- a/servicedirectory/v1/servicedirectory-api.json
+++ b/servicedirectory/v1/servicedirectory-api.json
@@ -883,7 +883,7 @@
}
}
},
- "revision": "20220518",
+ "revision": "20220804",
"rootUrl": "https://servicedirectory.googleapis.com/",
"schemas": {
"Binding": {
@@ -895,7 +895,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/servicedirectory/v1/servicedirectory-gen.go b/servicedirectory/v1/servicedirectory-gen.go
index 83aa2492f50..d877a0908df 100644
--- a/servicedirectory/v1/servicedirectory-gen.go
+++ b/servicedirectory/v1/servicedirectory-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/service-directory
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicedirectory/v1"
-// ...
-// ctx := context.Background()
-// servicedirectoryService, err := servicedirectory.NewService(ctx)
+// import "google.golang.org/api/servicedirectory/v1"
+// ...
+// ctx := context.Background()
+// servicedirectoryService, err := servicedirectory.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicedirectory // import "google.golang.org/api/servicedirectory/v1"
@@ -214,16 +214,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1227,8 +1231,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1435,8 +1439,8 @@ type ProjectsLocationsNamespacesCreateCall struct {
// Create: Creates a namespace, and returns the new namespace.
//
-// - parent: The resource name of the project and location the namespace
-// will be created in.
+// - parent: The resource name of the project and location the namespace
+// will be created in.
func (r *ProjectsLocationsNamespacesService) Create(parent string, namespace *Namespace) *ProjectsLocationsNamespacesCreateCall {
c := &ProjectsLocationsNamespacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1875,10 +1879,10 @@ type ProjectsLocationsNamespacesGetIamPolicyCall struct {
// GetIamPolicy: Gets the IAM Policy for a resource (namespace or
// service only).
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsNamespacesGetIamPolicyCall {
c := &ProjectsLocationsNamespacesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2020,8 +2024,8 @@ type ProjectsLocationsNamespacesListCall struct {
// List: Lists all namespaces.
//
-// - parent: The resource name of the project and location whose
-// namespaces you'd like to list.
+// - parent: The resource name of the project and location whose
+// namespaces you'd like to list.
func (r *ProjectsLocationsNamespacesService) List(parent string) *ProjectsLocationsNamespacesListCall {
c := &ProjectsLocationsNamespacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2029,10 +2033,10 @@ func (r *ProjectsLocationsNamespacesService) List(parent string) *ProjectsLocati
}
// Filter sets the optional parameter "filter": The filter to list
-// results by. General `filter` string syntax: ` ()` * `` can be `name`
-// or `labels.` for map field * `` can be `<`, `>`, `<=`, `>=`, `!=`,
+// results by. General `filter` string syntax: ` ()` * “ can be `name`
+// or `labels.` for map field * “ can be `<`, `>`, `<=`, `>=`, `!=`,
// `=`, `:`. Of which `:` means `HAS`, and is roughly the same as `=` *
-// `` must be the same data type as field * `` can be `AND`, `OR`, `NOT`
+// “ must be the same data type as field * “ can be `AND`, `OR`, `NOT`
// Examples of valid filters: * `labels.owner` returns namespaces that
// have a label with the key `owner`, this is the same as `labels:owner`
// * `labels.owner=sd` returns namespaces that have key/value `owner=sd`
@@ -2052,8 +2056,8 @@ func (c *ProjectsLocationsNamespacesListCall) Filter(filter string) *ProjectsLoc
}
// OrderBy sets the optional parameter "orderBy": The order to list
-// results by. General `order_by` string syntax: ` () (,)` * `` allows
-// value: `name` * `` ascending or descending order by ``. If this is
+// results by. General `order_by` string syntax: ` () (,)` * “ allows
+// value: `name` * “ ascending or descending order by “. If this is
// left blank, `asc` is used Note that an empty `order_by` string
// results in default order, which is order by `name` in ascending
// order.
@@ -2257,8 +2261,8 @@ type ProjectsLocationsNamespacesPatchCall struct {
// Patch: Updates a namespace.
//
-// - name: Immutable. The resource name for the namespace in the format
-// `projects/*/locations/*/namespaces/*`.
+// - name: Immutable. The resource name for the namespace in the format
+// `projects/*/locations/*/namespaces/*`.
func (r *ProjectsLocationsNamespacesService) Patch(name string, namespace *Namespace) *ProjectsLocationsNamespacesPatchCall {
c := &ProjectsLocationsNamespacesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2414,10 +2418,10 @@ type ProjectsLocationsNamespacesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Policy for a resource (namespace or
// service only).
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsNamespacesSetIamPolicyCall {
c := &ProjectsLocationsNamespacesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2560,10 +2564,10 @@ type ProjectsLocationsNamespacesTestIamPermissionsCall struct {
// TestIamPermissions: Tests IAM permissions for a resource (namespace
// or service only).
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsNamespacesTestIamPermissionsCall {
c := &ProjectsLocationsNamespacesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2705,8 +2709,8 @@ type ProjectsLocationsNamespacesServicesCreateCall struct {
// Create: Creates a service, and returns the new service.
//
-// - parent: The resource name of the namespace this service will belong
-// to.
+// - parent: The resource name of the namespace this service will belong
+// to.
func (r *ProjectsLocationsNamespacesServicesService) Create(parent string, service *Service) *ProjectsLocationsNamespacesServicesCreateCall {
c := &ProjectsLocationsNamespacesServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3145,10 +3149,10 @@ type ProjectsLocationsNamespacesServicesGetIamPolicyCall struct {
// GetIamPolicy: Gets the IAM Policy for a resource (namespace or
// service only).
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServicesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsNamespacesServicesGetIamPolicyCall {
c := &ProjectsLocationsNamespacesServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3290,8 +3294,8 @@ type ProjectsLocationsNamespacesServicesListCall struct {
// List: Lists all services belonging to a namespace.
//
-// - parent: The resource name of the namespace whose services you'd
-// like to list.
+// - parent: The resource name of the namespace whose services you'd
+// like to list.
func (r *ProjectsLocationsNamespacesServicesService) List(parent string) *ProjectsLocationsNamespacesServicesListCall {
c := &ProjectsLocationsNamespacesServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3299,10 +3303,10 @@ func (r *ProjectsLocationsNamespacesServicesService) List(parent string) *Projec
}
// Filter sets the optional parameter "filter": The filter to list
-// results by. General `filter` string syntax: ` ()` * `` can be `name`
-// or `annotations.` for map field * `` can be `<`, `>`, `<=`, `>=`,
+// results by. General `filter` string syntax: ` ()` * “ can be `name`
+// or `annotations.` for map field * “ can be `<`, `>`, `<=`, `>=`,
// `!=`, `=`, `:`. Of which `:` means `HAS`, and is roughly the same as
-// `=` * `` must be the same data type as field * `` can be `AND`, `OR`,
+// `=` * “ must be the same data type as field * “ can be `AND`, `OR`,
// `NOT` Examples of valid filters: * `annotations.owner` returns
// services that have a annotation with the key `owner`, this is the
// same as `annotations:owner` * `annotations.protocol=gRPC` returns
@@ -3323,8 +3327,8 @@ func (c *ProjectsLocationsNamespacesServicesListCall) Filter(filter string) *Pro
}
// OrderBy sets the optional parameter "orderBy": The order to list
-// results by. General `order_by` string syntax: ` () (,)` * `` allows
-// value: `name` * `` ascending or descending order by ``. If this is
+// results by. General `order_by` string syntax: ` () (,)` * “ allows
+// value: `name` * “ ascending or descending order by “. If this is
// left blank, `asc` is used Note that an empty `order_by` string
// results in default order, which is order by `name` in ascending
// order.
@@ -3528,8 +3532,8 @@ type ProjectsLocationsNamespacesServicesPatchCall struct {
// Patch: Updates a service.
//
-// - name: Immutable. The resource name for the service in the format
-// `projects/*/locations/*/namespaces/*/services/*`.
+// - name: Immutable. The resource name for the service in the format
+// `projects/*/locations/*/namespaces/*/services/*`.
func (r *ProjectsLocationsNamespacesServicesService) Patch(name string, service *Service) *ProjectsLocationsNamespacesServicesPatchCall {
c := &ProjectsLocationsNamespacesServicesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3828,10 +3832,10 @@ type ProjectsLocationsNamespacesServicesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Policy for a resource (namespace or
// service only).
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServicesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsNamespacesServicesSetIamPolicyCall {
c := &ProjectsLocationsNamespacesServicesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3974,10 +3978,10 @@ type ProjectsLocationsNamespacesServicesTestIamPermissionsCall struct {
// TestIamPermissions: Tests IAM permissions for a resource (namespace
// or service only).
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServicesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsNamespacesServicesTestIamPermissionsCall {
c := &ProjectsLocationsNamespacesServicesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4119,8 +4123,8 @@ type ProjectsLocationsNamespacesServicesEndpointsCreateCall struct {
// Create: Creates an endpoint, and returns the new endpoint.
//
-// - parent: The resource name of the service that this endpoint
-// provides.
+// - parent: The resource name of the service that this endpoint
+// provides.
func (r *ProjectsLocationsNamespacesServicesEndpointsService) Create(parent string, endpoint *Endpoint) *ProjectsLocationsNamespacesServicesEndpointsCreateCall {
c := &ProjectsLocationsNamespacesServicesEndpointsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4557,8 +4561,8 @@ type ProjectsLocationsNamespacesServicesEndpointsListCall struct {
// List: Lists all endpoints.
//
-// - parent: The resource name of the service whose endpoints you'd like
-// to list.
+// - parent: The resource name of the service whose endpoints you'd like
+// to list.
func (r *ProjectsLocationsNamespacesServicesEndpointsService) List(parent string) *ProjectsLocationsNamespacesServicesEndpointsListCall {
c := &ProjectsLocationsNamespacesServicesEndpointsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4566,10 +4570,10 @@ func (r *ProjectsLocationsNamespacesServicesEndpointsService) List(parent string
}
// Filter sets the optional parameter "filter": The filter to list
-// results by. General `filter` string syntax: ` ()` * `` can be `name`,
-// `address`, `port`, or `annotations.` for map field * `` can be `<`,
+// results by. General `filter` string syntax: ` ()` * “ can be `name`,
+// `address`, `port`, or `annotations.` for map field * “ can be `<`,
// `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:` means `HAS`, and is
-// roughly the same as `=` * `` must be the same data type as field * ``
+// roughly the same as `=` * “ must be the same data type as field * “
// can be `AND`, `OR`, `NOT` Examples of valid filters: *
// `annotations.owner` returns endpoints that have a annotation with the
// key `owner`, this is the same as `annotations:owner` *
@@ -4593,9 +4597,9 @@ func (c *ProjectsLocationsNamespacesServicesEndpointsListCall) Filter(filter str
}
// OrderBy sets the optional parameter "orderBy": The order to list
-// results by. General `order_by` string syntax: ` () (,)` * `` allows
-// values: `name`, `address`, `port` * `` ascending or descending order
-// by ``. If this is left blank, `asc` is used Note that an empty
+// results by. General `order_by` string syntax: ` () (,)` * “ allows
+// values: `name`, `address`, `port` * “ ascending or descending order
+// by “. If this is left blank, `asc` is used Note that an empty
// `order_by` string results in default order, which is order by `name`
// in ascending order.
func (c *ProjectsLocationsNamespacesServicesEndpointsListCall) OrderBy(orderBy string) *ProjectsLocationsNamespacesServicesEndpointsListCall {
@@ -4798,8 +4802,8 @@ type ProjectsLocationsNamespacesServicesEndpointsPatchCall struct {
// Patch: Updates an endpoint.
//
-// - name: Immutable. The resource name for the endpoint in the format
-// `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+// - name: Immutable. The resource name for the endpoint in the format
+// `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
func (r *ProjectsLocationsNamespacesServicesEndpointsService) Patch(name string, endpoint *Endpoint) *ProjectsLocationsNamespacesServicesEndpointsPatchCall {
c := &ProjectsLocationsNamespacesServicesEndpointsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/servicedirectory/v1beta1/servicedirectory-api.json b/servicedirectory/v1beta1/servicedirectory-api.json
index 49967ad67d7..26ab8ed3f42 100644
--- a/servicedirectory/v1beta1/servicedirectory-api.json
+++ b/servicedirectory/v1beta1/servicedirectory-api.json
@@ -1059,7 +1059,7 @@
}
}
},
- "revision": "20220720",
+ "revision": "20220804",
"rootUrl": "https://servicedirectory.googleapis.com/",
"schemas": {
"Binding": {
@@ -1071,7 +1071,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/servicedirectory/v1beta1/servicedirectory-gen.go b/servicedirectory/v1beta1/servicedirectory-gen.go
index b0592614833..a46adeed503 100644
--- a/servicedirectory/v1beta1/servicedirectory-gen.go
+++ b/servicedirectory/v1beta1/servicedirectory-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/service-directory
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicedirectory/v1beta1"
-// ...
-// ctx := context.Background()
-// servicedirectoryService, err := servicedirectory.NewService(ctx)
+// import "google.golang.org/api/servicedirectory/v1beta1"
+// ...
+// ctx := context.Background()
+// servicedirectoryService, err := servicedirectory.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicedirectoryService, err := servicedirectory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicedirectory // import "google.golang.org/api/servicedirectory/v1beta1"
@@ -238,16 +238,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1275,8 +1279,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1483,8 +1487,8 @@ type ProjectsLocationsNamespacesCreateCall struct {
// Create: Creates a namespace, and returns the new namespace.
//
-// - parent: The resource name of the project and location the namespace
-// will be created in.
+// - parent: The resource name of the project and location the namespace
+// will be created in.
func (r *ProjectsLocationsNamespacesService) Create(parent string, namespace *Namespace) *ProjectsLocationsNamespacesCreateCall {
c := &ProjectsLocationsNamespacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1922,10 +1926,10 @@ type ProjectsLocationsNamespacesGetIamPolicyCall struct {
// GetIamPolicy: Gets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsNamespacesGetIamPolicyCall {
c := &ProjectsLocationsNamespacesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2067,8 +2071,8 @@ type ProjectsLocationsNamespacesListCall struct {
// List: Lists all namespaces.
//
-// - parent: The resource name of the project and location whose
-// namespaces you'd like to list.
+// - parent: The resource name of the project and location whose
+// namespaces you'd like to list.
func (r *ProjectsLocationsNamespacesService) List(parent string) *ProjectsLocationsNamespacesListCall {
c := &ProjectsLocationsNamespacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2076,11 +2080,11 @@ func (r *ProjectsLocationsNamespacesService) List(parent string) *ProjectsLocati
}
// Filter sets the optional parameter "filter": The filter to list
-// results by. General `filter` string syntax: ` ()` * `` can be `name`,
-// `labels.` for map field, or `attributes.` for attributes field * ``
+// results by. General `filter` string syntax: ` ()` * “ can be `name`,
+// `labels.` for map field, or `attributes.` for attributes field * “
// can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:` means
-// `HAS`, and is roughly the same as `=` * `` must be the same data type
-// as field * `` can be `AND`, `OR`, `NOT` Examples of valid filters: *
+// `HAS`, and is roughly the same as `=` * “ must be the same data type
+// as field * “ can be `AND`, `OR`, `NOT` Examples of valid filters: *
// `labels.owner` returns namespaces that have a label with the key
// `owner`, this is the same as `labels:owner` * `labels.owner=sd`
// returns namespaces that have key/value `owner=sd` *
@@ -2101,8 +2105,8 @@ func (c *ProjectsLocationsNamespacesListCall) Filter(filter string) *ProjectsLoc
}
// OrderBy sets the optional parameter "orderBy": The order to list
-// results by. General `order_by` string syntax: ` () (,)` * `` allows
-// value: `name` * `` ascending or descending order by ``. If this is
+// results by. General `order_by` string syntax: ` () (,)` * “ allows
+// value: `name` * “ ascending or descending order by “. If this is
// left blank, `asc` is used Note that an empty `order_by` string
// results in default order, which is order by `name` in ascending
// order.
@@ -2306,8 +2310,8 @@ type ProjectsLocationsNamespacesPatchCall struct {
// Patch: Updates a namespace.
//
-// - name: Immutable. The resource name for the namespace in the format
-// `projects/*/locations/*/namespaces/*`.
+// - name: Immutable. The resource name for the namespace in the format
+// `projects/*/locations/*/namespaces/*`.
func (r *ProjectsLocationsNamespacesService) Patch(name string, namespace *Namespace) *ProjectsLocationsNamespacesPatchCall {
c := &ProjectsLocationsNamespacesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2462,10 +2466,10 @@ type ProjectsLocationsNamespacesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsNamespacesSetIamPolicyCall {
c := &ProjectsLocationsNamespacesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2608,10 +2612,10 @@ type ProjectsLocationsNamespacesTestIamPermissionsCall struct {
// TestIamPermissions: Tests IAM permissions for a resource (namespace,
// service or service workload only).
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsNamespacesTestIamPermissionsCall {
c := &ProjectsLocationsNamespacesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2753,10 +2757,10 @@ type ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall struct {
// GetIamPolicy: Gets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServiceWorkloadsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall {
c := &ProjectsLocationsNamespacesServiceWorkloadsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2898,10 +2902,10 @@ type ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServiceWorkloadsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall {
c := &ProjectsLocationsNamespacesServiceWorkloadsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3044,10 +3048,10 @@ type ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall struct {
// TestIamPermissions: Tests IAM permissions for a resource (namespace,
// service or service workload only).
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServiceWorkloadsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall {
c := &ProjectsLocationsNamespacesServiceWorkloadsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3189,8 +3193,8 @@ type ProjectsLocationsNamespacesServicesCreateCall struct {
// Create: Creates a service, and returns the new service.
//
-// - parent: The resource name of the namespace this service will belong
-// to.
+// - parent: The resource name of the namespace this service will belong
+// to.
func (r *ProjectsLocationsNamespacesServicesService) Create(parent string, service *Service) *ProjectsLocationsNamespacesServicesCreateCall {
c := &ProjectsLocationsNamespacesServicesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3628,10 +3632,10 @@ type ProjectsLocationsNamespacesServicesGetIamPolicyCall struct {
// GetIamPolicy: Gets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServicesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsNamespacesServicesGetIamPolicyCall {
c := &ProjectsLocationsNamespacesServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -3773,8 +3777,8 @@ type ProjectsLocationsNamespacesServicesListCall struct {
// List: Lists all services belonging to a namespace.
//
-// - parent: The resource name of the namespace whose services you'd
-// like to list.
+// - parent: The resource name of the namespace whose services you'd
+// like to list.
func (r *ProjectsLocationsNamespacesServicesService) List(parent string) *ProjectsLocationsNamespacesServicesListCall {
c := &ProjectsLocationsNamespacesServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3782,10 +3786,10 @@ func (r *ProjectsLocationsNamespacesServicesService) List(parent string) *Projec
}
// Filter sets the optional parameter "filter": The filter to list
-// results by. General `filter` string syntax: ` ()` * `` can be `name`
-// or `metadata.` for map field * `` can be `<`, `>`, `<=`, `>=`, `!=`,
+// results by. General `filter` string syntax: ` ()` * “ can be `name`
+// or `metadata.` for map field * “ can be `<`, `>`, `<=`, `>=`, `!=`,
// `=`, `:`. Of which `:` means `HAS`, and is roughly the same as `=` *
-// `` must be the same data type as field * `` can be `AND`, `OR`, `NOT`
+// “ must be the same data type as field * “ can be `AND`, `OR`, `NOT`
// Examples of valid filters: * `metadata.owner` returns services that
// have a metadata with the key `owner`, this is the same as
// `metadata:owner` * `metadata.protocol=gRPC` returns services that
@@ -3807,8 +3811,8 @@ func (c *ProjectsLocationsNamespacesServicesListCall) Filter(filter string) *Pro
}
// OrderBy sets the optional parameter "orderBy": The order to list
-// results by. General `order_by` string syntax: ` () (,)` * `` allows
-// value: `name` * `` ascending or descending order by ``. If this is
+// results by. General `order_by` string syntax: ` () (,)` * “ allows
+// value: `name` * “ ascending or descending order by “. If this is
// left blank, `asc` is used Note that an empty `order_by` string
// results in default order, which is order by `name` in ascending
// order.
@@ -4012,8 +4016,8 @@ type ProjectsLocationsNamespacesServicesPatchCall struct {
// Patch: Updates a service.
//
-// - name: Immutable. The resource name for the service in the format
-// `projects/*/locations/*/namespaces/*/services/*`.
+// - name: Immutable. The resource name for the service in the format
+// `projects/*/locations/*/namespaces/*/services/*`.
func (r *ProjectsLocationsNamespacesServicesService) Patch(name string, service *Service) *ProjectsLocationsNamespacesServicesPatchCall {
c := &ProjectsLocationsNamespacesServicesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4311,10 +4315,10 @@ type ProjectsLocationsNamespacesServicesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServicesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsNamespacesServicesSetIamPolicyCall {
c := &ProjectsLocationsNamespacesServicesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4457,10 +4461,10 @@ type ProjectsLocationsNamespacesServicesTestIamPermissionsCall struct {
// TestIamPermissions: Tests IAM permissions for a resource (namespace,
// service or service workload only).
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsNamespacesServicesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsNamespacesServicesTestIamPermissionsCall {
c := &ProjectsLocationsNamespacesServicesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -4602,8 +4606,8 @@ type ProjectsLocationsNamespacesServicesEndpointsCreateCall struct {
// Create: Creates an endpoint, and returns the new endpoint.
//
-// - parent: The resource name of the service that this endpoint
-// provides.
+// - parent: The resource name of the service that this endpoint
+// provides.
func (r *ProjectsLocationsNamespacesServicesEndpointsService) Create(parent string, endpoint *Endpoint) *ProjectsLocationsNamespacesServicesEndpointsCreateCall {
c := &ProjectsLocationsNamespacesServicesEndpointsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5040,8 +5044,8 @@ type ProjectsLocationsNamespacesServicesEndpointsListCall struct {
// List: Lists all endpoints.
//
-// - parent: The resource name of the service whose endpoints you'd like
-// to list.
+// - parent: The resource name of the service whose endpoints you'd like
+// to list.
func (r *ProjectsLocationsNamespacesServicesEndpointsService) List(parent string) *ProjectsLocationsNamespacesServicesEndpointsListCall {
c := &ProjectsLocationsNamespacesServicesEndpointsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5049,11 +5053,11 @@ func (r *ProjectsLocationsNamespacesServicesEndpointsService) List(parent string
}
// Filter sets the optional parameter "filter": The filter to list
-// results by. General `filter` string syntax: ` ()` * `` can be `name`,
+// results by. General `filter` string syntax: ` ()` * “ can be `name`,
// `address`, `port`, `metadata.` for map field, or `attributes.` for
-// attributes field * `` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of
-// which `:` means `HAS`, and is roughly the same as `=` * `` must be
-// the same data type as field * `` can be `AND`, `OR`, `NOT` Examples
+// attributes field * “ can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of
+// which `:` means `HAS`, and is roughly the same as `=` * “ must be
+// the same data type as field * “ can be `AND`, `OR`, `NOT` Examples
// of valid filters: * `metadata.owner` returns endpoints that have a
// metadata with the key `owner`, this is the same as `metadata:owner` *
// `metadata.protocol=gRPC` returns endpoints that have key/value
@@ -5070,7 +5074,9 @@ func (r *ProjectsLocationsNamespacesServicesEndpointsService) List(parent string
// doesn't have a field called "doesnotexist". Since the filter does not
// match any endpoints, it returns no results *
// `attributes.kubernetes_resource_type=KUBERNETES_RESOURCE_TYPE_CLUSTER_
-// IP` returns endpoints with the corresponding
+//
+// IP` returns endpoints with the corresponding
+//
// kubernetes_resource_type For more information about filtering, see
// API Filtering (https://aip.dev/160).
func (c *ProjectsLocationsNamespacesServicesEndpointsListCall) Filter(filter string) *ProjectsLocationsNamespacesServicesEndpointsListCall {
@@ -5079,9 +5085,9 @@ func (c *ProjectsLocationsNamespacesServicesEndpointsListCall) Filter(filter str
}
// OrderBy sets the optional parameter "orderBy": The order to list
-// results by. General `order_by` string syntax: ` () (,)` * `` allows
-// values: `name`, `address`, `port` * `` ascending or descending order
-// by ``. If this is left blank, `asc` is used Note that an empty
+// results by. General `order_by` string syntax: ` () (,)` * “ allows
+// values: `name`, `address`, `port` * “ ascending or descending order
+// by “. If this is left blank, `asc` is used Note that an empty
// `order_by` string results in default order, which is order by `name`
// in ascending order.
func (c *ProjectsLocationsNamespacesServicesEndpointsListCall) OrderBy(orderBy string) *ProjectsLocationsNamespacesServicesEndpointsListCall {
@@ -5284,8 +5290,8 @@ type ProjectsLocationsNamespacesServicesEndpointsPatchCall struct {
// Patch: Updates an endpoint.
//
-// - name: Immutable. The resource name for the endpoint in the format
-// `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+// - name: Immutable. The resource name for the endpoint in the format
+// `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
func (r *ProjectsLocationsNamespacesServicesEndpointsService) Patch(name string, endpoint *Endpoint) *ProjectsLocationsNamespacesServicesEndpointsPatchCall {
c := &ProjectsLocationsNamespacesServicesEndpointsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5440,10 +5446,10 @@ type ProjectsLocationsRegistrationPoliciesGetIamPolicyCall struct {
// GetIamPolicy: Gets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsRegistrationPoliciesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsLocationsRegistrationPoliciesGetIamPolicyCall {
c := &ProjectsLocationsRegistrationPoliciesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -5585,10 +5591,10 @@ type ProjectsLocationsRegistrationPoliciesSetIamPolicyCall struct {
// SetIamPolicy: Sets the IAM Policy for a resource
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsRegistrationPoliciesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsLocationsRegistrationPoliciesSetIamPolicyCall {
c := &ProjectsLocationsRegistrationPoliciesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -5731,10 +5737,10 @@ type ProjectsLocationsRegistrationPoliciesTestIamPermissionsCall struct {
// TestIamPermissions: Tests IAM permissions for a resource (namespace,
// service or service workload only).
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsLocationsRegistrationPoliciesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsLocationsRegistrationPoliciesTestIamPermissionsCall {
c := &ProjectsLocationsRegistrationPoliciesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
diff --git a/servicemanagement/v1/servicemanagement-api.json b/servicemanagement/v1/servicemanagement-api.json
index 6af06eb5331..72013a59408 100644
--- a/servicemanagement/v1/servicemanagement-api.json
+++ b/servicemanagement/v1/servicemanagement-api.json
@@ -829,7 +829,7 @@
}
}
},
- "revision": "20220617",
+ "revision": "20220805",
"rootUrl": "https://servicemanagement.googleapis.com/",
"schemas": {
"Advice": {
@@ -1144,7 +1144,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/servicemanagement/v1/servicemanagement-gen.go b/servicemanagement/v1/servicemanagement-gen.go
index 3581f7b6a8d..680a008020b 100644
--- a/servicemanagement/v1/servicemanagement-gen.go
+++ b/servicemanagement/v1/servicemanagement-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-management/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicemanagement/v1"
-// ...
-// ctx := context.Background()
-// servicemanagementService, err := servicemanagement.NewService(ctx)
+// import "google.golang.org/api/servicemanagement/v1"
+// ...
+// ctx := context.Background()
+// servicemanagementService, err := servicemanagement.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// servicemanagementService, err := servicemanagement.NewService(ctx, option.WithScopes(servicemanagement.ServiceManagementReadonlyScope))
+// servicemanagementService, err := servicemanagement.NewService(ctx, option.WithScopes(servicemanagement.ServiceManagementReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicemanagementService, err := servicemanagement.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicemanagementService, err := servicemanagement.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicemanagementService, err := servicemanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicemanagementService, err := servicemanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicemanagement // import "google.golang.org/api/servicemanagement/v1"
@@ -878,16 +878,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -5302,9 +5306,9 @@ type ServicesDeleteCall struct {
// service producers may call UndeleteService to restore the service.
// After 30 days, the service will be permanently deleted. Operation
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesService) Delete(serviceName string) *ServicesDeleteCall {
c := &ServicesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -5573,9 +5577,9 @@ type ServicesGetCall struct {
// Get: Gets a managed service. Authentication is required unless the
// service is public.
//
-// - serviceName: The name of the service. See the `ServiceManager`
-// overview for naming requirements. For example:
-// `example.googleapis.com`.
+// - serviceName: The name of the service. See the `ServiceManager`
+// overview for naming requirements. For example:
+// `example.googleapis.com`.
func (r *ServicesService) Get(serviceName string) *ServicesGetCall {
c := &ServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -5724,9 +5728,9 @@ type ServicesGetConfigCall struct {
// GetConfig: Gets a service configuration (version) for a managed
// service.
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesService) GetConfig(serviceName string) *ServicesGetConfigCall {
c := &ServicesGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -5745,8 +5749,10 @@ func (c *ServicesGetConfigCall) ConfigId(configId string) *ServicesGetConfigCall
// Service Config should be returned in the response.
//
// Possible values:
-// "BASIC" - Server response includes all fields except SourceInfo.
-// "FULL" - Server response includes all fields including SourceInfo.
+//
+// "BASIC" - Server response includes all fields except SourceInfo.
+// "FULL" - Server response includes all fields including SourceInfo.
+//
// SourceFiles are of type 'google.api.servicemanagement.v1.ConfigFile'
// and are only available for configs created using the
// SubmitConfigSource method.
@@ -5916,10 +5922,10 @@ type ServicesGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ServicesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ServicesGetIamPolicyCall {
c := &ServicesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6273,10 +6279,10 @@ type ServicesSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ServicesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ServicesSetIamPolicyCall {
c := &ServicesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6424,10 +6430,10 @@ type ServicesTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ServicesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ServicesTestIamPermissionsCall {
c := &ServicesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -6574,9 +6580,9 @@ type ServicesUndeleteCall struct {
// was deleted. The target service must exist and must have been deleted
// within the last 30 days. Operation
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesService) Undelete(serviceName string) *ServicesUndeleteCall {
c := &ServicesUndeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -6714,9 +6720,9 @@ type ServicesConfigsCreateCall struct {
// and ones referenced by existing rollouts are kept for each service.
// The rest will be deleted eventually.
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesConfigsService) Create(serviceName string, service *Service) *ServicesConfigsCreateCall {
c := &ServicesConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -6859,12 +6865,12 @@ type ServicesConfigsGetCall struct {
// Get: Gets a service configuration (version) for a managed service.
//
-// - configId: The id of the service configuration resource. This field
-// must be specified for the server to return all fields, including
-// `SourceInfo`.
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - configId: The id of the service configuration resource. This field
+// must be specified for the server to return all fields, including
+// `SourceInfo`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesConfigsService) Get(serviceName string, configId string) *ServicesConfigsGetCall {
c := &ServicesConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -6876,8 +6882,10 @@ func (r *ServicesConfigsService) Get(serviceName string, configId string) *Servi
// Service Config should be returned in the response.
//
// Possible values:
-// "BASIC" - Server response includes all fields except SourceInfo.
-// "FULL" - Server response includes all fields including SourceInfo.
+//
+// "BASIC" - Server response includes all fields except SourceInfo.
+// "FULL" - Server response includes all fields including SourceInfo.
+//
// SourceFiles are of type 'google.api.servicemanagement.v1.ConfigFile'
// and are only available for configs created using the
// SubmitConfigSource method.
@@ -7049,9 +7057,9 @@ type ServicesConfigsListCall struct {
// List: Lists the history of the service configuration for a managed
// service, from the newest to the oldest.
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesConfigsService) List(serviceName string) *ServicesConfigsListCall {
c := &ServicesConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -7253,9 +7261,9 @@ type ServicesConfigsSubmitCall struct {
// and ones referenced by existing service configurtions are kept for
// each service. The rest will be deleted eventually. Operation
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesConfigsService) Submit(serviceName string, submitconfigsourcerequest *SubmitConfigSourceRequest) *ServicesConfigsSubmitCall {
c := &ServicesConfigsSubmitCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -7399,10 +7407,10 @@ type ServicesConsumersGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ServicesConsumersService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ServicesConsumersGetIamPolicyCall {
c := &ServicesConsumersGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7549,10 +7557,10 @@ type ServicesConsumersSetIamPolicyCall struct {
// resource. Replaces any existing policy. Can return `NOT_FOUND`,
// `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ServicesConsumersService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ServicesConsumersSetIamPolicyCall {
c := &ServicesConsumersSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7700,10 +7708,10 @@ type ServicesConsumersTestIamPermissionsCall struct {
// and command-line tools, not for authorization checking. This
// operation may "fail open" without warning.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ServicesConsumersService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ServicesConsumersTestIamPermissionsCall {
c := &ServicesConsumersTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7857,9 +7865,9 @@ type ServicesRolloutsCreateCall struct {
// set of 100 most recent) rollouts are kept for each service. The rest
// will be deleted eventually. Operation
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesRolloutsService) Create(serviceName string, rollout *Rollout) *ServicesRolloutsCreateCall {
c := &ServicesRolloutsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -8002,10 +8010,10 @@ type ServicesRolloutsGetCall struct {
// Get: Gets a service configuration rollout.
//
-// - rolloutId: The id of the rollout resource.
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - rolloutId: The id of the rollout resource.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesRolloutsService) Get(serviceName string, rolloutId string) *ServicesRolloutsGetCall {
c := &ServicesRolloutsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
@@ -8163,9 +8171,9 @@ type ServicesRolloutsListCall struct {
// List: Lists the history of the service configuration rollouts for a
// managed service, from the newest to the oldest.
//
-// - serviceName: The name of the service. See the overview
-// (https://cloud.google.com/service-management/overview) for naming
-// requirements. For example: `example.googleapis.com`.
+// - serviceName: The name of the service. See the overview
+// (https://cloud.google.com/service-management/overview) for naming
+// requirements. For example: `example.googleapis.com`.
func (r *ServicesRolloutsService) List(serviceName string) *ServicesRolloutsListCall {
c := &ServicesRolloutsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.serviceName = serviceName
diff --git a/servicenetworking/v1/servicenetworking-api.json b/servicenetworking/v1/servicenetworking-api.json
index 963636bf081..a08a37dd056 100644
--- a/servicenetworking/v1/servicenetworking-api.json
+++ b/servicenetworking/v1/servicenetworking-api.json
@@ -865,7 +865,7 @@
}
}
},
- "revision": "20220720",
+ "revision": "20220816",
"rootUrl": "https://servicenetworking.googleapis.com/",
"schemas": {
"AddDnsRecordSetMetadata": {
@@ -2519,6 +2519,10 @@
"description": "OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for \"Read-only access to Google Calendar\" and \"Access to Cloud Platform\". Users can consent to a scope for an application, giving it permission to access that data on their behalf. OAuth scope specifications should be fairly coarse grained; a user will need to see and understand the text description of what your scope means. In most cases: use one or at most two OAuth scopes for an entire family of products. If your product has multiple APIs, you should probably be sharing the OAuth scope across all of those APIs. When you need finer grained OAuth consent screens: talk with your product management about how developers will use them in practice. Please note that even though each of the canonical scopes is enough for a request to be accepted and passed to the backend, a request can still fail due to the backend requiring additional scopes or permissions.",
"id": "OAuthRequirements",
"properties": {
+ "allowAnyScope": {
+ "description": "UNIMPLEMENTED: If enabled, ESF will allow OAuth credentials with any scope, more details in http://go/esf-oauth-any-scope. WARNING: Enabling this option will bring security risks. Customers enabling this feature accidentally may have the risk of losing authentication enforcement. Please reach out to api-auth@ and esf-team@ for approval and allowlisting before you enable this option. ",
+ "type": "boolean"
+ },
"canonicalScopes": {
"description": "The list of publicly documented OAuth scopes that are allowed access. An OAuth token containing any of these scopes will be accepted. Example: canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.read",
"type": "string"
diff --git a/servicenetworking/v1/servicenetworking-gen.go b/servicenetworking/v1/servicenetworking-gen.go
index 83274330c2a..fb34819c2bb 100644
--- a/servicenetworking/v1/servicenetworking-gen.go
+++ b/servicenetworking/v1/servicenetworking-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicenetworking/v1"
-// ...
-// ctx := context.Background()
-// servicenetworkingService, err := servicenetworking.NewService(ctx)
+// import "google.golang.org/api/servicenetworking/v1"
+// ...
+// ctx := context.Background()
+// servicenetworkingService, err := servicenetworking.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithScopes(servicenetworking.ServiceManagementScope))
+// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithScopes(servicenetworking.ServiceManagementScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicenetworking // import "google.golang.org/api/servicenetworking/v1"
@@ -3483,6 +3483,15 @@ func (s *MonitoringDestination) MarshalJSON() ([]byte, error) {
// accepted and passed to the backend, a request can still fail due to
// the backend requiring additional scopes or permissions.
type OAuthRequirements struct {
+ // AllowAnyScope: UNIMPLEMENTED: If enabled, ESF will allow OAuth
+ // credentials with any scope, more details in
+ // http://go/esf-oauth-any-scope. WARNING: Enabling this option will
+ // bring security risks. Customers enabling this feature accidentally
+ // may have the risk of losing authentication enforcement. Please reach
+ // out to api-auth@ and esf-team@ for approval and allowlisting before
+ // you enable this option.
+ AllowAnyScope bool `json:"allowAnyScope,omitempty"`
+
// CanonicalScopes: The list of publicly documented OAuth scopes that
// are allowed access. An OAuth token containing any of these scopes
// will be accepted. Example: canonical_scopes:
@@ -3490,7 +3499,7 @@ type OAuthRequirements struct {
// https://www.googleapis.com/auth/calendar.read
CanonicalScopes string `json:"canonicalScopes,omitempty"`
- // ForceSendFields is a list of field names (e.g. "CanonicalScopes") to
+ // ForceSendFields is a list of field names (e.g. "AllowAnyScope") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -3498,13 +3507,12 @@ type OAuthRequirements struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CanonicalScopes") to
- // include in API requests with the JSON null value. By default, fields
- // with empty values are omitted from API requests. However, any field
- // with an empty value appearing in NullFields will be sent to the
- // server as null. It is an 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. "AllowAnyScope") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
@@ -5702,14 +5710,14 @@ type ServicesAddSubnetworkCall struct {
// producer's tenant project to be a shared VPC service project as
// needed.
//
-// - parent: A tenant project in the service producer organization, in
-// the following format:
-// services/{service}/{collection-id}/{resource-id}. {collection-id}
-// is the cloud resource collection type that represents the tenant
-// project. Only `projects` are supported. {resource-id} is the tenant
-// project numeric id, such as `123456`. {service} the name of the
-// peering service, such as `service-peering.example.com`. This
-// service must already be enabled in the service consumer's project.
+// - parent: A tenant project in the service producer organization, in
+// the following format:
+// services/{service}/{collection-id}/{resource-id}. {collection-id}
+// is the cloud resource collection type that represents the tenant
+// project. Only `projects` are supported. {resource-id} is the tenant
+// project numeric id, such as `123456`. {service} the name of the
+// peering service, such as `service-peering.example.com`. This
+// service must already be enabled in the service consumer's project.
func (r *ServicesService) AddSubnetwork(parent string, addsubnetworkrequest *AddSubnetworkRequest) *ServicesAddSubnetworkCall {
c := &ServicesAddSubnetworkCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5853,10 +5861,10 @@ type ServicesDisableVpcServiceControlsCall struct {
// DisableVpcServiceControls: Disables VPC service controls for a
// connection.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesService) DisableVpcServiceControls(parent string, disablevpcservicecontrolsrequest *DisableVpcServiceControlsRequest) *ServicesDisableVpcServiceControlsCall {
c := &ServicesDisableVpcServiceControlsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6000,10 +6008,10 @@ type ServicesEnableVpcServiceControlsCall struct {
// EnableVpcServiceControls: Enables VPC service controls for a
// connection.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesService) EnableVpcServiceControls(parent string, enablevpcservicecontrolsrequest *EnableVpcServiceControlsRequest) *ServicesEnableVpcServiceControlsCall {
c := &ServicesEnableVpcServiceControlsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6151,9 +6159,9 @@ type ServicesSearchRangeCall struct {
// non-conflicting sub-range of requested size (expressed in number of
// leading bits of ipv4 network mask, as in CIDR range notation).
//
-// - parent: This is in a form services/{service}. {service} the name of
-// the private access management service, for example
-// 'service-peering.example.com'.
+// - parent: This is in a form services/{service}. {service} the name of
+// the private access management service, for example
+// 'service-peering.example.com'.
func (r *ServicesService) SearchRange(parent string, searchrangerequest *SearchRangeRequest) *ServicesSearchRangeCall {
c := &ServicesSearchRangeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6300,9 +6308,9 @@ type ServicesValidateCall struct {
// and not have to wait for AddSubnetwork operation completion to
// determine if user request is invalid.
//
-// - parent: This is in a form services/{service} where {service} is the
-// name of the private access management service. For example
-// 'service-peering.example.com'.
+// - parent: This is in a form services/{service} where {service} is the
+// name of the private access management service. For example
+// 'service-peering.example.com'.
func (r *ServicesService) Validate(parent string, validateconsumerconfigrequest *ValidateConsumerConfigRequest) *ServicesValidateCall {
c := &ServicesValidateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6452,10 +6460,10 @@ type ServicesConnectionsCreateCall struct {
// services in the service producer's organization, so it only needs to
// be invoked once.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesConnectionsService) Create(parent string, connection *Connection) *ServicesConnectionsCreateCall {
c := &ServicesConnectionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6598,13 +6606,13 @@ type ServicesConnectionsDeleteConnectionCall struct {
// DeleteConnection: Deletes a private service access connection.
//
-// - name: The private service connection that connects to a service
-// producer organization. The name includes both the private service
-// name and the VPC network peering name in the format of
-// `services/{peering_service_name}/connections/{vpc_peering_name}`.
-// For Google services that support this functionality, this is
-// `services/servicenetworking.googleapis.com/connections/servicenetwor
-// king-googleapis-com`.
+// - name: The private service connection that connects to a service
+// producer organization. The name includes both the private service
+// name and the VPC network peering name in the format of
+// `services/{peering_service_name}/connections/{vpc_peering_name}`.
+// For Google services that support this functionality, this is
+// `services/servicenetworking.googleapis.com/connections/servicenetwor
+// king-googleapis-com`.
func (r *ServicesConnectionsService) DeleteConnection(name string, deleteconnectionrequest *DeleteConnectionRequest) *ServicesConnectionsDeleteConnectionCall {
c := &ServicesConnectionsDeleteConnectionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6748,12 +6756,12 @@ type ServicesConnectionsListCall struct {
// List: List the private connections that are configured in a service
// consumer's VPC network.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`. If you specify
-// `services/-` as the parameter value, all configured peering
-// services are listed.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`. If you specify
+// `services/-` as the parameter value, all configured peering
+// services are listed.
func (r *ServicesConnectionsService) List(parent string) *ServicesConnectionsListCall {
c := &ServicesConnectionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6918,13 +6926,13 @@ type ServicesConnectionsPatchCall struct {
// Patch: Updates the allocated ranges that are assigned to a
// connection.
//
-// - name: The private service connection that connects to a service
-// producer organization. The name includes both the private service
-// name and the VPC network peering name in the format of
-// `services/{peering_service_name}/connections/{vpc_peering_name}`.
-// For Google services that support this functionality, this is
-// `services/servicenetworking.googleapis.com/connections/servicenetwor
-// king-googleapis-com`.
+// - name: The private service connection that connects to a service
+// producer organization. The name includes both the private service
+// name and the VPC network peering name in the format of
+// `services/{peering_service_name}/connections/{vpc_peering_name}`.
+// For Google services that support this functionality, this is
+// `services/servicenetworking.googleapis.com/connections/servicenetwor
+// king-googleapis-com`.
func (r *ServicesConnectionsService) Patch(name string, connection *Connection) *ServicesConnectionsPatchCall {
c := &ServicesConnectionsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7094,10 +7102,10 @@ type ServicesDnsRecordSetsAddCall struct {
// Add: Service producers can use this method to add DNS record sets to
// private DNS zones in the shared producer host project.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesDnsRecordSetsService) Add(parent string, adddnsrecordsetrequest *AddDnsRecordSetRequest) *ServicesDnsRecordSetsAddCall {
c := &ServicesDnsRecordSetsAddCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7241,10 +7249,10 @@ type ServicesDnsRecordSetsRemoveCall struct {
// Remove: Service producers can use this method to remove DNS record
// sets from private DNS zones in the shared producer host project.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesDnsRecordSetsService) Remove(parent string, removednsrecordsetrequest *RemoveDnsRecordSetRequest) *ServicesDnsRecordSetsRemoveCall {
c := &ServicesDnsRecordSetsRemoveCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7388,10 +7396,10 @@ type ServicesDnsRecordSetsUpdateCall struct {
// Update: Service producers can use this method to update DNS record
// sets from private DNS zones in the shared producer host project.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesDnsRecordSetsService) Update(parent string, updatednsrecordsetrequest *UpdateDnsRecordSetRequest) *ServicesDnsRecordSetsUpdateCall {
c := &ServicesDnsRecordSetsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7536,10 +7544,10 @@ type ServicesDnsZonesAddCall struct {
// in the shared producer host project and matching peering zones in the
// consumer project.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesDnsZonesService) Add(parent string, adddnszonerequest *AddDnsZoneRequest) *ServicesDnsZonesAddCall {
c := &ServicesDnsZonesAddCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7684,10 +7692,10 @@ type ServicesDnsZonesRemoveCall struct {
// zones in the shared producer host project and matching peering zones
// in the consumer project.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesDnsZonesService) Remove(parent string, removednszonerequest *RemoveDnsZoneRequest) *ServicesDnsZonesRemoveCall {
c := &ServicesDnsZonesRemoveCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7832,14 +7840,14 @@ type ServicesProjectsGlobalNetworksGetCall struct {
// their connection including the import/export of custom routes and
// subnetwork routes with public IP.
//
-// - name: Name of the consumer config to retrieve in the format:
-// `services/{service}/projects/{project}/global/networks/{network}`.
-// {service} is the peering service that is managing connectivity for
-// the service producer's organization. For Google services that
-// support this functionality, this value is
-// `servicenetworking.googleapis.com`. {project} is a project number
-// e.g. `12345` that contains the service consumer's VPC network.
-// {network} is the name of the service consumer's VPC network.
+// - name: Name of the consumer config to retrieve in the format:
+// `services/{service}/projects/{project}/global/networks/{network}`.
+// {service} is the peering service that is managing connectivity for
+// the service producer's organization. For Google services that
+// support this functionality, this value is
+// `servicenetworking.googleapis.com`. {project} is a project number
+// e.g. `12345` that contains the service consumer's VPC network.
+// {network} is the name of the service consumer's VPC network.
func (r *ServicesProjectsGlobalNetworksService) Get(name string) *ServicesProjectsGlobalNetworksGetCall {
c := &ServicesProjectsGlobalNetworksGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8004,16 +8012,16 @@ type ServicesProjectsGlobalNetworksUpdateConsumerConfigCall struct {
// configuration of their connection including the import/export of
// custom routes and subnetwork routes with public IP.
//
-// - parent: Parent resource identifying the connection for which the
-// consumer config is being updated in the format:
-// `services/{service}/projects/{project}/global/networks/{network}`
-// {service} is the peering service that is managing connectivity for
-// the service producer's organization. For Google services that
-// support this functionality, this value is
-// `servicenetworking.googleapis.com`. {project} is the number of the
-// project that contains the service consumer's VPC network e.g.
-// `12345`. {network} is the name of the service consumer's VPC
-// network.
+// - parent: Parent resource identifying the connection for which the
+// consumer config is being updated in the format:
+// `services/{service}/projects/{project}/global/networks/{network}`
+// {service} is the peering service that is managing connectivity for
+// the service producer's organization. For Google services that
+// support this functionality, this value is
+// `servicenetworking.googleapis.com`. {project} is the number of the
+// project that contains the service consumer's VPC network e.g.
+// `12345`. {network} is the name of the service consumer's VPC
+// network.
func (r *ServicesProjectsGlobalNetworksService) UpdateConsumerConfig(parent string, updateconsumerconfigrequest *UpdateConsumerConfigRequest) *ServicesProjectsGlobalNetworksUpdateConsumerConfigCall {
c := &ServicesProjectsGlobalNetworksUpdateConsumerConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8158,16 +8166,16 @@ type ServicesProjectsGlobalNetworksPeeredDnsDomainsCreateCall struct {
// in given namespace originating in the service producer VPC network to
// the consumer VPC network to be resolved.
//
-// - parent: Parent resource identifying the connection for which the
-// peered DNS domain will be created in the format:
-// `services/{service}/projects/{project}/global/networks/{network}`
-// {service} is the peering service that is managing connectivity for
-// the service producer's organization. For Google services that
-// support this functionality, this value is
-// `servicenetworking.googleapis.com`. {project} is the number of the
-// project that contains the service consumer's VPC network e.g.
-// `12345`. {network} is the name of the service consumer's VPC
-// network.
+// - parent: Parent resource identifying the connection for which the
+// peered DNS domain will be created in the format:
+// `services/{service}/projects/{project}/global/networks/{network}`
+// {service} is the peering service that is managing connectivity for
+// the service producer's organization. For Google services that
+// support this functionality, this value is
+// `servicenetworking.googleapis.com`. {project} is the number of the
+// project that contains the service consumer's VPC network e.g.
+// `12345`. {network} is the name of the service consumer's VPC
+// network.
func (r *ServicesProjectsGlobalNetworksPeeredDnsDomainsService) Create(parent string, peereddnsdomain *PeeredDnsDomain) *ServicesProjectsGlobalNetworksPeeredDnsDomainsCreateCall {
c := &ServicesProjectsGlobalNetworksPeeredDnsDomainsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8309,15 +8317,15 @@ type ServicesProjectsGlobalNetworksPeeredDnsDomainsDeleteCall struct {
// Delete: Deletes a peered DNS domain.
//
-// - name: The name of the peered DNS domain to delete in the format:
-// `services/{service}/projects/{project}/global/networks/{network}/pee
-// redDnsDomains/{name}`. {service} is the peering service that is
-// managing connectivity for the service producer's organization. For
-// Google services that support this functionality, this value is
-// `servicenetworking.googleapis.com`. {project} is the number of the
-// project that contains the service consumer's VPC network e.g.
-// `12345`. {network} is the name of the service consumer's VPC
-// network. {name} is the name of the peered DNS domain.
+// - name: The name of the peered DNS domain to delete in the format:
+// `services/{service}/projects/{project}/global/networks/{network}/pee
+// redDnsDomains/{name}`. {service} is the peering service that is
+// managing connectivity for the service producer's organization. For
+// Google services that support this functionality, this value is
+// `servicenetworking.googleapis.com`. {project} is the number of the
+// project that contains the service consumer's VPC network e.g.
+// `12345`. {network} is the name of the service consumer's VPC
+// network. {name} is the name of the peered DNS domain.
func (r *ServicesProjectsGlobalNetworksPeeredDnsDomainsService) Delete(name string) *ServicesProjectsGlobalNetworksPeeredDnsDomainsDeleteCall {
c := &ServicesProjectsGlobalNetworksPeeredDnsDomainsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8451,15 +8459,15 @@ type ServicesProjectsGlobalNetworksPeeredDnsDomainsListCall struct {
// List: Lists peered DNS domains for a connection.
//
-// - parent: Parent resource identifying the connection which owns this
-// collection of peered DNS domains in the format:
-// `services/{service}/projects/{project}/global/networks/{network}`.
-// {service} is the peering service that is managing connectivity for
-// the service producer's organization. For Google services that
-// support this functionality, this value is
-// `servicenetworking.googleapis.com`. {project} is a project number
-// e.g. `12345` that contains the service consumer's VPC network.
-// {network} is the name of the service consumer's VPC network.
+// - parent: Parent resource identifying the connection which owns this
+// collection of peered DNS domains in the format:
+// `services/{service}/projects/{project}/global/networks/{network}`.
+// {service} is the peering service that is managing connectivity for
+// the service producer's organization. For Google services that
+// support this functionality, this value is
+// `servicenetworking.googleapis.com`. {project} is a project number
+// e.g. `12345` that contains the service consumer's VPC network.
+// {network} is the name of the service consumer's VPC network.
func (r *ServicesProjectsGlobalNetworksPeeredDnsDomainsService) List(parent string) *ServicesProjectsGlobalNetworksPeeredDnsDomainsListCall {
c := &ServicesProjectsGlobalNetworksPeeredDnsDomainsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8609,9 +8617,9 @@ type ServicesRolesAddCall struct {
// role must be selected from within an allowlisted set of roles. Each
// role is applied at only the granularity specified in the allowlist.
//
-// - parent: This is in a form services/{service} where {service} is the
-// name of the private access management service. For example
-// 'service-peering.example.com'.
+// - parent: This is in a form services/{service} where {service} is the
+// name of the private access management service. For example
+// 'service-peering.example.com'.
func (r *ServicesRolesService) Add(parent string, addrolesrequest *AddRolesRequest) *ServicesRolesAddCall {
c := &ServicesRolesAddCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/servicenetworking/v1beta/servicenetworking-api.json b/servicenetworking/v1beta/servicenetworking-api.json
index 89fb46c692e..163e1e56aea 100644
--- a/servicenetworking/v1beta/servicenetworking-api.json
+++ b/servicenetworking/v1beta/servicenetworking-api.json
@@ -307,7 +307,7 @@
}
}
},
- "revision": "20220720",
+ "revision": "20220816",
"rootUrl": "https://servicenetworking.googleapis.com/",
"schemas": {
"AddDnsRecordSetMetadata": {
@@ -1777,6 +1777,10 @@
"description": "OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for \"Read-only access to Google Calendar\" and \"Access to Cloud Platform\". Users can consent to a scope for an application, giving it permission to access that data on their behalf. OAuth scope specifications should be fairly coarse grained; a user will need to see and understand the text description of what your scope means. In most cases: use one or at most two OAuth scopes for an entire family of products. If your product has multiple APIs, you should probably be sharing the OAuth scope across all of those APIs. When you need finer grained OAuth consent screens: talk with your product management about how developers will use them in practice. Please note that even though each of the canonical scopes is enough for a request to be accepted and passed to the backend, a request can still fail due to the backend requiring additional scopes or permissions.",
"id": "OAuthRequirements",
"properties": {
+ "allowAnyScope": {
+ "description": "UNIMPLEMENTED: If enabled, ESF will allow OAuth credentials with any scope, more details in http://go/esf-oauth-any-scope. WARNING: Enabling this option will bring security risks. Customers enabling this feature accidentally may have the risk of losing authentication enforcement. Please reach out to api-auth@ and esf-team@ for approval and allowlisting before you enable this option. ",
+ "type": "boolean"
+ },
"canonicalScopes": {
"description": "The list of publicly documented OAuth scopes that are allowed access. An OAuth token containing any of these scopes will be accepted. Example: canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.read",
"type": "string"
diff --git a/servicenetworking/v1beta/servicenetworking-gen.go b/servicenetworking/v1beta/servicenetworking-gen.go
index e1494fd2042..4d31ce42ac0 100644
--- a/servicenetworking/v1beta/servicenetworking-gen.go
+++ b/servicenetworking/v1beta/servicenetworking-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/servicenetworking/v1beta"
-// ...
-// ctx := context.Background()
-// servicenetworkingService, err := servicenetworking.NewService(ctx)
+// import "google.golang.org/api/servicenetworking/v1beta"
+// ...
+// ctx := context.Background()
+// servicenetworkingService, err := servicenetworking.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithScopes(servicenetworking.ServiceManagementScope))
+// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithScopes(servicenetworking.ServiceManagementScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithAPIKey("AIza..."))
+// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// servicenetworkingService, err := servicenetworking.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package servicenetworking // import "google.golang.org/api/servicenetworking/v1beta"
@@ -2994,6 +2994,15 @@ func (s *MonitoringDestination) MarshalJSON() ([]byte, error) {
// accepted and passed to the backend, a request can still fail due to
// the backend requiring additional scopes or permissions.
type OAuthRequirements struct {
+ // AllowAnyScope: UNIMPLEMENTED: If enabled, ESF will allow OAuth
+ // credentials with any scope, more details in
+ // http://go/esf-oauth-any-scope. WARNING: Enabling this option will
+ // bring security risks. Customers enabling this feature accidentally
+ // may have the risk of losing authentication enforcement. Please reach
+ // out to api-auth@ and esf-team@ for approval and allowlisting before
+ // you enable this option.
+ AllowAnyScope bool `json:"allowAnyScope,omitempty"`
+
// CanonicalScopes: The list of publicly documented OAuth scopes that
// are allowed access. An OAuth token containing any of these scopes
// will be accepted. Example: canonical_scopes:
@@ -3001,7 +3010,7 @@ type OAuthRequirements struct {
// https://www.googleapis.com/auth/calendar.read
CanonicalScopes string `json:"canonicalScopes,omitempty"`
- // ForceSendFields is a list of field names (e.g. "CanonicalScopes") to
+ // ForceSendFields is a list of field names (e.g. "AllowAnyScope") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -3009,13 +3018,12 @@ type OAuthRequirements struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CanonicalScopes") to
- // include in API requests with the JSON null value. By default, fields
- // with empty values are omitted from API requests. However, any field
- // with an empty value appearing in NullFields will be sent to the
- // server as null. It is an 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. "AllowAnyScope") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
@@ -4323,14 +4331,14 @@ type ServicesAddSubnetworkCall struct {
// needed. The response from the `get` operation will be of type
// `Subnetwork` if the operation successfully completes.
//
-// - parent: A tenant project in the service producer organization, in
-// the following format:
-// services/{service}/{collection-id}/{resource-id}. {collection-id}
-// is the cloud resource collection type that represents the tenant
-// project. Only `projects` are supported. {resource-id} is the tenant
-// project numeric id, such as `123456`. {service} the name of the
-// peering service, such as `service-peering.example.com`. This
-// service must already be enabled in the service consumer's project.
+// - parent: A tenant project in the service producer organization, in
+// the following format:
+// services/{service}/{collection-id}/{resource-id}. {collection-id}
+// is the cloud resource collection type that represents the tenant
+// project. Only `projects` are supported. {resource-id} is the tenant
+// project numeric id, such as `123456`. {service} the name of the
+// peering service, such as `service-peering.example.com`. This
+// service must already be enabled in the service consumer's project.
func (r *ServicesService) AddSubnetwork(parent string, addsubnetworkrequest *AddSubnetworkRequest) *ServicesAddSubnetworkCall {
c := &ServicesAddSubnetworkCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4479,9 +4487,9 @@ type ServicesSearchRangeCall struct {
// leading bits of ipv4 network mask, as in CIDR range notation).
// Operation
//
-// - parent: This is in a form services/{service}. {service} the name of
-// the private access management service, for example
-// 'service-peering.example.com'.
+// - parent: This is in a form services/{service}. {service} the name of
+// the private access management service, for example
+// 'service-peering.example.com'.
func (r *ServicesService) SearchRange(parent string, searchrangerequest *SearchRangeRequest) *ServicesSearchRangeCall {
c := &ServicesSearchRangeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4626,10 +4634,10 @@ type ServicesUpdateConnectionsCall struct {
// a connection. The response from the `get` operation will be of type
// `Connection` if the operation successfully completes.
//
-// - name: The service producer peering service that is managing peering
-// connectivity for a service producer organization. For Google
-// services that support this functionality, this is
-// `services/servicenetworking.googleapis.com`.
+// - name: The service producer peering service that is managing peering
+// connectivity for a service producer organization. For Google
+// services that support this functionality, this is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesService) UpdateConnections(name string, googlecloudservicenetworkingv1betaconnection *GoogleCloudServicenetworkingV1betaConnection) *ServicesUpdateConnectionsCall {
c := &ServicesUpdateConnectionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -4806,10 +4814,10 @@ type ServicesConnectionsCreateCall struct {
// be invoked once. The response from the `get` operation will be of
// type `Connection` if the operation successfully completes.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`.
func (r *ServicesConnectionsService) Create(parent string, googlecloudservicenetworkingv1betaconnection *GoogleCloudServicenetworkingV1betaConnection) *ServicesConnectionsCreateCall {
c := &ServicesConnectionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4953,12 +4961,12 @@ type ServicesConnectionsListCall struct {
// List: List the private connections that are configured in a service
// consumer's VPC network.
//
-// - parent: The service that is managing peering connectivity for a
-// service producer's organization. For Google services that support
-// this functionality, this value is
-// `services/servicenetworking.googleapis.com`. If you specify `-` as
-// the parameter value, all configured public peering services are
-// listed.
+// - parent: The service that is managing peering connectivity for a
+// service producer's organization. For Google services that support
+// this functionality, this value is
+// `services/servicenetworking.googleapis.com`. If you specify `-` as
+// the parameter value, all configured public peering services are
+// listed.
func (r *ServicesConnectionsService) List(parent string) *ServicesConnectionsListCall {
c := &ServicesConnectionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/serviceusage/v1/serviceusage-api.json b/serviceusage/v1/serviceusage-api.json
index 0d5bff2081c..f3a7f1db500 100644
--- a/serviceusage/v1/serviceusage-api.json
+++ b/serviceusage/v1/serviceusage-api.json
@@ -426,7 +426,7 @@
}
}
},
- "revision": "20220615",
+ "revision": "20220816",
"rootUrl": "https://serviceusage.googleapis.com/",
"schemas": {
"AdminQuotaPolicy": {
@@ -2153,6 +2153,10 @@
"description": "OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for \"Read-only access to Google Calendar\" and \"Access to Cloud Platform\". Users can consent to a scope for an application, giving it permission to access that data on their behalf. OAuth scope specifications should be fairly coarse grained; a user will need to see and understand the text description of what your scope means. In most cases: use one or at most two OAuth scopes for an entire family of products. If your product has multiple APIs, you should probably be sharing the OAuth scope across all of those APIs. When you need finer grained OAuth consent screens: talk with your product management about how developers will use them in practice. Please note that even though each of the canonical scopes is enough for a request to be accepted and passed to the backend, a request can still fail due to the backend requiring additional scopes or permissions.",
"id": "OAuthRequirements",
"properties": {
+ "allowAnyScope": {
+ "description": "UNIMPLEMENTED: If enabled, ESF will allow OAuth credentials with any scope, more details in http://go/esf-oauth-any-scope. WARNING: Enabling this option will bring security risks. Customers enabling this feature accidentally may have the risk of losing authentication enforcement. Please reach out to api-auth@ and esf-team@ for approval and allowlisting before you enable this option. ",
+ "type": "boolean"
+ },
"canonicalScopes": {
"description": "The list of publicly documented OAuth scopes that are allowed access. An OAuth token containing any of these scopes will be accepted. Example: canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.read",
"type": "string"
diff --git a/serviceusage/v1/serviceusage-gen.go b/serviceusage/v1/serviceusage-gen.go
index 2f69383fdc9..9cdfbd8be24 100644
--- a/serviceusage/v1/serviceusage-gen.go
+++ b/serviceusage/v1/serviceusage-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-usage/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/serviceusage/v1"
-// ...
-// ctx := context.Background()
-// serviceusageService, err := serviceusage.NewService(ctx)
+// import "google.golang.org/api/serviceusage/v1"
+// ...
+// ctx := context.Background()
+// serviceusageService, err := serviceusage.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// serviceusageService, err := serviceusage.NewService(ctx, option.WithScopes(serviceusage.ServiceManagementScope))
+// serviceusageService, err := serviceusage.NewService(ctx, option.WithScopes(serviceusage.ServiceManagementScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// serviceusageService, err := serviceusage.NewService(ctx, option.WithAPIKey("AIza..."))
+// serviceusageService, err := serviceusage.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// serviceusageService, err := serviceusage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// serviceusageService, err := serviceusage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package serviceusage // import "google.golang.org/api/serviceusage/v1"
@@ -3406,6 +3406,15 @@ func (s *MonitoringDestination) MarshalJSON() ([]byte, error) {
// accepted and passed to the backend, a request can still fail due to
// the backend requiring additional scopes or permissions.
type OAuthRequirements struct {
+ // AllowAnyScope: UNIMPLEMENTED: If enabled, ESF will allow OAuth
+ // credentials with any scope, more details in
+ // http://go/esf-oauth-any-scope. WARNING: Enabling this option will
+ // bring security risks. Customers enabling this feature accidentally
+ // may have the risk of losing authentication enforcement. Please reach
+ // out to api-auth@ and esf-team@ for approval and allowlisting before
+ // you enable this option.
+ AllowAnyScope bool `json:"allowAnyScope,omitempty"`
+
// CanonicalScopes: The list of publicly documented OAuth scopes that
// are allowed access. An OAuth token containing any of these scopes
// will be accepted. Example: canonical_scopes:
@@ -3413,7 +3422,7 @@ type OAuthRequirements struct {
// https://www.googleapis.com/auth/calendar.read
CanonicalScopes string `json:"canonicalScopes,omitempty"`
- // ForceSendFields is a list of field names (e.g. "CanonicalScopes") to
+ // ForceSendFields is a list of field names (e.g. "AllowAnyScope") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -3421,13 +3430,12 @@ type OAuthRequirements struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CanonicalScopes") to
- // include in API requests with the JSON null value. By default, fields
- // with empty values are omitted from API requests. However, any field
- // with an empty value appearing in NullFields will be sent to the
- // server as null. It is an 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. "AllowAnyScope") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
@@ -4918,9 +4926,9 @@ type ServicesBatchEnableCall struct {
// and no state changes occur. To enable a single service, use the
// `EnableService` method instead.
//
-// - parent: Parent to enable services on. An example name would be:
-// `projects/123` where `123` is the project number. The
-// `BatchEnableServices` method currently only supports projects.
+// - parent: Parent to enable services on. An example name would be:
+// `projects/123` where `123` is the project number. The
+// `BatchEnableServices` method currently only supports projects.
func (r *ServicesService) BatchEnable(parent string, batchenableservicesrequest *BatchEnableServicesRequest) *ServicesBatchEnableCall {
c := &ServicesBatchEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5064,11 +5072,11 @@ type ServicesBatchGetCall struct {
// BatchGet: Returns the service configurations and enabled states for a
// given list of services.
//
-// - parent: Parent to retrieve services from. If this is set, the
-// parent of all of the services specified in `names` must match this
-// field. An example name would be: `projects/123` where `123` is the
-// project number. The `BatchGetServices` method currently only
-// supports projects.
+// - parent: Parent to retrieve services from. If this is set, the
+// parent of all of the services specified in `names` must match this
+// field. An example name would be: `projects/123` where `123` is the
+// project number. The `BatchGetServices` method currently only
+// supports projects.
func (r *ServicesService) BatchGet(parent string) *ServicesBatchGetCall {
c := &ServicesBatchGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5236,11 +5244,11 @@ type ServicesDisableCall struct {
// will receive a `FAILED_PRECONDITION` status if the target service is
// not currently enabled.
//
-// - name: Name of the consumer and service to disable the service on.
-// The enable and disable methods currently only support projects. An
-// example name would be:
-// `projects/123/services/serviceusage.googleapis.com` where `123` is
-// the project number.
+// - name: Name of the consumer and service to disable the service on.
+// The enable and disable methods currently only support projects. An
+// example name would be:
+// `projects/123/services/serviceusage.googleapis.com` where `123` is
+// the project number.
func (r *ServicesService) Disable(name string, disableservicerequest *DisableServiceRequest) *ServicesDisableCall {
c := &ServicesDisableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5383,12 +5391,12 @@ type ServicesEnableCall struct {
// Enable: Enable a service so that it can be used with a project.
//
-// - name: Name of the consumer and service to enable the service on.
-// The `EnableService` and `DisableService` methods currently only
-// support projects. Enabling a service requires that the service is
-// public or is shared with the user enabling the service. An example
-// name would be: `projects/123/services/serviceusage.googleapis.com`
-// where `123` is the project number.
+// - name: Name of the consumer and service to enable the service on.
+// The `EnableService` and `DisableService` methods currently only
+// support projects. Enabling a service requires that the service is
+// public or is shared with the user enabling the service. An example
+// name would be: `projects/123/services/serviceusage.googleapis.com`
+// where `123` is the project number.
func (r *ServicesService) Enable(name string, enableservicerequest *EnableServiceRequest) *ServicesEnableCall {
c := &ServicesEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5532,10 +5540,10 @@ type ServicesGetCall struct {
// Get: Returns the service configuration and enabled state for a given
// service.
//
-// - name: Name of the consumer and service to get the `ConsumerState`
-// for. An example name would be:
-// `projects/123/services/serviceusage.googleapis.com` where `123` is
-// the project number.
+// - name: Name of the consumer and service to get the `ConsumerState`
+// for. An example name would be:
+// `projects/123/services/serviceusage.googleapis.com` where `123` is
+// the project number.
func (r *ServicesService) Get(name string) *ServicesGetCall {
c := &ServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5692,8 +5700,8 @@ type ServicesListCall struct {
// (https://cloud.google.com/asset-inventory/docs/apis), which provides
// higher throughput and richer filtering capability.
//
-// - parent: Parent to search for services on. An example name would be:
-// `projects/123` where `123` is the project number.
+// - parent: Parent to search for services on. An example name would be:
+// `projects/123` where `123` is the project number.
func (r *ServicesService) List(parent string) *ServicesListCall {
c := &ServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/serviceusage/v1beta1/serviceusage-api.json b/serviceusage/v1beta1/serviceusage-api.json
index 57a210acba5..a264c332fd5 100644
--- a/serviceusage/v1beta1/serviceusage-api.json
+++ b/serviceusage/v1beta1/serviceusage-api.json
@@ -959,7 +959,7 @@
}
}
},
- "revision": "20220615",
+ "revision": "20220816",
"rootUrl": "https://serviceusage.googleapis.com/",
"schemas": {
"AdminQuotaPolicy": {
@@ -2843,6 +2843,10 @@
"description": "OAuth scopes are a way to define data and permissions on data. For example, there are scopes defined for \"Read-only access to Google Calendar\" and \"Access to Cloud Platform\". Users can consent to a scope for an application, giving it permission to access that data on their behalf. OAuth scope specifications should be fairly coarse grained; a user will need to see and understand the text description of what your scope means. In most cases: use one or at most two OAuth scopes for an entire family of products. If your product has multiple APIs, you should probably be sharing the OAuth scope across all of those APIs. When you need finer grained OAuth consent screens: talk with your product management about how developers will use them in practice. Please note that even though each of the canonical scopes is enough for a request to be accepted and passed to the backend, a request can still fail due to the backend requiring additional scopes or permissions.",
"id": "OAuthRequirements",
"properties": {
+ "allowAnyScope": {
+ "description": "UNIMPLEMENTED: If enabled, ESF will allow OAuth credentials with any scope, more details in http://go/esf-oauth-any-scope. WARNING: Enabling this option will bring security risks. Customers enabling this feature accidentally may have the risk of losing authentication enforcement. Please reach out to api-auth@ and esf-team@ for approval and allowlisting before you enable this option. ",
+ "type": "boolean"
+ },
"canonicalScopes": {
"description": "The list of publicly documented OAuth scopes that are allowed access. An OAuth token containing any of these scopes will be accepted. Example: canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/calendar.read",
"type": "string"
diff --git a/serviceusage/v1beta1/serviceusage-gen.go b/serviceusage/v1beta1/serviceusage-gen.go
index 167237a9cdb..148c33d7139 100644
--- a/serviceusage/v1beta1/serviceusage-gen.go
+++ b/serviceusage/v1beta1/serviceusage-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-usage/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/serviceusage/v1beta1"
-// ...
-// ctx := context.Background()
-// serviceusageService, err := serviceusage.NewService(ctx)
+// import "google.golang.org/api/serviceusage/v1beta1"
+// ...
+// ctx := context.Background()
+// serviceusageService, err := serviceusage.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// serviceusageService, err := serviceusage.NewService(ctx, option.WithScopes(serviceusage.ServiceManagementScope))
+// serviceusageService, err := serviceusage.NewService(ctx, option.WithScopes(serviceusage.ServiceManagementScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// serviceusageService, err := serviceusage.NewService(ctx, option.WithAPIKey("AIza..."))
+// serviceusageService, err := serviceusage.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// serviceusageService, err := serviceusage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// serviceusageService, err := serviceusage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package serviceusage // import "google.golang.org/api/serviceusage/v1beta1"
@@ -3705,6 +3705,15 @@ func (s *MonitoringDestination) MarshalJSON() ([]byte, error) {
// accepted and passed to the backend, a request can still fail due to
// the backend requiring additional scopes or permissions.
type OAuthRequirements struct {
+ // AllowAnyScope: UNIMPLEMENTED: If enabled, ESF will allow OAuth
+ // credentials with any scope, more details in
+ // http://go/esf-oauth-any-scope. WARNING: Enabling this option will
+ // bring security risks. Customers enabling this feature accidentally
+ // may have the risk of losing authentication enforcement. Please reach
+ // out to api-auth@ and esf-team@ for approval and allowlisting before
+ // you enable this option.
+ AllowAnyScope bool `json:"allowAnyScope,omitempty"`
+
// CanonicalScopes: The list of publicly documented OAuth scopes that
// are allowed access. An OAuth token containing any of these scopes
// will be accepted. Example: canonical_scopes:
@@ -3712,7 +3721,7 @@ type OAuthRequirements struct {
// https://www.googleapis.com/auth/calendar.read
CanonicalScopes string `json:"canonicalScopes,omitempty"`
- // ForceSendFields is a list of field names (e.g. "CanonicalScopes") to
+ // ForceSendFields is a list of field names (e.g. "AllowAnyScope") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -3720,13 +3729,12 @@ type OAuthRequirements struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "CanonicalScopes") to
- // include in API requests with the JSON null value. By default, fields
- // with empty values are omitted from API requests. However, any field
- // with an empty value appearing in NullFields will be sent to the
- // server as null. It is an 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. "AllowAnyScope") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}
@@ -5132,9 +5140,9 @@ type ServicesBatchEnableCall struct {
// and no state changes occur. Operation response type:
// `google.protobuf.Empty`
//
-// - parent: Parent to enable services on. An example name would be:
-// `projects/123` where `123` is the project number (not project ID).
-// The `BatchEnableServices` method currently only supports projects.
+// - parent: Parent to enable services on. An example name would be:
+// `projects/123` where `123` is the project number (not project ID).
+// The `BatchEnableServices` method currently only supports projects.
func (r *ServicesService) BatchEnable(parent string, batchenableservicesrequest *BatchEnableServicesRequest) *ServicesBatchEnableCall {
c := &ServicesBatchEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5283,11 +5291,11 @@ type ServicesDisableCall struct {
// not currently enabled. Operation response type:
// `google.protobuf.Empty`
//
-// - name: Name of the consumer and service to disable the service on.
-// The enable and disable methods currently only support projects. An
-// example name would be:
-// `projects/123/services/serviceusage.googleapis.com` where `123` is
-// the project number (not project ID).
+// - name: Name of the consumer and service to disable the service on.
+// The enable and disable methods currently only support projects. An
+// example name would be:
+// `projects/123/services/serviceusage.googleapis.com` where `123` is
+// the project number (not project ID).
func (r *ServicesService) Disable(name string, disableservicerequest *DisableServiceRequest) *ServicesDisableCall {
c := &ServicesDisableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5431,12 +5439,12 @@ type ServicesEnableCall struct {
// Enable: Enables a service so that it can be used with a project.
// Operation response type: `google.protobuf.Empty`
//
-// - name: Name of the consumer and service to enable the service on.
-// The `EnableService` and `DisableService` methods currently only
-// support projects. Enabling a service requires that the service is
-// public or is shared with the user enabling the service. An example
-// name would be: `projects/123/services/serviceusage.googleapis.com`
-// where `123` is the project number (not project ID).
+// - name: Name of the consumer and service to enable the service on.
+// The `EnableService` and `DisableService` methods currently only
+// support projects. Enabling a service requires that the service is
+// public or is shared with the user enabling the service. An example
+// name would be: `projects/123/services/serviceusage.googleapis.com`
+// where `123` is the project number (not project ID).
func (r *ServicesService) Enable(name string, enableservicerequest *EnableServiceRequest) *ServicesEnableCall {
c := &ServicesEnableCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5578,11 +5586,11 @@ type ServicesGenerateServiceIdentityCall struct {
// GenerateServiceIdentity: Generates service identity for service.
//
-// - parent: Name of the consumer and service to generate an identity
-// for. The `GenerateServiceIdentity` methods currently only support
-// projects. An example name would be:
-// `projects/123/services/example.googleapis.com` where `123` is the
-// project number.
+// - parent: Name of the consumer and service to generate an identity
+// for. The `GenerateServiceIdentity` methods currently only support
+// projects. An example name would be:
+// `projects/123/services/example.googleapis.com` where `123` is the
+// project number.
func (r *ServicesService) GenerateServiceIdentity(parent string) *ServicesGenerateServiceIdentityCall {
c := &ServicesGenerateServiceIdentityCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5717,10 +5725,10 @@ type ServicesGetCall struct {
// Get: Returns the service configuration and enabled state for a given
// service.
//
-// - name: Name of the consumer and service to get the `ConsumerState`
-// for. An example name would be:
-// `projects/123/services/serviceusage.googleapis.com` where `123` is
-// the project number (not project ID).
+// - name: Name of the consumer and service to get the `ConsumerState`
+// for. An example name would be:
+// `projects/123/services/serviceusage.googleapis.com` where `123` is
+// the project number (not project ID).
func (r *ServicesService) Get(name string) *ServicesGetCall {
c := &ServicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5873,8 +5881,8 @@ type ServicesListCall struct {
// be filtered to only include services in a specific state, for example
// to only include services enabled on the project.
//
-// - parent: Parent to search for services on. An example name would be:
-// `projects/123` where `123` is the project number (not project ID).
+// - parent: Parent to search for services on. An example name would be:
+// `projects/123` where `123` is the project number (not project ID).
func (r *ServicesService) List(parent string) *ServicesListCall {
c := &ServicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6083,10 +6091,10 @@ type ServicesConsumerQuotaMetricsGetCall struct {
// Get: Retrieves a summary of quota information for a specific quota
// metric
//
-// - name: The resource name of the quota limit. An example name would
-// be:
-// `projects/123/services/serviceusage.googleapis.com/quotas/metrics/se
-// rviceusage.googleapis.com%2Fmutate_requests`.
+// - name: The resource name of the quota limit. An example name would
+// be:
+// `projects/123/services/serviceusage.googleapis.com/quotas/metrics/se
+// rviceusage.googleapis.com%2Fmutate_requests`.
func (r *ServicesConsumerQuotaMetricsService) Get(name string) *ServicesConsumerQuotaMetricsGetCall {
c := &ServicesConsumerQuotaMetricsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6097,10 +6105,14 @@ func (r *ServicesConsumerQuotaMetricsService) Get(name string) *ServicesConsumer
// detail for quota information in the response.
//
// Possible values:
-// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
+// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
// do not specify a quota view will typically default to the BASIC view.
-// "BASIC" - Only buckets with overrides are shown in the response.
-// "FULL" - Include per-location buckets even if they do not have
+//
+// "BASIC" - Only buckets with overrides are shown in the response.
+// "FULL" - Include per-location buckets even if they do not have
+//
// overrides. When the view is FULL, and a limit has regional or zonal
// quota, the limit will include buckets for all regions or zones that
// could support overrides, even if none are currently present. In some
@@ -6269,8 +6281,8 @@ type ServicesConsumerQuotaMetricsImportAdminOverridesCall struct {
// or limits. The name field in the quota override message should not be
// set.
//
-// - parent: The resource name of the consumer. An example name would
-// be: `projects/123/services/compute.googleapis.com`.
+// - parent: The resource name of the consumer. An example name would
+// be: `projects/123/services/compute.googleapis.com`.
func (r *ServicesConsumerQuotaMetricsService) ImportAdminOverrides(parent string, importadminoverridesrequest *ImportAdminOverridesRequest) *ServicesConsumerQuotaMetricsImportAdminOverridesCall {
c := &ServicesConsumerQuotaMetricsImportAdminOverridesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6416,8 +6428,8 @@ type ServicesConsumerQuotaMetricsImportConsumerOverridesCall struct {
// metrics or limits. The name field in the quota override message
// should not be set.
//
-// - parent: The resource name of the consumer. An example name would
-// be: `projects/123/services/compute.googleapis.com`.
+// - parent: The resource name of the consumer. An example name would
+// be: `projects/123/services/compute.googleapis.com`.
func (r *ServicesConsumerQuotaMetricsService) ImportConsumerOverrides(parent string, importconsumeroverridesrequest *ImportConsumerOverridesRequest) *ServicesConsumerQuotaMetricsImportConsumerOverridesCall {
c := &ServicesConsumerQuotaMetricsImportConsumerOverridesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6565,11 +6577,11 @@ type ServicesConsumerQuotaMetricsListCall struct {
// current effective limit value, and all of the overrides applied to
// the limit.
//
-// - parent: Parent of the quotas resource. Some example names would be:
-// `projects/123/services/serviceconsumermanagement.googleapis.com`
-// `folders/345/services/serviceconsumermanagement.googleapis.com`
-// `organizations/456/services/serviceconsumermanagement.googleapis.com
-// `.
+// - parent: Parent of the quotas resource. Some example names would be:
+// `projects/123/services/serviceconsumermanagement.googleapis.com`
+// `folders/345/services/serviceconsumermanagement.googleapis.com`
+// `organizations/456/services/serviceconsumermanagement.googleapis.com
+// `.
func (r *ServicesConsumerQuotaMetricsService) List(parent string) *ServicesConsumerQuotaMetricsListCall {
c := &ServicesConsumerQuotaMetricsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6594,10 +6606,14 @@ func (c *ServicesConsumerQuotaMetricsListCall) PageToken(pageToken string) *Serv
// detail for quota information in the response.
//
// Possible values:
-// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
+// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
// do not specify a quota view will typically default to the BASIC view.
-// "BASIC" - Only buckets with overrides are shown in the response.
-// "FULL" - Include per-location buckets even if they do not have
+//
+// "BASIC" - Only buckets with overrides are shown in the response.
+// "FULL" - Include per-location buckets even if they do not have
+//
// overrides. When the view is FULL, and a limit has regional or zonal
// quota, the limit will include buckets for all regions or zones that
// could support overrides, even if none are currently present. In some
@@ -6796,9 +6812,9 @@ type ServicesConsumerQuotaMetricsLimitsGetCall struct {
// Get: Retrieves a summary of quota information for a specific quota
// limit.
//
-// - name: The resource name of the quota limit. Use the quota limit
-// resource name returned by previous ListConsumerQuotaMetrics and
-// GetConsumerQuotaMetric API calls.
+// - name: The resource name of the quota limit. Use the quota limit
+// resource name returned by previous ListConsumerQuotaMetrics and
+// GetConsumerQuotaMetric API calls.
func (r *ServicesConsumerQuotaMetricsLimitsService) Get(name string) *ServicesConsumerQuotaMetricsLimitsGetCall {
c := &ServicesConsumerQuotaMetricsLimitsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6809,10 +6825,14 @@ func (r *ServicesConsumerQuotaMetricsLimitsService) Get(name string) *ServicesCo
// detail for quota information in the response.
//
// Possible values:
-// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
+// "QUOTA_VIEW_UNSPECIFIED" - No quota view specified. Requests that
+//
// do not specify a quota view will typically default to the BASIC view.
-// "BASIC" - Only buckets with overrides are shown in the response.
-// "FULL" - Include per-location buckets even if they do not have
+//
+// "BASIC" - Only buckets with overrides are shown in the response.
+// "FULL" - Include per-location buckets even if they do not have
+//
// overrides. When the view is FULL, and a limit has regional or zonal
// quota, the limit will include buckets for all regions or zones that
// could support overrides, even if none are currently present. In some
@@ -6982,11 +7002,11 @@ type ServicesConsumerQuotaMetricsLimitsAdminOverridesCreateCall struct {
// limit the amount of quota the consumer can use out of the total quota
// pool allocated to all children of the folder or organization.
//
-// - parent: The resource name of the parent quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - parent: The resource name of the parent quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsAdminOverridesService) Create(parent string, quotaoverride *QuotaOverride) *ServicesConsumerQuotaMetricsLimitsAdminOverridesCreateCall {
c := &ServicesConsumerQuotaMetricsLimitsAdminOverridesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7010,11 +7030,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsAdminOverridesCreateCall) Force(force
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsAdminOverridesCreateCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsAdminOverridesCreateCall {
@@ -7177,11 +7201,11 @@ type ServicesConsumerQuotaMetricsLimitsAdminOverridesDeleteCall struct {
// Delete: Deletes an admin override.
//
-// - name: The resource name of the override to delete. An example name
-// would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/adminOverrid
-// es/4a3f2c1d`.
+// - name: The resource name of the override to delete. An example name
+// would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/adminOverrid
+// es/4a3f2c1d`.
func (r *ServicesConsumerQuotaMetricsLimitsAdminOverridesService) Delete(name string) *ServicesConsumerQuotaMetricsLimitsAdminOverridesDeleteCall {
c := &ServicesConsumerQuotaMetricsLimitsAdminOverridesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7204,11 +7228,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsAdminOverridesDeleteCall) Force(force
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsAdminOverridesDeleteCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsAdminOverridesDeleteCall {
@@ -7364,11 +7392,11 @@ type ServicesConsumerQuotaMetricsLimitsAdminOverridesListCall struct {
// List: Lists all admin overrides on this limit.
//
-// - parent: The resource name of the parent quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - parent: The resource name of the parent quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsAdminOverridesService) List(parent string) *ServicesConsumerQuotaMetricsLimitsAdminOverridesListCall {
c := &ServicesConsumerQuotaMetricsLimitsAdminOverridesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7561,11 +7589,11 @@ type ServicesConsumerQuotaMetricsLimitsAdminOverridesPatchCall struct {
// Patch: Updates an admin override.
//
-// - name: The resource name of the override to update. An example name
-// would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/adminOverrid
-// es/4a3f2c1d`.
+// - name: The resource name of the override to update. An example name
+// would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/adminOverrid
+// es/4a3f2c1d`.
func (r *ServicesConsumerQuotaMetricsLimitsAdminOverridesService) Patch(name string, quotaoverride *QuotaOverride) *ServicesConsumerQuotaMetricsLimitsAdminOverridesPatchCall {
c := &ServicesConsumerQuotaMetricsLimitsAdminOverridesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7589,11 +7617,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsAdminOverridesPatchCall) Force(force
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsAdminOverridesPatchCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsAdminOverridesPatchCall {
@@ -7775,11 +7807,11 @@ type ServicesConsumerQuotaMetricsLimitsConsumerOverridesCreateCall struct {
// allowed by admin overrides, producer overrides, or the default limit
// of the service.
//
-// - parent: The resource name of the parent quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - parent: The resource name of the parent quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsConsumerOverridesService) Create(parent string, quotaoverride *QuotaOverride) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesCreateCall {
c := &ServicesConsumerQuotaMetricsLimitsConsumerOverridesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7803,11 +7835,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsConsumerOverridesCreateCall) Force(fo
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsConsumerOverridesCreateCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesCreateCall {
@@ -7970,11 +8006,11 @@ type ServicesConsumerQuotaMetricsLimitsConsumerOverridesDeleteCall struct {
// Delete: Deletes a consumer override.
//
-// - name: The resource name of the override to delete. An example name
-// would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/consumerOver
-// rides/4a3f2c1d`.
+// - name: The resource name of the override to delete. An example name
+// would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/consumerOver
+// rides/4a3f2c1d`.
func (r *ServicesConsumerQuotaMetricsLimitsConsumerOverridesService) Delete(name string) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesDeleteCall {
c := &ServicesConsumerQuotaMetricsLimitsConsumerOverridesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7997,11 +8033,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsConsumerOverridesDeleteCall) Force(fo
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsConsumerOverridesDeleteCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesDeleteCall {
@@ -8157,11 +8197,11 @@ type ServicesConsumerQuotaMetricsLimitsConsumerOverridesListCall struct {
// List: Lists all consumer overrides on this limit.
//
-// - parent: The resource name of the parent quota limit, returned by a
-// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
-// name would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
+// - parent: The resource name of the parent quota limit, returned by a
+// ListConsumerQuotaMetrics or GetConsumerQuotaMetric call. An example
+// name would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion`.
func (r *ServicesConsumerQuotaMetricsLimitsConsumerOverridesService) List(parent string) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesListCall {
c := &ServicesConsumerQuotaMetricsLimitsConsumerOverridesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8354,11 +8394,11 @@ type ServicesConsumerQuotaMetricsLimitsConsumerOverridesPatchCall struct {
// Patch: Updates a consumer override.
//
-// - name: The resource name of the override to update. An example name
-// would be:
-// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
-// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/consumerOver
-// rides/4a3f2c1d`.
+// - name: The resource name of the override to update. An example name
+// would be:
+// `projects/123/services/compute.googleapis.com/consumerQuotaMetrics/c
+// ompute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/consumerOver
+// rides/4a3f2c1d`.
func (r *ServicesConsumerQuotaMetricsLimitsConsumerOverridesService) Patch(name string, quotaoverride *QuotaOverride) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesPatchCall {
c := &ServicesConsumerQuotaMetricsLimitsConsumerOverridesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8382,11 +8422,15 @@ func (c *ServicesConsumerQuotaMetricsLimitsConsumerOverridesPatchCall) Force(for
// enforced. The 'force' and 'force_only' fields cannot both be set.
//
// Possible values:
-// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
-// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
+// "QUOTA_SAFETY_CHECK_UNSPECIFIED" - Unspecified quota safety check.
+// "LIMIT_DECREASE_BELOW_USAGE" - Validates that a quota mutation
+//
// would not cause the consumer's effective limit to be lower than the
// consumer's quota usage.
-// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
+// "LIMIT_DECREASE_PERCENTAGE_TOO_HIGH" - Validates that a quota
+//
// mutation would not cause the consumer's effective limit to decrease
// by more than 10 percent.
func (c *ServicesConsumerQuotaMetricsLimitsConsumerOverridesPatchCall) ForceOnly(forceOnly ...string) *ServicesConsumerQuotaMetricsLimitsConsumerOverridesPatchCall {
diff --git a/serviceuser/v1/serviceuser-gen.go b/serviceuser/v1/serviceuser-gen.go
index 778a4977a99..b4012673fa1 100644
--- a/serviceuser/v1/serviceuser-gen.go
+++ b/serviceuser/v1/serviceuser-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/service-management/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/serviceuser/v1"
-// ...
-// ctx := context.Background()
-// serviceuserService, err := serviceuser.NewService(ctx)
+// import "google.golang.org/api/serviceuser/v1"
+// ...
+// ctx := context.Background()
+// serviceuserService, err := serviceuser.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// serviceuserService, err := serviceuser.NewService(ctx, option.WithScopes(serviceuser.ServiceManagementScope))
+// serviceuserService, err := serviceuser.NewService(ctx, option.WithScopes(serviceuser.ServiceManagementScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// serviceuserService, err := serviceuser.NewService(ctx, option.WithAPIKey("AIza..."))
+// serviceuserService, err := serviceuser.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// serviceuserService, err := serviceuser.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// serviceuserService, err := serviceuser.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package serviceuser // import "google.golang.org/api/serviceuser/v1"
@@ -430,16 +430,16 @@ func (s *AuthRequirement) MarshalJSON() ([]byte, error) {
//
// Example for an API targeted for external use:
//
-// name: calendar.googleapis.com
-// authentication:
-// providers:
-// - id: google_calendar_auth
-// jwks_uri: https://www.googleapis.com/oauth2/v1/certs
-// issuer: https://securetoken.google.com
-// rules:
-// - selector: "*"
-// requirements:
-// provider_id: google_calendar_auth
+// name: calendar.googleapis.com
+// authentication:
+// providers:
+// - id: google_calendar_auth
+// jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+// issuer: https://securetoken.google.com
+// rules:
+// - selector: "*"
+// requirements:
+// provider_id: google_calendar_auth
type Authentication struct {
// Providers: Defines a set of authentication providers that a service
// supports.
@@ -537,9 +537,9 @@ func (s *AuthenticationRule) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// experimental:
-// authorization:
-// provider: firebaserules.googleapis.com
+// experimental:
+// authorization:
+// provider: firebaserules.googleapis.com
type AuthorizationConfig struct {
// Provider: The name of the authorization provider, such
// as
@@ -668,23 +668,24 @@ func (s *BackendRule) UnmarshalJSON(data []byte) error {
// metrics
// for billing:
//
-// monitored_resources:
-// - type: library.googleapis.com/branch
-// labels:
-// - key: /city
-// description: The city where the library branch is located
+// monitored_resources:
+// - type: library.googleapis.com/branch
+// labels:
+// - key: /city
+// description: The city where the library branch is located
+//
// in.
-// - key: /name
-// description: The name of the branch.
+// - key: /name
+// description: The name of the branch.
// metrics:
-// - name: library.googleapis.com/book/borrowed_count
-// metric_kind: DELTA
-// value_type: INT64
+// - name: library.googleapis.com/book/borrowed_count
+// metric_kind: DELTA
+// value_type: INT64
// billing:
-// consumer_destinations:
-// - monitored_resource: library.googleapis.com/branch
-// metrics:
-// - library.googleapis.com/book/borrowed_count
+// consumer_destinations:
+// - monitored_resource: library.googleapis.com/branch
+// metrics:
+// - library.googleapis.com/book/borrowed_count
type Billing struct {
// ConsumerDestinations: Billing configurations for sending metrics to
// the consumer project.
@@ -762,12 +763,12 @@ func (s *BillingDestination) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// context:
-// rules:
-// - selector: "*"
-// requested:
-// - google.rpc.context.ProjectContext
-// - google.rpc.context.OriginContext
+// context:
+// rules:
+// - selector: "*"
+// requested:
+// - google.rpc.context.ProjectContext
+// - google.rpc.context.OriginContext
//
// The above specifies that all methods in the API
// request
@@ -792,14 +793,16 @@ func (s *BillingDestination) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// context:
-// rules:
-// - selector:
+// context:
+// rules:
+// - selector:
+//
// "google.example.library.v1.LibraryService.CreateBook"
-// allowed_request_extensions:
-// - google.foo.v1.NewExtension
-// allowed_response_extensions:
-// - google.foo.v1.NewExtension
+//
+// allowed_request_extensions:
+// - google.foo.v1.NewExtension
+// allowed_response_extensions:
+// - google.foo.v1.NewExtension
//
// You can also specify extension ID instead of fully qualified
// extension name
@@ -927,10 +930,10 @@ func (s *Control) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// custom_error:
-// types:
-// - google.foo.v1.CustomError
-// - google.foo.v1.AnotherError
+// custom_error:
+// types:
+// - google.foo.v1.CustomError
+// - google.foo.v1.AnotherError
type CustomError struct {
// Rules: The list of custom error rules that apply to individual API
// messages.
@@ -1043,24 +1046,26 @@ type DisableServiceRequest struct {
//
// Example:
// documentation:
-// summary: >
-// The Google Calendar API gives access
-// to most calendar features.
-// pages:
-// - name: Overview
-// content: (== include google/foo/overview.md ==)
-// - name: Tutorial
-// content: (== include google/foo/tutorial.md ==)
-// subpages;
-// - name: Java
-// content: (== include google/foo/tutorial_java.md ==)
-// rules:
-// - selector: google.calendar.Calendar.Get
-// description: >
-// ...
-// - selector: google.calendar.Calendar.Put
-// description: >
-// ...
+//
+// summary: >
+// The Google Calendar API gives access
+// to most calendar features.
+// pages:
+// - name: Overview
+// content: (== include google/foo/overview.md ==)
+// - name: Tutorial
+// content: (== include google/foo/tutorial.md ==)
+// subpages;
+// - name: Java
+// content: (== include google/foo/tutorial_java.md ==)
+// rules:
+// - selector: google.calendar.Calendar.Get
+// description: >
+// ...
+// - selector: google.calendar.Calendar.Put
+// description: >
+// ...
+//
//
// Documentation is provided in markdown syntax. In addition to
// standard markdown features, definition lists, tables and fenced
@@ -1227,17 +1232,21 @@ type EnableServiceRequest struct {
//
// Example service configuration:
//
-// name: library-example.googleapis.com
-// endpoints:
-// # Below entry makes 'google.example.library.v1.Library'
-// # API be served from endpoint address
+// name: library-example.googleapis.com
+// endpoints:
+// # Below entry makes 'google.example.library.v1.Library'
+// # API be served from endpoint address
+//
// library-example.googleapis.com.
-// # It also allows HTTP OPTIONS calls to be passed to the
+//
+// # It also allows HTTP OPTIONS calls to be passed to the
+//
// backend, for
-// # it to decide whether the subsequent cross-origin request is
-// # allowed to proceed.
-// - name: library-example.googleapis.com
-// allow_cors: true
+//
+// # it to decide whether the subsequent cross-origin request is
+// # allowed to proceed.
+// - name: library-example.googleapis.com
+// allow_cors: true
type Endpoint struct {
// Aliases: DEPRECATED: This field is no longer supported. Instead of
// using aliases,
@@ -1583,19 +1592,19 @@ func (s *Http) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// service Messaging {
-// rpc GetMessage(GetMessageRequest) returns (Message) {
-// option (google.api.http) = {
-// get: "/v1/{name=messages/*}"
-// };
-// }
-// }
-// message GetMessageRequest {
-// string name = 1; // Mapped to URL path.
-// }
-// message Message {
-// string text = 1; // The resource content.
-// }
+// service Messaging {
+// rpc GetMessage(GetMessageRequest) returns (Message) {
+// option (google.api.http) = {
+// get: "/v1/{name=messages/*}"
+// };
+// }
+// }
+// message GetMessageRequest {
+// string name = 1; // Mapped to URL path.
+// }
+// message Message {
+// string text = 1; // The resource content.
+// }
//
// This enables an HTTP REST to gRPC mapping as below:
//
@@ -1610,23 +1619,27 @@ func (s *Http) MarshalJSON() ([]byte, error) {
// request body.
// For example:
//
-// service Messaging {
-// rpc GetMessage(GetMessageRequest) returns (Message) {
-// option (google.api.http) = {
-// get:"/v1/messages/{message_id}"
-// };
-// }
-// }
-// message GetMessageRequest {
-// message SubMessage {
-// string subfield = 1;
-// }
-// string message_id = 1; // Mapped to URL path.
-// int64 revision = 2; // Mapped to URL query parameter
+// service Messaging {
+// rpc GetMessage(GetMessageRequest) returns (Message) {
+// option (google.api.http) = {
+// get:"/v1/messages/{message_id}"
+// };
+// }
+// }
+// message GetMessageRequest {
+// message SubMessage {
+// string subfield = 1;
+// }
+// string message_id = 1; // Mapped to URL path.
+// int64 revision = 2; // Mapped to URL query parameter
+//
// `revision`.
-// SubMessage sub = 3; // Mapped to URL query parameter
+//
+// SubMessage sub = 3; // Mapped to URL query parameter
+//
// `sub.subfield`.
-// }
+//
+// }
//
// This enables a HTTP JSON to RPC mapping as below:
//
@@ -1653,18 +1666,18 @@ func (s *Http) MarshalJSON() ([]byte, error) {
// specifies the mapping. Consider a REST update method on the
// message resource collection:
//
-// service Messaging {
-// rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
-// option (google.api.http) = {
-// patch: "/v1/messages/{message_id}"
-// body: "message"
-// };
-// }
-// }
-// message UpdateMessageRequest {
-// string message_id = 1; // mapped to the URL
-// Message message = 2; // mapped to the body
-// }
+// service Messaging {
+// rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+// option (google.api.http) = {
+// patch: "/v1/messages/{message_id}"
+// body: "message"
+// };
+// }
+// }
+// message UpdateMessageRequest {
+// string message_id = 1; // mapped to the URL
+// Message message = 2; // mapped to the body
+// }
//
// The following HTTP JSON to RPC mapping is enabled, where
// the
@@ -1685,19 +1698,18 @@ func (s *Http) MarshalJSON() ([]byte, error) {
// of
// the update method:
//
-// service Messaging {
-// rpc UpdateMessage(Message) returns (Message) {
-// option (google.api.http) = {
-// patch: "/v1/messages/{message_id}"
-// body: "*"
-// };
-// }
-// }
-// message Message {
-// string message_id = 1;
-// string text = 2;
-// }
-//
+// service Messaging {
+// rpc UpdateMessage(Message) returns (Message) {
+// option (google.api.http) = {
+// patch: "/v1/messages/{message_id}"
+// body: "*"
+// };
+// }
+// }
+// message Message {
+// string message_id = 1;
+// string text = 2;
+// }
//
// The following HTTP JSON to RPC mapping is enabled:
//
@@ -1719,20 +1731,20 @@ func (s *Http) MarshalJSON() ([]byte, error) {
// using
// the `additional_bindings` option. Example:
//
-// service Messaging {
-// rpc GetMessage(GetMessageRequest) returns (Message) {
-// option (google.api.http) = {
-// get: "/v1/messages/{message_id}"
-// additional_bindings {
-// get: "/v1/users/{user_id}/messages/{message_id}"
-// }
-// };
-// }
-// }
-// message GetMessageRequest {
-// string message_id = 1;
-// string user_id = 2;
-// }
+// service Messaging {
+// rpc GetMessage(GetMessageRequest) returns (Message) {
+// option (google.api.http) = {
+// get: "/v1/messages/{message_id}"
+// additional_bindings {
+// get: "/v1/users/{user_id}/messages/{message_id}"
+// }
+// };
+// }
+// }
+// message GetMessageRequest {
+// string message_id = 1;
+// string user_id = 2;
+// }
//
// This enables the following two alternative HTTP JSON to RPC
// mappings:
@@ -1747,33 +1759,45 @@ func (s *Http) MarshalJSON() ([]byte, error) {
//
// 1. Leaf request fields (recursive expansion nested messages in the
// request
-// message) are classified into three categories:
-// - Fields referred by the path template. They are passed via the
+//
+// message) are classified into three categories:
+// - Fields referred by the path template. They are passed via the
+//
// URL path.
-// - Fields referred by the HttpRule.body. They are passed via the
+// - Fields referred by the HttpRule.body. They are passed via the
+//
// HTTP
-// request body.
-// - All other fields are passed via the URL query parameters, and
+//
+// request body.
+// - All other fields are passed via the URL query parameters, and
+//
// the
-// parameter name is the field path in the request message. A
+//
+// parameter name is the field path in the request message. A
+//
// repeated
-// field can be represented as multiple query parameters under the
+//
+// field can be represented as multiple query parameters under the
+//
// same
-// name.
-// 2. If HttpRule.body is "*", there is no URL query parameter, all
+//
+// name.
+// 2. If HttpRule.body is "*", there is no URL query parameter, all
+//
// fields
-// are passed via URL path and HTTP request body.
-// 3. If HttpRule.body is omitted, there is no HTTP request body, all
-// fields are passed via URL path and URL query parameters.
+//
+// are passed via URL path and HTTP request body.
+// 3. If HttpRule.body is omitted, there is no HTTP request body, all
+// fields are passed via URL path and URL query parameters.
//
// ### Path template syntax
//
-// Template = "/" Segments [ Verb ] ;
-// Segments = Segment { "/" Segment } ;
-// Segment = "*" | "**" | LITERAL | Variable ;
-// Variable = "{" FieldPath [ "=" Segments ] "}" ;
-// FieldPath = IDENT { "." IDENT } ;
-// Verb = ":" LITERAL ;
+// Template = "/" Segments [ Verb ] ;
+// Segments = Segment { "/" Segment } ;
+// Segment = "*" | "**" | LITERAL | Variable ;
+// Variable = "{" FieldPath [ "=" Segments ] "}" ;
+// FieldPath = IDENT { "." IDENT } ;
+// Verb = ":" LITERAL ;
//
// The syntax `*` matches a single URL path segment. The syntax `**`
// matches
@@ -1848,11 +1872,11 @@ func (s *Http) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// http:
-// rules:
-// # Selects a gRPC method and applies HttpRule to it.
-// - selector: example.v1.Messaging.GetMessage
-// get: /v1/messages/{message_id}/{sub.subfield}
+// http:
+// rules:
+// # Selects a gRPC method and applies HttpRule to it.
+// - selector: example.v1.Messaging.GetMessage
+// get: /v1/messages/{message_id}/{sub.subfield}
//
// ## Special notes
//
@@ -2062,13 +2086,15 @@ func (s *ListEnabledServicesResponse) MarshalJSON() ([]byte, error) {
// LogDescriptor: A description of a log type. Example in YAML format:
//
-// - name: library.googleapis.com/activity_history
-// description: The history of borrowing and returning library
+// - name: library.googleapis.com/activity_history
+// description: The history of borrowing and returning library
+//
// items.
-// display_name: Activity
-// labels:
-// - key: /customer_id
-// description: Identifier of a library customer
+//
+// display_name: Activity
+// labels:
+// - key: /customer_id
+// description: Identifier of a library customer
type LogDescriptor struct {
// Description: A human-readable description of this log. This
// information appears in
@@ -2128,29 +2154,30 @@ func (s *LogDescriptor) MarshalJSON() ([]byte, error) {
// the
// `purchase_history` log is only sent to the producer project.
//
-// monitored_resources:
-// - type: library.googleapis.com/branch
-// labels:
-// - key: /city
-// description: The city where the library branch is located
+// monitored_resources:
+// - type: library.googleapis.com/branch
+// labels:
+// - key: /city
+// description: The city where the library branch is located
+//
// in.
-// - key: /name
-// description: The name of the branch.
+// - key: /name
+// description: The name of the branch.
// logs:
-// - name: activity_history
-// labels:
-// - key: /customer_id
-// - name: purchase_history
+// - name: activity_history
+// labels:
+// - key: /customer_id
+// - name: purchase_history
// logging:
-// producer_destinations:
-// - monitored_resource: library.googleapis.com/branch
-// logs:
-// - activity_history
-// - purchase_history
-// consumer_destinations:
-// - monitored_resource: library.googleapis.com/branch
-// logs:
-// - activity_history
+// producer_destinations:
+// - monitored_resource: library.googleapis.com/branch
+// logs:
+// - activity_history
+// - purchase_history
+// consumer_destinations:
+// - monitored_resource: library.googleapis.com/branch
+// logs:
+// - activity_history
type Logging struct {
// ConsumerDestinations: Logging configurations for sending logs to the
// consumer project.
@@ -2602,45 +2629,45 @@ func (s *MetricRule) MarshalJSON() ([]byte, error) {
// but
// documentation and options are inherited as follows:
//
-// - If after comment and whitespace stripping, the documentation
-// string of the redeclared method is empty, it will be inherited
-// from the original method.
+// - If after comment and whitespace stripping, the documentation
+// string of the redeclared method is empty, it will be inherited
+// from the original method.
//
-// - Each annotation belonging to the service config (http,
-// visibility) which is not set in the redeclared method will be
-// inherited.
+// - Each annotation belonging to the service config (http,
+// visibility) which is not set in the redeclared method will be
+// inherited.
//
-// - If an http annotation is inherited, the path pattern will be
-// modified as follows. Any version prefix will be replaced by the
-// version of the including interface plus the root path if
-// specified.
+// - If an http annotation is inherited, the path pattern will be
+// modified as follows. Any version prefix will be replaced by the
+// version of the including interface plus the root path if
+// specified.
//
// Example of a simple mixin:
//
-// package google.acl.v1;
-// service AccessControl {
-// // Get the underlying ACL object.
-// rpc GetAcl(GetAclRequest) returns (Acl) {
-// option (google.api.http).get = "/v1/{resource=**}:getAcl";
-// }
-// }
+// package google.acl.v1;
+// service AccessControl {
+// // Get the underlying ACL object.
+// rpc GetAcl(GetAclRequest) returns (Acl) {
+// option (google.api.http).get = "/v1/{resource=**}:getAcl";
+// }
+// }
//
-// package google.storage.v2;
-// service Storage {
-// // rpc GetAcl(GetAclRequest) returns (Acl);
+// package google.storage.v2;
+// service Storage {
+// // rpc GetAcl(GetAclRequest) returns (Acl);
//
-// // Get a data record.
-// rpc GetData(GetDataRequest) returns (Data) {
-// option (google.api.http).get = "/v2/{resource=**}";
-// }
-// }
+// // Get a data record.
+// rpc GetData(GetDataRequest) returns (Data) {
+// option (google.api.http).get = "/v2/{resource=**}";
+// }
+// }
//
// Example of a mixin configuration:
//
-// apis:
-// - name: google.storage.v2.Storage
-// mixins:
-// - name: google.acl.v1.AccessControl
+// apis:
+// - name: google.storage.v2.Storage
+// mixins:
+// - name: google.acl.v1.AccessControl
//
// The mixin construct implies that all methods in `AccessControl`
// are
@@ -2650,13 +2677,13 @@ func (s *MetricRule) MarshalJSON() ([]byte, error) {
// inherting
// documentation and annotations as follows:
//
-// service Storage {
-// // Get the underlying ACL object.
-// rpc GetAcl(GetAclRequest) returns (Acl) {
-// option (google.api.http).get = "/v2/{resource=**}:getAcl";
-// }
-// ...
-// }
+// service Storage {
+// // Get the underlying ACL object.
+// rpc GetAcl(GetAclRequest) returns (Acl) {
+// option (google.api.http).get = "/v2/{resource=**}:getAcl";
+// }
+// ...
+// }
//
// Note how the version in the path pattern changed from `v1` to
// `v2`.
@@ -2665,22 +2692,24 @@ func (s *MetricRule) MarshalJSON() ([]byte, error) {
// a
// relative path under which inherited HTTP paths are placed. Example:
//
-// apis:
-// - name: google.storage.v2.Storage
-// mixins:
-// - name: google.acl.v1.AccessControl
-// root: acls
+// apis:
+// - name: google.storage.v2.Storage
+// mixins:
+// - name: google.acl.v1.AccessControl
+// root: acls
//
// This implies the following inherited HTTP annotation:
//
-// service Storage {
-// // Get the underlying ACL object.
-// rpc GetAcl(GetAclRequest) returns (Acl) {
-// option (google.api.http).get =
+// service Storage {
+// // Get the underlying ACL object.
+// rpc GetAcl(GetAclRequest) returns (Acl) {
+// option (google.api.http).get =
+//
// "/v2/acls/{resource=**}:getAcl";
-// }
-// ...
-// }
+//
+// }
+// ...
+// }
type Mixin struct {
// Name: The fully qualified name of the interface which is included.
Name string `json:"name,omitempty"`
@@ -2805,35 +2834,36 @@ func (s *MonitoredResourceDescriptor) MarshalJSON() ([]byte, error) {
// the
// consumer project.
//
-// monitored_resources:
-// - type: library.googleapis.com/branch
-// labels:
-// - key: /city
-// description: The city where the library branch is located
+// monitored_resources:
+// - type: library.googleapis.com/branch
+// labels:
+// - key: /city
+// description: The city where the library branch is located
+//
// in.
-// - key: /name
-// description: The name of the branch.
+// - key: /name
+// description: The name of the branch.
// metrics:
-// - name: library.googleapis.com/book/returned_count
-// metric_kind: DELTA
-// value_type: INT64
-// labels:
-// - key: /customer_id
-// - name: library.googleapis.com/book/overdue_count
-// metric_kind: GAUGE
-// value_type: INT64
-// labels:
-// - key: /customer_id
+// - name: library.googleapis.com/book/returned_count
+// metric_kind: DELTA
+// value_type: INT64
+// labels:
+// - key: /customer_id
+// - name: library.googleapis.com/book/overdue_count
+// metric_kind: GAUGE
+// value_type: INT64
+// labels:
+// - key: /customer_id
// monitoring:
-// producer_destinations:
-// - monitored_resource: library.googleapis.com/branch
-// metrics:
-// - library.googleapis.com/book/returned_count
-// consumer_destinations:
-// - monitored_resource: library.googleapis.com/branch
-// metrics:
-// - library.googleapis.com/book/returned_count
-// - library.googleapis.com/book/overdue_count
+// producer_destinations:
+// - monitored_resource: library.googleapis.com/branch
+// metrics:
+// - library.googleapis.com/book/returned_count
+// consumer_destinations:
+// - monitored_resource: library.googleapis.com/branch
+// metrics:
+// - library.googleapis.com/book/returned_count
+// - library.googleapis.com/book/overdue_count
type Monitoring struct {
// ConsumerDestinations: Monitoring configurations for sending metrics
// to the consumer project.
@@ -3242,54 +3272,60 @@ func (s *PublishedService) MarshalJSON() ([]byte, error) {
// usage.
//
// The quota configuration works this way:
-// - The service configuration defines a set of metrics.
-// - For API calls, the quota.metric_rules maps methods to metrics with
-// corresponding costs.
-// - The quota.limits defines limits on the metrics, which will be used
+// - The service configuration defines a set of metrics.
+// - For API calls, the quota.metric_rules maps methods to metrics with
+// corresponding costs.
+// - The quota.limits defines limits on the metrics, which will be used
+//
// for
-// quota checks at runtime.
+//
+// quota checks at runtime.
//
// An example quota configuration in yaml format:
//
-// quota:
-// limits:
+// quota:
+// limits:
//
-// - name: apiWriteQpsPerProject
-// metric: library.googleapis.com/write_calls
-// unit: "1/min/{project}" # rate limit for consumer projects
-// values:
-// STANDARD: 10000
+// - name: apiWriteQpsPerProject
+// metric: library.googleapis.com/write_calls
+// unit: "1/min/{project}" # rate limit for consumer projects
+// values:
+// STANDARD: 10000
//
//
-// # The metric rules bind all methods to the read_calls metric,
-// # except for the UpdateBook and DeleteBook methods. These two
+// # The metric rules bind all methods to the read_calls metric,
+// # except for the UpdateBook and DeleteBook methods. These two
+//
// methods
-// # are mapped to the write_calls metric, with the UpdateBook
+//
+// # are mapped to the write_calls metric, with the UpdateBook
+//
// method
-// # consuming at twice rate as the DeleteBook method.
-// metric_rules:
-// - selector: "*"
-// metric_costs:
-// library.googleapis.com/read_calls: 1
-// - selector: google.example.library.v1.LibraryService.UpdateBook
-// metric_costs:
-// library.googleapis.com/write_calls: 2
-// - selector: google.example.library.v1.LibraryService.DeleteBook
-// metric_costs:
-// library.googleapis.com/write_calls: 1
-//
-// Corresponding Metric definition:
-//
-// metrics:
-// - name: library.googleapis.com/read_calls
-// display_name: Read requests
-// metric_kind: DELTA
-// value_type: INT64
-//
-// - name: library.googleapis.com/write_calls
-// display_name: Write requests
-// metric_kind: DELTA
-// value_type: INT64
+//
+// # consuming at twice rate as the DeleteBook method.
+// metric_rules:
+// - selector: "*"
+// metric_costs:
+// library.googleapis.com/read_calls: 1
+// - selector: google.example.library.v1.LibraryService.UpdateBook
+// metric_costs:
+// library.googleapis.com/write_calls: 2
+// - selector: google.example.library.v1.LibraryService.DeleteBook
+// metric_costs:
+// library.googleapis.com/write_calls: 1
+//
+// Corresponding Metric definition:
+//
+// metrics:
+// - name: library.googleapis.com/read_calls
+// display_name: Read requests
+// metric_kind: DELTA
+// value_type: INT64
+//
+// - name: library.googleapis.com/write_calls
+// display_name: Write requests
+// metric_kind: DELTA
+// value_type: INT64
type Quota struct {
// Limits: List of `QuotaLimit` definitions for the service.
Limits []*QuotaLimit `json:"limits,omitempty"`
@@ -3514,21 +3550,21 @@ func (s *SearchServicesResponse) MarshalJSON() ([]byte, error) {
//
// Example:
//
-// type: google.api.Service
-// config_version: 3
-// name: calendar.googleapis.com
-// title: Google Calendar API
-// apis:
-// - name: google.calendar.v3.Calendar
-// authentication:
-// providers:
-// - id: google_calendar_auth
-// jwks_uri: https://www.googleapis.com/oauth2/v1/certs
-// issuer: https://securetoken.google.com
-// rules:
-// - selector: "*"
-// requirements:
-// provider_id: google_calendar_auth
+// type: google.api.Service
+// config_version: 3
+// name: calendar.googleapis.com
+// title: Google Calendar API
+// apis:
+// - name: google.calendar.v3.Calendar
+// authentication:
+// providers:
+// - id: google_calendar_auth
+// jwks_uri: https://www.googleapis.com/oauth2/v1/certs
+// issuer: https://securetoken.google.com
+// rules:
+// - selector: "*"
+// requirements:
+// provider_id: google_calendar_auth
type Service struct {
// Apis: A list of API interfaces exported by this service. Only the
// `name` field
@@ -3806,29 +3842,41 @@ func (s *SourceInfo) MarshalJSON() ([]byte, error) {
//
// - Partial errors. If a service needs to return partial errors to the
// client,
-// it may embed the `Status` in the normal response to indicate the
+//
+// it may embed the `Status` in the normal response to indicate the
+//
// partial
-// errors.
+//
+// errors.
//
// - Workflow errors. A typical workflow has multiple steps. Each step
// may
-// have a `Status` message for error reporting.
+//
+// have a `Status` message for error reporting.
//
// - Batch operations. If a client uses batch request and batch
// response, the
-// `Status` message should be used directly inside batch response,
+//
+// `Status` message should be used directly inside batch response,
+//
// one for
-// each error sub-response.
+//
+// each error sub-response.
//
// - Asynchronous operations. If an API call embeds asynchronous
// operation
-// results in its response, the status of those operations should
+//
+// results in its response, the status of those operations should
+//
// be
-// represented directly using the `Status` message.
+//
+// represented directly using the `Status` message.
//
// - Logging. If some API errors are stored in logs, the message
// `Status` could
-// be used directly after any stripping needed for security/privacy
+//
+// be used directly after any stripping needed for security/privacy
+//
// reasons.
type Status struct {
// Code: The status code, which should be an enum value of
@@ -4174,7 +4222,6 @@ func (s *Usage) MarshalJSON() ([]byte, error) {
//
// NOTE: Under development.
//
-//
// Use this rule to configure unregistered calls for the service.
// Unregistered
// calls are calls that do not contain consumer project
@@ -4189,18 +4236,20 @@ func (s *Usage) MarshalJSON() ([]byte, error) {
// Example of an API that wants to allow unregistered calls for entire
// service.
//
-// usage:
-// rules:
-// - selector: "*"
-// allow_unregistered_calls: true
+// usage:
+// rules:
+// - selector: "*"
+// allow_unregistered_calls: true
//
// Example of a method that wants to allow unregistered calls.
//
-// usage:
-// rules:
-// - selector:
+// usage:
+// rules:
+// - selector:
+//
// "google.example.library.v1.LibraryService.CreateBook"
-// allow_unregistered_calls: true
+//
+// allow_unregistered_calls: true
type UsageRule struct {
// AllowUnregisteredCalls: If true, the selected method allows
// unregistered calls, e.g. calls
diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go
index 85874cd1bc4..d32def42b1f 100644
--- a/sheets/v4/sheets-gen.go
+++ b/sheets/v4/sheets-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/sheets/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sheets/v4"
-// ...
-// ctx := context.Background()
-// sheetsService, err := sheets.NewService(ctx)
+// import "google.golang.org/api/sheets/v4"
+// ...
+// ctx := context.Background()
+// sheetsService, err := sheets.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// sheetsService, err := sheets.NewService(ctx, option.WithScopes(sheets.SpreadsheetsReadonlyScope))
+// sheetsService, err := sheets.NewService(ctx, option.WithScopes(sheets.SpreadsheetsReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// sheetsService, err := sheets.NewService(ctx, option.WithAPIKey("AIza..."))
+// sheetsService, err := sheets.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// sheetsService, err := sheets.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// sheetsService, err := sheets.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sheets // import "google.golang.org/api/sheets/v4"
@@ -3644,12 +3644,12 @@ func (s *ClearValuesResponse) MarshalJSON() ([]byte, error) {
// if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green,
// blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams
// = [red, green, blue].join(','); return ['rgba(', rgbParams, ',',
-// alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green,
+// alphaFrac, ')'].join(”); }; var rgbToCssColor = function(red, green,
// blue) { var rgbNumber = new Number((red << 16) | (green << 8) |
// blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 -
// hexString.length; var resultBuilder = ['#']; for (var i = 0; i <
// missingZeros; i++) { resultBuilder.push('0'); }
-// resultBuilder.push(hexString); return resultBuilder.join(''); }; //
+// resultBuilder.push(hexString); return resultBuilder.join(”); }; //
// ...
type Color struct {
// Alpha: The fraction of this color that should be applied to the
@@ -12551,9 +12551,9 @@ type SpreadsheetsSheetsCopyToCall struct {
// CopyTo: Copies a single sheet from a spreadsheet to another
// spreadsheet. Returns the properties of the newly created sheet.
//
-// - sheetId: The ID of the sheet to copy.
-// - spreadsheetId: The ID of the spreadsheet containing the sheet to
-// copy.
+// - sheetId: The ID of the sheet to copy.
+// - spreadsheetId: The ID of the spreadsheet containing the sheet to
+// copy.
func (r *SpreadsheetsSheetsService) CopyTo(spreadsheetId string, sheetId int64, copysheettoanotherspreadsheetrequest *CopySheetToAnotherSpreadsheetRequest) *SpreadsheetsSheetsCopyToCall {
c := &SpreadsheetsSheetsCopyToCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.spreadsheetId = spreadsheetId
@@ -12717,10 +12717,10 @@ type SpreadsheetsValuesAppendCall struct {
// the sheet (column-wise or row-wise), it does not influence what cell
// the data starts being written to.
//
-// - range: The A1 notation (/sheets/api/guides/concepts#cell) of a
-// range to search for a logical table of data. Values are appended
-// after the last row of the table.
-// - spreadsheetId: The ID of the spreadsheet to update.
+// - range: The A1 notation (/sheets/api/guides/concepts#cell) of a
+// range to search for a logical table of data. Values are appended
+// after the last row of the table.
+// - spreadsheetId: The ID of the spreadsheet to update.
func (r *SpreadsheetsValuesService) Append(spreadsheetId string, range_ string, valuerange *ValueRange) *SpreadsheetsValuesAppendCall {
c := &SpreadsheetsValuesAppendCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.spreadsheetId = spreadsheetId
@@ -12742,10 +12742,13 @@ func (c *SpreadsheetsValuesAppendCall) IncludeValuesInResponse(includeValuesInRe
// the input data should be inserted.
//
// Possible values:
-// "OVERWRITE" - The new data overwrites existing data in the areas it
+//
+// "OVERWRITE" - The new data overwrites existing data in the areas it
+//
// is written. (Note: adding data to the end of the sheet will still
// insert new rows or columns so the data can be written.)
-// "INSERT_ROWS" - Rows are inserted for the new data.
+//
+// "INSERT_ROWS" - Rows are inserted for the new data.
func (c *SpreadsheetsValuesAppendCall) InsertDataOption(insertDataOption string) *SpreadsheetsValuesAppendCall {
c.urlParams_.Set("insertDataOption", insertDataOption)
return c
@@ -12758,7 +12761,9 @@ func (c *SpreadsheetsValuesAppendCall) InsertDataOption(insertDataOption string)
// render option is SERIAL_NUMBER.
//
// Possible values:
-// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
+// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
// fields to be output as doubles in "serial number" format, as
// popularized by Lotus 1-2-3. The whole number portion of the value
// (left of the decimal) counts the days since December 30th 1899. The
@@ -12767,7 +12772,9 @@ func (c *SpreadsheetsValuesAppendCall) InsertDataOption(insertDataOption string)
// 2.5, 2 because it's 2 days after December 30th 1899, and .5 because
// noon is half a day. February 1st 1900 at 3pm would be 33.625. This
// correctly treats the year 1900 as not a leap year.
-// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
+// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
// fields to be output as strings in their given number format (which
// depends on the spreadsheet locale).
func (c *SpreadsheetsValuesAppendCall) ResponseDateTimeRenderOption(responseDateTimeRenderOption string) *SpreadsheetsValuesAppendCall {
@@ -12780,15 +12787,21 @@ func (c *SpreadsheetsValuesAppendCall) ResponseDateTimeRenderOption(responseDate
// should be rendered. The default render option is FORMATTED_VALUE.
//
// Possible values:
-// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
+// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
// reply according to the cell's formatting. Formatting is based on the
// spreadsheet's locale, not the requesting user's locale. For example,
// if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then
// `A2` would return "$1.23".
-// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
+// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
// in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then `A2` would return the number `1.23`.
-// "FORMULA" - Values will not be calculated. The reply will include
+//
+// "FORMULA" - Values will not be calculated. The reply will include
+//
// the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then A2 would return "=A1".
func (c *SpreadsheetsValuesAppendCall) ResponseValueRenderOption(responseValueRenderOption string) *SpreadsheetsValuesAppendCall {
@@ -12800,11 +12813,17 @@ func (c *SpreadsheetsValuesAppendCall) ResponseValueRenderOption(responseValueRe
// the input data should be interpreted.
//
// Possible values:
-// "INPUT_VALUE_OPTION_UNSPECIFIED" - Default input value. This value
+//
+// "INPUT_VALUE_OPTION_UNSPECIFIED" - Default input value. This value
+//
// must not be used.
-// "RAW" - The values the user has entered will not be parsed and will
+//
+// "RAW" - The values the user has entered will not be parsed and will
+//
// be stored as-is.
-// "USER_ENTERED" - The values will be parsed as if the user typed
+//
+// "USER_ENTERED" - The values will be parsed as if the user typed
+//
// them into the UI. Numbers will stay as numbers, but strings may be
// converted to numbers, dates, etc. following the same rules that are
// applied when entering text into a cell via the Google Sheets UI.
@@ -13325,7 +13344,9 @@ func (r *SpreadsheetsValuesService) BatchGet(spreadsheetId string) *Spreadsheets
// FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
//
// Possible values:
-// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
+// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
// fields to be output as doubles in "serial number" format, as
// popularized by Lotus 1-2-3. The whole number portion of the value
// (left of the decimal) counts the days since December 30th 1899. The
@@ -13334,7 +13355,9 @@ func (r *SpreadsheetsValuesService) BatchGet(spreadsheetId string) *Spreadsheets
// 2.5, 2 because it's 2 days after December 30th 1899, and .5 because
// noon is half a day. February 1st 1900 at 3pm would be 33.625. This
// correctly treats the year 1900 as not a leap year.
-// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
+// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
// fields to be output as strings in their given number format (which
// depends on the spreadsheet locale).
func (c *SpreadsheetsValuesBatchGetCall) DateTimeRenderOption(dateTimeRenderOption string) *SpreadsheetsValuesBatchGetCall {
@@ -13350,9 +13373,10 @@ func (c *SpreadsheetsValuesBatchGetCall) DateTimeRenderOption(dateTimeRenderOpti
// `[[1,3],[2,4]]`.
//
// Possible values:
-// "DIMENSION_UNSPECIFIED" - The default value, do not use.
-// "ROWS" - Operates on the rows of a sheet.
-// "COLUMNS" - Operates on the columns of a sheet.
+//
+// "DIMENSION_UNSPECIFIED" - The default value, do not use.
+// "ROWS" - Operates on the rows of a sheet.
+// "COLUMNS" - Operates on the columns of a sheet.
func (c *SpreadsheetsValuesBatchGetCall) MajorDimension(majorDimension string) *SpreadsheetsValuesBatchGetCall {
c.urlParams_.Set("majorDimension", majorDimension)
return c
@@ -13371,15 +13395,21 @@ func (c *SpreadsheetsValuesBatchGetCall) Ranges(ranges ...string) *SpreadsheetsV
// option is ValueRenderOption.FORMATTED_VALUE.
//
// Possible values:
-// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
+// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
// reply according to the cell's formatting. Formatting is based on the
// spreadsheet's locale, not the requesting user's locale. For example,
// if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then
// `A2` would return "$1.23".
-// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
+// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
// in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then `A2` would return the number `1.23`.
-// "FORMULA" - Values will not be calculated. The reply will include
+//
+// "FORMULA" - Values will not be calculated. The reply will include
+//
// the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then A2 would return "=A1".
func (c *SpreadsheetsValuesBatchGetCall) ValueRenderOption(valueRenderOption string) *SpreadsheetsValuesBatchGetCall {
@@ -14020,9 +14050,9 @@ type SpreadsheetsValuesClearCall struct {
// properties of the cell (such as formatting, data validation, etc..)
// are kept.
//
-// - range: The A1 notation or R1C1 notation
-// (/sheets/api/guides/concepts#cell) of the values to clear.
-// - spreadsheetId: The ID of the spreadsheet to update.
+// - range: The A1 notation or R1C1 notation
+// (/sheets/api/guides/concepts#cell) of the values to clear.
+// - spreadsheetId: The ID of the spreadsheet to update.
func (r *SpreadsheetsValuesService) Clear(spreadsheetId string, range_ string, clearvaluesrequest *ClearValuesRequest) *SpreadsheetsValuesClearCall {
c := &SpreadsheetsValuesClearCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.spreadsheetId = spreadsheetId
@@ -14176,10 +14206,10 @@ type SpreadsheetsValuesGetCall struct {
// Get: Returns a range of values from a spreadsheet. The caller must
// specify the spreadsheet ID and a range.
//
-// - range: The A1 notation or R1C1 notation
-// (/sheets/api/guides/concepts#cell) of the range to retrieve values
-// from.
-// - spreadsheetId: The ID of the spreadsheet to retrieve data from.
+// - range: The A1 notation or R1C1 notation
+// (/sheets/api/guides/concepts#cell) of the range to retrieve values
+// from.
+// - spreadsheetId: The ID of the spreadsheet to retrieve data from.
func (r *SpreadsheetsValuesService) Get(spreadsheetId string, range_ string) *SpreadsheetsValuesGetCall {
c := &SpreadsheetsValuesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.spreadsheetId = spreadsheetId
@@ -14193,7 +14223,9 @@ func (r *SpreadsheetsValuesService) Get(spreadsheetId string, range_ string) *Sp
// FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
//
// Possible values:
-// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
+// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
// fields to be output as doubles in "serial number" format, as
// popularized by Lotus 1-2-3. The whole number portion of the value
// (left of the decimal) counts the days since December 30th 1899. The
@@ -14202,7 +14234,9 @@ func (r *SpreadsheetsValuesService) Get(spreadsheetId string, range_ string) *Sp
// 2.5, 2 because it's 2 days after December 30th 1899, and .5 because
// noon is half a day. February 1st 1900 at 3pm would be 33.625. This
// correctly treats the year 1900 as not a leap year.
-// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
+// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
// fields to be output as strings in their given number format (which
// depends on the spreadsheet locale).
func (c *SpreadsheetsValuesGetCall) DateTimeRenderOption(dateTimeRenderOption string) *SpreadsheetsValuesGetCall {
@@ -14218,9 +14252,10 @@ func (c *SpreadsheetsValuesGetCall) DateTimeRenderOption(dateTimeRenderOption st
// `[[1,3],[2,4]]`.
//
// Possible values:
-// "DIMENSION_UNSPECIFIED" - The default value, do not use.
-// "ROWS" - Operates on the rows of a sheet.
-// "COLUMNS" - Operates on the columns of a sheet.
+//
+// "DIMENSION_UNSPECIFIED" - The default value, do not use.
+// "ROWS" - Operates on the rows of a sheet.
+// "COLUMNS" - Operates on the columns of a sheet.
func (c *SpreadsheetsValuesGetCall) MajorDimension(majorDimension string) *SpreadsheetsValuesGetCall {
c.urlParams_.Set("majorDimension", majorDimension)
return c
@@ -14231,15 +14266,21 @@ func (c *SpreadsheetsValuesGetCall) MajorDimension(majorDimension string) *Sprea
// option is FORMATTED_VALUE.
//
// Possible values:
-// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
+// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
// reply according to the cell's formatting. Formatting is based on the
// spreadsheet's locale, not the requesting user's locale. For example,
// if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then
// `A2` would return "$1.23".
-// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
+// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
// in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then `A2` would return the number `1.23`.
-// "FORMULA" - Values will not be calculated. The reply will include
+//
+// "FORMULA" - Values will not be calculated. The reply will include
+//
// the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then A2 would return "=A1".
func (c *SpreadsheetsValuesGetCall) ValueRenderOption(valueRenderOption string) *SpreadsheetsValuesGetCall {
@@ -14442,9 +14483,9 @@ type SpreadsheetsValuesUpdateCall struct {
// Update: Sets values in a range of a spreadsheet. The caller must
// specify the spreadsheet ID, range, and a valueInputOption.
//
-// - range: The A1 notation (/sheets/api/guides/concepts#cell) of the
-// values to update.
-// - spreadsheetId: The ID of the spreadsheet to update.
+// - range: The A1 notation (/sheets/api/guides/concepts#cell) of the
+// values to update.
+// - spreadsheetId: The ID of the spreadsheet to update.
func (r *SpreadsheetsValuesService) Update(spreadsheetId string, range_ string, valuerange *ValueRange) *SpreadsheetsValuesUpdateCall {
c := &SpreadsheetsValuesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.spreadsheetId = spreadsheetId
@@ -14472,7 +14513,9 @@ func (c *SpreadsheetsValuesUpdateCall) IncludeValuesInResponse(includeValuesInRe
// render option is SERIAL_NUMBER.
//
// Possible values:
-// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
+// "SERIAL_NUMBER" - Instructs date, time, datetime, and duration
+//
// fields to be output as doubles in "serial number" format, as
// popularized by Lotus 1-2-3. The whole number portion of the value
// (left of the decimal) counts the days since December 30th 1899. The
@@ -14481,7 +14524,9 @@ func (c *SpreadsheetsValuesUpdateCall) IncludeValuesInResponse(includeValuesInRe
// 2.5, 2 because it's 2 days after December 30th 1899, and .5 because
// noon is half a day. February 1st 1900 at 3pm would be 33.625. This
// correctly treats the year 1900 as not a leap year.
-// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
+// "FORMATTED_STRING" - Instructs date, time, datetime, and duration
+//
// fields to be output as strings in their given number format (which
// depends on the spreadsheet locale).
func (c *SpreadsheetsValuesUpdateCall) ResponseDateTimeRenderOption(responseDateTimeRenderOption string) *SpreadsheetsValuesUpdateCall {
@@ -14494,15 +14539,21 @@ func (c *SpreadsheetsValuesUpdateCall) ResponseDateTimeRenderOption(responseDate
// should be rendered. The default render option is FORMATTED_VALUE.
//
// Possible values:
-// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
+// "FORMATTED_VALUE" - Values will be calculated & formatted in the
+//
// reply according to the cell's formatting. Formatting is based on the
// spreadsheet's locale, not the requesting user's locale. For example,
// if `A1` is `1.23` and `A2` is `=A1` and formatted as currency, then
// `A2` would return "$1.23".
-// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
+// "UNFORMATTED_VALUE" - Values will be calculated, but not formatted
+//
// in the reply. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then `A2` would return the number `1.23`.
-// "FORMULA" - Values will not be calculated. The reply will include
+//
+// "FORMULA" - Values will not be calculated. The reply will include
+//
// the formulas. For example, if `A1` is `1.23` and `A2` is `=A1` and
// formatted as currency, then A2 would return "=A1".
func (c *SpreadsheetsValuesUpdateCall) ResponseValueRenderOption(responseValueRenderOption string) *SpreadsheetsValuesUpdateCall {
@@ -14514,11 +14565,17 @@ func (c *SpreadsheetsValuesUpdateCall) ResponseValueRenderOption(responseValueRe
// the input data should be interpreted.
//
// Possible values:
-// "INPUT_VALUE_OPTION_UNSPECIFIED" - Default input value. This value
+//
+// "INPUT_VALUE_OPTION_UNSPECIFIED" - Default input value. This value
+//
// must not be used.
-// "RAW" - The values the user has entered will not be parsed and will
+//
+// "RAW" - The values the user has entered will not be parsed and will
+//
// be stored as-is.
-// "USER_ENTERED" - The values will be parsed as if the user typed
+//
+// "USER_ENTERED" - The values will be parsed as if the user typed
+//
// them into the UI. Numbers will stay as numbers, but strings may be
// converted to numbers, dates, etc. following the same rules that are
// applied when entering text into a cell via the Google Sheets UI.
diff --git a/siteverification/v1/siteverification-gen.go b/siteverification/v1/siteverification-gen.go
index 7ca82a1e45f..0c0a027d8b8 100644
--- a/siteverification/v1/siteverification-gen.go
+++ b/siteverification/v1/siteverification-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/site-verification/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/siteverification/v1"
-// ...
-// ctx := context.Background()
-// siteverificationService, err := siteverification.NewService(ctx)
+// import "google.golang.org/api/siteverification/v1"
+// ...
+// ctx := context.Background()
+// siteverificationService, err := siteverification.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// siteverificationService, err := siteverification.NewService(ctx, option.WithScopes(siteverification.SiteverificationVerifyOnlyScope))
+// siteverificationService, err := siteverification.NewService(ctx, option.WithScopes(siteverification.SiteverificationVerifyOnlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// siteverificationService, err := siteverification.NewService(ctx, option.WithAPIKey("AIza..."))
+// siteverificationService, err := siteverification.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// siteverificationService, err := siteverification.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// siteverificationService, err := siteverification.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package siteverification // import "google.golang.org/api/siteverification/v1"
@@ -748,8 +748,8 @@ type WebResourceInsertCall struct {
// Insert: Attempt verification of a website or domain.
//
-// - verificationMethod: The method to use for verifying a site or
-// domain.
+// - verificationMethod: The method to use for verifying a site or
+// domain.
func (r *WebResourceService) Insert(verificationMethod string, siteverificationwebresourceresource *SiteVerificationWebResourceResource) *WebResourceInsertCall {
c := &WebResourceInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("verificationMethod", verificationMethod)
diff --git a/slides/v1/slides-gen.go b/slides/v1/slides-gen.go
index 4ebb98f204c..e7cbee96671 100644
--- a/slides/v1/slides-gen.go
+++ b/slides/v1/slides-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/slides/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/slides/v1"
-// ...
-// ctx := context.Background()
-// slidesService, err := slides.NewService(ctx)
+// import "google.golang.org/api/slides/v1"
+// ...
+// ctx := context.Background()
+// slidesService, err := slides.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// slidesService, err := slides.NewService(ctx, option.WithScopes(slides.SpreadsheetsReadonlyScope))
+// slidesService, err := slides.NewService(ctx, option.WithScopes(slides.SpreadsheetsReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// slidesService, err := slides.NewService(ctx, option.WithAPIKey("AIza..."))
+// slidesService, err := slides.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// slidesService, err := slides.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// slidesService, err := slides.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package slides // import "google.golang.org/api/slides/v1"
@@ -7784,9 +7784,9 @@ type PresentationsPagesGetThumbnailCall struct {
// image. This request counts as an expensive read request
// (/slides/limits) for quota purposes.
//
-// - pageObjectId: The object ID of the page whose thumbnail to
-// retrieve.
-// - presentationId: The ID of the presentation to retrieve.
+// - pageObjectId: The object ID of the page whose thumbnail to
+// retrieve.
+// - presentationId: The ID of the presentation to retrieve.
func (r *PresentationsPagesService) GetThumbnail(presentationId string, pageObjectId string) *PresentationsPagesGetThumbnailCall {
c := &PresentationsPagesGetThumbnailCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.presentationId = presentationId
@@ -7800,7 +7800,8 @@ func (r *PresentationsPagesService) GetThumbnail(presentationId string, pageObje
// defaults to PNG.
//
// Possible values:
-// "PNG" - The default mime type.
+//
+// "PNG" - The default mime type.
func (c *PresentationsPagesGetThumbnailCall) ThumbnailPropertiesMimeType(thumbnailPropertiesMimeType string) *PresentationsPagesGetThumbnailCall {
c.urlParams_.Set("thumbnailProperties.mimeType", thumbnailPropertiesMimeType)
return c
@@ -7812,12 +7813,15 @@ func (c *PresentationsPagesGetThumbnailCall) ThumbnailPropertiesMimeType(thumbna
// size of the image.
//
// Possible values:
-// "THUMBNAIL_SIZE_UNSPECIFIED" - The default thumbnail image size.
+//
+// "THUMBNAIL_SIZE_UNSPECIFIED" - The default thumbnail image size.
+//
// The unspecified thumbnail size implies that the server chooses the
// size of the image in a way that might vary in the future.
-// "LARGE" - The thumbnail image width of 1600px.
-// "MEDIUM" - The thumbnail image width of 800px.
-// "SMALL" - The thumbnail image width of 200px.
+//
+// "LARGE" - The thumbnail image width of 1600px.
+// "MEDIUM" - The thumbnail image width of 800px.
+// "SMALL" - The thumbnail image width of 200px.
func (c *PresentationsPagesGetThumbnailCall) ThumbnailPropertiesThumbnailSize(thumbnailPropertiesThumbnailSize string) *PresentationsPagesGetThumbnailCall {
c.urlParams_.Set("thumbnailProperties.thumbnailSize", thumbnailPropertiesThumbnailSize)
return c
diff --git a/smartdevicemanagement/v1/smartdevicemanagement-gen.go b/smartdevicemanagement/v1/smartdevicemanagement-gen.go
index 52d3a1949eb..d7ed8547f36 100644
--- a/smartdevicemanagement/v1/smartdevicemanagement-gen.go
+++ b/smartdevicemanagement/v1/smartdevicemanagement-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/nest/device-access
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/smartdevicemanagement/v1"
-// ...
-// ctx := context.Background()
-// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx)
+// import "google.golang.org/api/smartdevicemanagement/v1"
+// ...
+// ctx := context.Background()
+// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx, option.WithScopes(smartdevicemanagement.SdmThermostatServiceScope))
+// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx, option.WithScopes(smartdevicemanagement.SdmThermostatServiceScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx, option.WithAPIKey("AIza..."))
+// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// smartdevicemanagementService, err := smartdevicemanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package smartdevicemanagement // import "google.golang.org/api/smartdevicemanagement/v1"
@@ -538,8 +538,8 @@ type EnterprisesDevicesExecuteCommandCall struct {
// ExecuteCommand: Executes a command to device managed by the
// enterprise.
//
-// - name: The name of the device requested. For example:
-// "enterprises/XYZ/devices/123".
+// - name: The name of the device requested. For example:
+// "enterprises/XYZ/devices/123".
func (r *EnterprisesDevicesService) ExecuteCommand(name string, googlehomeenterprisesdmv1executedevicecommandrequest *GoogleHomeEnterpriseSdmV1ExecuteDeviceCommandRequest) *EnterprisesDevicesExecuteCommandCall {
c := &EnterprisesDevicesExecuteCommandCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -684,8 +684,8 @@ type EnterprisesDevicesGetCall struct {
// Get: Gets a device managed by the enterprise.
//
-// - name: The name of the device requested. For example:
-// "enterprises/XYZ/devices/123".
+// - name: The name of the device requested. For example:
+// "enterprises/XYZ/devices/123".
func (r *EnterprisesDevicesService) Get(name string) *EnterprisesDevicesGetCall {
c := &EnterprisesDevicesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -832,8 +832,8 @@ type EnterprisesDevicesListCall struct {
// List: Lists devices managed by the enterprise.
//
-// - parent: The parent enterprise to list devices under. E.g.
-// "enterprises/XYZ".
+// - parent: The parent enterprise to list devices under. E.g.
+// "enterprises/XYZ".
func (r *EnterprisesDevicesService) List(parent string) *EnterprisesDevicesListCall {
c := &EnterprisesDevicesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1042,8 +1042,8 @@ type EnterprisesStructuresGetCall struct {
// Get: Gets a structure managed by the enterprise.
//
-// - name: The name of the structure requested. For example:
-// "enterprises/XYZ/structures/ABC".
+// - name: The name of the structure requested. For example:
+// "enterprises/XYZ/structures/ABC".
func (r *EnterprisesStructuresService) Get(name string) *EnterprisesStructuresGetCall {
c := &EnterprisesStructuresGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1191,8 +1191,8 @@ type EnterprisesStructuresListCall struct {
// List: Lists structures managed by the enterprise.
//
-// - parent: The parent enterprise to list structures under. E.g.
-// "enterprises/XYZ".
+// - parent: The parent enterprise to list structures under. E.g.
+// "enterprises/XYZ".
func (r *EnterprisesStructuresService) List(parent string) *EnterprisesStructuresListCall {
c := &EnterprisesStructuresListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1287,7 +1287,9 @@ func (c *EnterprisesStructuresListCall) doRequest(alt string) (*http.Response, e
// error will be non-nil. Any non-2xx status code is an error. Response
// headers are in either
// *GoogleHomeEnterpriseSdmV1ListStructuresResponse.ServerResponse.Header
-// or (if a response was returned at all) in
+//
+// or (if a response was returned at all) in
+//
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
@@ -1400,8 +1402,8 @@ type EnterprisesStructuresRoomsGetCall struct {
// Get: Gets a room managed by the enterprise.
//
-// - name: The name of the room requested. For example:
-// "enterprises/XYZ/structures/ABC/rooms/123".
+// - name: The name of the room requested. For example:
+// "enterprises/XYZ/structures/ABC/rooms/123".
func (r *EnterprisesStructuresRoomsService) Get(name string) *EnterprisesStructuresRoomsGetCall {
c := &EnterprisesStructuresRoomsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1548,8 +1550,8 @@ type EnterprisesStructuresRoomsListCall struct {
// List: Lists rooms managed by the enterprise.
//
-// - parent: The parent resource name of the rooms requested. For
-// example: "enterprises/XYZ/structures/ABC".
+// - parent: The parent resource name of the rooms requested. For
+// example: "enterprises/XYZ/structures/ABC".
func (r *EnterprisesStructuresRoomsService) List(parent string) *EnterprisesStructuresRoomsListCall {
c := &EnterprisesStructuresRoomsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/sourcerepo/v1/sourcerepo-api.json b/sourcerepo/v1/sourcerepo-api.json
index 1e94695e2ef..a0c792417aa 100644
--- a/sourcerepo/v1/sourcerepo-api.json
+++ b/sourcerepo/v1/sourcerepo-api.json
@@ -450,7 +450,7 @@
}
}
},
- "revision": "20220429",
+ "revision": "20220802",
"rootUrl": "https://sourcerepo.googleapis.com/",
"schemas": {
"AuditConfig": {
@@ -510,7 +510,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/sourcerepo/v1/sourcerepo-gen.go b/sourcerepo/v1/sourcerepo-gen.go
index 5166fab6d95..b03d78cc991 100644
--- a/sourcerepo/v1/sourcerepo-gen.go
+++ b/sourcerepo/v1/sourcerepo-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/source-repositories/docs/apis
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sourcerepo/v1"
-// ...
-// ctx := context.Background()
-// sourcerepoService, err := sourcerepo.NewService(ctx)
+// import "google.golang.org/api/sourcerepo/v1"
+// ...
+// ctx := context.Background()
+// sourcerepoService, err := sourcerepo.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// sourcerepoService, err := sourcerepo.NewService(ctx, option.WithScopes(sourcerepo.SourceReadWriteScope))
+// sourcerepoService, err := sourcerepo.NewService(ctx, option.WithScopes(sourcerepo.SourceReadWriteScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// sourcerepoService, err := sourcerepo.NewService(ctx, option.WithAPIKey("AIza..."))
+// sourcerepoService, err := sourcerepo.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// sourcerepoService, err := sourcerepo.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// sourcerepoService, err := sourcerepo.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sourcerepo // import "google.golang.org/api/sourcerepo/v1"
@@ -291,16 +291,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1074,8 +1078,8 @@ type ProjectsGetConfigCall struct {
// GetConfig: Returns the Cloud Source Repositories configuration of the
// project.
//
-// - name: The name of the requested project. Values are of the form
-// `projects/`.
+// - name: The name of the requested project. Values are of the form
+// `projects/`.
func (r *ProjectsService) GetConfig(name string) *ProjectsGetConfigCall {
c := &ProjectsGetConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1222,8 +1226,8 @@ type ProjectsUpdateConfigCall struct {
// UpdateConfig: Updates the Cloud Source Repositories configuration of
// the project.
//
-// - name: The name of the requested project. Values are of the form
-// `projects/`.
+// - name: The name of the requested project. Values are of the form
+// `projects/`.
func (r *ProjectsService) UpdateConfig(name string, updateprojectconfigrequest *UpdateProjectConfigRequest) *ProjectsUpdateConfigCall {
c := &ProjectsUpdateConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1367,8 +1371,8 @@ type ProjectsReposCreateCall struct {
// the named repository already exists, `CreateRepo` returns
// `ALREADY_EXISTS`.
//
-// - parent: The project in which to create the repo. Values are of the
-// form `projects/`.
+// - parent: The project in which to create the repo. Values are of the
+// form `projects/`.
func (r *ProjectsReposService) Create(parent string, repo *Repo) *ProjectsReposCreateCall {
c := &ProjectsReposCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1510,8 +1514,8 @@ type ProjectsReposDeleteCall struct {
// Delete: Deletes a repo.
//
-// - name: The name of the repo to delete. Values are of the form
-// `projects//repos/`.
+// - name: The name of the repo to delete. Values are of the form
+// `projects//repos/`.
func (r *ProjectsReposService) Delete(name string) *ProjectsReposDeleteCall {
c := &ProjectsReposDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1645,8 +1649,8 @@ type ProjectsReposGetCall struct {
// Get: Returns information about a repo.
//
-// - name: The name of the requested repository. Values are of the form
-// `projects//repos/`.
+// - name: The name of the requested repository. Values are of the form
+// `projects//repos/`.
func (r *ProjectsReposService) Get(name string) *ProjectsReposGetCall {
c := &ProjectsReposGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1797,10 +1801,10 @@ type ProjectsReposGetIamPolicyCall struct {
// an empty policy if the resource exists and does not have a policy
// set.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsReposService) GetIamPolicy(resource string) *ProjectsReposGetIamPolicyCall {
c := &ProjectsReposGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -1975,8 +1979,8 @@ type ProjectsReposListCall struct {
// repos are not set by ListRepos. To get the size of a repo, use
// GetRepo.
//
-// - name: The project ID whose repos should be listed. Values are of
-// the form `projects/`.
+// - name: The project ID whose repos should be listed. Values are of
+// the form `projects/`.
func (r *ProjectsReposService) List(name string) *ProjectsReposListCall {
c := &ProjectsReposListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2174,8 +2178,8 @@ type ProjectsReposPatchCall struct {
// Patch: Updates information about a repo.
//
-// - name: The name of the requested repository. Values are of the form
-// `projects//repos/`.
+// - name: The name of the requested repository. Values are of the form
+// `projects//repos/`.
func (r *ProjectsReposService) Patch(name string, updatereporequest *UpdateRepoRequest) *ProjectsReposPatchCall {
c := &ProjectsReposPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2318,10 +2322,10 @@ type ProjectsReposSetIamPolicyCall struct {
// SetIamPolicy: Sets the access control policy on the specified
// resource. Replaces any existing policy.
//
-// - resource: REQUIRED: The resource for which the policy is being
-// specified. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy is being
+// specified. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsReposService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsReposSetIamPolicyCall {
c := &ProjectsReposSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -2465,8 +2469,8 @@ type ProjectsReposSyncCall struct {
// Sync: Synchronize a connected repo. The response contains
// SyncRepoMetadata in the metadata field.
//
-// - name: The name of the repo to synchronize. Values are of the form
-// `projects//repos/`.
+// - name: The name of the repo to synchronize. Values are of the form
+// `projects//repos/`.
func (r *ProjectsReposService) Sync(name string, syncreporequest *SyncRepoRequest) *ProjectsReposSyncCall {
c := &ProjectsReposSyncCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2610,10 +2614,10 @@ type ProjectsReposTestIamPermissionsCall struct {
// specified resource. If the resource does not exist, this will return
// an empty set of permissions, not a NOT_FOUND error.
//
-// - resource: REQUIRED: The resource for which the policy detail is
-// being requested. See Resource names
-// (https://cloud.google.com/apis/design/resource_names) for the
-// appropriate value for this field.
+// - resource: REQUIRED: The resource for which the policy detail is
+// being requested. See Resource names
+// (https://cloud.google.com/apis/design/resource_names) for the
+// appropriate value for this field.
func (r *ProjectsReposService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsReposTestIamPermissionsCall {
c := &ProjectsReposTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
diff --git a/spanner/v1/spanner-api.json b/spanner/v1/spanner-api.json
index 2e0f9d9c19b..86d8aff42f2 100644
--- a/spanner/v1/spanner-api.json
+++ b/spanner/v1/spanner-api.json
@@ -1453,7 +1453,7 @@
"type": "string"
},
"parent": {
- "description": "Required. The database whose roles should be listed. Values are of the form `projects//instances//databases//databaseRoles`.",
+ "description": "Required. The database whose roles should be listed. Values are of the form `projects//instances//databases/`.",
"location": "path",
"pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
"required": true,
@@ -2262,7 +2262,7 @@
}
}
},
- "revision": "20220718",
+ "revision": "20220812",
"rootUrl": "https://spanner.googleapis.com/",
"schemas": {
"Backup": {
@@ -2438,7 +2438,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
@@ -2808,7 +2808,7 @@
"readOnly": true
},
"encryptionInfo": {
- "description": "Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as encryption state and the Cloud KMS key versions that are in use. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.",
+ "description": "Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status' field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.",
"items": {
"$ref": "EncryptionInfo"
},
@@ -2854,7 +2854,7 @@
"id": "DatabaseRole",
"properties": {
"name": {
- "description": "Required. The name of the database role. Values are of the form `projects//instances//databases//databaseRoles/ {role}`, where `` is as specified in the `CREATE ROLE` DDL statement. This name can be passed to Get/Set IAMPolicy methods to identify the database role.",
+ "description": "Required. The name of the database role. Values are of the form `projects//instances//databases//databaseRoles/ `, where `` is as specified in the `CREATE ROLE` DDL statement.",
"type": "string"
}
},
diff --git a/spanner/v1/spanner-gen.go b/spanner/v1/spanner-gen.go
index f0055570131..418398edc6c 100644
--- a/spanner/v1/spanner-gen.go
+++ b/spanner/v1/spanner-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/spanner/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/spanner/v1"
-// ...
-// ctx := context.Background()
-// spannerService, err := spanner.NewService(ctx)
+// import "google.golang.org/api/spanner/v1"
+// ...
+// ctx := context.Background()
+// spannerService, err := spanner.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// spannerService, err := spanner.NewService(ctx, option.WithScopes(spanner.SpannerDataScope))
+// spannerService, err := spanner.NewService(ctx, option.WithScopes(spanner.SpannerDataScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// spannerService, err := spanner.NewService(ctx, option.WithAPIKey("AIza..."))
+// spannerService, err := spanner.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// spannerService, err := spanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// spannerService, err := spanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package spanner // import "google.golang.org/api/spanner/v1"
@@ -592,16 +592,20 @@ type Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
@@ -1292,11 +1296,12 @@ type Database struct {
// EncryptionInfo: Output only. For databases that are using customer
// managed encryption, this field contains the encryption information
- // for the database, such as encryption state and the Cloud KMS key
- // versions that are in use. For databases that are using Google default
- // or other types of encryption, this field is empty. This field is
- // propagated lazily from the backend. There might be a delay from when
- // a key version is being used and when it appears in this field.
+ // for the database, such as all Cloud KMS key versions that are in use.
+ // The `encryption_status' field inside of each `EncryptionInfo` is not
+ // populated. For databases that are using Google default or other types
+ // of encryption, this field is empty. This field is propagated lazily
+ // from the backend. There might be a delay from when a key version is
+ // being used and when it appears in this field.
EncryptionInfo []*EncryptionInfo `json:"encryptionInfo,omitempty"`
// Name: Required. The name of the database. Values are of the form
@@ -1360,9 +1365,8 @@ func (s *Database) MarshalJSON() ([]byte, error) {
// DatabaseRole: A Cloud Spanner database role.
type DatabaseRole struct {
// Name: Required. The name of the database role. Values are of the form
- // `projects//instances//databases//databaseRoles/ {role}`, where `` is
- // as specified in the `CREATE ROLE` DDL statement. This name can be
- // passed to Get/Set IAMPolicy methods to identify the database role.
+ // `projects//instances//databases//databaseRoles/ `, where `` is as
+ // specified in the `CREATE ROLE` DDL statement.
Name string `json:"name,omitempty"`
// ForceSendFields is a list of field names (e.g. "Name") to
@@ -5685,8 +5689,8 @@ type ProjectsInstanceConfigsGetCall struct {
// Get: Gets information about a particular instance configuration.
//
-// - name: The name of the requested instance configuration. Values are
-// of the form `projects//instanceConfigs/`.
+// - name: The name of the requested instance configuration. Values are
+// of the form `projects//instanceConfigs/`.
func (r *ProjectsInstanceConfigsService) Get(name string) *ProjectsInstanceConfigsGetCall {
c := &ProjectsInstanceConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5834,9 +5838,9 @@ type ProjectsInstanceConfigsListCall struct {
// List: Lists the supported instance configurations for a given
// project.
//
-// - parent: The name of the project for which a list of supported
-// instance configurations is requested. Values are of the form
-// `projects/`.
+// - parent: The name of the project for which a list of supported
+// instance configurations is requested. Values are of the form
+// `projects/`.
func (r *ProjectsInstanceConfigsService) List(parent string) *ProjectsInstanceConfigsListCall {
c := &ProjectsInstanceConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6690,8 +6694,8 @@ type ProjectsInstancesCreateCall struct {
// type is CreateInstanceMetadata. The response field type is Instance,
// if successful.
//
-// - parent: The name of the project in which to create the instance.
-// Values are of the form `projects/`.
+// - parent: The name of the project in which to create the instance.
+// Values are of the form `projects/`.
func (r *ProjectsInstancesService) Create(parent string, createinstancerequest *CreateInstanceRequest) *ProjectsInstancesCreateCall {
c := &ProjectsInstancesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6837,8 +6841,8 @@ type ProjectsInstancesDeleteCall struct {
// immediately and irrevocably disappear from the API. All data in the
// databases is permanently deleted.
//
-// - name: The name of the instance to be deleted. Values are of the
-// form `projects//instances/`.
+// - name: The name of the instance to be deleted. Values are of the
+// form `projects//instances/`.
func (r *ProjectsInstancesService) Delete(name string) *ProjectsInstancesDeleteCall {
c := &ProjectsInstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6972,8 +6976,8 @@ type ProjectsInstancesGetCall struct {
// Get: Gets information about a particular instance.
//
-// - name: The name of the requested instance. Values are of the form
-// `projects//instances/`.
+// - name: The name of the requested instance. Values are of the form
+// `projects//instances/`.
func (r *ProjectsInstancesService) Get(name string) *ProjectsInstancesGetCall {
c := &ProjectsInstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7137,10 +7141,10 @@ type ProjectsInstancesGetIamPolicyCall struct {
// have a policy set. Authorization requires
// `spanner.instances.getIamPolicy` on resource.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which the policy
-// is being retrieved. The format is `projects//instances/` for
-// instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which the policy
+// is being retrieved. The format is `projects//instances/` for
+// instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsInstancesGetIamPolicyCall {
c := &ProjectsInstancesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7283,8 +7287,8 @@ type ProjectsInstancesListCall struct {
// List: Lists all instances in the given project.
//
-// - parent: The name of the project for which a list of instances is
-// requested. Values are of the form `projects/`.
+// - parent: The name of the project for which a list of instances is
+// requested. Values are of the form `projects/`.
func (r *ProjectsInstancesService) List(parent string) *ProjectsInstancesListCall {
c := &ProjectsInstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7538,10 +7542,10 @@ type ProjectsInstancesPatchCall struct {
// successful. Authorization requires `spanner.instances.update`
// permission on the resource name.
//
-// - name: A unique identifier for the instance, which cannot be changed
-// after the instance is created. Values are of the form
-// `projects//instances/a-z*[a-z0-9]`. The final segment of the name
-// must be between 2 and 64 characters in length.
+// - name: A unique identifier for the instance, which cannot be changed
+// after the instance is created. Values are of the form
+// `projects//instances/a-z*[a-z0-9]`. The final segment of the name
+// must be between 2 and 64 characters in length.
func (r *ProjectsInstancesService) Patch(nameid string, updateinstancerequest *UpdateInstanceRequest) *ProjectsInstancesPatchCall {
c := &ProjectsInstancesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.nameid = nameid
@@ -7686,10 +7690,10 @@ type ProjectsInstancesSetIamPolicyCall struct {
// Replaces any existing policy. Authorization requires
// `spanner.instances.setIamPolicy` on resource.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which the policy
-// is being set. The format is `projects//instances/` for instance
-// resources and `projects//instances//databases/` for databases
-// resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which the policy
+// is being set. The format is `projects//instances/` for instance
+// resources and `projects//instances//databases/` for databases
+// resources.
func (r *ProjectsInstancesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsInstancesSetIamPolicyCall {
c := &ProjectsInstancesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7836,10 +7840,10 @@ type ProjectsInstancesTestIamPermissionsCall struct {
// the user has `spanner.instances.list` permission on the containing
// Google Cloud Project. Otherwise returns an empty set of permissions.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which
-// permissions are being tested. The format is `projects//instances/`
-// for instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which
+// permissions are being tested. The format is `projects//instances/`
+// for instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsInstancesTestIamPermissionsCall {
c := &ProjectsInstancesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -7990,8 +7994,8 @@ type ProjectsInstancesBackupOperationsListCall struct {
// `operation.metadata.value.progress.start_time` in descending order
// starting from the most recently started operation.
//
-// - parent: The instance of the backup operations. Values are of the
-// form `projects//instances/`.
+// - parent: The instance of the backup operations. Values are of the
+// form `projects//instances/`.
func (r *ProjectsInstancesBackupOperationsService) List(parent string) *ProjectsInstancesBackupOperationsListCall {
c := &ProjectsInstancesBackupOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8253,8 +8257,8 @@ type ProjectsInstancesBackupsCopyCall struct {
// returned operation will stop the copying and delete the backup.
// Concurrent CopyBackup requests can run on the same source backup.
//
-// - parent: The name of the destination instance that will contain the
-// backup copy. Values are of the form: `projects//instances/`.
+// - parent: The name of the destination instance that will contain the
+// backup copy. Values are of the form: `projects//instances/`.
func (r *ProjectsInstancesBackupsService) Copy(parent string, copybackuprequest *CopyBackupRequest) *ProjectsInstancesBackupsCopyCall {
c := &ProjectsInstancesBackupsCopyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8405,11 +8409,11 @@ type ProjectsInstancesBackupsCreateCall struct {
// per database. Backup creation of different databases can run
// concurrently.
//
-// - parent: The name of the instance in which the backup will be
-// created. This must be the same instance that contains the database
-// the backup will be created from. The backup will be stored in the
-// location(s) specified in the instance configuration of this
-// instance. Values are of the form `projects//instances/`.
+// - parent: The name of the instance in which the backup will be
+// created. This must be the same instance that contains the database
+// the backup will be created from. The backup will be stored in the
+// location(s) specified in the instance configuration of this
+// instance. Values are of the form `projects//instances/`.
func (r *ProjectsInstancesBackupsService) Create(parent string, backup *Backup) *ProjectsInstancesBackupsCreateCall {
c := &ProjectsInstancesBackupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8430,14 +8434,18 @@ func (c *ProjectsInstancesBackupsCreateCall) BackupId(backupId string) *Projects
// the backup.
//
// Possible values:
-// "ENCRYPTION_TYPE_UNSPECIFIED" - Unspecified. Do not use.
-// "USE_DATABASE_ENCRYPTION" - Use the same encryption configuration
+//
+// "ENCRYPTION_TYPE_UNSPECIFIED" - Unspecified. Do not use.
+// "USE_DATABASE_ENCRYPTION" - Use the same encryption configuration
+//
// as the database. This is the default option when encryption_config is
// empty. For example, if the database is using
// `Customer_Managed_Encryption`, the backup will be using the same
// Cloud KMS key as the database.
-// "GOOGLE_DEFAULT_ENCRYPTION" - Use Google default encryption.
-// "CUSTOMER_MANAGED_ENCRYPTION" - Use customer managed encryption. If
+//
+// "GOOGLE_DEFAULT_ENCRYPTION" - Use Google default encryption.
+// "CUSTOMER_MANAGED_ENCRYPTION" - Use customer managed encryption. If
+//
// specified, `kms_key_name` must contain a valid Cloud KMS key.
func (c *ProjectsInstancesBackupsCreateCall) EncryptionConfigEncryptionType(encryptionConfigEncryptionType string) *ProjectsInstancesBackupsCreateCall {
c.urlParams_.Set("encryptionConfig.encryptionType", encryptionConfigEncryptionType)
@@ -8615,8 +8623,8 @@ type ProjectsInstancesBackupsDeleteCall struct {
// Delete: Deletes a pending or completed Backup.
//
-// - name: Name of the backup to delete. Values are of the form
-// `projects//instances//backups/`.
+// - name: Name of the backup to delete. Values are of the form
+// `projects//instances//backups/`.
func (r *ProjectsInstancesBackupsService) Delete(name string) *ProjectsInstancesBackupsDeleteCall {
c := &ProjectsInstancesBackupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8750,8 +8758,8 @@ type ProjectsInstancesBackupsGetCall struct {
// Get: Gets metadata on a pending or completed Backup.
//
-// - name: Name of the backup. Values are of the form
-// `projects//instances//backups/`.
+// - name: Name of the backup. Values are of the form
+// `projects//instances//backups/`.
func (r *ProjectsInstancesBackupsService) Get(name string) *ProjectsInstancesBackupsGetCall {
c := &ProjectsInstancesBackupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -8903,10 +8911,10 @@ type ProjectsInstancesBackupsGetIamPolicyCall struct {
// authorization requires `spanner.backups.getIamPolicy` permission on
// resource.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which the policy
-// is being retrieved. The format is `projects//instances/` for
-// instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which the policy
+// is being retrieved. The format is `projects//instances/` for
+// instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesBackupsService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsInstancesBackupsGetIamPolicyCall {
c := &ProjectsInstancesBackupsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -9051,8 +9059,8 @@ type ProjectsInstancesBackupsListCall struct {
// ordered by `create_time` in descending order, starting from the most
// recent `create_time`.
//
-// - parent: The instance to list backups from. Values are of the form
-// `projects//instances/`.
+// - parent: The instance to list backups from. Values are of the form
+// `projects//instances/`.
func (r *ProjectsInstancesBackupsService) List(parent string) *ProjectsInstancesBackupsListCall {
c := &ProjectsInstancesBackupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9281,14 +9289,14 @@ type ProjectsInstancesBackupsPatchCall struct {
// Patch: Updates a pending or completed Backup.
//
-// - name: Output only for the CreateBackup operation. Required for the
-// UpdateBackup operation. A globally unique identifier for the backup
-// which cannot be changed. Values are of the form
-// `projects//instances//backups/a-z*[a-z0-9]` The final segment of
-// the name must be between 2 and 60 characters in length. The backup
-// is stored in the location(s) specified in the instance
-// configuration of the instance containing the backup, identified by
-// the prefix of the backup name of the form `projects//instances/`.
+// - name: Output only for the CreateBackup operation. Required for the
+// UpdateBackup operation. A globally unique identifier for the backup
+// which cannot be changed. Values are of the form
+// `projects//instances//backups/a-z*[a-z0-9]` The final segment of
+// the name must be between 2 and 60 characters in length. The backup
+// is stored in the location(s) specified in the instance
+// configuration of the instance containing the backup, identified by
+// the prefix of the backup name of the form `projects//instances/`.
func (r *ProjectsInstancesBackupsService) Patch(nameid string, backup *Backup) *ProjectsInstancesBackupsPatchCall {
c := &ProjectsInstancesBackupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.nameid = nameid
@@ -9452,10 +9460,10 @@ type ProjectsInstancesBackupsSetIamPolicyCall struct {
// authorization requires `spanner.backups.setIamPolicy` permission on
// resource.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which the policy
-// is being set. The format is `projects//instances/` for instance
-// resources and `projects//instances//databases/` for databases
-// resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which the policy
+// is being set. The format is `projects//instances/` for instance
+// resources and `projects//instances//databases/` for databases
+// resources.
func (r *ProjectsInstancesBackupsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsInstancesBackupsSetIamPolicyCall {
c := &ProjectsInstancesBackupsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -9605,10 +9613,10 @@ type ProjectsInstancesBackupsTestIamPermissionsCall struct {
// result in a NOT_FOUND error if the user has `spanner.backups.list`
// permission on the containing instance.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which
-// permissions are being tested. The format is `projects//instances/`
-// for instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which
+// permissions are being tested. The format is `projects//instances/`
+// for instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesBackupsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsInstancesBackupsTestIamPermissionsCall {
c := &ProjectsInstancesBackupsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -10397,8 +10405,8 @@ type ProjectsInstancesDatabaseOperationsListCall struct {
// that have completed/failed/canceled within the last 7 days, and
// pending operations.
//
-// - parent: The instance of the database operations. Values are of the
-// form `projects//instances/`.
+// - parent: The instance of the database operations. Values are of the
+// form `projects//instances/`.
func (r *ProjectsInstancesDatabaseOperationsService) List(parent string) *ProjectsInstancesDatabaseOperationsListCall {
c := &ProjectsInstancesDatabaseOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10639,8 +10647,8 @@ type ProjectsInstancesDatabasesCreateCall struct {
// database. The metadata field type is CreateDatabaseMetadata. The
// response field type is Database, if successful.
//
-// - parent: The name of the instance that will serve the new database.
-// Values are of the form `projects//instances/`.
+// - parent: The name of the instance that will serve the new database.
+// Values are of the form `projects//instances/`.
func (r *ProjectsInstancesDatabasesService) Create(parent string, createdatabaserequest *CreateDatabaseRequest) *ProjectsInstancesDatabasesCreateCall {
c := &ProjectsInstancesDatabasesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10919,8 +10927,8 @@ type ProjectsInstancesDatabasesGetCall struct {
// Get: Gets the state of a Cloud Spanner database.
//
-// - name: The name of the requested database. Values are of the form
-// `projects//instances//databases/`.
+// - name: The name of the requested database. Values are of the form
+// `projects//instances//databases/`.
func (r *ProjectsInstancesDatabasesService) Get(name string) *ProjectsInstancesDatabasesGetCall {
c := &ProjectsInstancesDatabasesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11069,8 +11077,8 @@ type ProjectsInstancesDatabasesGetDdlCall struct {
// formatted DDL statements. This method does not show pending schema
// updates, those may be queried using the Operations API.
//
-// - database: The database whose schema we wish to get. Values are of
-// the form `projects//instances//databases/`.
+// - database: The database whose schema we wish to get. Values are of
+// the form `projects//instances//databases/`.
func (r *ProjectsInstancesDatabasesService) GetDdl(database string) *ProjectsInstancesDatabasesGetDdlCall {
c := &ProjectsInstancesDatabasesGetDdlCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.database = database
@@ -11222,10 +11230,10 @@ type ProjectsInstancesDatabasesGetIamPolicyCall struct {
// authorization requires `spanner.backups.getIamPolicy` permission on
// resource.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which the policy
-// is being retrieved. The format is `projects//instances/` for
-// instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which the policy
+// is being retrieved. The format is `projects//instances/` for
+// instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesDatabasesService) GetIamPolicy(resource string, getiampolicyrequest *GetIamPolicyRequest) *ProjectsInstancesDatabasesGetIamPolicyCall {
c := &ProjectsInstancesDatabasesGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -11369,9 +11377,9 @@ type ProjectsInstancesDatabasesGetScansCall struct {
// GetScans: Request a specific scan with Database-specific data for
// Cloud Key Visualizer.
//
-// - name: The unique name of the scan containing the requested
-// information, specific to the Database service implementing this
-// interface.
+// - name: The unique name of the scan containing the requested
+// information, specific to the Database service implementing this
+// interface.
func (r *ProjectsInstancesDatabasesService) GetScans(name string) *ProjectsInstancesDatabasesGetScansCall {
c := &ProjectsInstancesDatabasesGetScansCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -11401,12 +11409,16 @@ func (c *ProjectsInstancesDatabasesGetScansCall) StartTime(startTime string) *Pr
// the FULL view is assumed.
//
// Possible values:
-// "VIEW_UNSPECIFIED" - Not specified, equivalent to SUMMARY.
-// "SUMMARY" - Server responses only include `name`, `details`,
+//
+// "VIEW_UNSPECIFIED" - Not specified, equivalent to SUMMARY.
+// "SUMMARY" - Server responses only include `name`, `details`,
+//
// `start_time` and `end_time`. The default value. Note, the ListScans
// method may only use this view type, others view types are not
// supported.
-// "FULL" - Full representation of the scan is returned in the server
+//
+// "FULL" - Full representation of the scan is returned in the server
+//
// response, including `data`.
func (c *ProjectsInstancesDatabasesGetScansCall) View(view string) *ProjectsInstancesDatabasesGetScansCall {
c.urlParams_.Set("view", view)
@@ -11580,8 +11592,8 @@ type ProjectsInstancesDatabasesListCall struct {
// List: Lists Cloud Spanner databases.
//
-// - parent: The instance whose databases should be listed. Values are
-// of the form `projects//instances/`.
+// - parent: The instance whose databases should be listed. Values are
+// of the form `projects//instances/`.
func (r *ProjectsInstancesDatabasesService) List(parent string) *ProjectsInstancesDatabasesListCall {
c := &ProjectsInstancesDatabasesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11788,10 +11800,10 @@ type ProjectsInstancesDatabasesRestoreCall struct {
// for the optimize operation associated with the first restore to
// complete.
//
-// - parent: The name of the instance in which to create the restored
-// database. This instance must be in the same project and have the
-// same instance configuration as the instance containing the source
-// backup. Values are of the form `projects//instances/`.
+// - parent: The name of the instance in which to create the restored
+// database. This instance must be in the same project and have the
+// same instance configuration as the instance containing the source
+// backup. Values are of the form `projects//instances/`.
func (r *ProjectsInstancesDatabasesService) Restore(parent string, restoredatabaserequest *RestoreDatabaseRequest) *ProjectsInstancesDatabasesRestoreCall {
c := &ProjectsInstancesDatabasesRestoreCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11938,10 +11950,10 @@ type ProjectsInstancesDatabasesSetIamPolicyCall struct {
// authorization requires `spanner.backups.setIamPolicy` permission on
// resource.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which the policy
-// is being set. The format is `projects//instances/` for instance
-// resources and `projects//instances//databases/` for databases
-// resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which the policy
+// is being set. The format is `projects//instances/` for instance
+// resources and `projects//instances//databases/` for databases
+// resources.
func (r *ProjectsInstancesDatabasesService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsInstancesDatabasesSetIamPolicyCall {
c := &ProjectsInstancesDatabasesSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -12091,10 +12103,10 @@ type ProjectsInstancesDatabasesTestIamPermissionsCall struct {
// result in a NOT_FOUND error if the user has `spanner.backups.list`
// permission on the containing instance.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which
-// permissions are being tested. The format is `projects//instances/`
-// for instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which
+// permissions are being tested. The format is `projects//instances/`
+// for instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesDatabasesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsInstancesDatabasesTestIamPermissionsCall {
c := &ProjectsInstancesDatabasesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -12385,8 +12397,8 @@ type ProjectsInstancesDatabasesDatabaseRolesListCall struct {
// List: Lists Cloud Spanner database roles.
//
-// - parent: The database whose roles should be listed. Values are of
-// the form `projects//instances//databases//databaseRoles`.
+// - parent: The database whose roles should be listed. Values are of
+// the form `projects//instances//databases/`.
func (r *ProjectsInstancesDatabasesDatabaseRolesService) List(parent string) *ProjectsInstancesDatabasesDatabaseRolesListCall {
c := &ProjectsInstancesDatabasesDatabaseRolesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12528,7 +12540,7 @@ func (c *ProjectsInstancesDatabasesDatabaseRolesListCall) Do(opts ...googleapi.C
// "type": "string"
// },
// "parent": {
- // "description": "Required. The database whose roles should be listed. Values are of the form `projects//instances//databases//databaseRoles`.",
+ // "description": "Required. The database whose roles should be listed. Values are of the form `projects//instances//databases/`.",
// "location": "path",
// "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
// "required": true,
@@ -12588,10 +12600,10 @@ type ProjectsInstancesDatabasesDatabaseRolesTestIamPermissionsCall struct {
// result in a NOT_FOUND error if the user has `spanner.backups.list`
// permission on the containing instance.
//
-// - resource: REQUIRED: The Cloud Spanner resource for which
-// permissions are being tested. The format is `projects//instances/`
-// for instance resources and `projects//instances//databases/` for
-// database resources.
+// - resource: REQUIRED: The Cloud Spanner resource for which
+// permissions are being tested. The format is `projects//instances/`
+// for instance resources and `projects//instances//databases/` for
+// database resources.
func (r *ProjectsInstancesDatabasesDatabaseRolesService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsInstancesDatabasesDatabaseRolesTestIamPermissionsCall {
c := &ProjectsInstancesDatabasesDatabaseRolesTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.resource = resource
@@ -13676,8 +13688,8 @@ type ProjectsInstancesDatabasesSessionsCommitCall struct {
// that you perform another read from the database to see the state of
// things as they are now.
//
-// - session: The session in which the transaction to be committed is
-// running.
+// - session: The session in which the transaction to be committed is
+// running.
func (r *ProjectsInstancesDatabasesSessionsService) Commit(session string, commitrequest *CommitRequest) *ProjectsInstancesDatabasesSessionsCommitCall {
c := &ProjectsInstancesDatabasesSessionsCommitCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.session = session
@@ -14118,8 +14130,8 @@ type ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall struct {
// after the first failed statement; the remaining statements are not
// executed.
//
-// - session: The session in which the DML statements should be
-// performed.
+// - session: The session in which the DML statements should be
+// performed.
func (r *ProjectsInstancesDatabasesSessionsService) ExecuteBatchDml(session string, executebatchdmlrequest *ExecuteBatchDmlRequest) *ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall {
c := &ProjectsInstancesDatabasesSessionsExecuteBatchDmlCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.session = session
@@ -15383,8 +15395,8 @@ type ProjectsInstancesDatabasesSessionsRollbackCall struct {
// transaction, the transaction was already aborted, or the transaction
// is not found. `Rollback` never returns `ABORTED`.
//
-// - session: The session in which the transaction to roll back is
-// running.
+// - session: The session in which the transaction to roll back is
+// running.
func (r *ProjectsInstancesDatabasesSessionsService) Rollback(session string, rollbackrequest *RollbackRequest) *ProjectsInstancesDatabasesSessionsRollbackCall {
c := &ProjectsInstancesDatabasesSessionsRollbackCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.session = session
@@ -16314,8 +16326,8 @@ type ScansListCall struct {
// List: Return available scans given a Database-specific resource name.
//
-// - parent: The unique name of the parent resource, specific to the
-// Database service implementing this interface.
+// - parent: The unique name of the parent resource, specific to the
+// Database service implementing this interface.
func (r *ScansService) List(parent string) *ScansListCall {
c := &ScansListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16350,12 +16362,16 @@ func (c *ScansListCall) PageToken(pageToken string) *ScansListCall {
// (the default) is currently supported for ListScans.
//
// Possible values:
-// "VIEW_UNSPECIFIED" - Not specified, equivalent to SUMMARY.
-// "SUMMARY" - Server responses only include `name`, `details`,
+//
+// "VIEW_UNSPECIFIED" - Not specified, equivalent to SUMMARY.
+// "SUMMARY" - Server responses only include `name`, `details`,
+//
// `start_time` and `end_time`. The default value. Note, the ListScans
// method may only use this view type, others view types are not
// supported.
-// "FULL" - Full representation of the scan is returned in the server
+//
+// "FULL" - Full representation of the scan is returned in the server
+//
// response, including `data`.
func (c *ScansListCall) View(view string) *ScansListCall {
c.urlParams_.Set("view", view)
diff --git a/spectrum/v1explorer/spectrum-gen.go b/spectrum/v1explorer/spectrum-gen.go
index 34a7f84a3d8..ae4562635bb 100644
--- a/spectrum/v1explorer/spectrum-gen.go
+++ b/spectrum/v1explorer/spectrum-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: http://developers.google.com/spectrum
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/spectrum/v1explorer"
-// ...
-// ctx := context.Background()
-// spectrumService, err := spectrum.NewService(ctx)
+// import "google.golang.org/api/spectrum/v1explorer"
+// ...
+// ctx := context.Background()
+// spectrumService, err := spectrum.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// spectrumService, err := spectrum.NewService(ctx, option.WithAPIKey("AIza..."))
+// spectrumService, err := spectrum.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// spectrumService, err := spectrum.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// spectrumService, err := spectrum.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package spectrum // import "google.golang.org/api/spectrum/v1explorer"
diff --git a/speech/v1/speech-gen.go b/speech/v1/speech-gen.go
index 034e8772085..c0df3b547b4 100644
--- a/speech/v1/speech-gen.go
+++ b/speech/v1/speech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/speech-to-text/docs/quickstart-protocol
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/speech/v1"
-// ...
-// ctx := context.Background()
-// speechService, err := speech.NewService(ctx)
+// import "google.golang.org/api/speech/v1"
+// ...
+// ctx := context.Background()
+// speechService, err := speech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
+// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package speech // import "google.golang.org/api/speech/v1"
@@ -2022,15 +2022,15 @@ type ProjectsLocationsCustomClassesCreateCall struct {
// Create: Create a custom class.
//
-// - parent: The parent resource where this custom class will be
-// created. Format:
-// `projects/{project}/locations/{location}/customClasses`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent resource where this custom class will be
+// created. Format:
+// `projects/{project}/locations/{location}/customClasses`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsCustomClassesService) Create(parent string, createcustomclassrequest *CreateCustomClassRequest) *ProjectsLocationsCustomClassesCreateCall {
c := &ProjectsLocationsCustomClassesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2171,14 +2171,14 @@ type ProjectsLocationsCustomClassesDeleteCall struct {
// Delete: Delete a custom class.
//
-// - name: The name of the custom class to delete. Format:
-// `projects/{project}/locations/{location}/customClasses/{custom_class
-// }` Speech-to-Text supports three locations: `global`, `us` (US
-// North America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - name: The name of the custom class to delete. Format:
+// `projects/{project}/locations/{location}/customClasses/{custom_class
+// }` Speech-to-Text supports three locations: `global`, `us` (US
+// North America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsCustomClassesService) Delete(name string) *ProjectsLocationsCustomClassesDeleteCall {
c := &ProjectsLocationsCustomClassesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2311,9 +2311,9 @@ type ProjectsLocationsCustomClassesGetCall struct {
// Get: Get a custom class.
//
-// - name: The name of the custom class to retrieve. Format:
-// `projects/{project}/locations/{location}/customClasses/{custom_class
-// }`.
+// - name: The name of the custom class to retrieve. Format:
+// `projects/{project}/locations/{location}/customClasses/{custom_class
+// }`.
func (r *ProjectsLocationsCustomClassesService) Get(name string) *ProjectsLocationsCustomClassesGetCall {
c := &ProjectsLocationsCustomClassesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2459,14 +2459,14 @@ type ProjectsLocationsCustomClassesListCall struct {
// List: List custom classes.
//
-// - parent: The parent, which owns this collection of custom classes.
-// Format: `projects/{project}/locations/{location}/customClasses`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent, which owns this collection of custom classes.
+// Format: `projects/{project}/locations/{location}/customClasses`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsCustomClassesService) List(parent string) *ProjectsLocationsCustomClassesListCall {
c := &ProjectsLocationsCustomClassesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2821,14 +2821,14 @@ type ProjectsLocationsPhraseSetsCreateCall struct {
// favored by the recognition model when you send a call that includes
// the PhraseSet.
//
-// - parent: The parent resource where this phrase set will be created.
-// Format: `projects/{project}/locations/{location}/phraseSets`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent resource where this phrase set will be created.
+// Format: `projects/{project}/locations/{location}/phraseSets`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsPhraseSetsService) Create(parent string, createphrasesetrequest *CreatePhraseSetRequest) *ProjectsLocationsPhraseSetsCreateCall {
c := &ProjectsLocationsPhraseSetsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2969,8 +2969,8 @@ type ProjectsLocationsPhraseSetsDeleteCall struct {
// Delete: Delete a phrase set.
//
-// - name: The name of the phrase set to delete. Format:
-// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.
+// - name: The name of the phrase set to delete. Format:
+// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.
func (r *ProjectsLocationsPhraseSetsService) Delete(name string) *ProjectsLocationsPhraseSetsDeleteCall {
c := &ProjectsLocationsPhraseSetsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3103,14 +3103,14 @@ type ProjectsLocationsPhraseSetsGetCall struct {
// Get: Get a phrase set.
//
-// - name: The name of the phrase set to retrieve. Format:
-// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - name: The name of the phrase set to retrieve. Format:
+// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsPhraseSetsService) Get(name string) *ProjectsLocationsPhraseSetsGetCall {
c := &ProjectsLocationsPhraseSetsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3256,14 +3256,14 @@ type ProjectsLocationsPhraseSetsListCall struct {
// List: List phrase sets.
//
-// - parent: The parent, which owns this collection of phrase set.
-// Format: `projects/{project}/locations/{location}` Speech-to-Text
-// supports three locations: `global`, `us` (US North America), and
-// `eu` (Europe). If you are calling the `speech.googleapis.com`
-// endpoint, use the `global` location. To specify a region, use a
-// regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent, which owns this collection of phrase set.
+// Format: `projects/{project}/locations/{location}` Speech-to-Text
+// supports three locations: `global`, `us` (US North America), and
+// `eu` (Europe). If you are calling the `speech.googleapis.com`
+// endpoint, use the `global` location. To specify a region, use a
+// regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsPhraseSetsService) List(parent string) *ProjectsLocationsPhraseSetsListCall {
c := &ProjectsLocationsPhraseSetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/speech/v1beta1/speech-gen.go b/speech/v1beta1/speech-gen.go
index 7b1fc747807..2adce4ad81d 100644
--- a/speech/v1beta1/speech-gen.go
+++ b/speech/v1beta1/speech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/speech-to-text/docs/quickstart-protocol
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/speech/v1beta1"
-// ...
-// ctx := context.Background()
-// speechService, err := speech.NewService(ctx)
+// import "google.golang.org/api/speech/v1beta1"
+// ...
+// ctx := context.Background()
+// speechService, err := speech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
+// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package speech // import "google.golang.org/api/speech/v1beta1"
@@ -631,29 +631,41 @@ func (s *SpeechRecognitionResult) MarshalJSON() ([]byte, error) {
//
// - Partial errors. If a service needs to return partial errors to the
// client,
-// it may embed the `Status` in the normal response to indicate the
+//
+// it may embed the `Status` in the normal response to indicate the
+//
// partial
-// errors.
+//
+// errors.
//
// - Workflow errors. A typical workflow has multiple steps. Each step
// may
-// have a `Status` message for error reporting.
+//
+// have a `Status` message for error reporting.
//
// - Batch operations. If a client uses batch request and batch
// response, the
-// `Status` message should be used directly inside batch response,
+//
+// `Status` message should be used directly inside batch response,
+//
// one for
-// each error sub-response.
+//
+// each error sub-response.
//
// - Asynchronous operations. If an API call embeds asynchronous
// operation
-// results in its response, the status of those operations should
+//
+// results in its response, the status of those operations should
+//
// be
-// represented directly using the `Status` message.
+//
+// represented directly using the `Status` message.
//
// - Logging. If some API errors are stored in logs, the message
// `Status` could
-// be used directly after any stripping needed for security/privacy
+//
+// be used directly after any stripping needed for security/privacy
+//
// reasons.
type Status struct {
// Code: The status code, which should be an enum value of
diff --git a/speech/v1p1beta1/speech-gen.go b/speech/v1p1beta1/speech-gen.go
index 9dea2aa9387..2a36cc6900e 100644
--- a/speech/v1p1beta1/speech-gen.go
+++ b/speech/v1p1beta1/speech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/speech-to-text/docs/quickstart-protocol
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/speech/v1p1beta1"
-// ...
-// ctx := context.Background()
-// speechService, err := speech.NewService(ctx)
+// import "google.golang.org/api/speech/v1p1beta1"
+// ...
+// ctx := context.Background()
+// speechService, err := speech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
+// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package speech // import "google.golang.org/api/speech/v1p1beta1"
@@ -2123,15 +2123,15 @@ type ProjectsLocationsCustomClassesCreateCall struct {
// Create: Create a custom class.
//
-// - parent: The parent resource where this custom class will be
-// created. Format:
-// `projects/{project}/locations/{location}/customClasses`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent resource where this custom class will be
+// created. Format:
+// `projects/{project}/locations/{location}/customClasses`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsCustomClassesService) Create(parent string, createcustomclassrequest *CreateCustomClassRequest) *ProjectsLocationsCustomClassesCreateCall {
c := &ProjectsLocationsCustomClassesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2272,14 +2272,14 @@ type ProjectsLocationsCustomClassesDeleteCall struct {
// Delete: Delete a custom class.
//
-// - name: The name of the custom class to delete. Format:
-// `projects/{project}/locations/{location}/customClasses/{custom_class
-// }` Speech-to-Text supports three locations: `global`, `us` (US
-// North America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - name: The name of the custom class to delete. Format:
+// `projects/{project}/locations/{location}/customClasses/{custom_class
+// }` Speech-to-Text supports three locations: `global`, `us` (US
+// North America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsCustomClassesService) Delete(name string) *ProjectsLocationsCustomClassesDeleteCall {
c := &ProjectsLocationsCustomClassesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2412,9 +2412,9 @@ type ProjectsLocationsCustomClassesGetCall struct {
// Get: Get a custom class.
//
-// - name: The name of the custom class to retrieve. Format:
-// `projects/{project}/locations/{location}/customClasses/{custom_class
-// }`.
+// - name: The name of the custom class to retrieve. Format:
+// `projects/{project}/locations/{location}/customClasses/{custom_class
+// }`.
func (r *ProjectsLocationsCustomClassesService) Get(name string) *ProjectsLocationsCustomClassesGetCall {
c := &ProjectsLocationsCustomClassesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2560,14 +2560,14 @@ type ProjectsLocationsCustomClassesListCall struct {
// List: List custom classes.
//
-// - parent: The parent, which owns this collection of custom classes.
-// Format: `projects/{project}/locations/{location}/customClasses`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent, which owns this collection of custom classes.
+// Format: `projects/{project}/locations/{location}/customClasses`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsCustomClassesService) List(parent string) *ProjectsLocationsCustomClassesListCall {
c := &ProjectsLocationsCustomClassesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2922,14 +2922,14 @@ type ProjectsLocationsPhraseSetsCreateCall struct {
// favored by the recognition model when you send a call that includes
// the PhraseSet.
//
-// - parent: The parent resource where this phrase set will be created.
-// Format: `projects/{project}/locations/{location}/phraseSets`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent resource where this phrase set will be created.
+// Format: `projects/{project}/locations/{location}/phraseSets`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsPhraseSetsService) Create(parent string, createphrasesetrequest *CreatePhraseSetRequest) *ProjectsLocationsPhraseSetsCreateCall {
c := &ProjectsLocationsPhraseSetsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3070,8 +3070,8 @@ type ProjectsLocationsPhraseSetsDeleteCall struct {
// Delete: Delete a phrase set.
//
-// - name: The name of the phrase set to delete. Format:
-// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.
+// - name: The name of the phrase set to delete. Format:
+// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.
func (r *ProjectsLocationsPhraseSetsService) Delete(name string) *ProjectsLocationsPhraseSetsDeleteCall {
c := &ProjectsLocationsPhraseSetsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3204,14 +3204,14 @@ type ProjectsLocationsPhraseSetsGetCall struct {
// Get: Get a phrase set.
//
-// - name: The name of the phrase set to retrieve. Format:
-// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
-// Speech-to-Text supports three locations: `global`, `us` (US North
-// America), and `eu` (Europe). If you are calling the
-// `speech.googleapis.com` endpoint, use the `global` location. To
-// specify a region, use a regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - name: The name of the phrase set to retrieve. Format:
+// `projects/{project}/locations/{location}/phraseSets/{phrase_set}`
+// Speech-to-Text supports three locations: `global`, `us` (US North
+// America), and `eu` (Europe). If you are calling the
+// `speech.googleapis.com` endpoint, use the `global` location. To
+// specify a region, use a regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsPhraseSetsService) Get(name string) *ProjectsLocationsPhraseSetsGetCall {
c := &ProjectsLocationsPhraseSetsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3357,14 +3357,14 @@ type ProjectsLocationsPhraseSetsListCall struct {
// List: List phrase sets.
//
-// - parent: The parent, which owns this collection of phrase set.
-// Format: `projects/{project}/locations/{location}` Speech-to-Text
-// supports three locations: `global`, `us` (US North America), and
-// `eu` (Europe). If you are calling the `speech.googleapis.com`
-// endpoint, use the `global` location. To specify a region, use a
-// regional endpoint
-// (https://cloud.google.com/speech-to-text/docs/endpoints) with
-// matching `us` or `eu` location value.
+// - parent: The parent, which owns this collection of phrase set.
+// Format: `projects/{project}/locations/{location}` Speech-to-Text
+// supports three locations: `global`, `us` (US North America), and
+// `eu` (Europe). If you are calling the `speech.googleapis.com`
+// endpoint, use the `global` location. To specify a region, use a
+// regional endpoint
+// (https://cloud.google.com/speech-to-text/docs/endpoints) with
+// matching `us` or `eu` location value.
func (r *ProjectsLocationsPhraseSetsService) List(parent string) *ProjectsLocationsPhraseSetsListCall {
c := &ProjectsLocationsPhraseSetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/speech/v2beta/speech-gen.go b/speech/v2beta/speech-gen.go
index 6c58c2e77b0..9ecc45875ff 100644
--- a/speech/v2beta/speech-gen.go
+++ b/speech/v2beta/speech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/speech-to-text/docs/quickstart-protocol
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/speech/v2beta"
-// ...
-// ctx := context.Background()
-// speechService, err := speech.NewService(ctx)
+// import "google.golang.org/api/speech/v2beta"
+// ...
+// ctx := context.Background()
+// speechService, err := speech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
+// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package speech // import "google.golang.org/api/speech/v2beta"
diff --git a/speech/v2beta1/speech-gen.go b/speech/v2beta1/speech-gen.go
index c138a8bed3a..aa719eec491 100644
--- a/speech/v2beta1/speech-gen.go
+++ b/speech/v2beta1/speech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/speech-to-text/docs/quickstart-protocol
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/speech/v2beta1"
-// ...
-// ctx := context.Background()
-// speechService, err := speech.NewService(ctx)
+// import "google.golang.org/api/speech/v2beta1"
+// ...
+// ctx := context.Background()
+// speechService, err := speech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
+// speechService, err := speech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// speechService, err := speech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package speech // import "google.golang.org/api/speech/v2beta1"
diff --git a/sql/v1beta4/sql-gen.go b/sql/v1beta4/sql-gen.go
index efb968aeea8..28bf99a095b 100644
--- a/sql/v1beta4/sql-gen.go
+++ b/sql/v1beta4/sql-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/cloud-sql/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sql/v1beta4"
-// ...
-// ctx := context.Background()
-// sqlService, err := sql.NewService(ctx)
+// import "google.golang.org/api/sql/v1beta4"
+// ...
+// ctx := context.Background()
+// sqlService, err := sql.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// sqlService, err := sql.NewService(ctx, option.WithScopes(sql.SqlserviceAdminScope))
+// sqlService, err := sql.NewService(ctx, option.WithScopes(sql.SqlserviceAdminScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// sqlService, err := sql.NewService(ctx, option.WithAPIKey("AIza..."))
+// sqlService, err := sql.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// sqlService, err := sql.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// sqlService, err := sql.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
//
@@ -9318,9 +9318,10 @@ func (r *ProjectsInstancesService) StartExternalSync(project string, instance st
// SyncMode sets the optional parameter "syncMode": External sync mode
//
// Possible values:
-// "EXTERNAL_SYNC_MODE_UNSPECIFIED"
-// "ONLINE"
-// "OFFLINE"
+//
+// "EXTERNAL_SYNC_MODE_UNSPECIFIED"
+// "ONLINE"
+// "OFFLINE"
func (c *ProjectsInstancesStartExternalSyncCall) SyncMode(syncMode string) *ProjectsInstancesStartExternalSyncCall {
c.urlParams_.Set("syncMode", syncMode)
return c
@@ -9480,9 +9481,10 @@ func (r *ProjectsInstancesService) VerifyExternalSyncSettings(project string, in
// SyncMode sets the optional parameter "syncMode": External sync mode
//
// Possible values:
-// "EXTERNAL_SYNC_MODE_UNSPECIFIED"
-// "ONLINE"
-// "OFFLINE"
+//
+// "EXTERNAL_SYNC_MODE_UNSPECIFIED"
+// "ONLINE"
+// "OFFLINE"
func (c *ProjectsInstancesVerifyExternalSyncSettingsCall) SyncMode(syncMode string) *ProjectsInstancesVerifyExternalSyncSettingsCall {
c.urlParams_.Set("syncMode", syncMode)
return c
diff --git a/sqladmin/v1/sqladmin-api.json b/sqladmin/v1/sqladmin-api.json
index 0397e3bf13a..aa93d53009f 100644
--- a/sqladmin/v1/sqladmin-api.json
+++ b/sqladmin/v1/sqladmin-api.json
@@ -1916,7 +1916,7 @@
}
}
},
- "revision": "20220724",
+ "revision": "20220804",
"rootUrl": "https://sqladmin.googleapis.com/",
"schemas": {
"AclEntry": {
@@ -4068,6 +4068,20 @@
"description": "The name of server Instance collation.",
"type": "string"
},
+ "connectorEnforcement": {
+ "description": "Specifies if connections must use Cloud SQL connectors. Option values include the following: * `NOT_REQUIRED`: Cloud SQL instances can be connected without Cloud SQL Connectors. * `REQUIRED`: Only allow connections that use Cloud SQL Connectors. Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance.",
+ "enum": [
+ "CONNECTOR_ENFORCEMENT_UNSPECIFIED",
+ "NOT_REQUIRED",
+ "REQUIRED"
+ ],
+ "enumDescriptions": [
+ "The requirement for Cloud SQL connectors is unknown.",
+ "Do not require Cloud SQL connectors.",
+ "Require all connections to use Cloud SQL connectors, including the Cloud SQL Auth Proxy and Cloud SQL Java, Python, and Go connectors. Note: This disables all existing authorized networks."
+ ],
+ "type": "string"
+ },
"crashSafeReplicationEnabled": {
"description": "Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances.",
"type": "boolean"
diff --git a/sqladmin/v1/sqladmin-gen.go b/sqladmin/v1/sqladmin-gen.go
index 61401b13c5a..33d1024c942 100644
--- a/sqladmin/v1/sqladmin-gen.go
+++ b/sqladmin/v1/sqladmin-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/cloud-sql/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sqladmin/v1"
-// ...
-// ctx := context.Background()
-// sqladminService, err := sqladmin.NewService(ctx)
+// import "google.golang.org/api/sqladmin/v1"
+// ...
+// ctx := context.Background()
+// sqladminService, err := sqladmin.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// sqladminService, err := sqladmin.NewService(ctx, option.WithScopes(sqladmin.SqlserviceAdminScope))
+// sqladminService, err := sqladmin.NewService(ctx, option.WithScopes(sqladmin.SqlserviceAdminScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// sqladminService, err := sqladmin.NewService(ctx, option.WithAPIKey("AIza..."))
+// sqladminService, err := sqladmin.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// sqladminService, err := sqladmin.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// sqladminService, err := sqladmin.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sqladmin // import "google.golang.org/api/sqladmin/v1"
@@ -3456,6 +3456,24 @@ type Settings struct {
// Collation: The name of server Instance collation.
Collation string `json:"collation,omitempty"`
+ // ConnectorEnforcement: Specifies if connections must use Cloud SQL
+ // connectors. Option values include the following: * `NOT_REQUIRED`:
+ // Cloud SQL instances can be connected without Cloud SQL Connectors. *
+ // `REQUIRED`: Only allow connections that use Cloud SQL Connectors.
+ // Note that using REQUIRED disables all existing authorized networks.
+ // If this field is not specified when creating a new instance,
+ // NOT_REQUIRED is used. If this field is not specified when patching or
+ // updating an existing instance, it is left unchanged in the instance.
+ //
+ // Possible values:
+ // "CONNECTOR_ENFORCEMENT_UNSPECIFIED" - The requirement for Cloud SQL
+ // connectors is unknown.
+ // "NOT_REQUIRED" - Do not require Cloud SQL connectors.
+ // "REQUIRED" - Require all connections to use Cloud SQL connectors,
+ // including the Cloud SQL Auth Proxy and Cloud SQL Java, Python, and Go
+ // connectors. Note: This disables all existing authorized networks.
+ ConnectorEnforcement string `json:"connectorEnforcement,omitempty"`
+
// CrashSafeReplicationEnabled: Configuration specific to read replica
// instances. Indicates whether database flags for crash-safe
// replication are enabled. This property was only applicable to First
@@ -4625,13 +4643,13 @@ type BackupRunsDeleteCall struct {
// Delete: Deletes the backup taken by a backup run.
//
-// - id: The ID of the backup run to delete. To find a backup run ID,
-// use the list
-// (https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1/backupRuns/list)
-// method.
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - id: The ID of the backup run to delete. To find a backup run ID,
+// use the list
+// (https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1/backupRuns/list)
+// method.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) Delete(project string, instance string, id int64) *BackupRunsDeleteCall {
c := &BackupRunsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -4785,10 +4803,10 @@ type BackupRunsGetCall struct {
// Get: Retrieves a resource containing information about a backup run.
//
-// - id: The ID of this backup run.
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - id: The ID of this backup run.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) Get(project string, instance string, id int64) *BackupRunsGetCall {
c := &BackupRunsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -4954,9 +4972,9 @@ type BackupRunsInsertCall struct {
// Insert: Creates a new backup run on demand.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) Insert(project string, instance string, backuprun *BackupRun) *BackupRunsInsertCall {
c := &BackupRunsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5110,9 +5128,9 @@ type BackupRunsListCall struct {
// instance and configuration in the reverse chronological order of the
// backup initiation time.
//
-// - instance: Cloud SQL instance ID, or "-" for all instances. This
-// does not include the project ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID, or "-" for all instances. This
+// does not include the project ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) List(project string, instance string) *BackupRunsListCall {
c := &BackupRunsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5318,9 +5336,9 @@ type ConnectGenerateEphemeralCertCall struct {
// specific to the target instance. Users may use the certificate to
// authenticate as themselves when connecting to the database.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *ConnectService) GenerateEphemeralCert(project string, instance string, generateephemeralcertrequest *GenerateEphemeralCertRequest) *ConnectGenerateEphemeralCertCall {
c := &ConnectGenerateEphemeralCertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5472,9 +5490,9 @@ type ConnectGetCall struct {
// Get: Retrieves connect settings about a Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *ConnectService) Get(project string, instance string) *ConnectGetCall {
c := &ConnectGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5643,10 +5661,10 @@ type DatabasesDeleteCall struct {
// Delete: Deletes a database from a Cloud SQL instance.
//
-// - database: Name of the database to be deleted in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database to be deleted in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Delete(project string, instance string, database string) *DatabasesDeleteCall {
c := &DatabasesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5800,10 +5818,10 @@ type DatabasesGetCall struct {
// Get: Retrieves a resource containing information about a database
// inside a Cloud SQL instance.
//
-// - database: Name of the database in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Get(project string, instance string, database string) *DatabasesGetCall {
c := &DatabasesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5969,9 +5987,9 @@ type DatabasesInsertCall struct {
// Insert: Inserts a resource containing information about a database
// inside a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Insert(project string, instance string, database *Database) *DatabasesInsertCall {
c := &DatabasesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6123,9 +6141,9 @@ type DatabasesListCall struct {
// List: Lists databases in the specified Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) List(project string, instance string) *DatabasesListCall {
c := &DatabasesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6284,10 +6302,10 @@ type DatabasesPatchCall struct {
// database inside a Cloud SQL instance. This method supports patch
// semantics.
//
-// - database: Name of the database to be updated in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database to be updated in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Patch(project string, instance string, database string, database2 *Database) *DatabasesPatchCall {
c := &DatabasesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6450,10 +6468,10 @@ type DatabasesUpdateCall struct {
// Update: Updates a resource containing information about a database
// inside a Cloud SQL instance.
//
-// - database: Name of the database to be updated in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database to be updated in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Update(project string, instance string, database string, database2 *Database) *DatabasesUpdateCall {
c := &DatabasesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6761,9 +6779,9 @@ type InstancesAddServerCaCall struct {
// certificate rotation, this operation replaces that version. There
// cannot be more than one CA version waiting to be rotated in.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) AddServerCa(project string, instance string) *InstancesAddServerCaCall {
c := &InstancesAddServerCaCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6907,10 +6925,10 @@ type InstancesCloneCall struct {
// Clone: Creates a Cloud SQL instance as a clone of the source
// instance. Using this operation might cause your instance to restart.
//
-// - instance: The ID of the Cloud SQL instance to be cloned (source).
-// This does not include the project ID.
-// - project: Project ID of the source as well as the clone Cloud SQL
-// instance.
+// - instance: The ID of the Cloud SQL instance to be cloned (source).
+// This does not include the project ID.
+// - project: Project ID of the source as well as the clone Cloud SQL
+// instance.
func (r *InstancesService) Clone(project string, instance string, instancesclonerequest *InstancesCloneRequest) *InstancesCloneCall {
c := &InstancesCloneCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7061,10 +7079,10 @@ type InstancesDeleteCall struct {
// Delete: Deletes a Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance to be
-// deleted.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance to be
+// deleted.
func (r *InstancesService) Delete(project string, instance string) *InstancesDeleteCall {
c := &InstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7362,10 +7380,10 @@ type InstancesExportCall struct {
// Export: Exports data from a Cloud SQL instance to a Cloud Storage
// bucket as a SQL dump or CSV file.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance to be
-// exported.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance to be
+// exported.
func (r *InstancesService) Export(project string, instance string, instancesexportrequest *InstancesExportRequest) *InstancesExportCall {
c := &InstancesExportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7522,9 +7540,9 @@ type InstancesFailoverCall struct {
// the Cloud SQL documentation. If using Legacy HA (MySQL only), this
// causes the instance to failover to its failover replica instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: ID of the project that contains the read replica.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: ID of the project that contains the read replica.
func (r *InstancesService) Failover(project string, instance string, instancesfailoverrequest *InstancesFailoverRequest) *InstancesFailoverCall {
c := &InstancesFailoverCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7677,9 +7695,9 @@ type InstancesGetCall struct {
// Get: Retrieves a resource containing information about a Cloud SQL
// instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Get(project string, instance string) *InstancesGetCall {
c := &InstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7836,9 +7854,9 @@ type InstancesImportCall struct {
// Import: Imports data into a Cloud SQL instance from a SQL dump or CSV
// file in Cloud Storage.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Import(project string, instance string, instancesimportrequest *InstancesImportRequest) *InstancesImportCall {
c := &InstancesImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7988,8 +8006,8 @@ type InstancesInsertCall struct {
// Insert: Creates a new Cloud SQL instance.
//
-// - project: Project ID of the project to which the newly created Cloud
-// SQL instances should belong.
+// - project: Project ID of the project to which the newly created Cloud
+// SQL instances should belong.
func (r *InstancesService) Insert(project string, databaseinstance *DatabaseInstance) *InstancesInsertCall {
c := &InstancesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8131,8 +8149,8 @@ type InstancesListCall struct {
// List: Lists instances under a given project.
//
-// - project: Project ID of the project for which to list Cloud SQL
-// instances.
+// - project: Project ID of the project for which to list Cloud SQL
+// instances.
func (r *InstancesService) List(project string) *InstancesListCall {
c := &InstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8351,9 +8369,9 @@ type InstancesListServerCasCall struct {
// CA that has been added but not yet used to sign a certificate, and a
// CA used to sign a certificate that has previously rotated out.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) ListServerCas(project string, instance string) *InstancesListServerCasCall {
c := &InstancesListServerCasCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8510,9 +8528,9 @@ type InstancesPatchCall struct {
// Patch: Updates settings of a Cloud SQL instance. This method supports
// patch semantics.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Patch(project string, instance string, databaseinstance *DatabaseInstance) *InstancesPatchCall {
c := &InstancesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8809,9 +8827,9 @@ type InstancesResetSslConfigCall struct {
// ResetSslConfig: Deletes all client certificates and generates a new
// server SSL certificate for the instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) ResetSslConfig(project string, instance string) *InstancesResetSslConfigCall {
c := &InstancesResetSslConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8953,10 +8971,10 @@ type InstancesRestartCall struct {
// Restart: Restarts a Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance to be
-// restarted.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance to be
+// restarted.
func (r *InstancesService) Restart(project string, instance string) *InstancesRestartCall {
c := &InstancesRestartCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9100,9 +9118,9 @@ type InstancesRestoreBackupCall struct {
// RestoreBackup: Restores a backup of a Cloud SQL instance. Using this
// operation might cause your instance to restart.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) RestoreBackup(project string, instance string, instancesrestorebackuprequest *InstancesRestoreBackupRequest) *InstancesRestoreBackupCall {
c := &InstancesRestoreBackupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9256,9 +9274,9 @@ type InstancesRotateServerCaCall struct {
// Certificate Authority (CA) version previously added with the
// addServerCA method.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) RotateServerCa(project string, instance string, instancesrotateservercarequest *InstancesRotateServerCaRequest) *InstancesRotateServerCaCall {
c := &InstancesRotateServerCaCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9697,9 +9715,9 @@ type InstancesTruncateLogCall struct {
// TruncateLog: Truncate MySQL general and slow query log tables MySQL
// only.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the Cloud SQL project.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the Cloud SQL project.
func (r *InstancesService) TruncateLog(project string, instance string, instancestruncatelogrequest *InstancesTruncateLogRequest) *InstancesTruncateLogCall {
c := &InstancesTruncateLogCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9852,9 +9870,9 @@ type InstancesUpdateCall struct {
// Update: Updates settings of a Cloud SQL instance. Using this
// operation might cause your instance to restart.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Update(project string, instance string, databaseinstance *DatabaseInstance) *InstancesUpdateCall {
c := &InstancesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10372,9 +10390,9 @@ type ProjectsInstancesRescheduleMaintenanceCall struct {
// RescheduleMaintenance: Reschedules the maintenance on the given
// instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: ID of the project that contains the instance.
func (r *ProjectsInstancesService) RescheduleMaintenance(project string, instance string, sqlinstancesreschedulemaintenancerequestbody *SqlInstancesRescheduleMaintenanceRequestBody) *ProjectsInstancesRescheduleMaintenanceCall {
c := &ProjectsInstancesRescheduleMaintenanceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10526,9 +10544,9 @@ type ProjectsInstancesStartExternalSyncCall struct {
// StartExternalSync: Start External primary instance migration.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: ID of the project that contains the instance.
func (r *ProjectsInstancesService) StartExternalSync(project string, instance string, sqlinstancesstartexternalsyncrequest *SqlInstancesStartExternalSyncRequest) *ProjectsInstancesStartExternalSyncCall {
c := &ProjectsInstancesStartExternalSyncCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10681,9 +10699,9 @@ type ProjectsInstancesVerifyExternalSyncSettingsCall struct {
// VerifyExternalSyncSettings: Verify External primary instance external
// sync settings.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *ProjectsInstancesService) VerifyExternalSyncSettings(project string, instance string, sqlinstancesverifyexternalsyncsettingsrequest *SqlInstancesVerifyExternalSyncSettingsRequest) *ProjectsInstancesVerifyExternalSyncSettingsCall {
c := &ProjectsInstancesVerifyExternalSyncSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10840,9 +10858,9 @@ type SslCertsCreateEphemeralCall struct {
// target instance. Users may use the certificate to authenticate as
// themselves when connecting to the database.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the Cloud SQL project.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the Cloud SQL project.
func (r *SslCertsService) CreateEphemeral(project string, instance string, sslcertscreateephemeralrequest *SslCertsCreateEphemeralRequest) *SslCertsCreateEphemeralCall {
c := &SslCertsCreateEphemeralCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10995,10 +11013,10 @@ type SslCertsDeleteCall struct {
// Delete: Deletes the SSL certificate. For First Generation instances,
// the certificate remains valid until the instance is restarted.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
-// - sha1Fingerprint: Sha1 FingerPrint.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
+// - sha1Fingerprint: Sha1 FingerPrint.
func (r *SslCertsService) Delete(project string, instance string, sha1Fingerprint string) *SslCertsDeleteCall {
c := &SslCertsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11153,10 +11171,10 @@ type SslCertsGetCall struct {
// private key (required for usage). The private key must be saved from
// the response to initial creation.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
-// - sha1Fingerprint: Sha1 FingerPrint.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
+// - sha1Fingerprint: Sha1 FingerPrint.
func (r *SslCertsService) Get(project string, instance string, sha1Fingerprint string) *SslCertsGetCall {
c := &SslCertsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11323,9 +11341,9 @@ type SslCertsInsertCall struct {
// private key and server certificate authority. The new certificate
// will not be usable until the instance is restarted.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *SslCertsService) Insert(project string, instance string, sslcertsinsertrequest *SslCertsInsertRequest) *SslCertsInsertCall {
c := &SslCertsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11477,9 +11495,9 @@ type SslCertsListCall struct {
// List: Lists all of the current SSL certificates for the instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *SslCertsService) List(project string, instance string) *SslCertsListCall {
c := &SslCertsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11782,9 +11800,9 @@ type UsersDeleteCall struct {
// Delete: Deletes a user from a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Delete(project string, instance string) *UsersDeleteCall {
c := &UsersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11952,11 +11970,11 @@ type UsersGetCall struct {
// Get: Retrieves a resource containing information about a user.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - name: User of the instance. If the database user has a host, this
-// is specified as {username}@{host} else as {username}.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - name: User of the instance. If the database user has a host, this
+// is specified as {username}@{host} else as {username}.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Get(project string, instance string, name string) *UsersGetCall {
c := &UsersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -12121,9 +12139,9 @@ type UsersInsertCall struct {
// Insert: Creates a new user in a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Insert(project string, instance string, user *User) *UsersInsertCall {
c := &UsersInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -12275,9 +12293,9 @@ type UsersListCall struct {
// List: Lists users in the specified Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) List(project string, instance string) *UsersListCall {
c := &UsersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -12433,9 +12451,9 @@ type UsersUpdateCall struct {
// Update: Updates an existing user in a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Update(project string, instance string, user *User) *UsersUpdateCall {
c := &UsersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
diff --git a/sqladmin/v1beta4/sqladmin-api.json b/sqladmin/v1beta4/sqladmin-api.json
index 29841ff81a2..358e1757f6a 100644
--- a/sqladmin/v1beta4/sqladmin-api.json
+++ b/sqladmin/v1beta4/sqladmin-api.json
@@ -1916,7 +1916,7 @@
}
}
},
- "revision": "20220724",
+ "revision": "20220804",
"rootUrl": "https://sqladmin.googleapis.com/",
"schemas": {
"AclEntry": {
@@ -4068,6 +4068,20 @@
"description": "The name of server Instance collation.",
"type": "string"
},
+ "connectorEnforcement": {
+ "description": "Specifies if connections must use Cloud SQL connectors. Option values include the following: * `NOT_REQUIRED`: Cloud SQL instances can be connected without Cloud SQL Connectors. * `REQUIRED`: Only allow connections that use Cloud SQL Connectors. Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance.",
+ "enum": [
+ "CONNECTOR_ENFORCEMENT_UNSPECIFIED",
+ "NOT_REQUIRED",
+ "REQUIRED"
+ ],
+ "enumDescriptions": [
+ "The requirement for Cloud SQL connectors is unknown.",
+ "Do not require Cloud SQL connectors.",
+ "Require all connections to use Cloud SQL connectors, including the Cloud SQL Auth Proxy and Cloud SQL Java, Python, and Go connectors. Note: This disables all existing authorized networks."
+ ],
+ "type": "string"
+ },
"crashSafeReplicationEnabled": {
"description": "Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances.",
"type": "boolean"
diff --git a/sqladmin/v1beta4/sqladmin-gen.go b/sqladmin/v1beta4/sqladmin-gen.go
index dd71b9c6163..a5918011cb5 100644
--- a/sqladmin/v1beta4/sqladmin-gen.go
+++ b/sqladmin/v1beta4/sqladmin-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/cloud-sql/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sqladmin/v1beta4"
-// ...
-// ctx := context.Background()
-// sqladminService, err := sqladmin.NewService(ctx)
+// import "google.golang.org/api/sqladmin/v1beta4"
+// ...
+// ctx := context.Background()
+// sqladminService, err := sqladmin.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// sqladminService, err := sqladmin.NewService(ctx, option.WithScopes(sqladmin.SqlserviceAdminScope))
+// sqladminService, err := sqladmin.NewService(ctx, option.WithScopes(sqladmin.SqlserviceAdminScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// sqladminService, err := sqladmin.NewService(ctx, option.WithAPIKey("AIza..."))
+// sqladminService, err := sqladmin.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// sqladminService, err := sqladmin.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// sqladminService, err := sqladmin.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sqladmin // import "google.golang.org/api/sqladmin/v1beta4"
@@ -3456,6 +3456,24 @@ type Settings struct {
// Collation: The name of server Instance collation.
Collation string `json:"collation,omitempty"`
+ // ConnectorEnforcement: Specifies if connections must use Cloud SQL
+ // connectors. Option values include the following: * `NOT_REQUIRED`:
+ // Cloud SQL instances can be connected without Cloud SQL Connectors. *
+ // `REQUIRED`: Only allow connections that use Cloud SQL Connectors.
+ // Note that using REQUIRED disables all existing authorized networks.
+ // If this field is not specified when creating a new instance,
+ // NOT_REQUIRED is used. If this field is not specified when patching or
+ // updating an existing instance, it is left unchanged in the instance.
+ //
+ // Possible values:
+ // "CONNECTOR_ENFORCEMENT_UNSPECIFIED" - The requirement for Cloud SQL
+ // connectors is unknown.
+ // "NOT_REQUIRED" - Do not require Cloud SQL connectors.
+ // "REQUIRED" - Require all connections to use Cloud SQL connectors,
+ // including the Cloud SQL Auth Proxy and Cloud SQL Java, Python, and Go
+ // connectors. Note: This disables all existing authorized networks.
+ ConnectorEnforcement string `json:"connectorEnforcement,omitempty"`
+
// CrashSafeReplicationEnabled: Configuration specific to read replica
// instances. Indicates whether database flags for crash-safe
// replication are enabled. This property was only applicable to First
@@ -4621,13 +4639,13 @@ type BackupRunsDeleteCall struct {
// Delete: Deletes the backup taken by a backup run.
//
-// - id: The ID of the backup run to delete. To find a backup run ID,
-// use the list
-// (https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/backupRuns/list)
-// method.
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - id: The ID of the backup run to delete. To find a backup run ID,
+// use the list
+// (https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/backupRuns/list)
+// method.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) Delete(project string, instance string, id int64) *BackupRunsDeleteCall {
c := &BackupRunsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -4781,10 +4799,10 @@ type BackupRunsGetCall struct {
// Get: Retrieves a resource containing information about a backup run.
//
-// - id: The ID of this backup run.
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - id: The ID of this backup run.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) Get(project string, instance string, id int64) *BackupRunsGetCall {
c := &BackupRunsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -4950,9 +4968,9 @@ type BackupRunsInsertCall struct {
// Insert: Creates a new backup run on demand.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) Insert(project string, instance string, backuprun *BackupRun) *BackupRunsInsertCall {
c := &BackupRunsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5106,9 +5124,9 @@ type BackupRunsListCall struct {
// instance and configuration in the reverse chronological order of the
// backup initiation time.
//
-// - instance: Cloud SQL instance ID, or "-" for all instances. This
-// does not include the project ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID, or "-" for all instances. This
+// does not include the project ID.
+// - project: Project ID of the project that contains the instance.
func (r *BackupRunsService) List(project string, instance string) *BackupRunsListCall {
c := &BackupRunsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5314,9 +5332,9 @@ type ConnectGenerateEphemeralCertCall struct {
// specific to the target instance. Users may use the certificate to
// authenticate as themselves when connecting to the database.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *ConnectService) GenerateEphemeralCert(project string, instance string, generateephemeralcertrequest *GenerateEphemeralCertRequest) *ConnectGenerateEphemeralCertCall {
c := &ConnectGenerateEphemeralCertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5468,9 +5486,9 @@ type ConnectGetCall struct {
// Get: Retrieves connect settings about a Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *ConnectService) Get(project string, instance string) *ConnectGetCall {
c := &ConnectGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5639,10 +5657,10 @@ type DatabasesDeleteCall struct {
// Delete: Deletes a database from a Cloud SQL instance.
//
-// - database: Name of the database to be deleted in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database to be deleted in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Delete(project string, instance string, database string) *DatabasesDeleteCall {
c := &DatabasesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5796,10 +5814,10 @@ type DatabasesGetCall struct {
// Get: Retrieves a resource containing information about a database
// inside a Cloud SQL instance.
//
-// - database: Name of the database in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Get(project string, instance string, database string) *DatabasesGetCall {
c := &DatabasesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -5965,9 +5983,9 @@ type DatabasesInsertCall struct {
// Insert: Inserts a resource containing information about a database
// inside a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Insert(project string, instance string, database *Database) *DatabasesInsertCall {
c := &DatabasesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6119,9 +6137,9 @@ type DatabasesListCall struct {
// List: Lists databases in the specified Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) List(project string, instance string) *DatabasesListCall {
c := &DatabasesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6280,10 +6298,10 @@ type DatabasesPatchCall struct {
// database inside a Cloud SQL instance. This method supports patch
// semantics.
//
-// - database: Name of the database to be updated in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database to be updated in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Patch(project string, instance string, database string, database2 *Database) *DatabasesPatchCall {
c := &DatabasesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6446,10 +6464,10 @@ type DatabasesUpdateCall struct {
// Update: Updates a resource containing information about a database
// inside a Cloud SQL instance.
//
-// - database: Name of the database to be updated in the instance.
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - database: Name of the database to be updated in the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *DatabasesService) Update(project string, instance string, database string, database2 *Database) *DatabasesUpdateCall {
c := &DatabasesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6757,9 +6775,9 @@ type InstancesAddServerCaCall struct {
// certificate rotation, this operation replaces that version. There
// cannot be more than one CA version waiting to be rotated in.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) AddServerCa(project string, instance string) *InstancesAddServerCaCall {
c := &InstancesAddServerCaCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -6903,10 +6921,10 @@ type InstancesCloneCall struct {
// Clone: Creates a Cloud SQL instance as a clone of the source
// instance. Using this operation might cause your instance to restart.
//
-// - instance: The ID of the Cloud SQL instance to be cloned (source).
-// This does not include the project ID.
-// - project: Project ID of the source as well as the clone Cloud SQL
-// instance.
+// - instance: The ID of the Cloud SQL instance to be cloned (source).
+// This does not include the project ID.
+// - project: Project ID of the source as well as the clone Cloud SQL
+// instance.
func (r *InstancesService) Clone(project string, instance string, instancesclonerequest *InstancesCloneRequest) *InstancesCloneCall {
c := &InstancesCloneCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7057,10 +7075,10 @@ type InstancesDeleteCall struct {
// Delete: Deletes a Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance to be
-// deleted.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance to be
+// deleted.
func (r *InstancesService) Delete(project string, instance string) *InstancesDeleteCall {
c := &InstancesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7358,10 +7376,10 @@ type InstancesExportCall struct {
// Export: Exports data from a Cloud SQL instance to a Cloud Storage
// bucket as a SQL dump or CSV file.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance to be
-// exported.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance to be
+// exported.
func (r *InstancesService) Export(project string, instance string, instancesexportrequest *InstancesExportRequest) *InstancesExportCall {
c := &InstancesExportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7518,9 +7536,9 @@ type InstancesFailoverCall struct {
// the Cloud SQL documentation. If using Legacy HA (MySQL only), this
// causes the instance to failover to its failover replica instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: ID of the project that contains the read replica.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: ID of the project that contains the read replica.
func (r *InstancesService) Failover(project string, instance string, instancesfailoverrequest *InstancesFailoverRequest) *InstancesFailoverCall {
c := &InstancesFailoverCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7673,9 +7691,9 @@ type InstancesGetCall struct {
// Get: Retrieves a resource containing information about a Cloud SQL
// instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Get(project string, instance string) *InstancesGetCall {
c := &InstancesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7832,9 +7850,9 @@ type InstancesImportCall struct {
// Import: Imports data into a Cloud SQL instance from a SQL dump or CSV
// file in Cloud Storage.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Import(project string, instance string, instancesimportrequest *InstancesImportRequest) *InstancesImportCall {
c := &InstancesImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -7984,8 +8002,8 @@ type InstancesInsertCall struct {
// Insert: Creates a new Cloud SQL instance.
//
-// - project: Project ID of the project to which the newly created Cloud
-// SQL instances should belong.
+// - project: Project ID of the project to which the newly created Cloud
+// SQL instances should belong.
func (r *InstancesService) Insert(project string, databaseinstance *DatabaseInstance) *InstancesInsertCall {
c := &InstancesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8127,8 +8145,8 @@ type InstancesListCall struct {
// List: Lists instances under a given project.
//
-// - project: Project ID of the project for which to list Cloud SQL
-// instances.
+// - project: Project ID of the project for which to list Cloud SQL
+// instances.
func (r *InstancesService) List(project string) *InstancesListCall {
c := &InstancesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8347,9 +8365,9 @@ type InstancesListServerCasCall struct {
// CA that has been added but not yet used to sign a certificate, and a
// CA used to sign a certificate that has previously rotated out.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) ListServerCas(project string, instance string) *InstancesListServerCasCall {
c := &InstancesListServerCasCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8506,9 +8524,9 @@ type InstancesPatchCall struct {
// Patch: Updates settings of a Cloud SQL instance. This method supports
// patch semantics.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Patch(project string, instance string, databaseinstance *DatabaseInstance) *InstancesPatchCall {
c := &InstancesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8805,9 +8823,9 @@ type InstancesResetSslConfigCall struct {
// ResetSslConfig: Deletes all client certificates and generates a new
// server SSL certificate for the instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) ResetSslConfig(project string, instance string) *InstancesResetSslConfigCall {
c := &InstancesResetSslConfigCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -8949,10 +8967,10 @@ type InstancesRestartCall struct {
// Restart: Restarts a Cloud SQL instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance to be
-// restarted.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance to be
+// restarted.
func (r *InstancesService) Restart(project string, instance string) *InstancesRestartCall {
c := &InstancesRestartCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9096,9 +9114,9 @@ type InstancesRestoreBackupCall struct {
// RestoreBackup: Restores a backup of a Cloud SQL instance. Using this
// operation might cause your instance to restart.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) RestoreBackup(project string, instance string, instancesrestorebackuprequest *InstancesRestoreBackupRequest) *InstancesRestoreBackupCall {
c := &InstancesRestoreBackupCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9252,9 +9270,9 @@ type InstancesRotateServerCaCall struct {
// Certificate Authority (CA) version previously added with the
// addServerCA method.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) RotateServerCa(project string, instance string, instancesrotateservercarequest *InstancesRotateServerCaRequest) *InstancesRotateServerCaCall {
c := &InstancesRotateServerCaCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9693,9 +9711,9 @@ type InstancesTruncateLogCall struct {
// TruncateLog: Truncate MySQL general and slow query log tables MySQL
// only.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the Cloud SQL project.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the Cloud SQL project.
func (r *InstancesService) TruncateLog(project string, instance string, instancestruncatelogrequest *InstancesTruncateLogRequest) *InstancesTruncateLogCall {
c := &InstancesTruncateLogCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -9848,9 +9866,9 @@ type InstancesUpdateCall struct {
// Update: Updates settings of a Cloud SQL instance. Using this
// operation might cause your instance to restart.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *InstancesService) Update(project string, instance string, databaseinstance *DatabaseInstance) *InstancesUpdateCall {
c := &InstancesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10368,9 +10386,9 @@ type ProjectsInstancesRescheduleMaintenanceCall struct {
// RescheduleMaintenance: Reschedules the maintenance on the given
// instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: ID of the project that contains the instance.
func (r *ProjectsInstancesService) RescheduleMaintenance(project string, instance string, sqlinstancesreschedulemaintenancerequestbody *SqlInstancesRescheduleMaintenanceRequestBody) *ProjectsInstancesRescheduleMaintenanceCall {
c := &ProjectsInstancesRescheduleMaintenanceCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10522,9 +10540,9 @@ type ProjectsInstancesStartExternalSyncCall struct {
// StartExternalSync: Start External primary instance migration.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: ID of the project that contains the instance.
func (r *ProjectsInstancesService) StartExternalSync(project string, instance string, sqlinstancesstartexternalsyncrequest *SqlInstancesStartExternalSyncRequest) *ProjectsInstancesStartExternalSyncCall {
c := &ProjectsInstancesStartExternalSyncCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10677,9 +10695,9 @@ type ProjectsInstancesVerifyExternalSyncSettingsCall struct {
// VerifyExternalSyncSettings: Verify External primary instance external
// sync settings.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *ProjectsInstancesService) VerifyExternalSyncSettings(project string, instance string, sqlinstancesverifyexternalsyncsettingsrequest *SqlInstancesVerifyExternalSyncSettingsRequest) *ProjectsInstancesVerifyExternalSyncSettingsCall {
c := &ProjectsInstancesVerifyExternalSyncSettingsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10836,9 +10854,9 @@ type SslCertsCreateEphemeralCall struct {
// target instance. Users may use the certificate to authenticate as
// themselves when connecting to the database.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the Cloud SQL project.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the Cloud SQL project.
func (r *SslCertsService) CreateEphemeral(project string, instance string, sslcertscreateephemeralrequest *SslCertsCreateEphemeralRequest) *SslCertsCreateEphemeralCall {
c := &SslCertsCreateEphemeralCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -10991,10 +11009,10 @@ type SslCertsDeleteCall struct {
// Delete: Deletes the SSL certificate. For First Generation instances,
// the certificate remains valid until the instance is restarted.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
-// - sha1Fingerprint: Sha1 FingerPrint.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
+// - sha1Fingerprint: Sha1 FingerPrint.
func (r *SslCertsService) Delete(project string, instance string, sha1Fingerprint string) *SslCertsDeleteCall {
c := &SslCertsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11149,10 +11167,10 @@ type SslCertsGetCall struct {
// private key (required for usage). The private key must be saved from
// the response to initial creation.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
-// - sha1Fingerprint: Sha1 FingerPrint.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
+// - sha1Fingerprint: Sha1 FingerPrint.
func (r *SslCertsService) Get(project string, instance string, sha1Fingerprint string) *SslCertsGetCall {
c := &SslCertsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11319,9 +11337,9 @@ type SslCertsInsertCall struct {
// private key and server certificate authority. The new certificate
// will not be usable until the instance is restarted.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *SslCertsService) Insert(project string, instance string, sslcertsinsertrequest *SslCertsInsertRequest) *SslCertsInsertCall {
c := &SslCertsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11473,9 +11491,9 @@ type SslCertsListCall struct {
// List: Lists all of the current SSL certificates for the instance.
//
-// - instance: Cloud SQL instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Cloud SQL instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *SslCertsService) List(project string, instance string) *SslCertsListCall {
c := &SslCertsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11778,9 +11796,9 @@ type UsersDeleteCall struct {
// Delete: Deletes a user from a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Delete(project string, instance string) *UsersDeleteCall {
c := &UsersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -11948,11 +11966,11 @@ type UsersGetCall struct {
// Get: Retrieves a resource containing information about a user.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - name: User of the instance. If the database user has a host, this
-// is specified as {username}@{host} else as {username}.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - name: User of the instance. If the database user has a host, this
+// is specified as {username}@{host} else as {username}.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Get(project string, instance string, name string) *UsersGetCall {
c := &UsersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -12117,9 +12135,9 @@ type UsersInsertCall struct {
// Insert: Creates a new user in a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Insert(project string, instance string, user *User) *UsersInsertCall {
c := &UsersInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -12271,9 +12289,9 @@ type UsersListCall struct {
// List: Lists users in the specified Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) List(project string, instance string) *UsersListCall {
c := &UsersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
@@ -12429,9 +12447,9 @@ type UsersUpdateCall struct {
// Update: Updates an existing user in a Cloud SQL instance.
//
-// - instance: Database instance ID. This does not include the project
-// ID.
-// - project: Project ID of the project that contains the instance.
+// - instance: Database instance ID. This does not include the project
+// ID.
+// - project: Project ID of the project that contains the instance.
func (r *UsersService) Update(project string, instance string, user *User) *UsersUpdateCall {
c := &UsersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.project = project
diff --git a/storage/v1/storage-gen.go b/storage/v1/storage-gen.go
index 353367a7c1b..35cea853eb1 100644
--- a/storage/v1/storage-gen.go
+++ b/storage/v1/storage-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://developers.google.com/storage/docs/json_api/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/storage/v1"
-// ...
-// ctx := context.Background()
-// storageService, err := storage.NewService(ctx)
+// import "google.golang.org/api/storage/v1"
+// ...
+// ctx := context.Background()
+// storageService, err := storage.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// storageService, err := storage.NewService(ctx, option.WithScopes(storage.DevstorageReadWriteScope))
+// storageService, err := storage.NewService(ctx, option.WithScopes(storage.DevstorageReadWriteScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// storageService, err := storage.NewService(ctx, option.WithAPIKey("AIza..."))
+// storageService, err := storage.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// storageService, err := storage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// storageService, err := storage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package storage // import "google.golang.org/api/storage/v1"
@@ -822,7 +822,7 @@ func (s *BucketLifecycleRuleAction) MarshalJSON() ([]byte, error) {
type BucketLifecycleRuleCondition struct {
// Age: Age of an object (in days). This condition is satisfied when an
// object reaches the specified age.
- Age int64 `json:"age,omitempty"`
+ Age *int64 `json:"age,omitempty"`
// CreatedBefore: A date in RFC 3339 format with only the date part (for
// instance, "2013-01-15"). This condition is satisfied when an object
@@ -2484,10 +2484,10 @@ type BucketAccessControlsDeleteCall struct {
// Delete: Permanently deletes the ACL entry for the specified entity on
// the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *BucketAccessControlsService) Delete(bucket string, entity string) *BucketAccessControlsDeleteCall {
c := &BucketAccessControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -2614,10 +2614,10 @@ type BucketAccessControlsGetCall struct {
// Get: Returns the ACL entry for the specified entity on the specified
// bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *BucketAccessControlsService) Get(bucket string, entity string) *BucketAccessControlsGetCall {
c := &BucketAccessControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -3094,10 +3094,10 @@ type BucketAccessControlsPatchCall struct {
// Patch: Patches an ACL entry on the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *BucketAccessControlsService) Patch(bucket string, entity string, bucketaccesscontrol *BucketAccessControl) *BucketAccessControlsPatchCall {
c := &BucketAccessControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -3260,10 +3260,10 @@ type BucketAccessControlsUpdateCall struct {
// Update: Updates an ACL entry on the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *BucketAccessControlsService) Update(bucket string, entity string, bucketaccesscontrol *BucketAccessControl) *BucketAccessControlsUpdateCall {
c := &BucketAccessControlsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -3598,8 +3598,9 @@ func (c *BucketsGetCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch int64
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
func (c *BucketsGetCall) Projection(projection string) *BucketsGetCall {
c.urlParams_.Set("projection", projection)
return c
@@ -3968,14 +3969,22 @@ func (r *BucketsService) Insert(projectid string, bucket *Bucket) *BucketsInsert
// predefined set of access controls to this bucket.
//
// Possible values:
-// "authenticatedRead" - Project team owners get OWNER access, and
+//
+// "authenticatedRead" - Project team owners get OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "private" - Project team owners get OWNER access.
-// "projectPrivate" - Project team members get access according to
+//
+// "private" - Project team owners get OWNER access.
+// "projectPrivate" - Project team members get access according to
+//
// their roles.
-// "publicRead" - Project team owners get OWNER access, and allUsers
+//
+// "publicRead" - Project team owners get OWNER access, and allUsers
+//
// get READER access.
-// "publicReadWrite" - Project team owners get OWNER access, and
+//
+// "publicReadWrite" - Project team owners get OWNER access, and
+//
// allUsers get WRITER access.
func (c *BucketsInsertCall) PredefinedAcl(predefinedAcl string) *BucketsInsertCall {
c.urlParams_.Set("predefinedAcl", predefinedAcl)
@@ -3987,16 +3996,26 @@ func (c *BucketsInsertCall) PredefinedAcl(predefinedAcl string) *BucketsInsertCa
// object access controls to this bucket.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *BucketsInsertCall) PredefinedDefaultObjectAcl(predefinedDefaultObjectAcl string) *BucketsInsertCall {
c.urlParams_.Set("predefinedDefaultObjectAcl", predefinedDefaultObjectAcl)
@@ -4009,8 +4028,9 @@ func (c *BucketsInsertCall) PredefinedDefaultObjectAcl(predefinedDefaultObjectAc
// full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
func (c *BucketsInsertCall) Projection(projection string) *BucketsInsertCall {
c.urlParams_.Set("projection", projection)
return c
@@ -4245,8 +4265,9 @@ func (c *BucketsListCall) Prefix(prefix string) *BucketsListCall {
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
func (c *BucketsListCall) Projection(projection string) *BucketsListCall {
c.urlParams_.Set("projection", projection)
return c
@@ -4453,9 +4474,9 @@ type BucketsLockRetentionPolicyCall struct {
// LockRetentionPolicy: Locks retention policy on a bucket.
//
-// - bucket: Name of a bucket.
-// - ifMetagenerationMatch: Makes the operation conditional on whether
-// bucket's current metageneration matches the given value.
+// - bucket: Name of a bucket.
+// - ifMetagenerationMatch: Makes the operation conditional on whether
+// bucket's current metageneration matches the given value.
func (r *BucketsService) LockRetentionPolicy(bucket string, ifMetagenerationMatch int64) *BucketsLockRetentionPolicyCall {
c := &BucketsLockRetentionPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -4641,14 +4662,22 @@ func (c *BucketsPatchCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch int
// predefined set of access controls to this bucket.
//
// Possible values:
-// "authenticatedRead" - Project team owners get OWNER access, and
+//
+// "authenticatedRead" - Project team owners get OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "private" - Project team owners get OWNER access.
-// "projectPrivate" - Project team members get access according to
+//
+// "private" - Project team owners get OWNER access.
+// "projectPrivate" - Project team members get access according to
+//
// their roles.
-// "publicRead" - Project team owners get OWNER access, and allUsers
+//
+// "publicRead" - Project team owners get OWNER access, and allUsers
+//
// get READER access.
-// "publicReadWrite" - Project team owners get OWNER access, and
+//
+// "publicReadWrite" - Project team owners get OWNER access, and
+//
// allUsers get WRITER access.
func (c *BucketsPatchCall) PredefinedAcl(predefinedAcl string) *BucketsPatchCall {
c.urlParams_.Set("predefinedAcl", predefinedAcl)
@@ -4660,16 +4689,26 @@ func (c *BucketsPatchCall) PredefinedAcl(predefinedAcl string) *BucketsPatchCall
// object access controls to this bucket.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *BucketsPatchCall) PredefinedDefaultObjectAcl(predefinedDefaultObjectAcl string) *BucketsPatchCall {
c.urlParams_.Set("predefinedDefaultObjectAcl", predefinedDefaultObjectAcl)
@@ -4680,8 +4719,9 @@ func (c *BucketsPatchCall) PredefinedDefaultObjectAcl(predefinedDefaultObjectAcl
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
func (c *BucketsPatchCall) Projection(projection string) *BucketsPatchCall {
c.urlParams_.Set("projection", projection)
return c
@@ -5253,14 +5293,22 @@ func (c *BucketsUpdateCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch in
// predefined set of access controls to this bucket.
//
// Possible values:
-// "authenticatedRead" - Project team owners get OWNER access, and
+//
+// "authenticatedRead" - Project team owners get OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "private" - Project team owners get OWNER access.
-// "projectPrivate" - Project team members get access according to
+//
+// "private" - Project team owners get OWNER access.
+// "projectPrivate" - Project team members get access according to
+//
// their roles.
-// "publicRead" - Project team owners get OWNER access, and allUsers
+//
+// "publicRead" - Project team owners get OWNER access, and allUsers
+//
// get READER access.
-// "publicReadWrite" - Project team owners get OWNER access, and
+//
+// "publicReadWrite" - Project team owners get OWNER access, and
+//
// allUsers get WRITER access.
func (c *BucketsUpdateCall) PredefinedAcl(predefinedAcl string) *BucketsUpdateCall {
c.urlParams_.Set("predefinedAcl", predefinedAcl)
@@ -5272,16 +5320,26 @@ func (c *BucketsUpdateCall) PredefinedAcl(predefinedAcl string) *BucketsUpdateCa
// object access controls to this bucket.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *BucketsUpdateCall) PredefinedDefaultObjectAcl(predefinedDefaultObjectAcl string) *BucketsUpdateCall {
c.urlParams_.Set("predefinedDefaultObjectAcl", predefinedDefaultObjectAcl)
@@ -5292,8 +5350,9 @@ func (c *BucketsUpdateCall) PredefinedDefaultObjectAcl(predefinedDefaultObjectAc
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit owner, acl and defaultObjectAcl properties.
func (c *BucketsUpdateCall) Projection(projection string) *BucketsUpdateCall {
c.urlParams_.Set("projection", projection)
return c
@@ -5609,10 +5668,10 @@ type DefaultObjectAccessControlsDeleteCall struct {
// Delete: Permanently deletes the default object ACL entry for the
// specified entity on the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *DefaultObjectAccessControlsService) Delete(bucket string, entity string) *DefaultObjectAccessControlsDeleteCall {
c := &DefaultObjectAccessControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -5739,10 +5798,10 @@ type DefaultObjectAccessControlsGetCall struct {
// Get: Returns the default object ACL entry for the specified entity on
// the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *DefaultObjectAccessControlsService) Get(bucket string, entity string) *DefaultObjectAccessControlsGetCall {
c := &DefaultObjectAccessControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -6249,10 +6308,10 @@ type DefaultObjectAccessControlsPatchCall struct {
// Patch: Patches a default object ACL entry on the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *DefaultObjectAccessControlsService) Patch(bucket string, entity string, objectaccesscontrol *ObjectAccessControl) *DefaultObjectAccessControlsPatchCall {
c := &DefaultObjectAccessControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -6415,10 +6474,10 @@ type DefaultObjectAccessControlsUpdateCall struct {
// Update: Updates a default object ACL entry on the specified bucket.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
func (r *DefaultObjectAccessControlsService) Update(bucket string, entity string, objectaccesscontrol *ObjectAccessControl) *DefaultObjectAccessControlsUpdateCall {
c := &DefaultObjectAccessControlsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -7195,12 +7254,12 @@ type ObjectAccessControlsDeleteCall struct {
// Delete: Permanently deletes the ACL entry for the specified entity on
// the specified object.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectAccessControlsService) Delete(bucket string, object string, entity string) *ObjectAccessControlsDeleteCall {
c := &ObjectAccessControlsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -7351,12 +7410,12 @@ type ObjectAccessControlsGetCall struct {
// Get: Returns the ACL entry for the specified entity on the specified
// object.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectAccessControlsService) Get(bucket string, object string, entity string) *ObjectAccessControlsGetCall {
c := &ObjectAccessControlsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -7546,9 +7605,9 @@ type ObjectAccessControlsInsertCall struct {
// Insert: Creates a new ACL entry on the specified object.
//
-// - bucket: Name of a bucket.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of a bucket.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectAccessControlsService) Insert(bucket string, object string, objectaccesscontrol *ObjectAccessControl) *ObjectAccessControlsInsertCall {
c := &ObjectAccessControlsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -7725,9 +7784,9 @@ type ObjectAccessControlsListCall struct {
// List: Retrieves ACL entries on the specified object.
//
-// - bucket: Name of a bucket.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of a bucket.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectAccessControlsService) List(bucket string, object string) *ObjectAccessControlsListCall {
c := &ObjectAccessControlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -7909,12 +7968,12 @@ type ObjectAccessControlsPatchCall struct {
// Patch: Patches an ACL entry on the specified object.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectAccessControlsService) Patch(bucket string, object string, entity string, objectaccesscontrol *ObjectAccessControl) *ObjectAccessControlsPatchCall {
c := &ObjectAccessControlsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -8101,12 +8160,12 @@ type ObjectAccessControlsUpdateCall struct {
// Update: Updates an ACL entry on the specified object.
//
-// - bucket: Name of a bucket.
-// - entity: The entity holding the permission. Can be user-userId,
-// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
-// allAuthenticatedUsers.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of a bucket.
+// - entity: The entity holding the permission. Can be user-userId,
+// user-emailAddress, group-groupId, group-emailAddress, allUsers, or
+// allAuthenticatedUsers.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectAccessControlsService) Update(bucket string, object string, entity string, objectaccesscontrol *ObjectAccessControl) *ObjectAccessControlsUpdateCall {
c := &ObjectAccessControlsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -8293,11 +8352,11 @@ type ObjectsComposeCall struct {
// Compose: Concatenates a list of existing objects into a new object in
// the same bucket.
//
-// - destinationBucket: Name of the bucket containing the source
-// objects. The destination object is stored in this bucket.
-// - destinationObject: Name of the new object. For information about
-// how to URL encode object names to be path safe, see Encoding URI
-// Path Parts.
+// - destinationBucket: Name of the bucket containing the source
+// objects. The destination object is stored in this bucket.
+// - destinationObject: Name of the new object. For information about
+// how to URL encode object names to be path safe, see Encoding URI
+// Path Parts.
func (r *ObjectsService) Compose(destinationBucket string, destinationObject string, composerequest *ComposeRequest) *ObjectsComposeCall {
c := &ObjectsComposeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.destinationBucket = destinationBucket
@@ -8311,16 +8370,26 @@ func (r *ObjectsService) Compose(destinationBucket string, destinationObject str
// to the destination object.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *ObjectsComposeCall) DestinationPredefinedAcl(destinationPredefinedAcl string) *ObjectsComposeCall {
c.urlParams_.Set("destinationPredefinedAcl", destinationPredefinedAcl)
@@ -8347,7 +8416,9 @@ func (c *ObjectsComposeCall) IfMetagenerationMatch(ifMetagenerationMatch int64)
// KmsKeyName sets the optional parameter "kmsKeyName": Resource name of
// the Cloud KMS key, of the form
// projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key,
-// that will be used to encrypt the object. Overrides the object
+//
+// that will be used to encrypt the object. Overrides the object
+//
// metadata's kms_key_name value, if any.
func (c *ObjectsComposeCall) KmsKeyName(kmsKeyName string) *ObjectsComposeCall {
c.urlParams_.Set("kmsKeyName", kmsKeyName)
@@ -8550,18 +8621,18 @@ type ObjectsCopyCall struct {
// Copy: Copies a source object to a destination object. Optionally
// overrides metadata.
//
-// - destinationBucket: Name of the bucket in which to store the new
-// object. Overrides the provided object metadata's bucket value, if
-// any.For information about how to URL encode object names to be path
-// safe, see Encoding URI Path Parts.
-// - destinationObject: Name of the new object. Required when the object
-// metadata is not otherwise provided. Overrides the object metadata's
-// name value, if any.
-// - sourceBucket: Name of the bucket in which to find the source
-// object.
-// - sourceObject: Name of the source object. For information about how
-// to URL encode object names to be path safe, see Encoding URI Path
-// Parts.
+// - destinationBucket: Name of the bucket in which to store the new
+// object. Overrides the provided object metadata's bucket value, if
+// any.For information about how to URL encode object names to be path
+// safe, see Encoding URI Path Parts.
+// - destinationObject: Name of the new object. Required when the object
+// metadata is not otherwise provided. Overrides the object metadata's
+// name value, if any.
+// - sourceBucket: Name of the bucket in which to find the source
+// object.
+// - sourceObject: Name of the source object. For information about how
+// to URL encode object names to be path safe, see Encoding URI Path
+// Parts.
func (r *ObjectsService) Copy(sourceBucket string, sourceObject string, destinationBucket string, destinationObject string, object *Object) *ObjectsCopyCall {
c := &ObjectsCopyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.sourceBucket = sourceBucket
@@ -8576,7 +8647,9 @@ func (r *ObjectsService) Copy(sourceBucket string, sourceObject string, destinat
// "destinationKmsKeyName": Resource name of the Cloud KMS key, of the
// form
// projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key,
-// that will be used to encrypt the object. Overrides the object
+//
+// that will be used to encrypt the object. Overrides the object
+//
// metadata's kms_key_name value, if any.
func (c *ObjectsCopyCall) DestinationKmsKeyName(destinationKmsKeyName string) *ObjectsCopyCall {
c.urlParams_.Set("destinationKmsKeyName", destinationKmsKeyName)
@@ -8588,16 +8661,26 @@ func (c *ObjectsCopyCall) DestinationKmsKeyName(destinationKmsKeyName string) *O
// to the destination object.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *ObjectsCopyCall) DestinationPredefinedAcl(destinationPredefinedAcl string) *ObjectsCopyCall {
c.urlParams_.Set("destinationPredefinedAcl", destinationPredefinedAcl)
@@ -8682,8 +8765,9 @@ func (c *ObjectsCopyCall) IfSourceMetagenerationNotMatch(ifSourceMetagenerationN
// specifies the acl property, when it defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsCopyCall) Projection(projection string) *ObjectsCopyCall {
c.urlParams_.Set("projection", projection)
return c
@@ -8962,9 +9046,9 @@ type ObjectsDeleteCall struct {
// if versioning is not enabled for the bucket, or if the generation
// parameter is used.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectsService) Delete(bucket string, object string) *ObjectsDeleteCall {
c := &ObjectsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -9165,9 +9249,9 @@ type ObjectsGetCall struct {
// Get: Retrieves an object or its metadata.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectsService) Get(bucket string, object string) *ObjectsGetCall {
c := &ObjectsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -9223,8 +9307,9 @@ func (c *ObjectsGetCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch int64
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsGetCall) Projection(projection string) *ObjectsGetCall {
c.urlParams_.Set("projection", projection)
return c
@@ -9453,9 +9538,9 @@ type ObjectsGetIamPolicyCall struct {
// GetIamPolicy: Returns an IAM policy for the specified object.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectsService) GetIamPolicy(bucket string, object string) *ObjectsGetIamPolicyCall {
c := &ObjectsGetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -9640,8 +9725,8 @@ type ObjectsInsertCall struct {
// Insert: Stores a new object and metadata.
//
-// - bucket: Name of the bucket in which to store the new object.
-// Overrides the provided object metadata's bucket value, if any.
+// - bucket: Name of the bucket in which to store the new object.
+// Overrides the provided object metadata's bucket value, if any.
func (r *ObjectsService) Insert(bucket string, object *Object) *ObjectsInsertCall {
c := &ObjectsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -9699,7 +9784,9 @@ func (c *ObjectsInsertCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch in
// KmsKeyName sets the optional parameter "kmsKeyName": Resource name of
// the Cloud KMS key, of the form
// projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key,
-// that will be used to encrypt the object. Overrides the object
+//
+// that will be used to encrypt the object. Overrides the object
+//
// metadata's kms_key_name value, if any.
func (c *ObjectsInsertCall) KmsKeyName(kmsKeyName string) *ObjectsInsertCall {
c.urlParams_.Set("kmsKeyName", kmsKeyName)
@@ -9719,16 +9806,26 @@ func (c *ObjectsInsertCall) Name(name string) *ObjectsInsertCall {
// predefined set of access controls to this object.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *ObjectsInsertCall) PredefinedAcl(predefinedAcl string) *ObjectsInsertCall {
c.urlParams_.Set("predefinedAcl", predefinedAcl)
@@ -9740,8 +9837,9 @@ func (c *ObjectsInsertCall) PredefinedAcl(predefinedAcl string) *ObjectsInsertCa
// specifies the acl property, when it defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsInsertCall) Projection(projection string) *ObjectsInsertCall {
c.urlParams_.Set("projection", projection)
return c
@@ -10147,8 +10245,9 @@ func (c *ObjectsListCall) Prefix(prefix string) *ObjectsListCall {
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsListCall) Projection(projection string) *ObjectsListCall {
c.urlParams_.Set("projection", projection)
return c
@@ -10403,9 +10502,9 @@ type ObjectsPatchCall struct {
// Patch: Patches an object's metadata.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectsService) Patch(bucket string, object string, object2 *Object) *ObjectsPatchCall {
c := &ObjectsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -10462,16 +10561,26 @@ func (c *ObjectsPatchCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch int
// predefined set of access controls to this object.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *ObjectsPatchCall) PredefinedAcl(predefinedAcl string) *ObjectsPatchCall {
c.urlParams_.Set("predefinedAcl", predefinedAcl)
@@ -10482,8 +10591,9 @@ func (c *ObjectsPatchCall) PredefinedAcl(predefinedAcl string) *ObjectsPatchCall
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsPatchCall) Projection(projection string) *ObjectsPatchCall {
c.urlParams_.Set("projection", projection)
return c
@@ -10710,18 +10820,18 @@ type ObjectsRewriteCall struct {
// Rewrite: Rewrites a source object to a destination object. Optionally
// overrides metadata.
//
-// - destinationBucket: Name of the bucket in which to store the new
-// object. Overrides the provided object metadata's bucket value, if
-// any.
-// - destinationObject: Name of the new object. Required when the object
-// metadata is not otherwise provided. Overrides the object metadata's
-// name value, if any. For information about how to URL encode object
-// names to be path safe, see Encoding URI Path Parts.
-// - sourceBucket: Name of the bucket in which to find the source
-// object.
-// - sourceObject: Name of the source object. For information about how
-// to URL encode object names to be path safe, see Encoding URI Path
-// Parts.
+// - destinationBucket: Name of the bucket in which to store the new
+// object. Overrides the provided object metadata's bucket value, if
+// any.
+// - destinationObject: Name of the new object. Required when the object
+// metadata is not otherwise provided. Overrides the object metadata's
+// name value, if any. For information about how to URL encode object
+// names to be path safe, see Encoding URI Path Parts.
+// - sourceBucket: Name of the bucket in which to find the source
+// object.
+// - sourceObject: Name of the source object. For information about how
+// to URL encode object names to be path safe, see Encoding URI Path
+// Parts.
func (r *ObjectsService) Rewrite(sourceBucket string, sourceObject string, destinationBucket string, destinationObject string, object *Object) *ObjectsRewriteCall {
c := &ObjectsRewriteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.sourceBucket = sourceBucket
@@ -10736,7 +10846,9 @@ func (r *ObjectsService) Rewrite(sourceBucket string, sourceObject string, desti
// "destinationKmsKeyName": Resource name of the Cloud KMS key, of the
// form
// projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key,
-// that will be used to encrypt the object. Overrides the object
+//
+// that will be used to encrypt the object. Overrides the object
+//
// metadata's kms_key_name value, if any.
func (c *ObjectsRewriteCall) DestinationKmsKeyName(destinationKmsKeyName string) *ObjectsRewriteCall {
c.urlParams_.Set("destinationKmsKeyName", destinationKmsKeyName)
@@ -10748,16 +10860,26 @@ func (c *ObjectsRewriteCall) DestinationKmsKeyName(destinationKmsKeyName string)
// to the destination object.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *ObjectsRewriteCall) DestinationPredefinedAcl(destinationPredefinedAcl string) *ObjectsRewriteCall {
c.urlParams_.Set("destinationPredefinedAcl", destinationPredefinedAcl)
@@ -10855,8 +10977,9 @@ func (c *ObjectsRewriteCall) MaxBytesRewrittenPerCall(maxBytesRewrittenPerCall i
// specifies the acl property, when it defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsRewriteCall) Projection(projection string) *ObjectsRewriteCall {
c.urlParams_.Set("projection", projection)
return c
@@ -11156,9 +11279,9 @@ type ObjectsSetIamPolicyCall struct {
// SetIamPolicy: Updates an IAM policy for the specified object.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectsService) SetIamPolicy(bucket string, object string, policy *Policy) *ObjectsSetIamPolicyCall {
c := &ObjectsSetIamPolicyCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -11337,10 +11460,10 @@ type ObjectsTestIamPermissionsCall struct {
// TestIamPermissions: Tests a set of permissions on the given object to
// see which, if any, are held by the caller.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
-// - permissions: Permissions to test.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
+// - permissions: Permissions to test.
func (r *ObjectsService) TestIamPermissions(bucket string, object string, permissions []string) *ObjectsTestIamPermissionsCall {
c := &ObjectsTestIamPermissionsCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -11533,9 +11656,9 @@ type ObjectsUpdateCall struct {
// Update: Updates an object's metadata.
//
-// - bucket: Name of the bucket in which the object resides.
-// - object: Name of the object. For information about how to URL encode
-// object names to be path safe, see Encoding URI Path Parts.
+// - bucket: Name of the bucket in which the object resides.
+// - object: Name of the object. For information about how to URL encode
+// object names to be path safe, see Encoding URI Path Parts.
func (r *ObjectsService) Update(bucket string, object string, object2 *Object) *ObjectsUpdateCall {
c := &ObjectsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.bucket = bucket
@@ -11592,16 +11715,26 @@ func (c *ObjectsUpdateCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch in
// predefined set of access controls to this object.
//
// Possible values:
-// "authenticatedRead" - Object owner gets OWNER access, and
+//
+// "authenticatedRead" - Object owner gets OWNER access, and
+//
// allAuthenticatedUsers get READER access.
-// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
+// "bucketOwnerFullControl" - Object owner gets OWNER access, and
+//
// project team owners get OWNER access.
-// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
+// "bucketOwnerRead" - Object owner gets OWNER access, and project
+//
// team owners get READER access.
-// "private" - Object owner gets OWNER access.
-// "projectPrivate" - Object owner gets OWNER access, and project team
+//
+// "private" - Object owner gets OWNER access.
+// "projectPrivate" - Object owner gets OWNER access, and project team
+//
// members get access according to their roles.
-// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
+// "publicRead" - Object owner gets OWNER access, and allUsers get
+//
// READER access.
func (c *ObjectsUpdateCall) PredefinedAcl(predefinedAcl string) *ObjectsUpdateCall {
c.urlParams_.Set("predefinedAcl", predefinedAcl)
@@ -11612,8 +11745,9 @@ func (c *ObjectsUpdateCall) PredefinedAcl(predefinedAcl string) *ObjectsUpdateCa
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsUpdateCall) Projection(projection string) *ObjectsUpdateCall {
c.urlParams_.Set("projection", projection)
return c
@@ -11902,8 +12036,9 @@ func (c *ObjectsWatchAllCall) Prefix(prefix string) *ObjectsWatchAllCall {
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the owner, acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the owner, acl property.
func (c *ObjectsWatchAllCall) Projection(projection string) *ObjectsWatchAllCall {
c.urlParams_.Set("projection", projection)
return c
@@ -12412,9 +12547,9 @@ type ProjectsHmacKeysGetCall struct {
// Get: Retrieves an HMAC key's metadata
//
-// - accessId: Name of the HMAC key.
-// - projectId: Project ID owning the service account of the requested
-// key.
+// - accessId: Name of the HMAC key.
+// - projectId: Project ID owning the service account of the requested
+// key.
func (r *ProjectsHmacKeysService) Get(projectId string, accessId string) *ProjectsHmacKeysGetCall {
c := &ProjectsHmacKeysGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
@@ -12822,9 +12957,9 @@ type ProjectsHmacKeysUpdateCall struct {
// Update: Updates the state of an HMAC key. See the HMAC Key resource
// descriptor for valid states.
//
-// - accessId: Name of the HMAC key being updated.
-// - projectId: Project ID owning the service account of the updated
-// key.
+// - accessId: Name of the HMAC key being updated.
+// - projectId: Project ID owning the service account of the updated
+// key.
func (r *ProjectsHmacKeysService) Update(projectId string, accessId string, hmackeymetadata *HmacKeyMetadata) *ProjectsHmacKeysUpdateCall {
c := &ProjectsHmacKeysUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
diff --git a/storage/v1beta1/storage-gen.go b/storage/v1beta1/storage-gen.go
index 0a098d2a59c..93c88c316f0 100644
--- a/storage/v1beta1/storage-gen.go
+++ b/storage/v1beta1/storage-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://developers.google.com/storage/docs/json_api/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/storage/v1beta1"
-// ...
-// ctx := context.Background()
-// storageService, err := storage.NewService(ctx)
+// import "google.golang.org/api/storage/v1beta1"
+// ...
+// ctx := context.Background()
+// storageService, err := storage.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// storageService, err := storage.NewService(ctx, option.WithScopes(storage.DevstorageReadWriteScope))
+// storageService, err := storage.NewService(ctx, option.WithScopes(storage.DevstorageReadWriteScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// storageService, err := storage.NewService(ctx, option.WithAPIKey("AIza..."))
+// storageService, err := storage.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// storageService, err := storage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// storageService, err := storage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package storage // import "google.golang.org/api/storage/v1beta1"
@@ -1741,8 +1741,9 @@ func (r *BucketsService) Get(bucket string) *BucketsGetCall {
// properties to return. Defaults to no_acl.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsGetCall) Projection(projection string) *BucketsGetCall {
c.urlParams_.Set("projection", projection)
return c
@@ -1910,8 +1911,9 @@ func (r *BucketsService) Insert(bucket *Bucket) *BucketsInsertCall {
// full.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsInsertCall) Projection(projection string) *BucketsInsertCall {
c.urlParams_.Set("projection", projection)
return c
@@ -2074,8 +2076,9 @@ func (c *BucketsListCall) PageToken(pageToken string) *BucketsListCall {
// properties to return. Defaults to no_acl.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsListCall) Projection(projection string) *BucketsListCall {
c.urlParams_.Set("projection", projection)
return c
@@ -2274,8 +2277,9 @@ func (r *BucketsService) Patch(bucket string, bucket2 *Bucket) *BucketsPatchCall
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsPatchCall) Projection(projection string) *BucketsPatchCall {
c.urlParams_.Set("projection", projection)
return c
@@ -2437,8 +2441,9 @@ func (r *BucketsService) Update(bucket string, bucket2 *Bucket) *BucketsUpdateCa
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsUpdateCall) Projection(projection string) *BucketsUpdateCall {
c.urlParams_.Set("projection", projection)
return c
@@ -3613,8 +3618,9 @@ func (r *ObjectsService) Get(bucket string, object string) *ObjectsGetCall {
// properties to return. Defaults to no_acl.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit the acl property.
func (c *ObjectsGetCall) Projection(projection string) *ObjectsGetCall {
c.urlParams_.Set("projection", projection)
return c
@@ -3817,8 +3823,9 @@ func (c *ObjectsInsertCall) Name(name string) *ObjectsInsertCall {
// specifies the acl property, when it defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit the acl property.
func (c *ObjectsInsertCall) Projection(projection string) *ObjectsInsertCall {
c.urlParams_.Set("projection", projection)
return c
@@ -4102,8 +4109,9 @@ func (c *ObjectsListCall) Prefix(prefix string) *ObjectsListCall {
// properties to return. Defaults to no_acl.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit the acl property.
func (c *ObjectsListCall) Projection(projection string) *ObjectsListCall {
c.urlParams_.Set("projection", projection)
return c
@@ -4318,8 +4326,9 @@ func (r *ObjectsService) Patch(bucket string, object string, object2 *Object) *O
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit the acl property.
func (c *ObjectsPatchCall) Projection(projection string) *ObjectsPatchCall {
c.urlParams_.Set("projection", projection)
return c
@@ -4491,8 +4500,9 @@ func (r *ObjectsService) Update(bucket string, object string, object2 *Object) *
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "no_acl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "no_acl" - Omit the acl property.
func (c *ObjectsUpdateCall) Projection(projection string) *ObjectsUpdateCall {
c.urlParams_.Set("projection", projection)
return c
diff --git a/storage/v1beta2/storage-gen.go b/storage/v1beta2/storage-gen.go
index b077f128a9b..96940ee87c8 100644
--- a/storage/v1beta2/storage-gen.go
+++ b/storage/v1beta2/storage-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://developers.google.com/storage/docs/json_api/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/storage/v1beta2"
-// ...
-// ctx := context.Background()
-// storageService, err := storage.NewService(ctx)
+// import "google.golang.org/api/storage/v1beta2"
+// ...
+// ctx := context.Background()
+// storageService, err := storage.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// storageService, err := storage.NewService(ctx, option.WithScopes(storage.DevstorageReadWriteScope))
+// storageService, err := storage.NewService(ctx, option.WithScopes(storage.DevstorageReadWriteScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// storageService, err := storage.NewService(ctx, option.WithAPIKey("AIza..."))
+// storageService, err := storage.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// storageService, err := storage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// storageService, err := storage.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package storage // import "google.golang.org/api/storage/v1beta2"
@@ -2250,8 +2250,9 @@ func (c *BucketsGetCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch uint6
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsGetCall) Projection(projection string) *BucketsGetCall {
c.urlParams_.Set("projection", projection)
return c
@@ -2432,8 +2433,9 @@ func (r *BucketsService) Insert(projectid string, bucket *Bucket) *BucketsInsert
// full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsInsertCall) Projection(projection string) *BucketsInsertCall {
c.urlParams_.Set("projection", projection)
return c
@@ -2605,8 +2607,9 @@ func (c *BucketsListCall) PageToken(pageToken string) *BucketsListCall {
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsListCall) Projection(projection string) *BucketsListCall {
c.urlParams_.Set("projection", projection)
return c
@@ -2822,8 +2825,9 @@ func (c *BucketsPatchCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch uin
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsPatchCall) Projection(projection string) *BucketsPatchCall {
c.urlParams_.Set("projection", projection)
return c
@@ -3015,8 +3019,9 @@ func (c *BucketsUpdateCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch ui
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit acl and defaultObjectAcl properties.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit acl and defaultObjectAcl properties.
func (c *BucketsUpdateCall) Projection(projection string) *BucketsUpdateCall {
c.urlParams_.Set("projection", projection)
return c
@@ -5416,8 +5421,9 @@ func (c *ObjectsCopyCall) IfSourceMetagenerationNotMatch(ifSourceMetagenerationN
// specifies the acl property, when it defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsCopyCall) Projection(projection string) *ObjectsCopyCall {
c.urlParams_.Set("projection", projection)
return c
@@ -5908,8 +5914,9 @@ func (c *ObjectsGetCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch uint6
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsGetCall) Projection(projection string) *ObjectsGetCall {
c.urlParams_.Set("projection", projection)
return c
@@ -6175,8 +6182,9 @@ func (c *ObjectsInsertCall) Name(name string) *ObjectsInsertCall {
// specifies the acl property, when it defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsInsertCall) Projection(projection string) *ObjectsInsertCall {
c.urlParams_.Set("projection", projection)
return c
@@ -6487,8 +6495,9 @@ func (c *ObjectsListCall) Prefix(prefix string) *ObjectsListCall {
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsListCall) Projection(projection string) *ObjectsListCall {
c.urlParams_.Set("projection", projection)
return c
@@ -6756,8 +6765,9 @@ func (c *ObjectsPatchCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch uin
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsPatchCall) Projection(projection string) *ObjectsPatchCall {
c.urlParams_.Set("projection", projection)
return c
@@ -7000,8 +7010,9 @@ func (c *ObjectsUpdateCall) IfMetagenerationNotMatch(ifMetagenerationNotMatch ui
// properties to return. Defaults to full.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsUpdateCall) Projection(projection string) *ObjectsUpdateCall {
c.urlParams_.Set("projection", projection)
return c
@@ -7252,8 +7263,9 @@ func (c *ObjectsWatchAllCall) Prefix(prefix string) *ObjectsWatchAllCall {
// properties to return. Defaults to noAcl.
//
// Possible values:
-// "full" - Include all properties.
-// "noAcl" - Omit the acl property.
+//
+// "full" - Include all properties.
+// "noAcl" - Omit the acl property.
func (c *ObjectsWatchAllCall) Projection(projection string) *ObjectsWatchAllCall {
c.urlParams_.Set("projection", projection)
return c
diff --git a/storagetransfer/v1/storagetransfer-gen.go b/storagetransfer/v1/storagetransfer-gen.go
index 80d93ad90f4..e456af39554 100644
--- a/storagetransfer/v1/storagetransfer-gen.go
+++ b/storagetransfer/v1/storagetransfer-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/storage-transfer/docs
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/storagetransfer/v1"
-// ...
-// ctx := context.Background()
-// storagetransferService, err := storagetransfer.NewService(ctx)
+// import "google.golang.org/api/storagetransfer/v1"
+// ...
+// ctx := context.Background()
+// storagetransferService, err := storagetransfer.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// storagetransferService, err := storagetransfer.NewService(ctx, option.WithAPIKey("AIza..."))
+// storagetransferService, err := storagetransfer.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// storagetransferService, err := storagetransfer.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// storagetransferService, err := storagetransfer.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package storagetransfer // import "google.golang.org/api/storagetransfer/v1"
@@ -2229,8 +2229,8 @@ type GoogleServiceAccountsGetCall struct {
// Storage Transfer Service and can only be used by Storage Transfer
// Service.
//
-// - projectId: The ID of the Google Cloud project that the Google
-// service account is associated with.
+// - projectId: The ID of the Google Cloud project that the Google
+// service account is associated with.
func (r *GoogleServiceAccountsService) Get(projectId string) *GoogleServiceAccountsGetCall {
c := &GoogleServiceAccountsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
@@ -2375,8 +2375,8 @@ type ProjectsAgentPoolsCreateCall struct {
// Create: Creates an agent pool resource.
//
-// - projectId: The ID of the Google Cloud project that owns the agent
-// pool.
+// - projectId: The ID of the Google Cloud project that owns the agent
+// pool.
func (r *ProjectsAgentPoolsService) Create(projectId string, agentpool *AgentPool) *ProjectsAgentPoolsCreateCall {
c := &ProjectsAgentPoolsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
@@ -3023,8 +3023,8 @@ type ProjectsAgentPoolsPatchCall struct {
// Patch: Updates an existing agent pool resource.
//
-// - name: Specifies a unique string that identifies the agent pool.
-// Format: `projects/{project_id}/agentPools/{agent_pool_id}`.
+// - name: Specifies a unique string that identifies the agent pool.
+// Format: `projects/{project_id}/agentPools/{agent_pool_id}`.
func (r *ProjectsAgentPoolsService) Patch(name string, agentpool *AgentPool) *ProjectsAgentPoolsPatchCall {
c := &ProjectsAgentPoolsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3460,14 +3460,14 @@ type TransferJobsListCall struct {
// List: Lists transfer jobs.
//
-// - filter: A list of query parameters specified as JSON text in the
-// form of: `{"projectId":"my_project_id",
-// "jobNames":["jobid1","jobid2",...],
-// "jobStatuses":["status1","status2",...]}` Since `jobNames` and
-// `jobStatuses` support multiple values, their values must be
-// specified with array notation. `projectId` is required. `jobNames`
-// and `jobStatuses` are optional. The valid values for `jobStatuses`
-// are case-insensitive: ENABLED, DISABLED, and DELETED.
+// - filter: A list of query parameters specified as JSON text in the
+// form of: `{"projectId":"my_project_id",
+// "jobNames":["jobid1","jobid2",...],
+// "jobStatuses":["status1","status2",...]}` Since `jobNames` and
+// `jobStatuses` support multiple values, their values must be
+// specified with array notation. `projectId` is required. `jobNames`
+// and `jobStatuses` are optional. The valid values for `jobStatuses`
+// are case-insensitive: ENABLED, DISABLED, and DELETED.
func (r *TransferJobsService) List(filter string) *TransferJobsListCall {
c := &TransferJobsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("filter", filter)
@@ -4254,19 +4254,19 @@ type TransferOperationsListCall struct {
// List: Lists transfer operations. Operations are ordered by their
// creation time in reverse chronological order.
//
-// - filter: A list of query parameters specified as JSON text in the
-// form of: `{"projectId":"my_project_id",
-// "jobNames":["jobid1","jobid2",...],
-// "operationNames":["opid1","opid2",...],
-// "transferStatuses":["status1","status2",...]}` Since `jobNames`,
-// `operationNames`, and `transferStatuses` support multiple values,
-// they must be specified with array notation. `projectId` is
-// required. `jobNames`, `operationNames`, and `transferStatuses` are
-// optional. The valid values for `transferStatuses` are
-// case-insensitive: IN_PROGRESS, PAUSED, SUCCESS, FAILED, and
-// ABORTED.
-// - name: The name of the type being listed; must be
-// `transferOperations`.
+// - filter: A list of query parameters specified as JSON text in the
+// form of: `{"projectId":"my_project_id",
+// "jobNames":["jobid1","jobid2",...],
+// "operationNames":["opid1","opid2",...],
+// "transferStatuses":["status1","status2",...]}` Since `jobNames`,
+// `operationNames`, and `transferStatuses` support multiple values,
+// they must be specified with array notation. `projectId` is
+// required. `jobNames`, `operationNames`, and `transferStatuses` are
+// optional. The valid values for `transferStatuses` are
+// case-insensitive: IN_PROGRESS, PAUSED, SUCCESS, FAILED, and
+// ABORTED.
+// - name: The name of the type being listed; must be
+// `transferOperations`.
func (r *TransferOperationsService) List(name string, filter string) *TransferOperationsListCall {
c := &TransferOperationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/streetviewpublish/v1/streetviewpublish-gen.go b/streetviewpublish/v1/streetviewpublish-gen.go
index 1326d8a349c..1d2a461fd97 100644
--- a/streetviewpublish/v1/streetviewpublish-gen.go
+++ b/streetviewpublish/v1/streetviewpublish-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/streetview/publish/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/streetviewpublish/v1"
-// ...
-// ctx := context.Background()
-// streetviewpublishService, err := streetviewpublish.NewService(ctx)
+// import "google.golang.org/api/streetviewpublish/v1"
+// ...
+// ctx := context.Background()
+// streetviewpublishService, err := streetviewpublish.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// streetviewpublishService, err := streetviewpublish.NewService(ctx, option.WithAPIKey("AIza..."))
+// streetviewpublishService, err := streetviewpublish.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// streetviewpublishService, err := streetviewpublish.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// streetviewpublishService, err := streetviewpublish.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package streetviewpublish // import "google.golang.org/api/streetviewpublish/v1"
@@ -1818,9 +1818,13 @@ func (c *PhotoGetCall) LanguageCode(languageCode string) *PhotoGetCall {
// response.
//
// Possible values:
-// "BASIC" - Server responses do not include the download URL for the
+//
+// "BASIC" - Server responses do not include the download URL for the
+//
// photo bytes. The default value.
-// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
+// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
// for the photo bytes.
func (c *PhotoGetCall) View(view string) *PhotoGetCall {
c.urlParams_.Set("view", view)
@@ -2310,10 +2314,13 @@ func (r *PhotoSequenceService) Create(photosequence *PhotoSequence) *PhotoSequen
// input form of PhotoSequence.
//
// Possible values:
-// "INPUT_TYPE_UNSPECIFIED" - Not specified. Server will return
+//
+// "INPUT_TYPE_UNSPECIFIED" - Not specified. Server will return
+//
// google.rpc.Code.INVALID_ARGUMENT.
-// "VIDEO" - 360 Video.
-// "XDM" - Extensible Device Metadata, http://www.xdm.org
+//
+// "VIDEO" - 360 Video.
+// "XDM" - Extensible Device Metadata, http://www.xdm.org
func (c *PhotoSequenceCreateCall) InputType(inputType string) *PhotoSequenceCreateCall {
c.urlParams_.Set("inputType", inputType)
return c
@@ -2624,9 +2631,13 @@ func (c *PhotoSequenceGetCall) Filter(filter string) *PhotoSequenceGetCall {
// not implemented.
//
// Possible values:
-// "BASIC" - Server responses do not include the download URL for the
+//
+// "BASIC" - Server responses do not include the download URL for the
+//
// photo bytes. The default value.
-// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
+// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
// for the photo bytes.
func (c *PhotoSequenceGetCall) View(view string) *PhotoSequenceGetCall {
c.urlParams_.Set("view", view)
@@ -3280,9 +3291,13 @@ func (c *PhotosBatchGetCall) PhotoIds(photoIds ...string) *PhotosBatchGetCall {
// response.
//
// Possible values:
-// "BASIC" - Server responses do not include the download URL for the
+//
+// "BASIC" - Server responses do not include the download URL for the
+//
// photo bytes. The default value.
-// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
+// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
// for the photo bytes.
func (c *PhotosBatchGetCall) View(view string) *PhotosBatchGetCall {
c.urlParams_.Set("view", view)
@@ -3625,9 +3640,13 @@ func (c *PhotosListCall) PageToken(pageToken string) *PhotosListCall {
// response.
//
// Possible values:
-// "BASIC" - Server responses do not include the download URL for the
+//
+// "BASIC" - Server responses do not include the download URL for the
+//
// photo bytes. The default value.
-// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
+// "INCLUDE_DOWNLOAD_URL" - Server responses include the download URL
+//
// for the photo bytes.
func (c *PhotosListCall) View(view string) *PhotosListCall {
c.urlParams_.Set("view", view)
diff --git a/sts/v1/sts-api.json b/sts/v1/sts-api.json
index d6d472ed153..3eddf33882c 100644
--- a/sts/v1/sts-api.json
+++ b/sts/v1/sts-api.json
@@ -131,7 +131,7 @@
}
}
},
- "revision": "20220619",
+ "revision": "20220806",
"rootUrl": "https://sts.googleapis.com/",
"schemas": {
"GoogleIamV1Binding": {
@@ -143,7 +143,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/sts/v1/sts-gen.go b/sts/v1/sts-gen.go
index 2e78e3976ff..37d7b197f16 100644
--- a/sts/v1/sts-gen.go
+++ b/sts/v1/sts-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: http://cloud.google.com/iam/docs/workload-identity-federation
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sts/v1"
-// ...
-// ctx := context.Background()
-// stsService, err := sts.NewService(ctx)
+// import "google.golang.org/api/sts/v1"
+// ...
+// ctx := context.Background()
+// stsService, err := sts.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// stsService, err := sts.NewService(ctx, option.WithAPIKey("AIza..."))
+// stsService, err := sts.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// stsService, err := sts.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// stsService, err := sts.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sts // import "google.golang.org/api/sts/v1"
@@ -155,16 +155,20 @@ type GoogleIamV1Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
diff --git a/sts/v1beta/sts-api.json b/sts/v1beta/sts-api.json
index 9036c047def..9fc7a0efe70 100644
--- a/sts/v1beta/sts-api.json
+++ b/sts/v1beta/sts-api.json
@@ -116,7 +116,7 @@
}
}
},
- "revision": "20220619",
+ "revision": "20220806",
"rootUrl": "https://sts.googleapis.com/",
"schemas": {
"GoogleIamV1Binding": {
@@ -128,7 +128,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
- "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
+ "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"items": {
"type": "string"
},
diff --git a/sts/v1beta/sts-gen.go b/sts/v1beta/sts-gen.go
index 542fa9500e7..1919aecb0fb 100644
--- a/sts/v1beta/sts-gen.go
+++ b/sts/v1beta/sts-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: http://cloud.google.com/iam/docs/workload-identity-federation
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/sts/v1beta"
-// ...
-// ctx := context.Background()
-// stsService, err := sts.NewService(ctx)
+// import "google.golang.org/api/sts/v1beta"
+// ...
+// ctx := context.Background()
+// stsService, err := sts.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// stsService, err := sts.NewService(ctx, option.WithAPIKey("AIza..."))
+// stsService, err := sts.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// stsService, err := sts.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// stsService, err := sts.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package sts // import "google.golang.org/api/sts/v1beta"
@@ -155,16 +155,20 @@ type GoogleIamV1Binding struct {
// who is authenticated with a Google account or a service account. *
// `user:{emailid}`: An email address that represents a specific Google
// account. For example, `alice@example.com` . *
- // `serviceAccount:{emailid}`: An email address that represents a
+ // `serviceAccount:{emailid}`: An email address that represents a Google
// service account. For example,
- // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An
- // email address that represents a Google group. For example,
- // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An
- // email address (plus unique identifier) representing a user that has
- // been recently deleted. For example,
- // `alice@example.com?uid=123456789012345678901`. If the user is
- // recovered, this value reverts to `user:{emailid}` and the recovered
- // user retains the role in the binding. *
+ // `my-other-app@appspot.gserviceaccount.com`. *
+ // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
+ // An identifier for a Kubernetes service account
+ // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
+ // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
+ // * `group:{emailid}`: An email address that represents a Google group.
+ // For example, `admins@example.com`. *
+ // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus
+ // unique identifier) representing a user that has been recently
+ // deleted. For example, `alice@example.com?uid=123456789012345678901`.
+ // If the user is recovered, this value reverts to `user:{emailid}` and
+ // the recovered user retains the role in the binding. *
// `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
// (plus unique identifier) representing a service account that has been
// recently deleted. For example,
diff --git a/surveys/v2/surveys-gen.go b/surveys/v2/surveys-gen.go
index ba98ce013e5..3c72a1b927f 100644
--- a/surveys/v2/surveys-gen.go
+++ b/surveys/v2/surveys-gen.go
@@ -6,35 +6,35 @@
// Package surveys provides access to the Surveys API.
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/surveys/v2"
-// ...
-// ctx := context.Background()
-// surveysService, err := surveys.NewService(ctx)
+// import "google.golang.org/api/surveys/v2"
+// ...
+// ctx := context.Background()
+// surveysService, err := surveys.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// surveysService, err := surveys.NewService(ctx, option.WithScopes(surveys.UserinfoEmailScope))
+// surveysService, err := surveys.NewService(ctx, option.WithScopes(surveys.UserinfoEmailScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// surveysService, err := surveys.NewService(ctx, option.WithAPIKey("AIza..."))
+// surveysService, err := surveys.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// surveysService, err := surveys.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// surveysService, err := surveys.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package surveys // import "google.golang.org/api/surveys/v2"
diff --git a/tagmanager/v1/tagmanager-gen.go b/tagmanager/v1/tagmanager-gen.go
index 0d642696e35..a7ac70ee18c 100644
--- a/tagmanager/v1/tagmanager-gen.go
+++ b/tagmanager/v1/tagmanager-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/tag-manager
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tagmanager/v1"
-// ...
-// ctx := context.Background()
-// tagmanagerService, err := tagmanager.NewService(ctx)
+// import "google.golang.org/api/tagmanager/v1"
+// ...
+// ctx := context.Background()
+// tagmanagerService, err := tagmanager.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// tagmanagerService, err := tagmanager.NewService(ctx, option.WithScopes(tagmanager.TagmanagerReadonlyScope))
+// tagmanagerService, err := tagmanager.NewService(ctx, option.WithScopes(tagmanager.TagmanagerReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tagmanagerService, err := tagmanager.NewService(ctx, option.WithAPIKey("AIza..."))
+// tagmanagerService, err := tagmanager.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tagmanagerService, err := tagmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tagmanagerService, err := tagmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tagmanager // import "google.golang.org/api/tagmanager/v1"
@@ -8035,10 +8035,10 @@ type AccountsContainersVersionsGetCall struct {
// Get: Gets a Container Version.
//
-// - accountId: The GTM Account ID.
-// - containerId: The GTM Container ID.
-// - containerVersionId: The GTM Container Version ID. Specify published
-// to retrieve the currently published version.
+// - accountId: The GTM Account ID.
+// - containerId: The GTM Container ID.
+// - containerVersionId: The GTM Container Version ID. Specify published
+// to retrieve the currently published version.
func (r *AccountsContainersVersionsService) Get(accountId string, containerId string, containerVersionId string) *AccountsContainersVersionsGetCall {
c := &AccountsContainersVersionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.accountId = accountId
diff --git a/tagmanager/v2/tagmanager-api.json b/tagmanager/v2/tagmanager-api.json
index 147a5d2dec4..5c4e8e27d1f 100644
--- a/tagmanager/v2/tagmanager-api.json
+++ b/tagmanager/v2/tagmanager-api.json
@@ -3317,7 +3317,7 @@
}
}
},
- "revision": "20211027",
+ "revision": "20220813",
"rootUrl": "https://tagmanager.googleapis.com/",
"schemas": {
"Account": {
@@ -5584,13 +5584,6 @@
"description": "User notes on how to apply this zone in the container.",
"type": "string"
},
- "parameter": {
- "description": "Additional parameters.",
- "items": {
- "$ref": "Parameter"
- },
- "type": "array"
- },
"path": {
"description": "GTM Zone's API relative path.",
"type": "string"
diff --git a/tagmanager/v2/tagmanager-gen.go b/tagmanager/v2/tagmanager-gen.go
index 1b58468ae4c..df0f4c85d49 100644
--- a/tagmanager/v2/tagmanager-gen.go
+++ b/tagmanager/v2/tagmanager-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/tag-manager
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tagmanager/v2"
-// ...
-// ctx := context.Background()
-// tagmanagerService, err := tagmanager.NewService(ctx)
+// import "google.golang.org/api/tagmanager/v2"
+// ...
+// ctx := context.Background()
+// tagmanagerService, err := tagmanager.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// tagmanagerService, err := tagmanager.NewService(ctx, option.WithScopes(tagmanager.TagmanagerReadonlyScope))
+// tagmanagerService, err := tagmanager.NewService(ctx, option.WithScopes(tagmanager.TagmanagerReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tagmanagerService, err := tagmanager.NewService(ctx, option.WithAPIKey("AIza..."))
+// tagmanagerService, err := tagmanager.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tagmanagerService, err := tagmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tagmanagerService, err := tagmanager.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tagmanager // import "google.golang.org/api/tagmanager/v2"
@@ -3412,9 +3412,6 @@ type Zone struct {
// Notes: User notes on how to apply this zone in the container.
Notes string `json:"notes,omitempty"`
- // Parameter: Additional parameters.
- Parameter []*Parameter `json:"parameter,omitempty"`
-
// Path: GTM Zone's API relative path.
Path string `json:"path,omitempty"`
@@ -3566,8 +3563,8 @@ type AccountsGetCall struct {
// Get: Gets a GTM Account.
//
-// - path: GTM Accounts's API relative path. Example:
-// accounts/{account_id}.
+// - path: GTM Accounts's API relative path. Example:
+// accounts/{account_id}.
func (r *AccountsService) Get(path string) *AccountsGetCall {
c := &AccountsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -3880,8 +3877,8 @@ type AccountsUpdateCall struct {
// Update: Updates a GTM Account.
//
-// - path: GTM Accounts's API relative path. Example:
-// accounts/{account_id}.
+// - path: GTM Accounts's API relative path. Example:
+// accounts/{account_id}.
func (r *AccountsService) Update(path string, account *Account) *AccountsUpdateCall {
c := &AccountsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -4036,8 +4033,8 @@ type AccountsContainersCreateCall struct {
// Create: Creates a Container.
//
-// - parent: GTM Account's API relative path. Example:
-// accounts/{account_id}.
+// - parent: GTM Account's API relative path. Example:
+// accounts/{account_id}.
func (r *AccountsContainersService) Create(parent string, container *Container) *AccountsContainersCreateCall {
c := &AccountsContainersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4178,8 +4175,8 @@ type AccountsContainersDeleteCall struct {
// Delete: Deletes a Container.
//
-// - path: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - path: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersService) Delete(path string) *AccountsContainersDeleteCall {
c := &AccountsContainersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -4284,8 +4281,8 @@ type AccountsContainersGetCall struct {
// Get: Gets a Container.
//
-// - path: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - path: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersService) Get(path string) *AccountsContainersGetCall {
c := &AccountsContainersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -4432,8 +4429,8 @@ type AccountsContainersListCall struct {
// List: Lists all Containers that belongs to a GTM Account.
//
-// - parent: GTM Accounts's API relative path. Example:
-// accounts/{account_id}.
+// - parent: GTM Accounts's API relative path. Example:
+// accounts/{account_id}.
func (r *AccountsContainersService) List(parent string) *AccountsContainersListCall {
c := &AccountsContainersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4613,8 +4610,8 @@ type AccountsContainersUpdateCall struct {
// Update: Updates a Container.
//
-// - path: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - path: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersService) Update(path string, container *Container) *AccountsContainersUpdateCall {
c := &AccountsContainersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -4769,8 +4766,8 @@ type AccountsContainersEnvironmentsCreateCall struct {
// Create: Creates a GTM Environment.
//
-// - parent: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersEnvironmentsService) Create(parent string, environment *Environment) *AccountsContainersEnvironmentsCreateCall {
c := &AccountsContainersEnvironmentsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4911,9 +4908,9 @@ type AccountsContainersEnvironmentsDeleteCall struct {
// Delete: Deletes a GTM Environment.
//
-// - path: GTM Environment's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/environments/{enviro
-// nment_id}.
+// - path: GTM Environment's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/environments/{enviro
+// nment_id}.
func (r *AccountsContainersEnvironmentsService) Delete(path string) *AccountsContainersEnvironmentsDeleteCall {
c := &AccountsContainersEnvironmentsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -5018,9 +5015,9 @@ type AccountsContainersEnvironmentsGetCall struct {
// Get: Gets a GTM Environment.
//
-// - path: GTM Environment's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/environments/{enviro
-// nment_id}.
+// - path: GTM Environment's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/environments/{enviro
+// nment_id}.
func (r *AccountsContainersEnvironmentsService) Get(path string) *AccountsContainersEnvironmentsGetCall {
c := &AccountsContainersEnvironmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -5167,8 +5164,8 @@ type AccountsContainersEnvironmentsListCall struct {
// List: Lists all GTM Environments of a GTM Container.
//
-// - parent: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersEnvironmentsService) List(parent string) *AccountsContainersEnvironmentsListCall {
c := &AccountsContainersEnvironmentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5349,9 +5346,9 @@ type AccountsContainersEnvironmentsReauthorizeCall struct {
// Reauthorize: Re-generates the authorization code for a GTM
// Environment.
//
-// - path: GTM Environment's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/environments/{enviro
-// nment_id}.
+// - path: GTM Environment's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/environments/{enviro
+// nment_id}.
func (r *AccountsContainersEnvironmentsService) Reauthorize(path string, environment *Environment) *AccountsContainersEnvironmentsReauthorizeCall {
c := &AccountsContainersEnvironmentsReauthorizeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -5493,9 +5490,9 @@ type AccountsContainersEnvironmentsUpdateCall struct {
// Update: Updates a GTM Environment.
//
-// - path: GTM Environment's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/environments/{enviro
-// nment_id}.
+// - path: GTM Environment's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/environments/{enviro
+// nment_id}.
func (r *AccountsContainersEnvironmentsService) Update(path string, environment *Environment) *AccountsContainersEnvironmentsUpdateCall {
c := &AccountsContainersEnvironmentsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -5650,8 +5647,8 @@ type AccountsContainersVersionHeadersLatestCall struct {
// Latest: Gets the latest container version header
//
-// - parent: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersVersionHeadersService) Latest(parent string) *AccountsContainersVersionHeadersLatestCall {
c := &AccountsContainersVersionHeadersLatestCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5798,8 +5795,8 @@ type AccountsContainersVersionHeadersListCall struct {
// List: Lists all Container Versions of a GTM Container.
//
-// - parent: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersVersionHeadersService) List(parent string) *AccountsContainersVersionHeadersListCall {
c := &AccountsContainersVersionHeadersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -5991,9 +5988,9 @@ type AccountsContainersVersionsDeleteCall struct {
// Delete: Deletes a Container Version.
//
-// - path: GTM ContainerVersion's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/versions/{version_id
-// }.
+// - path: GTM ContainerVersion's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/versions/{version_id
+// }.
func (r *AccountsContainersVersionsService) Delete(path string) *AccountsContainersVersionsDeleteCall {
c := &AccountsContainersVersionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -6098,9 +6095,9 @@ type AccountsContainersVersionsGetCall struct {
// Get: Gets a Container Version.
//
-// - path: GTM ContainerVersion's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/versions/{version_id
-// }.
+// - path: GTM ContainerVersion's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/versions/{version_id
+// }.
func (r *AccountsContainersVersionsService) Get(path string) *AccountsContainersVersionsGetCall {
c := &AccountsContainersVersionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -6261,8 +6258,8 @@ type AccountsContainersVersionsLiveCall struct {
// Live: Gets the live (i.e. published) container version
//
-// - parent: GTM Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersVersionsService) Live(parent string) *AccountsContainersVersionsLiveCall {
c := &AccountsContainersVersionsLiveCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -6408,9 +6405,9 @@ type AccountsContainersVersionsPublishCall struct {
// Publish: Publishes a Container Version.
//
-// - path: GTM ContainerVersion's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/versions/{version_id
-// }.
+// - path: GTM ContainerVersion's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/versions/{version_id
+// }.
func (r *AccountsContainersVersionsService) Publish(path string) *AccountsContainersVersionsPublishCall {
c := &AccountsContainersVersionsPublishCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -6556,9 +6553,9 @@ type AccountsContainersVersionsSetLatestCall struct {
// SetLatest: Sets the latest version used for synchronization of
// workspaces when detecting conflicts and errors.
//
-// - path: GTM ContainerVersion's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/versions/{version_id
-// }.
+// - path: GTM ContainerVersion's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/versions/{version_id
+// }.
func (r *AccountsContainersVersionsService) SetLatest(path string) *AccountsContainersVersionsSetLatestCall {
c := &AccountsContainersVersionsSetLatestCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -6690,9 +6687,9 @@ type AccountsContainersVersionsUndeleteCall struct {
// Undelete: Undeletes a Container Version.
//
-// - path: GTM ContainerVersion's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/versions/{version_id
-// }.
+// - path: GTM ContainerVersion's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/versions/{version_id
+// }.
func (r *AccountsContainersVersionsService) Undelete(path string) *AccountsContainersVersionsUndeleteCall {
c := &AccountsContainersVersionsUndeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -6825,9 +6822,9 @@ type AccountsContainersVersionsUpdateCall struct {
// Update: Updates a Container Version.
//
-// - path: GTM ContainerVersion's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/versions/{version_id
-// }.
+// - path: GTM ContainerVersion's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/versions/{version_id
+// }.
func (r *AccountsContainersVersionsService) Update(path string, containerversion *ContainerVersion) *AccountsContainersVersionsUpdateCall {
c := &AccountsContainersVersionsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -6982,8 +6979,8 @@ type AccountsContainersWorkspacesCreateCall struct {
// Create: Creates a Workspace.
//
-// - parent: GTM parent Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM parent Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersWorkspacesService) Create(parent string, workspace *Workspace) *AccountsContainersWorkspacesCreateCall {
c := &AccountsContainersWorkspacesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7127,9 +7124,9 @@ type AccountsContainersWorkspacesCreateVersionCall struct {
// in the workspace, deletes the workspace, and sets the base container
// version to the newly created version.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) CreateVersion(path string, createcontainerversionrequestversionoptions *CreateContainerVersionRequestVersionOptions) *AccountsContainersWorkspacesCreateVersionCall {
c := &AccountsContainersWorkspacesCreateVersionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -7270,9 +7267,9 @@ type AccountsContainersWorkspacesDeleteCall struct {
// Delete: Deletes a Workspace.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) Delete(path string) *AccountsContainersWorkspacesDeleteCall {
c := &AccountsContainersWorkspacesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -7377,9 +7374,9 @@ type AccountsContainersWorkspacesGetCall struct {
// Get: Gets a Workspace.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) Get(path string) *AccountsContainersWorkspacesGetCall {
c := &AccountsContainersWorkspacesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -7526,9 +7523,9 @@ type AccountsContainersWorkspacesGetStatusCall struct {
// GetStatus: Finds conflicting and modified entities in the workspace.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) GetStatus(path string) *AccountsContainersWorkspacesGetStatusCall {
c := &AccountsContainersWorkspacesGetStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -7675,8 +7672,8 @@ type AccountsContainersWorkspacesListCall struct {
// List: Lists all Workspaces that belong to a GTM Container.
//
-// - parent: GTM parent Container's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}.
+// - parent: GTM parent Container's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}.
func (r *AccountsContainersWorkspacesService) List(parent string) *AccountsContainersWorkspacesListCall {
c := &AccountsContainersWorkspacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7856,9 +7853,9 @@ type AccountsContainersWorkspacesQuickPreviewCall struct {
// QuickPreview: Quick previews a workspace by creating a fake container
// version from all entities in the provided workspace.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) QuickPreview(path string) *AccountsContainersWorkspacesQuickPreviewCall {
c := &AccountsContainersWorkspacesQuickPreviewCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -7992,9 +7989,9 @@ type AccountsContainersWorkspacesResolveConflictCall struct {
// ResolveConflict: Resolves a merge conflict for a workspace entity by
// updating it to the resolved entity passed in the request.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) ResolveConflict(path string, entity *Entity) *AccountsContainersWorkspacesResolveConflictCall {
c := &AccountsContainersWorkspacesResolveConflictCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -8122,9 +8119,9 @@ type AccountsContainersWorkspacesSyncCall struct {
// all unmodified workspace entities and displaying conflicts for
// modified entities.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) Sync(path string) *AccountsContainersWorkspacesSyncCall {
c := &AccountsContainersWorkspacesSyncCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -8257,9 +8254,9 @@ type AccountsContainersWorkspacesUpdateCall struct {
// Update: Updates a Workspace.
//
-// - path: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - path: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesService) Update(path string, workspace *Workspace) *AccountsContainersWorkspacesUpdateCall {
c := &AccountsContainersWorkspacesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -8413,9 +8410,9 @@ type AccountsContainersWorkspacesBuiltInVariablesCreateCall struct {
// Create: Creates one or more GTM Built-In Variables.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesBuiltInVariablesService) Create(parent string) *AccountsContainersWorkspacesBuiltInVariablesCreateCall {
c := &AccountsContainersWorkspacesBuiltInVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -8426,119 +8423,120 @@ func (r *AccountsContainersWorkspacesBuiltInVariablesService) Create(parent stri
// variables to enable.
//
// Possible values:
-// "builtInVariableTypeUnspecified"
-// "pageUrl"
-// "pageHostname"
-// "pagePath"
-// "referrer"
-// "event" - For web or mobile.
-// "clickElement"
-// "clickClasses"
-// "clickId"
-// "clickTarget"
-// "clickUrl"
-// "clickText"
-// "firstPartyServingUrl"
-// "formElement"
-// "formClasses"
-// "formId"
-// "formTarget"
-// "formUrl"
-// "formText"
-// "errorMessage"
-// "errorUrl"
-// "errorLine"
-// "newHistoryUrl"
-// "oldHistoryUrl"
-// "newHistoryFragment"
-// "oldHistoryFragment"
-// "newHistoryState"
-// "oldHistoryState"
-// "historySource"
-// "containerVersion" - For web or mobile.
-// "debugMode"
-// "randomNumber" - For web or mobile.
-// "containerId" - For web or mobile.
-// "appId"
-// "appName"
-// "appVersionCode"
-// "appVersionName"
-// "language"
-// "osVersion"
-// "platform"
-// "sdkVersion"
-// "deviceName"
-// "resolution"
-// "advertiserId"
-// "advertisingTrackingEnabled"
-// "htmlId"
-// "environmentName"
-// "ampBrowserLanguage"
-// "ampCanonicalPath"
-// "ampCanonicalUrl"
-// "ampCanonicalHost"
-// "ampReferrer"
-// "ampTitle"
-// "ampClientId"
-// "ampClientTimezone"
-// "ampClientTimestamp"
-// "ampClientScreenWidth"
-// "ampClientScreenHeight"
-// "ampClientScrollX"
-// "ampClientScrollY"
-// "ampClientMaxScrollX"
-// "ampClientMaxScrollY"
-// "ampTotalEngagedTime"
-// "ampPageViewId"
-// "ampPageLoadTime"
-// "ampPageDownloadTime"
-// "ampGtmEvent"
-// "eventName"
-// "firebaseEventParameterCampaign"
-// "firebaseEventParameterCampaignAclid"
-// "firebaseEventParameterCampaignAnid"
-// "firebaseEventParameterCampaignClickTimestamp"
-// "firebaseEventParameterCampaignContent"
-// "firebaseEventParameterCampaignCp1"
-// "firebaseEventParameterCampaignGclid"
-// "firebaseEventParameterCampaignSource"
-// "firebaseEventParameterCampaignTerm"
-// "firebaseEventParameterCurrency"
-// "firebaseEventParameterDynamicLinkAcceptTime"
-// "firebaseEventParameterDynamicLinkLinkid"
-// "firebaseEventParameterNotificationMessageDeviceTime"
-// "firebaseEventParameterNotificationMessageId"
-// "firebaseEventParameterNotificationMessageName"
-// "firebaseEventParameterNotificationMessageTime"
-// "firebaseEventParameterNotificationTopic"
-// "firebaseEventParameterPreviousAppVersion"
-// "firebaseEventParameterPreviousOsVersion"
-// "firebaseEventParameterPrice"
-// "firebaseEventParameterProductId"
-// "firebaseEventParameterQuantity"
-// "firebaseEventParameterValue"
-// "videoProvider"
-// "videoUrl"
-// "videoTitle"
-// "videoDuration"
-// "videoPercent"
-// "videoVisible"
-// "videoStatus"
-// "videoCurrentTime"
-// "scrollDepthThreshold"
-// "scrollDepthUnits"
-// "scrollDepthDirection"
-// "elementVisibilityRatio"
-// "elementVisibilityTime"
-// "elementVisibilityFirstTime"
-// "elementVisibilityRecentTime"
-// "requestPath"
-// "requestMethod"
-// "clientName"
-// "queryString"
-// "serverPageLocationUrl"
-// "serverPageLocationPath"
-// "serverPageLocationHostname"
+//
+// "builtInVariableTypeUnspecified"
+// "pageUrl"
+// "pageHostname"
+// "pagePath"
+// "referrer"
+// "event" - For web or mobile.
+// "clickElement"
+// "clickClasses"
+// "clickId"
+// "clickTarget"
+// "clickUrl"
+// "clickText"
+// "firstPartyServingUrl"
+// "formElement"
+// "formClasses"
+// "formId"
+// "formTarget"
+// "formUrl"
+// "formText"
+// "errorMessage"
+// "errorUrl"
+// "errorLine"
+// "newHistoryUrl"
+// "oldHistoryUrl"
+// "newHistoryFragment"
+// "oldHistoryFragment"
+// "newHistoryState"
+// "oldHistoryState"
+// "historySource"
+// "containerVersion" - For web or mobile.
+// "debugMode"
+// "randomNumber" - For web or mobile.
+// "containerId" - For web or mobile.
+// "appId"
+// "appName"
+// "appVersionCode"
+// "appVersionName"
+// "language"
+// "osVersion"
+// "platform"
+// "sdkVersion"
+// "deviceName"
+// "resolution"
+// "advertiserId"
+// "advertisingTrackingEnabled"
+// "htmlId"
+// "environmentName"
+// "ampBrowserLanguage"
+// "ampCanonicalPath"
+// "ampCanonicalUrl"
+// "ampCanonicalHost"
+// "ampReferrer"
+// "ampTitle"
+// "ampClientId"
+// "ampClientTimezone"
+// "ampClientTimestamp"
+// "ampClientScreenWidth"
+// "ampClientScreenHeight"
+// "ampClientScrollX"
+// "ampClientScrollY"
+// "ampClientMaxScrollX"
+// "ampClientMaxScrollY"
+// "ampTotalEngagedTime"
+// "ampPageViewId"
+// "ampPageLoadTime"
+// "ampPageDownloadTime"
+// "ampGtmEvent"
+// "eventName"
+// "firebaseEventParameterCampaign"
+// "firebaseEventParameterCampaignAclid"
+// "firebaseEventParameterCampaignAnid"
+// "firebaseEventParameterCampaignClickTimestamp"
+// "firebaseEventParameterCampaignContent"
+// "firebaseEventParameterCampaignCp1"
+// "firebaseEventParameterCampaignGclid"
+// "firebaseEventParameterCampaignSource"
+// "firebaseEventParameterCampaignTerm"
+// "firebaseEventParameterCurrency"
+// "firebaseEventParameterDynamicLinkAcceptTime"
+// "firebaseEventParameterDynamicLinkLinkid"
+// "firebaseEventParameterNotificationMessageDeviceTime"
+// "firebaseEventParameterNotificationMessageId"
+// "firebaseEventParameterNotificationMessageName"
+// "firebaseEventParameterNotificationMessageTime"
+// "firebaseEventParameterNotificationTopic"
+// "firebaseEventParameterPreviousAppVersion"
+// "firebaseEventParameterPreviousOsVersion"
+// "firebaseEventParameterPrice"
+// "firebaseEventParameterProductId"
+// "firebaseEventParameterQuantity"
+// "firebaseEventParameterValue"
+// "videoProvider"
+// "videoUrl"
+// "videoTitle"
+// "videoDuration"
+// "videoPercent"
+// "videoVisible"
+// "videoStatus"
+// "videoCurrentTime"
+// "scrollDepthThreshold"
+// "scrollDepthUnits"
+// "scrollDepthDirection"
+// "elementVisibilityRatio"
+// "elementVisibilityTime"
+// "elementVisibilityFirstTime"
+// "elementVisibilityRecentTime"
+// "requestPath"
+// "requestMethod"
+// "clientName"
+// "queryString"
+// "serverPageLocationUrl"
+// "serverPageLocationPath"
+// "serverPageLocationHostname"
func (c *AccountsContainersWorkspacesBuiltInVariablesCreateCall) Type(type_ ...string) *AccountsContainersWorkspacesBuiltInVariablesCreateCall {
c.urlParams_.SetMulti("type", append([]string{}, type_...))
return c
@@ -8905,9 +8903,9 @@ type AccountsContainersWorkspacesBuiltInVariablesDeleteCall struct {
// Delete: Deletes one or more GTM Built-In Variables.
//
-// - path: GTM BuiltInVariable's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/built_in_variables.
+// - path: GTM BuiltInVariable's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/built_in_variables.
func (r *AccountsContainersWorkspacesBuiltInVariablesService) Delete(path string) *AccountsContainersWorkspacesBuiltInVariablesDeleteCall {
c := &AccountsContainersWorkspacesBuiltInVariablesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -8918,119 +8916,120 @@ func (r *AccountsContainersWorkspacesBuiltInVariablesService) Delete(path string
// variables to delete.
//
// Possible values:
-// "builtInVariableTypeUnspecified"
-// "pageUrl"
-// "pageHostname"
-// "pagePath"
-// "referrer"
-// "event" - For web or mobile.
-// "clickElement"
-// "clickClasses"
-// "clickId"
-// "clickTarget"
-// "clickUrl"
-// "clickText"
-// "firstPartyServingUrl"
-// "formElement"
-// "formClasses"
-// "formId"
-// "formTarget"
-// "formUrl"
-// "formText"
-// "errorMessage"
-// "errorUrl"
-// "errorLine"
-// "newHistoryUrl"
-// "oldHistoryUrl"
-// "newHistoryFragment"
-// "oldHistoryFragment"
-// "newHistoryState"
-// "oldHistoryState"
-// "historySource"
-// "containerVersion" - For web or mobile.
-// "debugMode"
-// "randomNumber" - For web or mobile.
-// "containerId" - For web or mobile.
-// "appId"
-// "appName"
-// "appVersionCode"
-// "appVersionName"
-// "language"
-// "osVersion"
-// "platform"
-// "sdkVersion"
-// "deviceName"
-// "resolution"
-// "advertiserId"
-// "advertisingTrackingEnabled"
-// "htmlId"
-// "environmentName"
-// "ampBrowserLanguage"
-// "ampCanonicalPath"
-// "ampCanonicalUrl"
-// "ampCanonicalHost"
-// "ampReferrer"
-// "ampTitle"
-// "ampClientId"
-// "ampClientTimezone"
-// "ampClientTimestamp"
-// "ampClientScreenWidth"
-// "ampClientScreenHeight"
-// "ampClientScrollX"
-// "ampClientScrollY"
-// "ampClientMaxScrollX"
-// "ampClientMaxScrollY"
-// "ampTotalEngagedTime"
-// "ampPageViewId"
-// "ampPageLoadTime"
-// "ampPageDownloadTime"
-// "ampGtmEvent"
-// "eventName"
-// "firebaseEventParameterCampaign"
-// "firebaseEventParameterCampaignAclid"
-// "firebaseEventParameterCampaignAnid"
-// "firebaseEventParameterCampaignClickTimestamp"
-// "firebaseEventParameterCampaignContent"
-// "firebaseEventParameterCampaignCp1"
-// "firebaseEventParameterCampaignGclid"
-// "firebaseEventParameterCampaignSource"
-// "firebaseEventParameterCampaignTerm"
-// "firebaseEventParameterCurrency"
-// "firebaseEventParameterDynamicLinkAcceptTime"
-// "firebaseEventParameterDynamicLinkLinkid"
-// "firebaseEventParameterNotificationMessageDeviceTime"
-// "firebaseEventParameterNotificationMessageId"
-// "firebaseEventParameterNotificationMessageName"
-// "firebaseEventParameterNotificationMessageTime"
-// "firebaseEventParameterNotificationTopic"
-// "firebaseEventParameterPreviousAppVersion"
-// "firebaseEventParameterPreviousOsVersion"
-// "firebaseEventParameterPrice"
-// "firebaseEventParameterProductId"
-// "firebaseEventParameterQuantity"
-// "firebaseEventParameterValue"
-// "videoProvider"
-// "videoUrl"
-// "videoTitle"
-// "videoDuration"
-// "videoPercent"
-// "videoVisible"
-// "videoStatus"
-// "videoCurrentTime"
-// "scrollDepthThreshold"
-// "scrollDepthUnits"
-// "scrollDepthDirection"
-// "elementVisibilityRatio"
-// "elementVisibilityTime"
-// "elementVisibilityFirstTime"
-// "elementVisibilityRecentTime"
-// "requestPath"
-// "requestMethod"
-// "clientName"
-// "queryString"
-// "serverPageLocationUrl"
-// "serverPageLocationPath"
-// "serverPageLocationHostname"
+//
+// "builtInVariableTypeUnspecified"
+// "pageUrl"
+// "pageHostname"
+// "pagePath"
+// "referrer"
+// "event" - For web or mobile.
+// "clickElement"
+// "clickClasses"
+// "clickId"
+// "clickTarget"
+// "clickUrl"
+// "clickText"
+// "firstPartyServingUrl"
+// "formElement"
+// "formClasses"
+// "formId"
+// "formTarget"
+// "formUrl"
+// "formText"
+// "errorMessage"
+// "errorUrl"
+// "errorLine"
+// "newHistoryUrl"
+// "oldHistoryUrl"
+// "newHistoryFragment"
+// "oldHistoryFragment"
+// "newHistoryState"
+// "oldHistoryState"
+// "historySource"
+// "containerVersion" - For web or mobile.
+// "debugMode"
+// "randomNumber" - For web or mobile.
+// "containerId" - For web or mobile.
+// "appId"
+// "appName"
+// "appVersionCode"
+// "appVersionName"
+// "language"
+// "osVersion"
+// "platform"
+// "sdkVersion"
+// "deviceName"
+// "resolution"
+// "advertiserId"
+// "advertisingTrackingEnabled"
+// "htmlId"
+// "environmentName"
+// "ampBrowserLanguage"
+// "ampCanonicalPath"
+// "ampCanonicalUrl"
+// "ampCanonicalHost"
+// "ampReferrer"
+// "ampTitle"
+// "ampClientId"
+// "ampClientTimezone"
+// "ampClientTimestamp"
+// "ampClientScreenWidth"
+// "ampClientScreenHeight"
+// "ampClientScrollX"
+// "ampClientScrollY"
+// "ampClientMaxScrollX"
+// "ampClientMaxScrollY"
+// "ampTotalEngagedTime"
+// "ampPageViewId"
+// "ampPageLoadTime"
+// "ampPageDownloadTime"
+// "ampGtmEvent"
+// "eventName"
+// "firebaseEventParameterCampaign"
+// "firebaseEventParameterCampaignAclid"
+// "firebaseEventParameterCampaignAnid"
+// "firebaseEventParameterCampaignClickTimestamp"
+// "firebaseEventParameterCampaignContent"
+// "firebaseEventParameterCampaignCp1"
+// "firebaseEventParameterCampaignGclid"
+// "firebaseEventParameterCampaignSource"
+// "firebaseEventParameterCampaignTerm"
+// "firebaseEventParameterCurrency"
+// "firebaseEventParameterDynamicLinkAcceptTime"
+// "firebaseEventParameterDynamicLinkLinkid"
+// "firebaseEventParameterNotificationMessageDeviceTime"
+// "firebaseEventParameterNotificationMessageId"
+// "firebaseEventParameterNotificationMessageName"
+// "firebaseEventParameterNotificationMessageTime"
+// "firebaseEventParameterNotificationTopic"
+// "firebaseEventParameterPreviousAppVersion"
+// "firebaseEventParameterPreviousOsVersion"
+// "firebaseEventParameterPrice"
+// "firebaseEventParameterProductId"
+// "firebaseEventParameterQuantity"
+// "firebaseEventParameterValue"
+// "videoProvider"
+// "videoUrl"
+// "videoTitle"
+// "videoDuration"
+// "videoPercent"
+// "videoVisible"
+// "videoStatus"
+// "videoCurrentTime"
+// "scrollDepthThreshold"
+// "scrollDepthUnits"
+// "scrollDepthDirection"
+// "elementVisibilityRatio"
+// "elementVisibilityTime"
+// "elementVisibilityFirstTime"
+// "elementVisibilityRecentTime"
+// "requestPath"
+// "requestMethod"
+// "clientName"
+// "queryString"
+// "serverPageLocationUrl"
+// "serverPageLocationPath"
+// "serverPageLocationHostname"
func (c *AccountsContainersWorkspacesBuiltInVariablesDeleteCall) Type(type_ ...string) *AccountsContainersWorkspacesBuiltInVariablesDeleteCall {
c.urlParams_.SetMulti("type", append([]string{}, type_...))
return c
@@ -9370,9 +9369,9 @@ type AccountsContainersWorkspacesBuiltInVariablesListCall struct {
// List: Lists all the enabled Built-In Variables of a GTM Container.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesBuiltInVariablesService) List(parent string) *AccountsContainersWorkspacesBuiltInVariablesListCall {
c := &AccountsContainersWorkspacesBuiltInVariablesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -9553,9 +9552,9 @@ type AccountsContainersWorkspacesBuiltInVariablesRevertCall struct {
// Revert: Reverts changes to a GTM Built-In Variables in a GTM
// Workspace.
//
-// - path: GTM BuiltInVariable's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/built_in_variables.
+// - path: GTM BuiltInVariable's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/built_in_variables.
func (r *AccountsContainersWorkspacesBuiltInVariablesService) Revert(path string) *AccountsContainersWorkspacesBuiltInVariablesRevertCall {
c := &AccountsContainersWorkspacesBuiltInVariablesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -9566,119 +9565,120 @@ func (r *AccountsContainersWorkspacesBuiltInVariablesService) Revert(path string
// variable to revert.
//
// Possible values:
-// "builtInVariableTypeUnspecified"
-// "pageUrl"
-// "pageHostname"
-// "pagePath"
-// "referrer"
-// "event" - For web or mobile.
-// "clickElement"
-// "clickClasses"
-// "clickId"
-// "clickTarget"
-// "clickUrl"
-// "clickText"
-// "firstPartyServingUrl"
-// "formElement"
-// "formClasses"
-// "formId"
-// "formTarget"
-// "formUrl"
-// "formText"
-// "errorMessage"
-// "errorUrl"
-// "errorLine"
-// "newHistoryUrl"
-// "oldHistoryUrl"
-// "newHistoryFragment"
-// "oldHistoryFragment"
-// "newHistoryState"
-// "oldHistoryState"
-// "historySource"
-// "containerVersion" - For web or mobile.
-// "debugMode"
-// "randomNumber" - For web or mobile.
-// "containerId" - For web or mobile.
-// "appId"
-// "appName"
-// "appVersionCode"
-// "appVersionName"
-// "language"
-// "osVersion"
-// "platform"
-// "sdkVersion"
-// "deviceName"
-// "resolution"
-// "advertiserId"
-// "advertisingTrackingEnabled"
-// "htmlId"
-// "environmentName"
-// "ampBrowserLanguage"
-// "ampCanonicalPath"
-// "ampCanonicalUrl"
-// "ampCanonicalHost"
-// "ampReferrer"
-// "ampTitle"
-// "ampClientId"
-// "ampClientTimezone"
-// "ampClientTimestamp"
-// "ampClientScreenWidth"
-// "ampClientScreenHeight"
-// "ampClientScrollX"
-// "ampClientScrollY"
-// "ampClientMaxScrollX"
-// "ampClientMaxScrollY"
-// "ampTotalEngagedTime"
-// "ampPageViewId"
-// "ampPageLoadTime"
-// "ampPageDownloadTime"
-// "ampGtmEvent"
-// "eventName"
-// "firebaseEventParameterCampaign"
-// "firebaseEventParameterCampaignAclid"
-// "firebaseEventParameterCampaignAnid"
-// "firebaseEventParameterCampaignClickTimestamp"
-// "firebaseEventParameterCampaignContent"
-// "firebaseEventParameterCampaignCp1"
-// "firebaseEventParameterCampaignGclid"
-// "firebaseEventParameterCampaignSource"
-// "firebaseEventParameterCampaignTerm"
-// "firebaseEventParameterCurrency"
-// "firebaseEventParameterDynamicLinkAcceptTime"
-// "firebaseEventParameterDynamicLinkLinkid"
-// "firebaseEventParameterNotificationMessageDeviceTime"
-// "firebaseEventParameterNotificationMessageId"
-// "firebaseEventParameterNotificationMessageName"
-// "firebaseEventParameterNotificationMessageTime"
-// "firebaseEventParameterNotificationTopic"
-// "firebaseEventParameterPreviousAppVersion"
-// "firebaseEventParameterPreviousOsVersion"
-// "firebaseEventParameterPrice"
-// "firebaseEventParameterProductId"
-// "firebaseEventParameterQuantity"
-// "firebaseEventParameterValue"
-// "videoProvider"
-// "videoUrl"
-// "videoTitle"
-// "videoDuration"
-// "videoPercent"
-// "videoVisible"
-// "videoStatus"
-// "videoCurrentTime"
-// "scrollDepthThreshold"
-// "scrollDepthUnits"
-// "scrollDepthDirection"
-// "elementVisibilityRatio"
-// "elementVisibilityTime"
-// "elementVisibilityFirstTime"
-// "elementVisibilityRecentTime"
-// "requestPath"
-// "requestMethod"
-// "clientName"
-// "queryString"
-// "serverPageLocationUrl"
-// "serverPageLocationPath"
-// "serverPageLocationHostname"
+//
+// "builtInVariableTypeUnspecified"
+// "pageUrl"
+// "pageHostname"
+// "pagePath"
+// "referrer"
+// "event" - For web or mobile.
+// "clickElement"
+// "clickClasses"
+// "clickId"
+// "clickTarget"
+// "clickUrl"
+// "clickText"
+// "firstPartyServingUrl"
+// "formElement"
+// "formClasses"
+// "formId"
+// "formTarget"
+// "formUrl"
+// "formText"
+// "errorMessage"
+// "errorUrl"
+// "errorLine"
+// "newHistoryUrl"
+// "oldHistoryUrl"
+// "newHistoryFragment"
+// "oldHistoryFragment"
+// "newHistoryState"
+// "oldHistoryState"
+// "historySource"
+// "containerVersion" - For web or mobile.
+// "debugMode"
+// "randomNumber" - For web or mobile.
+// "containerId" - For web or mobile.
+// "appId"
+// "appName"
+// "appVersionCode"
+// "appVersionName"
+// "language"
+// "osVersion"
+// "platform"
+// "sdkVersion"
+// "deviceName"
+// "resolution"
+// "advertiserId"
+// "advertisingTrackingEnabled"
+// "htmlId"
+// "environmentName"
+// "ampBrowserLanguage"
+// "ampCanonicalPath"
+// "ampCanonicalUrl"
+// "ampCanonicalHost"
+// "ampReferrer"
+// "ampTitle"
+// "ampClientId"
+// "ampClientTimezone"
+// "ampClientTimestamp"
+// "ampClientScreenWidth"
+// "ampClientScreenHeight"
+// "ampClientScrollX"
+// "ampClientScrollY"
+// "ampClientMaxScrollX"
+// "ampClientMaxScrollY"
+// "ampTotalEngagedTime"
+// "ampPageViewId"
+// "ampPageLoadTime"
+// "ampPageDownloadTime"
+// "ampGtmEvent"
+// "eventName"
+// "firebaseEventParameterCampaign"
+// "firebaseEventParameterCampaignAclid"
+// "firebaseEventParameterCampaignAnid"
+// "firebaseEventParameterCampaignClickTimestamp"
+// "firebaseEventParameterCampaignContent"
+// "firebaseEventParameterCampaignCp1"
+// "firebaseEventParameterCampaignGclid"
+// "firebaseEventParameterCampaignSource"
+// "firebaseEventParameterCampaignTerm"
+// "firebaseEventParameterCurrency"
+// "firebaseEventParameterDynamicLinkAcceptTime"
+// "firebaseEventParameterDynamicLinkLinkid"
+// "firebaseEventParameterNotificationMessageDeviceTime"
+// "firebaseEventParameterNotificationMessageId"
+// "firebaseEventParameterNotificationMessageName"
+// "firebaseEventParameterNotificationMessageTime"
+// "firebaseEventParameterNotificationTopic"
+// "firebaseEventParameterPreviousAppVersion"
+// "firebaseEventParameterPreviousOsVersion"
+// "firebaseEventParameterPrice"
+// "firebaseEventParameterProductId"
+// "firebaseEventParameterQuantity"
+// "firebaseEventParameterValue"
+// "videoProvider"
+// "videoUrl"
+// "videoTitle"
+// "videoDuration"
+// "videoPercent"
+// "videoVisible"
+// "videoStatus"
+// "videoCurrentTime"
+// "scrollDepthThreshold"
+// "scrollDepthUnits"
+// "scrollDepthDirection"
+// "elementVisibilityRatio"
+// "elementVisibilityTime"
+// "elementVisibilityFirstTime"
+// "elementVisibilityRecentTime"
+// "requestPath"
+// "requestMethod"
+// "clientName"
+// "queryString"
+// "serverPageLocationUrl"
+// "serverPageLocationPath"
+// "serverPageLocationHostname"
func (c *AccountsContainersWorkspacesBuiltInVariablesRevertCall) Type(type_ string) *AccountsContainersWorkspacesBuiltInVariablesRevertCall {
c.urlParams_.Set("type", type_)
return c
@@ -10045,9 +10045,9 @@ type AccountsContainersWorkspacesClientsCreateCall struct {
// Create: Creates a GTM Client.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesClientsService) Create(parent string, client *Client) *AccountsContainersWorkspacesClientsCreateCall {
c := &AccountsContainersWorkspacesClientsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10188,9 +10188,9 @@ type AccountsContainersWorkspacesClientsDeleteCall struct {
// Delete: Deletes a GTM Client.
//
-// - path: GTM Client's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/clients/{client_id}.
+// - path: GTM Client's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/clients/{client_id}.
func (r *AccountsContainersWorkspacesClientsService) Delete(path string) *AccountsContainersWorkspacesClientsDeleteCall {
c := &AccountsContainersWorkspacesClientsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -10295,9 +10295,9 @@ type AccountsContainersWorkspacesClientsGetCall struct {
// Get: Gets a GTM Client.
//
-// - path: GTM Client's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/clients/{client_id}.
+// - path: GTM Client's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/clients/{client_id}.
func (r *AccountsContainersWorkspacesClientsService) Get(path string) *AccountsContainersWorkspacesClientsGetCall {
c := &AccountsContainersWorkspacesClientsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -10444,9 +10444,9 @@ type AccountsContainersWorkspacesClientsListCall struct {
// List: Lists all GTM Clients of a GTM container workspace.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesClientsService) List(parent string) *AccountsContainersWorkspacesClientsListCall {
c := &AccountsContainersWorkspacesClientsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -10625,9 +10625,9 @@ type AccountsContainersWorkspacesClientsRevertCall struct {
// Revert: Reverts changes to a GTM Client in a GTM Workspace.
//
-// - path: GTM Client's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/clients/{client_id}.
+// - path: GTM Client's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/clients/{client_id}.
func (r *AccountsContainersWorkspacesClientsService) Revert(path string) *AccountsContainersWorkspacesClientsRevertCall {
c := &AccountsContainersWorkspacesClientsRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -10772,9 +10772,9 @@ type AccountsContainersWorkspacesClientsUpdateCall struct {
// Update: Updates a GTM Client.
//
-// - path: GTM Client's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/clients/{client_id}.
+// - path: GTM Client's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/clients/{client_id}.
func (r *AccountsContainersWorkspacesClientsService) Update(path string, client *Client) *AccountsContainersWorkspacesClientsUpdateCall {
c := &AccountsContainersWorkspacesClientsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -10928,9 +10928,9 @@ type AccountsContainersWorkspacesFoldersCreateCall struct {
// Create: Creates a GTM Folder.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesFoldersService) Create(parent string, folder *Folder) *AccountsContainersWorkspacesFoldersCreateCall {
c := &AccountsContainersWorkspacesFoldersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11071,9 +11071,9 @@ type AccountsContainersWorkspacesFoldersDeleteCall struct {
// Delete: Deletes a GTM Folder.
//
-// - path: GTM Folder's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/folders/{folder_id}.
+// - path: GTM Folder's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/folders/{folder_id}.
func (r *AccountsContainersWorkspacesFoldersService) Delete(path string) *AccountsContainersWorkspacesFoldersDeleteCall {
c := &AccountsContainersWorkspacesFoldersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -11177,9 +11177,9 @@ type AccountsContainersWorkspacesFoldersEntitiesCall struct {
// Entities: List all entities in a GTM Folder.
//
-// - path: GTM Folder's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/folders/{folder_id}.
+// - path: GTM Folder's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/folders/{folder_id}.
func (r *AccountsContainersWorkspacesFoldersService) Entities(path string) *AccountsContainersWorkspacesFoldersEntitiesCall {
c := &AccountsContainersWorkspacesFoldersEntitiesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -11346,9 +11346,9 @@ type AccountsContainersWorkspacesFoldersGetCall struct {
// Get: Gets a GTM Folder.
//
-// - path: GTM Folder's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/folders/{folder_id}.
+// - path: GTM Folder's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/folders/{folder_id}.
func (r *AccountsContainersWorkspacesFoldersService) Get(path string) *AccountsContainersWorkspacesFoldersGetCall {
c := &AccountsContainersWorkspacesFoldersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -11495,9 +11495,9 @@ type AccountsContainersWorkspacesFoldersListCall struct {
// List: Lists all GTM Folders of a Container.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesFoldersService) List(parent string) *AccountsContainersWorkspacesFoldersListCall {
c := &AccountsContainersWorkspacesFoldersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -11677,9 +11677,9 @@ type AccountsContainersWorkspacesFoldersMoveEntitiesToFolderCall struct {
// MoveEntitiesToFolder: Moves entities to a GTM Folder.
//
-// - path: GTM Folder's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/folders/{folder_id}.
+// - path: GTM Folder's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/folders/{folder_id}.
func (r *AccountsContainersWorkspacesFoldersService) MoveEntitiesToFolder(path string, folder *Folder) *AccountsContainersWorkspacesFoldersMoveEntitiesToFolderCall {
c := &AccountsContainersWorkspacesFoldersMoveEntitiesToFolderCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -11831,9 +11831,9 @@ type AccountsContainersWorkspacesFoldersRevertCall struct {
// Revert: Reverts changes to a GTM Folder in a GTM Workspace.
//
-// - path: GTM Folder's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/folders/{folder_id}.
+// - path: GTM Folder's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/folders/{folder_id}.
func (r *AccountsContainersWorkspacesFoldersService) Revert(path string) *AccountsContainersWorkspacesFoldersRevertCall {
c := &AccountsContainersWorkspacesFoldersRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -11978,9 +11978,9 @@ type AccountsContainersWorkspacesFoldersUpdateCall struct {
// Update: Updates a GTM Folder.
//
-// - path: GTM Folder's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/folders/{folder_id}.
+// - path: GTM Folder's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/folders/{folder_id}.
func (r *AccountsContainersWorkspacesFoldersService) Update(path string, folder *Folder) *AccountsContainersWorkspacesFoldersUpdateCall {
c := &AccountsContainersWorkspacesFoldersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -12134,9 +12134,9 @@ type AccountsContainersWorkspacesTagsCreateCall struct {
// Create: Creates a GTM Tag.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesTagsService) Create(parent string, tag *Tag) *AccountsContainersWorkspacesTagsCreateCall {
c := &AccountsContainersWorkspacesTagsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12277,9 +12277,9 @@ type AccountsContainersWorkspacesTagsDeleteCall struct {
// Delete: Deletes a GTM Tag.
//
-// - path: GTM Tag's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/tags/{tag_id}.
+// - path: GTM Tag's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/tags/{tag_id}.
func (r *AccountsContainersWorkspacesTagsService) Delete(path string) *AccountsContainersWorkspacesTagsDeleteCall {
c := &AccountsContainersWorkspacesTagsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -12384,9 +12384,9 @@ type AccountsContainersWorkspacesTagsGetCall struct {
// Get: Gets a GTM Tag.
//
-// - path: GTM Tag's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/tags/{tag_id}.
+// - path: GTM Tag's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/tags/{tag_id}.
func (r *AccountsContainersWorkspacesTagsService) Get(path string) *AccountsContainersWorkspacesTagsGetCall {
c := &AccountsContainersWorkspacesTagsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -12533,9 +12533,9 @@ type AccountsContainersWorkspacesTagsListCall struct {
// List: Lists all GTM Tags of a Container.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesTagsService) List(parent string) *AccountsContainersWorkspacesTagsListCall {
c := &AccountsContainersWorkspacesTagsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -12714,9 +12714,9 @@ type AccountsContainersWorkspacesTagsRevertCall struct {
// Revert: Reverts changes to a GTM Tag in a GTM Workspace.
//
-// - path: GTM Tag's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/tags/{tag_id}.
+// - path: GTM Tag's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/tags/{tag_id}.
func (r *AccountsContainersWorkspacesTagsService) Revert(path string) *AccountsContainersWorkspacesTagsRevertCall {
c := &AccountsContainersWorkspacesTagsRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -12861,9 +12861,9 @@ type AccountsContainersWorkspacesTagsUpdateCall struct {
// Update: Updates a GTM Tag.
//
-// - path: GTM Tag's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/tags/{tag_id}.
+// - path: GTM Tag's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/tags/{tag_id}.
func (r *AccountsContainersWorkspacesTagsService) Update(path string, tag *Tag) *AccountsContainersWorkspacesTagsUpdateCall {
c := &AccountsContainersWorkspacesTagsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -13017,9 +13017,9 @@ type AccountsContainersWorkspacesTemplatesCreateCall struct {
// Create: Creates a GTM Custom Template.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesTemplatesService) Create(parent string, customtemplate *CustomTemplate) *AccountsContainersWorkspacesTemplatesCreateCall {
c := &AccountsContainersWorkspacesTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13160,9 +13160,9 @@ type AccountsContainersWorkspacesTemplatesDeleteCall struct {
// Delete: Deletes a GTM Template.
//
-// - path: GTM Custom Template's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/templates/{template_id}.
+// - path: GTM Custom Template's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/templates/{template_id}.
func (r *AccountsContainersWorkspacesTemplatesService) Delete(path string) *AccountsContainersWorkspacesTemplatesDeleteCall {
c := &AccountsContainersWorkspacesTemplatesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -13267,9 +13267,9 @@ type AccountsContainersWorkspacesTemplatesGetCall struct {
// Get: Gets a GTM Template.
//
-// - path: GTM Custom Template's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/templates/{template_id}.
+// - path: GTM Custom Template's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/templates/{template_id}.
func (r *AccountsContainersWorkspacesTemplatesService) Get(path string) *AccountsContainersWorkspacesTemplatesGetCall {
c := &AccountsContainersWorkspacesTemplatesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -13416,9 +13416,9 @@ type AccountsContainersWorkspacesTemplatesListCall struct {
// List: Lists all GTM Templates of a GTM container workspace.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesTemplatesService) List(parent string) *AccountsContainersWorkspacesTemplatesListCall {
c := &AccountsContainersWorkspacesTemplatesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -13597,9 +13597,9 @@ type AccountsContainersWorkspacesTemplatesRevertCall struct {
// Revert: Reverts changes to a GTM Template in a GTM Workspace.
//
-// - path: GTM Custom Template's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/templates/{template_id}.
+// - path: GTM Custom Template's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/templates/{template_id}.
func (r *AccountsContainersWorkspacesTemplatesService) Revert(path string) *AccountsContainersWorkspacesTemplatesRevertCall {
c := &AccountsContainersWorkspacesTemplatesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -13745,9 +13745,9 @@ type AccountsContainersWorkspacesTemplatesUpdateCall struct {
// Update: Updates a GTM Template.
//
-// - path: GTM Custom Template's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/templates/{template_id}.
+// - path: GTM Custom Template's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/templates/{template_id}.
func (r *AccountsContainersWorkspacesTemplatesService) Update(path string, customtemplate *CustomTemplate) *AccountsContainersWorkspacesTemplatesUpdateCall {
c := &AccountsContainersWorkspacesTemplatesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -13902,9 +13902,9 @@ type AccountsContainersWorkspacesTriggersCreateCall struct {
// Create: Creates a GTM Trigger.
//
-// - parent: GTM Workspaces's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspaces's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesTriggersService) Create(parent string, trigger *Trigger) *AccountsContainersWorkspacesTriggersCreateCall {
c := &AccountsContainersWorkspacesTriggersCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14045,9 +14045,9 @@ type AccountsContainersWorkspacesTriggersDeleteCall struct {
// Delete: Deletes a GTM Trigger.
//
-// - path: GTM Trigger's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/triggers/{trigger_id}.
+// - path: GTM Trigger's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/triggers/{trigger_id}.
func (r *AccountsContainersWorkspacesTriggersService) Delete(path string) *AccountsContainersWorkspacesTriggersDeleteCall {
c := &AccountsContainersWorkspacesTriggersDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -14152,9 +14152,9 @@ type AccountsContainersWorkspacesTriggersGetCall struct {
// Get: Gets a GTM Trigger.
//
-// - path: GTM Trigger's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/triggers/{trigger_id}.
+// - path: GTM Trigger's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/triggers/{trigger_id}.
func (r *AccountsContainersWorkspacesTriggersService) Get(path string) *AccountsContainersWorkspacesTriggersGetCall {
c := &AccountsContainersWorkspacesTriggersGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -14301,9 +14301,9 @@ type AccountsContainersWorkspacesTriggersListCall struct {
// List: Lists all GTM Triggers of a Container.
//
-// - parent: GTM Workspaces's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspaces's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesTriggersService) List(parent string) *AccountsContainersWorkspacesTriggersListCall {
c := &AccountsContainersWorkspacesTriggersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14482,9 +14482,9 @@ type AccountsContainersWorkspacesTriggersRevertCall struct {
// Revert: Reverts changes to a GTM Trigger in a GTM Workspace.
//
-// - path: GTM Trigger's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/triggers/{trigger_id}.
+// - path: GTM Trigger's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/triggers/{trigger_id}.
func (r *AccountsContainersWorkspacesTriggersService) Revert(path string) *AccountsContainersWorkspacesTriggersRevertCall {
c := &AccountsContainersWorkspacesTriggersRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -14630,9 +14630,9 @@ type AccountsContainersWorkspacesTriggersUpdateCall struct {
// Update: Updates a GTM Trigger.
//
-// - path: GTM Trigger's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/triggers/{trigger_id}.
+// - path: GTM Trigger's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/triggers/{trigger_id}.
func (r *AccountsContainersWorkspacesTriggersService) Update(path string, trigger *Trigger) *AccountsContainersWorkspacesTriggersUpdateCall {
c := &AccountsContainersWorkspacesTriggersUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -14787,9 +14787,9 @@ type AccountsContainersWorkspacesVariablesCreateCall struct {
// Create: Creates a GTM Variable.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesVariablesService) Create(parent string, variable *Variable) *AccountsContainersWorkspacesVariablesCreateCall {
c := &AccountsContainersWorkspacesVariablesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14930,9 +14930,9 @@ type AccountsContainersWorkspacesVariablesDeleteCall struct {
// Delete: Deletes a GTM Variable.
//
-// - path: GTM Variable's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/variables/{variable_id}.
+// - path: GTM Variable's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/variables/{variable_id}.
func (r *AccountsContainersWorkspacesVariablesService) Delete(path string) *AccountsContainersWorkspacesVariablesDeleteCall {
c := &AccountsContainersWorkspacesVariablesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -15037,9 +15037,9 @@ type AccountsContainersWorkspacesVariablesGetCall struct {
// Get: Gets a GTM Variable.
//
-// - path: GTM Variable's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/variables/{variable_id}.
+// - path: GTM Variable's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/variables/{variable_id}.
func (r *AccountsContainersWorkspacesVariablesService) Get(path string) *AccountsContainersWorkspacesVariablesGetCall {
c := &AccountsContainersWorkspacesVariablesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -15186,9 +15186,9 @@ type AccountsContainersWorkspacesVariablesListCall struct {
// List: Lists all GTM Variables of a Container.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesVariablesService) List(parent string) *AccountsContainersWorkspacesVariablesListCall {
c := &AccountsContainersWorkspacesVariablesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15367,9 +15367,9 @@ type AccountsContainersWorkspacesVariablesRevertCall struct {
// Revert: Reverts changes to a GTM Variable in a GTM Workspace.
//
-// - path: GTM Variable's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/variables/{variable_id}.
+// - path: GTM Variable's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/variables/{variable_id}.
func (r *AccountsContainersWorkspacesVariablesService) Revert(path string) *AccountsContainersWorkspacesVariablesRevertCall {
c := &AccountsContainersWorkspacesVariablesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -15515,9 +15515,9 @@ type AccountsContainersWorkspacesVariablesUpdateCall struct {
// Update: Updates a GTM Variable.
//
-// - path: GTM Variable's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/variables/{variable_id}.
+// - path: GTM Variable's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/variables/{variable_id}.
func (r *AccountsContainersWorkspacesVariablesService) Update(path string, variable *Variable) *AccountsContainersWorkspacesVariablesUpdateCall {
c := &AccountsContainersWorkspacesVariablesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -15672,9 +15672,9 @@ type AccountsContainersWorkspacesZonesCreateCall struct {
// Create: Creates a GTM Zone.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesZonesService) Create(parent string, zone *Zone) *AccountsContainersWorkspacesZonesCreateCall {
c := &AccountsContainersWorkspacesZonesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15815,9 +15815,9 @@ type AccountsContainersWorkspacesZonesDeleteCall struct {
// Delete: Deletes a GTM Zone.
//
-// - path: GTM Zone's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/zones/{zone_id}.
+// - path: GTM Zone's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/zones/{zone_id}.
func (r *AccountsContainersWorkspacesZonesService) Delete(path string) *AccountsContainersWorkspacesZonesDeleteCall {
c := &AccountsContainersWorkspacesZonesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -15922,9 +15922,9 @@ type AccountsContainersWorkspacesZonesGetCall struct {
// Get: Gets a GTM Zone.
//
-// - path: GTM Zone's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/zones/{zone_id}.
+// - path: GTM Zone's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/zones/{zone_id}.
func (r *AccountsContainersWorkspacesZonesService) Get(path string) *AccountsContainersWorkspacesZonesGetCall {
c := &AccountsContainersWorkspacesZonesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -16071,9 +16071,9 @@ type AccountsContainersWorkspacesZonesListCall struct {
// List: Lists all GTM Zones of a GTM container workspace.
//
-// - parent: GTM Workspace's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}.
+// - parent: GTM Workspace's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}.
func (r *AccountsContainersWorkspacesZonesService) List(parent string) *AccountsContainersWorkspacesZonesListCall {
c := &AccountsContainersWorkspacesZonesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16252,9 +16252,9 @@ type AccountsContainersWorkspacesZonesRevertCall struct {
// Revert: Reverts changes to a GTM Zone in a GTM Workspace.
//
-// - path: GTM Zone's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/zones/{zone_id}.
+// - path: GTM Zone's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/zones/{zone_id}.
func (r *AccountsContainersWorkspacesZonesService) Revert(path string) *AccountsContainersWorkspacesZonesRevertCall {
c := &AccountsContainersWorkspacesZonesRevertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -16399,9 +16399,9 @@ type AccountsContainersWorkspacesZonesUpdateCall struct {
// Update: Updates a GTM Zone.
//
-// - path: GTM Zone's API relative path. Example:
-// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
-// e_id}/zones/{zone_id}.
+// - path: GTM Zone's API relative path. Example:
+// accounts/{account_id}/containers/{container_id}/workspaces/{workspac
+// e_id}/zones/{zone_id}.
func (r *AccountsContainersWorkspacesZonesService) Update(path string, zone *Zone) *AccountsContainersWorkspacesZonesUpdateCall {
c := &AccountsContainersWorkspacesZonesUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -16555,8 +16555,8 @@ type AccountsUserPermissionsCreateCall struct {
// Create: Creates a user's Account & Container access.
//
-// - parent: GTM Account's API relative path. Example:
-// accounts/{account_id}.
+// - parent: GTM Account's API relative path. Example:
+// accounts/{account_id}.
func (r *AccountsUserPermissionsService) Create(parent string, userpermission *UserPermission) *AccountsUserPermissionsCreateCall {
c := &AccountsUserPermissionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16698,8 +16698,8 @@ type AccountsUserPermissionsDeleteCall struct {
// Delete: Removes a user from the account, revoking access to it and
// all of its containers.
//
-// - path: GTM UserPermission's API relative path. Example:
-// accounts/{account_id}/user_permissions/{user_permission_id}.
+// - path: GTM UserPermission's API relative path. Example:
+// accounts/{account_id}/user_permissions/{user_permission_id}.
func (r *AccountsUserPermissionsService) Delete(path string) *AccountsUserPermissionsDeleteCall {
c := &AccountsUserPermissionsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -16804,8 +16804,8 @@ type AccountsUserPermissionsGetCall struct {
// Get: Gets a user's Account & Container access.
//
-// - path: GTM UserPermission's API relative path. Example:
-// accounts/{account_id}/user_permissions/{user_permission_id}.
+// - path: GTM UserPermission's API relative path. Example:
+// accounts/{account_id}/user_permissions/{user_permission_id}.
func (r *AccountsUserPermissionsService) Get(path string) *AccountsUserPermissionsGetCall {
c := &AccountsUserPermissionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
@@ -16952,8 +16952,8 @@ type AccountsUserPermissionsListCall struct {
// List: List all users that have access to the account along with
// Account and Container user access granted to each of them.
//
-// - parent: GTM Accounts's API relative path. Example:
-// accounts/{account_id}.
+// - parent: GTM Accounts's API relative path. Example:
+// accounts/{account_id}.
func (r *AccountsUserPermissionsService) List(parent string) *AccountsUserPermissionsListCall {
c := &AccountsUserPermissionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17132,8 +17132,8 @@ type AccountsUserPermissionsUpdateCall struct {
// Update: Updates a user's Account & Container access.
//
-// - path: GTM UserPermission's API relative path. Example:
-// accounts/{account_id}/user_permissions/{user_permission_id}.
+// - path: GTM UserPermission's API relative path. Example:
+// accounts/{account_id}/user_permissions/{user_permission_id}.
func (r *AccountsUserPermissionsService) Update(path string, userpermission *UserPermission) *AccountsUserPermissionsUpdateCall {
c := &AccountsUserPermissionsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.path = path
diff --git a/tasks/v1/tasks-gen.go b/tasks/v1/tasks-gen.go
index 0bf2d99dd34..549325ae276 100644
--- a/tasks/v1/tasks-gen.go
+++ b/tasks/v1/tasks-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/tasks/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tasks/v1"
-// ...
-// ctx := context.Background()
-// tasksService, err := tasks.NewService(ctx)
+// import "google.golang.org/api/tasks/v1"
+// ...
+// ctx := context.Background()
+// tasksService, err := tasks.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// tasksService, err := tasks.NewService(ctx, option.WithScopes(tasks.TasksReadonlyScope))
+// tasksService, err := tasks.NewService(ctx, option.WithScopes(tasks.TasksReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tasksService, err := tasks.NewService(ctx, option.WithAPIKey("AIza..."))
+// tasksService, err := tasks.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tasksService, err := tasks.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tasksService, err := tasks.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tasks // import "google.golang.org/api/tasks/v1"
diff --git a/testing/v1/testing-api.json b/testing/v1/testing-api.json
index 504ada739ca..1cd1332d358 100644
--- a/testing/v1/testing-api.json
+++ b/testing/v1/testing-api.json
@@ -282,7 +282,7 @@
}
}
},
- "revision": "20220419",
+ "revision": "20220806",
"rootUrl": "https://testing.googleapis.com/",
"schemas": {
"Account": {
@@ -1402,7 +1402,7 @@
"id": "ManualSharding",
"properties": {
"testTargetsForShard": {
- "description": "Required. Group of packages, classes, and/or test methods to be run for each shard. When any physical devices are selected, the number of test_targets_for_shard must be \u003e= 1 and \u003c= 50. When no physical devices are selected, the number must be \u003e= 1 and \u003c= 500.",
+ "description": "Required. Group of packages, classes, and/or test methods to be run for each manually-created shard. You must specify at least one shard if this field is present. When you select one or more physical devices, the number of repeated test_targets_for_shard must be \u003c= 50. When you select one or more ARM virtual devices, it must be \u003c= 50. When you select only x86 virtual devices, it must be \u003c= 500.",
"items": {
"$ref": "TestTargetsForShard"
},
@@ -2151,11 +2151,11 @@
"type": "object"
},
"UniformSharding": {
- "description": "Uniformly shards test cases given a total number of shards. For Instrumentation test, it will be translated to \"-e numShard\" \"-e shardIndex\" AndroidJUnitRunner arguments. Based on the sharding mechanism AndroidJUnitRunner uses, there is no guarantee that test cases will be distributed uniformly across all shards. With uniform sharding enabled, specifying these sharding arguments via environment_variables is invalid.",
+ "description": "Uniformly shards test cases given a total number of shards. For instrumentation tests, it will be translated to \"-e numShard\" and \"-e shardIndex\" AndroidJUnitRunner arguments. With uniform sharding enabled, specifying either of these sharding arguments via `environment_variables` is invalid. Based on the sharding mechanism AndroidJUnitRunner uses, there is no guarantee that test cases will be distributed uniformly across all shards.",
"id": "UniformSharding",
"properties": {
"numShards": {
- "description": "Required. Total number of shards. When any physical devices are selected, the number must be \u003e= 1 and \u003c= 50. When no physical devices are selected, the number must be \u003e= 1 and \u003c= 500.",
+ "description": "Required. The total number of shards to create. This must always be a positive number that is no greater than the total number of test cases. When you select one or more physical devices, the number of shards must be \u003c= 50. When you select one or more ARM virtual devices, it must be \u003c= 50. When you select only x86 virtual devices, it must be \u003c= 500.",
"format": "int32",
"type": "integer"
}
diff --git a/testing/v1/testing-gen.go b/testing/v1/testing-gen.go
index 2500848352e..3b2c76312f3 100644
--- a/testing/v1/testing-gen.go
+++ b/testing/v1/testing-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/cloud-test-lab/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/testing/v1"
-// ...
-// ctx := context.Background()
-// testingService, err := testing.NewService(ctx)
+// import "google.golang.org/api/testing/v1"
+// ...
+// ctx := context.Background()
+// testingService, err := testing.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// testingService, err := testing.NewService(ctx, option.WithScopes(testing.CloudPlatformReadOnlyScope))
+// testingService, err := testing.NewService(ctx, option.WithScopes(testing.CloudPlatformReadOnlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// testingService, err := testing.NewService(ctx, option.WithAPIKey("AIza..."))
+// testingService, err := testing.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// testingService, err := testing.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// testingService, err := testing.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package testing // import "google.golang.org/api/testing/v1"
@@ -1966,10 +1966,12 @@ func (s *Locale) MarshalJSON() ([]byte, error) {
// InstrumentationTest is invalid.
type ManualSharding struct {
// TestTargetsForShard: Required. Group of packages, classes, and/or
- // test methods to be run for each shard. When any physical devices are
- // selected, the number of test_targets_for_shard must be >= 1 and <=
- // 50. When no physical devices are selected, the number must be >= 1
- // and <= 500.
+ // test methods to be run for each manually-created shard. You must
+ // specify at least one shard if this field is present. When you select
+ // one or more physical devices, the number of repeated
+ // test_targets_for_shard must be <= 50. When you select one or more ARM
+ // virtual devices, it must be <= 50. When you select only x86 virtual
+ // devices, it must be <= 500.
TestTargetsForShard []*TestTargetsForShard `json:"testTargetsForShard,omitempty"`
// ForceSendFields is a list of field names (e.g. "TestTargetsForShard")
@@ -3187,16 +3189,19 @@ func (s *TrafficRule) UnmarshalJSON(data []byte) error {
}
// UniformSharding: Uniformly shards test cases given a total number of
-// shards. For Instrumentation test, it will be translated to "-e
-// numShard" "-e shardIndex" AndroidJUnitRunner arguments. Based on the
+// shards. For instrumentation tests, it will be translated to "-e
+// numShard" and "-e shardIndex" AndroidJUnitRunner arguments. With
+// uniform sharding enabled, specifying either of these sharding
+// arguments via `environment_variables` is invalid. Based on the
// sharding mechanism AndroidJUnitRunner uses, there is no guarantee
-// that test cases will be distributed uniformly across all shards. With
-// uniform sharding enabled, specifying these sharding arguments via
-// environment_variables is invalid.
+// that test cases will be distributed uniformly across all shards.
type UniformSharding struct {
- // NumShards: Required. Total number of shards. When any physical
- // devices are selected, the number must be >= 1 and <= 50. When no
- // physical devices are selected, the number must be >= 1 and <= 500.
+ // NumShards: Required. The total number of shards to create. This must
+ // always be a positive number that is no greater than the total number
+ // of test cases. When you select one or more physical devices, the
+ // number of shards must be <= 50. When you select one or more ARM
+ // virtual devices, it must be <= 50. When you select only x86 virtual
+ // devices, it must be <= 500.
NumShards int64 `json:"numShards,omitempty"`
// ForceSendFields is a list of field names (e.g. "NumShards") to
@@ -3705,9 +3710,9 @@ type ProjectsTestMatricesGetCall struct {
// not authorized to read project - INVALID_ARGUMENT - if the request is
// malformed - NOT_FOUND - if the Test Matrix does not exist
//
-// - projectId: Cloud project that owns the test matrix.
-// - testMatrixId: Unique test matrix id which was assigned by the
-// service.
+// - projectId: Cloud project that owns the test matrix.
+// - testMatrixId: Unique test matrix id which was assigned by the
+// service.
func (r *ProjectsTestMatricesService) Get(projectId string, testMatrixId string) *ProjectsTestMatricesGetCall {
c := &ProjectsTestMatricesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
diff --git a/texttospeech/v1/texttospeech-gen.go b/texttospeech/v1/texttospeech-gen.go
index 65b7a0f6442..66099bc146a 100644
--- a/texttospeech/v1/texttospeech-gen.go
+++ b/texttospeech/v1/texttospeech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/text-to-speech/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/texttospeech/v1"
-// ...
-// ctx := context.Background()
-// texttospeechService, err := texttospeech.NewService(ctx)
+// import "google.golang.org/api/texttospeech/v1"
+// ...
+// ctx := context.Background()
+// texttospeechService, err := texttospeech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// texttospeechService, err := texttospeech.NewService(ctx, option.WithAPIKey("AIza..."))
+// texttospeechService, err := texttospeech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// texttospeechService, err := texttospeech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// texttospeechService, err := texttospeech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package texttospeech // import "google.golang.org/api/texttospeech/v1"
diff --git a/texttospeech/v1beta1/texttospeech-gen.go b/texttospeech/v1beta1/texttospeech-gen.go
index 9eb89be8683..732db352778 100644
--- a/texttospeech/v1beta1/texttospeech-gen.go
+++ b/texttospeech/v1beta1/texttospeech-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/text-to-speech/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/texttospeech/v1beta1"
-// ...
-// ctx := context.Background()
-// texttospeechService, err := texttospeech.NewService(ctx)
+// import "google.golang.org/api/texttospeech/v1beta1"
+// ...
+// ctx := context.Background()
+// texttospeechService, err := texttospeech.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// texttospeechService, err := texttospeech.NewService(ctx, option.WithAPIKey("AIza..."))
+// texttospeechService, err := texttospeech.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// texttospeechService, err := texttospeech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// texttospeechService, err := texttospeech.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package texttospeech // import "google.golang.org/api/texttospeech/v1beta1"
diff --git a/toolresults/v1/toolresults-gen.go b/toolresults/v1/toolresults-gen.go
index 43d658f14c1..f455fa87d13 100644
--- a/toolresults/v1/toolresults-gen.go
+++ b/toolresults/v1/toolresults-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://firebase.google.com/docs/test-lab/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/toolresults/v1"
-// ...
-// ctx := context.Background()
-// toolresultsService, err := toolresults.NewService(ctx)
+// import "google.golang.org/api/toolresults/v1"
+// ...
+// ctx := context.Background()
+// toolresultsService, err := toolresults.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// toolresultsService, err := toolresults.NewService(ctx, option.WithAPIKey("AIza..."))
+// toolresultsService, err := toolresults.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// toolresultsService, err := toolresults.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// toolresultsService, err := toolresults.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package toolresults // import "google.golang.org/api/toolresults/v1"
diff --git a/toolresults/v1beta3/toolresults-api.json b/toolresults/v1beta3/toolresults-api.json
index fdbbf13f299..6feb1990f49 100644
--- a/toolresults/v1beta3/toolresults-api.json
+++ b/toolresults/v1beta3/toolresults-api.json
@@ -1463,7 +1463,7 @@
}
}
},
- "revision": "20210809",
+ "revision": "20220810",
"rootUrl": "https://toolresults.googleapis.com/",
"schemas": {
"ANR": {
@@ -1768,6 +1768,12 @@
},
"type": "object"
},
+ "DetectedAppSplashScreen": {
+ "description": "A notification that Robo detected a splash screen provided by app (vs. Android OS splash screen).",
+ "id": "DetectedAppSplashScreen",
+ "properties": {},
+ "type": "object"
+ },
"DeviceOutOfMemory": {
"description": "A warning that device ran out of memory",
"id": "DeviceOutOfMemory",
@@ -3616,7 +3622,8 @@
"overlappingUiElements",
"unityException",
"deviceOutOfMemory",
- "logcatCollectionError"
+ "logcatCollectionError",
+ "detectedAppSplashScreen"
],
"enumDescriptions": [
"Default unspecified type. Do not use. For versioning only.",
@@ -3649,7 +3656,8 @@
"Overlapping UI elements are found in the Robo crawl",
"An uncaught Unity exception was detected (these don't crash apps).",
"Device running out of memory was detected",
- "Problems detected while collecting logcat"
+ "Problems detected while collecting logcat",
+ "Robo detected a splash screen provided by app (vs. Android OS splash screen)."
],
"type": "string"
},
diff --git a/toolresults/v1beta3/toolresults-gen.go b/toolresults/v1beta3/toolresults-gen.go
index f1659e1ffd8..22e927ec0de 100644
--- a/toolresults/v1beta3/toolresults-gen.go
+++ b/toolresults/v1beta3/toolresults-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://firebase.google.com/docs/test-lab/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/toolresults/v1beta3"
-// ...
-// ctx := context.Background()
-// toolresultsService, err := toolresults.NewService(ctx)
+// import "google.golang.org/api/toolresults/v1beta3"
+// ...
+// ctx := context.Background()
+// toolresultsService, err := toolresults.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// toolresultsService, err := toolresults.NewService(ctx, option.WithAPIKey("AIza..."))
+// toolresultsService, err := toolresults.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// toolresultsService, err := toolresults.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// toolresultsService, err := toolresults.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package toolresults // import "google.golang.org/api/toolresults/v1beta3"
@@ -814,6 +814,11 @@ func (s *CrashDialogError) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// DetectedAppSplashScreen: A notification that Robo detected a splash
+// screen provided by app (vs. Android OS splash screen).
+type DetectedAppSplashScreen struct {
+}
+
// DeviceOutOfMemory: A warning that device ran out of memory
type DeviceOutOfMemory struct {
}
@@ -4006,6 +4011,8 @@ type TestIssue struct {
// don't crash apps).
// "deviceOutOfMemory" - Device running out of memory was detected
// "logcatCollectionError" - Problems detected while collecting logcat
+ // "detectedAppSplashScreen" - Robo detected a splash screen provided
+ // by app (vs. Android OS splash screen).
Type string `json:"type,omitempty"`
// Warning: Warning message with additional details of the issue. Should
@@ -6858,9 +6865,9 @@ type ProjectsHistoriesExecutionsStepsAccessibilityClustersCall struct {
// locale format is incorrect - NOT_FOUND - if the containing Step does
// not exist
//
-// - name: A full resource name of the step. For example,
-// projects/my-project/histories/bh.1234567890abcdef/executions/
-// 1234567890123456789/steps/bs.1234567890abcdef.
+// - name: A full resource name of the step. For example,
+// projects/my-project/histories/bh.1234567890abcdef/executions/
+// 1234567890123456789/steps/bs.1234567890abcdef.
func (r *ProjectsHistoriesExecutionsStepsService) AccessibilityClusters(name string) *ProjectsHistoriesExecutionsStepsAccessibilityClustersCall {
c := &ProjectsHistoriesExecutionsStepsAccessibilityClustersCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -7988,11 +7995,11 @@ type ProjectsHistoriesExecutionsStepsPublishXunitXmlFilesCall struct {
// duplicate xml file or a file too large. - NOT_FOUND - if the
// containing Execution does not exist
//
-// - executionId: A Execution id.
-// - historyId: A History id.
-// - projectId: A Project id.
-// - stepId: A Step id. Note: This step must include a
-// TestExecutionStep.
+// - executionId: A Execution id.
+// - historyId: A History id.
+// - projectId: A Project id.
+// - stepId: A Step id. Note: This step must include a
+// TestExecutionStep.
func (r *ProjectsHistoriesExecutionsStepsService) PublishXunitXmlFiles(projectId string, historyId string, executionId string, stepId string, publishxunitxmlfilesrequest *PublishXunitXmlFilesRequest) *ProjectsHistoriesExecutionsStepsPublishXunitXmlFilesCall {
c := &ProjectsHistoriesExecutionsStepsPublishXunitXmlFilesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
@@ -8727,11 +8734,12 @@ func (r *ProjectsHistoriesExecutionsStepsPerfSampleSeriesService) List(projectId
// PerfMetricType values such as CPU to filter the result
//
// Possible values:
-// "perfMetricTypeUnspecified"
-// "memory"
-// "cpu"
-// "network"
-// "graphics"
+//
+// "perfMetricTypeUnspecified"
+// "memory"
+// "cpu"
+// "network"
+// "graphics"
func (c *ProjectsHistoriesExecutionsStepsPerfSampleSeriesListCall) Filter(filter ...string) *ProjectsHistoriesExecutionsStepsPerfSampleSeriesListCall {
c.urlParams_.SetMulti("filter", append([]string{}, filter...))
return c
@@ -9363,12 +9371,12 @@ type ProjectsHistoriesExecutionsStepsTestCasesGetCall struct {
// authorized to write to project - INVALID_ARGUMENT - if the request is
// malformed - NOT_FOUND - if the containing Test Case does not exist
//
-// - executionId: A Execution id.
-// - historyId: A History id.
-// - projectId: A Project id.
-// - stepId: A Step id. Note: This step must include a
-// TestExecutionStep.
-// - testCaseId: A Test Case id.
+// - executionId: A Execution id.
+// - historyId: A History id.
+// - projectId: A Project id.
+// - stepId: A Step id. Note: This step must include a
+// TestExecutionStep.
+// - testCaseId: A Test Case id.
func (r *ProjectsHistoriesExecutionsStepsTestCasesService) Get(projectId string, historyId string, executionId string, stepId string, testCaseId string) *ProjectsHistoriesExecutionsStepsTestCasesGetCall {
c := &ProjectsHistoriesExecutionsStepsTestCasesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
@@ -9556,11 +9564,11 @@ type ProjectsHistoriesExecutionsStepsTestCasesListCall struct {
// authorized to write to project - INVALID_ARGUMENT - if the request is
// malformed - NOT_FOUND - if the containing Step does not exist
//
-// - executionId: A Execution id.
-// - historyId: A History id.
-// - projectId: A Project id.
-// - stepId: A Step id. Note: This step must include a
-// TestExecutionStep.
+// - executionId: A Execution id.
+// - historyId: A History id.
+// - projectId: A Project id.
+// - stepId: A Step id. Note: This step must include a
+// TestExecutionStep.
func (r *ProjectsHistoriesExecutionsStepsTestCasesService) List(projectId string, historyId string, executionId string, stepId string) *ProjectsHistoriesExecutionsStepsTestCasesListCall {
c := &ProjectsHistoriesExecutionsStepsTestCasesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.projectId = projectId
diff --git a/tpu/v1/tpu-api.json b/tpu/v1/tpu-api.json
index 16b700e9ef6..3dab07c96aa 100644
--- a/tpu/v1/tpu-api.json
+++ b/tpu/v1/tpu-api.json
@@ -659,7 +659,7 @@
}
}
},
- "revision": "20220714",
+ "revision": "20220725",
"rootUrl": "https://tpu.googleapis.com/",
"schemas": {
"AcceleratorType": {
@@ -861,7 +861,7 @@
"V2_ALPHA1"
],
"enumDescriptions": [
- "LINT.IfChange API version is unknown.",
+ "API version is unknown.",
"TPU API V1Alpha1 version.",
"TPU API V1 version.",
"TPU API V2Alpha1 version."
@@ -969,7 +969,7 @@
"UNHIDING"
],
"enumDescriptions": [
- "LINT.IfChange TPU node state is not known/set.",
+ "TPU node state is not known/set.",
"TPU node is being created.",
"TPU node has been created.",
"TPU node is restarting.",
@@ -983,7 +983,7 @@
"TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).",
"TPU node is currently hiding.",
"TPU node has been hidden.",
- "TPU node is currently unhiding. LINT.ThenChange(//depot/google3/java/com/google/cloud/boq/clientapi/tpu/api/gce_tpu.proto)"
+ "TPU node is currently unhiding."
],
"readOnly": true,
"type": "string"
diff --git a/tpu/v1/tpu-gen.go b/tpu/v1/tpu-gen.go
index 8e852e4966d..f8f3a97739e 100644
--- a/tpu/v1/tpu-gen.go
+++ b/tpu/v1/tpu-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/tpu/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tpu/v1"
-// ...
-// ctx := context.Background()
-// tpuService, err := tpu.NewService(ctx)
+// import "google.golang.org/api/tpu/v1"
+// ...
+// ctx := context.Background()
+// tpuService, err := tpu.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tpuService, err := tpu.NewService(ctx, option.WithAPIKey("AIza..."))
+// tpuService, err := tpu.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tpuService, err := tpu.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tpuService, err := tpu.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tpu // import "google.golang.org/api/tpu/v1"
@@ -533,7 +533,7 @@ type Node struct {
// ApiVersion: Output only. The API version that created this Node.
//
// Possible values:
- // "API_VERSION_UNSPECIFIED" - LINT.IfChange API version is unknown.
+ // "API_VERSION_UNSPECIFIED" - API version is unknown.
// "V1_ALPHA1" - TPU API V1Alpha1 version.
// "V1" - TPU API V1 version.
// "V2_ALPHA1" - TPU API V2Alpha1 version.
@@ -612,8 +612,7 @@ type Node struct {
// State: Output only. The current state for the TPU Node.
//
// Possible values:
- // "STATE_UNSPECIFIED" - LINT.IfChange TPU node state is not
- // known/set.
+ // "STATE_UNSPECIFIED" - TPU node state is not known/set.
// "CREATING" - TPU node is being created.
// "READY" - TPU node has been created.
// "RESTARTING" - TPU node is restarting.
@@ -631,8 +630,6 @@ type Node struct {
// "HIDING" - TPU node is currently hiding.
// "HIDDEN" - TPU node has been hidden.
// "UNHIDING" - TPU node is currently unhiding.
- // LINT.ThenChange(//depot/google3/java/com/google/cloud/boq/clientapi/tp
- // u/api/gce_tpu.proto)
State string `json:"state,omitempty"`
// Symptoms: Output only. The Symptoms that have occurred to the TPU
@@ -1146,8 +1143,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/tpu/v1alpha1/tpu-api.json b/tpu/v1alpha1/tpu-api.json
index 2439f9b90cf..12c8b52036e 100644
--- a/tpu/v1alpha1/tpu-api.json
+++ b/tpu/v1alpha1/tpu-api.json
@@ -669,7 +669,7 @@
}
}
},
- "revision": "20220714",
+ "revision": "20220725",
"rootUrl": "https://tpu.googleapis.com/",
"schemas": {
"AcceleratorType": {
@@ -871,7 +871,7 @@
"V2_ALPHA1"
],
"enumDescriptions": [
- "LINT.IfChange API version is unknown.",
+ "API version is unknown.",
"TPU API V1Alpha1 version.",
"TPU API V1 version.",
"TPU API V2Alpha1 version."
@@ -979,7 +979,7 @@
"UNHIDING"
],
"enumDescriptions": [
- "LINT.IfChange TPU node state is not known/set.",
+ "TPU node state is not known/set.",
"TPU node is being created.",
"TPU node has been created.",
"TPU node is restarting.",
@@ -993,7 +993,7 @@
"TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).",
"TPU node is currently hiding.",
"TPU node has been hidden.",
- "TPU node is currently unhiding. LINT.ThenChange(//depot/google3/java/com/google/cloud/boq/clientapi/tpu/api/gce_tpu.proto)"
+ "TPU node is currently unhiding."
],
"readOnly": true,
"type": "string"
diff --git a/tpu/v1alpha1/tpu-gen.go b/tpu/v1alpha1/tpu-gen.go
index 25437abf6d1..3edcd4d4bba 100644
--- a/tpu/v1alpha1/tpu-gen.go
+++ b/tpu/v1alpha1/tpu-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/tpu/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tpu/v1alpha1"
-// ...
-// ctx := context.Background()
-// tpuService, err := tpu.NewService(ctx)
+// import "google.golang.org/api/tpu/v1alpha1"
+// ...
+// ctx := context.Background()
+// tpuService, err := tpu.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tpuService, err := tpu.NewService(ctx, option.WithAPIKey("AIza..."))
+// tpuService, err := tpu.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tpuService, err := tpu.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tpuService, err := tpu.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tpu // import "google.golang.org/api/tpu/v1alpha1"
@@ -533,7 +533,7 @@ type Node struct {
// ApiVersion: Output only. The API version that created this Node.
//
// Possible values:
- // "API_VERSION_UNSPECIFIED" - LINT.IfChange API version is unknown.
+ // "API_VERSION_UNSPECIFIED" - API version is unknown.
// "V1_ALPHA1" - TPU API V1Alpha1 version.
// "V1" - TPU API V1 version.
// "V2_ALPHA1" - TPU API V2Alpha1 version.
@@ -612,8 +612,7 @@ type Node struct {
// State: Output only. The current state for the TPU Node.
//
// Possible values:
- // "STATE_UNSPECIFIED" - LINT.IfChange TPU node state is not
- // known/set.
+ // "STATE_UNSPECIFIED" - TPU node state is not known/set.
// "CREATING" - TPU node is being created.
// "READY" - TPU node has been created.
// "RESTARTING" - TPU node is restarting.
@@ -631,8 +630,6 @@ type Node struct {
// "HIDING" - TPU node is currently hiding.
// "HIDDEN" - TPU node has been hidden.
// "UNHIDING" - TPU node is currently unhiding.
- // LINT.ThenChange(//depot/google3/java/com/google/cloud/boq/clientapi/tp
- // u/api/gce_tpu.proto)
State string `json:"state,omitempty"`
// Symptoms: Output only. The Symptoms that have occurred to the TPU
@@ -1146,8 +1143,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/tpu/v2alpha1/tpu-api.json b/tpu/v2alpha1/tpu-api.json
index b42f5f98eb5..0f18e6b1b2f 100644
--- a/tpu/v2alpha1/tpu-api.json
+++ b/tpu/v2alpha1/tpu-api.json
@@ -759,7 +759,7 @@
}
}
},
- "revision": "20220714",
+ "revision": "20220725",
"rootUrl": "https://tpu.googleapis.com/",
"schemas": {
"AcceleratorType": {
@@ -1122,7 +1122,7 @@
"V2_ALPHA1"
],
"enumDescriptions": [
- "LINT.IfChange API version is unknown.",
+ "API version is unknown.",
"TPU API V1Alpha1 version.",
"TPU API V1 version.",
"TPU API V2Alpha1 version."
@@ -1243,7 +1243,7 @@
"UNHIDING"
],
"enumDescriptions": [
- "LINT.IfChange TPU node state is not known/set.",
+ "TPU node state is not known/set.",
"TPU node is being created.",
"TPU node has been created.",
"TPU node is restarting.",
@@ -1257,7 +1257,7 @@
"TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).",
"TPU node is currently hiding.",
"TPU node has been hidden.",
- "TPU node is currently unhiding. LINT.ThenChange(//depot/google3/java/com/google/cloud/boq/clientapi/tpu/api/gce_tpu.proto)"
+ "TPU node is currently unhiding."
],
"readOnly": true,
"type": "string"
diff --git a/tpu/v2alpha1/tpu-gen.go b/tpu/v2alpha1/tpu-gen.go
index ab1b356f2ed..3846ac233ef 100644
--- a/tpu/v2alpha1/tpu-gen.go
+++ b/tpu/v2alpha1/tpu-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/tpu/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tpu/v2alpha1"
-// ...
-// ctx := context.Background()
-// tpuService, err := tpu.NewService(ctx)
+// import "google.golang.org/api/tpu/v2alpha1"
+// ...
+// ctx := context.Background()
+// tpuService, err := tpu.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tpuService, err := tpu.NewService(ctx, option.WithAPIKey("AIza..."))
+// tpuService, err := tpu.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tpuService, err := tpu.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tpuService, err := tpu.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tpu // import "google.golang.org/api/tpu/v2alpha1"
@@ -847,7 +847,7 @@ type Node struct {
// ApiVersion: Output only. The API version that created this Node.
//
// Possible values:
- // "API_VERSION_UNSPECIFIED" - LINT.IfChange API version is unknown.
+ // "API_VERSION_UNSPECIFIED" - API version is unknown.
// "V1_ALPHA1" - TPU API V1Alpha1 version.
// "V1" - TPU API V1 version.
// "V2_ALPHA1" - TPU API V2Alpha1 version.
@@ -924,8 +924,7 @@ type Node struct {
// State: Output only. The current state for the TPU Node.
//
// Possible values:
- // "STATE_UNSPECIFIED" - LINT.IfChange TPU node state is not
- // known/set.
+ // "STATE_UNSPECIFIED" - TPU node state is not known/set.
// "CREATING" - TPU node is being created.
// "READY" - TPU node has been created.
// "RESTARTING" - TPU node is restarting.
@@ -943,8 +942,6 @@ type Node struct {
// "HIDING" - TPU node is currently hiding.
// "HIDDEN" - TPU node has been hidden.
// "UNHIDING" - TPU node is currently unhiding.
- // LINT.ThenChange(//depot/google3/java/com/google/cloud/boq/clientapi/tp
- // u/api/gce_tpu.proto)
State string `json:"state,omitempty"`
// Symptoms: Output only. The Symptoms that have occurred to the TPU
@@ -1657,8 +1654,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/tracing/v2/tracing-gen.go b/tracing/v2/tracing-gen.go
index b388d4ef090..3e5f86f14fb 100644
--- a/tracing/v2/tracing-gen.go
+++ b/tracing/v2/tracing-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://cloud.google.com/trace
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/tracing/v2"
-// ...
-// ctx := context.Background()
-// tracingService, err := tracing.NewService(ctx)
+// import "google.golang.org/api/tracing/v2"
+// ...
+// ctx := context.Background()
+// tracingService, err := tracing.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// tracingService, err := tracing.NewService(ctx, option.WithScopes(tracing.TraceReadonlyScope))
+// tracingService, err := tracing.NewService(ctx, option.WithScopes(tracing.TraceReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// tracingService, err := tracing.NewService(ctx, option.WithAPIKey("AIza..."))
+// tracingService, err := tracing.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// tracingService, err := tracing.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// tracingService, err := tracing.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package tracing // import "google.golang.org/api/tracing/v2"
@@ -331,10 +331,12 @@ func (s *BatchWriteSpansRequest) MarshalJSON() ([]byte, error) {
// request
// or the response type of an API method. For instance:
//
-// service Foo {
-// rpc Bar(google.protobuf.Empty) returns
+// service Foo {
+// rpc Bar(google.protobuf.Empty) returns
+//
// (google.protobuf.Empty);
-// }
+//
+// }
//
// The JSON representation for `Empty` is empty JSON object `{}`.
type Empty struct {
@@ -903,29 +905,41 @@ func (s *StackTrace) MarshalJSON() ([]byte, error) {
//
// - Partial errors. If a service needs to return partial errors to the
// client,
-// it may embed the `Status` in the normal response to indicate the
+//
+// it may embed the `Status` in the normal response to indicate the
+//
// partial
-// errors.
+//
+// errors.
//
// - Workflow errors. A typical workflow has multiple steps. Each step
// may
-// have a `Status` message for error reporting.
+//
+// have a `Status` message for error reporting.
//
// - Batch operations. If a client uses batch request and batch
// response, the
-// `Status` message should be used directly inside batch response,
+//
+// `Status` message should be used directly inside batch response,
+//
// one for
-// each error sub-response.
+//
+// each error sub-response.
//
// - Asynchronous operations. If an API call embeds asynchronous
// operation
-// results in its response, the status of those operations should
+//
+// results in its response, the status of those operations should
+//
// be
-// represented directly using the `Status` message.
+//
+// represented directly using the `Status` message.
//
// - Logging. If some API errors are stored in logs, the message
// `Status` could
-// be used directly after any stripping needed for security/privacy
+//
+// be used directly after any stripping needed for security/privacy
+//
// reasons.
type Status struct {
// Code: The status code, which should be an enum value of
@@ -1315,7 +1329,9 @@ func (c *ProjectsTracesListCall) Filter(filter string) *ProjectsTracesListCall {
// * `name` (`name` field of root span in the trace)
// * `duration` (difference between `end_time` and `start_time` fields
// of
-// the root span)
+//
+// the root span)
+//
// * `start` (`start_time` field of the root span)
//
// Descending order can be specified by appending `desc` to the sort
diff --git a/trafficdirector/v2/trafficdirector-api.json b/trafficdirector/v2/trafficdirector-api.json
index c96bba22799..0bd0e9add41 100644
--- a/trafficdirector/v2/trafficdirector-api.json
+++ b/trafficdirector/v2/trafficdirector-api.json
@@ -128,7 +128,7 @@
}
}
},
- "revision": "20210809",
+ "revision": "20220723",
"rootUrl": "https://trafficdirector.googleapis.com/",
"schemas": {
"Address": {
@@ -427,7 +427,7 @@
"type": "object"
},
"GoogleRE2": {
- "description": "Google's `RE2 `_ regex engine. The regex string must adhere to the documented `syntax `_. The engine is designed to complete execution in linear time as well as limit the amount of memory used. Envoy supports program size checking via runtime. The runtime keys `re2.max_program_size.error_level` and `re2.max_program_size.warn_level` can be set to integers as the maximum program size or complexity that a compiled regex can have before an exception is thrown or a warning is logged, respectively. `re2.max_program_size.error_level` defaults to 100, and `re2.max_program_size.warn_level` has no default if unset (will not check/log a warning). Envoy emits two stats for tracking the program size of regexes: the histogram `re2.program_size`, which records the program size, and the counter `re2.exceeded_warn_level`, which is incremented each time the program size exceeds the warn level threshold.",
+ "description": "Google's `RE2 `_ regex engine. The regex string must adhere to the documented `syntax `_. The engine is designed to complete execution in linear time as well as limit the amount of memory used. Envoy supports program size checking via runtime. The runtime keys ``re2.max_program_size.error_level`` and ``re2.max_program_size.warn_level`` can be set to integers as the maximum program size or complexity that a compiled regex can have before an exception is thrown or a warning is logged, respectively. ``re2.max_program_size.error_level`` defaults to 100, and ``re2.max_program_size.warn_level`` has no default if unset (will not check/log a warning). Envoy emits two stats for tracking the program size of regexes: the histogram `re2.program_size`, which records the program size, and the counter `re2.exceeded_warn_level`, which is incremented each time the program size exceeds the warn level threshold.",
"id": "GoogleRE2",
"properties": {
"maxProgramSize": {
diff --git a/trafficdirector/v2/trafficdirector-gen.go b/trafficdirector/v2/trafficdirector-gen.go
index cc31487a523..bb0558e4f47 100644
--- a/trafficdirector/v2/trafficdirector-gen.go
+++ b/trafficdirector/v2/trafficdirector-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/traffic-director
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/trafficdirector/v2"
-// ...
-// ctx := context.Background()
-// trafficdirectorService, err := trafficdirector.NewService(ctx)
+// import "google.golang.org/api/trafficdirector/v2"
+// ...
+// ctx := context.Background()
+// trafficdirectorService, err := trafficdirector.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// trafficdirectorService, err := trafficdirector.NewService(ctx, option.WithAPIKey("AIza..."))
+// trafficdirectorService, err := trafficdirector.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// trafficdirectorService, err := trafficdirector.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// trafficdirectorService, err := trafficdirector.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package trafficdirector // import "google.golang.org/api/trafficdirector/v2"
@@ -702,12 +702,12 @@ func (s *Extension) MarshalJSON() ([]byte, error) {
// adhere to the documented `syntax `_. The engine is designed to
// complete execution in linear time as well as limit the amount of
// memory used. Envoy supports program size checking via runtime. The
-// runtime keys `re2.max_program_size.error_level` and
-// `re2.max_program_size.warn_level` can be set to integers as the
+// runtime keys “re2.max_program_size.error_level“ and
+// “re2.max_program_size.warn_level“ can be set to integers as the
// maximum program size or complexity that a compiled regex can have
// before an exception is thrown or a warning is logged, respectively.
-// `re2.max_program_size.error_level` defaults to 100, and
-// `re2.max_program_size.warn_level` has no default if unset (will not
+// “re2.max_program_size.error_level“ defaults to 100, and
+// “re2.max_program_size.warn_level“ has no default if unset (will not
// check/log a warning). Envoy emits two stats for tracking the program
// size of regexes: the histogram `re2.program_size`, which records the
// program size, and the counter `re2.exceeded_warn_level`, which is
diff --git a/transcoder/v1/transcoder-api.json b/transcoder/v1/transcoder-api.json
index 02bbb4f1fac..fb354e677bb 100644
--- a/transcoder/v1/transcoder-api.json
+++ b/transcoder/v1/transcoder-api.json
@@ -385,7 +385,7 @@
}
}
},
- "revision": "20220609",
+ "revision": "20220811",
"rootUrl": "https://transcoder.googleapis.com/",
"schemas": {
"AdBreak": {
@@ -577,6 +577,25 @@
},
"type": "object"
},
+ "BwdifConfig": {
+ "description": "Bob Weaver Deinterlacing Filter Configuration.",
+ "id": "BwdifConfig",
+ "properties": {
+ "deinterlaceAllFrames": {
+ "description": "Deinterlace all frames rather than just the frames identified as interlaced. The default is `false`.",
+ "type": "boolean"
+ },
+ "mode": {
+ "description": "Specifies the deinterlacing mode to adopt. The default is `send_frame`. Supported values: - `send_frame`: Output one frame for each frame - `send_field`: Output one frame for each field",
+ "type": "string"
+ },
+ "parity": {
+ "description": "The picture field parity assumed for the input interlaced video. The default is `auto`. Supported values: - `tff`: Assume the top field is first - `bff`: Assume the bottom field is first - `auto`: Enable automatic detection of field parity",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"Color": {
"description": "Color preprocessing configuration. **Note:** This configuration is not supported.",
"id": "Color",
@@ -642,6 +661,21 @@
},
"type": "object"
},
+ "Deinterlace": {
+ "description": "Deinterlace configuration for input video.",
+ "id": "Deinterlace",
+ "properties": {
+ "bwdif": {
+ "$ref": "BwdifConfig",
+ "description": "Specifies the Bob Weaver Deinterlacing Filter Configuration."
+ },
+ "yadif": {
+ "$ref": "YadifConfig",
+ "description": "Specifies the Yet Another Deinterlacing Filter Configuration."
+ }
+ },
+ "type": "object"
+ },
"Denoise": {
"description": "Denoise preprocessing configuration. **Note:** This configuration is not supported.",
"id": "Denoise",
@@ -1325,6 +1359,10 @@
"$ref": "Deblock",
"description": "Deblock preprocessing configuration."
},
+ "deinterlace": {
+ "$ref": "Deinterlace",
+ "description": "Specify the video deinterlace configuration."
+ },
"denoise": {
"$ref": "Denoise",
"description": "Denoise preprocessing configuration."
@@ -1560,6 +1598,29 @@
}
},
"type": "object"
+ },
+ "YadifConfig": {
+ "description": "Yet Another Deinterlacing Filter Configuration.",
+ "id": "YadifConfig",
+ "properties": {
+ "deinterlaceAllFrames": {
+ "description": "Deinterlace all frames rather than just the frames identified as interlaced. The default is `false`.",
+ "type": "boolean"
+ },
+ "disableSpatialInterlacing": {
+ "description": "Disable spacial interlacing. The default is `false`.",
+ "type": "boolean"
+ },
+ "mode": {
+ "description": "Specifies the deinterlacing mode to adopt. The default is `send_frame`. Supported values: - `send_frame`: Output one frame for each frame - `send_field`: Output one frame for each field",
+ "type": "string"
+ },
+ "parity": {
+ "description": "The picture field parity assumed for the input interlaced video. The default is `auto`. Supported values: - `tff`: Assume the top field is first - `bff`: Assume the bottom field is first - `auto`: Enable automatic detection of field parity",
+ "type": "string"
+ }
+ },
+ "type": "object"
}
},
"servicePath": "",
diff --git a/transcoder/v1/transcoder-gen.go b/transcoder/v1/transcoder-gen.go
index 4a6425b1688..a773238ebab 100644
--- a/transcoder/v1/transcoder-gen.go
+++ b/transcoder/v1/transcoder-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/transcoder/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/transcoder/v1"
-// ...
-// ctx := context.Background()
-// transcoderService, err := transcoder.NewService(ctx)
+// import "google.golang.org/api/transcoder/v1"
+// ...
+// ctx := context.Background()
+// transcoderService, err := transcoder.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// transcoderService, err := transcoder.NewService(ctx, option.WithAPIKey("AIza..."))
+// transcoderService, err := transcoder.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// transcoderService, err := transcoder.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// transcoderService, err := transcoder.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package transcoder // import "google.golang.org/api/transcoder/v1"
@@ -537,6 +537,48 @@ func (s *AudioStream) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// BwdifConfig: Bob Weaver Deinterlacing Filter Configuration.
+type BwdifConfig struct {
+ // DeinterlaceAllFrames: Deinterlace all frames rather than just the
+ // frames identified as interlaced. The default is `false`.
+ DeinterlaceAllFrames bool `json:"deinterlaceAllFrames,omitempty"`
+
+ // Mode: Specifies the deinterlacing mode to adopt. The default is
+ // `send_frame`. Supported values: - `send_frame`: Output one frame for
+ // each frame - `send_field`: Output one frame for each field
+ Mode string `json:"mode,omitempty"`
+
+ // Parity: The picture field parity assumed for the input interlaced
+ // video. The default is `auto`. Supported values: - `tff`: Assume the
+ // top field is first - `bff`: Assume the bottom field is first -
+ // `auto`: Enable automatic detection of field parity
+ Parity string `json:"parity,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "DeinterlaceAllFrames") to unconditionally include in API requests.
+ // By default, fields with empty or default values are omitted from API
+ // requests. However, any non-pointer, non-interface field appearing in
+ // ForceSendFields will be sent to the server regardless of whether the
+ // field is empty or not. This may be used to include empty fields in
+ // Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DeinterlaceAllFrames") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *BwdifConfig) MarshalJSON() ([]byte, error) {
+ type NoMethod BwdifConfig
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// Color: Color preprocessing configuration. **Note:** This
// configuration is not supported.
type Color struct {
@@ -686,6 +728,37 @@ func (s *Deblock) UnmarshalJSON(data []byte) error {
return nil
}
+// Deinterlace: Deinterlace configuration for input video.
+type Deinterlace struct {
+ // Bwdif: Specifies the Bob Weaver Deinterlacing Filter Configuration.
+ Bwdif *BwdifConfig `json:"bwdif,omitempty"`
+
+ // Yadif: Specifies the Yet Another Deinterlacing Filter Configuration.
+ Yadif *YadifConfig `json:"yadif,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "Bwdif") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "Bwdif") to include in API
+ // requests with the JSON null value. By default, fields with empty
+ // values are omitted from API requests. However, any field with an
+ // empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *Deinterlace) MarshalJSON() ([]byte, error) {
+ type NoMethod Deinterlace
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// Denoise: Denoise preprocessing configuration. **Note:** This
// configuration is not supported.
type Denoise struct {
@@ -1761,6 +1834,9 @@ type PreprocessingConfig struct {
// Deblock: Deblock preprocessing configuration.
Deblock *Deblock `json:"deblock,omitempty"`
+ // Deinterlace: Specify the video deinterlace configuration.
+ Deinterlace *Deinterlace `json:"deinterlace,omitempty"`
+
// Denoise: Denoise preprocessing configuration.
Denoise *Denoise `json:"denoise,omitempty"`
@@ -2186,6 +2262,52 @@ func (s *Vp9CodecSettings) UnmarshalJSON(data []byte) error {
return nil
}
+// YadifConfig: Yet Another Deinterlacing Filter Configuration.
+type YadifConfig struct {
+ // DeinterlaceAllFrames: Deinterlace all frames rather than just the
+ // frames identified as interlaced. The default is `false`.
+ DeinterlaceAllFrames bool `json:"deinterlaceAllFrames,omitempty"`
+
+ // DisableSpatialInterlacing: Disable spacial interlacing. The default
+ // is `false`.
+ DisableSpatialInterlacing bool `json:"disableSpatialInterlacing,omitempty"`
+
+ // Mode: Specifies the deinterlacing mode to adopt. The default is
+ // `send_frame`. Supported values: - `send_frame`: Output one frame for
+ // each frame - `send_field`: Output one frame for each field
+ Mode string `json:"mode,omitempty"`
+
+ // Parity: The picture field parity assumed for the input interlaced
+ // video. The default is `auto`. Supported values: - `tff`: Assume the
+ // top field is first - `bff`: Assume the bottom field is first -
+ // `auto`: Enable automatic detection of field parity
+ Parity string `json:"parity,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g.
+ // "DeinterlaceAllFrames") to unconditionally include in API requests.
+ // By default, fields with empty or default values are omitted from API
+ // requests. However, any non-pointer, non-interface field appearing in
+ // ForceSendFields will be sent to the server regardless of whether the
+ // field is empty or not. This may be used to include empty fields in
+ // Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "DeinterlaceAllFrames") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *YadifConfig) MarshalJSON() ([]byte, error) {
+ type NoMethod YadifConfig
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// method id "transcoder.projects.locations.jobTemplates.create":
type ProjectsLocationsJobTemplatesCreateCall struct {
@@ -2199,8 +2321,8 @@ type ProjectsLocationsJobTemplatesCreateCall struct {
// Create: Creates a job template in the specified region.
//
-// - parent: The parent location to create this job template. Format:
-// `projects/{project}/locations/{location}`.
+// - parent: The parent location to create this job template. Format:
+// `projects/{project}/locations/{location}`.
func (r *ProjectsLocationsJobTemplatesService) Create(parent string, jobtemplate *JobTemplate) *ProjectsLocationsJobTemplatesCreateCall {
c := &ProjectsLocationsJobTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2356,9 +2478,9 @@ type ProjectsLocationsJobTemplatesDeleteCall struct {
// Delete: Deletes a job template.
//
-// - name: The name of the job template to delete.
-// `projects/{project}/locations/{location}/jobTemplates/{job_template}
-// `.
+// - name: The name of the job template to delete.
+// `projects/{project}/locations/{location}/jobTemplates/{job_template}
+// `.
func (r *ProjectsLocationsJobTemplatesService) Delete(name string) *ProjectsLocationsJobTemplatesDeleteCall {
c := &ProjectsLocationsJobTemplatesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2504,9 +2626,9 @@ type ProjectsLocationsJobTemplatesGetCall struct {
// Get: Returns the job template data.
//
-// - name: The name of the job template to retrieve. Format:
-// `projects/{project}/locations/{location}/jobTemplates/{job_template}
-// `.
+// - name: The name of the job template to retrieve. Format:
+// `projects/{project}/locations/{location}/jobTemplates/{job_template}
+// `.
func (r *ProjectsLocationsJobTemplatesService) Get(name string) *ProjectsLocationsJobTemplatesGetCall {
c := &ProjectsLocationsJobTemplatesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2652,8 +2774,8 @@ type ProjectsLocationsJobTemplatesListCall struct {
// List: Lists job templates in the specified region.
//
-// - parent: The parent location from which to retrieve the collection
-// of job templates. Format: `projects/{project}/locations/{location}`.
+// - parent: The parent location from which to retrieve the collection
+// of job templates. Format: `projects/{project}/locations/{location}`.
func (r *ProjectsLocationsJobTemplatesService) List(parent string) *ProjectsLocationsJobTemplatesListCall {
c := &ProjectsLocationsJobTemplatesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2871,8 +2993,8 @@ type ProjectsLocationsJobsCreateCall struct {
// Create: Creates a job in the specified region.
//
-// - parent: The parent location to create and process this job. Format:
-// `projects/{project}/locations/{location}`.
+// - parent: The parent location to create and process this job. Format:
+// `projects/{project}/locations/{location}`.
func (r *ProjectsLocationsJobsService) Create(parent string, job *Job) *ProjectsLocationsJobsCreateCall {
c := &ProjectsLocationsJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3013,8 +3135,8 @@ type ProjectsLocationsJobsDeleteCall struct {
// Delete: Deletes a job.
//
-// - name: The name of the job to delete. Format:
-// `projects/{project}/locations/{location}/jobs/{job}`.
+// - name: The name of the job to delete. Format:
+// `projects/{project}/locations/{location}/jobs/{job}`.
func (r *ProjectsLocationsJobsService) Delete(name string) *ProjectsLocationsJobsDeleteCall {
c := &ProjectsLocationsJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3160,8 +3282,8 @@ type ProjectsLocationsJobsGetCall struct {
// Get: Returns the job data.
//
-// - name: The name of the job to retrieve. Format:
-// `projects/{project}/locations/{location}/jobs/{job}`.
+// - name: The name of the job to retrieve. Format:
+// `projects/{project}/locations/{location}/jobs/{job}`.
func (r *ProjectsLocationsJobsService) Get(name string) *ProjectsLocationsJobsGetCall {
c := &ProjectsLocationsJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/transcoder/v1beta1/transcoder-gen.go b/transcoder/v1beta1/transcoder-gen.go
index b89646f21ee..4437051bd1e 100644
--- a/transcoder/v1beta1/transcoder-gen.go
+++ b/transcoder/v1beta1/transcoder-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/transcoder/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/transcoder/v1beta1"
-// ...
-// ctx := context.Background()
-// transcoderService, err := transcoder.NewService(ctx)
+// import "google.golang.org/api/transcoder/v1beta1"
+// ...
+// ctx := context.Background()
+// transcoderService, err := transcoder.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// transcoderService, err := transcoder.NewService(ctx, option.WithAPIKey("AIza..."))
+// transcoderService, err := transcoder.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// transcoderService, err := transcoder.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// transcoderService, err := transcoder.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package transcoder // import "google.golang.org/api/transcoder/v1beta1"
@@ -2210,8 +2210,8 @@ type ProjectsLocationsJobTemplatesCreateCall struct {
// Create: Creates a job template in the specified region.
//
-// - parent: The parent location to create this job template. Format:
-// `projects/{project}/locations/{location}`.
+// - parent: The parent location to create this job template. Format:
+// `projects/{project}/locations/{location}`.
func (r *ProjectsLocationsJobTemplatesService) Create(parent string, jobtemplate *JobTemplate) *ProjectsLocationsJobTemplatesCreateCall {
c := &ProjectsLocationsJobTemplatesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2367,9 +2367,9 @@ type ProjectsLocationsJobTemplatesDeleteCall struct {
// Delete: Deletes a job template.
//
-// - name: The name of the job template to delete.
-// `projects/{project}/locations/{location}/jobTemplates/{job_template}
-// `.
+// - name: The name of the job template to delete.
+// `projects/{project}/locations/{location}/jobTemplates/{job_template}
+// `.
func (r *ProjectsLocationsJobTemplatesService) Delete(name string) *ProjectsLocationsJobTemplatesDeleteCall {
c := &ProjectsLocationsJobTemplatesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2502,9 +2502,9 @@ type ProjectsLocationsJobTemplatesGetCall struct {
// Get: Returns the job template data.
//
-// - name: The name of the job template to retrieve. Format:
-// `projects/{project}/locations/{location}/jobTemplates/{job_template}
-// `.
+// - name: The name of the job template to retrieve. Format:
+// `projects/{project}/locations/{location}/jobTemplates/{job_template}
+// `.
func (r *ProjectsLocationsJobTemplatesService) Get(name string) *ProjectsLocationsJobTemplatesGetCall {
c := &ProjectsLocationsJobTemplatesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2650,8 +2650,8 @@ type ProjectsLocationsJobTemplatesListCall struct {
// List: Lists job templates in the specified region.
//
-// - parent: The parent location from which to retrieve the collection
-// of job templates. Format: `projects/{project}/locations/{location}`.
+// - parent: The parent location from which to retrieve the collection
+// of job templates. Format: `projects/{project}/locations/{location}`.
func (r *ProjectsLocationsJobTemplatesService) List(parent string) *ProjectsLocationsJobTemplatesListCall {
c := &ProjectsLocationsJobTemplatesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2844,8 +2844,8 @@ type ProjectsLocationsJobsCreateCall struct {
// Create: Creates a job in the specified region.
//
-// - parent: The parent location to create and process this job. Format:
-// `projects/{project}/locations/{location}`.
+// - parent: The parent location to create and process this job. Format:
+// `projects/{project}/locations/{location}`.
func (r *ProjectsLocationsJobsService) Create(parent string, job *Job) *ProjectsLocationsJobsCreateCall {
c := &ProjectsLocationsJobsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2986,8 +2986,8 @@ type ProjectsLocationsJobsDeleteCall struct {
// Delete: Deletes a job.
//
-// - name: The name of the job to delete. Format:
-// `projects/{project}/locations/{location}/jobs/{job}`.
+// - name: The name of the job to delete. Format:
+// `projects/{project}/locations/{location}/jobs/{job}`.
func (r *ProjectsLocationsJobsService) Delete(name string) *ProjectsLocationsJobsDeleteCall {
c := &ProjectsLocationsJobsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3120,8 +3120,8 @@ type ProjectsLocationsJobsGetCall struct {
// Get: Returns the job data.
//
-// - name: The name of the job to retrieve. Format:
-// `projects/{project}/locations/{location}/jobs/{job}`.
+// - name: The name of the job to retrieve. Format:
+// `projects/{project}/locations/{location}/jobs/{job}`.
func (r *ProjectsLocationsJobsService) Get(name string) *ProjectsLocationsJobsGetCall {
c := &ProjectsLocationsJobsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/translate/v2/translate-gen.go b/translate/v2/translate-gen.go
index 58a18ae6c9a..be930da6206 100644
--- a/translate/v2/translate-gen.go
+++ b/translate/v2/translate-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://code.google.com/apis/language/translate/v2/getting_started.html
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/translate/v2"
-// ...
-// ctx := context.Background()
-// translateService, err := translate.NewService(ctx)
+// import "google.golang.org/api/translate/v2"
+// ...
+// ctx := context.Background()
+// translateService, err := translate.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// translateService, err := translate.NewService(ctx, option.WithScopes(translate.CloudTranslationScope))
+// translateService, err := translate.NewService(ctx, option.WithScopes(translate.CloudTranslationScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// translateService, err := translate.NewService(ctx, option.WithAPIKey("AIza..."))
+// translateService, err := translate.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// translateService, err := translate.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// translateService, err := translate.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package translate // import "google.golang.org/api/translate/v2"
@@ -661,9 +661,9 @@ type DetectionsListCall struct {
// List: Detects the language of text within a request.
//
-// - q: The input text upon which to perform language detection. Repeat
-// this
-// parameter to perform language detection on multiple text inputs.
+// - q: The input text upon which to perform language detection. Repeat
+// this
+// parameter to perform language detection on multiple text inputs.
func (r *DetectionsService) List(q []string) *DetectionsListCall {
c := &DetectionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("q", append([]string{}, q...))
@@ -963,11 +963,13 @@ type TranslationsListCall struct {
// List: Translates input text, returning translated text.
//
-// - q: The input text to translate. Repeat this parameter to perform
-// translation
+// - q: The input text to translate. Repeat this parameter to perform
+// translation
+//
// operations on multiple text inputs.
-// - target: The language to use for translation of the input text, set
-// to one of the
+// - target: The language to use for translation of the input text, set
+// to one of the
+//
// language codes listed in Language Support.
func (r *TranslationsService) List(q []string, target string) *TranslationsListCall {
c := &TranslationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
@@ -989,8 +991,9 @@ func (c *TranslationsListCall) Cid(cid ...string) *TranslationsListCall {
// plain-text.
//
// Possible values:
-// "html" - Specifies the input is in HTML
-// "text" - Specifies the input is in plain textual format
+//
+// "html" - Specifies the input is in HTML
+// "text" - Specifies the input is in plain textual format
func (c *TranslationsListCall) Format(format string) *TranslationsListCall {
c.urlParams_.Set("format", format)
return c
diff --git a/translate/v3/translate-api.json b/translate/v3/translate-api.json
index 4aad0896707..381c76922d2 100644
--- a/translate/v3/translate-api.json
+++ b/translate/v3/translate-api.json
@@ -580,6 +580,193 @@
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-translation"
]
+ },
+ "patch": {
+ "description": "Updates a glossary. A LRO is used since the update can be async if the glossary's entry file is updated.",
+ "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}",
+ "httpMethod": "PATCH",
+ "id": "translate.projects.locations.glossaries.patch",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. The resource name of the glossary. Glossary names have the form `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`.",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+$",
+ "required": true,
+ "type": "string"
+ },
+ "updateMask": {
+ "description": "The list of fields to be updated. Currently only `display_name` and 'input_config'",
+ "format": "google-fieldmask",
+ "location": "query",
+ "type": "string"
+ }
+ },
+ "path": "v3/{+name}",
+ "request": {
+ "$ref": "Glossary"
+ },
+ "response": {
+ "$ref": "Operation"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform"
+ ]
+ }
+ },
+ "resources": {
+ "glossaryEntries": {
+ "methods": {
+ "create": {
+ "description": "Creates a glossary entry.",
+ "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries",
+ "httpMethod": "POST",
+ "id": "translate.projects.locations.glossaries.glossaryEntries.create",
+ "parameterOrder": [
+ "parent"
+ ],
+ "parameters": {
+ "parent": {
+ "description": "Required. The resource name of the glossary to create the entry under.",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v3/{+parent}/glossaryEntries",
+ "request": {
+ "$ref": "GlossaryEntry"
+ },
+ "response": {
+ "$ref": "GlossaryEntry"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/cloud-translation"
+ ]
+ },
+ "delete": {
+ "description": "Deletes a single entry from the glossary",
+ "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries/{glossaryEntriesId}",
+ "httpMethod": "DELETE",
+ "id": "translate.projects.locations.glossaries.glossaryEntries.delete",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. The resource name of the glossary entry to delete",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+/glossaryEntries/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v3/{+name}",
+ "response": {
+ "$ref": "Empty"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/cloud-translation"
+ ]
+ },
+ "get": {
+ "description": "Gets a single glossary entry by the given id.",
+ "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries/{glossaryEntriesId}",
+ "httpMethod": "GET",
+ "id": "translate.projects.locations.glossaries.glossaryEntries.get",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. The resource name of the glossary entry to get",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+/glossaryEntries/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v3/{+name}",
+ "response": {
+ "$ref": "GlossaryEntry"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/cloud-translation"
+ ]
+ },
+ "list": {
+ "description": "List the entries for the glossary.",
+ "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries",
+ "httpMethod": "GET",
+ "id": "translate.projects.locations.glossaries.glossaryEntries.list",
+ "parameterOrder": [
+ "parent"
+ ],
+ "parameters": {
+ "pageSize": {
+ "description": "Optional. Requested page size. The server may return fewer glossary entries than requested. If unspecified, the server picks an appropriate default.",
+ "format": "int32",
+ "location": "query",
+ "type": "integer"
+ },
+ "pageToken": {
+ "description": "Optional. A token identifying a page of results the server should return. Typically, this is the value of [ListGlossaryEntriesResponse.next_page_token] returned from the previous call. The first page is returned if `page_token`is empty or missing.",
+ "location": "query",
+ "type": "string"
+ },
+ "parent": {
+ "description": "Required. The parent glossary resource name for listing the glossary's entries.",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v3/{+parent}/glossaryEntries",
+ "response": {
+ "$ref": "ListGlossaryEntriesResponse"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/cloud-translation"
+ ]
+ },
+ "patch": {
+ "description": "Updates a glossary entry.",
+ "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries/{glossaryEntriesId}",
+ "httpMethod": "PATCH",
+ "id": "translate.projects.locations.glossaries.glossaryEntries.patch",
+ "parameterOrder": [
+ "name"
+ ],
+ "parameters": {
+ "name": {
+ "description": "Required. The resource name of the entry. Format: \"projects/*/locations/*/glossaries/*/glossaryEntries/*\"",
+ "location": "path",
+ "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+/glossaryEntries/[^/]+$",
+ "required": true,
+ "type": "string"
+ }
+ },
+ "path": "v3/{+name}",
+ "request": {
+ "$ref": "GlossaryEntry"
+ },
+ "response": {
+ "$ref": "GlossaryEntry"
+ },
+ "scopes": [
+ "https://www.googleapis.com/auth/cloud-platform",
+ "https://www.googleapis.com/auth/cloud-translation"
+ ]
+ }
+ }
}
}
},
@@ -744,7 +931,7 @@
}
}
},
- "revision": "20220401",
+ "revision": "20220805",
"rootUrl": "https://translation.googleapis.com/",
"schemas": {
"BatchDocumentInputConfig": {
@@ -764,7 +951,7 @@
"properties": {
"gcsDestination": {
"$ref": "GcsDestination",
- "description": "Google Cloud Storage destination for output content. For every single input document (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateDocumentRequest). While the input documents are being processed, we write/update an index file `index.csv` under `gcs_destination.output_uri_prefix` (for example, gs://translation_output/index.csv) The index file is generated/updated as new files are being translated. The format is: input_document,target_language_code,translation_output,error_output, glossary_translation_output,glossary_error_output `input_document` is one file we matched using gcs_source.input_uri. `target_language_code` is provided in the request. `translation_output` contains the translations. (details provided below) `error_output` contains the error message during processing of the file. Both translations_file and errors_file could be empty strings if we have no content to output. `glossary_translation_output` and `glossary_error_output` are the translated output/error when we apply glossaries. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy) The naming format of translation output files follows (for target language code [trg]): `translation_output`: gs://translation_output/a_b_c_[trg]_translation.[extension] `glossary_translation_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.[extension] The output document will maintain the same file format as the input document. The naming format of error output files follows (for target language code [trg]): `error_output`: gs://translation_test/a_b_c_[trg]_errors.txt `glossary_error_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.txt The error output is a txt file containing error details."
+ "description": "Google Cloud Storage destination for output content. For every single input document (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateDocumentRequest). While the input documents are being processed, we write/update an index file `index.csv` under `gcs_destination.output_uri_prefix` (for example, gs://translation_output/index.csv) The index file is generated/updated as new files are being translated. The format is: input_document,target_language_code,translation_output,error_output, glossary_translation_output,glossary_error_output `input_document` is one file we matched using gcs_source.input_uri. `target_language_code` is provided in the request. `translation_output` contains the translations. (details provided below) `error_output` contains the error message during processing of the file. Both translations_file and errors_file could be empty strings if we have no content to output. `glossary_translation_output` and `glossary_error_output` are the translated output/error when we apply glossaries. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock#retention-policy) The naming format of translation output files follows (for target language code [trg]): `translation_output`: gs://translation_output/a_b_c_[trg]_translation.[extension] `glossary_translation_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.[extension] The output document will maintain the same file format as the input document. The naming format of error output files follows (for target language code [trg]): `error_output`: gs://translation_test/a_b_c_[trg]_errors.txt `glossary_error_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.txt The error output is a txt file containing error details."
}
},
"type": "object"
@@ -806,7 +993,7 @@
"description": "Required. Output configuration. If 2 input configs match to the same file (that is, same input path), we don't generate output for duplicate inputs."
},
"sourceLanguageCode": {
- "description": "Required. The BCP-47 language code of the input document if known, for example, \"en-US\" or \"sr-Latn\". Supported language codes are listed in Language Support (https://cloud.google.com/translate/docs/languages).",
+ "description": "Required. The BCP-47 language code of the input document if known, for example, \"en-US\" or \"sr-Latn\". Supported language codes are listed in [Language Support](https://cloud.google.com/translate/docs/languages).",
"type": "string"
},
"targetLanguageCodes": {
@@ -1021,6 +1208,10 @@
"description": "Represents a glossary built from user provided data.",
"id": "Glossary",
"properties": {
+ "displayName": {
+ "description": "Optional. The display name of the glossary.",
+ "type": "string"
+ },
"endTime": {
"description": "Output only. When the glossary creation was finished.",
"format": "google-datetime",
@@ -1058,6 +1249,29 @@
},
"type": "object"
},
+ "GlossaryEntry": {
+ "description": "Represents a single entry in a glossary.",
+ "id": "GlossaryEntry",
+ "properties": {
+ "description": {
+ "description": "Describes the glossary entry.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Required. The resource name of the entry. Format: \"projects/*/locations/*/glossaries/*/glossaryEntries/*\"",
+ "type": "string"
+ },
+ "termsPair": {
+ "$ref": "GlossaryTermsPair",
+ "description": "Used for an unidirectional glossary."
+ },
+ "termsSet": {
+ "$ref": "GlossaryTermsSet",
+ "description": "Used for an equivalent term sets glossary."
+ }
+ },
+ "type": "object"
+ },
"GlossaryInputConfig": {
"description": "Input configuration for glossaries.",
"id": "GlossaryInputConfig",
@@ -1069,6 +1283,50 @@
},
"type": "object"
},
+ "GlossaryTerm": {
+ "description": "Represents a single glossary term",
+ "id": "GlossaryTerm",
+ "properties": {
+ "languageCode": {
+ "description": "The language for this glossary term.",
+ "type": "string"
+ },
+ "text": {
+ "description": "The text for the glossary term.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "GlossaryTermsPair": {
+ "description": "Represents a single entry for an unidirectional glossary.",
+ "id": "GlossaryTermsPair",
+ "properties": {
+ "sourceTerm": {
+ "$ref": "GlossaryTerm",
+ "description": "The source term is the term that will get match in the text,"
+ },
+ "targetTerm": {
+ "$ref": "GlossaryTerm",
+ "description": "The term that will replace the match source term."
+ }
+ },
+ "type": "object"
+ },
+ "GlossaryTermsSet": {
+ "description": "Represents a single entry for an equivalent term set glossary. This is used for equivalent term sets where each term can be replaced by the other terms in the set.",
+ "id": "GlossaryTermsSet",
+ "properties": {
+ "terms": {
+ "description": "Each term in the set represents a term that can be replaced by the other terms.",
+ "items": {
+ "$ref": "GlossaryTerm"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
"InputConfig": {
"description": "Input configuration for BatchTranslateText request.",
"id": "InputConfig",
@@ -1131,6 +1389,24 @@
},
"type": "object"
},
+ "ListGlossaryEntriesResponse": {
+ "description": "Response message for ListGlossaryEntries",
+ "id": "ListGlossaryEntriesResponse",
+ "properties": {
+ "glossaryEntries": {
+ "description": "Optional. The Glossary Entries",
+ "items": {
+ "$ref": "GlossaryEntry"
+ },
+ "type": "array"
+ },
+ "nextPageToken": {
+ "description": "Optional. A token to retrieve a page of results. Pass this value in the [ListGLossaryEntriesRequest.page_token] field in the subsequent calls.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
"ListLocationsResponse": {
"description": "The response message for Locations.ListLocations.",
"id": "ListLocationsResponse",
@@ -1242,7 +1518,7 @@
"properties": {
"gcsDestination": {
"$ref": "GcsDestination",
- "description": "Google Cloud Storage destination for output content. For every single input file (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateTextRequest). Output files (tsv) generated are compliant with RFC 4180 except that record delimiters are '\\n' instead of '\\r\\n'. We don't provide any way to change record delimiters. While the input files are being processed, we write/update an index file 'index.csv' under 'output_uri_prefix' (for example, gs://translation-test/index.csv) The index file is generated/updated as new files are being translated. The format is: input_file,target_language_code,translations_file,errors_file, glossary_translations_file,glossary_errors_file input_file is one file we matched using gcs_source.input_uri. target_language_code is provided in the request. translations_file contains the translations. (details provided below) errors_file contains the errors during processing of the file. (details below). Both translations_file and errors_file could be empty strings if we have no content to output. glossary_translations_file and glossary_errors_file are always empty strings if the input_file is tsv. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy) The format of translations_file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_translations.[extension] If the input file extension is tsv, the output has the following columns: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: translation without applying a glossary. Empty string if there is an error. Column 4 (only present if a glossary is provided in the request): translation after applying the glossary. Empty string if there is an error applying the glossary. Could be same string as column 3 if there is no glossary applied. If input file extension is a txt or html, the translation is directly written to the output file. If glossary is requested, a separate glossary_translations_file has format of gs://translation_test/a_b_c_'trg'_glossary_translations.[extension] The format of errors file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_errors.[extension] If the input file extension is tsv, errors_file contains the following: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: Error detail for the translation. Could be empty. Column 4 (only present if a glossary is provided in the request): Error when applying the glossary. If the input file extension is txt or html, glossary_error_file will be generated that contains error details. glossary_error_file has format of gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]"
+ "description": "Google Cloud Storage destination for output content. For every single input file (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateTextRequest). Output files (tsv) generated are compliant with RFC 4180 except that record delimiters are '\\n' instead of '\\r\\n'. We don't provide any way to change record delimiters. While the input files are being processed, we write/update an index file 'index.csv' under 'output_uri_prefix' (for example, gs://translation-test/index.csv) The index file is generated/updated as new files are being translated. The format is: input_file,target_language_code,translations_file,errors_file, glossary_translations_file,glossary_errors_file input_file is one file we matched using gcs_source.input_uri. target_language_code is provided in the request. translations_file contains the translations. (details provided below) errors_file contains the errors during processing of the file. (details below). Both translations_file and errors_file could be empty strings if we have no content to output. glossary_translations_file and glossary_errors_file are always empty strings if the input_file is tsv. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock#retention-policy) The format of translations_file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_translations.[extension] If the input file extension is tsv, the output has the following columns: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: translation without applying a glossary. Empty string if there is an error. Column 4 (only present if a glossary is provided in the request): translation after applying the glossary. Empty string if there is an error applying the glossary. Could be same string as column 3 if there is no glossary applied. If input file extension is a txt or html, the translation is directly written to the output file. If glossary is requested, a separate glossary_translations_file has format of gs://translation_test/a_b_c_'trg'_glossary_translations.[extension] The format of errors file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_errors.[extension] If the input file extension is tsv, errors_file contains the following: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: Error detail for the translation. Could be empty. Column 4 (only present if a glossary is provided in the request): Error when applying the glossary. If the input file extension is txt or html, glossary_error_file will be generated that contains error details. glossary_error_file has format of gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]"
}
},
"type": "object"
diff --git a/translate/v3/translate-gen.go b/translate/v3/translate-gen.go
index 693058d6ad1..0df5e2f4dcc 100644
--- a/translate/v3/translate-gen.go
+++ b/translate/v3/translate-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/translate/docs/quickstarts
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/translate/v3"
-// ...
-// ctx := context.Background()
-// translateService, err := translate.NewService(ctx)
+// import "google.golang.org/api/translate/v3"
+// ...
+// ctx := context.Background()
+// translateService, err := translate.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// translateService, err := translate.NewService(ctx, option.WithScopes(translate.CloudTranslationScope))
+// translateService, err := translate.NewService(ctx, option.WithScopes(translate.CloudTranslationScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// translateService, err := translate.NewService(ctx, option.WithAPIKey("AIza..."))
+// translateService, err := translate.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// translateService, err := translate.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// translateService, err := translate.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package translate // import "google.golang.org/api/translate/v3"
@@ -176,11 +176,23 @@ type ProjectsLocationsService struct {
func NewProjectsLocationsGlossariesService(s *Service) *ProjectsLocationsGlossariesService {
rs := &ProjectsLocationsGlossariesService{s: s}
+ rs.GlossaryEntries = NewProjectsLocationsGlossariesGlossaryEntriesService(s)
return rs
}
type ProjectsLocationsGlossariesService struct {
s *Service
+
+ GlossaryEntries *ProjectsLocationsGlossariesGlossaryEntriesService
+}
+
+func NewProjectsLocationsGlossariesGlossaryEntriesService(s *Service) *ProjectsLocationsGlossariesGlossaryEntriesService {
+ rs := &ProjectsLocationsGlossariesGlossaryEntriesService{s: s}
+ return rs
+}
+
+type ProjectsLocationsGlossariesGlossaryEntriesService struct {
+ s *Service
}
func NewProjectsLocationsOperationsService(s *Service) *ProjectsLocationsOperationsService {
@@ -264,7 +276,7 @@ type BatchDocumentOutputConfig struct {
// index.csv will be keeping updated during the process, please make
// sure there is no custom retention policy applied on the output bucket
// that may avoid file updating.
- // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+ // (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
// The naming format of translation output files follows (for target
// language code [trg]): `translation_output`:
// gs://translation_output/a_b_c_[trg]_translation.[extension]
@@ -798,6 +810,9 @@ func (s *GcsSource) MarshalJSON() ([]byte, error) {
// Glossary: Represents a glossary built from user provided data.
type Glossary struct {
+ // DisplayName: Optional. The display name of the glossary.
+ DisplayName string `json:"displayName,omitempty"`
+
// EndTime: Output only. When the glossary creation was finished.
EndTime string `json:"endTime,omitempty"`
@@ -828,7 +843,7 @@ type Glossary struct {
// server.
googleapi.ServerResponse `json:"-"`
- // ForceSendFields is a list of field names (e.g. "EndTime") to
+ // ForceSendFields is a list of field names (e.g. "DisplayName") to
// unconditionally include in API requests. By default, fields with
// empty or default values are omitted from API requests. However, any
// non-pointer, non-interface field appearing in ForceSendFields will be
@@ -836,10 +851,10 @@ type Glossary struct {
// This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g. "EndTime") to include in
- // API requests with the JSON null value. By default, fields with empty
- // values are omitted from API requests. However, any field with an
- // empty value appearing in NullFields will be sent to the server as
+ // NullFields is a list of field names (e.g. "DisplayName") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
@@ -851,6 +866,48 @@ func (s *Glossary) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GlossaryEntry: Represents a single entry in a glossary.
+type GlossaryEntry struct {
+ // Description: Describes the glossary entry.
+ Description string `json:"description,omitempty"`
+
+ // Name: Required. The resource name of the entry. Format:
+ // "projects/*/locations/*/glossaries/*/glossaryEntries/*"
+ Name string `json:"name,omitempty"`
+
+ // TermsPair: Used for an unidirectional glossary.
+ TermsPair *GlossaryTermsPair `json:"termsPair,omitempty"`
+
+ // TermsSet: Used for an equivalent term sets glossary.
+ TermsSet *GlossaryTermsSet `json:"termsSet,omitempty"`
+
+ // ServerResponse contains the HTTP response code and headers from the
+ // server.
+ googleapi.ServerResponse `json:"-"`
+
+ // ForceSendFields is a list of field names (e.g. "Description") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "Description") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GlossaryEntry) MarshalJSON() ([]byte, error) {
+ type NoMethod GlossaryEntry
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// GlossaryInputConfig: Input configuration for glossaries.
type GlossaryInputConfig struct {
// GcsSource: Required. Google Cloud Storage location of glossary data.
@@ -892,6 +949,101 @@ func (s *GlossaryInputConfig) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// GlossaryTerm: Represents a single glossary term
+type GlossaryTerm struct {
+ // LanguageCode: The language for this glossary term.
+ LanguageCode string `json:"languageCode,omitempty"`
+
+ // Text: The text for the glossary term.
+ Text string `json:"text,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "LanguageCode") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "LanguageCode") to include
+ // in API requests with the JSON null value. By default, fields with
+ // empty values are omitted from API requests. However, any field with
+ // an empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GlossaryTerm) MarshalJSON() ([]byte, error) {
+ type NoMethod GlossaryTerm
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
+// GlossaryTermsPair: Represents a single entry for an unidirectional
+// glossary.
+type GlossaryTermsPair struct {
+ // SourceTerm: The source term is the term that will get match in the
+ // text,
+ SourceTerm *GlossaryTerm `json:"sourceTerm,omitempty"`
+
+ // TargetTerm: The term that will replace the match source term.
+ TargetTerm *GlossaryTerm `json:"targetTerm,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "SourceTerm") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "SourceTerm") to include in
+ // API requests with the JSON null value. By default, fields with empty
+ // values are omitted from API requests. However, any field with an
+ // empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GlossaryTermsPair) MarshalJSON() ([]byte, error) {
+ type NoMethod GlossaryTermsPair
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
+// GlossaryTermsSet: Represents a single entry for an equivalent term
+// set glossary. This is used for equivalent term sets where each term
+// can be replaced by the other terms in the set.
+type GlossaryTermsSet struct {
+ // Terms: Each term in the set represents a term that can be replaced by
+ // the other terms.
+ Terms []*GlossaryTerm `json:"terms,omitempty"`
+
+ // ForceSendFields is a list of field names (e.g. "Terms") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "Terms") to include in API
+ // requests with the JSON null value. By default, fields with empty
+ // values are omitted from API requests. However, any field with an
+ // empty value appearing in NullFields will be sent to the server as
+ // null. It is an error if a field in this list has a non-empty value.
+ // This may be used to include null fields in Patch requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *GlossaryTermsSet) MarshalJSON() ([]byte, error) {
+ type NoMethod GlossaryTermsSet
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// InputConfig: Input configuration for BatchTranslateText request.
type InputConfig struct {
// GcsSource: Required. Google Cloud Storage location for the source
@@ -1044,6 +1196,44 @@ func (s *ListGlossariesResponse) MarshalJSON() ([]byte, error) {
return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
}
+// ListGlossaryEntriesResponse: Response message for ListGlossaryEntries
+type ListGlossaryEntriesResponse struct {
+ // GlossaryEntries: Optional. The Glossary Entries
+ GlossaryEntries []*GlossaryEntry `json:"glossaryEntries,omitempty"`
+
+ // NextPageToken: Optional. A token to retrieve a page of results. Pass
+ // this value in the [ListGLossaryEntriesRequest.page_token] field in
+ // the subsequent calls.
+ NextPageToken string `json:"nextPageToken,omitempty"`
+
+ // ServerResponse contains the HTTP response code and headers from the
+ // server.
+ googleapi.ServerResponse `json:"-"`
+
+ // ForceSendFields is a list of field names (e.g. "GlossaryEntries") to
+ // unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
+ ForceSendFields []string `json:"-"`
+
+ // NullFields is a list of field names (e.g. "GlossaryEntries") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
+ NullFields []string `json:"-"`
+}
+
+func (s *ListGlossaryEntriesResponse) MarshalJSON() ([]byte, error) {
+ type NoMethod ListGlossaryEntriesResponse
+ raw := NoMethod(*s)
+ return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
+}
+
// ListLocationsResponse: The response message for
// Locations.ListLocations.
type ListLocationsResponse struct {
@@ -1258,7 +1448,7 @@ type OutputConfig struct {
// keeping updated during the process, please make sure there is no
// custom retention policy applied on the output bucket that may avoid
// file updating.
- // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+ // (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
// The format of translations_file (for target language code 'trg') is:
// gs://translation_test/a_b_c_'trg'_translations.[extension] If the
// input file extension is tsv, the output has the following columns:
@@ -1800,14 +1990,14 @@ type ProjectsDetectLanguageCall struct {
// DetectLanguage: Detects the language of text within a request.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format:
-// `projects/{project-number-or-id}/locations/{location-id}` or
-// `projects/{project-number-or-id}`. For global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Only models within the same
-// region (has same location-id) can be used. Otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format:
+// `projects/{project-number-or-id}/locations/{location-id}` or
+// `projects/{project-number-or-id}`. For global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Only models within the same
+// region (has same location-id) can be used. Otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsService) DetectLanguage(parent string, detectlanguagerequest *DetectLanguageRequest) *ProjectsDetectLanguageCall {
c := &ProjectsDetectLanguageCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1951,15 +2141,15 @@ type ProjectsGetSupportedLanguagesCall struct {
// GetSupportedLanguages: Returns a list of supported languages for
// translation.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for AutoML models. Only models within the same region (have same
-// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
-// is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for AutoML models. Only models within the same region (have same
+// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
+// is returned.
func (r *ProjectsService) GetSupportedLanguages(parent string) *ProjectsGetSupportedLanguagesCall {
c := &ProjectsGetSupportedLanguagesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2138,15 +2328,15 @@ type ProjectsTranslateTextCall struct {
// TranslateText: Translates input text and returns translated text.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for requests using AutoML models or custom glossaries. Models and
-// glossaries must be within the same region (have same location-id),
-// otherwise an INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for requests using AutoML models or custom glossaries. Models and
+// glossaries must be within the same region (have same location-id),
+// otherwise an INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsService) TranslateText(parent string, translatetextrequest *TranslateTextRequest) *ProjectsTranslateTextCall {
c := &ProjectsTranslateTextCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2295,12 +2485,12 @@ type ProjectsLocationsBatchTranslateDocumentCall struct {
// immediately and you can use google.longrunning.Operation.name to poll
// the status of the call.
//
-// - parent: Location to make a regional call. Format:
-// `projects/{project-number-or-id}/locations/{location-id}`. The
-// `global` location is not supported for batch translation. Only
-// AutoML Translation models or glossaries within the same region
-// (have the same location-id) can be used, otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Location to make a regional call. Format:
+// `projects/{project-number-or-id}/locations/{location-id}`. The
+// `global` location is not supported for batch translation. Only
+// AutoML Translation models or glossaries within the same region
+// (have the same location-id) can be used, otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) BatchTranslateDocument(parent string, batchtranslatedocumentrequest *BatchTranslateDocumentRequest) *ProjectsLocationsBatchTranslateDocumentCall {
c := &ProjectsLocationsBatchTranslateDocumentCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2448,12 +2638,12 @@ type ProjectsLocationsBatchTranslateTextCall struct {
// can use google.longrunning.Operation.name to poll the status of the
// call.
//
-// - parent: Location to make a call. Must refer to a caller's project.
-// Format: `projects/{project-number-or-id}/locations/{location-id}`.
-// The `global` location is not supported for batch translation. Only
-// AutoML Translation models or glossaries within the same region
-// (have the same location-id) can be used, otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Location to make a call. Must refer to a caller's project.
+// Format: `projects/{project-number-or-id}/locations/{location-id}`.
+// The `global` location is not supported for batch translation. Only
+// AutoML Translation models or glossaries within the same region
+// (have the same location-id) can be used, otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) BatchTranslateText(parent string, batchtranslatetextrequest *BatchTranslateTextRequest) *ProjectsLocationsBatchTranslateTextCall {
c := &ProjectsLocationsBatchTranslateTextCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2595,14 +2785,14 @@ type ProjectsLocationsDetectLanguageCall struct {
// DetectLanguage: Detects the language of text within a request.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format:
-// `projects/{project-number-or-id}/locations/{location-id}` or
-// `projects/{project-number-or-id}`. For global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Only models within the same
-// region (has same location-id) can be used. Otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format:
+// `projects/{project-number-or-id}/locations/{location-id}` or
+// `projects/{project-number-or-id}`. For global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Only models within the same
+// region (has same location-id) can be used. Otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) DetectLanguage(parent string, detectlanguagerequest *DetectLanguageRequest) *ProjectsLocationsDetectLanguageCall {
c := &ProjectsLocationsDetectLanguageCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2893,15 +3083,15 @@ type ProjectsLocationsGetSupportedLanguagesCall struct {
// GetSupportedLanguages: Returns a list of supported languages for
// translation.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for AutoML models. Only models within the same region (have same
-// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
-// is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for AutoML models. Only models within the same region (have same
+// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
+// is returned.
func (r *ProjectsLocationsService) GetSupportedLanguages(parent string) *ProjectsLocationsGetSupportedLanguagesCall {
c := &ProjectsLocationsGetSupportedLanguagesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3081,8 +3271,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3290,15 +3480,15 @@ type ProjectsLocationsTranslateDocumentCall struct {
// TranslateDocument: Translates documents in synchronous mode.
//
-// - parent: Location to make a regional call. Format:
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for requests using AutoML models or custom glossaries. Models and
-// glossaries must be within the same region (have the same
-// location-id), otherwise an INVALID_ARGUMENT (400) error is
-// returned.
+// - parent: Location to make a regional call. Format:
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for requests using AutoML models or custom glossaries. Models and
+// glossaries must be within the same region (have the same
+// location-id), otherwise an INVALID_ARGUMENT (400) error is
+// returned.
func (r *ProjectsLocationsService) TranslateDocument(parent string, translatedocumentrequest *TranslateDocumentRequest) *ProjectsLocationsTranslateDocumentCall {
c := &ProjectsLocationsTranslateDocumentCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3441,15 +3631,15 @@ type ProjectsLocationsTranslateTextCall struct {
// TranslateText: Translates input text and returns translated text.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for requests using AutoML models or custom glossaries. Models and
-// glossaries must be within the same region (have same location-id),
-// otherwise an INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for requests using AutoML models or custom glossaries. Models and
+// glossaries must be within the same region (have same location-id),
+// otherwise an INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) TranslateText(parent string, translatetextrequest *TranslateTextRequest) *ProjectsLocationsTranslateTextCall {
c := &ProjectsLocationsTranslateTextCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4019,8 +4209,8 @@ type ProjectsLocationsGlossariesListCall struct {
// List: Lists glossaries in a project. Returns NOT_FOUND, if the
// project doesn't exist.
//
-// - parent: The name of the project from which to list all of the
-// glossaries.
+// - parent: The name of the project from which to list all of the
+// glossaries.
func (r *ProjectsLocationsGlossariesService) List(parent string) *ProjectsLocationsGlossariesListCall {
c := &ProjectsLocationsGlossariesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4230,6 +4420,932 @@ func (c *ProjectsLocationsGlossariesListCall) Pages(ctx context.Context, f func(
}
}
+// method id "translate.projects.locations.glossaries.patch":
+
+type ProjectsLocationsGlossariesPatchCall struct {
+ s *Service
+ name string
+ glossary *Glossary
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Patch: Updates a glossary. A LRO is used since the update can be
+// async if the glossary's entry file is updated.
+//
+// - name: The resource name of the glossary. Glossary names have the
+// form
+// `projects/{project-number-or-id}/locations/{location-id}/glossaries/
+// {glossary-id}`.
+func (r *ProjectsLocationsGlossariesService) Patch(name string, glossary *Glossary) *ProjectsLocationsGlossariesPatchCall {
+ c := &ProjectsLocationsGlossariesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ c.glossary = glossary
+ return c
+}
+
+// UpdateMask sets the optional parameter "updateMask": The list of
+// fields to be updated. Currently only `display_name` and
+// 'input_config'
+func (c *ProjectsLocationsGlossariesPatchCall) UpdateMask(updateMask string) *ProjectsLocationsGlossariesPatchCall {
+ c.urlParams_.Set("updateMask", updateMask)
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsGlossariesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlossariesPatchCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsGlossariesPatchCall) Context(ctx context.Context) *ProjectsLocationsGlossariesPatchCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsGlossariesPatchCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsGlossariesPatchCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.glossary)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v3/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("PATCH", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "translate.projects.locations.glossaries.patch" call.
+// Exactly one of *Operation or error will be non-nil. Any non-2xx
+// status code is an error. Response headers are in either
+// *Operation.ServerResponse.Header or (if a response was returned at
+// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified
+// to check whether the returned error was because
+// http.StatusNotModified was returned.
+func (c *ProjectsLocationsGlossariesPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &Operation{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Updates a glossary. A LRO is used since the update can be async if the glossary's entry file is updated.",
+ // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}",
+ // "httpMethod": "PATCH",
+ // "id": "translate.projects.locations.glossaries.patch",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. The resource name of the glossary. Glossary names have the form `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // },
+ // "updateMask": {
+ // "description": "The list of fields to be updated. Currently only `display_name` and 'input_config'",
+ // "format": "google-fieldmask",
+ // "location": "query",
+ // "type": "string"
+ // }
+ // },
+ // "path": "v3/{+name}",
+ // "request": {
+ // "$ref": "Glossary"
+ // },
+ // "response": {
+ // "$ref": "Operation"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform"
+ // ]
+ // }
+
+}
+
+// method id "translate.projects.locations.glossaries.glossaryEntries.create":
+
+type ProjectsLocationsGlossariesGlossaryEntriesCreateCall struct {
+ s *Service
+ parent string
+ glossaryentry *GlossaryEntry
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Create: Creates a glossary entry.
+//
+// - parent: The resource name of the glossary to create the entry
+// under.
+func (r *ProjectsLocationsGlossariesGlossaryEntriesService) Create(parent string, glossaryentry *GlossaryEntry) *ProjectsLocationsGlossariesGlossaryEntriesCreateCall {
+ c := &ProjectsLocationsGlossariesGlossaryEntriesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.parent = parent
+ c.glossaryentry = glossaryentry
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesCreateCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlossariesGlossaryEntriesCreateCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesCreateCall) Context(ctx context.Context) *ProjectsLocationsGlossariesGlossaryEntriesCreateCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesCreateCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsGlossariesGlossaryEntriesCreateCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.glossaryentry)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v3/{+parent}/glossaryEntries")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("POST", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "parent": c.parent,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "translate.projects.locations.glossaries.glossaryEntries.create" call.
+// Exactly one of *GlossaryEntry or error will be non-nil. Any non-2xx
+// status code is an error. Response headers are in either
+// *GlossaryEntry.ServerResponse.Header or (if a response was returned
+// at all) in error.(*googleapi.Error).Header. Use
+// googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesCreateCall) Do(opts ...googleapi.CallOption) (*GlossaryEntry, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GlossaryEntry{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Creates a glossary entry.",
+ // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries",
+ // "httpMethod": "POST",
+ // "id": "translate.projects.locations.glossaries.glossaryEntries.create",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "parent": {
+ // "description": "Required. The resource name of the glossary to create the entry under.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v3/{+parent}/glossaryEntries",
+ // "request": {
+ // "$ref": "GlossaryEntry"
+ // },
+ // "response": {
+ // "$ref": "GlossaryEntry"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/cloud-translation"
+ // ]
+ // }
+
+}
+
+// method id "translate.projects.locations.glossaries.glossaryEntries.delete":
+
+type ProjectsLocationsGlossariesGlossaryEntriesDeleteCall struct {
+ s *Service
+ name string
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Delete: Deletes a single entry from the glossary
+//
+// - name: The resource name of the glossary entry to delete.
+func (r *ProjectsLocationsGlossariesGlossaryEntriesService) Delete(name string) *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall {
+ c := &ProjectsLocationsGlossariesGlossaryEntriesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall) Context(ctx context.Context) *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v3/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("DELETE", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "translate.projects.locations.glossaries.glossaryEntries.delete" call.
+// Exactly one of *Empty or error will be non-nil. Any non-2xx status
+// code is an error. Response headers are in either
+// *Empty.ServerResponse.Header or (if a response was returned at all)
+// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to
+// check whether the returned error was because http.StatusNotModified
+// was returned.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &Empty{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Deletes a single entry from the glossary",
+ // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries/{glossaryEntriesId}",
+ // "httpMethod": "DELETE",
+ // "id": "translate.projects.locations.glossaries.glossaryEntries.delete",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. The resource name of the glossary entry to delete",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+/glossaryEntries/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v3/{+name}",
+ // "response": {
+ // "$ref": "Empty"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/cloud-translation"
+ // ]
+ // }
+
+}
+
+// method id "translate.projects.locations.glossaries.glossaryEntries.get":
+
+type ProjectsLocationsGlossariesGlossaryEntriesGetCall struct {
+ s *Service
+ name string
+ urlParams_ gensupport.URLParams
+ ifNoneMatch_ string
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Get: Gets a single glossary entry by the given id.
+//
+// - name: The resource name of the glossary entry to get.
+func (r *ProjectsLocationsGlossariesGlossaryEntriesService) Get(name string) *ProjectsLocationsGlossariesGlossaryEntriesGetCall {
+ c := &ProjectsLocationsGlossariesGlossaryEntriesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlossariesGlossaryEntriesGetCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// IfNoneMatch sets the optional parameter which makes the operation
+// fail if the object's ETag matches the given value. This is useful for
+// getting updates only after the object has changed since the last
+// request. Use googleapi.IsNotModified to check whether the response
+// error from Do is the result of In-None-Match.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlossariesGlossaryEntriesGetCall {
+ c.ifNoneMatch_ = entityTag
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesGetCall) Context(ctx context.Context) *ProjectsLocationsGlossariesGlossaryEntriesGetCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesGetCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsGlossariesGlossaryEntriesGetCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ if c.ifNoneMatch_ != "" {
+ reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
+ }
+ var body io.Reader = nil
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v3/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("GET", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "translate.projects.locations.glossaries.glossaryEntries.get" call.
+// Exactly one of *GlossaryEntry or error will be non-nil. Any non-2xx
+// status code is an error. Response headers are in either
+// *GlossaryEntry.ServerResponse.Header or (if a response was returned
+// at all) in error.(*googleapi.Error).Header. Use
+// googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesGetCall) Do(opts ...googleapi.CallOption) (*GlossaryEntry, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GlossaryEntry{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Gets a single glossary entry by the given id.",
+ // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries/{glossaryEntriesId}",
+ // "httpMethod": "GET",
+ // "id": "translate.projects.locations.glossaries.glossaryEntries.get",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. The resource name of the glossary entry to get",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+/glossaryEntries/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v3/{+name}",
+ // "response": {
+ // "$ref": "GlossaryEntry"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/cloud-translation"
+ // ]
+ // }
+
+}
+
+// method id "translate.projects.locations.glossaries.glossaryEntries.list":
+
+type ProjectsLocationsGlossariesGlossaryEntriesListCall struct {
+ s *Service
+ parent string
+ urlParams_ gensupport.URLParams
+ ifNoneMatch_ string
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// List: List the entries for the glossary.
+//
+// - parent: The parent glossary resource name for listing the
+// glossary's entries.
+func (r *ProjectsLocationsGlossariesGlossaryEntriesService) List(parent string) *ProjectsLocationsGlossariesGlossaryEntriesListCall {
+ c := &ProjectsLocationsGlossariesGlossaryEntriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.parent = parent
+ return c
+}
+
+// PageSize sets the optional parameter "pageSize": Requested page size.
+// The server may return fewer glossary entries than requested. If
+// unspecified, the server picks an appropriate default.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) PageSize(pageSize int64) *ProjectsLocationsGlossariesGlossaryEntriesListCall {
+ c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
+ return c
+}
+
+// PageToken sets the optional parameter "pageToken": A token
+// identifying a page of results the server should return. Typically,
+// this is the value of [ListGlossaryEntriesResponse.next_page_token]
+// returned from the previous call. The first page is returned if
+// `page_token`is empty or missing.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) PageToken(pageToken string) *ProjectsLocationsGlossariesGlossaryEntriesListCall {
+ c.urlParams_.Set("pageToken", pageToken)
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlossariesGlossaryEntriesListCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// IfNoneMatch sets the optional parameter which makes the operation
+// fail if the object's ETag matches the given value. This is useful for
+// getting updates only after the object has changed since the last
+// request. Use googleapi.IsNotModified to check whether the response
+// error from Do is the result of In-None-Match.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) IfNoneMatch(entityTag string) *ProjectsLocationsGlossariesGlossaryEntriesListCall {
+ c.ifNoneMatch_ = entityTag
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) Context(ctx context.Context) *ProjectsLocationsGlossariesGlossaryEntriesListCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ if c.ifNoneMatch_ != "" {
+ reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
+ }
+ var body io.Reader = nil
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v3/{+parent}/glossaryEntries")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("GET", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "parent": c.parent,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "translate.projects.locations.glossaries.glossaryEntries.list" call.
+// Exactly one of *ListGlossaryEntriesResponse or error will be non-nil.
+// Any non-2xx status code is an error. Response headers are in either
+// *ListGlossaryEntriesResponse.ServerResponse.Header or (if a response
+// was returned at all) in error.(*googleapi.Error).Header. Use
+// googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) Do(opts ...googleapi.CallOption) (*ListGlossaryEntriesResponse, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &ListGlossaryEntriesResponse{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "List the entries for the glossary.",
+ // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries",
+ // "httpMethod": "GET",
+ // "id": "translate.projects.locations.glossaries.glossaryEntries.list",
+ // "parameterOrder": [
+ // "parent"
+ // ],
+ // "parameters": {
+ // "pageSize": {
+ // "description": "Optional. Requested page size. The server may return fewer glossary entries than requested. If unspecified, the server picks an appropriate default.",
+ // "format": "int32",
+ // "location": "query",
+ // "type": "integer"
+ // },
+ // "pageToken": {
+ // "description": "Optional. A token identifying a page of results the server should return. Typically, this is the value of [ListGlossaryEntriesResponse.next_page_token] returned from the previous call. The first page is returned if `page_token`is empty or missing.",
+ // "location": "query",
+ // "type": "string"
+ // },
+ // "parent": {
+ // "description": "Required. The parent glossary resource name for listing the glossary's entries.",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v3/{+parent}/glossaryEntries",
+ // "response": {
+ // "$ref": "ListGlossaryEntriesResponse"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/cloud-translation"
+ // ]
+ // }
+
+}
+
+// Pages invokes f for each page of results.
+// A non-nil error returned from f will halt the iteration.
+// The provided context supersedes any context provided to the Context method.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesListCall) Pages(ctx context.Context, f func(*ListGlossaryEntriesResponse) error) error {
+ c.ctx_ = ctx
+ defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point
+ for {
+ x, err := c.Do()
+ if err != nil {
+ return err
+ }
+ if err := f(x); err != nil {
+ return err
+ }
+ if x.NextPageToken == "" {
+ return nil
+ }
+ c.PageToken(x.NextPageToken)
+ }
+}
+
+// method id "translate.projects.locations.glossaries.glossaryEntries.patch":
+
+type ProjectsLocationsGlossariesGlossaryEntriesPatchCall struct {
+ s *Service
+ name string
+ glossaryentry *GlossaryEntry
+ urlParams_ gensupport.URLParams
+ ctx_ context.Context
+ header_ http.Header
+}
+
+// Patch: Updates a glossary entry.
+//
+// - name: The resource name of the entry. Format:
+// "projects/*/locations/*/glossaries/*/glossaryEntries/*".
+func (r *ProjectsLocationsGlossariesGlossaryEntriesService) Patch(name string, glossaryentry *GlossaryEntry) *ProjectsLocationsGlossariesGlossaryEntriesPatchCall {
+ c := &ProjectsLocationsGlossariesGlossaryEntriesPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
+ c.name = name
+ c.glossaryentry = glossaryentry
+ return c
+}
+
+// Fields allows partial responses to be retrieved. See
+// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
+// for more information.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesPatchCall) Fields(s ...googleapi.Field) *ProjectsLocationsGlossariesGlossaryEntriesPatchCall {
+ c.urlParams_.Set("fields", googleapi.CombineFields(s))
+ return c
+}
+
+// Context sets the context to be used in this call's Do method. Any
+// pending HTTP request will be aborted if the provided context is
+// canceled.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesPatchCall) Context(ctx context.Context) *ProjectsLocationsGlossariesGlossaryEntriesPatchCall {
+ c.ctx_ = ctx
+ return c
+}
+
+// Header returns an http.Header that can be modified by the caller to
+// add HTTP headers to the request.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesPatchCall) Header() http.Header {
+ if c.header_ == nil {
+ c.header_ = make(http.Header)
+ }
+ return c.header_
+}
+
+func (c *ProjectsLocationsGlossariesGlossaryEntriesPatchCall) doRequest(alt string) (*http.Response, error) {
+ reqHeaders := make(http.Header)
+ reqHeaders.Set("x-goog-api-client", "gl-go/"+gensupport.GoVersion()+" gdcl/"+internal.Version)
+ for k, v := range c.header_ {
+ reqHeaders[k] = v
+ }
+ reqHeaders.Set("User-Agent", c.s.userAgent())
+ var body io.Reader = nil
+ body, err := googleapi.WithoutDataWrapper.JSONReader(c.glossaryentry)
+ if err != nil {
+ return nil, err
+ }
+ reqHeaders.Set("Content-Type", "application/json")
+ c.urlParams_.Set("alt", alt)
+ c.urlParams_.Set("prettyPrint", "false")
+ urls := googleapi.ResolveRelative(c.s.BasePath, "v3/{+name}")
+ urls += "?" + c.urlParams_.Encode()
+ req, err := http.NewRequest("PATCH", urls, body)
+ if err != nil {
+ return nil, err
+ }
+ req.Header = reqHeaders
+ googleapi.Expand(req.URL, map[string]string{
+ "name": c.name,
+ })
+ return gensupport.SendRequest(c.ctx_, c.s.client, req)
+}
+
+// Do executes the "translate.projects.locations.glossaries.glossaryEntries.patch" call.
+// Exactly one of *GlossaryEntry or error will be non-nil. Any non-2xx
+// status code is an error. Response headers are in either
+// *GlossaryEntry.ServerResponse.Header or (if a response was returned
+// at all) in error.(*googleapi.Error).Header. Use
+// googleapi.IsNotModified to check whether the returned error was
+// because http.StatusNotModified was returned.
+func (c *ProjectsLocationsGlossariesGlossaryEntriesPatchCall) Do(opts ...googleapi.CallOption) (*GlossaryEntry, error) {
+ gensupport.SetOptions(c.urlParams_, opts...)
+ res, err := c.doRequest("json")
+ if res != nil && res.StatusCode == http.StatusNotModified {
+ if res.Body != nil {
+ res.Body.Close()
+ }
+ return nil, &googleapi.Error{
+ Code: res.StatusCode,
+ Header: res.Header,
+ }
+ }
+ if err != nil {
+ return nil, err
+ }
+ defer googleapi.CloseBody(res)
+ if err := googleapi.CheckResponse(res); err != nil {
+ return nil, err
+ }
+ ret := &GlossaryEntry{
+ ServerResponse: googleapi.ServerResponse{
+ Header: res.Header,
+ HTTPStatusCode: res.StatusCode,
+ },
+ }
+ target := &ret
+ if err := gensupport.DecodeResponse(target, res); err != nil {
+ return nil, err
+ }
+ return ret, nil
+ // {
+ // "description": "Updates a glossary entry.",
+ // "flatPath": "v3/projects/{projectsId}/locations/{locationsId}/glossaries/{glossariesId}/glossaryEntries/{glossaryEntriesId}",
+ // "httpMethod": "PATCH",
+ // "id": "translate.projects.locations.glossaries.glossaryEntries.patch",
+ // "parameterOrder": [
+ // "name"
+ // ],
+ // "parameters": {
+ // "name": {
+ // "description": "Required. The resource name of the entry. Format: \"projects/*/locations/*/glossaries/*/glossaryEntries/*\"",
+ // "location": "path",
+ // "pattern": "^projects/[^/]+/locations/[^/]+/glossaries/[^/]+/glossaryEntries/[^/]+$",
+ // "required": true,
+ // "type": "string"
+ // }
+ // },
+ // "path": "v3/{+name}",
+ // "request": {
+ // "$ref": "GlossaryEntry"
+ // },
+ // "response": {
+ // "$ref": "GlossaryEntry"
+ // },
+ // "scopes": [
+ // "https://www.googleapis.com/auth/cloud-platform",
+ // "https://www.googleapis.com/auth/cloud-translation"
+ // ]
+ // }
+
+}
+
// method id "translate.projects.locations.operations.cancel":
type ProjectsLocationsOperationsCancelCall struct {
diff --git a/translate/v3beta1/translate-api.json b/translate/v3beta1/translate-api.json
index 51903a56278..52f2018d296 100644
--- a/translate/v3beta1/translate-api.json
+++ b/translate/v3beta1/translate-api.json
@@ -744,7 +744,7 @@
}
}
},
- "revision": "20220401",
+ "revision": "20220805",
"rootUrl": "https://translation.googleapis.com/",
"schemas": {
"BatchDocumentInputConfig": {
@@ -764,7 +764,7 @@
"properties": {
"gcsDestination": {
"$ref": "GcsDestination",
- "description": "Google Cloud Storage destination for output content. For every single input document (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateDocumentRequest). While the input documents are being processed, we write/update an index file `index.csv` under `gcs_destination.output_uri_prefix` (for example, gs://translation_output/index.csv) The index file is generated/updated as new files are being translated. The format is: input_document,target_language_code,translation_output,error_output, glossary_translation_output,glossary_error_output `input_document` is one file we matched using gcs_source.input_uri. `target_language_code` is provided in the request. `translation_output` contains the translations. (details provided below) `error_output` contains the error message during processing of the file. Both translations_file and errors_file could be empty strings if we have no content to output. `glossary_translation_output` and `glossary_error_output` are the translated output/error when we apply glossaries. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy) The naming format of translation output files follows (for target language code [trg]): `translation_output`: gs://translation_output/a_b_c_[trg]_translation.[extension] `glossary_translation_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.[extension] The output document will maintain the same file format as the input document. The naming format of error output files follows (for target language code [trg]): `error_output`: gs://translation_test/a_b_c_[trg]_errors.txt `glossary_error_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.txt The error output is a txt file containing error details."
+ "description": "Google Cloud Storage destination for output content. For every single input document (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateDocumentRequest). While the input documents are being processed, we write/update an index file `index.csv` under `gcs_destination.output_uri_prefix` (for example, gs://translation_output/index.csv) The index file is generated/updated as new files are being translated. The format is: input_document,target_language_code,translation_output,error_output, glossary_translation_output,glossary_error_output `input_document` is one file we matched using gcs_source.input_uri. `target_language_code` is provided in the request. `translation_output` contains the translations. (details provided below) `error_output` contains the error message during processing of the file. Both translations_file and errors_file could be empty strings if we have no content to output. `glossary_translation_output` and `glossary_error_output` are the translated output/error when we apply glossaries. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock#retention-policy) The naming format of translation output files follows (for target language code [trg]): `translation_output`: gs://translation_output/a_b_c_[trg]_translation.[extension] `glossary_translation_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.[extension] The output document will maintain the same file format as the input document. The naming format of error output files follows (for target language code [trg]): `error_output`: gs://translation_test/a_b_c_[trg]_errors.txt `glossary_error_output`: gs://translation_test/a_b_c_[trg]_glossary_translation.txt The error output is a txt file containing error details."
}
},
"type": "object"
@@ -806,7 +806,7 @@
"description": "Required. Output configuration. If 2 input configs match to the same file (that is, same input path), we don't generate output for duplicate inputs."
},
"sourceLanguageCode": {
- "description": "Required. The BCP-47 language code of the input document if known, for example, \"en-US\" or \"sr-Latn\". Supported language codes are listed in Language Support (https://cloud.google.com/translate/docs/languages).",
+ "description": "Required. The BCP-47 language code of the input document if known, for example, \"en-US\" or \"sr-Latn\". Supported language codes are listed in [Language Support](https://cloud.google.com/translate/docs/languages).",
"type": "string"
},
"targetLanguageCodes": {
@@ -1064,7 +1064,7 @@
"properties": {
"gcsSource": {
"$ref": "GcsSource",
- "description": "Required. Google Cloud Storage location of glossary data. File format is determined based on the filename extension. API returns [google.rpc.Code.INVALID_ARGUMENT] for unsupported URI-s and file formats. Wildcards are not allowed. This must be a single file in one of the following formats: For unidirectional glossaries: - TSV/CSV (`.tsv`/`.csv`): 2 column file, tab- or comma-separated. The first column is source text. The second column is target text. The file must not contain headers. That is, the first row is data, not column names. - TMX (`.tmx`): TMX file with parallel data defining source/target term pairs. For equivalent term sets glossaries: - CSV (`.csv`): Multi-column CSV file defining equivalent glossary terms in multiple languages. The format is defined for Google Translation Toolkit and documented in [Use a glossary](https://support.google.com/translatortoolkit/answer/6306379?hl=en)."
+ "description": "Required. Google Cloud Storage location of glossary data. File format is determined based on the filename extension. API returns [google.rpc.Code.INVALID_ARGUMENT] for unsupported URI-s and file formats. Wildcards are not allowed. This must be a single file in one of the following formats: For unidirectional glossaries: - TSV/CSV (`.tsv`/`.csv`): 2 column file, tab- or comma-separated. The first column is source text. The second column is target text. The file must not contain headers. That is, the first row is data, not column names. - TMX (`.tmx`): TMX file with parallel data defining source/target term pairs. For equivalent term sets glossaries: - CSV (`.csv`): Multi-column CSV file defining equivalent glossary terms in multiple languages. See documentation for more information - [glossaries](https://cloud.google.com/translate/docs/advanced/glossary)."
}
},
"type": "object"
@@ -1242,7 +1242,7 @@
"properties": {
"gcsDestination": {
"$ref": "GcsDestination",
- "description": "Google Cloud Storage destination for output content. For every single input file (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateTextRequest). Output files (tsv) generated are compliant with RFC 4180 except that record delimiters are '\\n' instead of '\\r\\n'. We don't provide any way to change record delimiters. While the input files are being processed, we write/update an index file 'index.csv' under 'output_uri_prefix' (for example, gs://translation-test/index.csv) The index file is generated/updated as new files are being translated. The format is: input_file,target_language_code,translations_file,errors_file, glossary_translations_file,glossary_errors_file input_file is one file we matched using gcs_source.input_uri. target_language_code is provided in the request. translations_file contains the translations. (details provided below) errors_file contains the errors during processing of the file. (details below). Both translations_file and errors_file could be empty strings if we have no content to output. glossary_translations_file and glossary_errors_file are always empty strings if the input_file is tsv. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy) The format of translations_file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_translations.[extension] If the input file extension is tsv, the output has the following columns: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: translation without applying a glossary. Empty string if there is an error. Column 4 (only present if a glossary is provided in the request): translation after applying the glossary. Empty string if there is an error applying the glossary. Could be same string as column 3 if there is no glossary applied. If input file extension is a txt or html, the translation is directly written to the output file. If glossary is requested, a separate glossary_translations_file has format of gs://translation_test/a_b_c_'trg'_glossary_translations.[extension] The format of errors file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_errors.[extension] If the input file extension is tsv, errors_file contains the following: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: Error detail for the translation. Could be empty. Column 4 (only present if a glossary is provided in the request): Error when applying the glossary. If the input file extension is txt or html, glossary_error_file will be generated that contains error details. glossary_error_file has format of gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]"
+ "description": "Google Cloud Storage destination for output content. For every single input file (for example, gs://a/b/c.[extension]), we generate at most 2 * n output files. (n is the # of target_language_codes in the BatchTranslateTextRequest). Output files (tsv) generated are compliant with RFC 4180 except that record delimiters are '\\n' instead of '\\r\\n'. We don't provide any way to change record delimiters. While the input files are being processed, we write/update an index file 'index.csv' under 'output_uri_prefix' (for example, gs://translation-test/index.csv) The index file is generated/updated as new files are being translated. The format is: input_file,target_language_code,translations_file,errors_file, glossary_translations_file,glossary_errors_file input_file is one file we matched using gcs_source.input_uri. target_language_code is provided in the request. translations_file contains the translations. (details provided below) errors_file contains the errors during processing of the file. (details below). Both translations_file and errors_file could be empty strings if we have no content to output. glossary_translations_file and glossary_errors_file are always empty strings if the input_file is tsv. They could also be empty if we have no content to output. Once a row is present in index.csv, the input/output matching never changes. Callers should also expect all the content in input_file are processed and ready to be consumed (that is, no partial output file is written). Since index.csv will be keeping updated during the process, please make sure there is no custom retention policy applied on the output bucket that may avoid file updating. (https://cloud.google.com/storage/docs/bucket-lock#retention-policy) The format of translations_file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_translations.[extension] If the input file extension is tsv, the output has the following columns: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: translation without applying a glossary. Empty string if there is an error. Column 4 (only present if a glossary is provided in the request): translation after applying the glossary. Empty string if there is an error applying the glossary. Could be same string as column 3 if there is no glossary applied. If input file extension is a txt or html, the translation is directly written to the output file. If glossary is requested, a separate glossary_translations_file has format of gs://translation_test/a_b_c_'trg'_glossary_translations.[extension] The format of errors file (for target language code 'trg') is: gs://translation_test/a_b_c_'trg'_errors.[extension] If the input file extension is tsv, errors_file contains the following: Column 1: ID of the request provided in the input, if it's not provided in the input, then the input row number is used (0-based). Column 2: source sentence. Column 3: Error detail for the translation. Could be empty. Column 4 (only present if a glossary is provided in the request): Error when applying the glossary. If the input file extension is txt or html, glossary_error_file will be generated that contains error details. glossary_error_file has format of gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]"
}
},
"type": "object"
diff --git a/translate/v3beta1/translate-gen.go b/translate/v3beta1/translate-gen.go
index 21f741b9b7a..14059941cd9 100644
--- a/translate/v3beta1/translate-gen.go
+++ b/translate/v3beta1/translate-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/translate/docs/quickstarts
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/translate/v3beta1"
-// ...
-// ctx := context.Background()
-// translateService, err := translate.NewService(ctx)
+// import "google.golang.org/api/translate/v3beta1"
+// ...
+// ctx := context.Background()
+// translateService, err := translate.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// translateService, err := translate.NewService(ctx, option.WithScopes(translate.CloudTranslationScope))
+// translateService, err := translate.NewService(ctx, option.WithScopes(translate.CloudTranslationScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// translateService, err := translate.NewService(ctx, option.WithAPIKey("AIza..."))
+// translateService, err := translate.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// translateService, err := translate.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// translateService, err := translate.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package translate // import "google.golang.org/api/translate/v3beta1"
@@ -264,7 +264,7 @@ type BatchDocumentOutputConfig struct {
// index.csv will be keeping updated during the process, please make
// sure there is no custom retention policy applied on the output bucket
// that may avoid file updating.
- // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+ // (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
// The naming format of translation output files follows (for target
// language code [trg]): `translation_output`:
// gs://translation_output/a_b_c_[trg]_translation.[extension]
@@ -861,9 +861,9 @@ type GlossaryInputConfig struct {
// column names. - TMX (`.tmx`): TMX file with parallel data defining
// source/target term pairs. For equivalent term sets glossaries: - CSV
// (`.csv`): Multi-column CSV file defining equivalent glossary terms in
- // multiple languages. The format is defined for Google Translation
- // Toolkit and documented in Use a glossary
- // (https://support.google.com/translatortoolkit/answer/6306379?hl=en).
+ // multiple languages. See documentation for more information -
+ // glossaries
+ // (https://cloud.google.com/translate/docs/advanced/glossary).
GcsSource *GcsSource `json:"gcsSource,omitempty"`
// ForceSendFields is a list of field names (e.g. "GcsSource") to
@@ -1255,7 +1255,7 @@ type OutputConfig struct {
// keeping updated during the process, please make sure there is no
// custom retention policy applied on the output bucket that may avoid
// file updating.
- // (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
+ // (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
// The format of translations_file (for target language code 'trg') is:
// gs://translation_test/a_b_c_'trg'_translations.[extension] If the
// input file extension is tsv, the output has the following columns:
@@ -1794,14 +1794,14 @@ type ProjectsDetectLanguageCall struct {
// DetectLanguage: Detects the language of text within a request.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format:
-// `projects/{project-number-or-id}/locations/{location-id}` or
-// `projects/{project-number-or-id}`. For global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Only models within the same
-// region (has same location-id) can be used. Otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format:
+// `projects/{project-number-or-id}/locations/{location-id}` or
+// `projects/{project-number-or-id}`. For global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Only models within the same
+// region (has same location-id) can be used. Otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsService) DetectLanguage(parent string, detectlanguagerequest *DetectLanguageRequest) *ProjectsDetectLanguageCall {
c := &ProjectsDetectLanguageCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1945,15 +1945,15 @@ type ProjectsGetSupportedLanguagesCall struct {
// GetSupportedLanguages: Returns a list of supported languages for
// translation.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for AutoML models. Only models within the same region (have same
-// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
-// is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for AutoML models. Only models within the same region (have same
+// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
+// is returned.
func (r *ProjectsService) GetSupportedLanguages(parent string) *ProjectsGetSupportedLanguagesCall {
c := &ProjectsGetSupportedLanguagesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2132,15 +2132,15 @@ type ProjectsTranslateTextCall struct {
// TranslateText: Translates input text and returns translated text.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for requests using AutoML models or custom glossaries. Models and
-// glossaries must be within the same region (have same location-id),
-// otherwise an INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for requests using AutoML models or custom glossaries. Models and
+// glossaries must be within the same region (have same location-id),
+// otherwise an INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsService) TranslateText(parent string, translatetextrequest *TranslateTextRequest) *ProjectsTranslateTextCall {
c := &ProjectsTranslateTextCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2289,12 +2289,12 @@ type ProjectsLocationsBatchTranslateDocumentCall struct {
// immediately and you can use google.longrunning.Operation.name to poll
// the status of the call.
//
-// - parent: Location to make a regional call. Format:
-// `projects/{project-number-or-id}/locations/{location-id}`. The
-// `global` location is not supported for batch translation. Only
-// AutoML Translation models or glossaries within the same region
-// (have the same location-id) can be used, otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Location to make a regional call. Format:
+// `projects/{project-number-or-id}/locations/{location-id}`. The
+// `global` location is not supported for batch translation. Only
+// AutoML Translation models or glossaries within the same region
+// (have the same location-id) can be used, otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) BatchTranslateDocument(parent string, batchtranslatedocumentrequest *BatchTranslateDocumentRequest) *ProjectsLocationsBatchTranslateDocumentCall {
c := &ProjectsLocationsBatchTranslateDocumentCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2442,12 +2442,12 @@ type ProjectsLocationsBatchTranslateTextCall struct {
// can use google.longrunning.Operation.name to poll the status of the
// call.
//
-// - parent: Location to make a call. Must refer to a caller's project.
-// Format: `projects/{project-number-or-id}/locations/{location-id}`.
-// The `global` location is not supported for batch translation. Only
-// AutoML Translation models or glossaries within the same region
-// (have the same location-id) can be used, otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Location to make a call. Must refer to a caller's project.
+// Format: `projects/{project-number-or-id}/locations/{location-id}`.
+// The `global` location is not supported for batch translation. Only
+// AutoML Translation models or glossaries within the same region
+// (have the same location-id) can be used, otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) BatchTranslateText(parent string, batchtranslatetextrequest *BatchTranslateTextRequest) *ProjectsLocationsBatchTranslateTextCall {
c := &ProjectsLocationsBatchTranslateTextCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2589,14 +2589,14 @@ type ProjectsLocationsDetectLanguageCall struct {
// DetectLanguage: Detects the language of text within a request.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format:
-// `projects/{project-number-or-id}/locations/{location-id}` or
-// `projects/{project-number-or-id}`. For global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Only models within the same
-// region (has same location-id) can be used. Otherwise an
-// INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format:
+// `projects/{project-number-or-id}/locations/{location-id}` or
+// `projects/{project-number-or-id}`. For global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Only models within the same
+// region (has same location-id) can be used. Otherwise an
+// INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) DetectLanguage(parent string, detectlanguagerequest *DetectLanguageRequest) *ProjectsLocationsDetectLanguageCall {
c := &ProjectsLocationsDetectLanguageCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2887,15 +2887,15 @@ type ProjectsLocationsGetSupportedLanguagesCall struct {
// GetSupportedLanguages: Returns a list of supported languages for
// translation.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for AutoML models. Only models within the same region (have same
-// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
-// is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for AutoML models. Only models within the same region (have same
+// location-id) can be used, otherwise an INVALID_ARGUMENT (400) error
+// is returned.
func (r *ProjectsLocationsService) GetSupportedLanguages(parent string) *ProjectsLocationsGetSupportedLanguagesCall {
c := &ProjectsLocationsGetSupportedLanguagesCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3075,8 +3075,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3284,14 +3284,14 @@ type ProjectsLocationsTranslateDocumentCall struct {
// TranslateDocument: Translates documents in synchronous mode.
//
-// - parent: Location to make a regional call. Format:
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global`. Non-global
-// location is required for requests using AutoML models or custom
-// glossaries. Models and glossaries must be within the same region
-// (have the same location-id), otherwise an INVALID_ARGUMENT (400)
-// error is returned.
+// - parent: Location to make a regional call. Format:
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global`. Non-global
+// location is required for requests using AutoML models or custom
+// glossaries. Models and glossaries must be within the same region
+// (have the same location-id), otherwise an INVALID_ARGUMENT (400)
+// error is returned.
func (r *ProjectsLocationsService) TranslateDocument(parent string, translatedocumentrequest *TranslateDocumentRequest) *ProjectsLocationsTranslateDocumentCall {
c := &ProjectsLocationsTranslateDocumentCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3434,15 +3434,15 @@ type ProjectsLocationsTranslateTextCall struct {
// TranslateText: Translates input text and returns translated text.
//
-// - parent: Project or location to make a call. Must refer to a
-// caller's project. Format: `projects/{project-number-or-id}` or
-// `projects/{project-number-or-id}/locations/{location-id}`. For
-// global calls, use
-// `projects/{project-number-or-id}/locations/global` or
-// `projects/{project-number-or-id}`. Non-global location is required
-// for requests using AutoML models or custom glossaries. Models and
-// glossaries must be within the same region (have same location-id),
-// otherwise an INVALID_ARGUMENT (400) error is returned.
+// - parent: Project or location to make a call. Must refer to a
+// caller's project. Format: `projects/{project-number-or-id}` or
+// `projects/{project-number-or-id}/locations/{location-id}`. For
+// global calls, use
+// `projects/{project-number-or-id}/locations/global` or
+// `projects/{project-number-or-id}`. Non-global location is required
+// for requests using AutoML models or custom glossaries. Models and
+// glossaries must be within the same region (have same location-id),
+// otherwise an INVALID_ARGUMENT (400) error is returned.
func (r *ProjectsLocationsService) TranslateText(parent string, translatetextrequest *TranslateTextRequest) *ProjectsLocationsTranslateTextCall {
c := &ProjectsLocationsTranslateTextCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -4012,8 +4012,8 @@ type ProjectsLocationsGlossariesListCall struct {
// List: Lists glossaries in a project. Returns NOT_FOUND, if the
// project doesn't exist.
//
-// - parent: The name of the project from which to list all of the
-// glossaries.
+// - parent: The name of the project from which to list all of the
+// glossaries.
func (r *ProjectsLocationsGlossariesService) List(parent string) *ProjectsLocationsGlossariesListCall {
c := &ProjectsLocationsGlossariesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/transport/internal/dca/dca.go b/transport/internal/dca/dca.go
index 071586e9446..78004f0475f 100644
--- a/transport/internal/dca/dca.go
+++ b/transport/internal/dca/dca.go
@@ -6,17 +6,17 @@
// Authentication according to https://google.aip.dev/auth/4114
//
// The overall logic for DCA is as follows:
-// 1. If both endpoint override and client certificate are specified, use them as is.
-// 2. If user does not specify client certificate, we will attempt to use default
-// client certificate.
-// 3. If user does not specify endpoint override, we will use defaultMtlsEndpoint if
-// client certificate is available and defaultEndpoint otherwise.
+// 1. If both endpoint override and client certificate are specified, use them as is.
+// 2. If user does not specify client certificate, we will attempt to use default
+// client certificate.
+// 3. If user does not specify endpoint override, we will use defaultMtlsEndpoint if
+// client certificate is available and defaultEndpoint otherwise.
//
// Implications of the above logic:
-// 1. If the user specifies a non-mTLS endpoint override but client certificate is
-// available, we will pass along the cert anyway and let the server decide what to do.
-// 2. If the user specifies an mTLS endpoint override but client certificate is not
-// available, we will not fail-fast, but let backend throw error when connecting.
+// 1. If the user specifies a non-mTLS endpoint override but client certificate is
+// available, we will pass along the cert anyway and let the server decide what to do.
+// 2. If the user specifies an mTLS endpoint override but client certificate is not
+// available, we will not fail-fast, but let backend throw error when connecting.
//
// We would like to avoid introducing client-side logic that parses whether the
// endpoint override is an mTLS url, since the url pattern may change at anytime.
diff --git a/urlshortener/v1/urlshortener-gen.go b/urlshortener/v1/urlshortener-gen.go
index c615fea3b56..92d7cbac1b9 100644
--- a/urlshortener/v1/urlshortener-gen.go
+++ b/urlshortener/v1/urlshortener-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/url-shortener/v1/getting_started
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/urlshortener/v1"
-// ...
-// ctx := context.Background()
-// urlshortenerService, err := urlshortener.NewService(ctx)
+// import "google.golang.org/api/urlshortener/v1"
+// ...
+// ctx := context.Background()
+// urlshortenerService, err := urlshortener.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// urlshortenerService, err := urlshortener.NewService(ctx, option.WithAPIKey("AIza..."))
+// urlshortenerService, err := urlshortener.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// urlshortenerService, err := urlshortener.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// urlshortenerService, err := urlshortener.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package urlshortener // import "google.golang.org/api/urlshortener/v1"
@@ -376,9 +376,11 @@ func (r *UrlService) Get(shortUrl string) *UrlGetCall {
// information to return.
//
// Possible values:
-// "ANALYTICS_CLICKS" - Returns only click counts.
-// "ANALYTICS_TOP_STRINGS" - Returns only top string counts.
-// "FULL" - Returns the creation timestamp and all available
+//
+// "ANALYTICS_CLICKS" - Returns only click counts.
+// "ANALYTICS_TOP_STRINGS" - Returns only top string counts.
+// "FULL" - Returns the creation timestamp and all available
+//
// analytics.
func (c *UrlGetCall) Projection(projection string) *UrlGetCall {
c.urlParams_.Set("projection", projection)
@@ -663,8 +665,9 @@ func (r *UrlService) List() *UrlListCall {
// information to return.
//
// Possible values:
-// "ANALYTICS_CLICKS" - Returns short URL click counts.
-// "FULL" - Returns short URL click counts.
+//
+// "ANALYTICS_CLICKS" - Returns short URL click counts.
+// "FULL" - Returns short URL click counts.
func (c *UrlListCall) Projection(projection string) *UrlListCall {
c.urlParams_.Set("projection", projection)
return c
diff --git a/vault/v1/vault-gen.go b/vault/v1/vault-gen.go
index ddeeb36acee..9e7713b7df2 100644
--- a/vault/v1/vault-gen.go
+++ b/vault/v1/vault-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/vault
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vault/v1"
-// ...
-// ctx := context.Background()
-// vaultService, err := vault.NewService(ctx)
+// import "google.golang.org/api/vault/v1"
+// ...
+// ctx := context.Background()
+// vaultService, err := vault.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// vaultService, err := vault.NewService(ctx, option.WithScopes(vault.EdiscoveryReadonlyScope))
+// vaultService, err := vault.NewService(ctx, option.WithScopes(vault.EdiscoveryReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// vaultService, err := vault.NewService(ctx, option.WithAPIKey("AIza..."))
+// vaultService, err := vault.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// vaultService, err := vault.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// vaultService, err := vault.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vault // import "google.golang.org/api/vault/v1"
@@ -3298,11 +3298,17 @@ func (r *MattersService) Get(matterId string) *MattersGetCall {
// information about the matter to return in the response.
//
// Possible values:
-// "VIEW_UNSPECIFIED" - The amount of detail is unspecified. Same as
+//
+// "VIEW_UNSPECIFIED" - The amount of detail is unspecified. Same as
+//
// **BASIC**.
-// "BASIC" - Returns the matter ID, name, description, and state.
+//
+// "BASIC" - Returns the matter ID, name, description, and state.
+//
// Default choice.
-// "FULL" - Returns the basic details and a list of matter owners and
+//
+// "FULL" - Returns the basic details and a list of matter owners and
+//
// collaborators (see
// [MatterPermissions](https://developers.google.com/vault/reference/rest
// /v1/matters#matterpermission)).
@@ -3486,10 +3492,11 @@ func (c *MattersListCall) PageToken(pageToken string) *MattersListCall {
// with the specified state. The default lists matters of all states.
//
// Possible values:
-// "STATE_UNSPECIFIED" - The matter has no specified state.
-// "OPEN" - The matter is open.
-// "CLOSED" - The matter is closed.
-// "DELETED" - The matter is deleted.
+//
+// "STATE_UNSPECIFIED" - The matter has no specified state.
+// "OPEN" - The matter is open.
+// "CLOSED" - The matter is closed.
+// "DELETED" - The matter is deleted.
func (c *MattersListCall) State(state string) *MattersListCall {
c.urlParams_.Set("state", state)
return c
@@ -3499,11 +3506,17 @@ func (c *MattersListCall) State(state string) *MattersListCall {
// information about the matter to return in response.
//
// Possible values:
-// "VIEW_UNSPECIFIED" - The amount of detail is unspecified. Same as
+//
+// "VIEW_UNSPECIFIED" - The amount of detail is unspecified. Same as
+//
// **BASIC**.
-// "BASIC" - Returns the matter ID, name, description, and state.
+//
+// "BASIC" - Returns the matter ID, name, description, and state.
+//
// Default choice.
-// "FULL" - Returns the basic details and a list of matter owners and
+//
+// "FULL" - Returns the basic details and a list of matter owners and
+//
// collaborators (see
// [MatterPermissions](https://developers.google.com/vault/reference/rest
// /v1/matters#matterpermission)).
@@ -5357,10 +5370,14 @@ func (r *MattersHoldsService) Get(matterId string, holdId string) *MattersHoldsG
// return for a hold.
//
// Possible values:
-// "HOLD_VIEW_UNSPECIFIED" - Not specified. Defaults to **FULL_HOLD**.
-// "BASIC_HOLD" - Returns the hold ID, name, update time, service, and
+//
+// "HOLD_VIEW_UNSPECIFIED" - Not specified. Defaults to **FULL_HOLD**.
+// "BASIC_HOLD" - Returns the hold ID, name, update time, service, and
+//
// query.
-// "FULL_HOLD" - Returns all details of **BASIC_HOLD** and the
+//
+// "FULL_HOLD" - Returns all details of **BASIC_HOLD** and the
+//
// entities the hold applies to, such as accounts or organizational
// unit.
func (c *MattersHoldsGetCall) View(view string) *MattersHoldsGetCall {
@@ -5557,10 +5574,14 @@ func (c *MattersHoldsListCall) PageToken(pageToken string) *MattersHoldsListCall
// return for a hold.
//
// Possible values:
-// "HOLD_VIEW_UNSPECIFIED" - Not specified. Defaults to **FULL_HOLD**.
-// "BASIC_HOLD" - Returns the hold ID, name, update time, service, and
+//
+// "HOLD_VIEW_UNSPECIFIED" - Not specified. Defaults to **FULL_HOLD**.
+// "BASIC_HOLD" - Returns the hold ID, name, update time, service, and
+//
// query.
-// "FULL_HOLD" - Returns all details of **BASIC_HOLD** and the
+//
+// "FULL_HOLD" - Returns all details of **BASIC_HOLD** and the
+//
// entities the hold applies to, such as accounts or organizational
// unit.
func (c *MattersHoldsListCall) View(view string) *MattersHoldsListCall {
diff --git a/vectortile/v1/vectortile-gen.go b/vectortile/v1/vectortile-gen.go
index 0df732cbac2..cc33501ec33 100644
--- a/vectortile/v1/vectortile-gen.go
+++ b/vectortile/v1/vectortile-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/maps/contact-sales/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vectortile/v1"
-// ...
-// ctx := context.Background()
-// vectortileService, err := vectortile.NewService(ctx)
+// import "google.golang.org/api/vectortile/v1"
+// ...
+// ctx := context.Background()
+// vectortileService, err := vectortile.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// vectortileService, err := vectortile.NewService(ctx, option.WithAPIKey("AIza..."))
+// vectortileService, err := vectortile.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// vectortileService, err := vectortile.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// vectortileService, err := vectortile.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vectortile // import "google.golang.org/api/vectortile/v1"
@@ -1173,10 +1173,10 @@ type FeaturetilesGetCall struct {
// Get: Gets a feature tile by its tile resource name.
//
-// - name: Resource name of the tile. The tile resource name is prefixed
-// by its collection ID `tiles/` followed by the resource ID, which
-// encodes the tile's global x and y coordinates and zoom level as
-// `@,,z`. For example, `tiles/@1,2,3z`.
+// - name: Resource name of the tile. The tile resource name is prefixed
+// by its collection ID `tiles/` followed by the resource ID, which
+// encodes the tile's global x and y coordinates and zoom level as
+// `@,,z`. For example, `tiles/@1,2,3z`.
func (r *FeaturetilesService) Get(name string) *FeaturetilesGetCall {
c := &FeaturetilesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1238,14 +1238,15 @@ func (c *FeaturetilesGetCall) ClientInfoOperatingSystem(clientInfoOperatingSyste
// Platform where the application is running.
//
// Possible values:
-// "PLATFORM_UNSPECIFIED" - Unspecified or unknown OS.
-// "EDITOR" - Development environment.
-// "MAC_OS" - macOS.
-// "WINDOWS" - Windows.
-// "LINUX" - Linux
-// "ANDROID" - Android
-// "IOS" - iOS
-// "WEB_GL" - WebGL.
+//
+// "PLATFORM_UNSPECIFIED" - Unspecified or unknown OS.
+// "EDITOR" - Development environment.
+// "MAC_OS" - macOS.
+// "WINDOWS" - Windows.
+// "LINUX" - Linux
+// "ANDROID" - Android
+// "IOS" - iOS
+// "WEB_GL" - WebGL.
func (c *FeaturetilesGetCall) ClientInfoPlatform(clientInfoPlatform string) *FeaturetilesGetCall {
c.urlParams_.Set("clientInfo.platform", clientInfoPlatform)
return c
@@ -1592,10 +1593,10 @@ type TerraintilesGetCall struct {
// Get: Gets a terrain tile by its tile resource name.
//
-// - name: Resource name of the tile. The tile resource name is prefixed
-// by its collection ID `terraintiles/` followed by the resource ID,
-// which encodes the tile's global x and y coordinates and zoom level
-// as `@,,z`. For example, `terraintiles/@1,2,3z`.
+// - name: Resource name of the tile. The tile resource name is prefixed
+// by its collection ID `terraintiles/` followed by the resource ID,
+// which encodes the tile's global x and y coordinates and zoom level
+// as `@,,z`. For example, `terraintiles/@1,2,3z`.
func (r *TerraintilesService) Get(name string) *TerraintilesGetCall {
c := &TerraintilesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1656,14 +1657,15 @@ func (c *TerraintilesGetCall) ClientInfoOperatingSystem(clientInfoOperatingSyste
// Platform where the application is running.
//
// Possible values:
-// "PLATFORM_UNSPECIFIED" - Unspecified or unknown OS.
-// "EDITOR" - Development environment.
-// "MAC_OS" - macOS.
-// "WINDOWS" - Windows.
-// "LINUX" - Linux
-// "ANDROID" - Android
-// "IOS" - iOS
-// "WEB_GL" - WebGL.
+//
+// "PLATFORM_UNSPECIFIED" - Unspecified or unknown OS.
+// "EDITOR" - Development environment.
+// "MAC_OS" - macOS.
+// "WINDOWS" - Windows.
+// "LINUX" - Linux
+// "ANDROID" - Android
+// "IOS" - iOS
+// "WEB_GL" - WebGL.
func (c *TerraintilesGetCall) ClientInfoPlatform(clientInfoPlatform string) *TerraintilesGetCall {
c.urlParams_.Set("clientInfo.platform", clientInfoPlatform)
return c
@@ -1716,11 +1718,17 @@ func (c *TerraintilesGetCall) MinElevationResolutionCells(minElevationResolution
// formats that the client understands.
//
// Possible values:
-// "TERRAIN_FORMAT_UNKNOWN" - An unknown or unspecified terrain
+//
+// "TERRAIN_FORMAT_UNKNOWN" - An unknown or unspecified terrain
+//
// format.
-// "FIRST_DERIVATIVE" - Terrain elevation data encoded as a
+//
+// "FIRST_DERIVATIVE" - Terrain elevation data encoded as a
+//
// FirstDerivativeElevationGrid. .
-// "SECOND_DERIVATIVE" - Terrain elevation data encoded as a
+//
+// "SECOND_DERIVATIVE" - Terrain elevation data encoded as a
+//
// SecondDerivativeElevationGrid.
func (c *TerraintilesGetCall) TerrainFormats(terrainFormats ...string) *TerraintilesGetCall {
c.urlParams_.SetMulti("terrainFormats", append([]string{}, terrainFormats...))
diff --git a/verifiedaccess/v1/verifiedaccess-gen.go b/verifiedaccess/v1/verifiedaccess-gen.go
index 5d4d3ee7633..2778c1fed92 100644
--- a/verifiedaccess/v1/verifiedaccess-gen.go
+++ b/verifiedaccess/v1/verifiedaccess-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/chrome/verified-access
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/verifiedaccess/v1"
-// ...
-// ctx := context.Background()
-// verifiedaccessService, err := verifiedaccess.NewService(ctx)
+// import "google.golang.org/api/verifiedaccess/v1"
+// ...
+// ctx := context.Background()
+// verifiedaccessService, err := verifiedaccess.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithAPIKey("AIza..."))
+// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package verifiedaccess // import "google.golang.org/api/verifiedaccess/v1"
diff --git a/verifiedaccess/v2/verifiedaccess-gen.go b/verifiedaccess/v2/verifiedaccess-gen.go
index 0ddda825aa5..da57c28b1fe 100644
--- a/verifiedaccess/v2/verifiedaccess-gen.go
+++ b/verifiedaccess/v2/verifiedaccess-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/chrome/verified-access
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/verifiedaccess/v2"
-// ...
-// ctx := context.Background()
-// verifiedaccessService, err := verifiedaccess.NewService(ctx)
+// import "google.golang.org/api/verifiedaccess/v2"
+// ...
+// ctx := context.Background()
+// verifiedaccessService, err := verifiedaccess.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithAPIKey("AIza..."))
+// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// verifiedaccessService, err := verifiedaccess.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package verifiedaccess // import "google.golang.org/api/verifiedaccess/v2"
diff --git a/versionhistory/v1/versionhistory-api.json b/versionhistory/v1/versionhistory-api.json
index f4801066141..472748126b1 100644
--- a/versionhistory/v1/versionhistory-api.json
+++ b/versionhistory/v1/versionhistory-api.json
@@ -271,7 +271,7 @@
}
}
},
- "revision": "20220314",
+ "revision": "20220814",
"rootUrl": "https://versionhistory.googleapis.com/",
"schemas": {
"Channel": {
@@ -421,7 +421,8 @@
"MAC_ARM64",
"LACROS",
"LACROS_ARM32",
- "CHROMEOS"
+ "CHROMEOS",
+ "LACROS_ARM64"
],
"enumDescriptions": [
"",
@@ -436,6 +437,7 @@
"",
"",
"",
+ "",
""
],
"type": "string"
diff --git a/versionhistory/v1/versionhistory-gen.go b/versionhistory/v1/versionhistory-gen.go
index fda969d5dc9..d7bad7585d1 100644
--- a/versionhistory/v1/versionhistory-gen.go
+++ b/versionhistory/v1/versionhistory-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.chrome.com/versionhistory
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/versionhistory/v1"
-// ...
-// ctx := context.Background()
-// versionhistoryService, err := versionhistory.NewService(ctx)
+// import "google.golang.org/api/versionhistory/v1"
+// ...
+// ctx := context.Background()
+// versionhistoryService, err := versionhistory.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// versionhistoryService, err := versionhistory.NewService(ctx, option.WithAPIKey("AIza..."))
+// versionhistoryService, err := versionhistory.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// versionhistoryService, err := versionhistory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// versionhistoryService, err := versionhistory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package versionhistory // import "google.golang.org/api/versionhistory/v1"
@@ -425,6 +425,7 @@ type Platform struct {
// "LACROS"
// "LACROS_ARM32"
// "CHROMEOS"
+ // "LACROS_ARM64"
PlatformType string `json:"platformType,omitempty"`
// ForceSendFields is a list of field names (e.g. "Name") to
@@ -567,8 +568,8 @@ type PlatformsListCall struct {
// List: Returns list of platforms that are available for a given
// product. The resource "product" has no resource name in its name.
//
-// - parent: The product, which owns this collection of platforms.
-// Format: {product}.
+// - parent: The product, which owns this collection of platforms.
+// Format: {product}.
func (r *PlatformsService) List(parent string) *PlatformsListCall {
c := &PlatformsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -760,8 +761,8 @@ type PlatformsChannelsListCall struct {
// List: Returns list of channels that are available for a given
// platform.
//
-// - parent: The platform, which owns this collection of channels.
-// Format: {product}/platforms/{platform}.
+// - parent: The platform, which owns this collection of channels.
+// Format: {product}/platforms/{platform}.
func (r *PlatformsChannelsService) List(parent string) *PlatformsChannelsListCall {
c := &PlatformsChannelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -952,8 +953,8 @@ type PlatformsChannelsVersionsListCall struct {
// List: Returns list of version for the given platform/channel.
//
-// - parent: The channel, which owns this collection of versions.
-// Format: {product}/platforms/{platform}/channels/{channel}.
+// - parent: The channel, which owns this collection of versions.
+// Format: {product}/platforms/{platform}/channels/{channel}.
func (r *PlatformsChannelsVersionsService) List(parent string) *PlatformsChannelsVersionsListCall {
c := &PlatformsChannelsVersionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1187,9 +1188,9 @@ type PlatformsChannelsVersionsReleasesListCall struct {
// List: Returns list of releases of the given version.
//
-// - parent: The version, which owns this collection of releases.
-// Format:
-// {product}/platforms/{platform}/channels/{channel}/versions/{version}.
+// - parent: The version, which owns this collection of releases.
+// Format:
+// {product}/platforms/{platform}/channels/{channel}/versions/{version}.
func (r *PlatformsChannelsVersionsReleasesService) List(parent string) *PlatformsChannelsVersionsReleasesListCall {
c := &PlatformsChannelsVersionsReleasesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/videointelligence/v1/videointelligence-gen.go b/videointelligence/v1/videointelligence-gen.go
index 1f13d0bb1d3..11ed6b65f10 100644
--- a/videointelligence/v1/videointelligence-gen.go
+++ b/videointelligence/v1/videointelligence-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/video-intelligence/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/videointelligence/v1"
-// ...
-// ctx := context.Background()
-// videointelligenceService, err := videointelligence.NewService(ctx)
+// import "google.golang.org/api/videointelligence/v1"
+// ...
+// ctx := context.Background()
+// videointelligenceService, err := videointelligence.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package videointelligence // import "google.golang.org/api/videointelligence/v1"
diff --git a/videointelligence/v1beta2/videointelligence-gen.go b/videointelligence/v1beta2/videointelligence-gen.go
index 2fc622614aa..d078fd96e34 100644
--- a/videointelligence/v1beta2/videointelligence-gen.go
+++ b/videointelligence/v1beta2/videointelligence-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/video-intelligence/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/videointelligence/v1beta2"
-// ...
-// ctx := context.Background()
-// videointelligenceService, err := videointelligence.NewService(ctx)
+// import "google.golang.org/api/videointelligence/v1beta2"
+// ...
+// ctx := context.Background()
+// videointelligenceService, err := videointelligence.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package videointelligence // import "google.golang.org/api/videointelligence/v1beta2"
diff --git a/videointelligence/v1p1beta1/videointelligence-gen.go b/videointelligence/v1p1beta1/videointelligence-gen.go
index 35f2f0f532d..eec7d1ef497 100644
--- a/videointelligence/v1p1beta1/videointelligence-gen.go
+++ b/videointelligence/v1p1beta1/videointelligence-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/video-intelligence/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/videointelligence/v1p1beta1"
-// ...
-// ctx := context.Background()
-// videointelligenceService, err := videointelligence.NewService(ctx)
+// import "google.golang.org/api/videointelligence/v1p1beta1"
+// ...
+// ctx := context.Background()
+// videointelligenceService, err := videointelligence.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package videointelligence // import "google.golang.org/api/videointelligence/v1p1beta1"
diff --git a/videointelligence/v1p2beta1/videointelligence-gen.go b/videointelligence/v1p2beta1/videointelligence-gen.go
index 1eba50f2b79..a44def5a53d 100644
--- a/videointelligence/v1p2beta1/videointelligence-gen.go
+++ b/videointelligence/v1p2beta1/videointelligence-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/video-intelligence/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/videointelligence/v1p2beta1"
-// ...
-// ctx := context.Background()
-// videointelligenceService, err := videointelligence.NewService(ctx)
+// import "google.golang.org/api/videointelligence/v1p2beta1"
+// ...
+// ctx := context.Background()
+// videointelligenceService, err := videointelligence.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package videointelligence // import "google.golang.org/api/videointelligence/v1p2beta1"
diff --git a/videointelligence/v1p3beta1/videointelligence-gen.go b/videointelligence/v1p3beta1/videointelligence-gen.go
index 80aa32e20da..a16f639fc7b 100644
--- a/videointelligence/v1p3beta1/videointelligence-gen.go
+++ b/videointelligence/v1p3beta1/videointelligence-gen.go
@@ -10,31 +10,31 @@
//
// For product documentation, see: https://cloud.google.com/video-intelligence/docs/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/videointelligence/v1p3beta1"
-// ...
-// ctx := context.Background()
-// videointelligenceService, err := videointelligence.NewService(ctx)
+// import "google.golang.org/api/videointelligence/v1p3beta1"
+// ...
+// ctx := context.Background()
+// videointelligenceService, err := videointelligence.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// videointelligenceService, err := videointelligence.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package videointelligence // import "google.golang.org/api/videointelligence/v1p3beta1"
diff --git a/vision/v1/vision-api.json b/vision/v1/vision-api.json
index 19cb1dc10e3..5e7dbb87015 100644
--- a/vision/v1/vision-api.json
+++ b/vision/v1/vision-api.json
@@ -1282,7 +1282,7 @@
}
}
},
- "revision": "20220319",
+ "revision": "20220805",
"rootUrl": "https://vision.googleapis.com/",
"schemas": {
"AddProductToProductSetRequest": {
@@ -9147,6 +9147,13 @@
"description": "Parameters for text detections. This is used to control TEXT_DETECTION and DOCUMENT_TEXT_DETECTION features.",
"id": "TextDetectionParams",
"properties": {
+ "advancedOcrOptions": {
+ "description": "A list of advanced OCR options to fine-tune OCR behavior.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
"enableTextDetectionConfidenceScore": {
"description": "By default, Cloud Vision API only includes confidence score for DOCUMENT_TEXT_DETECTION result. Set the flag to true to include confidence score for TEXT_DETECTION as well.",
"type": "boolean"
diff --git a/vision/v1/vision-gen.go b/vision/v1/vision-gen.go
index 17a85685c35..554a86e5571 100644
--- a/vision/v1/vision-gen.go
+++ b/vision/v1/vision-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/vision/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vision/v1"
-// ...
-// ctx := context.Background()
-// visionService, err := vision.NewService(ctx)
+// import "google.golang.org/api/vision/v1"
+// ...
+// ctx := context.Background()
+// visionService, err := vision.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// visionService, err := vision.NewService(ctx, option.WithScopes(vision.CloudVisionScope))
+// visionService, err := vision.NewService(ctx, option.WithScopes(vision.CloudVisionScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// visionService, err := vision.NewService(ctx, option.WithAPIKey("AIza..."))
+// visionService, err := vision.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// visionService, err := vision.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// visionService, err := vision.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vision // import "google.golang.org/api/vision/v1"
@@ -1143,12 +1143,12 @@ type CancelOperationRequest struct {
// if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green,
// blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams
// = [red, green, blue].join(','); return ['rgba(', rgbParams, ',',
-// alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green,
+// alphaFrac, ')'].join(”); }; var rgbToCssColor = function(red, green,
// blue) { var rgbNumber = new Number((red << 16) | (green << 8) |
// blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 -
// hexString.length; var resultBuilder = ['#']; for (var i = 0; i <
// missingZeros; i++) { resultBuilder.push('0'); }
-// resultBuilder.push(hexString); return resultBuilder.join(''); }; //
+// resultBuilder.push(hexString); return resultBuilder.join(”); }; //
// ...
type Color struct {
// Alpha: The fraction of this color that should be applied to the
@@ -13513,27 +13513,30 @@ func (s *TextAnnotation) MarshalJSON() ([]byte, error) {
// TextDetectionParams: Parameters for text detections. This is used to
// control TEXT_DETECTION and DOCUMENT_TEXT_DETECTION features.
type TextDetectionParams struct {
+ // AdvancedOcrOptions: A list of advanced OCR options to fine-tune OCR
+ // behavior.
+ AdvancedOcrOptions []string `json:"advancedOcrOptions,omitempty"`
+
// EnableTextDetectionConfidenceScore: By default, Cloud Vision API only
// includes confidence score for DOCUMENT_TEXT_DETECTION result. Set the
// flag to true to include confidence score for TEXT_DETECTION as well.
EnableTextDetectionConfidenceScore bool `json:"enableTextDetectionConfidenceScore,omitempty"`
- // ForceSendFields is a list of field names (e.g.
- // "EnableTextDetectionConfidenceScore") to unconditionally include in
- // API requests. By default, fields with empty or default values are
- // omitted from API requests. However, any non-pointer, non-interface
- // field appearing in ForceSendFields will be sent to the server
- // regardless of whether the field is empty or not. This may be used to
- // include empty fields in Patch requests.
+ // ForceSendFields is a list of field names (e.g. "AdvancedOcrOptions")
+ // to unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g.
- // "EnableTextDetectionConfidenceScore") to include in API requests with
- // the JSON null value. By default, fields with empty values are omitted
- // from API requests. However, any field with an empty value appearing
- // in NullFields will be sent to the server as null. It is an 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. "AdvancedOcrOptions") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
NullFields []string `json:"-"`
}
@@ -15272,12 +15275,12 @@ type ProjectsFilesAnnotateCall struct {
// (gif) or pages (pdf or tiff) from each file provided and perform
// detection and annotation for each image extracted.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsFilesService) Annotate(parent string, batchannotatefilesrequest *BatchAnnotateFilesRequest) *ProjectsFilesAnnotateCall {
c := &ProjectsFilesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15426,12 +15429,12 @@ type ProjectsFilesAsyncBatchAnnotateCall struct {
// `Operation.response` contains `AsyncBatchAnnotateFilesResponse`
// (results).
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsFilesService) AsyncBatchAnnotate(parent string, asyncbatchannotatefilesrequest *AsyncBatchAnnotateFilesRequest) *ProjectsFilesAsyncBatchAnnotateCall {
c := &ProjectsFilesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15574,12 +15577,12 @@ type ProjectsImagesAnnotateCall struct {
// Annotate: Run image detection and annotation for a batch of images.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsImagesService) Annotate(parent string, batchannotateimagesrequest *BatchAnnotateImagesRequest) *ProjectsImagesAnnotateCall {
c := &ProjectsImagesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15728,12 +15731,12 @@ type ProjectsImagesAsyncBatchAnnotateCall struct {
// will write image annotation outputs to json files in customer GCS
// bucket, each json file containing BatchAnnotateImagesResponse proto.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsImagesService) AsyncBatchAnnotate(parent string, asyncbatchannotateimagesrequest *AsyncBatchAnnotateImagesRequest) *ProjectsImagesAsyncBatchAnnotateCall {
c := &ProjectsImagesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -15881,12 +15884,12 @@ type ProjectsLocationsFilesAnnotateCall struct {
// (gif) or pages (pdf or tiff) from each file provided and perform
// detection and annotation for each image extracted.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsFilesService) Annotate(parent string, batchannotatefilesrequest *BatchAnnotateFilesRequest) *ProjectsLocationsFilesAnnotateCall {
c := &ProjectsLocationsFilesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16035,12 +16038,12 @@ type ProjectsLocationsFilesAsyncBatchAnnotateCall struct {
// `Operation.response` contains `AsyncBatchAnnotateFilesResponse`
// (results).
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsFilesService) AsyncBatchAnnotate(parent string, asyncbatchannotatefilesrequest *AsyncBatchAnnotateFilesRequest) *ProjectsLocationsFilesAsyncBatchAnnotateCall {
c := &ProjectsLocationsFilesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16183,12 +16186,12 @@ type ProjectsLocationsImagesAnnotateCall struct {
// Annotate: Run image detection and annotation for a batch of images.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsImagesService) Annotate(parent string, batchannotateimagesrequest *BatchAnnotateImagesRequest) *ProjectsLocationsImagesAnnotateCall {
c := &ProjectsLocationsImagesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16337,12 +16340,12 @@ type ProjectsLocationsImagesAsyncBatchAnnotateCall struct {
// will write image annotation outputs to json files in customer GCS
// bucket, each json file containing BatchAnnotateImagesResponse proto.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsImagesService) AsyncBatchAnnotate(parent string, asyncbatchannotateimagesrequest *AsyncBatchAnnotateImagesRequest) *ProjectsLocationsImagesAsyncBatchAnnotateCall {
c := &ProjectsLocationsImagesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16637,8 +16640,8 @@ type ProjectsLocationsProductSetsAddProductCall struct {
// added to at most 100 ProductSets. Possible errors: * Returns
// NOT_FOUND if the Product or the ProductSet doesn't exist.
//
-// - name: The resource name for the ProductSet to modify. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+// - name: The resource name for the ProductSet to modify. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
func (r *ProjectsLocationsProductSetsService) AddProduct(name string, addproducttoproductsetrequest *AddProductToProductSetRequest) *ProjectsLocationsProductSetsAddProductCall {
c := &ProjectsLocationsProductSetsAddProductCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -16783,8 +16786,8 @@ type ProjectsLocationsProductSetsCreateCall struct {
// errors: * Returns INVALID_ARGUMENT if display_name is missing, or is
// longer than 4096 characters.
//
-// - parent: The project in which the ProductSet should be created.
-// Format is `projects/PROJECT_ID/locations/LOC_ID`.
+// - parent: The project in which the ProductSet should be created.
+// Format is `projects/PROJECT_ID/locations/LOC_ID`.
func (r *ProjectsLocationsProductSetsService) Create(parent string, productset *ProductSet) *ProjectsLocationsProductSetsCreateCall {
c := &ProjectsLocationsProductSetsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -16943,8 +16946,8 @@ type ProjectsLocationsProductSetsDeleteCall struct {
// ReferenceImages in the ProductSet are not deleted. The actual image
// files are not deleted from Google Cloud Storage.
//
-// - name: Resource name of the ProductSet to delete. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+// - name: Resource name of the ProductSet to delete. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
func (r *ProjectsLocationsProductSetsService) Delete(name string) *ProjectsLocationsProductSetsDeleteCall {
c := &ProjectsLocationsProductSetsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17079,8 +17082,8 @@ type ProjectsLocationsProductSetsGetCall struct {
// Get: Gets information associated with a ProductSet. Possible errors:
// * Returns NOT_FOUND if the ProductSet does not exist.
//
-// - name: Resource name of the ProductSet to get. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+// - name: Resource name of the ProductSet to get. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
func (r *ProjectsLocationsProductSetsService) Get(name string) *ProjectsLocationsProductSetsGetCall {
c := &ProjectsLocationsProductSetsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17234,8 +17237,8 @@ type ProjectsLocationsProductSetsImportCall struct {
// method is a csv file on Google Cloud Storage. For the format of the
// csv file please see ImportProductSetsGcsSource.csv_file_uri.
//
-// - parent: The project in which the ProductSets should be imported.
-// Format is `projects/PROJECT_ID/locations/LOC_ID`.
+// - parent: The project in which the ProductSets should be imported.
+// Format is `projects/PROJECT_ID/locations/LOC_ID`.
func (r *ProjectsLocationsProductSetsService) Import(parent string, importproductsetsrequest *ImportProductSetsRequest) *ProjectsLocationsProductSetsImportCall {
c := &ProjectsLocationsProductSetsImportCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17380,8 +17383,8 @@ type ProjectsLocationsProductSetsListCall struct {
// Returns INVALID_ARGUMENT if page_size is greater than 100, or less
// than 1.
//
-// - parent: The project from which ProductSets should be listed. Format
-// is `projects/PROJECT_ID/locations/LOC_ID`.
+// - parent: The project from which ProductSets should be listed. Format
+// is `projects/PROJECT_ID/locations/LOC_ID`.
func (r *ProjectsLocationsProductSetsService) List(parent string) *ProjectsLocationsProductSetsListCall {
c := &ProjectsLocationsProductSetsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -17578,9 +17581,9 @@ type ProjectsLocationsProductSetsPatchCall struct {
// is present in update_mask but missing from the request or longer than
// 4096 characters.
//
-// - name: The resource name of the ProductSet. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
-// This field is ignored when creating a ProductSet.
+// - name: The resource name of the ProductSet. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+// This field is ignored when creating a ProductSet.
func (r *ProjectsLocationsProductSetsService) Patch(name string, productset *ProductSet) *ProjectsLocationsProductSetsPatchCall {
c := &ProjectsLocationsProductSetsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17738,8 +17741,8 @@ type ProjectsLocationsProductSetsRemoveProductCall struct {
// RemoveProduct: Removes a Product from the specified ProductSet.
//
-// - name: The resource name for the ProductSet to modify. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+// - name: The resource name for the ProductSet to modify. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
func (r *ProjectsLocationsProductSetsService) RemoveProduct(name string, removeproductfromproductsetrequest *RemoveProductFromProductSetRequest) *ProjectsLocationsProductSetsRemoveProductCall {
c := &ProjectsLocationsProductSetsRemoveProductCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -17885,9 +17888,9 @@ type ProjectsLocationsProductSetsProductsListCall struct {
// will be empty. Possible errors: * Returns INVALID_ARGUMENT if
// page_size is greater than 100 or less than 1.
//
-// - name: The ProductSet resource for which to retrieve Products.
-// Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+// - name: The ProductSet resource for which to retrieve Products.
+// Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
func (r *ProjectsLocationsProductSetsProductsService) List(name string) *ProjectsLocationsProductSetsProductsListCall {
c := &ProjectsLocationsProductSetsProductsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -18084,8 +18087,8 @@ type ProjectsLocationsProductsCreateCall struct {
// than 4096 characters. * Returns INVALID_ARGUMENT if product_category
// is missing or invalid.
//
-// - parent: The project in which the Product should be created. Format
-// is `projects/PROJECT_ID/locations/LOC_ID`.
+// - parent: The project in which the Product should be created. Format
+// is `projects/PROJECT_ID/locations/LOC_ID`.
func (r *ProjectsLocationsProductsService) Create(parent string, product *Product) *ProjectsLocationsProductsCreateCall {
c := &ProjectsLocationsProductsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -18245,8 +18248,8 @@ type ProjectsLocationsProductsDeleteCall struct {
// away, but search queries against ProductSets containing the product
// may still work until all related caches are refreshed.
//
-// - name: Resource name of product to delete. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+// - name: Resource name of product to delete. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
func (r *ProjectsLocationsProductsService) Delete(name string) *ProjectsLocationsProductsDeleteCall {
c := &ProjectsLocationsProductsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -18381,8 +18384,8 @@ type ProjectsLocationsProductsGetCall struct {
// Get: Gets information associated with a Product. Possible errors: *
// Returns NOT_FOUND if the Product does not exist.
//
-// - name: Resource name of the Product to get. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+// - name: Resource name of the Product to get. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
func (r *ProjectsLocationsProductsService) Get(name string) *ProjectsLocationsProductsGetCall {
c := &ProjectsLocationsProductsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -18531,8 +18534,8 @@ type ProjectsLocationsProductsListCall struct {
// Returns INVALID_ARGUMENT if page_size is greater than 100 or less
// than 1.
//
-// - parent: The project OR ProductSet from which Products should be
-// listed. Format: `projects/PROJECT_ID/locations/LOC_ID`.
+// - parent: The project OR ProductSet from which Products should be
+// listed. Format: `projects/PROJECT_ID/locations/LOC_ID`.
func (r *ProjectsLocationsProductsService) List(parent string) *ProjectsLocationsProductsListCall {
c := &ProjectsLocationsProductsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -18733,9 +18736,9 @@ type ProjectsLocationsProductsPatchCall struct {
// in update_mask but is longer than 4096 characters. * Returns
// INVALID_ARGUMENT if product_category is present in update_mask.
//
-// - name: The resource name of the product. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`. This
-// field is ignored when creating a product.
+// - name: The resource name of the product. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`. This
+// field is ignored when creating a product.
func (r *ProjectsLocationsProductsService) Patch(name string, product *Product) *ProjectsLocationsProductsPatchCall {
c := &ProjectsLocationsProductsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -18910,8 +18913,8 @@ type ProjectsLocationsProductsPurgeCall struct {
// track of the progress and results of the request.
// `Operation.metadata` contains `BatchOperationMetadata`. (progress)
//
-// - parent: The project and location in which the Products should be
-// deleted. Format is `projects/PROJECT_ID/locations/LOC_ID`.
+// - parent: The project and location in which the Products should be
+// deleted. Format is `projects/PROJECT_ID/locations/LOC_ID`.
func (r *ProjectsLocationsProductsService) Purge(parent string, purgeproductsrequest *PurgeProductsRequest) *ProjectsLocationsProductsPurgeCall {
c := &ProjectsLocationsProductsPurgeCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -19067,9 +19070,9 @@ type ProjectsLocationsProductsReferenceImagesCreateCall struct {
// Returns INVALID_ARGUMENT if bounding_poly contains more than 10
// polygons.
//
-// - parent: Resource name of the product in which to create the
-// reference image. Format is
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+// - parent: Resource name of the product in which to create the
+// reference image. Format is
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
func (r *ProjectsLocationsProductsReferenceImagesService) Create(parent string, referenceimage *ReferenceImage) *ProjectsLocationsProductsReferenceImagesCreateCall {
c := &ProjectsLocationsProductsReferenceImagesCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -19231,10 +19234,10 @@ type ProjectsLocationsProductsReferenceImagesDeleteCall struct {
// refreshed. The actual image files are not deleted from Google Cloud
// Storage.
//
-// - name: The resource name of the reference image to delete. Format
-// is:
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
-// mages/IMAGE_ID`.
+// - name: The resource name of the reference image to delete. Format
+// is:
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
+// mages/IMAGE_ID`.
func (r *ProjectsLocationsProductsReferenceImagesService) Delete(name string) *ProjectsLocationsProductsReferenceImagesDeleteCall {
c := &ProjectsLocationsProductsReferenceImagesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -19369,9 +19372,9 @@ type ProjectsLocationsProductsReferenceImagesGetCall struct {
// Get: Gets information associated with a ReferenceImage. Possible
// errors: * Returns NOT_FOUND if the specified image does not exist.
//
-// - name: The resource name of the ReferenceImage to get. Format is:
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
-// mages/IMAGE_ID`.
+// - name: The resource name of the ReferenceImage to get. Format is:
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
+// mages/IMAGE_ID`.
func (r *ProjectsLocationsProductsReferenceImagesService) Get(name string) *ProjectsLocationsProductsReferenceImagesGetCall {
c := &ProjectsLocationsProductsReferenceImagesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -19520,9 +19523,9 @@ type ProjectsLocationsProductsReferenceImagesListCall struct {
// the parent product does not exist. * Returns INVALID_ARGUMENT if the
// page_size is greater than 100, or less than 1.
//
-// - parent: Resource name of the product containing the reference
-// images. Format is
-// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+// - parent: Resource name of the product containing the reference
+// images. Format is
+// `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
func (r *ProjectsLocationsProductsReferenceImagesService) List(parent string) *ProjectsLocationsProductsReferenceImagesListCall {
c := &ProjectsLocationsProductsReferenceImagesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/vision/v1p1beta1/vision-api.json b/vision/v1p1beta1/vision-api.json
index 7c6842a1a5d..0b1bca8c352 100644
--- a/vision/v1p1beta1/vision-api.json
+++ b/vision/v1p1beta1/vision-api.json
@@ -449,7 +449,7 @@
}
}
},
- "revision": "20210809",
+ "revision": "20220805",
"rootUrl": "https://vision.googleapis.com/",
"schemas": {
"AnnotateFileResponse": {
@@ -2710,6 +2710,13 @@
"description": "Parameters for text detections. This is used to control TEXT_DETECTION and DOCUMENT_TEXT_DETECTION features.",
"id": "GoogleCloudVisionV1p1beta1TextDetectionParams",
"properties": {
+ "advancedOcrOptions": {
+ "description": "A list of advanced OCR options to fine-tune OCR behavior.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
"enableTextDetectionConfidenceScore": {
"description": "By default, Cloud Vision API only includes confidence score for DOCUMENT_TEXT_DETECTION result. Set the flag to true to include confidence score for TEXT_DETECTION as well.",
"type": "boolean"
diff --git a/vision/v1p1beta1/vision-gen.go b/vision/v1p1beta1/vision-gen.go
index cedf10d8998..d6b93f0c094 100644
--- a/vision/v1p1beta1/vision-gen.go
+++ b/vision/v1p1beta1/vision-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/vision/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vision/v1p1beta1"
-// ...
-// ctx := context.Background()
-// visionService, err := vision.NewService(ctx)
+// import "google.golang.org/api/vision/v1p1beta1"
+// ...
+// ctx := context.Background()
+// visionService, err := vision.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// visionService, err := vision.NewService(ctx, option.WithScopes(vision.CloudVisionScope))
+// visionService, err := vision.NewService(ctx, option.WithScopes(vision.CloudVisionScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// visionService, err := vision.NewService(ctx, option.WithAPIKey("AIza..."))
+// visionService, err := vision.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// visionService, err := vision.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// visionService, err := vision.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vision // import "google.golang.org/api/vision/v1p1beta1"
@@ -684,12 +684,12 @@ func (s *BoundingPoly) MarshalJSON() ([]byte, error) {
// if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green,
// blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams
// = [red, green, blue].join(','); return ['rgba(', rgbParams, ',',
-// alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green,
+// alphaFrac, ')'].join(”); }; var rgbToCssColor = function(red, green,
// blue) { var rgbNumber = new Number((red << 16) | (green << 8) |
// blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 -
// hexString.length; var resultBuilder = ['#']; for (var i = 0; i <
// missingZeros; i++) { resultBuilder.push('0'); }
-// resultBuilder.push(hexString); return resultBuilder.join(''); }; //
+// resultBuilder.push(hexString); return resultBuilder.join(”); }; //
// ...
type Color struct {
// Alpha: The fraction of this color that should be applied to the
@@ -3979,27 +3979,30 @@ func (s *GoogleCloudVisionV1p1beta1TextAnnotationTextProperty) MarshalJSON() ([]
// detections. This is used to control TEXT_DETECTION and
// DOCUMENT_TEXT_DETECTION features.
type GoogleCloudVisionV1p1beta1TextDetectionParams struct {
+ // AdvancedOcrOptions: A list of advanced OCR options to fine-tune OCR
+ // behavior.
+ AdvancedOcrOptions []string `json:"advancedOcrOptions,omitempty"`
+
// EnableTextDetectionConfidenceScore: By default, Cloud Vision API only
// includes confidence score for DOCUMENT_TEXT_DETECTION result. Set the
// flag to true to include confidence score for TEXT_DETECTION as well.
EnableTextDetectionConfidenceScore bool `json:"enableTextDetectionConfidenceScore,omitempty"`
- // ForceSendFields is a list of field names (e.g.
- // "EnableTextDetectionConfidenceScore") to unconditionally include in
- // API requests. By default, fields with empty or default values are
- // omitted from API requests. However, any non-pointer, non-interface
- // field appearing in ForceSendFields will be sent to the server
- // regardless of whether the field is empty or not. This may be used to
- // include empty fields in Patch requests.
+ // ForceSendFields is a list of field names (e.g. "AdvancedOcrOptions")
+ // to unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g.
- // "EnableTextDetectionConfidenceScore") to include in API requests with
- // the JSON null value. By default, fields with empty values are omitted
- // from API requests. However, any field with an empty value appearing
- // in NullFields will be sent to the server as null. It is an 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. "AdvancedOcrOptions") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
NullFields []string `json:"-"`
}
@@ -13889,12 +13892,12 @@ type ProjectsFilesAnnotateCall struct {
// (gif) or pages (pdf or tiff) from each file provided and perform
// detection and annotation for each image extracted.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsFilesService) Annotate(parent string, googlecloudvisionv1p1beta1batchannotatefilesrequest *GoogleCloudVisionV1p1beta1BatchAnnotateFilesRequest) *ProjectsFilesAnnotateCall {
c := &ProjectsFilesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14045,12 +14048,12 @@ type ProjectsFilesAsyncBatchAnnotateCall struct {
// `Operation.response` contains `AsyncBatchAnnotateFilesResponse`
// (results).
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsFilesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p1beta1asyncbatchannotatefilesrequest *GoogleCloudVisionV1p1beta1AsyncBatchAnnotateFilesRequest) *ProjectsFilesAsyncBatchAnnotateCall {
c := &ProjectsFilesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14193,12 +14196,12 @@ type ProjectsImagesAnnotateCall struct {
// Annotate: Run image detection and annotation for a batch of images.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsImagesService) Annotate(parent string, googlecloudvisionv1p1beta1batchannotateimagesrequest *GoogleCloudVisionV1p1beta1BatchAnnotateImagesRequest) *ProjectsImagesAnnotateCall {
c := &ProjectsImagesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14349,12 +14352,12 @@ type ProjectsImagesAsyncBatchAnnotateCall struct {
// will write image annotation outputs to json files in customer GCS
// bucket, each json file containing BatchAnnotateImagesResponse proto.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsImagesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p1beta1asyncbatchannotateimagesrequest *GoogleCloudVisionV1p1beta1AsyncBatchAnnotateImagesRequest) *ProjectsImagesAsyncBatchAnnotateCall {
c := &ProjectsImagesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14502,12 +14505,12 @@ type ProjectsLocationsFilesAnnotateCall struct {
// (gif) or pages (pdf or tiff) from each file provided and perform
// detection and annotation for each image extracted.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsFilesService) Annotate(parent string, googlecloudvisionv1p1beta1batchannotatefilesrequest *GoogleCloudVisionV1p1beta1BatchAnnotateFilesRequest) *ProjectsLocationsFilesAnnotateCall {
c := &ProjectsLocationsFilesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14658,12 +14661,12 @@ type ProjectsLocationsFilesAsyncBatchAnnotateCall struct {
// `Operation.response` contains `AsyncBatchAnnotateFilesResponse`
// (results).
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsFilesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p1beta1asyncbatchannotatefilesrequest *GoogleCloudVisionV1p1beta1AsyncBatchAnnotateFilesRequest) *ProjectsLocationsFilesAsyncBatchAnnotateCall {
c := &ProjectsLocationsFilesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14806,12 +14809,12 @@ type ProjectsLocationsImagesAnnotateCall struct {
// Annotate: Run image detection and annotation for a batch of images.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsImagesService) Annotate(parent string, googlecloudvisionv1p1beta1batchannotateimagesrequest *GoogleCloudVisionV1p1beta1BatchAnnotateImagesRequest) *ProjectsLocationsImagesAnnotateCall {
c := &ProjectsLocationsImagesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14962,12 +14965,12 @@ type ProjectsLocationsImagesAsyncBatchAnnotateCall struct {
// will write image annotation outputs to json files in customer GCS
// bucket, each json file containing BatchAnnotateImagesResponse proto.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsImagesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p1beta1asyncbatchannotateimagesrequest *GoogleCloudVisionV1p1beta1AsyncBatchAnnotateImagesRequest) *ProjectsLocationsImagesAsyncBatchAnnotateCall {
c := &ProjectsLocationsImagesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/vision/v1p2beta1/vision-api.json b/vision/v1p2beta1/vision-api.json
index 0eecf7bbc62..92c48896d87 100644
--- a/vision/v1p2beta1/vision-api.json
+++ b/vision/v1p2beta1/vision-api.json
@@ -449,7 +449,7 @@
}
}
},
- "revision": "20210809",
+ "revision": "20220805",
"rootUrl": "https://vision.googleapis.com/",
"schemas": {
"AnnotateFileResponse": {
@@ -4123,6 +4123,13 @@
"description": "Parameters for text detections. This is used to control TEXT_DETECTION and DOCUMENT_TEXT_DETECTION features.",
"id": "GoogleCloudVisionV1p2beta1TextDetectionParams",
"properties": {
+ "advancedOcrOptions": {
+ "description": "A list of advanced OCR options to fine-tune OCR behavior.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
"enableTextDetectionConfidenceScore": {
"description": "By default, Cloud Vision API only includes confidence score for DOCUMENT_TEXT_DETECTION result. Set the flag to true to include confidence score for TEXT_DETECTION as well.",
"type": "boolean"
diff --git a/vision/v1p2beta1/vision-gen.go b/vision/v1p2beta1/vision-gen.go
index 50abd05a3c3..dc9c4160045 100644
--- a/vision/v1p2beta1/vision-gen.go
+++ b/vision/v1p2beta1/vision-gen.go
@@ -10,35 +10,35 @@
//
// For product documentation, see: https://cloud.google.com/vision/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vision/v1p2beta1"
-// ...
-// ctx := context.Background()
-// visionService, err := vision.NewService(ctx)
+// import "google.golang.org/api/vision/v1p2beta1"
+// ...
+// ctx := context.Background()
+// visionService, err := vision.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// visionService, err := vision.NewService(ctx, option.WithScopes(vision.CloudVisionScope))
+// visionService, err := vision.NewService(ctx, option.WithScopes(vision.CloudVisionScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// visionService, err := vision.NewService(ctx, option.WithAPIKey("AIza..."))
+// visionService, err := vision.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// visionService, err := vision.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// visionService, err := vision.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vision // import "google.golang.org/api/vision/v1p2beta1"
@@ -684,12 +684,12 @@ func (s *BoundingPoly) MarshalJSON() ([]byte, error) {
// if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green,
// blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams
// = [red, green, blue].join(','); return ['rgba(', rgbParams, ',',
-// alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green,
+// alphaFrac, ')'].join(”); }; var rgbToCssColor = function(red, green,
// blue) { var rgbNumber = new Number((red << 16) | (green << 8) |
// blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 -
// hexString.length; var resultBuilder = ['#']; for (var i = 0; i <
// missingZeros; i++) { resultBuilder.push('0'); }
-// resultBuilder.push(hexString); return resultBuilder.join(''); }; //
+// resultBuilder.push(hexString); return resultBuilder.join(”); }; //
// ...
type Color struct {
// Alpha: The fraction of this color that should be applied to the
@@ -6279,27 +6279,30 @@ func (s *GoogleCloudVisionV1p2beta1TextAnnotationTextProperty) MarshalJSON() ([]
// detections. This is used to control TEXT_DETECTION and
// DOCUMENT_TEXT_DETECTION features.
type GoogleCloudVisionV1p2beta1TextDetectionParams struct {
+ // AdvancedOcrOptions: A list of advanced OCR options to fine-tune OCR
+ // behavior.
+ AdvancedOcrOptions []string `json:"advancedOcrOptions,omitempty"`
+
// EnableTextDetectionConfidenceScore: By default, Cloud Vision API only
// includes confidence score for DOCUMENT_TEXT_DETECTION result. Set the
// flag to true to include confidence score for TEXT_DETECTION as well.
EnableTextDetectionConfidenceScore bool `json:"enableTextDetectionConfidenceScore,omitempty"`
- // ForceSendFields is a list of field names (e.g.
- // "EnableTextDetectionConfidenceScore") to unconditionally include in
- // API requests. By default, fields with empty or default values are
- // omitted from API requests. However, any non-pointer, non-interface
- // field appearing in ForceSendFields will be sent to the server
- // regardless of whether the field is empty or not. This may be used to
- // include empty fields in Patch requests.
+ // ForceSendFields is a list of field names (e.g. "AdvancedOcrOptions")
+ // to unconditionally include in API requests. By default, fields with
+ // empty or default values are omitted from API requests. However, any
+ // non-pointer, non-interface field appearing in ForceSendFields will be
+ // sent to the server regardless of whether the field is empty or not.
+ // This may be used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
- // NullFields is a list of field names (e.g.
- // "EnableTextDetectionConfidenceScore") to include in API requests with
- // the JSON null value. By default, fields with empty values are omitted
- // from API requests. However, any field with an empty value appearing
- // in NullFields will be sent to the server as null. It is an 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. "AdvancedOcrOptions") to
+ // include in API requests with the JSON null value. By default, fields
+ // with empty values are omitted from API requests. However, any field
+ // with an empty value appearing in NullFields will be sent to the
+ // server as null. It is an error if a field in this list has a
+ // non-empty value. This may be used to include null fields in Patch
+ // requests.
NullFields []string `json:"-"`
}
@@ -13889,12 +13892,12 @@ type ProjectsFilesAnnotateCall struct {
// (gif) or pages (pdf or tiff) from each file provided and perform
// detection and annotation for each image extracted.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsFilesService) Annotate(parent string, googlecloudvisionv1p2beta1batchannotatefilesrequest *GoogleCloudVisionV1p2beta1BatchAnnotateFilesRequest) *ProjectsFilesAnnotateCall {
c := &ProjectsFilesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14045,12 +14048,12 @@ type ProjectsFilesAsyncBatchAnnotateCall struct {
// `Operation.response` contains `AsyncBatchAnnotateFilesResponse`
// (results).
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsFilesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p2beta1asyncbatchannotatefilesrequest *GoogleCloudVisionV1p2beta1AsyncBatchAnnotateFilesRequest) *ProjectsFilesAsyncBatchAnnotateCall {
c := &ProjectsFilesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14193,12 +14196,12 @@ type ProjectsImagesAnnotateCall struct {
// Annotate: Run image detection and annotation for a batch of images.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsImagesService) Annotate(parent string, googlecloudvisionv1p2beta1batchannotateimagesrequest *GoogleCloudVisionV1p2beta1BatchAnnotateImagesRequest) *ProjectsImagesAnnotateCall {
c := &ProjectsImagesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14349,12 +14352,12 @@ type ProjectsImagesAsyncBatchAnnotateCall struct {
// will write image annotation outputs to json files in customer GCS
// bucket, each json file containing BatchAnnotateImagesResponse proto.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsImagesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p2beta1asyncbatchannotateimagesrequest *GoogleCloudVisionV1p2beta1AsyncBatchAnnotateImagesRequest) *ProjectsImagesAsyncBatchAnnotateCall {
c := &ProjectsImagesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14502,12 +14505,12 @@ type ProjectsLocationsFilesAnnotateCall struct {
// (gif) or pages (pdf or tiff) from each file provided and perform
// detection and annotation for each image extracted.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsFilesService) Annotate(parent string, googlecloudvisionv1p2beta1batchannotatefilesrequest *GoogleCloudVisionV1p2beta1BatchAnnotateFilesRequest) *ProjectsLocationsFilesAnnotateCall {
c := &ProjectsLocationsFilesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14658,12 +14661,12 @@ type ProjectsLocationsFilesAsyncBatchAnnotateCall struct {
// `Operation.response` contains `AsyncBatchAnnotateFilesResponse`
// (results).
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsFilesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p2beta1asyncbatchannotatefilesrequest *GoogleCloudVisionV1p2beta1AsyncBatchAnnotateFilesRequest) *ProjectsLocationsFilesAsyncBatchAnnotateCall {
c := &ProjectsLocationsFilesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14806,12 +14809,12 @@ type ProjectsLocationsImagesAnnotateCall struct {
// Annotate: Run image detection and annotation for a batch of images.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsImagesService) Annotate(parent string, googlecloudvisionv1p2beta1batchannotateimagesrequest *GoogleCloudVisionV1p2beta1BatchAnnotateImagesRequest) *ProjectsLocationsImagesAnnotateCall {
c := &ProjectsLocationsImagesAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -14962,12 +14965,12 @@ type ProjectsLocationsImagesAsyncBatchAnnotateCall struct {
// will write image annotation outputs to json files in customer GCS
// bucket, each json file containing BatchAnnotateImagesResponse proto.
//
-// - parent: Optional. Target project and location to make a call.
-// Format: `projects/{project-id}/locations/{location-id}`. If no
-// parent is specified, a region will be chosen automatically.
-// Supported location-ids: `us`: USA country only, `asia`: East asia
-// areas, like Japan, Taiwan, `eu`: The European Union. Example:
-// `projects/project-A/locations/eu`.
+// - parent: Optional. Target project and location to make a call.
+// Format: `projects/{project-id}/locations/{location-id}`. If no
+// parent is specified, a region will be chosen automatically.
+// Supported location-ids: `us`: USA country only, `asia`: East asia
+// areas, like Japan, Taiwan, `eu`: The European Union. Example:
+// `projects/project-A/locations/eu`.
func (r *ProjectsLocationsImagesService) AsyncBatchAnnotate(parent string, googlecloudvisionv1p2beta1asyncbatchannotateimagesrequest *GoogleCloudVisionV1p2beta1AsyncBatchAnnotateImagesRequest) *ProjectsLocationsImagesAsyncBatchAnnotateCall {
c := &ProjectsLocationsImagesAsyncBatchAnnotateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/vmmigration/v1/vmmigration-api.json b/vmmigration/v1/vmmigration-api.json
index c676a34f950..b619e8aa631 100644
--- a/vmmigration/v1/vmmigration-api.json
+++ b/vmmigration/v1/vmmigration-api.json
@@ -1897,7 +1897,7 @@
}
}
},
- "revision": "20220714",
+ "revision": "20220811",
"rootUrl": "https://vmmigration.googleapis.com/",
"schemas": {
"AddGroupMigrationRequest": {
@@ -2873,7 +2873,7 @@
"id": "LocalizedMessage",
"properties": {
"locale": {
- "description": "The locale used following the specification defined at http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"",
+ "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"",
"type": "string"
},
"message": {
diff --git a/vmmigration/v1/vmmigration-gen.go b/vmmigration/v1/vmmigration-gen.go
index 13ff162474c..067a2e7c453 100644
--- a/vmmigration/v1/vmmigration-gen.go
+++ b/vmmigration/v1/vmmigration-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/migrate/virtual-machines
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vmmigration/v1"
-// ...
-// ctx := context.Background()
-// vmmigrationService, err := vmmigration.NewService(ctx)
+// import "google.golang.org/api/vmmigration/v1"
+// ...
+// ctx := context.Background()
+// vmmigrationService, err := vmmigration.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// vmmigrationService, err := vmmigration.NewService(ctx, option.WithAPIKey("AIza..."))
+// vmmigrationService, err := vmmigration.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// vmmigrationService, err := vmmigration.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// vmmigrationService, err := vmmigration.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vmmigration // import "google.golang.org/api/vmmigration/v1"
@@ -1500,7 +1500,7 @@ func (s *ListUtilizationReportsResponse) MarshalJSON() ([]byte, error) {
// return to the user which can be attached to an RPC error.
type LocalizedMessage struct {
// Locale: The locale used following the specification defined at
- // http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US",
+ // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US",
// "fr-CH", "es-MX"
Locale string `json:"locale,omitempty"`
@@ -2816,8 +2816,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -5926,9 +5926,9 @@ type ProjectsLocationsSourcesDatacenterConnectorsCreateCall struct {
// Create: Creates a new DatacenterConnector in a given Source.
//
-// - parent: The DatacenterConnector's parent. Required. The Source in
-// where the new DatacenterConnector will be created. For example:
-// `projects/my-project/locations/us-central1/sources/my-source`.
+// - parent: The DatacenterConnector's parent. Required. The Source in
+// where the new DatacenterConnector will be created. For example:
+// `projects/my-project/locations/us-central1/sources/my-source`.
func (r *ProjectsLocationsSourcesDatacenterConnectorsService) Create(parent string, datacenterconnector *DatacenterConnector) *ProjectsLocationsSourcesDatacenterConnectorsCreateCall {
c := &ProjectsLocationsSourcesDatacenterConnectorsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7231,12 +7231,17 @@ func (r *ProjectsLocationsSourcesMigratingVmsService) Get(name string) *Projects
// migrating VM.
//
// Possible values:
-// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
+// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
// fallback to the default value.
-// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
+// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
// basic details do not include the recent clone jobs and recent cutover
// jobs lists.
-// "MIGRATING_VM_VIEW_FULL" - Include everything.
+//
+// "MIGRATING_VM_VIEW_FULL" - Include everything.
func (c *ProjectsLocationsSourcesMigratingVmsGetCall) View(view string) *ProjectsLocationsSourcesMigratingVmsGetCall {
c.urlParams_.Set("view", view)
return c
@@ -7439,12 +7444,17 @@ func (c *ProjectsLocationsSourcesMigratingVmsListCall) PageToken(pageToken strin
// migrating VM.
//
// Possible values:
-// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
+// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
// fallback to the default value.
-// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
+// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
// basic details do not include the recent clone jobs and recent cutover
// jobs lists.
-// "MIGRATING_VM_VIEW_FULL" - Include everything.
+//
+// "MIGRATING_VM_VIEW_FULL" - Include everything.
func (c *ProjectsLocationsSourcesMigratingVmsListCall) View(view string) *ProjectsLocationsSourcesMigratingVmsListCall {
c.urlParams_.Set("view", view)
return c
@@ -9976,12 +9986,17 @@ func (r *ProjectsLocationsSourcesUtilizationReportsService) Get(name string) *Pr
// report. Defaults to FULL
//
// Possible values:
-// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
+// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
// The API will default to FULL on single report request and BASIC for
// multiple reports request.
-// "BASIC" - Get the report metadata, without the list of VMs and
+//
+// "BASIC" - Get the report metadata, without the list of VMs and
+//
// their utilization info.
-// "FULL" - Include everything.
+//
+// "FULL" - Include everything.
func (c *ProjectsLocationsSourcesUtilizationReportsGetCall) View(view string) *ProjectsLocationsSourcesUtilizationReportsGetCall {
c.urlParams_.Set("view", view)
return c
@@ -10184,12 +10199,17 @@ func (c *ProjectsLocationsSourcesUtilizationReportsListCall) PageToken(pageToken
// report. Defaults to BASIC.
//
// Possible values:
-// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
+// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
// The API will default to FULL on single report request and BASIC for
// multiple reports request.
-// "BASIC" - Get the report metadata, without the list of VMs and
+//
+// "BASIC" - Get the report metadata, without the list of VMs and
+//
// their utilization info.
-// "FULL" - Include everything.
+//
+// "FULL" - Include everything.
func (c *ProjectsLocationsSourcesUtilizationReportsListCall) View(view string) *ProjectsLocationsSourcesUtilizationReportsListCall {
c.urlParams_.Set("view", view)
return c
diff --git a/vmmigration/v1alpha1/vmmigration-api.json b/vmmigration/v1alpha1/vmmigration-api.json
index 8a62c258fd0..1b2407bc265 100644
--- a/vmmigration/v1alpha1/vmmigration-api.json
+++ b/vmmigration/v1alpha1/vmmigration-api.json
@@ -1897,7 +1897,7 @@
}
}
},
- "revision": "20220714",
+ "revision": "20220811",
"rootUrl": "https://vmmigration.googleapis.com/",
"schemas": {
"AdaptingOSStep": {
@@ -3031,7 +3031,7 @@
"id": "LocalizedMessage",
"properties": {
"locale": {
- "description": "The locale used following the specification defined at http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"",
+ "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"",
"type": "string"
},
"message": {
diff --git a/vmmigration/v1alpha1/vmmigration-gen.go b/vmmigration/v1alpha1/vmmigration-gen.go
index 9d9b7e0f763..d5f2b0347ed 100644
--- a/vmmigration/v1alpha1/vmmigration-gen.go
+++ b/vmmigration/v1alpha1/vmmigration-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/migrate/virtual-machines
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/vmmigration/v1alpha1"
-// ...
-// ctx := context.Background()
-// vmmigrationService, err := vmmigration.NewService(ctx)
+// import "google.golang.org/api/vmmigration/v1alpha1"
+// ...
+// ctx := context.Background()
+// vmmigrationService, err := vmmigration.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// vmmigrationService, err := vmmigration.NewService(ctx, option.WithAPIKey("AIza..."))
+// vmmigrationService, err := vmmigration.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// vmmigrationService, err := vmmigration.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// vmmigrationService, err := vmmigration.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package vmmigration // import "google.golang.org/api/vmmigration/v1alpha1"
@@ -1672,7 +1672,7 @@ func (s *ListUtilizationReportsResponse) MarshalJSON() ([]byte, error) {
// return to the user which can be attached to an RPC error.
type LocalizedMessage struct {
// Locale: The locale used following the specification defined at
- // http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US",
+ // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US",
// "fr-CH", "es-MX"
Locale string `json:"locale,omitempty"`
@@ -3218,8 +3218,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -6328,9 +6328,9 @@ type ProjectsLocationsSourcesDatacenterConnectorsCreateCall struct {
// Create: Creates a new DatacenterConnector in a given Source.
//
-// - parent: The DatacenterConnector's parent. Required. The Source in
-// where the new DatacenterConnector will be created. For example:
-// `projects/my-project/locations/us-central1/sources/my-source`.
+// - parent: The DatacenterConnector's parent. Required. The Source in
+// where the new DatacenterConnector will be created. For example:
+// `projects/my-project/locations/us-central1/sources/my-source`.
func (r *ProjectsLocationsSourcesDatacenterConnectorsService) Create(parent string, datacenterconnector *DatacenterConnector) *ProjectsLocationsSourcesDatacenterConnectorsCreateCall {
c := &ProjectsLocationsSourcesDatacenterConnectorsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -7633,12 +7633,17 @@ func (r *ProjectsLocationsSourcesMigratingVmsService) Get(name string) *Projects
// migrating VM.
//
// Possible values:
-// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
+// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
// fallback to the default value.
-// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
+// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
// basic details do not include the recent clone jobs and recent cutover
// jobs lists.
-// "MIGRATING_VM_VIEW_FULL" - Include everything.
+//
+// "MIGRATING_VM_VIEW_FULL" - Include everything.
func (c *ProjectsLocationsSourcesMigratingVmsGetCall) View(view string) *ProjectsLocationsSourcesMigratingVmsGetCall {
c.urlParams_.Set("view", view)
return c
@@ -7841,12 +7846,17 @@ func (c *ProjectsLocationsSourcesMigratingVmsListCall) PageToken(pageToken strin
// migrating VM.
//
// Possible values:
-// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
+// "MIGRATING_VM_VIEW_UNSPECIFIED" - View is unspecified. The API will
+//
// fallback to the default value.
-// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
+// "MIGRATING_VM_VIEW_BASIC" - Get the migrating VM basic details. The
+//
// basic details do not include the recent clone jobs and recent cutover
// jobs lists.
-// "MIGRATING_VM_VIEW_FULL" - Include everything.
+//
+// "MIGRATING_VM_VIEW_FULL" - Include everything.
func (c *ProjectsLocationsSourcesMigratingVmsListCall) View(view string) *ProjectsLocationsSourcesMigratingVmsListCall {
c.urlParams_.Set("view", view)
return c
@@ -10378,12 +10388,17 @@ func (r *ProjectsLocationsSourcesUtilizationReportsService) Get(name string) *Pr
// report. Defaults to FULL
//
// Possible values:
-// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
+// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
// The API will default to FULL on single report request and BASIC for
// multiple reports request.
-// "BASIC" - Get the report metadata, without the list of VMs and
+//
+// "BASIC" - Get the report metadata, without the list of VMs and
+//
// their utilization info.
-// "FULL" - Include everything.
+//
+// "FULL" - Include everything.
func (c *ProjectsLocationsSourcesUtilizationReportsGetCall) View(view string) *ProjectsLocationsSourcesUtilizationReportsGetCall {
c.urlParams_.Set("view", view)
return c
@@ -10586,12 +10601,17 @@ func (c *ProjectsLocationsSourcesUtilizationReportsListCall) PageToken(pageToken
// report. Defaults to BASIC.
//
// Possible values:
-// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
+// "UTILIZATION_REPORT_VIEW_UNSPECIFIED" - The default / unset value.
+//
// The API will default to FULL on single report request and BASIC for
// multiple reports request.
-// "BASIC" - Get the report metadata, without the list of VMs and
+//
+// "BASIC" - Get the report metadata, without the list of VMs and
+//
// their utilization info.
-// "FULL" - Include everything.
+//
+// "FULL" - Include everything.
func (c *ProjectsLocationsSourcesUtilizationReportsListCall) View(view string) *ProjectsLocationsSourcesUtilizationReportsListCall {
c.urlParams_.Set("view", view)
return c
diff --git a/webfonts/v1/webfonts-gen.go b/webfonts/v1/webfonts-gen.go
index 32a22677655..2aca33a23ce 100644
--- a/webfonts/v1/webfonts-gen.go
+++ b/webfonts/v1/webfonts-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/fonts/docs/developer_api
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/webfonts/v1"
-// ...
-// ctx := context.Background()
-// webfontsService, err := webfonts.NewService(ctx)
+// import "google.golang.org/api/webfonts/v1"
+// ...
+// ctx := context.Background()
+// webfontsService, err := webfonts.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// webfontsService, err := webfonts.NewService(ctx, option.WithAPIKey("AIza..."))
+// webfontsService, err := webfonts.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// webfontsService, err := webfonts.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// webfontsService, err := webfonts.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package webfonts // import "google.golang.org/api/webfonts/v1"
@@ -242,13 +242,16 @@ func (r *WebfontsService) List() *WebfontsListCall {
// Sort sets the optional parameter "sort": Enables sorting of the list.
//
// Possible values:
-// "SORT_UNDEFINED" - No sorting specified, use the default sorting
+//
+// "SORT_UNDEFINED" - No sorting specified, use the default sorting
+//
// method.
-// "ALPHA" - Sort alphabetically
-// "DATE" - Sort by date added
-// "POPULARITY" - Sort by popularity
-// "STYLE" - Sort by number of styles
-// "TRENDING" - Sort by trending
+//
+// "ALPHA" - Sort alphabetically
+// "DATE" - Sort by date added
+// "POPULARITY" - Sort by popularity
+// "STYLE" - Sort by number of styles
+// "TRENDING" - Sort by trending
func (c *WebfontsListCall) Sort(sort string) *WebfontsListCall {
c.urlParams_.Set("sort", sort)
return c
diff --git a/webmasters/v3/webmasters-gen.go b/webmasters/v3/webmasters-gen.go
index 8204d592160..4da2034c76a 100644
--- a/webmasters/v3/webmasters-gen.go
+++ b/webmasters/v3/webmasters-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/webmaster-tools/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/webmasters/v3"
-// ...
-// ctx := context.Background()
-// webmastersService, err := webmasters.NewService(ctx)
+// import "google.golang.org/api/webmasters/v3"
+// ...
+// ctx := context.Background()
+// webmastersService, err := webmasters.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// webmastersService, err := webmasters.NewService(ctx, option.WithScopes(webmasters.WebmastersReadonlyScope))
+// webmastersService, err := webmasters.NewService(ctx, option.WithScopes(webmasters.WebmastersReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// webmastersService, err := webmasters.NewService(ctx, option.WithAPIKey("AIza..."))
+// webmastersService, err := webmasters.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// webmastersService, err := webmasters.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// webmastersService, err := webmasters.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package webmasters // import "google.golang.org/api/webmasters/v3"
@@ -631,8 +631,8 @@ type SearchanalyticsQueryCall struct {
// data, issue a broad date range query grouped by date for any metric,
// and see which day rows are returned.
//
-// - siteUrl: The site's URL, including protocol. For example:
-// http://www.example.com/.
+// - siteUrl: The site's URL, including protocol. For example:
+// http://www.example.com/.
func (r *SearchanalyticsService) Query(siteUrl string, searchanalyticsqueryrequest *SearchAnalyticsQueryRequest) *SearchanalyticsQueryCall {
c := &SearchanalyticsQueryCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -773,10 +773,10 @@ type SitemapsDeleteCall struct {
// Delete: Deletes a sitemap from this site.
//
-// - feedpath: The URL of the actual sitemap. For example:
-// http://www.example.com/sitemap.xml.
-// - siteUrl: The site's URL, including protocol. For example:
-// http://www.example.com/.
+// - feedpath: The URL of the actual sitemap. For example:
+// http://www.example.com/sitemap.xml.
+// - siteUrl: The site's URL, including protocol. For example:
+// http://www.example.com/.
func (r *SitemapsService) Delete(siteUrl string, feedpath string) *SitemapsDeleteCall {
c := &SitemapsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -889,10 +889,10 @@ type SitemapsGetCall struct {
// Get: Retrieves information about a specific sitemap.
//
-// - feedpath: The URL of the actual sitemap. For example:
-// http://www.example.com/sitemap.xml.
-// - siteUrl: The site's URL, including protocol. For example:
-// http://www.example.com/.
+// - feedpath: The URL of the actual sitemap. For example:
+// http://www.example.com/sitemap.xml.
+// - siteUrl: The site's URL, including protocol. For example:
+// http://www.example.com/.
func (r *SitemapsService) Get(siteUrl string, feedpath string) *SitemapsGetCall {
c := &SitemapsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -1048,8 +1048,8 @@ type SitemapsListCall struct {
// in the sitemap index file (if sitemapIndex is specified in the
// request).
//
-// - siteUrl: The site's URL, including protocol. For example:
-// http://www.example.com/.
+// - siteUrl: The site's URL, including protocol. For example:
+// http://www.example.com/.
func (r *SitemapsService) List(siteUrl string) *SitemapsListCall {
c := &SitemapsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -1207,10 +1207,10 @@ type SitemapsSubmitCall struct {
// Submit: Submits a sitemap for a site.
//
-// - feedpath: The URL of the sitemap to add. For example:
-// http://www.example.com/sitemap.xml.
-// - siteUrl: The site's URL, including protocol. For example:
-// http://www.example.com/.
+// - feedpath: The URL of the sitemap to add. For example:
+// http://www.example.com/sitemap.xml.
+// - siteUrl: The site's URL, including protocol. For example:
+// http://www.example.com/.
func (r *SitemapsService) Submit(siteUrl string, feedpath string) *SitemapsSubmitCall {
c := &SitemapsSubmitCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -1424,10 +1424,10 @@ type SitesDeleteCall struct {
// Delete: Removes a site from the set of the user's Search Console
// sites.
//
-// - siteUrl: The URI of the property as defined in Search Console.
-// Examples: http://www.example.com/ or android-app://com.example/
-// Note: for property-sets, use the URI that starts with sc-set: which
-// is used in Search Console URLs.
+// - siteUrl: The URI of the property as defined in Search Console.
+// Examples: http://www.example.com/ or android-app://com.example/
+// Note: for property-sets, use the URI that starts with sc-set: which
+// is used in Search Console URLs.
func (r *SitesService) Delete(siteUrl string) *SitesDeleteCall {
c := &SitesDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
@@ -1530,10 +1530,10 @@ type SitesGetCall struct {
// Get: Retrieves information about specific site.
//
-// - siteUrl: The URI of the property as defined in Search Console.
-// Examples: http://www.example.com/ or android-app://com.example/
-// Note: for property-sets, use the URI that starts with sc-set: which
-// is used in Search Console URLs.
+// - siteUrl: The URI of the property as defined in Search Console.
+// Examples: http://www.example.com/ or android-app://com.example/
+// Note: for property-sets, use the URI that starts with sc-set: which
+// is used in Search Console URLs.
func (r *SitesService) Get(siteUrl string) *SitesGetCall {
c := &SitesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.siteUrl = siteUrl
diff --git a/webrisk/v1/webrisk-api.json b/webrisk/v1/webrisk-api.json
index bddb1b507ed..862c5e45a0d 100644
--- a/webrisk/v1/webrisk-api.json
+++ b/webrisk/v1/webrisk-api.json
@@ -452,7 +452,7 @@
}
}
},
- "revision": "20220708",
+ "revision": "20220819",
"rootUrl": "https://webrisk.googleapis.com/",
"schemas": {
"GoogleCloudWebriskV1ComputeThreatListDiffResponse": {
@@ -715,14 +715,16 @@
"RUNNING",
"SUCCEEDED",
"CANCELLED",
- "FAILED"
+ "FAILED",
+ "CLOSED"
],
"enumDescriptions": [
"Default unspecified state.",
"The operation is currently running.",
"The operation finished with a success status.",
"The operation was cancelled.",
- "The operation finished with a failure status."
+ "The operation finished with a failure status.",
+ "The operation was closed with no action taken."
],
"type": "string"
},
@@ -819,11 +821,11 @@
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
- "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
+ "description": "This field will contain a `SubmitUriMetadata` object.",
"type": "object"
},
"name": {
- "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.",
+ "description": "This will match the pattern `/v1/{project-name}/operations/{operation-id}`.",
"type": "string"
},
"response": {
diff --git a/webrisk/v1/webrisk-gen.go b/webrisk/v1/webrisk-gen.go
index 0eff0005216..cf626aff1a6 100644
--- a/webrisk/v1/webrisk-gen.go
+++ b/webrisk/v1/webrisk-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/web-risk/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/webrisk/v1"
-// ...
-// ctx := context.Background()
-// webriskService, err := webrisk.NewService(ctx)
+// import "google.golang.org/api/webrisk/v1"
+// ...
+// ctx := context.Background()
+// webriskService, err := webrisk.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// webriskService, err := webrisk.NewService(ctx, option.WithAPIKey("AIza..."))
+// webriskService, err := webrisk.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// webriskService, err := webrisk.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// webriskService, err := webrisk.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package webrisk // import "google.golang.org/api/webrisk/v1"
@@ -652,6 +652,7 @@ type GoogleCloudWebriskV1SubmitUriMetadata struct {
// "SUCCEEDED" - The operation finished with a success status.
// "CANCELLED" - The operation was cancelled.
// "FAILED" - The operation finished with a failure status.
+ // "CLOSED" - The operation was closed with no action taken.
State string `json:"state,omitempty"`
// UpdateTime: Latest update time of the operation.
@@ -836,17 +837,11 @@ type GoogleLongrunningOperation struct {
// cancellation.
Error *GoogleRpcStatus `json:"error,omitempty"`
- // Metadata: Service-specific metadata associated with the operation. It
- // typically contains progress information and common metadata such as
- // create time. Some services might not provide such metadata. Any
- // method that returns a long-running operation should document the
- // metadata type, if any.
+ // Metadata: This field will contain a `SubmitUriMetadata` object.
Metadata googleapi.RawMessage `json:"metadata,omitempty"`
- // Name: The server-assigned name, which is only unique within the same
- // service that originally returns it. If you use the default HTTP
- // mapping, the `name` should be a resource name ending with
- // `operations/{unique_id}`.
+ // Name: This will match the pattern
+ // `/v1/{project-name}/operations/{operation-id}`.
Name string `json:"name,omitempty"`
// Response: The normal response of the operation in case of success. If
@@ -975,12 +970,16 @@ func (c *HashesSearchCall) HashPrefix(hashPrefix string) *HashesSearchCall {
// ThreatLists to search in. Multiple ThreatLists may be specified.
//
// Possible values:
-// "THREAT_TYPE_UNSPECIFIED" - No entries should match this threat
+//
+// "THREAT_TYPE_UNSPECIFIED" - No entries should match this threat
+//
// type. This threat type is unused.
-// "MALWARE" - Malware targeting any platform.
-// "SOCIAL_ENGINEERING" - Social engineering targeting any platform.
-// "UNWANTED_SOFTWARE" - Unwanted software targeting any platform.
-// "SOCIAL_ENGINEERING_EXTENDED_COVERAGE" - Extended Coverage Social
+//
+// "MALWARE" - Malware targeting any platform.
+// "SOCIAL_ENGINEERING" - Social engineering targeting any platform.
+// "UNWANTED_SOFTWARE" - Unwanted software targeting any platform.
+// "SOCIAL_ENGINEERING_EXTENDED_COVERAGE" - Extended Coverage Social
+//
// Engineering list targeting any platform.
func (c *HashesSearchCall) ThreatTypes(threatTypes ...string) *HashesSearchCall {
c.urlParams_.SetMulti("threatTypes", append([]string{}, threatTypes...))
@@ -1788,8 +1787,8 @@ type ProjectsSubmissionsCreateCall struct {
// Only allowlisted projects can use this method during Early Access.
// Please reach out to Sales or your customer engineer to obtain access.
//
-// - parent: The name of the project that is making the submission. This
-// string is in the format "projects/{project_number}".
+// - parent: The name of the project that is making the submission. This
+// string is in the format "projects/{project_number}".
func (r *ProjectsSubmissionsService) Create(parent string, googlecloudwebriskv1submission *GoogleCloudWebriskV1Submission) *ProjectsSubmissionsCreateCall {
c := &ProjectsSubmissionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1941,8 +1940,8 @@ type ProjectsUrisSubmitCall struct {
// Only allowlisted projects can use this method during Early Access.
// Please reach out to Sales or your customer engineer to obtain access.
//
-// - parent: The name of the project that is making the submission. This
-// string is in the format "projects/{project_number}".
+// - parent: The name of the project that is making the submission. This
+// string is in the format "projects/{project_number}".
func (r *ProjectsUrisService) Submit(parent string, googlecloudwebriskv1submiturirequest *GoogleCloudWebriskV1SubmitUriRequest) *ProjectsUrisSubmitCall {
c := &ProjectsUrisSubmitCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2118,9 +2117,10 @@ func (c *ThreatListsComputeDiffCall) ConstraintsMaxDiffEntries(constraintsMaxDif
// by the client.
//
// Possible values:
-// "COMPRESSION_TYPE_UNSPECIFIED" - Unknown.
-// "RAW" - Raw, uncompressed data.
-// "RICE" - Rice-Golomb encoded data.
+//
+// "COMPRESSION_TYPE_UNSPECIFIED" - Unknown.
+// "RAW" - Raw, uncompressed data.
+// "RICE" - Rice-Golomb encoded data.
func (c *ThreatListsComputeDiffCall) ConstraintsSupportedCompressions(constraintsSupportedCompressions ...string) *ThreatListsComputeDiffCall {
c.urlParams_.SetMulti("constraints.supportedCompressions", append([]string{}, constraintsSupportedCompressions...))
return c
@@ -2132,12 +2132,16 @@ func (c *ThreatListsComputeDiffCall) ConstraintsSupportedCompressions(constraint
// make one request per ThreatType.
//
// Possible values:
-// "THREAT_TYPE_UNSPECIFIED" - No entries should match this threat
+//
+// "THREAT_TYPE_UNSPECIFIED" - No entries should match this threat
+//
// type. This threat type is unused.
-// "MALWARE" - Malware targeting any platform.
-// "SOCIAL_ENGINEERING" - Social engineering targeting any platform.
-// "UNWANTED_SOFTWARE" - Unwanted software targeting any platform.
-// "SOCIAL_ENGINEERING_EXTENDED_COVERAGE" - Extended Coverage Social
+//
+// "MALWARE" - Malware targeting any platform.
+// "SOCIAL_ENGINEERING" - Social engineering targeting any platform.
+// "UNWANTED_SOFTWARE" - Unwanted software targeting any platform.
+// "SOCIAL_ENGINEERING_EXTENDED_COVERAGE" - Extended Coverage Social
+//
// Engineering list targeting any platform.
func (c *ThreatListsComputeDiffCall) ThreatType(threatType string) *ThreatListsComputeDiffCall {
c.urlParams_.Set("threatType", threatType)
@@ -2348,12 +2352,16 @@ func (r *UrisService) Search() *UrisSearchCall {
// ThreatLists to search in. Multiple ThreatLists may be specified.
//
// Possible values:
-// "THREAT_TYPE_UNSPECIFIED" - No entries should match this threat
+//
+// "THREAT_TYPE_UNSPECIFIED" - No entries should match this threat
+//
// type. This threat type is unused.
-// "MALWARE" - Malware targeting any platform.
-// "SOCIAL_ENGINEERING" - Social engineering targeting any platform.
-// "UNWANTED_SOFTWARE" - Unwanted software targeting any platform.
-// "SOCIAL_ENGINEERING_EXTENDED_COVERAGE" - Extended Coverage Social
+//
+// "MALWARE" - Malware targeting any platform.
+// "SOCIAL_ENGINEERING" - Social engineering targeting any platform.
+// "UNWANTED_SOFTWARE" - Unwanted software targeting any platform.
+// "SOCIAL_ENGINEERING_EXTENDED_COVERAGE" - Extended Coverage Social
+//
// Engineering list targeting any platform.
func (c *UrisSearchCall) ThreatTypes(threatTypes ...string) *UrisSearchCall {
c.urlParams_.SetMulti("threatTypes", append([]string{}, threatTypes...))
diff --git a/websecurityscanner/v1/websecurityscanner-gen.go b/websecurityscanner/v1/websecurityscanner-gen.go
index f3049ddbf9d..97508041293 100644
--- a/websecurityscanner/v1/websecurityscanner-gen.go
+++ b/websecurityscanner/v1/websecurityscanner-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/security-command-center/docs/concepts-web-security-scanner-overview/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/websecurityscanner/v1"
-// ...
-// ctx := context.Background()
-// websecurityscannerService, err := websecurityscanner.NewService(ctx)
+// import "google.golang.org/api/websecurityscanner/v1"
+// ...
+// ctx := context.Background()
+// websecurityscannerService, err := websecurityscanner.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithAPIKey("AIza..."))
+// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package websecurityscanner // import "google.golang.org/api/websecurityscanner/v1"
@@ -1537,9 +1537,9 @@ type ProjectsScanConfigsCreateCall struct {
// Create: Creates a new ScanConfig.
//
-// - parent: The parent resource name where the scan is created, which
-// should be a project resource name in the format
-// 'projects/{projectId}'.
+// - parent: The parent resource name where the scan is created, which
+// should be a project resource name in the format
+// 'projects/{projectId}'.
func (r *ProjectsScanConfigsService) Create(parent string, scanconfig *ScanConfig) *ProjectsScanConfigsCreateCall {
c := &ProjectsScanConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1680,9 +1680,9 @@ type ProjectsScanConfigsDeleteCall struct {
// Delete: Deletes an existing ScanConfig and its child resources.
//
-// - name: The resource name of the ScanConfig to be deleted. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be deleted. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Delete(name string) *ProjectsScanConfigsDeleteCall {
c := &ProjectsScanConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1815,9 +1815,9 @@ type ProjectsScanConfigsGetCall struct {
// Get: Gets a ScanConfig.
//
-// - name: The resource name of the ScanConfig to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Get(name string) *ProjectsScanConfigsGetCall {
c := &ProjectsScanConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1963,8 +1963,8 @@ type ProjectsScanConfigsListCall struct {
// List: Lists ScanConfigs under a given project.
//
-// - parent: The parent resource name, which should be a project
-// resource name in the format 'projects/{projectId}'.
+// - parent: The parent resource name, which should be a project
+// resource name in the format 'projects/{projectId}'.
func (r *ProjectsScanConfigsService) List(parent string) *ProjectsScanConfigsListCall {
c := &ProjectsScanConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2160,9 +2160,9 @@ type ProjectsScanConfigsPatchCall struct {
// Patch: Updates a ScanConfig. This method support partial update of a
// ScanConfig.
//
-// - name: The resource name of the ScanConfig. The name follows the
-// format of 'projects/{projectId}/scanConfigs/{scanConfigId}'. The
-// ScanConfig IDs are generated by the system.
+// - name: The resource name of the ScanConfig. The name follows the
+// format of 'projects/{projectId}/scanConfigs/{scanConfigId}'. The
+// ScanConfig IDs are generated by the system.
func (r *ProjectsScanConfigsService) Patch(name string, scanconfig *ScanConfig) *ProjectsScanConfigsPatchCall {
c := &ProjectsScanConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2319,9 +2319,9 @@ type ProjectsScanConfigsStartCall struct {
// Start: Start a ScanRun according to the given ScanConfig.
//
-// - name: The resource name of the ScanConfig to be used. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be used. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Start(name string, startscanrunrequest *StartScanRunRequest) *ProjectsScanConfigsStartCall {
c := &ProjectsScanConfigsStartCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2463,10 +2463,10 @@ type ProjectsScanConfigsScanRunsGetCall struct {
// Get: Gets a ScanRun.
//
-// - name: The resource name of the ScanRun to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - name: The resource name of the ScanRun to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsService) Get(name string) *ProjectsScanConfigsScanRunsGetCall {
c := &ProjectsScanConfigsScanRunsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2613,9 +2613,9 @@ type ProjectsScanConfigsScanRunsListCall struct {
// List: Lists ScanRuns under a given ScanConfig, in descending order of
// ScanRun stop time.
//
-// - parent: The parent resource name, which should be a scan resource
-// name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - parent: The parent resource name, which should be a scan resource
+// name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsScanRunsService) List(parent string) *ProjectsScanConfigsScanRunsListCall {
c := &ProjectsScanConfigsScanRunsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2810,10 +2810,10 @@ type ProjectsScanConfigsScanRunsStopCall struct {
// Stop: Stops a ScanRun. The stopped ScanRun is returned.
//
-// - name: The resource name of the ScanRun to be stopped. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - name: The resource name of the ScanRun to be stopped. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsService) Stop(name string, stopscanrunrequest *StopScanRunRequest) *ProjectsScanConfigsScanRunsStopCall {
c := &ProjectsScanConfigsScanRunsStopCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2955,10 +2955,10 @@ type ProjectsScanConfigsScanRunsCrawledUrlsListCall struct {
// List: List CrawledUrls under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsCrawledUrlsService) List(parent string) *ProjectsScanConfigsScanRunsCrawledUrlsListCall {
c := &ProjectsScanConfigsScanRunsCrawledUrlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3153,10 +3153,10 @@ type ProjectsScanConfigsScanRunsFindingTypeStatsListCall struct {
// List: List all FindingTypeStats under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsFindingTypeStatsService) List(parent string) *ProjectsScanConfigsScanRunsFindingTypeStatsListCall {
c := &ProjectsScanConfigsScanRunsFindingTypeStatsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3302,10 +3302,10 @@ type ProjectsScanConfigsScanRunsFindingsGetCall struct {
// Get: Gets a Finding.
//
-// - name: The resource name of the Finding to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }/findings/{findingId}'.
+// - name: The resource name of the Finding to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }/findings/{findingId}'.
func (r *ProjectsScanConfigsScanRunsFindingsService) Get(name string) *ProjectsScanConfigsScanRunsFindingsGetCall {
c := &ProjectsScanConfigsScanRunsFindingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3451,10 +3451,10 @@ type ProjectsScanConfigsScanRunsFindingsListCall struct {
// List: List Findings under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsFindingsService) List(parent string) *ProjectsScanConfigsScanRunsFindingsListCall {
c := &ProjectsScanConfigsScanRunsFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/websecurityscanner/v1alpha/websecurityscanner-gen.go b/websecurityscanner/v1alpha/websecurityscanner-gen.go
index 56c22dea10a..fbeae8941fa 100644
--- a/websecurityscanner/v1alpha/websecurityscanner-gen.go
+++ b/websecurityscanner/v1alpha/websecurityscanner-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/security-command-center/docs/concepts-web-security-scanner-overview/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/websecurityscanner/v1alpha"
-// ...
-// ctx := context.Background()
-// websecurityscannerService, err := websecurityscanner.NewService(ctx)
+// import "google.golang.org/api/websecurityscanner/v1alpha"
+// ...
+// ctx := context.Background()
+// websecurityscannerService, err := websecurityscanner.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithAPIKey("AIza..."))
+// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package websecurityscanner // import "google.golang.org/api/websecurityscanner/v1alpha"
@@ -1171,9 +1171,9 @@ type ProjectsScanConfigsCreateCall struct {
// Create: Creates a new ScanConfig.
//
-// - parent: The parent resource name where the scan is created, which
-// should be a project resource name in the format
-// 'projects/{projectId}'.
+// - parent: The parent resource name where the scan is created, which
+// should be a project resource name in the format
+// 'projects/{projectId}'.
func (r *ProjectsScanConfigsService) Create(parent string, scanconfig *ScanConfig) *ProjectsScanConfigsCreateCall {
c := &ProjectsScanConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1314,9 +1314,9 @@ type ProjectsScanConfigsDeleteCall struct {
// Delete: Deletes an existing ScanConfig and its child resources.
//
-// - name: The resource name of the ScanConfig to be deleted. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be deleted. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Delete(name string) *ProjectsScanConfigsDeleteCall {
c := &ProjectsScanConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1449,9 +1449,9 @@ type ProjectsScanConfigsGetCall struct {
// Get: Gets a ScanConfig.
//
-// - name: The resource name of the ScanConfig to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Get(name string) *ProjectsScanConfigsGetCall {
c := &ProjectsScanConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1597,8 +1597,8 @@ type ProjectsScanConfigsListCall struct {
// List: Lists ScanConfigs under a given project.
//
-// - parent: The parent resource name, which should be a project
-// resource name in the format 'projects/{projectId}'.
+// - parent: The parent resource name, which should be a project
+// resource name in the format 'projects/{projectId}'.
func (r *ProjectsScanConfigsService) List(parent string) *ProjectsScanConfigsListCall {
c := &ProjectsScanConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1794,9 +1794,9 @@ type ProjectsScanConfigsPatchCall struct {
// Patch: Updates a ScanConfig. This method support partial update of a
// ScanConfig.
//
-// - name: The resource name of the ScanConfig. The name follows the
-// format of 'projects/{projectId}/scanConfigs/{scanConfigId}'. The
-// ScanConfig IDs are generated by the system.
+// - name: The resource name of the ScanConfig. The name follows the
+// format of 'projects/{projectId}/scanConfigs/{scanConfigId}'. The
+// ScanConfig IDs are generated by the system.
func (r *ProjectsScanConfigsService) Patch(name string, scanconfig *ScanConfig) *ProjectsScanConfigsPatchCall {
c := &ProjectsScanConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1953,9 +1953,9 @@ type ProjectsScanConfigsStartCall struct {
// Start: Start a ScanRun according to the given ScanConfig.
//
-// - name: The resource name of the ScanConfig to be used. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be used. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Start(name string, startscanrunrequest *StartScanRunRequest) *ProjectsScanConfigsStartCall {
c := &ProjectsScanConfigsStartCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2097,10 +2097,10 @@ type ProjectsScanConfigsScanRunsGetCall struct {
// Get: Gets a ScanRun.
//
-// - name: The resource name of the ScanRun to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - name: The resource name of the ScanRun to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsService) Get(name string) *ProjectsScanConfigsScanRunsGetCall {
c := &ProjectsScanConfigsScanRunsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2247,9 +2247,9 @@ type ProjectsScanConfigsScanRunsListCall struct {
// List: Lists ScanRuns under a given ScanConfig, in descending order of
// ScanRun stop time.
//
-// - parent: The parent resource name, which should be a scan resource
-// name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - parent: The parent resource name, which should be a scan resource
+// name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsScanRunsService) List(parent string) *ProjectsScanConfigsScanRunsListCall {
c := &ProjectsScanConfigsScanRunsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2444,10 +2444,10 @@ type ProjectsScanConfigsScanRunsStopCall struct {
// Stop: Stops a ScanRun. The stopped ScanRun is returned.
//
-// - name: The resource name of the ScanRun to be stopped. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - name: The resource name of the ScanRun to be stopped. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsService) Stop(name string, stopscanrunrequest *StopScanRunRequest) *ProjectsScanConfigsScanRunsStopCall {
c := &ProjectsScanConfigsScanRunsStopCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2589,10 +2589,10 @@ type ProjectsScanConfigsScanRunsCrawledUrlsListCall struct {
// List: List CrawledUrls under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsCrawledUrlsService) List(parent string) *ProjectsScanConfigsScanRunsCrawledUrlsListCall {
c := &ProjectsScanConfigsScanRunsCrawledUrlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2787,10 +2787,10 @@ type ProjectsScanConfigsScanRunsFindingTypeStatsListCall struct {
// List: List all FindingTypeStats under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsFindingTypeStatsService) List(parent string) *ProjectsScanConfigsScanRunsFindingTypeStatsListCall {
c := &ProjectsScanConfigsScanRunsFindingTypeStatsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2936,10 +2936,10 @@ type ProjectsScanConfigsScanRunsFindingsGetCall struct {
// Get: Gets a Finding.
//
-// - name: The resource name of the Finding to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }/findings/{findingId}'.
+// - name: The resource name of the Finding to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }/findings/{findingId}'.
func (r *ProjectsScanConfigsScanRunsFindingsService) Get(name string) *ProjectsScanConfigsScanRunsFindingsGetCall {
c := &ProjectsScanConfigsScanRunsFindingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3085,10 +3085,10 @@ type ProjectsScanConfigsScanRunsFindingsListCall struct {
// List: List Findings under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsFindingsService) List(parent string) *ProjectsScanConfigsScanRunsFindingsListCall {
c := &ProjectsScanConfigsScanRunsFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/websecurityscanner/v1beta/websecurityscanner-gen.go b/websecurityscanner/v1beta/websecurityscanner-gen.go
index c097ab681a8..44637da9376 100644
--- a/websecurityscanner/v1beta/websecurityscanner-gen.go
+++ b/websecurityscanner/v1beta/websecurityscanner-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/security-command-center/docs/concepts-web-security-scanner-overview/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/websecurityscanner/v1beta"
-// ...
-// ctx := context.Background()
-// websecurityscannerService, err := websecurityscanner.NewService(ctx)
+// import "google.golang.org/api/websecurityscanner/v1beta"
+// ...
+// ctx := context.Background()
+// websecurityscannerService, err := websecurityscanner.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithAPIKey("AIza..."))
+// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// websecurityscannerService, err := websecurityscanner.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package websecurityscanner // import "google.golang.org/api/websecurityscanner/v1beta"
@@ -1510,9 +1510,9 @@ type ProjectsScanConfigsCreateCall struct {
// Create: Creates a new ScanConfig.
//
-// - parent: The parent resource name where the scan is created, which
-// should be a project resource name in the format
-// 'projects/{projectId}'.
+// - parent: The parent resource name where the scan is created, which
+// should be a project resource name in the format
+// 'projects/{projectId}'.
func (r *ProjectsScanConfigsService) Create(parent string, scanconfig *ScanConfig) *ProjectsScanConfigsCreateCall {
c := &ProjectsScanConfigsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1653,9 +1653,9 @@ type ProjectsScanConfigsDeleteCall struct {
// Delete: Deletes an existing ScanConfig and its child resources.
//
-// - name: The resource name of the ScanConfig to be deleted. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be deleted. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Delete(name string) *ProjectsScanConfigsDeleteCall {
c := &ProjectsScanConfigsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1788,9 +1788,9 @@ type ProjectsScanConfigsGetCall struct {
// Get: Gets a ScanConfig.
//
-// - name: The resource name of the ScanConfig to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Get(name string) *ProjectsScanConfigsGetCall {
c := &ProjectsScanConfigsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1936,8 +1936,8 @@ type ProjectsScanConfigsListCall struct {
// List: Lists ScanConfigs under a given project.
//
-// - parent: The parent resource name, which should be a project
-// resource name in the format 'projects/{projectId}'.
+// - parent: The parent resource name, which should be a project
+// resource name in the format 'projects/{projectId}'.
func (r *ProjectsScanConfigsService) List(parent string) *ProjectsScanConfigsListCall {
c := &ProjectsScanConfigsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2133,9 +2133,9 @@ type ProjectsScanConfigsPatchCall struct {
// Patch: Updates a ScanConfig. This method support partial update of a
// ScanConfig.
//
-// - name: The resource name of the ScanConfig. The name follows the
-// format of 'projects/{projectId}/scanConfigs/{scanConfigId}'. The
-// ScanConfig IDs are generated by the system.
+// - name: The resource name of the ScanConfig. The name follows the
+// format of 'projects/{projectId}/scanConfigs/{scanConfigId}'. The
+// ScanConfig IDs are generated by the system.
func (r *ProjectsScanConfigsService) Patch(name string, scanconfig *ScanConfig) *ProjectsScanConfigsPatchCall {
c := &ProjectsScanConfigsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2292,9 +2292,9 @@ type ProjectsScanConfigsStartCall struct {
// Start: Start a ScanRun according to the given ScanConfig.
//
-// - name: The resource name of the ScanConfig to be used. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - name: The resource name of the ScanConfig to be used. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsService) Start(name string, startscanrunrequest *StartScanRunRequest) *ProjectsScanConfigsStartCall {
c := &ProjectsScanConfigsStartCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2436,10 +2436,10 @@ type ProjectsScanConfigsScanRunsGetCall struct {
// Get: Gets a ScanRun.
//
-// - name: The resource name of the ScanRun to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - name: The resource name of the ScanRun to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsService) Get(name string) *ProjectsScanConfigsScanRunsGetCall {
c := &ProjectsScanConfigsScanRunsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2586,9 +2586,9 @@ type ProjectsScanConfigsScanRunsListCall struct {
// List: Lists ScanRuns under a given ScanConfig, in descending order of
// ScanRun stop time.
//
-// - parent: The parent resource name, which should be a scan resource
-// name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+// - parent: The parent resource name, which should be a scan resource
+// name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}'.
func (r *ProjectsScanConfigsScanRunsService) List(parent string) *ProjectsScanConfigsScanRunsListCall {
c := &ProjectsScanConfigsScanRunsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2783,10 +2783,10 @@ type ProjectsScanConfigsScanRunsStopCall struct {
// Stop: Stops a ScanRun. The stopped ScanRun is returned.
//
-// - name: The resource name of the ScanRun to be stopped. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - name: The resource name of the ScanRun to be stopped. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsService) Stop(name string, stopscanrunrequest *StopScanRunRequest) *ProjectsScanConfigsScanRunsStopCall {
c := &ProjectsScanConfigsScanRunsStopCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -2928,10 +2928,10 @@ type ProjectsScanConfigsScanRunsCrawledUrlsListCall struct {
// List: List CrawledUrls under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsCrawledUrlsService) List(parent string) *ProjectsScanConfigsScanRunsCrawledUrlsListCall {
c := &ProjectsScanConfigsScanRunsCrawledUrlsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3126,10 +3126,10 @@ type ProjectsScanConfigsScanRunsFindingTypeStatsListCall struct {
// List: List all FindingTypeStats under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsFindingTypeStatsService) List(parent string) *ProjectsScanConfigsScanRunsFindingTypeStatsListCall {
c := &ProjectsScanConfigsScanRunsFindingTypeStatsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -3275,10 +3275,10 @@ type ProjectsScanConfigsScanRunsFindingsGetCall struct {
// Get: Gets a Finding.
//
-// - name: The resource name of the Finding to be returned. The name
-// follows the format of
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }/findings/{findingId}'.
+// - name: The resource name of the Finding to be returned. The name
+// follows the format of
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }/findings/{findingId}'.
func (r *ProjectsScanConfigsScanRunsFindingsService) Get(name string) *ProjectsScanConfigsScanRunsFindingsGetCall {
c := &ProjectsScanConfigsScanRunsFindingsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -3424,10 +3424,10 @@ type ProjectsScanConfigsScanRunsFindingsListCall struct {
// List: List Findings under a given ScanRun.
//
-// - parent: The parent resource name, which should be a scan run
-// resource name in the format
-// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
-// }'.
+// - parent: The parent resource name, which should be a scan run
+// resource name in the format
+// 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId
+// }'.
func (r *ProjectsScanConfigsScanRunsFindingsService) List(parent string) *ProjectsScanConfigsScanRunsFindingsListCall {
c := &ProjectsScanConfigsScanRunsFindingsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
diff --git a/workflowexecutions/v1/workflowexecutions-gen.go b/workflowexecutions/v1/workflowexecutions-gen.go
index d1481f6de2a..daaa6b83153 100644
--- a/workflowexecutions/v1/workflowexecutions-gen.go
+++ b/workflowexecutions/v1/workflowexecutions-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/workflows
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/workflowexecutions/v1"
-// ...
-// ctx := context.Background()
-// workflowexecutionsService, err := workflowexecutions.NewService(ctx)
+// import "google.golang.org/api/workflowexecutions/v1"
+// ...
+// ctx := context.Background()
+// workflowexecutionsService, err := workflowexecutions.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithAPIKey("AIza..."))
+// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package workflowexecutions // import "google.golang.org/api/workflowexecutions/v1"
@@ -561,9 +561,9 @@ type ProjectsLocationsWorkflowsTriggerPubsubExecutionCall struct {
// TriggerPubsubExecution: Triggers a new execution using the latest
// revision of the given workflow by a Pub/Sub push notification.
//
-// - workflow: Name of the workflow for which an execution should be
-// created. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - workflow: Name of the workflow for which an execution should be
+// created. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) TriggerPubsubExecution(workflow string, triggerpubsubexecutionrequest *TriggerPubsubExecutionRequest) *ProjectsLocationsWorkflowsTriggerPubsubExecutionCall {
c := &ProjectsLocationsWorkflowsTriggerPubsubExecutionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.workflow = workflow
@@ -705,9 +705,9 @@ type ProjectsLocationsWorkflowsExecutionsCancelCall struct {
// Cancel: Cancels an execution of the given name.
//
-// - name: Name of the execution to be cancelled. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}/executi
-// ons/{execution}.
+// - name: Name of the execution to be cancelled. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}/executi
+// ons/{execution}.
func (r *ProjectsLocationsWorkflowsExecutionsService) Cancel(name string, cancelexecutionrequest *CancelExecutionRequest) *ProjectsLocationsWorkflowsExecutionsCancelCall {
c := &ProjectsLocationsWorkflowsExecutionsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -850,10 +850,10 @@ type ProjectsLocationsWorkflowsExecutionsCreateCall struct {
// Create: Creates a new execution using the latest revision of the
// given workflow.
//
-// - parent: Name of the workflow for which an execution should be
-// created. Format:
-// projects/{project}/locations/{location}/workflows/{workflow} The
-// latest revision of the workflow will be used.
+// - parent: Name of the workflow for which an execution should be
+// created. Format:
+// projects/{project}/locations/{location}/workflows/{workflow} The
+// latest revision of the workflow will be used.
func (r *ProjectsLocationsWorkflowsExecutionsService) Create(parent string, execution *Execution) *ProjectsLocationsWorkflowsExecutionsCreateCall {
c := &ProjectsLocationsWorkflowsExecutionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -995,9 +995,9 @@ type ProjectsLocationsWorkflowsExecutionsGetCall struct {
// Get: Returns an execution of the given name.
//
-// - name: Name of the execution to be retrieved. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}/executi
-// ons/{execution}.
+// - name: Name of the execution to be retrieved. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}/executi
+// ons/{execution}.
func (r *ProjectsLocationsWorkflowsExecutionsService) Get(name string) *ProjectsLocationsWorkflowsExecutionsGetCall {
c := &ProjectsLocationsWorkflowsExecutionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1009,11 +1009,14 @@ func (r *ProjectsLocationsWorkflowsExecutionsService) Get(name string) *Projects
// the FULL view.
//
// Possible values:
-// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
-// "BASIC" - Includes only basic metadata about the execution.
+//
+// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
+// "BASIC" - Includes only basic metadata about the execution.
+//
// Following fields are returned: name, start_time, end_time, state and
// workflow_revision_id.
-// "FULL" - Includes all data.
+//
+// "FULL" - Includes all data.
func (c *ProjectsLocationsWorkflowsExecutionsGetCall) View(view string) *ProjectsLocationsWorkflowsExecutionsGetCall {
c.urlParams_.Set("view", view)
return c
@@ -1176,9 +1179,9 @@ type ProjectsLocationsWorkflowsExecutionsListCall struct {
// revisions. Returned executions are ordered by their start time
// (newest first).
//
-// - parent: Name of the workflow for which the executions should be
-// listed. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - parent: Name of the workflow for which the executions should be
+// listed. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsExecutionsService) List(parent string) *ProjectsLocationsWorkflowsExecutionsListCall {
c := &ProjectsLocationsWorkflowsExecutionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1211,11 +1214,14 @@ func (c *ProjectsLocationsWorkflowsExecutionsListCall) PageToken(pageToken strin
// the BASIC view.
//
// Possible values:
-// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
-// "BASIC" - Includes only basic metadata about the execution.
+//
+// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
+// "BASIC" - Includes only basic metadata about the execution.
+//
// Following fields are returned: name, start_time, end_time, state and
// workflow_revision_id.
-// "FULL" - Includes all data.
+//
+// "FULL" - Includes all data.
func (c *ProjectsLocationsWorkflowsExecutionsListCall) View(view string) *ProjectsLocationsWorkflowsExecutionsListCall {
c.urlParams_.Set("view", view)
return c
diff --git a/workflowexecutions/v1beta/workflowexecutions-gen.go b/workflowexecutions/v1beta/workflowexecutions-gen.go
index 48a9f069710..d8056aab70a 100644
--- a/workflowexecutions/v1beta/workflowexecutions-gen.go
+++ b/workflowexecutions/v1beta/workflowexecutions-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/workflows
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/workflowexecutions/v1beta"
-// ...
-// ctx := context.Background()
-// workflowexecutionsService, err := workflowexecutions.NewService(ctx)
+// import "google.golang.org/api/workflowexecutions/v1beta"
+// ...
+// ctx := context.Background()
+// workflowexecutionsService, err := workflowexecutions.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithAPIKey("AIza..."))
+// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// workflowexecutionsService, err := workflowexecutions.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package workflowexecutions // import "google.golang.org/api/workflowexecutions/v1beta"
@@ -457,9 +457,9 @@ type ProjectsLocationsWorkflowsExecutionsCancelCall struct {
// Cancel: Cancels an execution of the given name.
//
-// - name: Name of the execution to be cancelled. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}/executi
-// ons/{execution}.
+// - name: Name of the execution to be cancelled. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}/executi
+// ons/{execution}.
func (r *ProjectsLocationsWorkflowsExecutionsService) Cancel(name string, cancelexecutionrequest *CancelExecutionRequest) *ProjectsLocationsWorkflowsExecutionsCancelCall {
c := &ProjectsLocationsWorkflowsExecutionsCancelCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -602,10 +602,10 @@ type ProjectsLocationsWorkflowsExecutionsCreateCall struct {
// Create: Creates a new execution using the latest revision of the
// given workflow.
//
-// - parent: Name of the workflow for which an execution should be
-// created. Format:
-// projects/{project}/locations/{location}/workflows/{workflow} The
-// latest revision of the workflow will be used.
+// - parent: Name of the workflow for which an execution should be
+// created. Format:
+// projects/{project}/locations/{location}/workflows/{workflow} The
+// latest revision of the workflow will be used.
func (r *ProjectsLocationsWorkflowsExecutionsService) Create(parent string, execution *Execution) *ProjectsLocationsWorkflowsExecutionsCreateCall {
c := &ProjectsLocationsWorkflowsExecutionsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -747,9 +747,9 @@ type ProjectsLocationsWorkflowsExecutionsGetCall struct {
// Get: Returns an execution of the given name.
//
-// - name: Name of the execution to be retrieved. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}/executi
-// ons/{execution}.
+// - name: Name of the execution to be retrieved. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}/executi
+// ons/{execution}.
func (r *ProjectsLocationsWorkflowsExecutionsService) Get(name string) *ProjectsLocationsWorkflowsExecutionsGetCall {
c := &ProjectsLocationsWorkflowsExecutionsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -761,11 +761,14 @@ func (r *ProjectsLocationsWorkflowsExecutionsService) Get(name string) *Projects
// the FULL view.
//
// Possible values:
-// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
-// "BASIC" - Includes only basic metadata about the execution.
+//
+// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
+// "BASIC" - Includes only basic metadata about the execution.
+//
// Following fields are returned: name, start_time, end_time, state and
// workflow_revision_id.
-// "FULL" - Includes all data.
+//
+// "FULL" - Includes all data.
func (c *ProjectsLocationsWorkflowsExecutionsGetCall) View(view string) *ProjectsLocationsWorkflowsExecutionsGetCall {
c.urlParams_.Set("view", view)
return c
@@ -928,9 +931,9 @@ type ProjectsLocationsWorkflowsExecutionsListCall struct {
// revisions. Returned executions are ordered by their start time
// (newest first).
//
-// - parent: Name of the workflow for which the executions should be
-// listed. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - parent: Name of the workflow for which the executions should be
+// listed. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsExecutionsService) List(parent string) *ProjectsLocationsWorkflowsExecutionsListCall {
c := &ProjectsLocationsWorkflowsExecutionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -963,11 +966,14 @@ func (c *ProjectsLocationsWorkflowsExecutionsListCall) PageToken(pageToken strin
// the BASIC view.
//
// Possible values:
-// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
-// "BASIC" - Includes only basic metadata about the execution.
+//
+// "EXECUTION_VIEW_UNSPECIFIED" - The default / unset value.
+// "BASIC" - Includes only basic metadata about the execution.
+//
// Following fields are returned: name, start_time, end_time, state and
// workflow_revision_id.
-// "FULL" - Includes all data.
+//
+// "FULL" - Includes all data.
func (c *ProjectsLocationsWorkflowsExecutionsListCall) View(view string) *ProjectsLocationsWorkflowsExecutionsListCall {
c.urlParams_.Set("view", view)
return c
diff --git a/workflows/v1/workflows-gen.go b/workflows/v1/workflows-gen.go
index d19d6f8a7ce..abd5923deab 100644
--- a/workflows/v1/workflows-gen.go
+++ b/workflows/v1/workflows-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/workflows
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/workflows/v1"
-// ...
-// ctx := context.Background()
-// workflowsService, err := workflows.NewService(ctx)
+// import "google.golang.org/api/workflows/v1"
+// ...
+// ctx := context.Background()
+// workflowsService, err := workflows.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// workflowsService, err := workflows.NewService(ctx, option.WithAPIKey("AIza..."))
+// workflowsService, err := workflows.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// workflowsService, err := workflows.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// workflowsService, err := workflows.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package workflows // import "google.golang.org/api/workflows/v1"
@@ -751,8 +751,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1457,8 +1457,8 @@ type ProjectsLocationsWorkflowsCreateCall struct {
// already exists in the specified project and location, the long
// running operation will return ALREADY_EXISTS error.
//
-// - parent: Project and location in which the workflow should be
-// created. Format: projects/{project}/locations/{location}.
+// - parent: Project and location in which the workflow should be
+// created. Format: projects/{project}/locations/{location}.
func (r *ProjectsLocationsWorkflowsService) Create(parent string, workflow *Workflow) *ProjectsLocationsWorkflowsCreateCall {
c := &ProjectsLocationsWorkflowsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1616,8 +1616,8 @@ type ProjectsLocationsWorkflowsDeleteCall struct {
// Delete: Deletes a workflow with the specified name. This method also
// cancels and deletes all running executions of the workflow.
//
-// - name: Name of the workflow to be deleted. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - name: Name of the workflow to be deleted. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) Delete(name string) *ProjectsLocationsWorkflowsDeleteCall {
c := &ProjectsLocationsWorkflowsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1750,9 +1750,9 @@ type ProjectsLocationsWorkflowsGetCall struct {
// Get: Gets details of a single Workflow.
//
-// - name: Name of the workflow which information should be retrieved.
-// Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - name: Name of the workflow which information should be retrieved.
+// Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) Get(name string) *ProjectsLocationsWorkflowsGetCall {
c := &ProjectsLocationsWorkflowsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1899,8 +1899,8 @@ type ProjectsLocationsWorkflowsListCall struct {
// List: Lists Workflows in a given project and location. The default
// order is not specified.
//
-// - parent: Project and location from which the workflows should be
-// listed. Format: projects/{project}/locations/{location}.
+// - parent: Project and location from which the workflows should be
+// listed. Format: projects/{project}/locations/{location}.
func (r *ProjectsLocationsWorkflowsService) List(parent string) *ProjectsLocationsWorkflowsListCall {
c := &ProjectsLocationsWorkflowsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2129,8 +2129,8 @@ type ProjectsLocationsWorkflowsPatchCall struct {
// operation. In that case, such revision will be used in new workflow
// executions.
//
-// - name: The resource name of the workflow. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - name: The resource name of the workflow. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) Patch(name string, workflow *Workflow) *ProjectsLocationsWorkflowsPatchCall {
c := &ProjectsLocationsWorkflowsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/workflows/v1beta/workflows-gen.go b/workflows/v1beta/workflows-gen.go
index 21223a777df..150b3f910e6 100644
--- a/workflows/v1beta/workflows-gen.go
+++ b/workflows/v1beta/workflows-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://cloud.google.com/workflows
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/workflows/v1beta"
-// ...
-// ctx := context.Background()
-// workflowsService, err := workflows.NewService(ctx)
+// import "google.golang.org/api/workflows/v1beta"
+// ...
+// ctx := context.Background()
+// workflowsService, err := workflows.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// workflowsService, err := workflows.NewService(ctx, option.WithAPIKey("AIza..."))
+// workflowsService, err := workflows.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// workflowsService, err := workflows.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// workflowsService, err := workflows.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package workflows // import "google.golang.org/api/workflows/v1beta"
@@ -751,8 +751,8 @@ type ProjectsLocationsListCall struct {
// List: Lists information about the supported locations for this
// service.
//
-// - name: The resource that owns the locations collection, if
-// applicable.
+// - name: The resource that owns the locations collection, if
+// applicable.
func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1457,8 +1457,8 @@ type ProjectsLocationsWorkflowsCreateCall struct {
// already exists in the specified project and location, the long
// running operation will return ALREADY_EXISTS error.
//
-// - parent: Project and location in which the workflow should be
-// created. Format: projects/{project}/locations/{location}.
+// - parent: Project and location in which the workflow should be
+// created. Format: projects/{project}/locations/{location}.
func (r *ProjectsLocationsWorkflowsService) Create(parent string, workflow *Workflow) *ProjectsLocationsWorkflowsCreateCall {
c := &ProjectsLocationsWorkflowsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -1616,8 +1616,8 @@ type ProjectsLocationsWorkflowsDeleteCall struct {
// Delete: Deletes a workflow with the specified name. This method also
// cancels and deletes all running executions of the workflow.
//
-// - name: Name of the workflow to be deleted. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - name: Name of the workflow to be deleted. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) Delete(name string) *ProjectsLocationsWorkflowsDeleteCall {
c := &ProjectsLocationsWorkflowsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1750,9 +1750,9 @@ type ProjectsLocationsWorkflowsGetCall struct {
// Get: Gets details of a single Workflow.
//
-// - name: Name of the workflow which information should be retrieved.
-// Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - name: Name of the workflow which information should be retrieved.
+// Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) Get(name string) *ProjectsLocationsWorkflowsGetCall {
c := &ProjectsLocationsWorkflowsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
@@ -1899,8 +1899,8 @@ type ProjectsLocationsWorkflowsListCall struct {
// List: Lists Workflows in a given project and location. The default
// order is not specified.
//
-// - parent: Project and location from which the workflows should be
-// listed. Format: projects/{project}/locations/{location}.
+// - parent: Project and location from which the workflows should be
+// listed. Format: projects/{project}/locations/{location}.
func (r *ProjectsLocationsWorkflowsService) List(parent string) *ProjectsLocationsWorkflowsListCall {
c := &ProjectsLocationsWorkflowsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.parent = parent
@@ -2129,8 +2129,8 @@ type ProjectsLocationsWorkflowsPatchCall struct {
// operation. In that case, such revision will be used in new workflow
// executions.
//
-// - name: The resource name of the workflow. Format:
-// projects/{project}/locations/{location}/workflows/{workflow}.
+// - name: The resource name of the workflow. Format:
+// projects/{project}/locations/{location}/workflows/{workflow}.
func (r *ProjectsLocationsWorkflowsService) Patch(name string, workflow *Workflow) *ProjectsLocationsWorkflowsPatchCall {
c := &ProjectsLocationsWorkflowsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.name = name
diff --git a/youtube/v3/youtube-gen.go b/youtube/v3/youtube-gen.go
index a4f6b0d8e91..056f67305bd 100644
--- a/youtube/v3/youtube-gen.go
+++ b/youtube/v3/youtube-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/youtube/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/youtube/v3"
-// ...
-// ctx := context.Background()
-// youtubeService, err := youtube.NewService(ctx)
+// import "google.golang.org/api/youtube/v3"
+// ...
+// ctx := context.Background()
+// youtubeService, err := youtube.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// youtubeService, err := youtube.NewService(ctx, option.WithScopes(youtube.YoutubepartnerChannelAuditScope))
+// youtubeService, err := youtube.NewService(ctx, option.WithScopes(youtube.YoutubepartnerChannelAuditScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// youtubeService, err := youtube.NewService(ctx, option.WithAPIKey("AIza..."))
+// youtubeService, err := youtube.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// youtubeService, err := youtube.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// youtubeService, err := youtube.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package youtube // import "google.golang.org/api/youtube/v3"
@@ -10409,9 +10409,9 @@ type AbuseReportsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include.
func (r *AbuseReportsService) Insert(part []string, abusereport *AbuseReport) *AbuseReportsInsertCall {
c := &AbuseReportsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -10550,14 +10550,14 @@ type ActivitiesListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more activity resource properties that the API response will
-// include. If the parameter identifies a property that contains child
-// properties, the child properties will be included in the response.
-// For example, in an activity resource, the snippet property contains
-// other properties that identify the type of activity, a display
-// title for the activity, and so forth. If you set *part=snippet*,
-// the API response will also contain all of those nested properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more activity resource properties that the API response will
+// include. If the parameter identifies a property that contains child
+// properties, the child properties will be included in the response.
+// For example, in an activity resource, the snippet property contains
+// other properties that identify the type of activity, a display
+// title for the activity, and so forth. If you set *part=snippet*,
+// the API response will also contain all of those nested properties.
func (r *ActivitiesService) List(part []string) *ActivitiesListCall {
c := &ActivitiesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -10950,8 +10950,8 @@ type CaptionsDownloadCall struct {
// Download: Downloads a caption track.
//
-// - id: The ID of the caption track to download, required for One
-// Platform.
+// - id: The ID of the caption track to download, required for One
+// Platform.
func (r *CaptionsService) Download(id string) *CaptionsDownloadCall {
c := &CaptionsDownloadCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.id = id
@@ -11146,9 +11146,9 @@ type CaptionsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter specifies the caption resource parts
-// that the API response will include. Set the parameter value to
-// snippet.
+// - part: The *part* parameter specifies the caption resource parts
+// that the API response will include. Set the parameter value to
+// snippet.
func (r *CaptionsService) Insert(part []string, caption *Caption) *CaptionsInsertCall {
c := &CaptionsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -11420,11 +11420,11 @@ type CaptionsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more caption resource parts that the API response will include.
-// The part names that you can include in the parameter value are id
-// and snippet.
-// - videoId: Returns the captions for the specified video.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more caption resource parts that the API response will include.
+// The part names that you can include in the parameter value are id
+// and snippet.
+// - videoId: Returns the captions for the specified video.
func (r *CaptionsService) List(part []string, videoId string) *CaptionsListCall {
c := &CaptionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -11624,10 +11624,10 @@ type CaptionsUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more caption resource parts that the API response will include.
-// The part names that you can include in the parameter value are id
-// and snippet.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more caption resource parts that the API response will include.
+// The part names that you can include in the parameter value are id
+// and snippet.
func (r *CaptionsService) Update(part []string, caption *Caption) *CaptionsUpdateCall {
c := &CaptionsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -12300,11 +12300,11 @@ type ChannelSectionsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The part
-// names that you can include in the parameter value are snippet and
-// contentDetails.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The part
+// names that you can include in the parameter value are snippet and
+// contentDetails.
func (r *ChannelSectionsService) Insert(part []string, channelsection *ChannelSection) *ChannelSectionsInsertCall {
c := &ChannelSectionsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -12495,16 +12495,16 @@ type ChannelSectionsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more channelSection resource properties that the API response
-// will include. The part names that you can include in the parameter
-// value are id, snippet, and contentDetails. If the parameter
-// identifies a property that contains child properties, the child
-// properties will be included in the response. For example, in a
-// channelSection resource, the snippet property contains other
-// properties, such as a display title for the channelSection. If you
-// set *part=snippet*, the API response will also contain all of those
-// nested properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more channelSection resource properties that the API response
+// will include. The part names that you can include in the parameter
+// value are id, snippet, and contentDetails. If the parameter
+// identifies a property that contains child properties, the child
+// properties will be included in the response. For example, in a
+// channelSection resource, the snippet property contains other
+// properties, such as a display title for the channelSection. If you
+// set *part=snippet*, the API response will also contain all of those
+// nested properties.
func (r *ChannelSectionsService) List(part []string) *ChannelSectionsListCall {
c := &ChannelSectionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -12720,11 +12720,11 @@ type ChannelSectionsUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The part
-// names that you can include in the parameter value are snippet and
-// contentDetails.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The part
+// names that you can include in the parameter value are snippet and
+// contentDetails.
func (r *ChannelSectionsService) Update(part []string, channelsection *ChannelSection) *ChannelSectionsUpdateCall {
c := &ChannelSectionsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -12886,14 +12886,14 @@ type ChannelsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more channel resource properties that the API response will
-// include. If the parameter identifies a property that contains child
-// properties, the child properties will be included in the response.
-// For example, in a channel resource, the contentDetails property
-// contains other properties, such as the uploads properties. As such,
-// if you set *part=contentDetails*, the API response will also
-// contain all of those nested properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more channel resource properties that the API response will
+// include. If the parameter identifies a property that contains child
+// properties, the child properties will be included in the response.
+// For example, in a channel resource, the contentDetails property
+// contains other properties, such as the uploads properties. As such,
+// if you set *part=contentDetails*, the API response will also
+// contain all of those nested properties.
func (r *ChannelsService) List(part []string) *ChannelsListCall {
c := &ChannelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -13202,14 +13202,14 @@ type ChannelsUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The API
-// currently only allows the parameter value to be set to either
-// brandingSettings or invideoPromotion. (You cannot update both of
-// those parts with a single request.) Note that this method overrides
-// the existing values for all of the mutable properties that are
-// contained in any parts that the parameter value specifies.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The API
+// currently only allows the parameter value to be set to either
+// brandingSettings or invideoPromotion. (You cannot update both of
+// those parts with a single request.) Note that this method overrides
+// the existing values for all of the mutable properties that are
+// contained in any parts that the parameter value specifies.
func (r *ChannelsService) Update(part []string, channel *Channel) *ChannelsUpdateCall {
c := &ChannelsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -13369,9 +13369,9 @@ type CommentThreadsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter identifies the properties that the API
-// response will include. Set the parameter value to snippet. The
-// snippet part has a quota cost of 2 units.
+// - part: The *part* parameter identifies the properties that the API
+// response will include. Set the parameter value to snippet. The
+// snippet part has a quota cost of 2 units.
func (r *CommentThreadsService) Insert(part []string, commentthread *CommentThread) *CommentThreadsInsertCall {
c := &CommentThreadsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -13509,9 +13509,9 @@ type CommentThreadsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more commentThread resource properties that the API response
-// will include.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more commentThread resource properties that the API response
+// will include.
func (r *CommentThreadsService) List(part []string) *CommentThreadsListCall {
c := &CommentThreadsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -13555,11 +13555,14 @@ func (c *CommentThreadsListCall) MaxResults(maxResults int64) *CommentThreadsLis
// published, heldForReview, likelySpam.
//
// Possible values:
-// "published" (default) - The comment is available for public
+//
+// "published" (default) - The comment is available for public
+//
// display.
-// "heldForReview" - The comment is awaiting review by a moderator.
-// "likelySpam"
-// "rejected" - The comment is unfit for display.
+//
+// "heldForReview" - The comment is awaiting review by a moderator.
+// "likelySpam"
+// "rejected" - The comment is unfit for display.
func (c *CommentThreadsListCall) ModerationStatus(moderationStatus string) *CommentThreadsListCall {
c.urlParams_.Set("moderationStatus", moderationStatus)
return c
@@ -13568,9 +13571,10 @@ func (c *CommentThreadsListCall) ModerationStatus(moderationStatus string) *Comm
// Order sets the optional parameter "order":
//
// Possible values:
-// "orderUnspecified"
-// "time" (default) - Order by time.
-// "relevance" - Order by relevance.
+//
+// "orderUnspecified"
+// "time" (default) - Order by time.
+// "relevance" - Order by relevance.
func (c *CommentThreadsListCall) Order(order string) *CommentThreadsListCall {
c.urlParams_.Set("order", order)
return c
@@ -13597,10 +13601,13 @@ func (c *CommentThreadsListCall) SearchTerms(searchTerms string) *CommentThreads
// text format for the returned comments.
//
// Possible values:
-// "textFormatUnspecified"
-// "html" (default) - Returns the comments in HTML format. This is the
+//
+// "textFormatUnspecified"
+// "html" (default) - Returns the comments in HTML format. This is the
+//
// default value.
-// "plainText" - Returns the comments in plain text format.
+//
+// "plainText" - Returns the comments in plain text format.
func (c *CommentThreadsListCall) TextFormat(textFormat string) *CommentThreadsListCall {
c.urlParams_.Set("textFormat", textFormat)
return c
@@ -13956,9 +13963,9 @@ type CommentsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter identifies the properties that the API
-// response will include. Set the parameter value to snippet. The
-// snippet part has a quota cost of 2 units.
+// - part: The *part* parameter identifies the properties that the API
+// response will include. Set the parameter value to snippet. The
+// snippet part has a quota cost of 2 units.
func (r *CommentsService) Insert(part []string, comment *Comment) *CommentsInsertCall {
c := &CommentsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -14096,9 +14103,9 @@ type CommentsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more comment resource properties that the API response will
-// include.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more comment resource properties that the API response will
+// include.
func (r *CommentsService) List(part []string) *CommentsListCall {
c := &CommentsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -14142,10 +14149,13 @@ func (c *CommentsListCall) ParentId(parentId string) *CommentsListCall {
// text format for the returned comments.
//
// Possible values:
-// "textFormatUnspecified"
-// "html" (default) - Returns the comments in HTML format. This is the
+//
+// "textFormatUnspecified"
+// "html" (default) - Returns the comments in HTML format. This is the
+//
// default value.
-// "plainText" - Returns the comments in plain text format.
+//
+// "plainText" - Returns the comments in plain text format.
func (c *CommentsListCall) TextFormat(textFormat string) *CommentsListCall {
c.urlParams_.Set("textFormat", textFormat)
return c
@@ -14348,8 +14358,8 @@ type CommentsMarkAsSpamCall struct {
// MarkAsSpam: Expresses the caller's opinion that one or more comments
// should be flagged as spam.
//
-// - id: Flags the comments with the given IDs as spam in the caller's
-// opinion.
+// - id: Flags the comments with the given IDs as spam in the caller's
+// opinion.
func (r *CommentsService) MarkAsSpam(id []string) *CommentsMarkAsSpamCall {
c := &CommentsMarkAsSpamCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("id", append([]string{}, id...))
@@ -14450,13 +14460,13 @@ type CommentsSetModerationStatusCall struct {
// SetModerationStatus: Sets the moderation status of one or more
// comments.
//
-// - id: Modifies the moderation status of the comments with the given
-// IDs.
-// - moderationStatus: Specifies the requested moderation status. Note,
-// comments can be in statuses, which are not available through this
-// call. For example, this call does not allow to mark a comment as
-// 'likely spam'. Valid values: MODERATION_STATUS_PUBLISHED,
-// MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.
+// - id: Modifies the moderation status of the comments with the given
+// IDs.
+// - moderationStatus: Specifies the requested moderation status. Note,
+// comments can be in statuses, which are not available through this
+// call. For example, this call does not allow to mark a comment as
+// 'likely spam'. Valid values: MODERATION_STATUS_PUBLISHED,
+// MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.
func (r *CommentsService) SetModerationStatus(id []string, moderationStatus string) *CommentsSetModerationStatusCall {
c := &CommentsSetModerationStatusCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("id", append([]string{}, id...))
@@ -14592,10 +14602,10 @@ type CommentsUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter identifies the properties that the API
-// response will include. You must at least include the snippet part
-// in the parameter value since that part contains all of the
-// properties that the API request can update.
+// - part: The *part* parameter identifies the properties that the API
+// response will include. You must at least include the snippet part
+// in the parameter value since that part contains all of the
+// properties that the API request can update.
func (r *CommentsService) Update(part []string, comment *Comment) *CommentsUpdateCall {
c := &CommentsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -14733,9 +14743,9 @@ type I18nLanguagesListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies the i18nLanguage resource
-// properties that the API response will include. Set the parameter
-// value to snippet.
+// - part: The *part* parameter specifies the i18nLanguage resource
+// properties that the API response will include. Set the parameter
+// value to snippet.
func (r *I18nLanguagesService) List(part []string) *I18nLanguagesListCall {
c := &I18nLanguagesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -14891,9 +14901,9 @@ type I18nRegionsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies the i18nRegion resource
-// properties that the API response will include. Set the parameter
-// value to snippet.
+// - part: The *part* parameter specifies the i18nRegion resource
+// properties that the API response will include. Set the parameter
+// value to snippet.
func (r *I18nRegionsService) List(part []string) *I18nRegionsListCall {
c := &I18nRegionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -15048,11 +15058,11 @@ type LiveBroadcastsBindCall struct {
// Bind: Bind a broadcast to a stream.
//
-// - id: Broadcast to bind to the stream.
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more liveBroadcast resource properties that the API response
-// will include. The part names that you can include in the parameter
-// value are id, snippet, contentDetails, and status.
+// - id: Broadcast to bind to the stream.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more liveBroadcast resource properties that the API response
+// will include. The part names that you can include in the parameter
+// value are id, snippet, contentDetails, and status.
func (r *LiveBroadcastsService) Bind(id string, part []string) *LiveBroadcastsBindCall {
c := &LiveBroadcastsBindCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("id", id)
@@ -15404,11 +15414,11 @@ type LiveBroadcastsInsertCall struct {
// Insert: Inserts a new stream for the authenticated user.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The part
-// properties that you can include in the parameter value are id,
-// snippet, contentDetails, and status.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The part
+// properties that you can include in the parameter value are id,
+// snippet, contentDetails, and status.
func (r *LiveBroadcastsService) Insert(part []string, livebroadcast *LiveBroadcast) *LiveBroadcastsInsertCall {
c := &LiveBroadcastsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -15804,10 +15814,10 @@ type LiveBroadcastsListCall struct {
// List: Retrieve the list of broadcasts associated with the given
// channel.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more liveBroadcast resource properties that the API response
-// will include. The part names that you can include in the parameter
-// value are id, snippet, contentDetails, status and statistics.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more liveBroadcast resource properties that the API response
+// will include. The part names that you can include in the parameter
+// value are id, snippet, contentDetails, status and statistics.
func (r *LiveBroadcastsService) List(part []string) *LiveBroadcastsListCall {
c := &LiveBroadcastsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -15818,11 +15828,12 @@ func (r *LiveBroadcastsService) List(part []string) *LiveBroadcastsListCall {
// broadcasts with a certain status, e.g. active broadcasts.
//
// Possible values:
-// "broadcastStatusFilterUnspecified"
-// "all" - Return all broadcasts.
-// "active" - Return current live broadcasts.
-// "upcoming" - Return broadcasts that have not yet started.
-// "completed" - Return broadcasts that have already ended.
+//
+// "broadcastStatusFilterUnspecified"
+// "all" - Return all broadcasts.
+// "active" - Return current live broadcasts.
+// "upcoming" - Return broadcasts that have not yet started.
+// "completed" - Return broadcasts that have already ended.
func (c *LiveBroadcastsListCall) BroadcastStatus(broadcastStatus string) *LiveBroadcastsListCall {
c.urlParams_.Set("broadcastStatus", broadcastStatus)
return c
@@ -15832,10 +15843,11 @@ func (c *LiveBroadcastsListCall) BroadcastStatus(broadcastStatus string) *LiveBr
// only broadcasts with the selected type.
//
// Possible values:
-// "broadcastTypeFilterUnspecified"
-// "all" - Return all broadcasts.
-// "event" (default) - Return only scheduled event broadcasts.
-// "persistent" - Return only persistent broadcasts.
+//
+// "broadcastTypeFilterUnspecified"
+// "all" - Return all broadcasts.
+// "event" (default) - Return only scheduled event broadcasts.
+// "persistent" - Return only persistent broadcasts.
func (c *LiveBroadcastsListCall) BroadcastType(broadcastType string) *LiveBroadcastsListCall {
c.urlParams_.Set("broadcastType", broadcastType)
return c
@@ -16140,13 +16152,13 @@ type LiveBroadcastsTransitionCall struct {
// Transition: Transition a broadcast to a given status.
//
-// - broadcastStatus: The status to which the broadcast is going to
-// transition.
-// - id: Broadcast to transition.
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more liveBroadcast resource properties that the API response
-// will include. The part names that you can include in the parameter
-// value are id, snippet, contentDetails, and status.
+// - broadcastStatus: The status to which the broadcast is going to
+// transition.
+// - id: Broadcast to transition.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more liveBroadcast resource properties that the API response
+// will include. The part names that you can include in the parameter
+// value are id, snippet, contentDetails, and status.
func (r *LiveBroadcastsService) Transition(broadcastStatus string, id string, part []string) *LiveBroadcastsTransitionCall {
c := &LiveBroadcastsTransitionCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("broadcastStatus", broadcastStatus)
@@ -16355,20 +16367,20 @@ type LiveBroadcastsUpdateCall struct {
// Update: Updates an existing broadcast for the authenticated user.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The part
-// properties that you can include in the parameter value are id,
-// snippet, contentDetails, and status. Note that this method will
-// override the existing values for all of the mutable properties that
-// are contained in any parts that the parameter value specifies. For
-// example, a broadcast's privacy status is defined in the status
-// part. As such, if your request is updating a private or unlisted
-// broadcast, and the request's part parameter value includes the
-// status part, the broadcast's privacy setting will be updated to
-// whatever value the request body specifies. If the request body does
-// not specify a value, the existing privacy setting will be removed
-// and the broadcast will revert to the default privacy setting.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The part
+// properties that you can include in the parameter value are id,
+// snippet, contentDetails, and status. Note that this method will
+// override the existing values for all of the mutable properties that
+// are contained in any parts that the parameter value specifies. For
+// example, a broadcast's privacy status is defined in the status
+// part. As such, if your request is updating a private or unlisted
+// broadcast, and the request's part parameter value includes the
+// status part, the broadcast's privacy setting will be updated to
+// whatever value the request body specifies. If the request body does
+// not specify a value, the existing privacy setting will be removed
+// and the broadcast will revert to the default privacy setting.
func (r *LiveBroadcastsService) Update(part []string, livebroadcast *LiveBroadcast) *LiveBroadcastsUpdateCall {
c := &LiveBroadcastsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -16657,10 +16669,10 @@ type LiveChatBansInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response returns. Set the
-// parameter value to snippet.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response returns. Set the
+// parameter value to snippet.
func (r *LiveChatBansService) Insert(part []string, livechatban *LiveChatBan) *LiveChatBansInsertCall {
c := &LiveChatBansInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -16898,10 +16910,10 @@ type LiveChatMessagesInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes. It identifies the
-// properties that the write operation will set as well as the
-// properties that the API response will include. Set the parameter
-// value to snippet.
+// - part: The *part* parameter serves two purposes. It identifies the
+// properties that the write operation will set as well as the
+// properties that the API response will include. Set the parameter
+// value to snippet.
func (r *LiveChatMessagesService) Insert(part []string, livechatmessage *LiveChatMessage) *LiveChatMessagesInsertCall {
c := &LiveChatMessagesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -17040,11 +17052,11 @@ type LiveChatMessagesListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - liveChatId: The id of the live chat for which comments should be
-// returned.
-// - part: The *part* parameter specifies the liveChatComment resource
-// parts that the API response will include. Supported values are id
-// and snippet.
+// - liveChatId: The id of the live chat for which comments should be
+// returned.
+// - part: The *part* parameter specifies the liveChatComment resource
+// parts that the API response will include. Supported values are id
+// and snippet.
func (r *LiveChatMessagesService) List(liveChatId string, part []string) *LiveChatMessagesListCall {
c := &LiveChatMessagesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("liveChatId", liveChatId)
@@ -17375,10 +17387,10 @@ type LiveChatModeratorsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response returns. Set the
-// parameter value to snippet.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response returns. Set the
+// parameter value to snippet.
func (r *LiveChatModeratorsService) Insert(part []string, livechatmoderator *LiveChatModerator) *LiveChatModeratorsInsertCall {
c := &LiveChatModeratorsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -17517,11 +17529,11 @@ type LiveChatModeratorsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - liveChatId: The id of the live chat for which moderators should be
-// returned.
-// - part: The *part* parameter specifies the liveChatModerator resource
-// parts that the API response will include. Supported values are id
-// and snippet.
+// - liveChatId: The id of the live chat for which moderators should be
+// returned.
+// - part: The *part* parameter specifies the liveChatModerator resource
+// parts that the API response will include. Supported values are id
+// and snippet.
func (r *LiveChatModeratorsService) List(liveChatId string, part []string) *LiveChatModeratorsListCall {
c := &LiveChatModeratorsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("liveChatId", liveChatId)
@@ -17875,11 +17887,11 @@ type LiveStreamsInsertCall struct {
// Insert: Inserts a new stream for the authenticated user.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The part
-// properties that you can include in the parameter value are id,
-// snippet, cdn, content_details, and status.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The part
+// properties that you can include in the parameter value are id,
+// snippet, cdn, content_details, and status.
func (r *LiveStreamsService) Insert(part []string, livestream *LiveStream) *LiveStreamsInsertCall {
c := &LiveStreamsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -18070,10 +18082,10 @@ type LiveStreamsListCall struct {
// List: Retrieve the list of streams associated with the given channel.
// --
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more liveStream resource properties that the API response will
-// include. The part names that you can include in the parameter value
-// are id, snippet, cdn, and status.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more liveStream resource properties that the API response will
+// include. The part names that you can include in the parameter value
+// are id, snippet, cdn, and status.
func (r *LiveStreamsService) List(part []string) *LiveStreamsListCall {
c := &LiveStreamsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -18343,15 +18355,15 @@ type LiveStreamsUpdateCall struct {
// Update: Updates an existing stream for the authenticated user.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. The part
-// properties that you can include in the parameter value are id,
-// snippet, cdn, and status. Note that this method will override the
-// existing values for all of the mutable properties that are
-// contained in any parts that the parameter value specifies. If the
-// request body does not specify a value for a mutable property, the
-// existing value for that property will be removed.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. The part
+// properties that you can include in the parameter value are id,
+// snippet, cdn, and status. Note that this method will override the
+// existing values for all of the mutable properties that are
+// contained in any parts that the parameter value specifies. If the
+// request body does not specify a value for a mutable property, the
+// existing value for that property will be removed.
func (r *LiveStreamsService) Update(part []string, livestream *LiveStream) *LiveStreamsUpdateCall {
c := &LiveStreamsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -18542,8 +18554,8 @@ type MembersListCall struct {
// List: Retrieves a list of members that match the request criteria for
// a channel.
//
-// - part: The *part* parameter specifies the member resource parts that
-// the API response will include. Set the parameter value to snippet.
+// - part: The *part* parameter specifies the member resource parts that
+// the API response will include. Set the parameter value to snippet.
func (r *MembersService) List(part []string) *MembersListCall {
c := &MembersListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -18579,10 +18591,14 @@ func (c *MembersListCall) MaxResults(maxResults int64) *MembersListCall {
// which channel members to return.
//
// Possible values:
-// "listMembersModeUnknown"
-// "updates" - Return only members that joined after the first call
+//
+// "listMembersModeUnknown"
+// "updates" - Return only members that joined after the first call
+//
// with this mode was made.
-// "all_current" (default) - Return all current members, from newest
+//
+// "all_current" (default) - Return all current members, from newest
+//
// to oldest.
func (c *MembersListCall) Mode(mode string) *MembersListCall {
c.urlParams_.Set("mode", mode)
@@ -18795,9 +18811,9 @@ type MembershipsLevelsListCall struct {
// List: Retrieves a list of all pricing levels offered by a creator to
// the fans.
//
-// - part: The *part* parameter specifies the membershipsLevel resource
-// parts that the API response will include. Supported values are id
-// and snippet.
+// - part: The *part* parameter specifies the membershipsLevel resource
+// parts that the API response will include. Supported values are id
+// and snippet.
func (r *MembershipsLevelsService) List(part []string) *MembershipsLevelsListCall {
c := &MembershipsLevelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -19061,9 +19077,9 @@ type PlaylistItemsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include.
func (r *PlaylistItemsService) Insert(part []string, playlistitem *PlaylistItem) *PlaylistItemsInsertCall {
c := &PlaylistItemsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -19225,15 +19241,15 @@ type PlaylistItemsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more playlistItem resource properties that the API response will
-// include. If the parameter identifies a property that contains child
-// properties, the child properties will be included in the response.
-// For example, in a playlistItem resource, the snippet property
-// contains numerous fields, including the title, description,
-// position, and resourceId properties. As such, if you set
-// *part=snippet*, the API response will contain all of those
-// properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more playlistItem resource properties that the API response will
+// include. If the parameter identifies a property that contains child
+// properties, the child properties will be included in the response.
+// For example, in a playlistItem resource, the snippet property
+// contains numerous fields, including the title, description,
+// position, and resourceId properties. As such, if you set
+// *part=snippet*, the API response will contain all of those
+// properties.
func (r *PlaylistItemsService) List(part []string) *PlaylistItemsListCall {
c := &PlaylistItemsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -19487,20 +19503,20 @@ type PlaylistItemsUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. Note
-// that this method will override the existing values for all of the
-// mutable properties that are contained in any parts that the
-// parameter value specifies. For example, a playlist item can specify
-// a start time and end time, which identify the times portion of the
-// video that should play when users watch the video in the playlist.
-// If your request is updating a playlist item that sets these values,
-// and the request's part parameter value includes the contentDetails
-// part, the playlist item's start and end times will be updated to
-// whatever value the request body specifies. If the request body does
-// not specify values, the existing start and end times will be
-// removed and replaced with the default settings.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. Note
+// that this method will override the existing values for all of the
+// mutable properties that are contained in any parts that the
+// parameter value specifies. For example, a playlist item can specify
+// a start time and end time, which identify the times portion of the
+// video that should play when users watch the video in the playlist.
+// If your request is updating a playlist item that sets these values,
+// and the request's part parameter value includes the contentDetails
+// part, the playlist item's start and end times will be updated to
+// whatever value the request body specifies. If the request body does
+// not specify values, the existing start and end times will be
+// removed and replaced with the default settings.
func (r *PlaylistItemsService) Update(part []string, playlistitem *PlaylistItem) *PlaylistItemsUpdateCall {
c := &PlaylistItemsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -19784,9 +19800,9 @@ type PlaylistsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include.
func (r *PlaylistsService) Insert(part []string, playlist *Playlist) *PlaylistsInsertCall {
c := &PlaylistsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -19977,14 +19993,14 @@ type PlaylistsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more playlist resource properties that the API response will
-// include. If the parameter identifies a property that contains child
-// properties, the child properties will be included in the response.
-// For example, in a playlist resource, the snippet property contains
-// properties like author, title, description, tags, and timeCreated.
-// As such, if you set *part=snippet*, the API response will contain
-// all of those properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more playlist resource properties that the API response will
+// include. If the parameter identifies a property that contains child
+// properties, the child properties will be included in the response.
+// For example, in a playlist resource, the snippet property contains
+// properties like author, title, description, tags, and timeCreated.
+// As such, if you set *part=snippet*, the API response will contain
+// all of those properties.
func (r *PlaylistsService) List(part []string) *PlaylistsListCall {
c := &PlaylistsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -20281,15 +20297,15 @@ type PlaylistsUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. Note
-// that this method will override the existing values for mutable
-// properties that are contained in any parts that the request body
-// specifies. For example, a playlist's description is contained in
-// the snippet part, which must be included in the request body. If
-// the request does not specify a value for the snippet.description
-// property, the playlist's existing description will be deleted.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. Note
+// that this method will override the existing values for mutable
+// properties that are contained in any parts that the request body
+// specifies. For example, a playlist's description is contained in
+// the snippet part, which must be included in the request body. If
+// the request does not specify a value for the snippet.description
+// property, the playlist's existing description will be deleted.
func (r *PlaylistsService) Update(part []string, playlist *Playlist) *PlaylistsUpdateCall {
c := &PlaylistsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -20451,9 +20467,9 @@ type SearchListCall struct {
// List: Retrieves a list of search resources
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more search resource properties that the API response will
-// include. Set the parameter value to snippet.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more search resource properties that the API response will
+// include. Set the parameter value to snippet.
func (r *SearchService) List(part []string) *SearchListCall {
c := &SearchListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -20471,9 +20487,10 @@ func (c *SearchListCall) ChannelId(channelId string) *SearchListCall {
// on the channel search.
//
// Possible values:
-// "channelTypeUnspecified"
-// "any" - Return all channels.
-// "show" - Only retrieve shows.
+//
+// "channelTypeUnspecified"
+// "any" - Return all channels.
+// "show" - Only retrieve shows.
func (c *SearchListCall) ChannelType(channelType string) *SearchListCall {
c.urlParams_.Set("channelType", channelType)
return c
@@ -20483,10 +20500,11 @@ func (c *SearchListCall) ChannelType(channelType string) *SearchListCall {
// livestream status of the videos.
//
// Possible values:
-// "none"
-// "upcoming" - The live broadcast is upcoming.
-// "live" - The live broadcast is active.
-// "completed" - The live broadcast has been completed.
+//
+// "none"
+// "upcoming" - The live broadcast is upcoming.
+// "live" - The live broadcast is active.
+// "completed" - The live broadcast has been completed.
func (c *SearchListCall) EventType(eventType string) *SearchListCall {
c.urlParams_.Set("eventType", eventType)
return c
@@ -20556,17 +20574,25 @@ func (c *SearchListCall) OnBehalfOfContentOwner(onBehalfOfContentOwner string) *
// Order sets the optional parameter "order": Sort order of the results.
//
// Possible values:
-// "searchSortUnspecified"
-// "date" - Resources are sorted in reverse chronological order based
+//
+// "searchSortUnspecified"
+// "date" - Resources are sorted in reverse chronological order based
+//
// on the date they were created.
-// "rating" - Resources are sorted from highest to lowest rating.
-// "viewCount" - Resources are sorted from highest to lowest number of
+//
+// "rating" - Resources are sorted from highest to lowest rating.
+// "viewCount" - Resources are sorted from highest to lowest number of
+//
// views.
-// "relevance" (default) - Resources are sorted based on their
+//
+// "relevance" (default) - Resources are sorted based on their
+//
// relevance to the search query. This is the default value for this
// parameter.
-// "title" - Resources are sorted alphabetically by title.
-// "videoCount" - Channels are sorted in descending order of their
+//
+// "title" - Resources are sorted alphabetically by title.
+// "videoCount" - Channels are sorted in descending order of their
+//
// number of uploaded videos.
func (c *SearchListCall) Order(order string) *SearchListCall {
c.urlParams_.Set("order", order)
@@ -20628,14 +20654,18 @@ func (c *SearchListCall) RelevanceLanguage(relevanceLanguage string) *SearchList
// as standard content.
//
// Possible values:
-// "safeSearchSettingUnspecified"
-// "none" - YouTube will not filter the search result set.
-// "moderate" (default) - YouTube will filter some content from search
+//
+// "safeSearchSettingUnspecified"
+// "none" - YouTube will not filter the search result set.
+// "moderate" (default) - YouTube will filter some content from search
+//
// results and, at the least, will filter content that is restricted in
// your locale. Based on their content, search results could be removed
// from search results or demoted in search results. This is the default
// parameter value.
-// "strict" - YouTube will try to exclude all restricted content from
+//
+// "strict" - YouTube will try to exclude all restricted content from
+//
// the search result set. Based on their content, search results could
// be removed from search results or demoted in search results.
func (c *SearchListCall) SafeSearch(safeSearch string) *SearchListCall {
@@ -20661,10 +20691,11 @@ func (c *SearchListCall) Type(type_ ...string) *SearchListCall {
// the presence of captions on the videos.
//
// Possible values:
-// "videoCaptionUnspecified"
-// "any" - Do not filter results based on caption availability.
-// "closedCaption" - Only include videos that have captions.
-// "none" - Only include videos that do not have captions.
+//
+// "videoCaptionUnspecified"
+// "any" - Do not filter results based on caption availability.
+// "closedCaption" - Only include videos that have captions.
+// "none" - Only include videos that do not have captions.
func (c *SearchListCall) VideoCaption(videoCaption string) *SearchListCall {
c.urlParams_.Set("videoCaption", videoCaption)
return c
@@ -20681,9 +20712,10 @@ func (c *SearchListCall) VideoCategoryId(videoCategoryId string) *SearchListCall
// on the definition of the videos.
//
// Possible values:
-// "any" - Return all videos, regardless of their resolution.
-// "standard" - Only retrieve videos in standard definition.
-// "high" - Only retrieve HD videos.
+//
+// "any" - Return all videos, regardless of their resolution.
+// "standard" - Only retrieve videos in standard definition.
+// "high" - Only retrieve HD videos.
func (c *SearchListCall) VideoDefinition(videoDefinition string) *SearchListCall {
c.urlParams_.Set("videoDefinition", videoDefinition)
return c
@@ -20693,10 +20725,13 @@ func (c *SearchListCall) VideoDefinition(videoDefinition string) *SearchListCall
// on 3d videos.
//
// Possible values:
-// "any" - Include both 3D and non-3D videos in returned results. This
+//
+// "any" - Include both 3D and non-3D videos in returned results. This
+//
// is the default value.
-// "2d" - Restrict search results to exclude 3D videos.
-// "3d" - Restrict search results to only include 3D videos.
+//
+// "2d" - Restrict search results to exclude 3D videos.
+// "3d" - Restrict search results to only include 3D videos.
func (c *SearchListCall) VideoDimension(videoDimension string) *SearchListCall {
c.urlParams_.Set("videoDimension", videoDimension)
return c
@@ -20706,13 +20741,18 @@ func (c *SearchListCall) VideoDimension(videoDimension string) *SearchListCall {
// the duration of the videos.
//
// Possible values:
-// "videoDurationUnspecified"
-// "any" - Do not filter video search results based on their duration.
+//
+// "videoDurationUnspecified"
+// "any" - Do not filter video search results based on their duration.
+//
// This is the default value.
-// "short" - Only include videos that are less than four minutes long.
-// "medium" - Only include videos that are between four and 20 minutes
+//
+// "short" - Only include videos that are less than four minutes long.
+// "medium" - Only include videos that are between four and 20 minutes
+//
// long (inclusive).
-// "long" - Only include videos longer than 20 minutes.
+//
+// "long" - Only include videos longer than 20 minutes.
func (c *SearchListCall) VideoDuration(videoDuration string) *SearchListCall {
c.urlParams_.Set("videoDuration", videoDuration)
return c
@@ -20722,9 +20762,10 @@ func (c *SearchListCall) VideoDuration(videoDuration string) *SearchListCall {
// on embeddable videos.
//
// Possible values:
-// "videoEmbeddableUnspecified"
-// "any" - Return all videos, embeddable or not.
-// "true" - Only retrieve embeddable videos.
+//
+// "videoEmbeddableUnspecified"
+// "any" - Return all videos, embeddable or not.
+// "true" - Only retrieve embeddable videos.
func (c *SearchListCall) VideoEmbeddable(videoEmbeddable string) *SearchListCall {
c.urlParams_.Set("videoEmbeddable", videoEmbeddable)
return c
@@ -20734,11 +20775,17 @@ func (c *SearchListCall) VideoEmbeddable(videoEmbeddable string) *SearchListCall
// the license of the videos.
//
// Possible values:
-// "any" - Return all videos, regardless of which license they have,
+//
+// "any" - Return all videos, regardless of which license they have,
+//
// that match the query parameters.
-// "youtube" - Only return videos that have the standard YouTube
+//
+// "youtube" - Only return videos that have the standard YouTube
+//
// license.
-// "creativeCommon" - Only return videos that have a Creative Commons
+//
+// "creativeCommon" - Only return videos that have a Creative Commons
+//
// license. Users can reuse videos with this license in other videos
// that they create. Learn more.
func (c *SearchListCall) VideoLicense(videoLicense string) *SearchListCall {
@@ -20750,9 +20797,10 @@ func (c *SearchListCall) VideoLicense(videoLicense string) *SearchListCall {
// on syndicated videos.
//
// Possible values:
-// "videoSyndicatedUnspecified"
-// "any" - Return all videos, syndicated or not.
-// "true" - Only retrieve syndicated videos.
+//
+// "videoSyndicatedUnspecified"
+// "any" - Return all videos, syndicated or not.
+// "true" - Only retrieve syndicated videos.
func (c *SearchListCall) VideoSyndicated(videoSyndicated string) *SearchListCall {
c.urlParams_.Set("videoSyndicated", videoSyndicated)
return c
@@ -20762,10 +20810,11 @@ func (c *SearchListCall) VideoSyndicated(videoSyndicated string) *SearchListCall
// of a specific type.
//
// Possible values:
-// "videoTypeUnspecified"
-// "any" - Return all videos.
-// "movie" - Only retrieve movies.
-// "episode" - Only retrieve episodes of shows.
+//
+// "videoTypeUnspecified"
+// "any" - Return all videos.
+// "movie" - Only retrieve movies.
+// "episode" - Only retrieve episodes of shows.
func (c *SearchListCall) VideoType(videoType string) *SearchListCall {
c.urlParams_.Set("videoType", videoType)
return c
@@ -21329,9 +21378,9 @@ type SubscriptionsInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include.
func (r *SubscriptionsService) Insert(part []string, subscription *Subscription) *SubscriptionsInsertCall {
c := &SubscriptionsInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -21471,14 +21520,14 @@ type SubscriptionsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more subscription resource properties that the API response will
-// include. If the parameter identifies a property that contains child
-// properties, the child properties will be included in the response.
-// For example, in a subscription resource, the snippet property
-// contains other properties, such as a display title for the
-// subscription. If you set *part=snippet*, the API response will also
-// contain all of those nested properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more subscription resource properties that the API response will
+// include. If the parameter identifies a property that contains child
+// properties, the child properties will be included in the response.
+// For example, in a subscription resource, the snippet property
+// contains other properties, such as a display title for the
+// subscription. If you set *part=snippet*, the API response will also
+// contain all of those nested properties.
func (r *SubscriptionsService) List(part []string) *SubscriptionsListCall {
c := &SubscriptionsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -21581,10 +21630,11 @@ func (c *SubscriptionsListCall) OnBehalfOfContentOwnerChannel(onBehalfOfContentO
// subscriptions
//
// Possible values:
-// "subscriptionOrderUnspecified"
-// "relevance" (default) - Sort by relevance.
-// "unread" - Sort by order of activity.
-// "alphabetical" - Sort alphabetically.
+//
+// "subscriptionOrderUnspecified"
+// "relevance" (default) - Sort by relevance.
+// "unread" - Sort by order of activity.
+// "alphabetical" - Sort alphabetically.
func (c *SubscriptionsListCall) Order(order string) *SubscriptionsListCall {
c.urlParams_.Set("order", order)
return c
@@ -21830,9 +21880,9 @@ type SuperChatEventsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies the superChatEvent resource
-// parts that the API response will include. This parameter is
-// currently not supported.
+// - part: The *part* parameter specifies the superChatEvent resource
+// parts that the API response will include. This parameter is
+// currently not supported.
func (r *SuperChatEventsService) List(part []string) *SuperChatEventsListCall {
c := &SuperChatEventsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -22186,9 +22236,9 @@ type ThirdPartyLinksDeleteCall struct {
// Delete: Deletes a resource.
//
-// - linkingToken: Delete the partner links with the given linking
-// token.
-// - type: Type of the link to be deleted.
+// - linkingToken: Delete the partner links with the given linking
+// token.
+// - type: Type of the link to be deleted.
func (r *ThirdPartyLinksService) Delete(linkingToken string, type_ string) *ThirdPartyLinksDeleteCall {
c := &ThirdPartyLinksDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("linkingToken", linkingToken)
@@ -22326,9 +22376,9 @@ type ThirdPartyLinksInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter specifies the thirdPartyLink resource
-// parts that the API request and response will include. Supported
-// values are linkingToken, status, and snippet.
+// - part: The *part* parameter specifies the thirdPartyLink resource
+// parts that the API request and response will include. Supported
+// values are linkingToken, status, and snippet.
func (r *ThirdPartyLinksService) Insert(part []string, thirdpartylink *ThirdPartyLink) *ThirdPartyLinksInsertCall {
c := &ThirdPartyLinksInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -22475,9 +22525,9 @@ type ThirdPartyLinksListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies the thirdPartyLink resource
-// parts that the API response will include. Supported values are
-// linkingToken, status, and snippet.
+// - part: The *part* parameter specifies the thirdPartyLink resource
+// parts that the API response will include. Supported values are
+// linkingToken, status, and snippet.
func (r *ThirdPartyLinksService) List(part []string) *ThirdPartyLinksListCall {
c := &ThirdPartyLinksListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -22502,8 +22552,10 @@ func (c *ThirdPartyLinksListCall) LinkingToken(linkingToken string) *ThirdPartyL
// the given type.
//
// Possible values:
-// "linkUnspecified"
-// "channelToStoreLink" - A link that is connecting (or about to
+//
+// "linkUnspecified"
+// "channelToStoreLink" - A link that is connecting (or about to
+//
// connect) a channel with a store on a merchandising platform in order
// to enable retail commerce capabilities for that channel on YouTube.
func (c *ThirdPartyLinksListCall) Type(type_ string) *ThirdPartyLinksListCall {
@@ -22666,9 +22718,9 @@ type ThirdPartyLinksUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter specifies the thirdPartyLink resource
-// parts that the API request and response will include. Supported
-// values are linkingToken, status, and snippet.
+// - part: The *part* parameter specifies the thirdPartyLink resource
+// parts that the API request and response will include. Supported
+// values are linkingToken, status, and snippet.
func (r *ThirdPartyLinksService) Update(part []string, thirdpartylink *ThirdPartyLink) *ThirdPartyLinksUpdateCall {
c := &ThirdPartyLinksUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -22817,8 +22869,8 @@ type ThumbnailsSetCall struct {
// uploading/setting of a thumbnail for multiple videos, which doesn't
// result in creation of a single resource), I use a custom verb here.
//
-// - videoId: Returns the Thumbnail with the given video IDs for Stubby
-// or Apiary.
+// - videoId: Returns the Thumbnail with the given video IDs for Stubby
+// or Apiary.
func (r *ThumbnailsService) Set(videoId string) *ThumbnailsSetCall {
c := &ThumbnailsSetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.Set("videoId", videoId)
@@ -23058,9 +23110,9 @@ type VideoAbuseReportReasonsListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies the videoCategory resource
-// parts that the API response will include. Supported values are id
-// and snippet.
+// - part: The *part* parameter specifies the videoCategory resource
+// parts that the API response will include. Supported values are id
+// and snippet.
func (r *VideoAbuseReportReasonsService) List(part []string) *VideoAbuseReportReasonsListCall {
c := &VideoAbuseReportReasonsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -23216,9 +23268,9 @@ type VideoCategoriesListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies the videoCategory resource
-// properties that the API response will include. Set the parameter
-// value to snippet.
+// - part: The *part* parameter specifies the videoCategory resource
+// properties that the API response will include. Set the parameter
+// value to snippet.
func (r *VideoCategoriesService) List(part []string) *VideoCategoriesListCall {
c := &VideoCategoriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -23687,15 +23739,15 @@ type VideosInsertCall struct {
// Insert: Inserts a new resource into this collection.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. Note
-// that not all parts contain properties that can be set when
-// inserting or updating a video. For example, the statistics object
-// encapsulates statistics that YouTube calculates for a video and
-// does not contain values that you can set or modify. If the
-// parameter value specifies a part that does not contain mutable
-// values, that part will still be included in the API response.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. Note
+// that not all parts contain properties that can be set when
+// inserting or updating a video. For example, the statistics object
+// encapsulates statistics that YouTube calculates for a video and
+// does not contain values that you can set or modify. If the
+// parameter value specifies a part that does not contain mutable
+// values, that part will still be included in the API response.
func (r *VideosService) Insert(part []string, video *Video) *VideosInsertCall {
c := &VideosInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -24010,14 +24062,14 @@ type VideosListCall struct {
// List: Retrieves a list of resources, possibly filtered.
//
-// - part: The *part* parameter specifies a comma-separated list of one
-// or more video resource properties that the API response will
-// include. If the parameter identifies a property that contains child
-// properties, the child properties will be included in the response.
-// For example, in a video resource, the snippet property contains the
-// channelId, title, description, tags, and categoryId properties. As
-// such, if you set *part=snippet*, the API response will contain all
-// of those properties.
+// - part: The *part* parameter specifies a comma-separated list of one
+// or more video resource properties that the API response will
+// include. If the parameter identifies a property that contains child
+// properties, the child properties will be included in the response.
+// For example, in a video resource, the snippet property contains the
+// channelId, title, description, tags, and categoryId properties. As
+// such, if you set *part=snippet*, the API response will contain all
+// of those properties.
func (r *VideosService) List(part []string) *VideosListCall {
c := &VideosListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
@@ -24028,8 +24080,10 @@ func (r *VideosService) List(part []string) *VideosListCall {
// in the specified chart.
//
// Possible values:
-// "chartUnspecified"
-// "mostPopular" - Return the most popular videos for the specified
+//
+// "chartUnspecified"
+// "mostPopular" - Return the most popular videos for the specified
+//
// content region and video category.
func (c *VideosListCall) Chart(chart string) *VideosListCall {
c.urlParams_.Set("chart", chart)
@@ -24088,9 +24142,10 @@ func (c *VideosListCall) MaxWidth(maxWidth int64) *VideosListCall {
// RateType.RATED_TYPE_NONE.
//
// Possible values:
-// "none"
-// "like" - The entity is liked.
-// "dislike" - The entity is disliked.
+//
+// "none"
+// "like" - The entity is liked.
+// "dislike" - The entity is disliked.
func (c *VideosListCall) MyRating(myRating string) *VideosListCall {
c.urlParams_.Set("myRating", myRating)
return c
@@ -24627,24 +24682,24 @@ type VideosUpdateCall struct {
// Update: Updates an existing resource.
//
-// - part: The *part* parameter serves two purposes in this operation.
-// It identifies the properties that the write operation will set as
-// well as the properties that the API response will include. Note
-// that this method will override the existing values for all of the
-// mutable properties that are contained in any parts that the
-// parameter value specifies. For example, a video's privacy setting
-// is contained in the status part. As such, if your request is
-// updating a private video, and the request's part parameter value
-// includes the status part, the video's privacy setting will be
-// updated to whatever value the request body specifies. If the
-// request body does not specify a value, the existing privacy setting
-// will be removed and the video will revert to the default privacy
-// setting. In addition, not all parts contain properties that can be
-// set when inserting or updating a video. For example, the statistics
-// object encapsulates statistics that YouTube calculates for a video
-// and does not contain values that you can set or modify. If the
-// parameter value specifies a part that does not contain mutable
-// values, that part will still be included in the API response.
+// - part: The *part* parameter serves two purposes in this operation.
+// It identifies the properties that the write operation will set as
+// well as the properties that the API response will include. Note
+// that this method will override the existing values for all of the
+// mutable properties that are contained in any parts that the
+// parameter value specifies. For example, a video's privacy setting
+// is contained in the status part. As such, if your request is
+// updating a private video, and the request's part parameter value
+// includes the status part, the video's privacy setting will be
+// updated to whatever value the request body specifies. If the
+// request body does not specify a value, the existing privacy setting
+// will be removed and the video will revert to the default privacy
+// setting. In addition, not all parts contain properties that can be
+// set when inserting or updating a video. For example, the statistics
+// object encapsulates statistics that YouTube calculates for a video
+// and does not contain values that you can set or modify. If the
+// parameter value specifies a part that does not contain mutable
+// values, that part will still be included in the API response.
func (r *VideosService) Update(part []string, video *Video) *VideosUpdateCall {
c := &VideosUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)}
c.urlParams_.SetMulti("part", append([]string{}, part...))
diff --git a/youtubeanalytics/v1/youtubeanalytics-gen.go b/youtubeanalytics/v1/youtubeanalytics-gen.go
index 813e59ea60e..1b5ac707b58 100644
--- a/youtubeanalytics/v1/youtubeanalytics-gen.go
+++ b/youtubeanalytics/v1/youtubeanalytics-gen.go
@@ -8,31 +8,31 @@
//
// For product documentation, see: https://developers.google.com/youtube/analytics
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/youtubeanalytics/v1"
-// ...
-// ctx := context.Background()
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx)
+// import "google.golang.org/api/youtubeanalytics/v1"
+// ...
+// ctx := context.Background()
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithAPIKey("AIza..."))
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package youtubeanalytics // import "google.golang.org/api/youtubeanalytics/v1"
diff --git a/youtubeanalytics/v1beta1/youtubeanalytics-gen.go b/youtubeanalytics/v1beta1/youtubeanalytics-gen.go
index bc686dcac74..805a90ffb96 100644
--- a/youtubeanalytics/v1beta1/youtubeanalytics-gen.go
+++ b/youtubeanalytics/v1beta1/youtubeanalytics-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: http://developers.google.com/youtube/analytics/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/youtubeanalytics/v1beta1"
-// ...
-// ctx := context.Background()
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx)
+// import "google.golang.org/api/youtubeanalytics/v1beta1"
+// ...
+// ctx := context.Background()
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithScopes(youtubeanalytics.YtAnalyticsReadonlyScope))
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithScopes(youtubeanalytics.YtAnalyticsReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithAPIKey("AIza..."))
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package youtubeanalytics // import "google.golang.org/api/youtubeanalytics/v1beta1"
diff --git a/youtubeanalytics/v2/youtubeanalytics-gen.go b/youtubeanalytics/v2/youtubeanalytics-gen.go
index 80330ae30a1..360dfbed410 100644
--- a/youtubeanalytics/v2/youtubeanalytics-gen.go
+++ b/youtubeanalytics/v2/youtubeanalytics-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/youtube/analytics
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/youtubeanalytics/v2"
-// ...
-// ctx := context.Background()
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx)
+// import "google.golang.org/api/youtubeanalytics/v2"
+// ...
+// ctx := context.Background()
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithScopes(youtubeanalytics.YtAnalyticsReadonlyScope))
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithScopes(youtubeanalytics.YtAnalyticsReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithAPIKey("AIza..."))
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// youtubeanalyticsService, err := youtubeanalytics.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package youtubeanalytics // import "google.golang.org/api/youtubeanalytics/v2"
diff --git a/youtubereporting/v1/youtubereporting-gen.go b/youtubereporting/v1/youtubereporting-gen.go
index 067db30ce72..e1a39249660 100644
--- a/youtubereporting/v1/youtubereporting-gen.go
+++ b/youtubereporting/v1/youtubereporting-gen.go
@@ -8,35 +8,35 @@
//
// For product documentation, see: https://developers.google.com/youtube/reporting/v1/reports/
//
-// Creating a client
+// # Creating a client
//
// Usage example:
//
-// import "google.golang.org/api/youtubereporting/v1"
-// ...
-// ctx := context.Background()
-// youtubereportingService, err := youtubereporting.NewService(ctx)
+// import "google.golang.org/api/youtubereporting/v1"
+// ...
+// ctx := context.Background()
+// youtubereportingService, err := youtubereporting.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
-// Other authentication options
+// # Other authentication options
//
// By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use option.WithScopes:
//
-// youtubereportingService, err := youtubereporting.NewService(ctx, option.WithScopes(youtubereporting.YtAnalyticsReadonlyScope))
+// youtubereportingService, err := youtubereporting.NewService(ctx, option.WithScopes(youtubereporting.YtAnalyticsReadonlyScope))
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
-// youtubereportingService, err := youtubereporting.NewService(ctx, option.WithAPIKey("AIza..."))
+// youtubereportingService, err := youtubereporting.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
-// config := &oauth2.Config{...}
-// // ...
-// token, err := config.Exchange(ctx, ...)
-// youtubereportingService, err := youtubereporting.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
+// config := &oauth2.Config{...}
+// // ...
+// token, err := config.Exchange(ctx, ...)
+// youtubereportingService, err := youtubereporting.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
package youtubereporting // import "google.golang.org/api/youtubereporting/v1"