Se usó la API de Cloud Translation para traducir esta página.

Cómo crear o transferir una suscripción

Después de hacer un pedido a la cuenta de un cliente puedes crear varias suscripciones diferentes:

Una suscripción de 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 pidió la cuenta de este cliente, puede transferir una suscripción.

Los clientes con customerType = 'team' solo pueden comprar Essentials y Ediciones Enterprise Essentials de Google Workspace. Si intentas comprar para cualquiera de las otras suscripciones a Google Workspace, error: Customer is not eligible to purchase this subscription. Clientes es posible que no puedas manejar la compra de suscripciones basadas en el uso o de Essentials Los planes de compromiso anual tienen opciones limitadas de actualización y cambio a una versión inferior.

Crea una suscripción

Si deseas 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 devuelve cuando recuperar la cuenta de un cliente de reventa

Crea un plan de compromiso anual

Para las suscripciones al plan de compromiso anual, no todos los SKU tienen el mismo con la 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 dominio principal del cliente. nombre o el identificador único del cliente.
SKU_ID: Es la unidad de mantenimiento de inventario (SKU). identificador. Para obtener más información, consulta Productos y IDs de SKU.
PURCHASE_ORDER_ID: Una orden de compra opcional ID que puedes usar para hacer un seguimiento del uso.

Una respuesta correcta muestra un estado HTTP 200 y el nombre de la suscripción nueva de seguridad para un plan de compromiso anual. ANNUAL_MONTHLY_PAY se devuelve 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 creado, utiliza la siguiente solicitud HTTP POST con 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 dominio principal del cliente. nombre o el identificador único del cliente.
SKU_ID: Es la unidad de mantenimiento de inventario (SKU). identificador. Para obtener más información, consulta Productos y IDs de SKU.
PURCHASE_ORDER_ID: Una orden de compra opcional ID 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"
}

Crear una prueba gratuita

Para crear una suscripción de prueba gratuita de 30 días para la cuenta de un cliente usa la siguiente solicitud HTTP POST e incluye la autorización token:

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 dominio principal del cliente. nombre o el identificador único del cliente.
SKU_ID: Es la unidad de mantenimiento de inventario (SKU). identificador. Para obtener más información, consulta Productos y IDs de SKU.
PURCHASE_ORDER_ID: Una orden de compra opcional ID 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. tasa. Para descontar una suscripción, debes proporcionar el código de oferta en a la llamada de suscripción insert. Si el cliente cambia de su SKU original, se quitará el descuento.

Para crear una suscripción de compromiso anual con descuento para una cuenta recién creada cuenta del cliente, 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: Es el dominio principal del cliente. nombre o el identificador único del cliente.
SKU_ID: Es la unidad de mantenimiento de inventario (SKU). identificador. Para obtener más información, consulta Productos y IDs de SKU.
PURCHASE_ORDER_ID: Una orden de compra opcional ID que puedes usar para hacer un seguimiento del uso.
GOOGLE_CONTRACT_DEAL_CODE: Un código de descuento disponible de 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"
}

Transfiere una suscripción

Si no pediste la cuenta del cliente a través de la hacer un pedido de una cuenta nueva para clientes operación, usa el token de transferencia del cliente cuando crees una suscripción para con ese cliente.

Si deseas crear una suscripción para una cuenta de cliente que no pediste, utiliza 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 dominio principal del cliente. nombre o el identificador único del cliente.
TOKEN_VALUE: Es un token de transferencia proporcionado por tu cliente. Una vez 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 la Centro de ayuda de Google Workspace.

Para transferir la suscripción de un cliente de un plan de compromiso anual, usa el 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 dominio principal del cliente. nombre o el identificador único del cliente.
SKU_ID: Es la unidad de mantenimiento de inventario (SKU). identificador. Para obtener más información, consulta Productos y IDs de SKU.
PURCHASE_ORDER_ID: Una orden de compra opcional ID que puedes usar para hacer un seguimiento del uso.

Una respuesta correcta devuelve un estado HTTP 200 código y la configuración de la suscripción transferida de 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 un dispositivo Google Drive asociado o Google Vault, usa el Operación batch para transferir todas las suscripciones con el estado ACTIVE. Transfiriendo cada una suscripción una por una generará 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 debe transferirse. El skuId del SKU El cliente se muestra como transferInfo.currentLegacySkuId. Para un lista completa de skuIds y qué productos usan estos planes, consulta Productos y SKU.

Las transferencias no funcionan con códigos de acuerdo de descuento.