Before you can start coding your first client application, there are a few things you need to do, if you haven't done them already.
Try out the billing features in the Google Cloud Platform Console
This API documentation assumes that you've used Google Cloud Platform, and that you're familiar with the billing features and concepts in the Google Cloud Platform Console.
If you're not already familiar with concepts like billing accounts and projects, then try out the user interface before starting to code.
Learn REST basics
There are two ways to invoke the API:
- Sending HTTP requests and parsing the responses.
- Using client libraries.
If you decide not to use client libraries, you'll need to understand the basics of REST.
REST is a style of software architecture that provides a convenient and consistent approach to requesting and modifying data.
The term REST is short for "Representational State Transfer." In the context of Google APIs, it refers to using HTTP verbs to retrieve and modify representations of data stored by Google.
In a RESTful system, resources are stored in a data store; a client sends a request that the server perform a particular action (such as creating, retrieving, updating, or deleting a resource), and the server performs the action and sends a response, often in the form of a representation of the specified resource.
In Google's RESTful APIs, the client specifies an action using an HTTP verb such as
DELETE. It specifies a resource by a globally-unique URI of the following form:
Because all API resources have unique HTTP-accessible URIs, REST enables data caching and is optimized to work with the web's distributed infrastructure.
You may find the method definitions in the HTTP 1.1 standards documentation useful; they include specifications for
REST in the Google Cloud Billing API
The Google Cloud Billing API operations map directly to REST HTTP verbs.
The specific formats for Google Cloud Billing API URIs are:
Learn JSON basics
The Google Cloud Billing API returns data in JSON format.