Module client (2.22.0)

Convenience wrapper for invoking APIs/factories w/ a project.

Classes

Client

Client(project=None,namespace=None,credentials=None,client_info=google.api_core.gapic_v1.client_info.ClientInfo,client_options=None,database=None,_http=None,_use_grpc=None,)

Convenience wrapper for invoking APIs/factories w/ a project.

.. doctest::

from google.cloud import datastoreclient = datastore.Client()

Parameters
NameDescription
projectstr

(Optional) The project to pass to proxied API methods.

namespacestr

(Optional) namespace to pass to proxied API methods.

credentialsgoogle.auth.credentials.Credentials

(Optional) The OAuth2 Credentials to use for this client. If not passed (and if no_http object is passed), falls back to the default inferred from the environment.

client_infogoogle.api_core.gapic_v1.client_info.ClientInfo orgoogle.api_core.client_info.ClientInfo

(Optional) The client info used to send a user-agent string along with API requests. IfNone, then default info will be used. Generally, you only need to set this if you're developing your own library or partner tool.

client_optionsgoogle.api_core.client_options.ClientOptions ordict

(Optional) Client options used to set user options on the client. API Endpoint should be set through client_options.

_httprequests.Session

(Optional) HTTP object to make requests. Can be any object that definesrequest() with the same interface asrequests.Session.request. If not passed, an_http object is created that is bound to thecredentials for the current object. This parameter should be considered private, and could change in the future.

_use_grpcbool

(Optional) Explicitly specifies whether to use the gRPC transport (via GAX) or HTTP. If unset, falls back to theGOOGLE_CLOUD_DISABLE_GRPC environment variable. This parameter should be considered private, and could change in the future.

databasestr

(Optional) database to pass to proxied API methods.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-16 UTC.