If you are using Google Cloud APIs for the first time, you can follow
the steps in this guide to call the APIs using
curl commands. You can use
curl commands to experiment with an API before you develop your application.
Creating a Google account
To use Google Cloud APIs in your applications, you first need to have a Google account. This allows you to use Google developer products, including Google Cloud Console, Cloud SDK, Cloud Logging, and Cloud Monitoring. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
Creating a Google project
To use Cloud APIs, you also need to have a Google project. A project is equivalent to a developer account. It serves as a resource container for your Google Cloud resources. It also provides an isolation boundary for your usage of Google Cloud services, so you can manage quota limits and billing independently at the project level. Usage telemetry and dashboards are grouped by projects as well. If you don't already have a project, you can create one using the Cloud Console.
A project can own a wide range of resources, including API keys, OAuth clients, service accounts, Compute Engine VMs, Cloud Storage buckets, and BigQuery datasets. When an application calls a Cloud API, the project that owns the application credentials is called the client project, and the project that owns the target resource is called the resource project. One API request may touch multiple resources, hence multiple resource projects are involved.
If you want to stop using Google Cloud for any reasons, you can use Cloud Console to delete your project. Your project and all resources in the project will be deleted after the retention window. Note that different types of data have different retention periods.
To use a Cloud API, you must enable it for your project. Depending on which services and which projects are involved from your application, including the client project and resource projects, you may need to enable an API for multiple projects.
Enabling an API requires you to accept the Terms of Service and billing
responsibility for the API. You need permission
on the project to enable APIs. For more information, see Service Usage
To enable an API for a project using the console:
- Go to the Cloud Console API Library.
- From the projects list, select the project you want to use.
- In the API Library, select the API you want to enable. If you need help finding the API, use the search field and/or the filters.
- On the API page, click ENABLE.
From the same page you can disable an API for your project if you no longer use it to avoid misuse and accidental billing charges. You can also enable and disable Cloud APIs using the Cloud SDK and the Service Usage API:
$ gcloud services enable pubsub.googleapis.com $ gcloud services disable pubsub.googleapis.com
Some Cloud APIs charge for usage. You need to enable billing for your project before you can start using these APIs in your project. The API usage in a project is charged to the billing account associated with the project.
Getting application credentials
Cloud APIs only accept API requests from registered applications. This requirement helps API producers associate and report API usage to the right project owning the application.
Cloud APIs use application credentials for identifying the calling applications. Credential types include API keys, OAuth 2.0 clients, and service accounts. You can use Cloud Console to create, retrieve, and manage your application credentials. For more information about application credentials, see Authentication Overview.
Using application credentials
If you are new to Google Cloud APIs, we highly recommend that you use
oauth2l to experiment with your
application credentials and Cloud APIs before writing any application code.
oauth2l can accept any application credentials and use them to make calls to
Google Cloud APIs using the
oauth2l curl --credentials ./creds.json --scope cloud-platform --url https://pubsub.googleapis.com/v1/projects/my-project-id/topics -- -v
If you are building an application using Cloud APIs, we recommend you to use Google Cloud Client Libraries if available. The client libraries can handle common API features for your convenience, such as authentication, error handling, retry, and payload validation. You need to pass your application credentials to the client libraries during initialization, so the client libraries can make calls to Google Cloud APIs on behalf of your application.
For more information, see Client Libraries Explained.
For more information about authentication, see Authentication overview.
For more information about error handling, see Handling Errors.
For more information about billing, see Create, modify, or close your billing account.
For more information about enabling billing on your project, see Modify a project's billing settings.
For more information about enabling and disabling APIs, see Enabling and disabling services.