Antes de empezar a programar tu primera aplicación cliente, tienes que hacer varias cosas (si es que aún no las has hecho):
Probar las funciones de facturación en la consola de Google Cloud Platform
En esta documentación de la API se presupone que ya has utilizado Google Cloud Platform y que te has familiarizado con las funciones y los conceptos de facturación de la consola de Google Cloud Platform.
Si todavía no dominas conceptos como las cuentas de facturación y los proyectos, prueba la interfaz de usuario antes de ponerte a programar.
Conocer los aspectos básicos de REST
Hay dos formas de invocar la API:
- Enviar peticiones HTTP y analizar las respuestas.
- Utilizar bibliotecas cliente.
Si prefieres no utilizar las bibliotecas cliente, tendrás que comprender los aspectos básicos de REST.
REST es un tipo de arquitectura de software que proporciona un método cómodo y uniforme para enviar peticiones y modificar datos.
El término REST es la abreviatura en inglés de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, hace referencia al uso de verbos HTTP para obtener y modificar representaciones de datos que ha almacenado Google.
En un sistema RESTful (es decir, que utiliza una arquitectura REST), los recursos se guardan en un almacén de datos. El cliente envía una petición para que el servidor realice una acción determinada (como crear, obtener, actualizar o eliminar un recurso) y este, tras llevarla a cabo, envía una respuesta, normalmente como una representación del recurso especificado.
En las API RESTful de Google, el cliente especifica una acción mediante un verbo HTTP como POST, GET, PUT o DELETE. El recurso se especifica globalmente mediante un URI exclusivo con el siguiente formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Como todos los recursos de la API tienen URI accesibles mediante HTTP, REST permite almacenar los datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.
Pueden resultarte útiles las definiciones de métodos de la documentación del estándar HTTP 1.1, ya que incluyen las especificaciones de GET, POST, PUT y DELETE.
REST en la API de facturación de Google Cloud
Las operaciones de la API de facturación de Google Cloud se corresponden directamente con los verbos HTTP de REST.
Los formatos específicos para los URI de la API de facturación de Google Cloud son:
https://www.googleapis.com/billing/v1/resourcePath?parameters
El conjunto completo de los URI que se utilizan para cada operación admitida en la API se resume en los documentos de referencia de REST y de RPC de la API de facturación de Google Cloud.
Conocer los aspectos básicos de JSON
La API de facturación de Google Cloud devuelve los datos en el formato JSON.
JSON (es decir, la notación de objetos de JavaScript) es un formato de datos común e independiente del lenguaje que proporciona una representación de texto simple de estructuras de datos arbitrarios. Visita json.org para obtener más información.