Sign Up

This page describes how to activate the Google Cloud Datastore API, the quotas associated with this API, and how to enable billing. The activation process varies based on your existing setup and environment.

Accessing the Cloud Datastore API from a Compute Engine instance

This section shows how to activate and access the Cloud Datastore API from a Compute Engine VM instance in a new or existing Cloud project.

  1. Enable the Cloud Datastore API for the project. You can enable the API for an existing project, or create a new project and then enable the API.
    Enable the Cloud Datastore API
  2. Enable the Google Compute Engine API for the project you selected or created in the previous step.
    Enable the Compute Engine API
  3. In the Cloud Platform Console, go to the Billing page.

    Go to the Billing page

  4. Click New billing account.
  5. Fill out your billing information, and then click Accept and start free trial.
  6. Create a Compute Engine instance.

Console

  1. In the Google Cloud Platform Console, go to the VM Instances page.
  2. Click the Create instance button.
  3. In the Identity and API access section, set Access scopes to provide access for Datastore. Either click Allow full access to all Cloud APIs to grant access to all Google Cloud APIs, or click Set access for each API, click the dropdown for Cloud Datastore, and then click Enabled to grant access to Cloud Datastore.
  4. Click the Create button to create the instance.
  5. Confirm that your instance is running.
  6. To use this new Compute Engine instance, connect to it using your browser.

gcloud

  1. If you haven't already done this, install the gcloud tool and set up gcloud compute.
  2. Add a Google Compute Engine instance and start it, following the instructions for starting an instance in the Google Compute Engine documentation. Specify the project ID, the instance name, and the datastore scope as shown here, where [YOUR_PROJECT_ID] is the ID of the project you created previously and [YOUR_INSTANCE_NAME] is the name you want to use for your Compute Engine instance:

    export PROJECT_ID=[YOUR_PROJECT_ID]
    export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
    gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore
    
  3. Confirm that your instance is running.

  4. To use this new Compute Engine instance, connect to it using ssh.

At this point all services and authorizations are configured for your project and you can start writing code or exploring the API.

Accessing the Cloud Datastore API from another platform

This section shows how to activate and access the Cloud Datastore API from an external application running on a platform outside of Google Cloud.

  1. Enable the Cloud Datastore API for the project. You can enable the API for an existing project, or create a new project and then enable the API.
    Enable the Cloud Datastore API
  2. Go to the Create service account key page.
  3. Click the drop-down box below Service account, then click New service account.
  4. Enter a name for the service account in Name.
  5. Use the default Service account ID or generate a different one.
  6. Select JSON in Key type.
  7. Click Create.
  8. Upon successful creation, your browser will download the private key. The Cloud Platform Console provides a prompt that displays the private key file name. Note the file name so you can locate it, then click Close to dismiss the prompt.
  9. Your Service Account is the Email address displayed under the Service Account section.
  10. Your Private Key is the file you just downloaded.

At this point all services and authorizations are configured for your project and you can start writing code or exploring the API.

Quotas and billing

A certain amount of free quota is available, as described in Pricing and Quota. This means you aren't required to enable billing to get started or to use Cloud Datastore up to the free quota limits. However, if you need more resources than is provided by the free quota, you must enable billing and set a budget for your project.

Enabling billing and setting a budget

The budget is a daily limit: it sets the maximum dollar amount of resources you will be charged for each day. After this limit is reached, no further costs will be incurred, but also, no further billable Cloud Datastore operations will be allowed. You'll need to specify a budget because the initial default budget is always 0, which means by default you cannot exceed the free quota, even with billing enabled.

To enable billing:

  1. In the Cloud Platform Console, go to the Billing page.

    Go to the Billing page

  2. Click New billing account.
  3. Fill out your billing information, and then click Accept and start free trial.

To set a budget:

Send feedback about...

Cloud Datastore