This guide provides all required setup steps to start using the Cloud Billing Budget API.
Before you begin
You should do the following before reading this guide:
About the Google Cloud console
The Google Cloud console (visit documentation, open console) is a web UI used to provision, configure, manage, and monitor systems that use Google Cloud products. You use the Google Cloud console to set up and manage Google Cloud and Cloud Billing resources.
1. Select or Create a project
To use services provided by Google Cloud, you must create a project. A project organizes all your Google Cloud resources. A project consists of a set of collaborators, enabled APIs (and other resources), monitoring tools, billing information, and authentication and access controls. You can create one project, or you can create multiple projects and use them to organize your Google Cloud resources in a resource hierarchy. For more information on projects, see the Resource Manager documentation.
Recommendation: We recommend that you configure a separate, single Google Cloud project to contain all of your billing administration needs, including the Cloud Billing Budget API. Your billing administration Google Cloud project can also be used for things like Cloud Billing Account API access, Cloud Billing exported data, Pub/Sub channels for programmatic budget notifications, and so on.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
2. Enable billing
You need to make sure that billing is enabled on the project you are using for calling the Cloud Billing Budget API. If you followed the recommendation in the project section, this is your billing administration Google Cloud project.
A Cloud Billing Account is used to define who pays for a given set of Google Cloud resources. Resources, such as enabled APIs, are organized in projects. A Cloud Billing Account can be linked to one or more projects. Project usage is charged to the linked billing account. In most cases, you configure billing when you create a project. For more information, see the Billing documentation.
You set up Cloud Billing budgets to monitor a Cloud Billing Account. The Cloud Billing Account you are monitoring can be the same Cloud Billing Account that is linked to the project you use to call the Cloud Billing Budget API. Note that the Cloud Billing Budget API is free to use for Google Cloud customers. If you choose to configure programmatic budget notifications, you will be charged the standard Pub/Sub prices.
Make sure that billing is enabled for your Google Cloud project.
3. Enable the API
You must enable the Cloud Billing Budget API in the project you are using to call the Cloud Billing Budget API. If you followed the recommendation in the project section, this is your billing administration Google Cloud project.
For more information on enabling APIs, see the Service Usage documentation.
Enable the Cloud Billing Budget API.
4. Set up authentication and authorization
If you plan to use the Cloud Billing Budget API, you need to set up authentication. Any client application that uses the API must confirm its identity by authenticating. For details, see Authenticate to Cloud Billing.
You authenticate as a specific principal, such as a Google Account or a service account. That principal must have Identity and Access Management (IAM) roles that contain the required permissions for the Cloud Billing Budget API.
To ensure that the principal has the necessary
permissions to manage budgets,
ask your administrator to grant the principal the
Billing Account Administrator (roles/billing.admin) IAM role on your billing account.
For more information about granting roles, see Manage access.
Your administrator might also be able to give the principal the required permissions through custom roles or other predefined roles.
To learn how to grant roles on a billing account, see Update Cloud Billing permissions.
5. Install and initialize the gcloud CLI
If you plan to use the Cloud Billing Budget API, you need to install and initialize the Google Cloud CLI. Google Cloud CLI is a set of tools that you can use to manage resources and applications hosted on Google Cloud. This includes the gcloud CLI. The following link provides instructions:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
6. Test the SDK and authentication
If you have set up authentication in previous steps, you can use the gcloud CLI to test your authentication environment. Execute the following command to verify that no error occurs and that credentials are returned:
gcloud auth print-access-token
That command is used by all Cloud Billing Budget API command line REST samples to authenticate API calls.
7. Install the Cloud Billing Budget API client library
The Cloud Billing Budget API is built on HTTP and JSON, so any standard HTTP client can send requests to it and parse the responses.
You have three options for calling the API:
Google supported client libraries (recommended)
Client libraries provide better language integration, improved security, and support for making calls that require user authorization. The Google supported client libraries are available for several popular languages, and these are the recommended option.