Descripción general de la API de distribuidor

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Una de las formas en que Google ofrece servicios de productos de Google a los usuarios es a través de los canales de distribución de servicios, como los distribuidores autorizados de Google Workspace. Cuando trabajas con la API de distribuidor, es importante comprender las relaciones conceptuales entre los distribuidores y los clientes, los planes de pagos, los SKU de productos y las licencias.

Distribuidor

Un distribuidor compra licencias de usuario a Google y las distribuye a los clientes de Google. Un distribuidor puede administrar las suscripciones de clientes directamente o, si personaliza varios servicios, puede trabajar con un integrador de servicios para administrar a los clientes.

Los distribuidores pueden elegir entre los siguientes planes:

  • compromiso anual: el distribuidor compra una cantidad fija de licencias de Google por un año. Los clientes pueden crear hasta el recuento de licencias, pero a los distribuidores se les factura la cantidad de licencias pedidas. Si los clientes necesitan licencias adicionales, los distribuidores pueden usar la llamada a la API subscriptions.changeSeats para aumentar la cantidad de licencias pedidas.
  • Flexible: Cada vez que un cliente crea un usuario nuevo, Google le cobra esta licencia al distribuidor. El contrato del distribuidor con Google describe el precio, las especificaciones y la cantidad máxima de licencias.

Además de administrar las licencias de usuario, el distribuidor (o sus integradores de servicios asociados) proporciona a los clientes una amplia gama de servicios adicionales, como capacitación, promociones, publicidad, precios, personalización de implementaciones, solución de problemas y mantenimiento.

Licencias

Una licencia permite que un usuario con una Cuenta de Google acceda a los servicios de Google Workspace. Cuando un cliente asigna una licencia a un usuario, se convierte en una licencia activa. Para calcular la cantidad total de usuarios de un cliente, solo se cuentan las licencias activas.

Cliente

Un cliente de Google comienza con una cuenta de Google Workspace que configura el distribuidor. Cuando configura la cuenta del cliente, el distribuidor proporciona un nombre de dominio principal, un correo electrónico alternativo y una dirección física. Luego, el distribuidor también crea una suscripción para cada SKU del producto disponible para el cliente. El cliente aloja cada cuenta de usuario individual. Para obtener más información, consulta Solicita una cuenta de cliente nueva.

Planes

Un plan define las condiciones de facturación de un distribuidor con Google. Estos planes no definen la relación de facturación entre un distribuidor y sus clientes. Los distribuidores definen sus propias condiciones de facturación con sus clientes.

La API de distribuidor es compatible con el sistema de pospago mensual de Google Workspace, que tiene varios planes de pago disponibles:

  • ANNUAL_MONTHLY_PAY: Compromiso anual con pagos mensuales
  • ANNUAL_YEARLY_PAY: Compromiso anual con un pago anual
  • FLEXIBLE: Plan sin compromiso con pagos mensuales
  • TRIAL: plan de prueba gratuita
    • La duración de la prueba puede variar hasta un máximo de 30 días.
    • Límite de envío diario de Gmail de 500 mensajes por usuario.
  • FREE: Plan gratuito solo para suscripciones a Cloud Identity Free Edition

Para obtener más información sobre estos planes, consulta Elige un plan de pagos para tus clientes.

Suscripción

Una suscripción administra la relación del plan de pagos de un cliente de Google con el SKU de un producto, las licencias de usuario, el estado de prueba gratuita de 30 días y las opciones de renovación. Una de las funciones principales de un distribuidor es administrar las suscripciones del cliente de Google.

En la API de distribuidor, una suscripción es un recurso de API principal. Define la configuración de un plan de pagos, licencias, prueba gratuita de 30 días, renovación y una orden de compra de un distribuidor. Un cliente puede tener más de una suscripción, una por cada SKU de producto que el distribuidor le asigne.

Cada suscripción tiene un identificador único, un subscriptionId. Debido a que una subscriptionId cambia cuando cambia la suscripción, no uses un valor subscriptionId como clave para los datos persistentes. Esta clave se interrumpirá si cambia la suscripción.

Para obtener más información, consulta Cómo administrar suscripciones.

Productos y SKU de productos

Un producto es una oferta comercial de un conjunto especializado de servicios de Google y funciones de aplicaciones. Un producto puede tener versiones personalizadas de términos, precios y otros detalles del acuerdo. Cada una de estas versiones de producto se identifica mediante un SKU de producto. En esta versión, la API de distribuidor ofrece una suscripción para cada SKU en los productos de Google Workspace, Google Vault y Google Drive. Para obtener más información, consulta Productos y SKU.