Después de pedir la cuenta de un cliente, puedes crear varias suscripciones diferentes:
- Suscripción de compromiso anual
- Una suscripción flexible
- Prueba gratuita de 30 días
- Suscripción con descuento
Para obtener más información sobre los productos que usan estas suscripciones, consulta Productos y SKU.
Si no solicitaste la cuenta de este cliente, puedes transferir una suscripción.
Los clientes con customerType = 'team' solo pueden comprar ediciones de Essentials y Enterprise Essentials de Google Workspace. Si intentas comprar cualquiera de las otras suscripciones a Google Workspace, verás 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 manejar los planes de compromiso anuales y tengan opciones limitadas de cambio a una versión inferior o de actualización.
Cree una suscripción
A fin de crear una suscripción para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST y agrega 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
Para las suscripciones de planes de compromiso anuales, no todos los SKU tienen la misma configuración de renovación predeterminada. Te recomendamos que siempre pases renewalSettings. Crear 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: Puede ser el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta ID 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 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"
}
Cree un plan flexible
A fin de 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: Puede ser el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta ID 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 al 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
A fin de 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, también, 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: Puede ser el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta ID 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 del 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 de descuento
Es posible que Google proporcione un código de acuerdo para crear suscripciones con descuento. Para descontar una suscripción, debes proporcionar el código del acuerdo en la llamada de suscripción insert. Si el cliente cambia de su SKU original, se quitará el descuento.
A fin de 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, también, 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: Puede ser el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta ID 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 del 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"
}
Transferir una suscripción
Si no solicitaste la cuenta del cliente mediante la operación order a new customer account, usa el token de transferencia del cliente cuando crees una suscripción.
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: Puede ser el nombre de dominio principal del cliente o su identificador único.TOKEN_VALUE: Un token de transferencia proporcionado por tu cliente. Una vez que el cliente genera el token, este tiene una validez de 14 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 del plan de compromiso anual, usa la siguiente solicitud HTTP POST y agrega 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: Puede ser el nombre de dominio principal del cliente o su identificador único.SKU_ID: Es el identificador único de unidad de mantenimiento de inventario (SKU). Para obtener más información, consulta ID 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 de Google Drive o Google Vault asociada, usa la operación batch para transferir todas las suscripciones con un estado ACTIVE. Si se transfiere una suscripción de a una, se producirá 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 tiene el cliente en realidad se muestra como transferInfo.currentLegacySkuId. Para obtener una lista completa de skuIds y qué productos usan estos planes, consulta Productos y SKU.
Las transferencias no funcionan con códigos de acuerdos con descuento.