Antes de comenzar a codificar la primera aplicación de presupuesto de Facturación de Cloud, debes realizar algunas tareas, si aún no las hiciste.
Prueba las funciones de Facturación de Cloud en la consola de Google Cloud
En esta documentación de la API, se da por sentado que usaste Google Cloud y que conoces las características y los conceptos de Facturación de Cloud en la consola de Google Cloud. Si aún no estás familiarizado con conceptos como cuentas de facturación de Cloud, proyectos de Google Cloud, productos de Google Cloud, y presupuestos y alertas de Facturación de Cloud, lee los siguientes documentos antes de comenzar a codificar:
- Descripción general de los conceptos de Facturación de Cloud
- Administra tu cuenta de Facturación de Cloud
- Visualiza los proyectos vinculados a una cuenta de Facturación de Cloud.
- Reglas de presupuesto y alertas de presupuesto.
- Control de acceso para la API de presupuesto de Facturación de Cloud
Una vez que estés familiarizado con las características y los conceptos de Facturación de Cloud, prueba la interfaz de usuario de la consola de Google Cloud.
Conceptos clave de Facturación de Cloud
- Cada cuenta de Facturación de Cloud individual puede tener varios miles de presupuestos asociados a ella a la vez. Consulta Cuotas y límites para obtener información adicional y los límites actuales.
- Un presupuesto está vinculado a una sola cuenta de Facturación de Cloud a la vez.
- Una sola cuenta de facturación de Cloud está vinculada a uno o más proyectos de Google Cloud y paga por ellos.
- Un proyecto de Google Cloud está vinculado a una sola cuenta de Facturación de Cloud a la vez.
- Puedes crear un presupuesto para supervisar los costos de toda una cuenta de Facturación de Cloud, incluidos todos los proyectos de Google Cloud pagados a través de esa cuenta de facturación. También puedes definir el alcance del presupuesto mediante los filtros de presupuesto detallados para supervisar porciones específicas de los costos. Los filtros incluyen proyectos de Google Cloud, servicios, el período del presupuesto y otros filtros aplicables a tu cuenta de Facturación de Cloud.
Obtén información sobre los aspectos básicos de REST
Hay dos formas de invocar a la API de presupuesto de Facturación de Cloud:
- Enviar solicitudes HTTP y analizar las respuestas
- Usar bibliotecas cliente (recomendado).
Si decides no usar bibliotecas cliente, deberás comprender los conceptos 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 presupuesto de Facturación de Cloud
Las operaciones de la API de presupuesto 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 presupuesto de Facturación de Cloud son los siguientes:
https://billingbudgets.googleapis.com/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 presupuesto de Facturación de Cloud (REST, RPC).
Obtén información sobre los aspectos básicos de JSON
La API de presupuesto 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.