google-api-python-client 2.136.0__py2.py3-none-any.whl → 2.138.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/websecurityscanner.v1alpha.json

@@ -526,7 +526,7 @@
 }
 }
 },
-"revision": "20240616",
+"revision": "20240623",
 "rootUrl": "https://websecurityscanner.googleapis.com/",
 "schemas": {
 "Authentication": {

googleapiclient/discovery_cache/documents/websecurityscanner.v1beta.json

@@ -526,7 +526,7 @@
 }
 }
 },
-"revision": "20240616",
+"revision": "20240623",
 "rootUrl": "https://websecurityscanner.googleapis.com/",
 "schemas": {
 "Authentication": {

googleapiclient/discovery_cache/documents/workflowexecutions.v1.json

@@ -457,7 +457,7 @@
 }
 }
 },
-"revision": "20240618",
+"revision": "20240715",
 "rootUrl": "https://workflowexecutions.googleapis.com/",
 "schemas": {
 "Callback": {
@@ -578,6 +578,20 @@
 "description": "Output only. The error which caused the execution to finish prematurely. The value is only present if the execution's state is `FAILED` or `CANCELLED`.",
 "readOnly": true
 },
+"executionHistoryLevel": {
+"description": "Optional. Describes the level of the execution history feature to apply to this execution. If not specified, the level of the execution history feature will be determined by its workflow's execution history level. If the value is different from its workflow's value, it will override the workflow's execution history level for this exeuction.",
+"enum": [
+"EXECUTION_HISTORY_LEVEL_UNSPECIFIED",
+"EXECUTION_HISTORY_BASIC",
+"EXECUTION_HISTORY_DETAILED"
+],
+"enumDescriptions": [
+"The default/unset value.",
+"Enable execution history basic feature for this execution.",
+"Enable execution history detailed feature for this execution."
+],
+"type": "string"
+},
 "labels": {
 "additionalProperties": {
 "type": "string"

googleapiclient/discovery_cache/documents/workflowexecutions.v1beta.json

@@ -269,7 +269,7 @@
 }
 }
 },
-"revision": "20240618",
+"revision": "20240625",
 "rootUrl": "https://workflowexecutions.googleapis.com/",
 "schemas": {
 "CancelExecutionRequest": {

googleapiclient/discovery_cache/documents/workflows.v1.json

@@ -485,7 +485,7 @@
 }
 }
 },
-"revision": "20240619",
+"revision": "20240710",
 "rootUrl": "https://workflows.googleapis.com/",
 "schemas": {
 "Empty": {
@@ -722,7 +722,7 @@
 "type": "object"
 },
 "Workflow": {
-"description": "Workflow program to be executed by Workflows.",
+"description": "LINT.IfChange Workflow program to be executed by Workflows.",
 "id": "Workflow",
 "properties": {
 "allKmsKeys": {

googleapiclient/discovery_cache/documents/workloadmanager.v1.json

@@ -772,7 +772,7 @@
 }
 }
 },
-"revision": "20240619",
+"revision": "20240701",
 "rootUrl": "https://workloadmanager.googleapis.com/",
 "schemas": {
 "AgentCommand": {
@@ -797,6 +797,10 @@
 "description": "Provides the mapping of a cloud asset to a direct physical location or to a proxy that defines the location on its behalf.",
 "id": "AssetLocation",
 "properties": {
+"ccfeRmsPath": {
+"description": "Spanner path of the CCFE RMS database. It is only applicable for CCFE tenants that use CCFE RMS for storing resource metadata.",
+"type": "string"
+},
 "expected": {
 "$ref": "IsolationExpectations",
 "description": "Defines the customer expectation around ZI/ZS for this asset and ZI/ZS state of the region at the time of asset creation."
@@ -2318,7 +2322,15 @@
 "SpannerLocation": {
 "id": "SpannerLocation",
 "properties": {
+"backupName": {
+"description": "Set of backups used by the resource with name in the same format as what is available at http://table/spanner_automon.backup_metadata",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "dbName": {
+"description": "Set of databases used by the resource in format /span//",
 "items": {
 "type": "string"
 },

googleapiclient/discovery_cache/documents/workspaceevents.v1.json

@@ -424,7 +424,7 @@
 }
 }
 },
-"revision": "20240625",
+"revision": "20240702",
 "rootUrl": "https://workspaceevents.googleapis.com/",
 "schemas": {
 "ListSubscriptionsResponse": {

googleapiclient/discovery_cache/documents/workstations.v1.json

@@ -1195,7 +1195,7 @@
 }
 }
 },
-"revision": "20240619",
+"revision": "20240716",
 "rootUrl": "https://workstations.googleapis.com/",
 "schemas": {
 "Accelerator": {
@@ -1347,11 +1347,11 @@
 "type": "object"
 },
 "DomainConfig": {
-"description": "Configuration options for private workstation clusters.",
+"description": "Configuration options for a custom domain.",
 "id": "DomainConfig",
 "properties": {
 "domain": {
-"description": "Immutable. Whether Workstations endpoint is private.",
+"description": "Immutable. Domain used by Workstations for HTTP ingress.",
 "type": "string"
 }
 },
@@ -1435,7 +1435,7 @@
 "type": "boolean"
 },
 "enableNestedVirtualization": {
-"description": "Optional. Whether to enable nested virtualization on Cloud Workstations VMs created using this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * **GPUs**: nested virtualization may not be enabled on workstation configurations with accelerators. * **Operating System**: because [Container-Optimized OS](https://cloud.google.com/compute/docs/images/os-details#container-optimized_os_cos) does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an [Ubuntu LTS](https://cloud.google.com/compute/docs/images/os-details#ubuntu_lts) image.",
+"description": "Optional. Whether to enable nested virtualization on Cloud Workstations VMs created using this workstation configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series.",
 "type": "boolean"
 },
 "machineType": {
@@ -1940,23 +1940,45 @@
 },
 "type": "object"
 },
+"PortRange": {
+"description": "A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.",
+"id": "PortRange",
+"properties": {
+"first": {
+"description": "Required. Starting port number for the current range of ports.",
+"format": "int32",
+"type": "integer"
+},
+"last": {
+"description": "Required. Ending port number for the current range of ports.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "PrivateClusterConfig": {
+"description": "Configuration options for private workstation clusters.",
 "id": "PrivateClusterConfig",
 "properties": {
 "allowedProjects": {
+"description": "Optional. Additional projects that are allowed to attach to the workstation cluster's service attachment. By default, the workstation cluster's project and the VPC host project (if different) are allowed.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "clusterHostname": {
+"description": "Output only. Hostname for the workstation cluster. This field will be populated only when private endpoint is enabled. To access workstations in the workstation cluster, create a new DNS zone mapping this domain name to an internal IP address and a forwarding rule mapping that address to the service attachment.",
 "readOnly": true,
 "type": "string"
 },
 "enablePrivateEndpoint": {
+"description": "Immutable. Whether Workstations endpoint is private.",
 "type": "boolean"
 },
 "serviceAttachmentUri": {
+"description": "Output only. Service attachment URI for the workstation cluster. The service attachemnt is created when private endpoint is enabled. To access workstations in the workstation cluster, configure access to the managed service using [Private Service Connect](https://cloud.google.com/vpc/docs/configure-private-service-connect-services).",
 "readOnly": true,
 "type": "string"
 }
@@ -2282,6 +2304,13 @@
 "description": "A workstation configuration resource in the Cloud Workstations API. Workstation configurations act as templates for workstations. The workstation configuration defines details such as the workstation virtual machine (VM) instance type, persistent storage, container image defining environment, which IDE or Code Editor to use, and more. Administrators and platform teams can also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/docs/overview) rules to grant access to teams or to individual developers.",
 "id": "WorkstationConfig",
 "properties": {
+"allowedPorts": {
+"description": "Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.",
+"items": {
+"$ref": "PortRange"
+},
+"type": "array"
+},
 "annotations": {
 "additionalProperties": {
 "type": "string"
@@ -2327,7 +2356,7 @@
 "type": "string"
 },
 "enableAuditAgent": {
-"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service account must also be specified that has `logging.buckets.write` permission on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging).",
+"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type=\"gce_instance\" log_name:\"/logs/linux-auditd\"",
 "type": "boolean"
 },
 "encryptionKey": {

googleapiclient/discovery_cache/documents/workstations.v1beta.json

@@ -1127,7 +1127,7 @@
 }
 }
 },
-"revision": "20240619",
+"revision": "20240716",
 "rootUrl": "https://workstations.googleapis.com/",
 "schemas": {
 "Accelerator": {
@@ -1233,7 +1233,7 @@
 "type": "integer"
 },
 "enableNestedVirtualization": {
-"description": "Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series. * **GPUs**: nested virtualization may not be enabled on boost configurations with accelerators. * **Operating System**: Because [Container-Optimized OS](https://cloud.google.com/compute/docs/images/os-details#container-optimized_os_cos) does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an [Ubuntu LTS](https://cloud.google.com/compute/docs/images/os-details#ubuntu_lts) image. Defaults to false.",
+"description": "Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.",
 "type": "boolean"
 },
 "id": {
@@ -1315,11 +1315,11 @@
 "type": "object"
 },
 "DomainConfig": {
-"description": "Configuration options for private workstation clusters.",
+"description": "Configuration options for a custom domain.",
 "id": "DomainConfig",
 "properties": {
 "domain": {
-"description": "Immutable. Whether Workstations endpoint is private.",
+"description": "Immutable. Domain used by Workstations for HTTP ingress.",
 "type": "string"
 }
 },
@@ -1410,7 +1410,7 @@
 "type": "boolean"
 },
 "enableNestedVirtualization": {
-"description": "Optional. Whether to enable nested virtualization on Cloud Workstations VMs created using this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * **GPUs**: nested virtualization may not be enabled on workstation configurations with accelerators. * **Operating System**: because [Container-Optimized OS](https://cloud.google.com/compute/docs/images/os-details#container-optimized_os_cos) does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an [Ubuntu LTS](https://cloud.google.com/compute/docs/images/os-details#ubuntu_lts) image.",
+"description": "Optional. Whether to enable nested virtualization on Cloud Workstations VMs created using this workstation configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series.",
 "type": "boolean"
 },
 "machineType": {
@@ -1875,7 +1875,7 @@
 "type": "object"
 },
 "PortRange": {
-"description": "A PortsConfig defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.",
+"description": "A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.",
 "id": "PortRange",
 "properties": {
 "first": {
@@ -1892,22 +1892,27 @@
 "type": "object"
 },
 "PrivateClusterConfig": {
+"description": "Configuration options for private workstation clusters.",
 "id": "PrivateClusterConfig",
 "properties": {
 "allowedProjects": {
+"description": "Optional. Additional projects that are allowed to attach to the workstation cluster's service attachment. By default, the workstation cluster's project and the VPC host project (if different) are allowed.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "clusterHostname": {
+"description": "Output only. Hostname for the workstation cluster. This field will be populated only when private endpoint is enabled. To access workstations in the workstation cluster, create a new DNS zone mapping this domain name to an internal IP address and a forwarding rule mapping that address to the service attachment.",
 "readOnly": true,
 "type": "string"
 },
 "enablePrivateEndpoint": {
+"description": "Immutable. Whether Workstations endpoint is private.",
 "type": "boolean"
 },
 "serviceAttachmentUri": {
+"description": "Output only. Service attachment URI for the workstation cluster. The service attachemnt is created when private endpoint is enabled. To access workstations in the workstation cluster, configure access to the managed service using [Private Service Connect](https://cloud.google.com/vpc/docs/configure-private-service-connect-services).",
 "readOnly": true,
 "type": "string"
 }
@@ -2046,6 +2051,14 @@
 "description": "Optional. Client-specified annotations.",
 "type": "object"
 },
+"boostConfigs": {
+"description": "Output only. List of available boost configuration ids that this workstation can be boosted up to",
+"items": {
+"$ref": "WorkstationBoostConfig"
+},
+"readOnly": true,
+"type": "array"
+},
 "createTime": {
 "description": "Output only. Time when this workstation was created.",
 "format": "google-datetime",
@@ -2099,6 +2112,16 @@
 "readOnly": true,
 "type": "boolean"
 },
+"satisfiesPzi": {
+"description": "Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
+"satisfiesPzs": {
+"description": "Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
 "sourceWorkstation": {
 "description": "Optional. The source workstation from which this workstations persistent directories were cloned on creation.",
 "type": "string"
@@ -2142,6 +2165,18 @@
 },
 "type": "object"
 },
+"WorkstationBoostConfig": {
+"description": "Boost config for this workstation. This object is populated from the parent workstation config.",
+"id": "WorkstationBoostConfig",
+"properties": {
+"id": {
+"description": "Output only. Boost config id.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "WorkstationCluster": {
 "description": "A workstation cluster resource in the Cloud Workstations API. Defines a group of workstations in a particular region and the VPC network they're attached to.",
 "id": "WorkstationCluster",
@@ -2219,6 +2254,16 @@
 "readOnly": true,
 "type": "boolean"
 },
+"satisfiesPzi": {
+"description": "Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
+"satisfiesPzs": {
+"description": "Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
 "subnetwork": {
 "description": "Immutable. Name of the Compute Engine subnetwork in which instances associated with this workstation cluster will be created. Must be part of the subnetwork specified for this workstation cluster.",
 "type": "string"
@@ -2293,7 +2338,7 @@
 "type": "string"
 },
 "enableAuditAgent": {
-"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service account must also be specified that has `logging.buckets.write` permission on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging).",
+"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type=\"gce_instance\" log_name:\"/logs/linux-auditd\"",
 "type": "boolean"
 },
 "encryptionKey": {
@@ -2366,6 +2411,16 @@
 "format": "google-duration",
 "type": "string"
 },
+"satisfiesPzi": {
+"description": "Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
+"satisfiesPzs": {
+"description": "Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
 "uid": {
 "description": "Output only. A system-assigned unique identifier for this workstation configuration.",
 "readOnly": true,

googleapiclient/discovery_cache/documents/youtube.v3.json

@@ -4072,7 +4072,7 @@
 }
 }
 },
-"revision": "20240630",
+"revision": "20240707",
 "rootUrl": "https://youtube.googleapis.com/",
 "schemas": {
 "AbuseReport": {

googleapiclient/discovery_cache/documents/youtubeAnalytics.v2.json

@@ -421,7 +421,7 @@
 }
 }
 },
-"revision": "20240630",
+"revision": "20240707",
 "rootUrl": "https://youtubeanalytics.googleapis.com/",
 "schemas": {
 "EmptyResponse": {

googleapiclient/discovery_cache/documents/youtubereporting.v1.json

@@ -411,7 +411,7 @@
 }
 }
 },
-"revision": "20240630",
+"revision": "20240707",
 "rootUrl": "https://youtubereporting.googleapis.com/",
 "schemas": {
 "Empty": {

googleapiclient/model.py

@@ -27,10 +27,18 @@ import json
 import logging
 import platform
 import urllib
+import warnings
 
 from googleapiclient import version as googleapiclient_version
 from googleapiclient.errors import HttpError
 
+try:
+    from google.api_core.version_header import API_VERSION_METADATA_KEY
+
+    HAS_API_VERSION = True
+except ImportError:
+    HAS_API_VERSION = False
+
 _LIBRARY_VERSION = googleapiclient_version.__version__
 _PY_VERSION = platform.python_version()
 
@@ -121,7 +129,7 @@ class BaseModel(Model):
             LOGGER.info("query: %s", query)
             LOGGER.info("--request-end--")
 
-    def request(self, headers, path_params, query_params, body_value):
+    def request(self, headers, path_params, query_params, body_value, api_version=None):
         """Updates outgoing requests with a serialized body.
 
         Args:
@@ -129,7 +137,10 @@ class BaseModel(Model):
           path_params: dict, parameters that appear in the request path
           query_params: dict, parameters that appear in the query
           body_value: object, the request body as a Python object, which must be
-                      serializable by json.
+              serializable by json.
+          api_version: str, The precise API version represented by this request,
+              which will result in an API Version header being sent along with the
+              HTTP request.
         Returns:
           A tuple of (headers, path_params, query, body)
 
@@ -155,6 +166,15 @@ class BaseModel(Model):
             _PY_VERSION,
         )
 
+        if api_version and HAS_API_VERSION:
+            headers[API_VERSION_METADATA_KEY] = api_version
+        elif api_version:
+            warnings.warn(
+                "The `api_version` argument is ignored as a newer version of "
+                "`google-api-core` is required to use this feature."
+                "Please upgrade `google-api-core` to 2.19.0 or newer."
+            )
+
         if body_value is not None:
             headers["content-type"] = self.content_type
             body_value = self.serialize(body_value)

googleapiclient/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "2.136.0"
+__version__ = "2.138.0"