En esta guía, se proporcionan todos los pasos de configuración necesarios para comenzar a usar la API de presupuesto de Facturación de Cloud.
Antes de comenzar
Debes hacer lo siguiente antes de leer esta guía:
- Consulta Descripción general de la API de presupuesto de Facturación de Cloud.
- Consulta Requisitos previos de la API de presupuesto de Facturación de Cloud.
Acerca de la consola de Google Cloud
La consola de Google Cloud (consultar la documentación, abrir la consola) es una IU web que se usa para aprovisionar, configurar, administrar y supervisar los sistemas que usan productos de Google Cloud. Usa la consola de Google Cloud para configurar y administrar los recursos de Google Cloud y de la Facturación de Cloud.
1. Selecciona o crea un proyecto
Para usar los servicios que proporciona Google Cloud, debes crear un proyecto. En él, se organizan todos tus recursos de Google Cloud. Un proyecto consta de un conjunto de colaboradores, API habilitadas (y otros recursos), herramientas de supervisión, datos de facturación, y controles de autenticación y acceso. Puedes crear uno o varios proyectos y usarlos para organizar tus recursos de Google Cloud en una jerarquía de recursos. Para obtener más información sobre los proyectos, consulta la documentación de Resource Manager.
Recomendación: Te recomendamos que configures un proyecto de Google Cloud independiente y único que contenga todas tus necesidades de administración de la facturación, incluida la API de presupuesto de Facturación de Cloud. El proyecto de administración de la facturación de Google Cloud también se puede usar para el acceso a la API de la cuenta de facturación de Cloud, los datos exportados de la Facturación de Cloud y los canales de Pub/Sub destinados a las notificaciones de presupuesto programáticas, entre otras cosas.
En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
2. Habilitar facturación
Debes asegurarte de que la facturación esté habilitada en el proyecto que usas para llamar a la API de presupuesto de Facturación de Cloud. Si seguiste la recomendación en la sección de proyecto, este es tu proyecto de administración de la facturación de Google Cloud.
Una cuenta de Facturación de Cloud se usa para definir quién paga por un conjunto determinado de recursos de Google Cloud. Los recursos, que pueden ser, por ejemplo, API habilitadas, están organizados en proyectos. Una cuenta de facturación de Cloud se puede vincular a uno o más proyectos. El uso del proyecto se carga a la cuenta de facturación vinculada. En la mayoría de los casos, configuras la facturación cuando creas un proyecto. Para obtener más información, consulta Documentación de Cloud Billing.
Configura los presupuestos de Facturación de Cloud para supervisar una cuenta de Facturación de Cloud. La cuenta de facturación de Cloud que supervisas puede ser la misma que está vinculada al proyecto usado para llamar a la API de presupuesto de Facturación de Cloud. Ten en cuenta que la API de presupuesto de Facturación de Cloud es gratuita para los clientes de Google Cloud. Si eliges configurar las notificaciones de presupuesto programáticas, se te cobrarán los precios estándar de Pub/Sub.
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
3. Habilite la API
Debes habilitar la API de presupuesto de Facturación de Cloud en el proyecto que usas para llamarla. Si seguiste la recomendación en la sección de proyecto, este es tu proyecto de administración de la facturación de Google Cloud.
Para obtener más información sobre cómo habilitar las API, consulta Cómo habilitar e inhabilitar servicios.
Habilita Cloud Billing Budget API.
4. Configura la autenticación y la autorización
Si planeas usar la API de presupuesto de Facturación de Cloud, debes configurar la autenticación. Cualquier aplicación cliente que use la API debe confirmar su identidad mediante la autenticación. Para obtener más información, consulta Autentica la Facturación de Cloud.
Debes autenticarte como un principal específico, como una Cuenta de Google o una cuenta de servicio. Ese principal debe tener funciones de Identity and Access Management (IAM) que contengan los permisos necesarios para la API de presupuesto de Facturación de Cloud.
Para garantizar que la cuenta principal tenga los permisos necesarios y se puedan administrar presupuestos, pídele a tu administrador que le otorgue el rol de IAM de Administrador de cuentas de facturación (roles/billing.admin) en tu facturación.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.
Es posible que tu administrador también pueda otorgar los permisos necesarios a la principal a través de funciones personalizadas o de otras funciones predefinidas.
Para obtener información sobre cómo otorgar funciones en una cuenta de facturación, consulta Actualiza permisos de Facturación de Cloud.
5. Instala e inicializa la CLI de gcloud
Si planeas usar la API de presupuesto de Facturación de Cloud, debes instalar y, luego, inicializar Google Cloud CLI. Google Cloud CLI es un conjunto de herramientas que puedes usar para administrar recursos y aplicaciones alojados en Google Cloud. Esto incluye la CLI de gcloud. En el siguiente vínculo, se proporcionan instrucciones:
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
6. Prueba el SDK y la autenticación
Si ya configuraste la autenticación en los pasos anteriores, puedes usar la herramienta de gcloud CLI para probar tu entorno de autenticación. Ejecuta el siguiente comando para verificar que no se produzcan errores y que se muestren las credenciales:
gcloud auth print-access-token
Todos los ejemplos de REST de la línea de comandos de la API de presupuesto de Facturación de Cloud usan ese comando para autenticar las llamadas a la API.
7. Instala la biblioteca cliente de la API de presupuesto de Facturación de Cloud
La API de presupuesto de Facturación de Cloud se basa en HTTP y JSON, por lo que cualquier cliente HTTP estándar puede enviarle solicitudes y analizar las respuestas.
Tienes las siguientes tres opciones para llamar a la API:
Bibliotecas cliente compatibles con Google (opción recomendada)
Las bibliotecas cliente proporcionan una mejor integración del lenguaje, mayor seguridad y compatibilidad para realizar llamadas que requieren la autorización del usuario. Las bibliotecas cliente compatibles con Google están disponibles para varios lenguajes conocidos, y esta es la opción recomendada.