Después de ordenar la cuenta de un cliente, puedes crear varias suscripciones diferentes:
- Una suscripción con compromiso anual
- Una suscripción flexible
- Una 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 SKUs.
Si no pediste la cuenta de este cliente, puedes transferir una suscripción.
Los clientes con 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, recibirás el error Customer is not eligible to purchase this subscription. Es posible que los clientes que compren suscripciones a Essentials o 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
Para crear una suscripción para la cuenta de un cliente recién creada, usa la siguiente solicitud HTTP POST y, luego, incluye el token de autorización:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID es el nombre de dominio principal del cliente o el identificador único que se muestra cuando se recupera la cuenta de un cliente revendido.
Crea un plan de compromiso anual
En el caso de las suscripciones a planes de compromiso anual, no todos los SKUs tienen la misma configuración de renovación predeterminada. Te recomendamos que siempre pases renewalSettings. Crea una suscripción de compromiso anual con 10 asientos:
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: 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 productos y SKU.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 una respuesta de 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"
}
Crea un plan flexible
Para crear una suscripción flexible para la cuenta de un cliente recién creada, usa la siguiente solicitud HTTP POST y, luego, 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: 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 productos y SKU.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 que se creó recientemente, usa la siguiente solicitud HTTP POST y, luego, 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: 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 productos y SKU.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 un plan de prueba gratuita 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
Es posible que Google proporcione un código de oferta para crear suscripciones a un precio con descuento. Para aplicar un descuento a una suscripción, debes proporcionar el código de oferta en la llamada insert de la suscripción. Si el cliente cambia de su SKU original, se quita el descuento.
Para crear una suscripción de compromiso anual con descuento para la cuenta de un cliente que se acaba de crear, usa la siguiente solicitud HTTP POST y, luego, 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: 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 productos y SKU.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 en Google.
El siguiente es un ejemplo de una respuesta de 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 pediste la cuenta del cliente con la operación order a new customer account, usa el token de transferencia del cliente cuando crees una suscripción para él.
Para 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: El nombre de dominio principal del cliente o su identificador único.TOKEN_VALUE: Es un token de transferencia que proporciona tu cliente. Después de que el cliente genera el token, este es válido por 30 días.
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 de un plan de compromiso anual, usa la siguiente solicitud HTTP POST y, luego, 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: 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 productos y SKU.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 transferencia
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. Transferir cada suscripción de forma individual genera un error.
La transferencia de suscripciones suspendidas solo se permite 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 un 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 ofertas de descuento.