A partir de enero de 2021, puedes usar la API de Cloud Channel para crear clientes, derechos y cuentas secundarias de Facturación de Cloud. Si actualmente usas la API de Cloud Billing para controlar estas tareas, te recomendamos que uses la API de Cloud Channel.
En esta guía, se presentan los conceptos básicos de la creación de clientes y derechos con la API de Cloud Channel.
Antes de comenzar
Completa el codelab de la API de Cloud Channel antes de continuar. Esto te garantizará que tu entorno de desarrollo esté configurado para seguir muestras de código y otros codelabs.
Resumen de cambios
Si actualmente usas el extremo billingAccounts.create
de la API de Cloud Billing para crear una cuenta de facturación secundaria de un cliente, debes comenzar a usar el extremo customers.create()
, seguido del extremo entitlements.create()
, para crear una nueva cuenta de facturación secundaria de Cloud para un cliente.
Para administrar roles de IAM, debes usar los extremos existentes de la API de Cloud Billing.
Crea un cliente
Cuando tengas todo listo para crear un cliente nuevo con la API de Cloud Channel, usa el extremo customers.create()
. Antes de comenzar, asegúrate de tener la siguiente información del cliente.
- Dominio principal
- Nombre de la organización
- Dirección
- Código postal (si corresponde)
- Código de país
Después de crear un cliente, debes mantener seguro el campo name
de la respuesta, ya que es un identificador único para tu cliente.
Crea una autorización
Después de crear un cliente, puedes aprovisionar derechos para él. Para ello, especifica un offer
con los extremos entitlements.create()
y operations.get()
. El nombre de la cuenta secundaria de Facturación de Cloud, que se muestra como provisionedService.provisioningId
, se puede usar con la API de Cloud Billing y la exportación de BigQuery.
Si creas un derecho con una oferta de Google Cloud , también se creará una cuenta secundaria de Facturación de Cloud.
Para obtener instrucciones más detalladas sobre la creación de clientes y derechos, incluidos fragmentos de código en varios idiomas, completa el Google Cloud codelab de aprovisionamiento de extremo a extremo.