Skip to content
This repository was archived by the owner on Mar 26, 2026. It is now read-only.

Commit 4a15d60

Browse files
committed
added docstrings for api_audience and interceptor
1 parent 535d654 commit 4a15d60

File tree

5 files changed

+20
-0
lines changed

5 files changed

+20
-0
lines changed

gapic/templates/%namespace/%name_%version/%sub/services/%service/transports/base.py.j2

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,10 @@ class {{ service.name }}Transport(abc.ABC):
103103
your own client library.
104104
always_use_jwt_access (Optional[bool]): Whether self signed JWT should
105105
be used for service account credentials.
106+
api_audience Optional[str]: The intended audience for the API calls
107+
to the service that will be set when using certain 3rd party
108+
authentication flows. Audience is typically a resource identifier.
109+
If not set, the host value will be used as a default.
106110
"""
107111
{% if service.any_extended_operations_methods %}
108112
self._extended_operations_services: Dict[str, Any] = {}

gapic/templates/%namespace/%name_%version/%sub/services/%service/transports/grpc.py.j2

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,6 +169,10 @@ class {{ service.name }}GrpcTransport({{ service.name }}Transport):
169169
your own client library.
170170
always_use_jwt_access (Optional[bool]): Whether self signed JWT should
171171
be used for service account credentials.
172+
api_audience Optional[str]: The intended audience for the API calls
173+
to the service that will be set when using certain 3rd party
174+
authentication flows. Audience is typically a resource identifier.
175+
If not set, the host value will be used as a default.
172176

173177
Raises:
174178
google.auth.exceptions.MutualTLSChannelError: If mutual TLS transport

gapic/templates/%namespace/%name_%version/%sub/services/%service/transports/grpc_asyncio.py.j2

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -218,6 +218,10 @@ class {{ service.grpc_asyncio_transport_name }}({{ service.name }}Transport):
218218
your own client library.
219219
always_use_jwt_access (Optional[bool]): Whether self signed JWT should
220220
be used for service account credentials.
221+
api_audience Optional[str]: The intended audience for the API calls
222+
to the service that will be set when using certain 3rd party
223+
authentication flows. Audience is typically a resource identifier.
224+
If not set, the host value will be used as a default.
221225

222226
Raises:
223227
google.auth.exceptions.MutualTlsChannelError: If mutual TLS transport

gapic/templates/%namespace/%name_%version/%sub/services/%service/transports/rest.py.j2

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,12 @@ class {{service.name}}RestTransport(_Base{{ service.name }}RestTransport):
135135
url_scheme: the protocol scheme for the API endpoint. Normally
136136
"https", but for testing or local servers,
137137
"http" can be specified.
138+
interceptor Optional[{{ service.name }}RestInterceptor]: Interceptor used
139+
to manipulate requests, request metadata, and responses.
140+
api_audience Optional[str]: The intended audience for the API calls
141+
to the service that will be set when using certain 3rd party
142+
authentication flows. Audience is typically a resource identifier.
143+
If not set, the host value will be used as a default.
138144
"""
139145
# Run the base constructor
140146
# TODO(yon-mg): resolve other ctor params i.e. scopes, quota, etc.

gapic/templates/%namespace/%name_%version/%sub/services/%service/transports/rest_asyncio.py.j2

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,8 @@ class Async{{service.name}}RestTransport(_Base{{ service.name }}RestTransport):
134134
url_scheme (str): the protocol scheme for the API endpoint. Normally
135135
"https", but for testing or local servers,
136136
"http" can be specified.
137+
interceptor Optional[{{ service.name }}RestInterceptor]: Interceptor used
138+
to manipulate requests, request metadata, and responses.
137139
"""
138140
# Run the base constructor
139141
super().__init__(

0 commit comments

Comments
 (0)