feat: add from_service_account_info factory and fix sphinx identifiers (

#48)

feat: add 'from_service_account_info' factory to clients
fix: fix sphinx identifiers
PiperOrigin-RevId: 350246057

Source-Author: Google APIs <noreply@google.com>
Source-Date: Tue Jan 5 16:44:11 2021 -0800
Source-Repo: googleapis/googleapis
Source-Sha: 520682435235d9c503983a360a2090025aa47cd1
Source-Link: googleapis/googleapis@5206824

docs/credentials_v1/iam_credentials.rst

@@ -0,0 +1,6 @@
+IAMCredentials
+--------------------------------
+
+.. automodule:: google.cloud.iam_credentials_v1.services.iam_credentials
+    :members:
+    :inherited-members:

docs/credentials_v1/services.rst

@@ -1,6 +1,6 @@
 Services for Google Iam Credentials v1 API
 ==========================================
+.. toctree::
+    :maxdepth: 2
 
-.. automodule:: google.cloud.iam_credentials_v1.services.iam_credentials
-    :members:
-    :inherited-members:
+    iam_credentials

docs/credentials_v1/types.rst

@@ -3,4 +3,5 @@ Types for Google Iam Credentials v1 API
 
 .. automodule:: google.cloud.iam_credentials_v1.types
     :members:
+    :undoc-members:
     :show-inheritance:

google/cloud/iam_credentials_v1/services/iam_credentials/async_client.py

@@ -89,6 +89,7 @@ class IAMCredentialsAsyncClient:
         IAMCredentialsClient.parse_common_location_path
     )
 
+    from_service_account_info = IAMCredentialsClient.from_service_account_info
     from_service_account_file = IAMCredentialsClient.from_service_account_file
     from_service_account_json = from_service_account_file
 
@@ -169,7 +170,7 @@ async def generate_access_token(
         account.
 
         Args:
-            request (:class:`~.common.GenerateAccessTokenRequest`):
+            request (:class:`google.cloud.iam_credentials_v1.types.GenerateAccessTokenRequest`):
                 The request object.
             name (:class:`str`):
                 Required. The resource name of the service account for
@@ -178,6 +179,7 @@ async def generate_access_token(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -195,6 +197,7 @@ async def generate_access_token(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``delegates`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -205,16 +208,18 @@ async def generate_access_token(
                 https://developers.google.com/identity/protocols/googlescopes
                 for more information.
                 At least one value required.
+
                 This corresponds to the ``scope`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
-            lifetime (:class:`~.duration.Duration`):
+            lifetime (:class:`google.protobuf.duration_pb2.Duration`):
                 The desired lifetime duration of the
                 access token in seconds. Must be set to
                 a value less than or equal to 3600 (1
                 hour). If a value is not specified, the
                 token's lifetime will be set to a
                 default value of one hour.
+
                 This corresponds to the ``lifetime`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -226,7 +231,7 @@ async def generate_access_token(
                 sent along with the request as metadata.
 
         Returns:
-            ~.common.GenerateAccessTokenResponse:
+            google.cloud.iam_credentials_v1.types.GenerateAccessTokenResponse:
 
         """
         # Create or coerce a protobuf request object.
@@ -298,7 +303,7 @@ async def generate_id_token(
         account.
 
         Args:
-            request (:class:`~.common.GenerateIdTokenRequest`):
+            request (:class:`google.cloud.iam_credentials_v1.types.GenerateIdTokenRequest`):
                 The request object.
             name (:class:`str`):
                 Required. The resource name of the service account for
@@ -307,6 +312,7 @@ async def generate_id_token(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -324,20 +330,23 @@ async def generate_id_token(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``delegates`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             audience (:class:`str`):
                 Required. The audience for the token,
                 such as the API or account that this
                 token grants access to.
+
                 This corresponds to the ``audience`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             include_email (:class:`bool`):
                 Include the service account email in the token. If set
                 to ``true``, the token will contain ``email`` and
                 ``email_verified`` claims.
+
                 This corresponds to the ``include_email`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -349,7 +358,7 @@ async def generate_id_token(
                 sent along with the request as metadata.
 
         Returns:
-            ~.common.GenerateIdTokenResponse:
+            google.cloud.iam_credentials_v1.types.GenerateIdTokenResponse:
 
         """
         # Create or coerce a protobuf request object.
@@ -420,7 +429,7 @@ async def sign_blob(
         private key.
 
         Args:
-            request (:class:`~.common.SignBlobRequest`):
+            request (:class:`google.cloud.iam_credentials_v1.types.SignBlobRequest`):
                 The request object.
             name (:class:`str`):
                 Required. The resource name of the service account for
@@ -429,6 +438,7 @@ async def sign_blob(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -446,6 +456,7 @@ async def sign_blob(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``delegates`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -462,7 +473,7 @@ async def sign_blob(
                 sent along with the request as metadata.
 
         Returns:
-            ~.common.SignBlobResponse:
+            google.cloud.iam_credentials_v1.types.SignBlobResponse:
 
         """
         # Create or coerce a protobuf request object.
@@ -531,7 +542,7 @@ async def sign_jwt(
         private key.
 
         Args:
-            request (:class:`~.common.SignJwtRequest`):
+            request (:class:`google.cloud.iam_credentials_v1.types.SignJwtRequest`):
                 The request object.
             name (:class:`str`):
                 Required. The resource name of the service account for
@@ -540,6 +551,7 @@ async def sign_jwt(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -557,13 +569,15 @@ async def sign_jwt(
                 ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
                 The ``-`` wildcard character is required; replacing it
                 with a project ID is invalid.
+
                 This corresponds to the ``delegates`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             payload (:class:`str`):
                 Required. The JWT payload to sign: a
                 JSON object that contains a JWT Claims
                 Set.
+
                 This corresponds to the ``payload`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -575,7 +589,7 @@ async def sign_jwt(
                 sent along with the request as metadata.
 
         Returns:
-            ~.common.SignJwtResponse:
+            google.cloud.iam_credentials_v1.types.SignJwtResponse:
 
         """
         # Create or coerce a protobuf request object.