Después de pedir 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 SKU.
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 alguna de las otras suscripciones de Google Workspace, recibirás el error Customer is not eligible to purchase this subscription. Es posible que los clientes que compren suscripciones de Essentials o basadas en el uso no puedan manejar los planes de compromiso anual y tengan opciones limitadas para cambiar a una versión superior o inferior.
Crea una suscripción
Para crear una suscripción para la cuenta de un cliente recién creado, 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
El valor de CUSTOMER_ID puede ser el nombre de dominio principal del cliente o el identificador único del cliente que se devuelve cuando se recupera la cuenta de un cliente revendido.
Crea un plan de compromiso anual
En el caso de las suscripciones con planes de compromiso anual, 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 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: 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 Productos y IDs de SKU.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
Una respuesta correcta devuelve un estado HTTP 200 y la configuración de la nueva suscripción para un plan de compromiso anual. ANNUAL_MONTHLY_PAY se muestra como ANNUAL en todas las respuestas de la API.
A continuación, se muestra 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"
}
Crea un plan flexible
Para crear una suscripción flexible para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST e 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 Productos y IDs de SKU.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
A continuación, se muestra 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 agrega 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 Productos y IDs de SKU.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
A continuación, se muestra un ejemplo de una respuesta del 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 una tarifa con descuento. Para aplicar un descuento a una suscripción, debes proporcionar el código de oferta en la llamada a insert de la suscripción. Si el cliente cambia de SKU original, se quitará el descuento.
Para crear una suscripción con compromiso anual con descuento para la cuenta de un cliente recién creado, usa la siguiente solicitud HTTP POST e 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 Productos y IDs de 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.
A continuación, se muestra 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"
}
Transfiere 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: Es 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 durante 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 con un plan de compromiso anual, usa la siguiente solicitud HTTP POST e 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 Productos y IDs de SKU.PURCHASE_ORDER_ID: Es un ID de orden de compra opcional que puedes usar para hacer un seguimiento del uso.
Una respuesta correcta devuelve 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 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 el estado ACTIVE. Si transfieres cada suscripción de a una, se generará un error.
Solo se permiten las transferencias 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 devuelve un skuId del SKU que se debe transferir. El skuIddel SKU que el cliente realmente tiene se muestra como transferInfo.currentLegacySkuId. Para obtener una lista completa de los skuIds y los productos que usan estos planes, consulta Productos y SKU.
Las transferencias no funcionan con los códigos de ofertas con descuento.