google-api-python-client 2.187.0__py3-none-any.whl → 2.188.0__py3-none-any.whl

googleapiclient/discovery.py

@@ -649,16 +649,23 @@ def build_from_document(
 
         # Obtain client cert and create mTLS http channel if cert exists.
         client_cert_to_use = None
-        use_client_cert = os.getenv(GOOGLE_API_USE_CLIENT_CERTIFICATE, "false")
-        if not use_client_cert in ("true", "false"):
-            raise MutualTLSChannelError(
-                "Unsupported GOOGLE_API_USE_CLIENT_CERTIFICATE value. Accepted values: true, false"
-            )
+        if hasattr(mtls, "should_use_client_cert"):
+            use_client_cert = mtls.should_use_client_cert()
+        else:
+            # if unsupported, fallback to reading from env var
+            use_client_cert_str = os.getenv(
+                "GOOGLE_API_USE_CLIENT_CERTIFICATE", "false"
+            ).lower()
+            use_client_cert = use_client_cert_str == "true"
+            if use_client_cert_str not in ("true", "false"):
+                raise MutualTLSChannelError(
+                    "Unsupported GOOGLE_API_USE_CLIENT_CERTIFICATE value. Accepted values: true, false"
+                )
         if client_options and client_options.client_cert_source:
             raise MutualTLSChannelError(
                 "ClientOptions.client_cert_source is not supported, please use ClientOptions.client_encrypted_cert_source."
             )
-        if use_client_cert == "true":
+        if use_client_cert:
             if (
                 client_options
                 and hasattr(client_options, "client_encrypted_cert_source")

googleapiclient/discovery_cache/documents/accessapproval.v1.json

@@ -913,7 +913,7 @@
 }
 }
 },
-"revision": "20251015",
+"revision": "20251201",
 "rootUrl": "https://accessapproval.googleapis.com/",
 "schemas": {
 "AccessApprovalServiceAccount": {
@@ -1340,7 +1340,10 @@
 "PQ_SIGN_ML_DSA_65",
 "PQ_SIGN_ML_DSA_87",
 "PQ_SIGN_SLH_DSA_SHA2_128S",
-"PQ_SIGN_HASH_SLH_DSA_SHA2_128S_SHA256"
+"PQ_SIGN_HASH_SLH_DSA_SHA2_128S_SHA256",
+"PQ_SIGN_ML_DSA_44_EXTERNAL_MU",
+"PQ_SIGN_ML_DSA_65_EXTERNAL_MU",
+"PQ_SIGN_ML_DSA_87_EXTERNAL_MU"
 ],
 "enumDescriptions": [
 "Not specified.",
@@ -1386,7 +1389,10 @@
 "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version.",
 "The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 5. Randomized version.",
 "The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized version.",
-"The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized pre-hash version supporting SHA256 digests."
+"The post-quantum stateless hash-based digital signature algorithm, at security level 1. Randomized pre-hash version supporting SHA256 digests.",
+"The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 1. Randomized version supporting externally-computed message representatives.",
+"The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 3. Randomized version supporting externally-computed message representatives.",
+"The post-quantum Module-Lattice-Based Digital Signature Algorithm, at security level 5. Randomized version supporting externally-computed message representatives."
 ],
 "type": "string"
 },

googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json

@@ -1068,7 +1068,7 @@
 "type": "string"
 },
 "returnPartialSuccess": {
-"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
+"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
 "location": "query",
 "type": "boolean"
 }
@@ -1300,7 +1300,7 @@
 }
 }
 },
-"revision": "20251005",
+"revision": "20251112",
 "rootUrl": "https://accesscontextmanager.googleapis.com/",
 "schemas": {
 "AccessContextManagerOperationMetadata": {
@@ -2162,7 +2162,7 @@
 "type": "array"
 },
 "unreachable": {
-"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
+"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.",
 "items": {
 "type": "string"
 },

googleapiclient/discovery_cache/documents/adexchangebuyer2.v2beta1.json

@@ -3115,7 +3115,7 @@
 }
 }
 },
-"revision": "20250807",
+"revision": "20251203",
 "rootUrl": "https://adexchangebuyer.googleapis.com/",
 "schemas": {
 "AbsoluteDateRange": {
@@ -5851,7 +5851,7 @@
 "COST_PER_DAY"
 ],
 "enumDescriptions": [
-"A placeholder for an undefined pricing type. If the pricing type is unpsecified, `COST_PER_MILLE` will be used instead.",
+"A placeholder for an undefined pricing type. If the pricing type is unspecified, `COST_PER_MILLE` will be used instead.",
 "Cost per thousand impressions.",
 "Cost per day"
 ],

googleapiclient/discovery_cache/documents/admin.directory_v1.json

@@ -3849,6 +3849,24 @@
 },
 "users": {
 "methods": {
+"createGuest": {
+"description": "Create a guest user with access to a [subset of Workspace capabilities](https://support.google.com/a/answer/16558545?hl=en). This feature is currently in Alpha. Please reach out to support if you are interested in trying this feature.",
+"flatPath": "admin/directory/v1/users:createGuest",
+"httpMethod": "POST",
+"id": "directory.users.createGuest",
+"parameterOrder": [],
+"parameters": {},
+"path": "admin/directory/v1/users:createGuest",
+"request": {
+"$ref": "DirectoryUsersCreateGuestRequest"
+},
+"response": {
+"$ref": "User"
+},
+"scopes": [
+"https://www.googleapis.com/auth/admin.directory.user"
+]
+},
 "delete": {
 "description": "Deletes a user.",
 "flatPath": "admin/directory/v1/users/{userKey}",
@@ -4671,7 +4689,7 @@
 }
 }
 },
-"revision": "20251021",
+"revision": "20251124",
 "rootUrl": "https://admin.googleapis.com/",
 "schemas": {
 "Alias": {
@@ -5459,7 +5477,7 @@ false
 "type": "array"
 },
 "bluetoothAdapterInfo": {
-"description": "Output only. Information about bluetooth adapters of the device.",
+"description": "Output only. Information about Bluetooth adapters of the device.",
 "items": {
 "$ref": "BluetoothAdapterInfo"
 },
@@ -6354,6 +6372,17 @@ false
 },
 "type": "object"
 },
+"DirectoryUsersCreateGuestRequest": {
+"description": "Directory users guest creation request message.",
+"id": "DirectoryUsersCreateGuestRequest",
+"properties": {
+"primaryGuestEmail": {
+"description": "Immutable. External email of the guest user being created.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "DomainAlias": {
 "id": "DomainAlias",
 "properties": {
@@ -6750,6 +6779,17 @@ false
 },
 "type": "object"
 },
+"GuestAccountInfo": {
+"description": "Account info specific to Guest users.",
+"id": "GuestAccountInfo",
+"properties": {
+"primaryGuestEmail": {
+"description": "Immutable. The guest's external email.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListPrintServersResponse": {
 "id": "ListPrintServersResponse",
 "properties": {
@@ -7960,6 +8000,10 @@ false
 "description": "The user's gender. The maximum allowed data size for this field is 1KB.",
 "type": "any"
 },
+"guestAccountInfo": {
+"$ref": "GuestAccountInfo",
+"description": "Immutable. Additional guest-related metadata fields"
+},
 "hashFunction": {
 "description": "Stores the hash format of the `password` property. The following `hashFunction` values are allowed: * `MD5` - Accepts simple hex-encoded values. * `SHA-1` - Accepts simple hex-encoded values. * `crypt` - Compliant with the [C crypt library](https://en.wikipedia.org/wiki/Crypt_%28C%29). Supports the DES, MD5 (hash prefix `$1$`), SHA-256 (hash prefix `$5$`), and SHA-512 (hash prefix `$6$`) hash algorithms. If rounds are specified as part of the prefix, they must be 10,000 or fewer.",
 "type": "string"
@@ -8000,6 +8044,10 @@ false
 "readOnly": true,
 "type": "boolean"
 },
+"isGuestUser": {
+"description": "Immutable. Indicates if the inserted user is a guest.",
+"type": "boolean"
+},
 "isMailboxSetup": {
 "description": "Output only. Indicates if the user's Google mailbox is created. This property is only applicable if the user has been assigned a Gmail license.",
 "readOnly": true,

googleapiclient/discovery_cache/documents/admin.directoryv1.json

@@ -3849,6 +3849,24 @@
 },
 "users": {
 "methods": {
+"createGuest": {
+"description": "Create a guest user with access to a [subset of Workspace capabilities](https://support.google.com/a/answer/16558545?hl=en). This feature is currently in Alpha. Please reach out to support if you are interested in trying this feature.",
+"flatPath": "admin/directory/v1/users:createGuest",
+"httpMethod": "POST",
+"id": "directory.users.createGuest",
+"parameterOrder": [],
+"parameters": {},
+"path": "admin/directory/v1/users:createGuest",
+"request": {
+"$ref": "DirectoryUsersCreateGuestRequest"
+},
+"response": {
+"$ref": "User"
+},
+"scopes": [
+"https://www.googleapis.com/auth/admin.directory.user"
+]
+},
 "delete": {
 "description": "Deletes a user.",
 "flatPath": "admin/directory/v1/users/{userKey}",
@@ -4671,7 +4689,7 @@
 }
 }
 },
-"revision": "20251021",
+"revision": "20251124",
 "rootUrl": "https://admin.googleapis.com/",
 "schemas": {
 "Alias": {
@@ -5459,7 +5477,7 @@ false
 "type": "array"
 },
 "bluetoothAdapterInfo": {
-"description": "Output only. Information about bluetooth adapters of the device.",
+"description": "Output only. Information about Bluetooth adapters of the device.",
 "items": {
 "$ref": "BluetoothAdapterInfo"
 },
@@ -6354,6 +6372,17 @@ false
 },
 "type": "object"
 },
+"DirectoryUsersCreateGuestRequest": {
+"description": "Directory users guest creation request message.",
+"id": "DirectoryUsersCreateGuestRequest",
+"properties": {
+"primaryGuestEmail": {
+"description": "Immutable. External email of the guest user being created.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "DomainAlias": {
 "id": "DomainAlias",
 "properties": {
@@ -6750,6 +6779,17 @@ false
 },
 "type": "object"
 },
+"GuestAccountInfo": {
+"description": "Account info specific to Guest users.",
+"id": "GuestAccountInfo",
+"properties": {
+"primaryGuestEmail": {
+"description": "Immutable. The guest's external email.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListPrintServersResponse": {
 "id": "ListPrintServersResponse",
 "properties": {
@@ -7960,6 +8000,10 @@ false
 "description": "The user's gender. The maximum allowed data size for this field is 1KB.",
 "type": "any"
 },
+"guestAccountInfo": {
+"$ref": "GuestAccountInfo",
+"description": "Immutable. Additional guest-related metadata fields"
+},
 "hashFunction": {
 "description": "Stores the hash format of the `password` property. The following `hashFunction` values are allowed: * `MD5` - Accepts simple hex-encoded values. * `SHA-1` - Accepts simple hex-encoded values. * `crypt` - Compliant with the [C crypt library](https://en.wikipedia.org/wiki/Crypt_%28C%29). Supports the DES, MD5 (hash prefix `$1$`), SHA-256 (hash prefix `$5$`), and SHA-512 (hash prefix `$6$`) hash algorithms. If rounds are specified as part of the prefix, they must be 10,000 or fewer.",
 "type": "string"
@@ -8000,6 +8044,10 @@ false
 "readOnly": true,
 "type": "boolean"
 },
+"isGuestUser": {
+"description": "Immutable. Indicates if the inserted user is a guest.",
+"type": "boolean"
+},
 "isMailboxSetup": {
 "description": "Output only. Indicates if the user's Google mailbox is created. This property is only applicable if the user has been assigned a Gmail license.",
 "readOnly": true,

googleapiclient/discovery_cache/documents/admin.reports_v1.json

@@ -3,10 +3,10 @@
 "oauth2": {
 "scopes": {
 "https://www.googleapis.com/auth/admin.reports.audit.readonly": {
-"description": "View audit reports for your G Suite domain"
+"description": "View audit reports for your Google Workspace domain"
 },
 "https://www.googleapis.com/auth/admin.reports.usage.readonly": {
-"description": "View usage reports for your G Suite domain"
+"description": "View usage reports for your Google Workspace domain"
 }
 }
 }
@@ -153,7 +153,20 @@
 "keep",
 "vault",
 "gemini_in_workspace_apps",
-"classroom"
+"classroom",
+"assignments",
+"cloud_search",
+"tasks",
+"data_migration",
+"meet_hardware",
+"directory_sync",
+"ldap",
+"profile",
+"access_evaluation",
+"admin_data_action",
+"contacts",
+"takeout",
+"graduation"
 ],
 "enumDescriptions": [
 "The Google Workspace Access Transparency activity reports return information about different types of Access Transparency activity events.",
@@ -180,10 +193,23 @@
 "The Keep application's activity reports return information about various Google Keep activity events. The Keep activity report is only available for Google Workspace Business and Enterprise customers.",
 "The Vault activity reports return information about various types of Vault activity events.",
 "The Gemini for Workspace activity reports return information about various types of Gemini activity events performed by users within a Workspace application.",
-"The Classroom activity reports return information about different types of [Classroom activity events](https://developers.google.com/workspace/admin/reports/v1/appendix/activity/classroom)."
+"The Classroom activity reports return information about different types of [Classroom activity events](https://developers.google.com/workspace/admin/reports/v1/appendix/activity/classroom).",
+"The assignments application's activity reports return information about various types of assignments activity events.",
+"The Cloud Search application's activity reports return information about various types of cloud_search activity events.",
+"The Tasks application's activity reports return information about various types of Tasks activity events.",
+"The Data Migration application's activity reports return information about various types of data migration activity events.",
+"The Meet Hardware application's activity reports return information about various types of Meet Hardware activity events.",
+"The Directory Sync application's activity reports return information about various types of Directory Sync activity events.",
+"The ldap application's activity reports return information about various types of ldap activity events.",
+"The Profile application's activity reports return information about various types of Profile activity events.",
+"The Access Evaluation activity reports return information about various types of Access Evaluation activity events.",
+"The Admin Data Action application's activity reports return information about various types of Admin Data Action activity events.",
+"The Contacts application's activity reports return information about various types of Contacts activity events.",
+"The Takeout application's activity reports return information about various types of Takeout activity events.",
+"The Graduation application's activity reports return information about various types of Graduation activity events."
 ],
 "location": "path",
-"pattern": "(access_transparency)|(admin)|(calendar)|(chat)|(chrome)|(classroom)|(context_aware_access)|(data_studio)|(drive)|(gcp)|(gmail)|(gplus)|(groups)|(groups_enterprise)|(jamboard)|(keep)|(login)|(meet)|(mobile)|(rules)|(saml)|(token)|(user_accounts)|(vault)|(gemini_in_workspace_apps)",
+"pattern": "(access_evaluation)|(access_transparency)|(admin)|(admin_data_action)|(assignments)|(calendar)|(chat)|(chrome)|(classroom)|(cloud_search)|(contacts)|(context_aware_access)|(data_studio)|(data_migration)|(directory_sync)|(drive)|(gcp)|(gmail)|(gplus)|(graduation)|(groups)|(groups_enterprise)|(jamboard)|(keep)|(ldap)|(login)|(meet)|(meet_hardware)|(mobile)|(profile)|(rules)|(saml)|(token)|(user_accounts)|(vault)|(gemini_in_workspace_apps)|(tasks)|(takeout)",
 "required": true,
 "type": "string"
 },
@@ -237,6 +263,11 @@
 "location": "query",
 "type": "string"
 },
+"resourceDetailsFilter": {
+"description": "Optional. The `resourceDetailsFilter` query string is an AND separated list composed of [Resource Details](#resourcedetails) fields manipulated by relational operators. Resource Details Filters are in the form `{resourceDetails.field1}{relational operator}{field1 value} AND {resourceDetails.field2}{relational operator}{field2 value}...` All the inner fields are traversed using the `.` operator, as shown in the following example: ``` resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" AND resourceDetails.appliedLabels.fieldValue.id = \"fieldValueId\" ``` `resourceDetailsFilter` query supports these relational operators: * `=`\u2014'equal to'. * `!=`\u2014'not equal to'. * `:`\u2014'exists'. This is used for filtering on repeated fields. [`FieldValue`](#fieldvalue) types that are repeated in nature uses `exists` operator for filtering. The following [`FieldValue`](#fieldvalue) types are repeated: * [`TextListValue`](#textlistvalue) * [`SelectionListValue`](#selectionlistvalue) * [`UserListValue`](#userlistvalue) For example, in the following filter, [`SelectionListValue`](#selectionlistvalue), is a repeated field. The filter checks whether [`SelectionListValue`](#selectionlistvalue) contains `selection_id`: ``` resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" AND resourceDetails.appliedLabels.fieldValue.id = \"fieldValueId\" AND resourceDetails.appliedLabels.fieldValue.type = \"SELECTION_LIST_VALUE\" AND resourceDetails.appliedLabels.fieldValue.selectionListValue.id: \"id\" ``` **Usage** ``` GET...&resourceDetailsFilter=resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" GET...&resourceDetailsFilter=resourceDetails.id=%22resourceId%22%20AND%20resourceDetails.appliedLabels.id=%22appliedLabelId%22 ``` **Note the following**: * You must URL encode the query string before sending the request. * The API supports a maximum of 5 fields separated by the AND operator. - When filtering on deeper levels (e.g., [`AppliedLabel`](#appliedlabel), [`FieldValue`](#fieldvalue)), the IDs of all preceding levels in the hierarchy must be included in the filter. For example: Filtering on [`FieldValue`](#fieldvalue) requires [`AppliedLabel`](#appliedlabel) ID and resourceDetails ID to be present. *Sample Query*: ``` resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" AND resourceDetails.appliedLabels.fieldValue.id = \"fieldValueId\" ``` * Filtering on inner [`FieldValue`](#fieldvalue) types like `longTextValue` and `textValue` requires `resourceDetails.appliedLabels.fieldValue.type` to be present. * Only Filtering on a single [`AppliedLabel`](#appliedlabel) id and [`FieldValue`](#fieldvalue) id is supported.",
+"location": "query",
+"type": "string"
+},
 "startTime": {
 "description": "Sets the beginning of the range of time shown in the report. The date is in the RFC 3339 format, for example 2010-10-28T10:26:35.000Z. The report returns all activities from `startTime` until `endTime`. The `startTime` must be before the `endTime` (if specified) and the current time when the request is made, or the API returns an error. For Gmail requests, `startTime` and `endTime` must be provided and the difference must not be greater than 30 days.",
 "location": "query",
@@ -635,7 +666,7 @@
 }
 }
 },
-"revision": "20250818",
+"revision": "20251202",
 "rootUrl": "https://admin.googleapis.com/",
 "schemas": {
 "Activities": {

googleapiclient/discovery_cache/documents/admin.reportsv1.json

@@ -3,10 +3,10 @@
 "oauth2": {
 "scopes": {
 "https://www.googleapis.com/auth/admin.reports.audit.readonly": {
-"description": "View audit reports for your G Suite domain"
+"description": "View audit reports for your Google Workspace domain"
 },
 "https://www.googleapis.com/auth/admin.reports.usage.readonly": {
-"description": "View usage reports for your G Suite domain"
+"description": "View usage reports for your Google Workspace domain"
 }
 }
 }
@@ -153,7 +153,20 @@
 "keep",
 "vault",
 "gemini_in_workspace_apps",
-"classroom"
+"classroom",
+"assignments",
+"cloud_search",
+"tasks",
+"data_migration",
+"meet_hardware",
+"directory_sync",
+"ldap",
+"profile",
+"access_evaluation",
+"admin_data_action",
+"contacts",
+"takeout",
+"graduation"
 ],
 "enumDescriptions": [
 "The Google Workspace Access Transparency activity reports return information about different types of Access Transparency activity events.",
@@ -180,10 +193,23 @@
 "The Keep application's activity reports return information about various Google Keep activity events. The Keep activity report is only available for Google Workspace Business and Enterprise customers.",
 "The Vault activity reports return information about various types of Vault activity events.",
 "The Gemini for Workspace activity reports return information about various types of Gemini activity events performed by users within a Workspace application.",
-"The Classroom activity reports return information about different types of [Classroom activity events](https://developers.google.com/workspace/admin/reports/v1/appendix/activity/classroom)."
+"The Classroom activity reports return information about different types of [Classroom activity events](https://developers.google.com/workspace/admin/reports/v1/appendix/activity/classroom).",
+"The assignments application's activity reports return information about various types of assignments activity events.",
+"The Cloud Search application's activity reports return information about various types of cloud_search activity events.",
+"The Tasks application's activity reports return information about various types of Tasks activity events.",
+"The Data Migration application's activity reports return information about various types of data migration activity events.",
+"The Meet Hardware application's activity reports return information about various types of Meet Hardware activity events.",
+"The Directory Sync application's activity reports return information about various types of Directory Sync activity events.",
+"The ldap application's activity reports return information about various types of ldap activity events.",
+"The Profile application's activity reports return information about various types of Profile activity events.",
+"The Access Evaluation activity reports return information about various types of Access Evaluation activity events.",
+"The Admin Data Action application's activity reports return information about various types of Admin Data Action activity events.",
+"The Contacts application's activity reports return information about various types of Contacts activity events.",
+"The Takeout application's activity reports return information about various types of Takeout activity events.",
+"The Graduation application's activity reports return information about various types of Graduation activity events."
 ],
 "location": "path",
-"pattern": "(access_transparency)|(admin)|(calendar)|(chat)|(chrome)|(classroom)|(context_aware_access)|(data_studio)|(drive)|(gcp)|(gmail)|(gplus)|(groups)|(groups_enterprise)|(jamboard)|(keep)|(login)|(meet)|(mobile)|(rules)|(saml)|(token)|(user_accounts)|(vault)|(gemini_in_workspace_apps)",
+"pattern": "(access_evaluation)|(access_transparency)|(admin)|(admin_data_action)|(assignments)|(calendar)|(chat)|(chrome)|(classroom)|(cloud_search)|(contacts)|(context_aware_access)|(data_studio)|(data_migration)|(directory_sync)|(drive)|(gcp)|(gmail)|(gplus)|(graduation)|(groups)|(groups_enterprise)|(jamboard)|(keep)|(ldap)|(login)|(meet)|(meet_hardware)|(mobile)|(profile)|(rules)|(saml)|(token)|(user_accounts)|(vault)|(gemini_in_workspace_apps)|(tasks)|(takeout)",
 "required": true,
 "type": "string"
 },
@@ -237,6 +263,11 @@
 "location": "query",
 "type": "string"
 },
+"resourceDetailsFilter": {
+"description": "Optional. The `resourceDetailsFilter` query string is an AND separated list composed of [Resource Details](#resourcedetails) fields manipulated by relational operators. Resource Details Filters are in the form `{resourceDetails.field1}{relational operator}{field1 value} AND {resourceDetails.field2}{relational operator}{field2 value}...` All the inner fields are traversed using the `.` operator, as shown in the following example: ``` resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" AND resourceDetails.appliedLabels.fieldValue.id = \"fieldValueId\" ``` `resourceDetailsFilter` query supports these relational operators: * `=`\u2014'equal to'. * `!=`\u2014'not equal to'. * `:`\u2014'exists'. This is used for filtering on repeated fields. [`FieldValue`](#fieldvalue) types that are repeated in nature uses `exists` operator for filtering. The following [`FieldValue`](#fieldvalue) types are repeated: * [`TextListValue`](#textlistvalue) * [`SelectionListValue`](#selectionlistvalue) * [`UserListValue`](#userlistvalue) For example, in the following filter, [`SelectionListValue`](#selectionlistvalue), is a repeated field. The filter checks whether [`SelectionListValue`](#selectionlistvalue) contains `selection_id`: ``` resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" AND resourceDetails.appliedLabels.fieldValue.id = \"fieldValueId\" AND resourceDetails.appliedLabels.fieldValue.type = \"SELECTION_LIST_VALUE\" AND resourceDetails.appliedLabels.fieldValue.selectionListValue.id: \"id\" ``` **Usage** ``` GET...&resourceDetailsFilter=resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" GET...&resourceDetailsFilter=resourceDetails.id=%22resourceId%22%20AND%20resourceDetails.appliedLabels.id=%22appliedLabelId%22 ``` **Note the following**: * You must URL encode the query string before sending the request. * The API supports a maximum of 5 fields separated by the AND operator. - When filtering on deeper levels (e.g., [`AppliedLabel`](#appliedlabel), [`FieldValue`](#fieldvalue)), the IDs of all preceding levels in the hierarchy must be included in the filter. For example: Filtering on [`FieldValue`](#fieldvalue) requires [`AppliedLabel`](#appliedlabel) ID and resourceDetails ID to be present. *Sample Query*: ``` resourceDetails.id = \"resourceId\" AND resourceDetails.appliedLabels.id = \"appliedLabelId\" AND resourceDetails.appliedLabels.fieldValue.id = \"fieldValueId\" ``` * Filtering on inner [`FieldValue`](#fieldvalue) types like `longTextValue` and `textValue` requires `resourceDetails.appliedLabels.fieldValue.type` to be present. * Only Filtering on a single [`AppliedLabel`](#appliedlabel) id and [`FieldValue`](#fieldvalue) id is supported.",
+"location": "query",
+"type": "string"
+},
 "startTime": {
 "description": "Sets the beginning of the range of time shown in the report. The date is in the RFC 3339 format, for example 2010-10-28T10:26:35.000Z. The report returns all activities from `startTime` until `endTime`. The `startTime` must be before the `endTime` (if specified) and the current time when the request is made, or the API returns an error. For Gmail requests, `startTime` and `endTime` must be provided and the difference must not be greater than 30 days.",
 "location": "query",
@@ -635,7 +666,7 @@
 }
 }
 },
-"revision": "20250818",
+"revision": "20251202",
 "rootUrl": "https://admin.googleapis.com/",
 "schemas": {
 "Activities": {