Configuration#

Overview#

Use service client objects to configure your applications.

For example:

>>> from gcloud import bigquery
>>> client = bigquery.Client()

When creating a client in this way, the project ID will be determined by searching these locations in the following order.

GCLOUD_PROJECT environment variable
GOOGLE_APPLICATION_CREDENTIALS JSON file
Default service configuration path from $ gcloud beta auth application-default login.
Google App Engine application ID
Google Compute Engine project ID (from metadata server)

You can override the detection of your default project by setting the: project parameter when creating client objects.

>>> from gcloud import bigquery
>>> client = bigquery.Client(project='my-project')

You can see what project ID a client is referencing by accessing the project property on the client object.

>>> client.project
u'my-project'

Authentication#

The authentication credentials can be implicitly determined from the environment or directly. See Authentication.

Logging in via gcloud beta auth application-default login will automatically configure a JSON key file with your default project ID and credentials.

Setting the GOOGLE_APPLICATION_CREDENTIALS and GCLOUD_PROJECT environment variables will override the automatically configured credentials.

You can change your default project ID to my-new-default-project by using the gcloud CLI tool to change the configuration.

$ gcloud config set project my-new-default-project