Después de pedir la cuenta de un cliente, puedes crear varias suscripciones diferentes:
- Una suscripción al compromiso anual
- Una suscripción flexible
- Prueba gratuita de 30 días
- Una suscripción con descuento
Para obtener más información sobre los productos que usan estas suscripciones, consulta Productos y SKU.
Si no pediste la cuenta de este cliente, puedes transferir una suscripción.
Los clientes que tengan customerType = 'team' solo pueden comprar las ediciones Essentials y Enterprise Essentials de Google Workspace. Si intentas comprar cualquiera de las otras suscripciones a Google Workspace, aparecerá el error Customer is not eligible to purchase this subscription. Es posible que los clientes que compren Essentials o suscripciones basadas en el uso no puedan administrar los planes de compromiso anual y tengan opciones limitadas de actualización y cambio a una versión inferior.
Crea una suscripción
Si quieres crear una suscripción para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST y, además, incluye el token de autorización:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
El CUSTOMER_ID es el nombre de dominio principal del cliente o el identificador único del cliente que se muestra cuando se recupera la cuenta de un cliente de reventa.
Crea un plan de compromiso anual
En el caso de las suscripciones a planes de compromiso anuales, no todos los SKU tienen la misma configuración de renovación predeterminada. Te recomendamos que siempre pases renewalSettings. Crea una suscripción de compromiso anual con 10 licencias:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
renewalSettings: {
"renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Reemplaza lo siguiente:
CUSTOMER_ID: Es el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de la unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta IDs de SKU y productos.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
Una respuesta correcta muestra un estado HTTP 200 y la configuración de la suscripción nueva para un plan de compromiso anual. ANNUAL_MONTHLY_PAY se muestra como ANNUAL en todas las respuestas de la API.
El siguiente es un ejemplo de respuesta a un plan anual:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Crear un plan flexible
Si quieres crear una suscripción flexible para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST y, además, incluye el token de autorización:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "FLEXIBLE"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Reemplaza lo siguiente:
CUSTOMER_ID: Es el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de la unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta IDs de SKU y productos.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
El siguiente es un ejemplo de una respuesta de plan flexible:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": false
},
"purchaseOrderId": "my_example_flex_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Crea una prueba gratuita
Para crear una suscripción de prueba gratuita de 30 días para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST y, además, incluye el token de autorización:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "TRIAL"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Reemplaza lo siguiente:
CUSTOMER_ID: Es el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de la unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta IDs de SKU y productos.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
El siguiente es un ejemplo de respuesta a un plan de prueba gratuito de 30 días:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "TRIAL",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": true,
"trialEndTime": "1331648420142"
},
"purchaseOrderId": "my_example_trial_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Crea una suscripción con descuento
Google puede proporcionar un código de oferta para crear suscripciones a una tarifa con descuento. Para descontar una suscripción, debes proporcionar el código de acuerdo en la llamada insert de la suscripción. Si el cliente cambia de su SKU original, se quita el descuento.
Si quieres crear una suscripción de compromiso anual con descuento para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST y, además, incluye el token de autorización:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
renewalSettings: {
"renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
},
"purchaseOrderId": "PURCHASE_ORDER_ID",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}
Reemplaza lo siguiente:
CUSTOMER_ID: Es el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de la unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta IDs de SKU y productos.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.GOOGLE_CONTRACT_DEAL_CODE: Es un código de descuento disponible de Google.
El siguiente es un ejemplo de respuesta a un plan anual con descuento:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
"skuName": "Google Workspace Business Standard"
}
Cómo transferir una suscripción
Si no realizaste el pedido de la cuenta del cliente con la operación Pedir una cuenta de cliente nueva, usa el token de transferencia del cliente cuando crees una suscripción para ese cliente.
Si quieres crear una suscripción para una cuenta de cliente que no pediste, usa la siguiente solicitud HTTP POST:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Reemplaza lo siguiente:
CUSTOMER_ID: Es el nombre de dominio principal del cliente o su identificador único.TOKEN_VALUE: Un token de transferencia que proporciona el cliente. Una vez que el cliente genera el token, tiene 30 días de validez.
Para obtener más información sobre cómo los clientes obtienen un token de transferencia, consulta el Centro de ayuda de Google Workspace.
Para transferir la suscripción de un cliente con un plan de compromiso anual, usa la siguiente solicitud HTTP POST y, además, incluye el token de autorización:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Reemplaza lo siguiente:
CUSTOMER_ID: Es el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de la unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta IDs de SKU y productos.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
Una respuesta correcta muestra un código de estado HTTP 200 y la configuración de la suscripción transferida para un plan de compromiso anual:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Admin console dashboard",
"skuName": "Google Workspace Business Standard"
}
Limitaciones de las transferencias
Si transfieres una suscripción a Google Workspace con una suscripción asociada a Google Drive o Google Vault, usa la operación batch para transferir todas las suscripciones con un estado ACTIVE. La transferencia de cada suscripción una por una genera un error.
Solo se permite la transferencia de suscripciones suspendidas si el motivo de la suspensión es PENDING_TOS_ACCEPTANCE, TRIAL_ENDED o RENEWAL_WITH_TYPE_CANCEL.
Cuando se transfiere un SKU heredado, subscriptions.list muestra una skuId del SKU que se debe transferir. El skuId del SKU que el cliente tiene en realidad se muestra como transferInfo.currentLegacySkuId. Para obtener una lista completa de skuIds y los productos que usan estos planes, consulta Productos y SKU.
Las transferencias no funcionan con códigos de oferta de descuento.