chore: use gapic-generator-python 0.65.1 (#303)

- [ ] Regenerate this pull request now. PiperOrigin-RevId: 441524537 Source-Link: googleapis/googleapis@2a27391 Source-Link: https://github.com/googleapis/googleapis-gen/commit/ab6756a48c89b5bcb9fb73443cb8e55d574f4643 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYWI2NzU2YTQ4Yzg5YjViY2I5ZmI3MzQ0M2NiOGU1NWQ1NzRmNDY0MyJ9 feat: AuditConfig for IAM v1 fix(deps): require grpc-google-iam-v1 >=0.12.4 docs: fix type in docstring for map fields

Author: gcf-owl-bot[bot]

google/cloud/iot_v1/services/device_manager/async_client.py

@@ -16,7 +16,7 @@
 from collections import OrderedDict
 import functools
 import re
-from typing import Dict, Optional, Sequence, Tuple, Type, Union
+from typing import Dict, Mapping, Optional, Sequence, Tuple, Type, Union
 import pkg_resources
 
 from google.api_core.client_options import ClientOptions
@@ -1280,7 +1280,6 @@ async def modify_cloud_to_device_config(
  eventually sent from the Cloud IoT Core servers. Returns
  the modified configuration version and its metadata.
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
@@ -1400,7 +1399,6 @@ async def list_device_config_versions(
  r"""Lists the last few versions of the device
  configuration in descending order (i.e.: newest first).
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
@@ -1507,7 +1505,6 @@ async def list_device_states(
  r"""Lists the last few versions of the device state in
  descending order (i.e.: newest first).
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
@@ -1613,17 +1610,17 @@ async def set_iam_policy(
  r"""Sets the access control policy on the specified
  resource. Replaces any existing policy.
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
+ from google.iam.v1 import iam_policy_pb2 # type: ignore
 
  def sample_set_iam_policy():
  # Create a client
  client = iot_v1.DeviceManagerClient()
 
  # Initialize request argument(s)
- request = iot_v1.SetIamPolicyRequest(
+ request = iam_policy_pb2.SetIamPolicyRequest(
  resource="resource_value",
  )
 
@@ -1654,21 +1651,26 @@ def sample_set_iam_policy():
 
  Returns:
  google.iam.v1.policy_pb2.Policy:
- Defines an Identity and Access Management (IAM) policy. It is used to
- specify access control policies for Cloud Platform
- resources.
+ An Identity and Access Management (IAM) policy, which specifies access
+ controls for Google Cloud resources.
 
  A Policy is a collection of bindings. A binding binds
- one or more members to a single role. Members can be
- user accounts, service accounts, Google groups, and
- domains (such as G Suite). A role is a named list of
- permissions (defined by IAM or configured by users).
- A binding can optionally specify a condition, which
- is a logic expression that further constrains the
- role binding based on attributes about the request
- and/or target resource.
-
- **JSON Example**
+ one or more members, or principals, to a single role.
+ Principals can be user accounts, service accounts,
+ Google groups, and domains (such as G Suite). A role
+ is a named list of permissions; each role can be an
+ IAM predefined role or a user-created custom role.
+
+ For some types of Google Cloud resources, a binding
+ can also specify a condition, which is a logical
+ expression that allows access to a resource only if
+ the expression evaluates to true. A condition can add
+ constraints based on attributes of the request, the
+ resource, or both. To learn which resources support
+ conditions in their IAM policies, see the [IAM
+ documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+
+ **JSON example:**
 
  {
  "bindings": [
@@ -1683,17 +1685,17 @@ def sample_set_iam_policy():
 
  }, { "role":
  "roles/resourcemanager.organizationViewer",
- "members": ["user:eve@example.com"],
+ "members": [ "user:eve@example.com" ],
  "condition": { "title": "expirable access",
  "description": "Does not grant access after
  Sep 2020", "expression": "request.time <
  timestamp('2020-10-01T00:00:00.000Z')", } }
 
- ]
+ ], "etag": "BwWWja0YfJA=", "version": 3
 
  }
 
- **YAML Example**
+ **YAML example:**
 
  bindings: - members: - user:\ mike@example.com -
  group:\ admins@example.com - domain:google.com -
@@ -1704,11 +1706,12 @@ def sample_set_iam_policy():
  condition: title: expirable access description:
  Does not grant access after Sep 2020 expression:
  request.time <
- timestamp('2020-10-01T00:00:00.000Z')
+ timestamp('2020-10-01T00:00:00.000Z') etag:
+ BwWWja0YfJA= version: 3
 
  For a description of IAM and its features, see the
- [IAM developer's
- guide](\ https://cloud.google.com/iam/docs).
+ [IAM
+ documentation](\ https://cloud.google.com/iam/docs/).
 
  """
  # Create or coerce a protobuf request object.
@@ -1768,17 +1771,17 @@ async def get_iam_policy(
  Returns an empty policy if the resource exists and does
  not have a policy set.
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
+ from google.iam.v1 import iam_policy_pb2 # type: ignore
 
  def sample_get_iam_policy():
  # Create a client
  client = iot_v1.DeviceManagerClient()
 
  # Initialize request argument(s)
- request = iot_v1.GetIamPolicyRequest(
+ request = iam_policy_pb2.GetIamPolicyRequest(
  resource="resource_value",
  )
 
@@ -1809,21 +1812,26 @@ def sample_get_iam_policy():
 
  Returns:
  google.iam.v1.policy_pb2.Policy:
- Defines an Identity and Access Management (IAM) policy. It is used to
- specify access control policies for Cloud Platform
- resources.
+ An Identity and Access Management (IAM) policy, which specifies access
+ controls for Google Cloud resources.
 
  A Policy is a collection of bindings. A binding binds
- one or more members to a single role. Members can be
- user accounts, service accounts, Google groups, and
- domains (such as G Suite). A role is a named list of
- permissions (defined by IAM or configured by users).
- A binding can optionally specify a condition, which
- is a logic expression that further constrains the
- role binding based on attributes about the request
- and/or target resource.
-
- **JSON Example**
+ one or more members, or principals, to a single role.
+ Principals can be user accounts, service accounts,
+ Google groups, and domains (such as G Suite). A role
+ is a named list of permissions; each role can be an
+ IAM predefined role or a user-created custom role.
+
+ For some types of Google Cloud resources, a binding
+ can also specify a condition, which is a logical
+ expression that allows access to a resource only if
+ the expression evaluates to true. A condition can add
+ constraints based on attributes of the request, the
+ resource, or both. To learn which resources support
+ conditions in their IAM policies, see the [IAM
+ documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+
+ **JSON example:**
 
  {
  "bindings": [
@@ -1838,17 +1846,17 @@ def sample_get_iam_policy():
 
  }, { "role":
  "roles/resourcemanager.organizationViewer",
- "members": ["user:eve@example.com"],
+ "members": [ "user:eve@example.com" ],
  "condition": { "title": "expirable access",
  "description": "Does not grant access after
  Sep 2020", "expression": "request.time <
  timestamp('2020-10-01T00:00:00.000Z')", } }
 
- ]
+ ], "etag": "BwWWja0YfJA=", "version": 3
 
  }
 
- **YAML Example**
+ **YAML example:**
 
  bindings: - members: - user:\ mike@example.com -
  group:\ admins@example.com - domain:google.com -
@@ -1859,11 +1867,12 @@ def sample_get_iam_policy():
  condition: title: expirable access description:
  Does not grant access after Sep 2020 expression:
  request.time <
- timestamp('2020-10-01T00:00:00.000Z')
+ timestamp('2020-10-01T00:00:00.000Z') etag:
+ BwWWja0YfJA= version: 3
 
  For a description of IAM and its features, see the
- [IAM developer's
- guide](\ https://cloud.google.com/iam/docs).
+ [IAM
+ documentation](\ https://cloud.google.com/iam/docs/).
 
  """
  # Create or coerce a protobuf request object.
@@ -1924,17 +1933,17 @@ async def test_iam_permissions(
  If the resource does not exist, this will return an empty set of
  permissions, not a NOT_FOUND error.
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
+ from google.iam.v1 import iam_policy_pb2 # type: ignore
 
  def sample_test_iam_permissions():
  # Create a client
  client = iot_v1.DeviceManagerClient()
 
  # Initialize request argument(s)
- request = iot_v1.TestIamPermissionsRequest(
+ request = iam_policy_pb2.TestIamPermissionsRequest(
  resource="resource_value",
  permissions=['permissions_value_1', 'permissions_value_2'],
  )
@@ -2051,7 +2060,6 @@ async def send_command_to_device(
  guaranteed; for QoS 0, no acknowledgment will be expected
  from the device.
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1
@@ -2303,7 +2311,6 @@ async def unbind_device_from_gateway(
  r"""Deletes the association between the device and the
  gateway.
 
-
  .. code-block:: python
 
  from google.cloud import iot_v1