Crear y gestionar cuentas de clientes con la API Cloud Channel

Desde enero del 2021, puedes usar la API Cloud Channel para crear clientes, derechos y subcuentas de facturación de Cloud. Si actualmente usas la API Cloud Billing para gestionar estas tareas, te recomendamos que uses la API Cloud Channel.

En esta guía se explican los conceptos básicos de la creación de clientes y derechos mediante la API Cloud Channel.

Antes de empezar

Completa el codelab de la API Cloud Channel antes de continuar. De esta forma, te asegurarás de que tu entorno de desarrollo esté configurado para seguir los ejemplos de código y otros codelabs.

Resumen de cambios

Si actualmente usas el endpoint de la API Cloud Billing billingAccounts.create para crear una subcuenta de facturación de Cloud para un cliente, debes empezar a usar el endpoint customers.create() y, a continuación, el endpoint entitlements.create() para crear una subcuenta de facturación de Cloud para un cliente.

Para gestionar roles de gestión de identidades y accesos, debes usar los endpoints de la API Cloud Billing.

Crear un cliente

Cuando quieras crear un cliente con la API Cloud Channel, usa el endpoint customers.create(). Asegúrate de tener la siguiente información del cliente antes de empezar.

  • Dominio principal
  • Nombre de la organización
  • Dirección
  • Código postal (si procede)
  • Código de país

Después de crear un cliente, debe mantener seguro el campo name de la respuesta, ya que es un identificador único de su cliente.

Crear un derecho

Una vez que hayas creado un cliente, puedes proporcionarle derechos especificando un offer con los endpoints entitlements.create() y operations.get(). El nombre de la subcuenta de Facturación de Cloud, que se devuelve como provisionedService.provisioningId, se puede usar con la API Cloud Billing y la exportación de BigQuery.

Si creas un derecho con una Google Cloud oferta, también se creará una subcuenta de facturación de Cloud.

Para obtener instrucciones más detalladas sobre cómo crear clientes y derechos, incluidos ejemplos de código en varios idiomas, completa el Google Cloud codelab de aprovisionamiento integral.