On January 1, 2020 this library will no longer support Python 2 on the latest released version. Previously released library versions will continue to be available. For more information please visit Python 2 support on Google Cloud.

Client Options

Client options class.

Client options provide a consistent interface for user options to be defined across clients.

You can pass a client options object to a client.

from google.api_core.client_options import ClientOptions
from google.cloud.vision_v1 import ImageAnnotatorClient

def get_client_cert():
    # code to load client certificate and private key.
    return client_cert_bytes, client_private_key_bytes

options = ClientOptions(api_endpoint="foo.googleapis.com",
    client_cert_source=get_client_cert)

client = ImageAnnotatorClient(client_options=options)

You can also pass a dictionary.

from google.cloud.vision_v1 import ImageAnnotatorClient

client = ImageAnnotatorClient(
    client_options={
        "api_endpoint": "foo.googleapis.com",
        "client_cert_source" : get_client_cert
    })

class google.api_core.client_options.ClientOptions(api_endpoint=None, client_cert_source=None, client_encrypted_cert_source=None, quota_project_id=None, credentials_file=None, scopes=None)

Bases: object

Client Options used to set options on clients.

Parameters

• api_endpoint (Optional[str]) – The desired API endpoint, e.g., compute.googleapis.com

• client_cert_source (Optional[Callable[[], (bytes, bytes)]]) – A callback which returns client certificate bytes and private key bytes both in PEM format. client_cert_source and client_encrypted_cert_source are mutually exclusive.

• client_encrypted_cert_source (Optional[Callable[[], (str, str, bytes)]]) – A callback which returns client certificate file path, encrypted private key file path, and the passphrase bytes.``client_cert_source`` and client_encrypted_cert_source are mutually exclusive.

• quota_project_id (Optional[str]) – A project name that a client’s quota belongs to.

• credentials_file (Optional[str]) – A path to a file storing credentials.

• scopes (Optional[Sequence[str]]) – OAuth access token override scopes.

Raises

ValueError – If both client_cert_source and client_encrypted_cert_source are provided.

google.api_core.client_options.from_dict(options)

Construct a client options object from a dictionary.

Parameters

options (Dict[str, Any]) – A dictionary with client options. See the docstring for ClientOptions for details on valid arguments.