Recurso: Suscripción
Plantilla JSON para una suscripción.
Representación JSON |
---|
{ "customerId": string, "subscriptionId": string, "skuId": string, "creationTime": string, "kind": string, "seats": { object ( |
Campos | |
---|---|
customerId |
Esta propiedad siempre se mostrará en una respuesta como el identificador único generado por Google. En una solicitud, esta propiedad puede ser el dominio principal o el identificador único generado por Google. |
subscriptionId |
El |
skuId |
Una propiedad obligatoria El |
creationTime |
La propiedad |
kind |
Identifica el recurso como una suscripción. Valor: |
seats |
Esta es una propiedad obligatoria. La cantidad y el límite de licencias de licencias de los usuarios en el plan. |
renewalSettings |
Configuración de renovación del plan de compromiso anual. Para obtener información más detallada, consulte las opciones de renovación en el Centro de ayuda para administradores. |
purchaseOrderId |
Esta es una propiedad opcional. La información de esta orden de compra (PO) es para que los distribuidores la utilicen en el seguimiento del uso de la empresa. Si se proporciona un valor |
status |
Esta es una propiedad opcional. |
resourceUiUrl |
URL de la página de suscripciones del cliente en la Consola del administrador El servicio de API genera la URL de solo lectura. Esta opción se utiliza si su aplicación cliente requiere que el cliente complete una tarea mediante la página Suscripciones de la Consola del administrador. |
billingMethod |
Campo de solo lectura que muestra el método de facturación actual para una suscripción. |
suspensionReasons[] |
Campo de solo lectura que contiene una enumeración de todos los motivos de suspensión actuales de una suscripción. Es posible que una suscripción tenga muchos motivos de suspensión superpuestos. El valor de
|
customerDomain |
Nombre del dominio principal del cliente |
dealCode |
Código de Google (100 caracteres como máximo) para los precios con descuento de los planes de suscripción. El código de oferta debe incluirse en las solicitudes de |
skuName |
Nombre comercial externo de solo lectura para el SKU de un producto asignado a un cliente en la suscripción. Los nombres de SKU están sujetos a cambios a discreción de Google. Para obtener información sobre los productos y los SKU disponibles en esta versión de la API, consulta ID de productos y SKU. |
plan |
La propiedad |
plan.planName |
La propiedad
|
plan.isCommitmentPlan |
El valor booleano de la propiedad
|
plan.commitmentInterval |
En esta versión de la API, el intervalo del plan de compromiso anual es de un año. |
plan.commitmentInterval.startTime |
Un intervalo de compromiso anual: el intervalo de un año en |
plan.commitmentInterval.endTime |
Intervalo de un plan de compromiso anual en |
trialSettings |
El compromiso anual de G Suite y los planes de pago flexibles pueden estar disponibles en una prueba gratuita de 30 días. Para obtener más información, consulta los conceptos de la API. |
trialSettings.isInTrial |
Determina si un plan de suscripción se encuentra en una prueba gratuita de 30 días:
|
trialSettings.trialEndTime |
Fecha en la que finaliza la prueba. El valor está en milisegundos con el formato de época de UNIX. Consulta un ejemplo de conversor de época. |
transferInfo |
Información relacionada con la transferencia de solo lectura para la suscripción. Para obtener más información, consulta Cómo recuperar suscripciones transferibles de un cliente. |
transferInfo.transferabilityExpirationTime |
La hora a la que vencerá el token de transferencia o el intent de transferencia. La hora se expresa en milisegundos con el formato de época UNIX. |
transferInfo.minimumTransferableSeats |
Cuando inserte una suscripción, esta es la cantidad mínima de licencias que aparecen en el pedido de transferencia de este producto. Por ejemplo, si el cliente tiene 20 usuarios, el distribuidor no puede realizar un pedido de transferencia de 15 licencias. La cantidad mínima es de 20 licencias. |
transferInfo.currentLegacySkuId |
Es el |
Licencias
Plantilla JSON para las licencias suscritas.
Representación JSON |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
Campos | |
---|---|
numberOfSeats |
Esta es una propiedad obligatoria y es exclusiva de suscripciones con planes |
maximumNumberOfSeats |
Esta es una propiedad obligatoria y es exclusiva de suscripciones con planes de |
licensedNumberOfSeats |
Campo de solo lectura que contiene la cantidad actual de usuarios a los que se les asignó una licencia para el producto definido en |
kind |
Identifica el recurso como una configuración de licencia de suscripción. Valor: |
RenewalSettings
Plantilla JSON para la configuración de renovación de una suscripción.
Representación JSON |
---|
{ "renewalType": string, "kind": string } |
Campos | |
---|---|
renewalType |
Configuración de renovación del plan de compromiso anual. Para obtener información más detallada, consulte las opciones de renovación en el Centro de ayuda para administradores. Cuando renuevas una suscripción, |
kind |
Identifica el recurso como una configuración de renovación de suscripción. Valor: |
Métodos |
|
---|---|
|
Activa una suscripción que el distribuidor había suspendido anteriormente. |
|
Actualiza un plan de suscripción. |
|
Actualiza la configuración de renovación de la licencia de un usuario. |
|
Actualiza la configuración de licencias de usuario de una suscripción. |
|
Cancela, suspende o transfiere una suscripción para dirigir. |
|
Obtiene una suscripción específica. |
|
Crea o transfiere una suscripción. |
|
Listas de suscripciones administradas por el distribuidor. |
|
Transfiere de inmediato una suscripción de prueba gratuita de 30 días a una suscripción de servicio pagado. |
|
Suspende una suscripción activa. |