Antes de que comiences a escribir el código de tu primera aplicación cliente, hay unas cuantas tareas que debes realizar si aún no las has hecho.
Prueba las funciones de Facturación de Cloud en la consola de Google Cloud
En esta documentación de la API, se supone que usaste Google Cloud, y que conoces las funciones y los conceptos de Facturación de Cloud en la consola de Google Cloud.
Si aún no estás familiarizado con conceptos como las cuentas de Facturación de Cloud y los proyectos de Google Cloud, prueba la interfaz de usuario antes de comenzar a programar.
Obtén información sobre los aspectos básicos de REST
Hay dos formas de invocar a la API de Facturación de Cloud:
- Enviar solicitudes HTTP y analizar las respuestas
- Usar bibliotecas cliente
Si decides no usar bibliotecas cliente, deberás comprender los aspectos básicos de REST.
REST es un estilo de arquitectura de software que proporciona un enfoque conveniente y coherente para solicitar y modificar datos.
El término REST es la abreviatura de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, se refiere al uso de los verbos HTTP para recuperar y modificar las representaciones de los datos almacenados por Google.
En un sistema RESTful, los recursos se almacenan en un almacén de datos; un cliente envía una solicitud para que el servidor ejecute una acción en particular (como crear, recuperar, actualizar o borrar un recurso) y el servidor ejecuta la acción y envía una respuesta que, por lo general, es una representación del recurso especificado.
En las API con tecnología REST de Google, el cliente especifica una acción con un verbo HTTP como POST, GET, PUT o DELETE. Especifica un recurso mediante un URI único a nivel global de la siguiente manera:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Dado que todos los recursos de API tienen URI únicos accesibles a través de HTTP, REST permite el almacenamiento de datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.
Puedes encontrar las definiciones de métodos en la documentación de estándares del HTTP 1.1, los que incluyen especificaciones para GET, POST, PUT y DELETE.
REST en la API de Facturación de Cloud
Las operaciones de la API de Facturación de Cloud se asignan directamente a los verbos HTTP de REST.
Los formatos específicos para los URI de la API de Facturación de Cloud son los siguientes:
https://www.googleapis.com/billing/v1/resourcePath?parameters
El conjunto completo de URI utilizados para cada operación compatible en la API se resume en los documentos de referencia de la API de Facturación de Cloud (REST, RPC).
Obtén información sobre los conceptos básicos de JSON
La API de Facturación de Cloud muestra datos en formato JSON.
JSON (JavaScript Object Notation) es un formato de datos común y, también, independiente del lenguaje que proporciona una representación de texto simple de estructuras de datos arbitrarias. Para obtener más información, visita json.org.