|
1282 | 1282 | ], |
1283 | 1283 | "parameters": { |
1284 | 1284 | "parent": { |
1285 | | - "description": "Required. [Resource name](https://cloud.google.com/apis/design/resource_names) of the group to search transitive memberships in. Format: `groups/{group_id}`, where `group_id` is the unique ID assigned to the Group to which the Membership belongs to. group_id can be a wildcard collection id \"-\". When a group_id is specified, the membership graph will be constrained to paths between the member (defined in the query) and the parent. If a wildcard collection is provided, all membership paths connected to the member will be returned.", |
| 1285 | + "description": "Required. [Resource name](https://cloud.google.com/apis/design/resource_names) of the group to search transitive memberships in. Format: `groups/{group_id}`, where `group_id` is the unique ID assigned to the Group to which the Membership belongs to. group_id can be a wildcard collection id \"-\". When `group_id` is specified, the membership graph will be constrained to paths between the member (defined in the query) and the parent. If a wildcard collection is provided, all membership paths connected to the member will be returned.", |
1286 | 1286 | "location": "path", |
1287 | 1287 | "pattern": "^groups/[^/]+$", |
1288 | 1288 | "required": true, |
|
1442 | 1442 | "type": "integer" |
1443 | 1443 | }, |
1444 | 1444 | "pageToken": { |
1445 | | - "description": "The next_page_token value returned from a previous list request, if any", |
| 1445 | + "description": "The next_page_token value returned from a previous list request, if any.", |
1446 | 1446 | "location": "query", |
1447 | 1447 | "type": "string" |
1448 | 1448 | }, |
|
1485 | 1485 | "type": "integer" |
1486 | 1486 | }, |
1487 | 1487 | "pageToken": { |
1488 | | - "description": "The next_page_token value returned from a previous list request, if any.", |
| 1488 | + "description": "The `next_page_token` value returned from a previous list request, if any.", |
1489 | 1489 | "location": "query", |
1490 | 1490 | "type": "string" |
1491 | 1491 | }, |
|
1497 | 1497 | "type": "string" |
1498 | 1498 | }, |
1499 | 1499 | "query": { |
1500 | | - "description": "Required. A CEL expression that MUST include member specification AND label(s). This is a `required` field. Users can search on label attributes of groups. CONTAINS match ('in') is supported on labels. Identity-mapped groups are uniquely identified by both a `member_key_id` and a `member_key_namespace`, which requires an additional query input: `member_key_namespace`. Example query: `member_key_id == 'member_key_id_value' && in labels` Query may optionally contain equality operators on the parent of the group restricting the search within a particular customer, e.g. `parent == 'customers/{customer_id}'`. The `customer_id` must begin with \"C\" (for example, 'C046psxkn'). This filtering is only supported for Admins with groups read permissons on the input customer. Example query: `member_key_id == 'member_key_id_value' && in labels && parent == 'customers/C046psxkn'`", |
| 1500 | + "description": "Required. A CEL expression that MUST include member specification AND label(s). This is a `required` field. Users can search on label attributes of groups. CONTAINS match ('in') is supported on labels. Identity-mapped groups are uniquely identified by both a `member_key_id` and a `member_key_namespace`, which requires an additional query input: `member_key_namespace`. Example query: `member_key_id == 'member_key_id_value' && in labels` Query may optionally contain equality operators on the parent of the group restricting the search within a particular customer, e.g. `parent == 'customers/{customer_id}'`. The `customer_id` must begin with \"C\" (for example, 'C046psxkn'). This filtering is only supported for Admins with groups read permissions on the input customer. Example query: `member_key_id == 'member_key_id_value' && in labels && parent == 'customers/C046psxkn'`", |
1501 | 1501 | "location": "query", |
1502 | 1502 | "type": "string" |
1503 | 1503 | } |
|
2082 | 2082 | "parameterOrder": [], |
2083 | 2083 | "parameters": { |
2084 | 2084 | "filter": { |
2085 | | - "description": "Optional. A CEL expression for filtering the results. Policies can be filtered by application with this expression: setting.name = 'settings/gmail.*' Policies can be filtered by setting type with this expression: setting.name = '*.service_status' A maximum of one of the above setting.name clauses can be used. Policies can be filtered by customer with this expression: customer = \"customers/{customer}\" Where `customer` is the `id` from the [Admin SDK `Customer` resource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). You may use `customers/my_customer` to specify your own organization. When no customer is mentioned it will be default to customers/my_customer. A maximum of one customer clause can be used. The above clauses can only be combined together in a single filter expression with the AND operator.", |
| 2085 | + "description": "Optional. A CEL expression for filtering the results. Policies can be filtered by application with this expression: setting.name = 'settings/gmail.*' Policies can be filtered by setting type with this expression: setting.name = '*.service_status' A maximum of one of the above setting.name clauses can be used. Policies can be filtered by customer with this expression: customer = \"customers/{customer}\" Where `customer` is the `id` from the [Admin SDK `Customer` resource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). You may use `customers/my_customer` to specify your own organization. When no customer is mentioned it will be default to customers/my_customer. A maximum of one customer clause can be used. The above clauses can only be combined together in a single filter expression with the `&&` operator.", |
2086 | 2086 | "location": "query", |
2087 | 2087 | "type": "string" |
2088 | 2088 | }, |
2089 | 2089 | "pageSize": { |
2090 | | - "description": "Optional. The maximum number of results to return. The service may return fewer than this value. If omitted (or defaulted to zero) the server will default to 50. The maximum allowed value is 100, though requests with page_size greater than that will be interpreted as 100.", |
| 2090 | + "description": "Optional. The maximum number of results to return. The service can return fewer than this number. If omitted or set to 0, the default is 50 results per page. The maximum allowed value is 100. `page_size` values greater than 100 default to 100.", |
2091 | 2091 | "format": "int32", |
2092 | 2092 | "location": "query", |
2093 | 2093 | "type": "integer" |
|
2110 | 2110 | } |
2111 | 2111 | } |
2112 | 2112 | }, |
2113 | | - "revision": "20241119", |
| 2113 | + "revision": "20241126", |
2114 | 2114 | "rootUrl": "https://cloudidentity.googleapis.com/", |
2115 | 2115 | "schemas": { |
2116 | 2116 | "AddIdpCredentialOperationMetadata": { |
|
2673 | 2673 | "type": "object" |
2674 | 2674 | }, |
2675 | 2675 | "Device": { |
2676 | | - "description": "A Device within the Cloud Identity Devices API. Represents a Device known to Google Cloud, independent of the device ownership, type, and whether it is assigned or in use by a user.", |
| 2676 | + "description": "A Device within the Cloud Identity Devices API. Represents a Device known to Google Cloud, independent of the device ownership, type, and whether it is assigned or in use by a user. Important: Device API scopes require that you use domain-wide delegation to access the API. For more information, see [Set up the Devices API](https://cloud.google.com/identity/docs/how-to/setup-devices).", |
2677 | 2677 | "id": "Device", |
2678 | 2678 | "properties": { |
2679 | 2679 | "androidSpecificAttributes": { |
|
3829 | 3829 | "type": "string" |
3830 | 3830 | }, |
3831 | 3831 | "name": { |
3832 | | - "description": "Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Device in format: `devices/{device}`, where device is the unique id assigned to the Device.", |
| 3832 | + "description": "Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Device in format: `devices/{device}`, where device is the unique id assigned to the Device. Important: Device API scopes require that you use domain-wide delegation to access the API. For more information, see [Set up the Devices API](https://cloud.google.com/identity/docs/how-to/setup-devices).", |
3833 | 3833 | "readOnly": true, |
3834 | 3834 | "type": "string" |
3835 | 3835 | }, |
|
4699 | 4699 | "id": "MembershipAdjacencyList", |
4700 | 4700 | "properties": { |
4701 | 4701 | "edges": { |
4702 | | - "description": "Each edge contains information about the member that belongs to this group. Note: Fields returned here will help identify the specific Membership resource (e.g name, preferred_member_key and role), but may not be a comprehensive list of all fields.", |
| 4702 | + "description": "Each edge contains information about the member that belongs to this group. Note: Fields returned here will help identify the specific Membership resource (e.g `name`, `preferred_member_key` and `role`), but may not be a comprehensive list of all fields.", |
4703 | 4703 | "items": { |
4704 | 4704 | "$ref": "Membership" |
4705 | 4705 | }, |
|
4974 | 4974 | "type": "string" |
4975 | 4975 | }, |
4976 | 4976 | "sortOrder": { |
4977 | | - "description": "Output only. The decimal sort order of this PolicyQuery. The value is relative to all other policies with the same setting type within the whole customer. (There are no duplicates within this set.)", |
| 4977 | + "description": "Output only. The decimal sort order of this PolicyQuery. The value is relative to all other policies with the same setting type for the customer. (There are no duplicates within this set).", |
4978 | 4978 | "format": "double", |
4979 | 4979 | "readOnly": true, |
4980 | 4980 | "type": "number" |
|
0 commit comments