Sign Up

This page describes how to activate the Google Cloud Datastore API, the quotas associated with this API, how to enable billing, and how to set a spending limit. 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. To use the Cloud Datastore API, your Cloud project requires an active App Engine application. Open the App Engine dashboard and confirm your Cloud project has an active App Engine app.
    Open the App Engine dashboard
    Create an App Engine app if needed. The app must not be disabled.
  3. Enable the Google Compute Engine API for the project you selected or created in the previous step.
    Enable the Compute Engine API
  4. Enable billing for your project.

    Enable billing

  5. 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. To use the Cloud Datastore API, your Cloud project requires an active App Engine application. Open the App Engine dashboard and confirm your Cloud project has an active App Engine app.
    Open the App Engine dashboard
    Create an App Engine app if needed. The app must not be disabled.
  3. Go to the Create service account key page.
  4. Click the drop-down box below Service account, then click New service account.
  5. Enter a name for the service account in Name.
  6. Use the default Service account ID or generate a different one.
  7. Select JSON in Key type.
  8. Click Create.
  9. 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.
  10. Your Service Account is the Email address displayed under the Service Account section.
  11. 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 spending limit for your project.

Enabling billing and setting a spending limit

The spending limit 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 spending limit because the initial default spending limit is always 0, which means by default you cannot exceed the free quota, even with billing enabled.

Cloud Datastore resources are part of App Engine resources. The spending limit for App Engine resources are set in the App Engine Application settings.

To enable billing:

  1. Enable billing for your project.

    Enable billing

To set a spending limit:

  1. Go to the Application settings.
    Go to the Application settings
  2. Click Edit and specify a spending limit.
  3. Click Save.

The spending limit only applies to App Engine resources, which includes Cloud Datastore, for the selected project:

  • You may still be charged for other Google Cloud Platform resources.
  • If you have multiple projects, you may want to set the spending limit for each project.

When you increase the daily spending limit, the new limit takes effect immediately.

For more information, see Spending Limits.