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

- [ ] 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/secretmanager_v1/services/secret_manager_service/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
@@ -347,7 +347,6 @@ async def create_secret(
  containing no
  [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -477,7 +476,6 @@ async def add_secret_version(
  containing secret data and attaches it to an existing
  [Secret][google.cloud.secretmanager.v1.Secret].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -586,7 +584,6 @@ async def get_secret(
  r"""Gets metadata for a given
  [Secret][google.cloud.secretmanager.v1.Secret].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -690,7 +687,6 @@ async def update_secret(
  r"""Updates metadata of an existing
  [Secret][google.cloud.secretmanager.v1.Secret].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -887,7 +883,6 @@ async def list_secret_versions(
  [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
  This call does not return secret data.
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -1004,7 +999,6 @@ async def get_secret_version(
  recently created
  [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -1111,7 +1105,6 @@ async def access_secret_version(
  recently created
  [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -1229,7 +1222,6 @@ async def disable_secret_version(
  to
  [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -1334,7 +1326,6 @@ async def enable_secret_version(
  to
  [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -1440,7 +1431,6 @@ async def destroy_secret_version(
  [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED]
  and irrevocably destroys the secret data.
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
@@ -1543,17 +1533,17 @@ async def set_iam_policy(
  are enforced according to the policy set on the associated
  [Secret][google.cloud.secretmanager.v1.Secret].
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
+ from google.iam.v1 import iam_policy_pb2 # type: ignore
 
  def sample_set_iam_policy():
  # Create a client
  client = secretmanager_v1.SecretManagerServiceClient()
 
  # Initialize request argument(s)
- request = secretmanager_v1.SetIamPolicyRequest(
+ request = iam_policy_pb2.SetIamPolicyRequest(
  resource="resource_value",
  )
 
@@ -1575,21 +1565,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": [
@@ -1604,17 +1599,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 -
@@ -1625,11 +1620,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.
@@ -1675,17 +1671,17 @@ async def get_iam_policy(
  Returns empty policy if the secret exists and does not
  have a policy set.
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
+ from google.iam.v1 import iam_policy_pb2 # type: ignore
 
  def sample_get_iam_policy():
  # Create a client
  client = secretmanager_v1.SecretManagerServiceClient()
 
  # Initialize request argument(s)
- request = secretmanager_v1.GetIamPolicyRequest(
+ request = iam_policy_pb2.GetIamPolicyRequest(
  resource="resource_value",
  )
 
@@ -1707,21 +1703,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": [
@@ -1736,17 +1737,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 -
@@ -1757,11 +1758,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.
@@ -1812,17 +1814,17 @@ async def test_iam_permissions(
  authorization checking. This operation may "fail open" without
  warning.
 
-
  .. code-block:: python
 
  from google.cloud import secretmanager_v1
+ from google.iam.v1 import iam_policy_pb2 # type: ignore
 
  def sample_test_iam_permissions():
  # Create a client
  client = secretmanager_v1.SecretManagerServiceClient()
 
  # Initialize request argument(s)
- request = secretmanager_v1.TestIamPermissionsRequest(
+ request = iam_policy_pb2.TestIamPermissionsRequest(
  resource="resource_value",
  permissions=['permissions_value_1', 'permissions_value_2'],
  )