diff --git a/api-list.json b/api-list.json index dfdfe4c65a..4f13676490 100644 --- a/api-list.json +++ b/api-list.json @@ -5698,7 +5698,7 @@ "name": "sourcerepo", "version": "v1", "title": "Cloud Source Repositories API", - "description": "Accesses source code repositories hosted by Google. Important: Cloud Source Repositories is scheduled for end-of-sale starting June 17, 2024. Customers who have enabled the API prior to this date will not be affected and can continue to use Cloud Source Repositories. Organizations or projects who have not previously enabled the API cannot use Cloud Source Repositories after this date. View Cloud Source Repositories documentation for more info.", + "description": "Accesses source code repositories hosted by Google. Important: Cloud Source Repositories is scheduled for end of sales starting June 17, 2024. Customers who have enabled the API prior to this date will not be affected and can continue to use Cloud Source Repositories. Organizations or projects who have not previously enabled the API cannot use Cloud Source Repositories after this date. View Cloud Source Repositories documentation for more info.", "discoveryRestUrl": "https://sourcerepo.googleapis.com/$discovery/rest?version=v1", "icons": { "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", diff --git a/chat/v1/chat-api.json b/chat/v1/chat-api.json index a6aa79fb62..b1e01b0ce0 100644 --- a/chat/v1/chat-api.json +++ b/chat/v1/chat-api.json @@ -347,7 +347,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name of the space, in the form \"spaces/*\". Format: `spaces/{space}`", + "description": "Required. Resource name of the space, in the form `spaces/{space}`. Format: `spaces/{space}`", "location": "path", "pattern": "^spaces/[^/]+$", "required": true, @@ -365,7 +365,7 @@ ] }, "list": { - "description": "Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list-spaces). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent. ", + "description": "Lists spaces the caller is a member of. Group chats and DMs aren't listed until the first message is sent. For an example, see [List spaces](https://developers.google.com/workspace/chat/list-spaces). Requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize). Supports [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). Lists spaces visible to the caller or authenticated user. Group chats and DMs aren't listed until the first message is sent. To list all named spaces by Google Workspace organization, use the `spaces.search()` method using Workspace administrator privileges instead.", "flatPath": "v1/spaces", "httpMethod": "GET", "id": "chat.spaces.list", @@ -550,7 +550,7 @@ ], "parameters": { "filter": { - "description": "Optional. A query filter. You can filter memberships by a member's role ([`role`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members#membershiprole)) and type ([`member.type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/User#type)). To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN` or `BOT`. To filter by both role and type, use the `AND` operator. To filter by either role or type, use the `OR` operator. For example, the following queries are valid: ``` role = \"ROLE_MANAGER\" OR role = \"ROLE_MEMBER\" member.type = \"HUMAN\" AND role = \"ROLE_MANAGER\" ``` The following queries are invalid: ``` member.type = \"HUMAN\" AND member.type = \"BOT\" role = \"ROLE_MANAGER\" AND role = \"ROLE_MEMBER\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.", + "description": "Optional. A query filter. You can filter memberships by a member's role ([`role`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members#membershiprole)) and type ([`member.type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/User#type)). To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter by type, set `member.type` to `HUMAN` or `BOT`. Developer Preview: You can also filter for `member.type` using the `!=` operator. To filter by both role and type, use the `AND` operator. To filter by either role or type, use the `OR` operator. Either `member.type = \"HUMAN\"` or `member.type != \"BOT\"` is required when `use_admin_access` is set to true. Other member type filters will be rejected. For example, the following queries are valid: ``` role = \"ROLE_MANAGER\" OR role = \"ROLE_MEMBER\" member.type = \"HUMAN\" AND role = \"ROLE_MANAGER\" member.type != \"BOT\" ``` The following queries are invalid: ``` member.type = \"HUMAN\" AND member.type = \"BOT\" role = \"ROLE_MANAGER\" AND role = \"ROLE_MEMBER\" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error.", "location": "query", "type": "string" }, @@ -903,7 +903,7 @@ ], "parameters": { "name": { - "description": "Required. Resource name of the attachment, in the form `spaces/*/messages/*/attachments/*`.", + "description": "Required. Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`.", "location": "path", "pattern": "^spaces/[^/]+/messages/[^/]+/attachments/[^/]+$", "required": true, @@ -1215,7 +1215,7 @@ } } }, - "revision": "20240509", + "revision": "20240519", "rootUrl": "https://chat.googleapis.com/", "schemas": { "AccessoryWidget": { @@ -1424,7 +1424,7 @@ "readOnly": true }, "name": { - "description": "Resource name of the attachment, in the form `spaces/*/messages/*/attachments/*`.", + "description": "Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`.", "type": "string" }, "source": { diff --git a/chat/v1/chat-gen.go b/chat/v1/chat-gen.go index a4a474e783..770960542c 100644 --- a/chat/v1/chat-gen.go +++ b/chat/v1/chat-gen.go @@ -635,7 +635,7 @@ type Attachment struct { // field is used with the Google Drive API. DriveDataRef *DriveDataRef `json:"driveDataRef,omitempty"` // Name: Resource name of the attachment, in the form - // `spaces/*/messages/*/attachments/*`. + // `spaces/{space}/messages/{message}/attachments/{attachment}`. Name string `json:"name,omitempty"` // Source: Output only. The source of the attachment. // @@ -6062,7 +6062,7 @@ type SpacesGetCall struct { // and user authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // -// - name: Resource name of the space, in the form "spaces/*". Format: +// - name: Resource name of the space, in the form `spaces/{space}`. Format: // `spaces/{space}`. func (r *SpacesService) Get(name string) *SpacesGetCall { c := &SpacesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -6177,7 +6177,9 @@ type SpacesListCall struct { // and user authentication // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). // Lists spaces visible to the caller or authenticated user. Group chats and -// DMs aren't listed until the first message is sent. +// DMs aren't listed until the first message is sent. To list all named spaces +// by Google Workspace organization, use the `spaces.search()` method using +// Workspace administrator privileges instead. func (r *SpacesService) List() *SpacesListCall { c := &SpacesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -6977,13 +6979,16 @@ func (r *SpacesMembersService) List(parent string) *SpacesMembersListCall { // and type (`member.type` // (https://developers.google.com/workspace/chat/api/reference/rest/v1/User#type)). // To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`. To filter -// by type, set `member.type` to `HUMAN` or `BOT`. To filter by both role and -// type, use the `AND` operator. To filter by either role or type, use the `OR` -// operator. For example, the following queries are valid: ``` role = -// "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "HUMAN" AND role = -// "ROLE_MANAGER" ``` The following queries are invalid: ``` member.type = -// "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND role = -// "ROLE_MEMBER" ``` Invalid queries are rejected by the server with an +// by type, set `member.type` to `HUMAN` or `BOT`. Developer Preview: You can +// also filter for `member.type` using the `!=` operator. To filter by both +// role and type, use the `AND` operator. To filter by either role or type, use +// the `OR` operator. Either `member.type = "HUMAN" or `member.type != "BOT" +// is required when `use_admin_access` is set to true. Other member type +// filters will be rejected. For example, the following queries are valid: ``` +// role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "HUMAN" AND role +// = "ROLE_MANAGER" member.type != "BOT" ``` The following queries are invalid: +// ``` member.type = "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND +// role = "ROLE_MEMBER" ``` Invalid queries are rejected by the server with an // `INVALID_ARGUMENT` error. func (c *SpacesMembersListCall) Filter(filter string) *SpacesMembersListCall { c.urlParams_.Set("filter", filter) @@ -8166,7 +8171,7 @@ type SpacesMessagesAttachmentsGetCall struct { // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). // // - name: Resource name of the attachment, in the form -// `spaces/*/messages/*/attachments/*`. +// `spaces/{space}/messages/{message}/attachments/{attachment}`. func (r *SpacesMessagesAttachmentsService) Get(name string) *SpacesMessagesAttachmentsGetCall { c := &SpacesMessagesAttachmentsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.name = name diff --git a/cloudbilling/v1/cloudbilling-api.json b/cloudbilling/v1/cloudbilling-api.json index 15134dee61..219270620a 100644 --- a/cloudbilling/v1/cloudbilling-api.json +++ b/cloudbilling/v1/cloudbilling-api.json @@ -723,7 +723,7 @@ "type": "string" }, "parent": { - "description": "Required. The name of the service. Example: \"services/DA34-426B-A397\"", + "description": "Required. The name of the service. Example: \"services/6F81-5844-456A\"", "location": "path", "pattern": "^services/[^/]+$", "required": true, @@ -751,7 +751,7 @@ } } }, - "revision": "20240119", + "revision": "20240517", "rootUrl": "https://cloudbilling.googleapis.com/", "schemas": { "AggregationInfo": { @@ -1211,11 +1211,11 @@ "type": "string" }, "name": { - "description": "The resource name for the service. Example: \"services/DA34-426B-A397\"", + "description": "The resource name for the service. Example: \"services/6F81-5844-456A\"", "type": "string" }, "serviceId": { - "description": "The identifier for the service. Example: \"DA34-426B-A397\"", + "description": "The identifier for the service. Example: \"6F81-5844-456A\"", "type": "string" } }, @@ -1238,7 +1238,7 @@ "type": "object" }, "Sku": { - "description": "Encapsulates a single SKU in Google Cloud Platform", + "description": "Encapsulates a single SKU in Google Cloud", "id": "Sku", "properties": { "category": { @@ -1254,7 +1254,7 @@ "description": "The geographic taxonomy for this sku." }, "name": { - "description": "The resource name for the SKU. Example: \"services/DA34-426B-A397/skus/AA95-CD31-42FE\"", + "description": "The resource name for the SKU. Example: \"services/6F81-5844-456A/skus/D041-B8A1-6E0B\"", "type": "string" }, "pricingInfo": { @@ -1276,7 +1276,7 @@ "type": "array" }, "skuId": { - "description": "The identifier for the SKU. Example: \"AA95-CD31-42FE\"", + "description": "The identifier for the SKU. Example: \"D041-B8A1-6E0B\"", "type": "string" } }, diff --git a/cloudbilling/v1/cloudbilling-gen.go b/cloudbilling/v1/cloudbilling-gen.go index 893289ddf0..3a32a5716f 100644 --- a/cloudbilling/v1/cloudbilling-gen.go +++ b/cloudbilling/v1/cloudbilling-gen.go @@ -1072,9 +1072,9 @@ type Service struct { BusinessEntityName string `json:"businessEntityName,omitempty"` // DisplayName: A human readable display name for this service. DisplayName string `json:"displayName,omitempty"` - // Name: The resource name for the service. Example: "services/DA34-426B-A397" + // Name: The resource name for the service. Example: "services/6F81-5844-456A" Name string `json:"name,omitempty"` - // ServiceId: The identifier for the service. Example: "DA34-426B-A397" + // ServiceId: The identifier for the service. Example: "6F81-5844-456A" ServiceId string `json:"serviceId,omitempty"` // ForceSendFields is a list of field names (e.g. "BusinessEntityName") to // unconditionally include in API requests. By default, fields with empty or @@ -1123,7 +1123,7 @@ func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// Sku: Encapsulates a single SKU in Google Cloud Platform +// Sku: Encapsulates a single SKU in Google Cloud type Sku struct { // Category: The category hierarchy of this SKU, purely for organizational // purpose. @@ -1134,7 +1134,7 @@ type Sku struct { // GeoTaxonomy: The geographic taxonomy for this sku. GeoTaxonomy *GeoTaxonomy `json:"geoTaxonomy,omitempty"` // Name: The resource name for the SKU. Example: - // "services/DA34-426B-A397/skus/AA95-CD31-42FE" + // "services/6F81-5844-456A/skus/D041-B8A1-6E0B" Name string `json:"name,omitempty"` // PricingInfo: A timeline of pricing info for this SKU in chronological order. PricingInfo []*PricingInfo `json:"pricingInfo,omitempty"` @@ -1145,7 +1145,7 @@ type Sku struct { // "asia-east1" Service regions can be found at // https://cloud.google.com/about/locations/ ServiceRegions []string `json:"serviceRegions,omitempty"` - // SkuId: The identifier for the SKU. Example: "AA95-CD31-42FE" + // SkuId: The identifier for the SKU. Example: "D041-B8A1-6E0B" SkuId string `json:"skuId,omitempty"` // ForceSendFields is a list of field names (e.g. "Category") to // unconditionally include in API requests. By default, fields with empty or @@ -3408,7 +3408,7 @@ type ServicesSkusListCall struct { // List: Lists all publicly available SKUs for a given cloud service. // -// - parent: The name of the service. Example: "services/DA34-426B-A397". +// - parent: The name of the service. Example: "services/6F81-5844-456A". func (r *ServicesSkusService) List(parent string) *ServicesSkusListCall { c := &ServicesSkusListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent diff --git a/compute/v0.alpha/compute-api.json b/compute/v0.alpha/compute-api.json index 5b1001c852..7d5c8416c6 100644 --- a/compute/v0.alpha/compute-api.json +++ b/compute/v0.alpha/compute-api.json @@ -33307,7 +33307,7 @@ ] }, "list": { - "description": "Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request.", + "description": "Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method.", "flatPath": "projects/{project}/regions", "httpMethod": "GET", "id": "compute.regions.list", @@ -44423,7 +44423,7 @@ } } }, - "revision": "20240507", + "revision": "20240519", "rootUrl": "https://compute.googleapis.com/", "schemas": { "AWSV4Signature": { @@ -45966,7 +45966,7 @@ }, "diskEncryptionKey": { "$ref": "CustomerEncryptionKey", - "description": "Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group." + "description": "Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method." }, "diskSizeGb": { "description": "The size of the disk in GB.", @@ -61989,7 +61989,7 @@ "compute.instanceTemplates.insert" ] }, - "description": "The machine type to use for instances that are created from these properties.", + "description": "The machine type to use for instances that are created from these properties. This field only accept machine types name. e.g. n2-standard-4 and does not accept machine type full or partial url. e.g. projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 will throw INTERNAL_ERROR.", "type": "string" }, "metadata": { @@ -81750,10 +81750,12 @@ "stopState": { "description": "Current stopping state of the instance.", "enum": [ + "PENDING_STOP", "SHUTTING_DOWN", "STOPPING" ], "enumDescriptions": [ + "The instance is gracefully shutting down.", "Deprecating, please use PENDING_STOP. The instance is gracefully shutting down.", "The instance is stopping." ], diff --git a/compute/v0.alpha/compute-gen.go b/compute/v0.alpha/compute-gen.go index e2f17fc7a1..633d2049c3 100644 --- a/compute/v0.alpha/compute-gen.go +++ b/compute/v0.alpha/compute-gen.go @@ -3140,9 +3140,10 @@ type AttachedDisk struct { // when you create a snapshot or an image from the disk or when you attach the // disk to a virtual machine instance. If you do not provide an encryption key, // then the disk will be encrypted using an automatically generated key and you - // do not need to provide a key to use the disk later. Instance templates do - // not store customer-supplied encryption keys, so you cannot use your own keys - // to encrypt disks in a managed instance group. + // do not need to provide a key to use the disk later. Note: Instance templates + // do not store customer-supplied encryption keys, so you cannot use your own + // keys to encrypt disks in a managed instance group. You cannot create VMs + // that have disks with customer-supplied keys using the bulk insert method. DiskEncryptionKey *CustomerEncryptionKey `json:"diskEncryptionKey,omitempty"` // DiskSizeGb: The size of the disk in GB. DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"` @@ -22067,7 +22068,10 @@ type InstanceProperties struct { // Labels: Labels to apply to instances that are created from these properties. Labels map[string]string `json:"labels,omitempty"` // MachineType: The machine type to use for instances that are created from - // these properties. + // these properties. This field only accept machine types name. e.g. + // n2-standard-4 and does not accept machine type full or partial url. e.g. + // projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4 + // will throw INTERNAL_ERROR. MachineType string `json:"machineType,omitempty"` // Metadata: The metadata key/value pairs to assign to instances that are // created from these properties. These pairs can consist of custom metadata or @@ -43533,6 +43537,7 @@ type ResourceStatusShutdownDetails struct { // StopState: Current stopping state of the instance. // // Possible values: + // "PENDING_STOP" - The instance is gracefully shutting down. // "SHUTTING_DOWN" - Deprecating, please use PENDING_STOP. The instance is // gracefully shutting down. // "STOPPING" - The instance is stopping. diff --git a/compute/v0.alpha/compute3-gen.go b/compute/v0.alpha/compute3-gen.go index 7c7d376924..7c91f4311e 100644 --- a/compute/v0.alpha/compute3-gen.go +++ b/compute/v0.alpha/compute3-gen.go @@ -26880,7 +26880,13 @@ type RegionsListCall struct { // field). To exclude one or more fields, set your request's `fields` query // parameter to only include the fields you need. For example, to only include // the `id` and `selfLink` fields, add the query parameter -// `?fields=id,selfLink` to your request. +// `?fields=id,selfLink` to your request. This method fails if the quota +// information is unavailable for the region and if the organization policy +// constraint compute.requireBasicQuotaInResponse is enforced. This constraint, +// when enforced, disables the fail-open behaviour when quota information (the +// `items.quotas` field) is unavailable for the region. It is recommended to +// use the default setting for the constraint unless your application requires +// the fail-closed behaviour for this method. // // - project: Project ID for this request. func (r *RegionsService) List(project string) *RegionsListCall { diff --git a/contactcenterinsights/v1/contactcenterinsights-api.json b/contactcenterinsights/v1/contactcenterinsights-api.json index 122a505134..26d7b798d7 100644 --- a/contactcenterinsights/v1/contactcenterinsights-api.json +++ b/contactcenterinsights/v1/contactcenterinsights-api.json @@ -468,7 +468,7 @@ "type": "string" }, "updateMask": { - "description": "The list of fields to be updated.", + "description": "The list of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `agent_id` * `language_code` * `labels` * `metadata` * `quality_metadata` * `call_metadata` * `start_time` * `expire_time` or `ttl` * `data_source.gcs_source.audio_uri` or `data_source.dialogflow_source.audio_uri`", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1474,7 +1474,7 @@ } } }, - "revision": "20240506", + "revision": "20240520", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudContactcenterinsightsV1AgentCoachingInstruction": { diff --git a/contactcenterinsights/v1/contactcenterinsights-gen.go b/contactcenterinsights/v1/contactcenterinsights-gen.go index 5c37adcac5..8f1e4b2240 100644 --- a/contactcenterinsights/v1/contactcenterinsights-gen.go +++ b/contactcenterinsights/v1/contactcenterinsights-gen.go @@ -8888,7 +8888,12 @@ func (r *ProjectsLocationsConversationsService) Patch(name string, googlecloudco } // UpdateMask sets the optional parameter "updateMask": The list of fields to -// be updated. +// be updated. All possible fields can be updated by passing `*`, or a subset +// of the following updateable fields can be provided: * `agent_id` * +// `language_code` * `labels` * `metadata` * `quality_metadata` * +// `call_metadata` * `start_time` * `expire_time` or `ttl` * +// `data_source.gcs_source.audio_uri` or +// `data_source.dialogflow_source.audio_uri` func (c *ProjectsLocationsConversationsPatchCall) UpdateMask(updateMask string) *ProjectsLocationsConversationsPatchCall { c.urlParams_.Set("updateMask", updateMask) return c diff --git a/iam/v1/iam-api.json b/iam/v1/iam-api.json index 231021059c..a555b2e262 100644 --- a/iam/v1/iam-api.json +++ b/iam/v1/iam-api.json @@ -969,7 +969,7 @@ ], "parameters": { "parent": { - "description": "The `parent` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [`projects.roles.create()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/create): `projects/{PROJECT_ID}`. This method creates project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [`organizations.roles.create()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `organizations/{ORGANIZATION_ID}`. This method creates organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `parent` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [projects.roles.create](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/create): `projects/{PROJECT_ID}`. This method creates project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [organizations.roles.create](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `organizations/{ORGANIZATION_ID}`. This method creates organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -1003,7 +1003,7 @@ "type": "string" }, "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`projects.roles.delete()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.delete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [projects.roles.delete](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.delete](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^organizations/[^/]+/roles/[^/]+$", "required": true, @@ -1028,7 +1028,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`. This method returns results from all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * [`projects.roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`. This method returns results from all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * [projects.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^organizations/[^/]+/roles/[^/]+$", "required": true, @@ -1064,7 +1064,7 @@ "type": "string" }, "parent": { - "description": "The `parent` parameter's value depends on the target resource for the request, namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty string. This method doesn't require a resource; it simply returns all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): `projects/{PROJECT_ID}`. This method lists all project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [`organizations.roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): `organizations/{ORGANIZATION_ID}`. This method lists all organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `parent` parameter's value depends on the target resource for the request, namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty string. This method doesn't require a resource; it simply returns all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * [projects.roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): `projects/{PROJECT_ID}`. This method lists all project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [organizations.roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): `organizations/{ORGANIZATION_ID}`. This method lists all organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^organizations/[^/]+$", "required": true, @@ -1107,7 +1107,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`projects.roles.patch()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.patch()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [projects.roles.patch](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.patch](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^organizations/[^/]+/roles/[^/]+$", "required": true, @@ -1141,7 +1141,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`projects.roles.undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/undelete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [projects.roles.undelete](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.undelete](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/undelete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^organizations/[^/]+/roles/[^/]+$", "required": true, @@ -1192,7 +1192,7 @@ "oauthClients": { "methods": { "create": { - "description": "Creates a new OauthClient. You cannot reuse the name of a deleted oauth client until 30 days after deletion.", + "description": "Creates a new OauthClient. You cannot reuse the name of a deleted OauthClient until 30 days after deletion.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/oauthClients", "httpMethod": "POST", "id": "iam.projects.locations.oauthClients.create", @@ -1201,12 +1201,12 @@ ], "parameters": { "oauthClientId": { - "description": "Required. The ID to use for the oauth client, which becomes the final component of the resource name. This value should be a string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not be specified.", + "description": "Required. The ID to use for the OauthClient, which becomes the final component of the resource name. This value should be a string of 6 to 63 lowercase letters, digits, or hyphens. It must start with a letter, and cannot have a trailing hyphen. The prefix `gcp-` is reserved for use by Google, and may not be specified.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The parent resource to create the oauth client in. The only supported location is `global`.", + "description": "Required. The parent resource to create the OauthClient in. The only supported location is `global`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, @@ -1225,7 +1225,7 @@ ] }, "delete": { - "description": "Deletes a OauthClient. You cannot use a deleted oauth client. However, deletion does not revoke access tokens that have already been issued; they continue to grant access. Deletion does revoke refresh tokens that have already been issued; They cannot be used to renew an access token. If the oauth client is undeleted, and the refresh tokens are not expired, they are valid for token exchange again. You can undelete an oauth client for 30 days. After 30 days, deletion is permanent. You cannot update deleted oauth clients. However, you can view and list them.", + "description": "Deletes an OauthClient. You cannot use a deleted OauthClient. However, deletion does not revoke access tokens that have already been issued. They continue to grant access. Deletion does revoke refresh tokens that have already been issued. They cannot be used to renew an access token. If the OauthClient is undeleted, and the refresh tokens are not expired, they are valid for token exchange again. You can undelete an OauthClient for 30 days. After 30 days, deletion is permanent. You cannot update deleted OauthClients. However, you can view and list them.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/oauthClients/{oauthClientsId}", "httpMethod": "DELETE", "id": "iam.projects.locations.oauthClients.delete", @@ -1234,7 +1234,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the oauth client to delete. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", + "description": "Required. The name of the OauthClient to delete. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+$", "required": true, @@ -1259,7 +1259,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the oauth client to retrieve. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", + "description": "Required. The name of the OauthClient to retrieve. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+$", "required": true, @@ -1275,7 +1275,7 @@ ] }, "list": { - "description": "Lists all non-deleted OauthClientss in a project. If `show_deleted` is set to `true`, then deleted oauth clients are also listed.", + "description": "Lists all non-deleted OauthClients in a project. If `show_deleted` is set to `true`, then deleted OauthClients are also listed.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/oauthClients", "httpMethod": "GET", "id": "iam.projects.locations.oauthClients.list", @@ -1284,7 +1284,7 @@ ], "parameters": { "pageSize": { - "description": "Optional. The maximum number of oauth clients to return. If unspecified, at most 50 oauth clients will be returned. The maximum value is 100; values above 100 are truncated to 100.", + "description": "Optional. The maximum number of OauthClients to return. If unspecified, at most 50 OauthClients will be returned. The maximum value is 100; values above 100 are truncated to 100.", "format": "int32", "location": "query", "type": "integer" @@ -1295,14 +1295,14 @@ "type": "string" }, "parent": { - "description": "Required. The parent to list oauth clients for.", + "description": "Required. The parent to list OauthClients for.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string" }, "showDeleted": { - "description": "Optional. Whether to return soft-deleted oauth clients.", + "description": "Optional. Whether to return soft-deleted OauthClients.", "location": "query", "type": "boolean" } @@ -1325,7 +1325,7 @@ ], "parameters": { "name": { - "description": "Immutable. The resource name of the oauth client. Format:`projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", + "description": "Immutable. The resource name of the OauthClient. Format:`projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+$", "required": true, @@ -1350,7 +1350,7 @@ ] }, "undelete": { - "description": "Undeletes a OauthClient, as long as it was deleted fewer than 30 days ago.", + "description": "Undeletes an OauthClient, as long as it was deleted fewer than 30 days ago.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/oauthClients/{oauthClientsId}:undelete", "httpMethod": "POST", "id": "iam.projects.locations.oauthClients.undelete", @@ -1359,7 +1359,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the oauth client to undelete. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", + "description": "Required. The name of the OauthClient to undelete. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+$", "required": true, @@ -1391,12 +1391,12 @@ ], "parameters": { "oauthClientCredentialId": { - "description": "Required. The ID to use for the oauth client credential, which becomes the final component of the resource name. This value should be 4-32 characters, and may contain the characters [a-z0-9-]. The prefix `gcp-` is reserved for use by Google, and may not be specified.", + "description": "Required. The ID to use for the OauthClientCredential, which becomes the final component of the resource name. This value should be 4-32 characters, and may contain the characters [a-z0-9-]. The prefix `gcp-` is reserved for use by Google, and may not be specified.", "location": "query", "type": "string" }, "parent": { - "description": "Required. The parent resource to create the oauth client Credential in.", + "description": "Required. The parent resource to create the OauthClientCredential in.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+$", "required": true, @@ -1415,7 +1415,7 @@ ] }, "delete": { - "description": "Deletes a OauthClientCredential. Before deleting an oauth client credential, it should first be disabled.", + "description": "Deletes an OauthClientCredential. Before deleting an OauthClientCredential, it should first be disabled.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/oauthClients/{oauthClientsId}/credentials/{credentialsId}", "httpMethod": "DELETE", "id": "iam.projects.locations.oauthClients.credentials.delete", @@ -1424,7 +1424,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the oauth client credential to delete. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`.", + "description": "Required. The name of the OauthClientCredential to delete. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+/credentials/[^/]+$", "required": true, @@ -1449,7 +1449,7 @@ ], "parameters": { "name": { - "description": "Required. The name of the oauth client credential to retrieve. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`.", + "description": "Required. The name of the OauthClientCredential to retrieve. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+/credentials/[^/]+$", "required": true, @@ -1465,7 +1465,7 @@ ] }, "list": { - "description": "Lists all OauthClientCredentialss in a OauthClient.", + "description": "Lists all OauthClientCredentials in an OauthClient.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/oauthClients/{oauthClientsId}/credentials", "httpMethod": "GET", "id": "iam.projects.locations.oauthClients.credentials.list", @@ -1474,7 +1474,7 @@ ], "parameters": { "parent": { - "description": "Required. The parent to list oauth client credentials for.", + "description": "Required. The parent to list OauthClientCredentials for.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+$", "required": true, @@ -1499,7 +1499,7 @@ ], "parameters": { "name": { - "description": "Immutable. The resource name of the oauth client credential. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`", + "description": "Immutable. The resource name of the OauthClientCredential. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/oauthClients/[^/]+/credentials/[^/]+$", "required": true, @@ -2269,7 +2269,7 @@ ], "parameters": { "parent": { - "description": "The `parent` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [`projects.roles.create()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/create): `projects/{PROJECT_ID}`. This method creates project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [`organizations.roles.create()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `organizations/{ORGANIZATION_ID}`. This method creates organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `parent` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [projects.roles.create](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/create): `projects/{PROJECT_ID}`. This method creates project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [organizations.roles.create](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): `organizations/{ORGANIZATION_ID}`. This method creates organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2303,7 +2303,7 @@ "type": "string" }, "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`projects.roles.delete()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.delete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [projects.roles.delete](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/delete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.delete](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^projects/[^/]+/roles/[^/]+$", "required": true, @@ -2328,7 +2328,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`. This method returns results from all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * [`projects.roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`. This method returns results from all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * [projects.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^projects/[^/]+/roles/[^/]+$", "required": true, @@ -2364,7 +2364,7 @@ "type": "string" }, "parent": { - "description": "The `parent` parameter's value depends on the target resource for the request, namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty string. This method doesn't require a resource; it simply returns all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): `projects/{PROJECT_ID}`. This method lists all project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [`organizations.roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): `organizations/{ORGANIZATION_ID}`. This method lists all organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `parent` parameter's value depends on the target resource for the request, namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty string. This method doesn't require a resource; it simply returns all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * [projects.roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): `projects/{PROJECT_ID}`. This method lists all project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [organizations.roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): `organizations/{ORGANIZATION_ID}`. This method lists all organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, @@ -2407,7 +2407,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`projects.roles.patch()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.patch()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [projects.roles.patch](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/patch): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.patch](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^projects/[^/]+/roles/[^/]+$", "required": true, @@ -2441,7 +2441,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`projects.roles.undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.undelete()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/undelete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [projects.roles.undelete](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/undelete): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.undelete](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/undelete): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^projects/[^/]+/roles/[^/]+$", "required": true, @@ -2598,7 +2598,7 @@ ] }, "getIamPolicy": { - "description": "Gets the IAM policy that is attached to a ServiceAccount. This IAM policy specifies which principals have access to the service account. This method does not tell you whether the service account has been granted any roles on other resources. To check whether a service account has role grants on a resource, use the `getIamPolicy` method for that resource. For example, to view the role grants for a project, call the Resource Manager API's [`projects.getIamPolicy`](https://cloud.google.com/resource-manager/reference/rest/v1/projects/getIamPolicy) method.", + "description": "Gets the IAM policy that is attached to a ServiceAccount. This IAM policy specifies which principals have access to the service account. This method does not tell you whether the service account has been granted any roles on other resources. To check whether a service account has role grants on a resource, use the `getIamPolicy` method for that resource. For example, to view the role grants for a project, call the Resource Manager API's [projects.getIamPolicy](https://cloud.google.com/resource-manager/reference/rest/v1/projects/getIamPolicy) method.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:getIamPolicy", "httpMethod": "POST", "id": "iam.projects.serviceAccounts.getIamPolicy", @@ -2722,7 +2722,7 @@ }, "signBlob": { "deprecated": true, - "description": "**Note:** This method is deprecated. Use the [`signBlob`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a blob using the system-managed private key for a ServiceAccount.", + "description": "**Note:** This method is deprecated. Use the [signBlob](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a blob using the system-managed private key for a ServiceAccount.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signBlob", "httpMethod": "POST", "id": "iam.projects.serviceAccounts.signBlob", @@ -2751,7 +2751,7 @@ }, "signJwt": { "deprecated": true, - "description": "**Note:** This method is deprecated. Use the [`signJwt`](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a JSON Web Token (JWT) using the system-managed private key for a ServiceAccount.", + "description": "**Note:** This method is deprecated. Use the [signJwt](https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) method in the IAM Service Account Credentials API instead. If you currently use this method, see the [migration guide](https://cloud.google.com/iam/help/credentials/migrate-api) for instructions. Signs a JSON Web Token (JWT) using the system-managed private key for a ServiceAccount.", "flatPath": "v1/projects/{projectsId}/serviceAccounts/{serviceAccountsId}:signJwt", "httpMethod": "POST", "id": "iam.projects.serviceAccounts.signJwt", @@ -3130,7 +3130,7 @@ ], "parameters": { "name": { - "description": "The `name` parameter's value depends on the target resource for the request, namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [`roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`. This method returns results from all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * [`projects.roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [`organizations.roles.get()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `name` parameter's value depends on the target resource for the request, namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `name` value format is described below: * [roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`. This method returns results from all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * [projects.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the project level. Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}` * [organizations.roles.get](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles) that have been created at the organization level. Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "path", "pattern": "^roles/[^/]+$", "required": true, @@ -3164,7 +3164,7 @@ "type": "string" }, "parent": { - "description": "The `parent` parameter's value depends on the target resource for the request, namely [`roles`](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [`projects`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [`organizations`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [`roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty string. This method doesn't require a resource; it simply returns all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * [`projects.roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): `projects/{PROJECT_ID}`. This method lists all project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [`organizations.roles.list()`](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): `organizations/{ORGANIZATION_ID}`. This method lists all organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", + "description": "The `parent` parameter's value depends on the target resource for the request, namely [roles](https://cloud.google.com/iam/docs/reference/rest/v1/roles), [projects](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or [organizations](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below: * [roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty string. This method doesn't require a resource; it simply returns all [predefined roles](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * [projects.roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): `projects/{PROJECT_ID}`. This method lists all project-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * [organizations.roles.list](https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): `organizations/{ORGANIZATION_ID}`. This method lists all organization-level [custom roles](https://cloud.google.com/iam/docs/understanding-custom-roles). Example request URL: `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles` Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.", "location": "query", "type": "string" }, @@ -3216,7 +3216,7 @@ } } }, - "revision": "20240502", + "revision": "20240521", "rootUrl": "https://iam.googleapis.com/", "schemas": { "AccessRestrictions": { @@ -3867,7 +3867,7 @@ "id": "ListOauthClientCredentialsResponse", "properties": { "oauthClientCredentials": { - "description": "A list of oauth client credentials.", + "description": "A list of OauthClientCredentials.", "items": { "$ref": "OauthClientCredential" }, @@ -3885,7 +3885,7 @@ "type": "string" }, "oauthClients": { - "description": "A list of oauth clients.", + "description": "A list of OauthClients.", "items": { "$ref": "OauthClient" }, @@ -4053,11 +4053,11 @@ "type": "object" }, "OauthClient": { - "description": "Represents an oauth client. Used to access Google Cloud resources on behave of a user by using OAuth2 Protocol to obtain an access token from Google Cloud Platform.", + "description": "Represents an OauthClient. Used to access Google Cloud resources on behave of a user by using OAuth 2.0 Protocol to obtain an access token from Google Cloud Platform.", "id": "OauthClient", "properties": { "allowedGrantTypes": { - "description": "Required. The list of OAuth grant type is allowed for the oauth client.", + "description": "Required. The list of OAuth grant types is allowed for the OauthClient.", "items": { "enum": [ "GRANT_TYPE_UNSPECIFIED", @@ -4065,9 +4065,9 @@ "REFRESH_TOKEN_GRANT" ], "enumDescriptions": [ - "should not be used", - "authorization code grant", - "refresh token grant" + "Should not be used.", + "Authorization code grant.", + "Refresh token grant." ], "type": "string" }, @@ -4081,55 +4081,55 @@ "type": "array" }, "allowedScopes": { - "description": "Required. The list of scopes that the oauth client is allowed to request during OAuth flows. The following scopes are supported: * `https://www.googleapis.com/auth/cloud-platform`: See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. * `openid`: Associate you with your personal info on Google Cloud. * `email`: See your Google Cloud Account email address.", + "description": "Required. The list of scopes that the OauthClient is allowed to request during OAuth flows. The following scopes are supported: * `https://www.googleapis.com/auth/cloud-platform`: See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. * `openid`: Associate you with your personal info on Google Cloud. * `email`: See your Google Cloud Account email address.", "items": { "type": "string" }, "type": "array" }, "clientId": { - "description": "Output only. The system-generated oauth client id.", + "description": "Output only. The system-generated OauthClient id.", "readOnly": true, "type": "string" }, "clientType": { - "description": "Immutable. The type of oauth client. either public or private.", + "description": "Immutable. The type of OauthClient. Either public or private. For private clients, the client secret can be managed using the dedicated OauthClientCredential resource.", "enum": [ "CLIENT_TYPE_UNSPECIFIED", "PUBLIC_CLIENT", "CONFIDENTIAL_CLIENT" ], "enumDescriptions": [ - "should not be used", - "public client has no secret", - "private client" + "Should not be used.", + "Public client has no secret.", + "Private client." ], "type": "string" }, "description": { - "description": "Optional. A user-specified description of the oauth client. Cannot exceed 256 characters.", + "description": "Optional. A user-specified description of the OauthClient. Cannot exceed 256 characters.", "type": "string" }, "disabled": { - "description": "Optional. Whether the oauth client is disabled. You cannot use a disabled oauth client for login.", + "description": "Optional. Whether the OauthClient is disabled. You cannot use a disabled OAuth client.", "type": "boolean" }, "displayName": { - "description": "Optional. A user-specified display name of the oauth client. Cannot exceed 32 characters.", + "description": "Optional. A user-specified display name of the OauthClient. Cannot exceed 32 characters.", "type": "string" }, "expireTime": { - "description": "Output only. Time after which the oauth client will be permanently purged and cannot be recovered.", + "description": "Output only. Time after which the OauthClient will be permanently purged and cannot be recovered.", "format": "google-datetime", "readOnly": true, "type": "string" }, "name": { - "description": "Immutable. The resource name of the oauth client. Format:`projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", + "description": "Immutable. The resource name of the OauthClient. Format:`projects/{project}/locations/{location}/oauthClients/{oauth_client}`.", "type": "string" }, "state": { - "description": "Output only. The state of the oauth client.", + "description": "Output only. The state of the OauthClient.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", @@ -4137,8 +4137,8 @@ ], "enumDescriptions": [ "Default value. This value is unused.", - "The oauth client is active.", - "The oauth client is soft-deleted. Soft-deleted oauth client is permanently deleted after approximately 30 days unless restored via UndeleteOauthClient." + "The OauthClient is active.", + "The OauthClient is soft-deleted. Soft-deleted OauthClient is permanently deleted after approximately 30 days unless restored via `UndeleteOauthClient`." ], "readOnly": true, "type": "string" @@ -4147,24 +4147,24 @@ "type": "object" }, "OauthClientCredential": { - "description": "Represents an oauth client credential. Used to authenticate an oauth client while accessing Google Cloud resources on behalf of a user by using OAuth2 Protocol.", + "description": "Represents an OauthClientCredential. Used to authenticate an OauthClient while accessing Google Cloud resources on behalf of a user by using OAuth 2.0 Protocol.", "id": "OauthClientCredential", "properties": { "clientSecret": { - "description": "Output only. The system-generated oauth client secret.", + "description": "Output only. The system-generated OAuth client secret. The client secret must be stored securely. If the client secret is leaked, you must delete and re-create the client credential. To learn more, see [OAuth client and credential security risks and mitigations](https://cloud.google.com/iam/docs/workforce-oauth-app#security)", "readOnly": true, "type": "string" }, "disabled": { - "description": "Optional. Whether the oauth client credential is disabled. You cannot use a disabled oauth client credential for OAuth.", + "description": "Optional. Whether the OauthClientCredential is disabled. You cannot use a disabled OauthClientCredential.", "type": "boolean" }, "displayName": { - "description": "Optional. A user-specified display name of the oauth client credential Cannot exceed 32 characters.", + "description": "Optional. A user-specified display name of the OauthClientCredential. Cannot exceed 32 characters.", "type": "string" }, "name": { - "description": "Immutable. The resource name of the oauth client credential. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`", + "description": "Immutable. The resource name of the OauthClientCredential. Format: `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credentials/{credential}`", "type": "string" } }, diff --git a/iam/v1/iam-gen.go b/iam/v1/iam-gen.go index 40b1634f66..f934b274ad 100644 --- a/iam/v1/iam-gen.go +++ b/iam/v1/iam-gen.go @@ -1605,7 +1605,7 @@ func (s *LintResult) MarshalJSON() ([]byte, error) { // ListOauthClientCredentialsResponse: Response message for // ListOauthClientCredentials. type ListOauthClientCredentialsResponse struct { - // OauthClientCredentials: A list of oauth client credentials. + // OauthClientCredentials: A list of OauthClientCredentials. OauthClientCredentials []*OauthClientCredential `json:"oauthClientCredentials,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1634,7 +1634,7 @@ type ListOauthClientsResponse struct { // retrieve the next page. If this field is omitted, there are no subsequent // pages. NextPageToken string `json:"nextPageToken,omitempty"` - // OauthClients: A list of oauth clients. + // OauthClients: A list of OauthClients. OauthClients []*OauthClient `json:"oauthClients,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1912,60 +1912,62 @@ func (s *ListWorkloadIdentityPoolsResponse) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// OauthClient: Represents an oauth client. Used to access Google Cloud -// resources on behave of a user by using OAuth2 Protocol to obtain an access -// token from Google Cloud Platform. +// OauthClient: Represents an OauthClient. Used to access Google Cloud +// resources on behave of a user by using OAuth 2.0 Protocol to obtain an +// access token from Google Cloud Platform. type OauthClient struct { - // AllowedGrantTypes: Required. The list of OAuth grant type is allowed for the - // oauth client. + // AllowedGrantTypes: Required. The list of OAuth grant types is allowed for + // the OauthClient. // // Possible values: - // "GRANT_TYPE_UNSPECIFIED" - should not be used - // "AUTHORIZATION_CODE_GRANT" - authorization code grant - // "REFRESH_TOKEN_GRANT" - refresh token grant + // "GRANT_TYPE_UNSPECIFIED" - Should not be used. + // "AUTHORIZATION_CODE_GRANT" - Authorization code grant. + // "REFRESH_TOKEN_GRANT" - Refresh token grant. AllowedGrantTypes []string `json:"allowedGrantTypes,omitempty"` // AllowedRedirectUris: Required. The list of redirect uris that is allowed to // redirect back when authorization process is completed. AllowedRedirectUris []string `json:"allowedRedirectUris,omitempty"` - // AllowedScopes: Required. The list of scopes that the oauth client is allowed + // AllowedScopes: Required. The list of scopes that the OauthClient is allowed // to request during OAuth flows. The following scopes are supported: * // `https://www.googleapis.com/auth/cloud-platform`: See, edit, configure, and // delete your Google Cloud data and see the email address for your Google // Account. * `openid`: Associate you with your personal info on Google Cloud. // * `email`: See your Google Cloud Account email address. AllowedScopes []string `json:"allowedScopes,omitempty"` - // ClientId: Output only. The system-generated oauth client id. + // ClientId: Output only. The system-generated OauthClient id. ClientId string `json:"clientId,omitempty"` - // ClientType: Immutable. The type of oauth client. either public or private. + // ClientType: Immutable. The type of OauthClient. Either public or private. + // For private clients, the client secret can be managed using the dedicated + // OauthClientCredential resource. // // Possible values: - // "CLIENT_TYPE_UNSPECIFIED" - should not be used - // "PUBLIC_CLIENT" - public client has no secret - // "CONFIDENTIAL_CLIENT" - private client + // "CLIENT_TYPE_UNSPECIFIED" - Should not be used. + // "PUBLIC_CLIENT" - Public client has no secret. + // "CONFIDENTIAL_CLIENT" - Private client. ClientType string `json:"clientType,omitempty"` - // Description: Optional. A user-specified description of the oauth client. + // Description: Optional. A user-specified description of the OauthClient. // Cannot exceed 256 characters. Description string `json:"description,omitempty"` - // Disabled: Optional. Whether the oauth client is disabled. You cannot use a - // disabled oauth client for login. + // Disabled: Optional. Whether the OauthClient is disabled. You cannot use a + // disabled OAuth client. Disabled bool `json:"disabled,omitempty"` - // DisplayName: Optional. A user-specified display name of the oauth client. + // DisplayName: Optional. A user-specified display name of the OauthClient. // Cannot exceed 32 characters. DisplayName string `json:"displayName,omitempty"` - // ExpireTime: Output only. Time after which the oauth client will be + // ExpireTime: Output only. Time after which the OauthClient will be // permanently purged and cannot be recovered. ExpireTime string `json:"expireTime,omitempty"` - // Name: Immutable. The resource name of the oauth client. + // Name: Immutable. The resource name of the OauthClient. // Format:`projects/{project}/locations/{location}/oauthClients/{oauth_client}`. Name string `json:"name,omitempty"` - // State: Output only. The state of the oauth client. + // State: Output only. The state of the OauthClient. // // Possible values: // "STATE_UNSPECIFIED" - Default value. This value is unused. - // "ACTIVE" - The oauth client is active. - // "DELETED" - The oauth client is soft-deleted. Soft-deleted oauth client is + // "ACTIVE" - The OauthClient is active. + // "DELETED" - The OauthClient is soft-deleted. Soft-deleted OauthClient is // permanently deleted after approximately 30 days unless restored via - // UndeleteOauthClient. + // `UndeleteOauthClient`. State string `json:"state,omitempty"` // ServerResponse contains the HTTP response code and headers from the server. @@ -1988,19 +1990,23 @@ func (s *OauthClient) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } -// OauthClientCredential: Represents an oauth client credential. Used to -// authenticate an oauth client while accessing Google Cloud resources on -// behalf of a user by using OAuth2 Protocol. +// OauthClientCredential: Represents an OauthClientCredential. Used to +// authenticate an OauthClient while accessing Google Cloud resources on behalf +// of a user by using OAuth 2.0 Protocol. type OauthClientCredential struct { - // ClientSecret: Output only. The system-generated oauth client secret. + // ClientSecret: Output only. The system-generated OAuth client secret. The + // client secret must be stored securely. If the client secret is leaked, you + // must delete and re-create the client credential. To learn more, see OAuth + // client and credential security risks and mitigations + // (https://cloud.google.com/iam/docs/workforce-oauth-app#security) ClientSecret string `json:"clientSecret,omitempty"` - // Disabled: Optional. Whether the oauth client credential is disabled. You - // cannot use a disabled oauth client credential for OAuth. + // Disabled: Optional. Whether the OauthClientCredential is disabled. You + // cannot use a disabled OauthClientCredential. Disabled bool `json:"disabled,omitempty"` - // DisplayName: Optional. A user-specified display name of the oauth client - // credential Cannot exceed 32 characters. + // DisplayName: Optional. A user-specified display name of the + // OauthClientCredential. Cannot exceed 32 characters. DisplayName string `json:"displayName,omitempty"` - // Name: Immutable. The resource name of the oauth client credential. Format: + // Name: Immutable. The resource name of the OauthClientCredential. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}/credenti // als/{credential}` Name string `json:"name,omitempty"` @@ -6842,17 +6848,17 @@ type OrganizationsRolesCreateCall struct { // Create: Creates a new custom Role. // // - parent: The `parent` parameter's value depends on the target resource for -// the request, namely `projects` +// the request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `parent` value format is described below: * -// `projects.roles.create()` +// projects.roles.create // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/create): // `projects/{PROJECT_ID}`. This method creates project-level custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles). Example // request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// `organizations.roles.create()` +// organizations.roles.create // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): // `organizations/{ORGANIZATION_ID}`. This method creates organization-level // custom roles @@ -6968,19 +6974,19 @@ type OrganizationsRolesDeleteCall struct { // the custom role, the binding is permanently removed. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `projects` +// request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `name` value format is described below: * -// `projects.roles.delete()` +// projects.roles.delete // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/delete): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.delete()` +// ` * organizations.roles.delete // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // deletes only custom roles @@ -7092,25 +7098,24 @@ type OrganizationsRolesGetCall struct { // Get: Gets the definition of a Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `roles` -// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), `projects` +// request, namely roles +// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). -// Each resource type's `name` value format is described below: * -// `roles.get()` +// Each resource type's `name` value format is described below: * roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): // `roles/{ROLE_NAME}`. This method returns results from all predefined roles // (https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) // in IAM. Example request URL: -// `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * `projects.roles.get()` +// `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * projects.roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.get()` +// ` * organizations.roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // returns only custom roles @@ -7227,24 +7232,24 @@ type OrganizationsRolesListCall struct { // that is defined for an organization or project. // // - parent: The `parent` parameter's value depends on the target resource for -// the request, namely `roles` -// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), `projects` +// the request, namely roles +// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `parent` value format is described below: * -// `roles.list()` +// roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty // string. This method doesn't require a resource; it simply returns all // predefined roles // (https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) // in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * -// `projects.roles.list()` +// projects.roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): // `projects/{PROJECT_ID}`. This method lists all project-level custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles). Example // request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// `organizations.roles.list()` +// organizations.roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): // `organizations/{ORGANIZATION_ID}`. This method lists all // organization-level custom roles @@ -7421,19 +7426,19 @@ type OrganizationsRolesPatchCall struct { // Patch: Updates the definition of a custom Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `projects` +// request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `name` value format is described below: * -// `projects.roles.patch()` +// projects.roles.patch // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/patch): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.patch()` +// ` * organizations.roles.patch // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // updates only custom roles @@ -7550,19 +7555,19 @@ type OrganizationsRolesUndeleteCall struct { // Undelete: Undeletes a custom Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `projects` +// request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `name` value format is described below: * -// `projects.roles.undelete()` +// projects.roles.undelete // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/undelete): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.undelete()` +// ` * organizations.roles.undelete // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/undelete): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // undeletes only custom roles @@ -7788,9 +7793,9 @@ type ProjectsLocationsOauthClientsCreateCall struct { } // Create: Creates a new OauthClient. You cannot reuse the name of a deleted -// oauth client until 30 days after deletion. +// OauthClient until 30 days after deletion. // -// - parent: The parent resource to create the oauth client in. The only +// - parent: The parent resource to create the OauthClient in. The only // supported location is `global`. func (r *ProjectsLocationsOauthClientsService) Create(parent string, oauthclient *OauthClient) *ProjectsLocationsOauthClientsCreateCall { c := &ProjectsLocationsOauthClientsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -7800,7 +7805,7 @@ func (r *ProjectsLocationsOauthClientsService) Create(parent string, oauthclient } // OauthClientId sets the optional parameter "oauthClientId": Required. The ID -// to use for the oauth client, which becomes the final component of the +// to use for the OauthClient, which becomes the final component of the // resource name. This value should be a string of 6 to 63 lowercase letters, // digits, or hyphens. It must start with a letter, and cannot have a trailing // hyphen. The prefix `gcp-` is reserved for use by Google, and may not be @@ -7900,16 +7905,16 @@ type ProjectsLocationsOauthClientsDeleteCall struct { header_ http.Header } -// Delete: Deletes a OauthClient. You cannot use a deleted oauth client. +// Delete: Deletes an OauthClient. You cannot use a deleted OauthClient. // However, deletion does not revoke access tokens that have already been -// issued; they continue to grant access. Deletion does revoke refresh tokens -// that have already been issued; They cannot be used to renew an access token. -// If the oauth client is undeleted, and the refresh tokens are not expired, -// they are valid for token exchange again. You can undelete an oauth client -// for 30 days. After 30 days, deletion is permanent. You cannot update deleted -// oauth clients. However, you can view and list them. -// -// - name: The name of the oauth client to delete. Format: +// issued. They continue to grant access. Deletion does revoke refresh tokens +// that have already been issued. They cannot be used to renew an access token. +// If the OauthClient is undeleted, and the refresh tokens are not expired, +// they are valid for token exchange again. You can undelete an OauthClient for +// 30 days. After 30 days, deletion is permanent. You cannot update deleted +// OauthClients. However, you can view and list them. +// +// - name: The name of the OauthClient to delete. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}`. func (r *ProjectsLocationsOauthClientsService) Delete(name string) *ProjectsLocationsOauthClientsDeleteCall { c := &ProjectsLocationsOauthClientsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -8006,7 +8011,7 @@ type ProjectsLocationsOauthClientsGetCall struct { // Get: Gets an individual OauthClient. // -// - name: The name of the oauth client to retrieve. Format: +// - name: The name of the OauthClient to retrieve. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}`. func (r *ProjectsLocationsOauthClientsService) Get(name string) *ProjectsLocationsOauthClientsGetCall { c := &ProjectsLocationsOauthClientsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -8112,18 +8117,18 @@ type ProjectsLocationsOauthClientsListCall struct { header_ http.Header } -// List: Lists all non-deleted OauthClientss in a project. If `show_deleted` is -// set to `true`, then deleted oauth clients are also listed. +// List: Lists all non-deleted OauthClients in a project. If `show_deleted` is +// set to `true`, then deleted OauthClients are also listed. // -// - parent: The parent to list oauth clients for. +// - parent: The parent to list OauthClients for. func (r *ProjectsLocationsOauthClientsService) List(parent string) *ProjectsLocationsOauthClientsListCall { c := &ProjectsLocationsOauthClientsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent return c } -// PageSize sets the optional parameter "pageSize": The maximum number of oauth -// clients to return. If unspecified, at most 50 oauth clients will be +// PageSize sets the optional parameter "pageSize": The maximum number of +// OauthClients to return. If unspecified, at most 50 OauthClients will be // returned. The maximum value is 100; values above 100 are truncated to 100. func (c *ProjectsLocationsOauthClientsListCall) PageSize(pageSize int64) *ProjectsLocationsOauthClientsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) @@ -8139,7 +8144,7 @@ func (c *ProjectsLocationsOauthClientsListCall) PageToken(pageToken string) *Pro } // ShowDeleted sets the optional parameter "showDeleted": Whether to return -// soft-deleted oauth clients. +// soft-deleted OauthClients. func (c *ProjectsLocationsOauthClientsListCall) ShowDeleted(showDeleted bool) *ProjectsLocationsOauthClientsListCall { c.urlParams_.Set("showDeleted", fmt.Sprint(showDeleted)) return c @@ -8267,7 +8272,7 @@ type ProjectsLocationsOauthClientsPatchCall struct { // Patch: Updates an existing OauthClient. // -// - name: Immutable. The resource name of the oauth client. +// - name: Immutable. The resource name of the OauthClient. // Format:`projects/{project}/locations/{location}/oauthClients/{oauth_client} // `. func (r *ProjectsLocationsOauthClientsService) Patch(name string, oauthclient *OauthClient) *ProjectsLocationsOauthClientsPatchCall { @@ -8375,10 +8380,10 @@ type ProjectsLocationsOauthClientsUndeleteCall struct { header_ http.Header } -// Undelete: Undeletes a OauthClient, as long as it was deleted fewer than 30 +// Undelete: Undeletes an OauthClient, as long as it was deleted fewer than 30 // days ago. // -// - name: The name of the oauth client to undelete. Format: +// - name: The name of the OauthClient to undelete. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}`. func (r *ProjectsLocationsOauthClientsService) Undelete(name string, undeleteoauthclientrequest *UndeleteOauthClientRequest) *ProjectsLocationsOauthClientsUndeleteCall { c := &ProjectsLocationsOauthClientsUndeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} @@ -8480,7 +8485,7 @@ type ProjectsLocationsOauthClientsCredentialsCreateCall struct { // Create: Creates a new OauthClientCredential. // -// - parent: The parent resource to create the oauth client Credential in. +// - parent: The parent resource to create the OauthClientCredential in. func (r *ProjectsLocationsOauthClientsCredentialsService) Create(parent string, oauthclientcredential *OauthClientCredential) *ProjectsLocationsOauthClientsCredentialsCreateCall { c := &ProjectsLocationsOauthClientsCredentialsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8489,10 +8494,11 @@ func (r *ProjectsLocationsOauthClientsCredentialsService) Create(parent string, } // OauthClientCredentialId sets the optional parameter -// "oauthClientCredentialId": Required. The ID to use for the oauth client -// credential, which becomes the final component of the resource name. This -// value should be 4-32 characters, and may contain the characters [a-z0-9-]. -// The prefix `gcp-` is reserved for use by Google, and may not be specified. +// "oauthClientCredentialId": Required. The ID to use for the +// OauthClientCredential, which becomes the final component of the resource +// name. This value should be 4-32 characters, and may contain the characters +// [a-z0-9-]. The prefix `gcp-` is reserved for use by Google, and may not be +// specified. func (c *ProjectsLocationsOauthClientsCredentialsCreateCall) OauthClientCredentialId(oauthClientCredentialId string) *ProjectsLocationsOauthClientsCredentialsCreateCall { c.urlParams_.Set("oauthClientCredentialId", oauthClientCredentialId) return c @@ -8589,10 +8595,10 @@ type ProjectsLocationsOauthClientsCredentialsDeleteCall struct { header_ http.Header } -// Delete: Deletes a OauthClientCredential. Before deleting an oauth client -// credential, it should first be disabled. +// Delete: Deletes an OauthClientCredential. Before deleting an +// OauthClientCredential, it should first be disabled. // -// - name: The name of the oauth client credential to delete. Format: +// - name: The name of the OauthClientCredential to delete. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}/creden // tials/{credential}`. func (r *ProjectsLocationsOauthClientsCredentialsService) Delete(name string) *ProjectsLocationsOauthClientsCredentialsDeleteCall { @@ -8690,7 +8696,7 @@ type ProjectsLocationsOauthClientsCredentialsGetCall struct { // Get: Gets an individual OauthClientCredential. // -// - name: The name of the oauth client credential to retrieve. Format: +// - name: The name of the OauthClientCredential to retrieve. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}/creden // tials/{credential}`. func (r *ProjectsLocationsOauthClientsCredentialsService) Get(name string) *ProjectsLocationsOauthClientsCredentialsGetCall { @@ -8798,9 +8804,9 @@ type ProjectsLocationsOauthClientsCredentialsListCall struct { header_ http.Header } -// List: Lists all OauthClientCredentialss in a OauthClient. +// List: Lists all OauthClientCredentials in an OauthClient. // -// - parent: The parent to list oauth client credentials for. +// - parent: The parent to list OauthClientCredentials for. func (r *ProjectsLocationsOauthClientsCredentialsService) List(parent string) *ProjectsLocationsOauthClientsCredentialsListCall { c := &ProjectsLocationsOauthClientsCredentialsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.parent = parent @@ -8908,7 +8914,7 @@ type ProjectsLocationsOauthClientsCredentialsPatchCall struct { // Patch: Updates an existing OauthClientCredential. // -// - name: Immutable. The resource name of the oauth client credential. Format: +// - name: Immutable. The resource name of the OauthClientCredential. Format: // `projects/{project}/locations/{location}/oauthClients/{oauth_client}/creden // tials/{credential}`. func (r *ProjectsLocationsOauthClientsCredentialsService) Patch(name string, oauthclientcredential *OauthClientCredential) *ProjectsLocationsOauthClientsCredentialsPatchCall { @@ -11614,17 +11620,17 @@ type ProjectsRolesCreateCall struct { // Create: Creates a new custom Role. // // - parent: The `parent` parameter's value depends on the target resource for -// the request, namely `projects` +// the request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `parent` value format is described below: * -// `projects.roles.create()` +// projects.roles.create // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/create): // `projects/{PROJECT_ID}`. This method creates project-level custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles). Example // request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// `organizations.roles.create()` +// organizations.roles.create // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/create): // `organizations/{ORGANIZATION_ID}`. This method creates organization-level // custom roles @@ -11740,19 +11746,19 @@ type ProjectsRolesDeleteCall struct { // the custom role, the binding is permanently removed. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `projects` +// request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `name` value format is described below: * -// `projects.roles.delete()` +// projects.roles.delete // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/delete): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.delete()` +// ` * organizations.roles.delete // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/delete): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // deletes only custom roles @@ -11864,25 +11870,24 @@ type ProjectsRolesGetCall struct { // Get: Gets the definition of a Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `roles` -// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), `projects` +// request, namely roles +// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). -// Each resource type's `name` value format is described below: * -// `roles.get()` +// Each resource type's `name` value format is described below: * roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): // `roles/{ROLE_NAME}`. This method returns results from all predefined roles // (https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) // in IAM. Example request URL: -// `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * `projects.roles.get()` +// `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * projects.roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.get()` +// ` * organizations.roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // returns only custom roles @@ -11999,24 +12004,24 @@ type ProjectsRolesListCall struct { // that is defined for an organization or project. // // - parent: The `parent` parameter's value depends on the target resource for -// the request, namely `roles` -// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), `projects` +// the request, namely roles +// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `parent` value format is described below: * -// `roles.list()` +// roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty // string. This method doesn't require a resource; it simply returns all // predefined roles // (https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) // in IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * -// `projects.roles.list()` +// projects.roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): // `projects/{PROJECT_ID}`. This method lists all project-level custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles). Example // request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// `organizations.roles.list()` +// organizations.roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): // `organizations/{ORGANIZATION_ID}`. This method lists all // organization-level custom roles @@ -12193,19 +12198,19 @@ type ProjectsRolesPatchCall struct { // Patch: Updates the definition of a custom Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `projects` +// request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `name` value format is described below: * -// `projects.roles.patch()` +// projects.roles.patch // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/patch): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.patch()` +// ` * organizations.roles.patch // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/patch): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // updates only custom roles @@ -12322,19 +12327,19 @@ type ProjectsRolesUndeleteCall struct { // Undelete: Undeletes a custom Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `projects` +// request, namely projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles) or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). // Each resource type's `name` value format is described below: * -// `projects.roles.undelete()` +// projects.roles.undelete // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/undelete): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.undelete()` +// ` * organizations.roles.undelete // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/undelete): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // undeletes only custom roles @@ -13016,7 +13021,7 @@ type ProjectsServiceAccountsGetIamPolicyCall struct { // any roles on other resources. To check whether a service account has role // grants on a resource, use the `getIamPolicy` method for that resource. For // example, to view the role grants for a project, call the Resource Manager -// API's `projects.getIamPolicy` +// API's projects.getIamPolicy // (https://cloud.google.com/resource-manager/reference/rest/v1/projects/getIamPolicy) // method. // @@ -13506,7 +13511,7 @@ type ProjectsServiceAccountsSignBlobCall struct { header_ http.Header } -// SignBlob: **Note:** This method is deprecated. Use the `signBlob` +// SignBlob: **Note:** This method is deprecated. Use the signBlob // (https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signBlob) // method in the IAM Service Account Credentials API instead. If you currently // use this method, see the migration guide @@ -13626,7 +13631,7 @@ type ProjectsServiceAccountsSignJwtCall struct { header_ http.Header } -// SignJwt: **Note:** This method is deprecated. Use the `signJwt` +// SignJwt: **Note:** This method is deprecated. Use the signJwt // (https://cloud.google.com/iam/help/rest-credentials/v1/projects.serviceAccounts/signJwt) // method in the IAM Service Account Credentials API instead. If you currently // use this method, see the migration guide @@ -15019,25 +15024,24 @@ type RolesGetCall struct { // Get: Gets the definition of a Role. // // - name: The `name` parameter's value depends on the target resource for the -// request, namely `roles` -// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), `projects` +// request, namely roles +// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). -// Each resource type's `name` value format is described below: * -// `roles.get()` +// Each resource type's `name` value format is described below: * roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/roles/get): // `roles/{ROLE_NAME}`. This method returns results from all predefined roles // (https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) // in IAM. Example request URL: -// `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * `projects.roles.get()` +// `https://iam.googleapis.com/v1/roles/{ROLE_NAME}` * projects.roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/get): // `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only // custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles) that have // been created at the project level. Example request URL: // `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID} -// ` * `organizations.roles.get()` +// ` * organizations.roles.get // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/get): // `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method // returns only custom roles @@ -15172,24 +15176,23 @@ func (c *RolesListCall) PageToken(pageToken string) *RolesListCall { } // Parent sets the optional parameter "parent": The `parent` parameter's value -// depends on the target resource for the request, namely `roles` -// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), `projects` +// depends on the target resource for the request, namely roles +// (https://cloud.google.com/iam/docs/reference/rest/v1/roles), projects // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles), or -// `organizations` +// organizations // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles). -// Each resource type's `parent` value format is described below: * -// `roles.list()` +// Each resource type's `parent` value format is described below: * roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/roles/list): An empty // string. This method doesn't require a resource; it simply returns all // predefined roles // (https://cloud.google.com/iam/docs/understanding-roles#predefined_roles) in // IAM. Example request URL: `https://iam.googleapis.com/v1/roles` * -// `projects.roles.list()` +// projects.roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/projects.roles/list): // `projects/{PROJECT_ID}`. This method lists all project-level custom roles // (https://cloud.google.com/iam/docs/understanding-custom-roles). Example // request URL: `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles` * -// `organizations.roles.list()` +// organizations.roles.list // (https://cloud.google.com/iam/docs/reference/rest/v1/organizations.roles/list): // `organizations/{ORGANIZATION_ID}`. This method lists all organization-level // custom roles (https://cloud.google.com/iam/docs/understanding-custom-roles). diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json index 73ac0ecf9a..5e10093f7d 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-api.json @@ -2653,7 +2653,7 @@ } } }, - "revision": "20240211", + "revision": "20240520", "rootUrl": "https://prod-tt-sasportal.googleapis.com/", "schemas": { "SasPortalAssignment": { @@ -3201,9 +3201,9 @@ "type": "integer" }, "antennaGain": { - "description": "Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.", - "format": "int32", - "type": "integer" + "description": "Peak antenna gain in dBi. This parameter is a double with a value between -127 and +128 (dBi) inclusive. Part of Release 2 to support floating-point value", + "format": "double", + "type": "number" }, "antennaModel": { "description": "If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.", diff --git a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go index 160b0abde7..10cf855e3c 100644 --- a/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go +++ b/prod_tt_sasportal/v1alpha1/prod_tt_sasportal-gen.go @@ -1042,9 +1042,10 @@ type SasPortalInstallationParams struct { // up (above horizontal). This parameter is optional for Category A devices and // conditional for Category B devices. AntennaDowntilt int64 `json:"antennaDowntilt,omitempty"` - // AntennaGain: Peak antenna gain in dBi. This parameter is an integer with a - // value between -127 and +128 (dBi) inclusive. - AntennaGain int64 `json:"antennaGain,omitempty"` + // AntennaGain: Peak antenna gain in dBi. This parameter is a double with a + // value between -127 and +128 (dBi) inclusive. Part of Release 2 to support + // floating-point value + AntennaGain float64 `json:"antennaGain,omitempty"` // AntennaModel: If an external antenna is used, the antenna model is // optionally provided in this field. The string has a maximum length of 128 // octets. @@ -1112,6 +1113,7 @@ func (s *SasPortalInstallationParams) MarshalJSON() ([]byte, error) { func (s *SasPortalInstallationParams) UnmarshalJSON(data []byte) error { type NoMethod SasPortalInstallationParams var s1 struct { + AntennaGain gensupport.JSONFloat64 `json:"antennaGain"` Height gensupport.JSONFloat64 `json:"height"` HorizontalAccuracy gensupport.JSONFloat64 `json:"horizontalAccuracy"` Latitude gensupport.JSONFloat64 `json:"latitude"` @@ -1123,6 +1125,7 @@ func (s *SasPortalInstallationParams) UnmarshalJSON(data []byte) error { if err := json.Unmarshal(data, &s1); err != nil { return err } + s.AntennaGain = float64(s1.AntennaGain) s.Height = float64(s1.Height) s.HorizontalAccuracy = float64(s1.HorizontalAccuracy) s.Latitude = float64(s1.Latitude) diff --git a/recaptchaenterprise/v1/recaptchaenterprise-api.json b/recaptchaenterprise/v1/recaptchaenterprise-api.json index 32e5ef42f1..4f112cf59a 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-api.json +++ b/recaptchaenterprise/v1/recaptchaenterprise-api.json @@ -694,7 +694,7 @@ } } }, - "revision": "20240324", + "revision": "20240518", "rootUrl": "https://recaptchaenterprise.googleapis.com/", "schemas": { "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": { @@ -948,6 +948,11 @@ "readOnly": true, "type": "string" }, + "phoneFraudAssessment": { + "$ref": "GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment", + "description": "Output only. Assessment returned when a site key, a token, and a phone number as `user_id` are provided. Account defender and SMS toll fraud protection need to be enabled.", + "readOnly": true + }, "privatePasswordLeakVerification": { "$ref": "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification", "description": "Optional. The private password leak verification field contains the parameters that are used to to check for leaks privately without sharing user credentials." @@ -1542,6 +1547,18 @@ }, "type": "object" }, + "GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment": { + "description": "Assessment for Phone Fraud", + "id": "GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment", + "properties": { + "smsTollFraudVerdict": { + "$ref": "GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict", + "description": "Output only. Assessment of this phone event for risk of sms toll fraud.", + "readOnly": true + } + }, + "type": "object" + }, "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification": { "description": "Private password leak verification info.", "id": "GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification", @@ -1763,6 +1780,35 @@ }, "type": "object" }, + "GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict": { + "description": "Information about sms toll fraud", + "id": "GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict", + "properties": { + "reasons": { + "description": "Output only. Reasons contributing to the SMS toll fraud verdict.", + "items": { + "enum": [ + "SMS_TOLL_FRAUD_REASON_UNSPECIFIED", + "INVALID_PHONE_NUMBER" + ], + "enumDescriptions": [ + "Default unspecified reason", + "The provided phone number was invalid" + ], + "type": "string" + }, + "readOnly": true, + "type": "array" + }, + "risk": { + "description": "Output only. Probability of an sms event being fraudulent. Values are from 0.0 (lowest) to 1.0 (highest).", + "format": "float", + "readOnly": true, + "type": "number" + } + }, + "type": "object" + }, "GoogleCloudRecaptchaenterpriseV1TestingOptions": { "description": "Options for user acceptance testing.", "id": "GoogleCloudRecaptchaenterpriseV1TestingOptions", diff --git a/recaptchaenterprise/v1/recaptchaenterprise-gen.go b/recaptchaenterprise/v1/recaptchaenterprise-gen.go index 085ec45682..be7b659589 100644 --- a/recaptchaenterprise/v1/recaptchaenterprise-gen.go +++ b/recaptchaenterprise/v1/recaptchaenterprise-gen.go @@ -510,6 +510,10 @@ type GoogleCloudRecaptchaenterpriseV1Assessment struct { // Name: Output only. Identifier. The resource name for the Assessment in the // format `projects/{project}/assessments/{assessment}`. Name string `json:"name,omitempty"` + // PhoneFraudAssessment: Output only. Assessment returned when a site key, a + // token, and a phone number as `user_id` are provided. Account defender and + // SMS toll fraud protection need to be enabled. + PhoneFraudAssessment *GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment `json:"phoneFraudAssessment,omitempty"` // PrivatePasswordLeakVerification: Optional. The private password leak // verification field contains the parameters that are used to to check for // leaks privately without sharing user credentials. @@ -1409,6 +1413,30 @@ func (s *GoogleCloudRecaptchaenterpriseV1MigrateKeyRequest) MarshalJSON() ([]byt return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment: Assessment for Phone +// Fraud +type GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment struct { + // SmsTollFraudVerdict: Output only. Assessment of this phone event for risk of + // sms toll fraud. + SmsTollFraudVerdict *GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict `json:"smsTollFraudVerdict,omitempty"` + // ForceSendFields is a list of field names (e.g. "SmsTollFraudVerdict") to + // unconditionally include in API requests. By default, fields with empty or + // default values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "SmsTollFraudVerdict") to include + // in API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecaptchaenterpriseV1PhoneFraudAssessment + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + // GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification: Private // password leak verification info. type GoogleCloudRecaptchaenterpriseV1PrivatePasswordLeakVerification struct { @@ -1750,6 +1778,50 @@ func (s *GoogleCloudRecaptchaenterpriseV1SearchRelatedAccountGroupMembershipsRes return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) } +// GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict: Information about sms +// toll fraud +type GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict struct { + // Reasons: Output only. Reasons contributing to the SMS toll fraud verdict. + // + // Possible values: + // "SMS_TOLL_FRAUD_REASON_UNSPECIFIED" - Default unspecified reason + // "INVALID_PHONE_NUMBER" - The provided phone number was invalid + Reasons []string `json:"reasons,omitempty"` + // Risk: Output only. Probability of an sms event being fraudulent. Values are + // from 0.0 (lowest) to 1.0 (highest). + Risk float64 `json:"risk,omitempty"` + // ForceSendFields is a list of field names (e.g. "Reasons") to unconditionally + // include in API requests. By default, fields with empty or default values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more + // details. + ForceSendFields []string `json:"-"` + // NullFields is a list of field names (e.g. "Reasons") to include in API + // requests with the JSON null value. By default, fields with empty values are + // omitted from API requests. See + // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. + NullFields []string `json:"-"` +} + +func (s *GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict) MarshalJSON() ([]byte, error) { + type NoMethod GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict + return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields) +} + +func (s *GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict) UnmarshalJSON(data []byte) error { + type NoMethod GoogleCloudRecaptchaenterpriseV1SmsTollFraudVerdict + var s1 struct { + Risk gensupport.JSONFloat64 `json:"risk"` + *NoMethod + } + s1.NoMethod = (*NoMethod)(s) + if err := json.Unmarshal(data, &s1); err != nil { + return err + } + s.Risk = float64(s1.Risk) + return nil +} + // GoogleCloudRecaptchaenterpriseV1TestingOptions: Options for user acceptance // testing. type GoogleCloudRecaptchaenterpriseV1TestingOptions struct { diff --git a/sheets/v4/sheets-api.json b/sheets/v4/sheets-api.json index 9c988ae694..7a664b09b9 100644 --- a/sheets/v4/sheets-api.json +++ b/sheets/v4/sheets-api.json @@ -870,7 +870,7 @@ } } }, - "revision": "20240423", + "revision": "20240514", "rootUrl": "https://sheets.googleapis.com/", "schemas": { "AddBandingRequest": { @@ -5904,7 +5904,7 @@ "type": "object" }, "RefreshCancellationStatus": { - "description": "The status of a refresh cancellation. You can send cancel request to explicitly cancel one or multiple data source object refreshes.", + "description": "The status of a refresh cancellation. You can send a cancel request to explicitly cancel one or multiple data source object refreshes.", "id": "RefreshCancellationStatus", "properties": { "errorCode": { diff --git a/sheets/v4/sheets-gen.go b/sheets/v4/sheets-gen.go index 6e0da07ecd..7e7901dfda 100644 --- a/sheets/v4/sheets-gen.go +++ b/sheets/v4/sheets-gen.go @@ -6933,8 +6933,8 @@ func (s *RandomizeRangeRequest) MarshalJSON() ([]byte, error) { } // RefreshCancellationStatus: The status of a refresh cancellation. You can -// send cancel request to explicitly cancel one or multiple data source object -// refreshes. +// send a cancel request to explicitly cancel one or multiple data source +// object refreshes. type RefreshCancellationStatus struct { // ErrorCode: The error code. //