googleapis · parthea · Feb 5, 2025 · Feb 5, 2025 · Feb 5, 2025
@@ -26,12 +26,12 @@ In order to use this library, you first need to go through the following steps:
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
 3. `Enable the Google APIs Common Protos.`_
-4. `Setup Authentication.`_
+4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
 .. _Enable the Google APIs Common Protos.:  https://github.com/googleapis/googleapis/tree/master/google
-.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
 ~~~~~~~~~~~~

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 
-# Copyright 2024 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
 
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/annotations.proto
+# Protobuf Python Version: 4.25.3
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -41,6 +42,8 @@
     DESCRIPTOR, "google.api.annotations_pb2", _globals
 )
 if _descriptor._USE_C_DESCRIPTORS == False:
-    DESCRIPTOR._options = None
-    DESCRIPTOR._serialized_options = b"\n\016com.google.apiB\020AnnotationsProtoP\001ZAgoogle.golang.org/genproto/googleapis/api/annotations;annotations\242\002\004GAPI"
+    _globals["DESCRIPTOR"]._options = None
+    _globals[
+        "DESCRIPTOR"
+    ]._serialized_options = b"\n\016com.google.apiB\020AnnotationsProtoP\001ZAgoogle.golang.org/genproto/googleapis/api/annotations;annotations\242\002\004GAPI"
 # @@protoc_insertion_point(module_scope)
@@ -0,0 +1,24 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import ClassVar as _ClassVar
+
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pb2 as _descriptor_pb2
+
+from google.api import http_pb2 as _http_pb2
+
+DESCRIPTOR: _descriptor.FileDescriptor
+HTTP_FIELD_NUMBER: _ClassVar[int]
+http: _descriptor.FieldDescriptor
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 
-# Copyright 2024 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
 
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/auth.proto
+# Protobuf Python Version: 4.25.3
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -35,8 +36,10 @@
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, "google.api.auth_pb2", _globals)
 if _descriptor._USE_C_DESCRIPTORS == False:
-    DESCRIPTOR._options = None
-    DESCRIPTOR._serialized_options = b"\n\016com.google.apiB\tAuthProtoP\001ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\242\002\004GAPI"
+    _globals["DESCRIPTOR"]._options = None
+    _globals[
+        "DESCRIPTOR"
+    ]._serialized_options = b"\n\016com.google.apiB\tAuthProtoP\001ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\242\002\004GAPI"
     _globals["_AUTHENTICATION"]._serialized_start = 37
     _globals["_AUTHENTICATION"]._serialized_end = 145
     _globals["_AUTHENTICATIONRULE"]._serialized_start = 148

@@ -0,0 +1,120 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import ClassVar as _ClassVar
+from typing import Iterable as _Iterable
+from typing import Mapping as _Mapping
+from typing import Optional as _Optional
+from typing import Union as _Union
+
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf.internal import containers as _containers
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Authentication(_message.Message):
+    __slots__ = ("rules", "providers")
+    RULES_FIELD_NUMBER: _ClassVar[int]
+    PROVIDERS_FIELD_NUMBER: _ClassVar[int]
+    rules: _containers.RepeatedCompositeFieldContainer[AuthenticationRule]
+    providers: _containers.RepeatedCompositeFieldContainer[AuthProvider]
+    def __init__(
+        self,
+        rules: _Optional[_Iterable[_Union[AuthenticationRule, _Mapping]]] = ...,
+        providers: _Optional[_Iterable[_Union[AuthProvider, _Mapping]]] = ...,
+    ) -> None: ...
+
+class AuthenticationRule(_message.Message):
+    __slots__ = ("selector", "oauth", "allow_without_credential", "requirements")
+    SELECTOR_FIELD_NUMBER: _ClassVar[int]
+    OAUTH_FIELD_NUMBER: _ClassVar[int]
+    ALLOW_WITHOUT_CREDENTIAL_FIELD_NUMBER: _ClassVar[int]
+    REQUIREMENTS_FIELD_NUMBER: _ClassVar[int]
+    selector: str
+    oauth: OAuthRequirements
+    allow_without_credential: bool
+    requirements: _containers.RepeatedCompositeFieldContainer[AuthRequirement]
+    def __init__(
+        self,
+        selector: _Optional[str] = ...,
+        oauth: _Optional[_Union[OAuthRequirements, _Mapping]] = ...,
+        allow_without_credential: bool = ...,
+        requirements: _Optional[_Iterable[_Union[AuthRequirement, _Mapping]]] = ...,
+    ) -> None: ...
+
+class JwtLocation(_message.Message):
+    __slots__ = ("header", "query", "cookie", "value_prefix")
+    HEADER_FIELD_NUMBER: _ClassVar[int]
+    QUERY_FIELD_NUMBER: _ClassVar[int]
+    COOKIE_FIELD_NUMBER: _ClassVar[int]
+    VALUE_PREFIX_FIELD_NUMBER: _ClassVar[int]
+    header: str
+    query: str
+    cookie: str
+    value_prefix: str
+    def __init__(
+        self,
+        header: _Optional[str] = ...,
+        query: _Optional[str] = ...,
+        cookie: _Optional[str] = ...,
+        value_prefix: _Optional[str] = ...,
+    ) -> None: ...
+
+class AuthProvider(_message.Message):
+    __slots__ = (
+        "id",
+        "issuer",
+        "jwks_uri",
+        "audiences",
+        "authorization_url",
+        "jwt_locations",
+    )
+    ID_FIELD_NUMBER: _ClassVar[int]
+    ISSUER_FIELD_NUMBER: _ClassVar[int]
+    JWKS_URI_FIELD_NUMBER: _ClassVar[int]
+    AUDIENCES_FIELD_NUMBER: _ClassVar[int]
+    AUTHORIZATION_URL_FIELD_NUMBER: _ClassVar[int]
+    JWT_LOCATIONS_FIELD_NUMBER: _ClassVar[int]
+    id: str
+    issuer: str
+    jwks_uri: str
+    audiences: str
+    authorization_url: str
+    jwt_locations: _containers.RepeatedCompositeFieldContainer[JwtLocation]
+    def __init__(
+        self,
+        id: _Optional[str] = ...,
+        issuer: _Optional[str] = ...,
+        jwks_uri: _Optional[str] = ...,
+        audiences: _Optional[str] = ...,
+        authorization_url: _Optional[str] = ...,
+        jwt_locations: _Optional[_Iterable[_Union[JwtLocation, _Mapping]]] = ...,
+    ) -> None: ...
+
+class OAuthRequirements(_message.Message):
+    __slots__ = ("canonical_scopes",)
+    CANONICAL_SCOPES_FIELD_NUMBER: _ClassVar[int]
+    canonical_scopes: str
+    def __init__(self, canonical_scopes: _Optional[str] = ...) -> None: ...
+
+class AuthRequirement(_message.Message):
+    __slots__ = ("provider_id", "audiences")
+    PROVIDER_ID_FIELD_NUMBER: _ClassVar[int]
+    AUDIENCES_FIELD_NUMBER: _ClassVar[int]
+    provider_id: str
+    audiences: str
+    def __init__(
+        self, provider_id: _Optional[str] = ..., audiences: _Optional[str] = ...
+    ) -> None: ...
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 
-# Copyright 2024 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
 
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/backend.proto
+# Protobuf Python Version: 4.25.3
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -35,12 +36,18 @@
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, "google.api.backend_pb2", _globals)
 if _descriptor._USE_C_DESCRIPTORS == False:
-    DESCRIPTOR._options = None
-    DESCRIPTOR._serialized_options = b"\n\016com.google.apiB\014BackendProtoP\001ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\242\002\004GAPI"
-    _BACKENDRULE_OVERRIDESBYREQUESTPROTOCOLENTRY._options = None
-    _BACKENDRULE_OVERRIDESBYREQUESTPROTOCOLENTRY._serialized_options = b"8\001"
-    _BACKENDRULE.fields_by_name["min_deadline"]._options = None
-    _BACKENDRULE.fields_by_name["min_deadline"]._serialized_options = b"\030\001"
+    _globals["DESCRIPTOR"]._options = None
+    _globals[
+        "DESCRIPTOR"
+    ]._serialized_options = b"\n\016com.google.apiB\014BackendProtoP\001ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\242\002\004GAPI"
+    _globals["_BACKENDRULE_OVERRIDESBYREQUESTPROTOCOLENTRY"]._options = None
+    _globals[
+        "_BACKENDRULE_OVERRIDESBYREQUESTPROTOCOLENTRY"
+    ]._serialized_options = b"8\001"
+    _globals["_BACKENDRULE"].fields_by_name["min_deadline"]._options = None
+    _globals["_BACKENDRULE"].fields_by_name[
+        "min_deadline"
+    ]._serialized_options = b"\030\001"
     _globals["_BACKEND"]._serialized_start = 40
     _globals["_BACKEND"]._serialized_end = 89
     _globals["_BACKENDRULE"]._serialized_start = 92

@@ -0,0 +1,102 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import ClassVar as _ClassVar
+from typing import Iterable as _Iterable
+from typing import Mapping as _Mapping
+from typing import Optional as _Optional
+from typing import Union as _Union
+
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Backend(_message.Message):
+    __slots__ = ("rules",)
+    RULES_FIELD_NUMBER: _ClassVar[int]
+    rules: _containers.RepeatedCompositeFieldContainer[BackendRule]
+    def __init__(
+        self, rules: _Optional[_Iterable[_Union[BackendRule, _Mapping]]] = ...
+    ) -> None: ...
+
+class BackendRule(_message.Message):
+    __slots__ = (
+        "selector",
+        "address",
+        "deadline",
+        "min_deadline",
+        "operation_deadline",
+        "path_translation",
+        "jwt_audience",
+        "disable_auth",
+        "protocol",
+        "overrides_by_request_protocol",
+    )
+
+    class PathTranslation(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+        __slots__ = ()
+        PATH_TRANSLATION_UNSPECIFIED: _ClassVar[BackendRule.PathTranslation]
+        CONSTANT_ADDRESS: _ClassVar[BackendRule.PathTranslation]
+        APPEND_PATH_TO_ADDRESS: _ClassVar[BackendRule.PathTranslation]
+    PATH_TRANSLATION_UNSPECIFIED: BackendRule.PathTranslation
+    CONSTANT_ADDRESS: BackendRule.PathTranslation
+    APPEND_PATH_TO_ADDRESS: BackendRule.PathTranslation
+
+    class OverridesByRequestProtocolEntry(_message.Message):
+        __slots__ = ("key", "value")
+        KEY_FIELD_NUMBER: _ClassVar[int]
+        VALUE_FIELD_NUMBER: _ClassVar[int]
+        key: str
+        value: BackendRule
+        def __init__(
+            self,
+            key: _Optional[str] = ...,
+            value: _Optional[_Union[BackendRule, _Mapping]] = ...,
+        ) -> None: ...
+    SELECTOR_FIELD_NUMBER: _ClassVar[int]
+    ADDRESS_FIELD_NUMBER: _ClassVar[int]
+    DEADLINE_FIELD_NUMBER: _ClassVar[int]
+    MIN_DEADLINE_FIELD_NUMBER: _ClassVar[int]
+    OPERATION_DEADLINE_FIELD_NUMBER: _ClassVar[int]
+    PATH_TRANSLATION_FIELD_NUMBER: _ClassVar[int]
+    JWT_AUDIENCE_FIELD_NUMBER: _ClassVar[int]
+    DISABLE_AUTH_FIELD_NUMBER: _ClassVar[int]
+    PROTOCOL_FIELD_NUMBER: _ClassVar[int]
+    OVERRIDES_BY_REQUEST_PROTOCOL_FIELD_NUMBER: _ClassVar[int]
+    selector: str
+    address: str
+    deadline: float
+    min_deadline: float
+    operation_deadline: float
+    path_translation: BackendRule.PathTranslation
+    jwt_audience: str
+    disable_auth: bool
+    protocol: str
+    overrides_by_request_protocol: _containers.MessageMap[str, BackendRule]
+    def __init__(
+        self,
+        selector: _Optional[str] = ...,
+        address: _Optional[str] = ...,
+        deadline: _Optional[float] = ...,
+        min_deadline: _Optional[float] = ...,
+        operation_deadline: _Optional[float] = ...,
+        path_translation: _Optional[_Union[BackendRule.PathTranslation, str]] = ...,
+        jwt_audience: _Optional[str] = ...,
+        disable_auth: bool = ...,
+        protocol: _Optional[str] = ...,
+        overrides_by_request_protocol: _Optional[_Mapping[str, BackendRule]] = ...,
+    ) -> None: ...
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 
-# Copyright 2024 Google LLC
+# Copyright 2025 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
 
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/billing.proto
+# Protobuf Python Version: 4.25.3
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -35,8 +36,10 @@
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, "google.api.billing_pb2", _globals)
 if _descriptor._USE_C_DESCRIPTORS == False:
-    DESCRIPTOR._options = None
-    DESCRIPTOR._serialized_options = b"\n\016com.google.apiB\014BillingProtoP\001ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\242\002\004GAPI"
+    _globals["DESCRIPTOR"]._options = None
+    _globals[
+        "DESCRIPTOR"
+    ]._serialized_options = b"\n\016com.google.apiB\014BillingProtoP\001ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\242\002\004GAPI"
     _globals["_BILLING"]._serialized_start = 41
     _globals["_BILLING"]._serialized_end = 188
     _globals["_BILLING_BILLINGDESTINATION"]._serialized_start = 123