Создать или перенести подписку

После того, как вы закажете учетную запись клиента , вы сможете создать ряд различных подписок:

  • Годовая подписка
  • Гибкая подписка
  • 30-дневная бесплатная пробная версия
  • Подписка со скидкой

Дополнительную информацию о продуктах, используемых в этих подписках, см. в разделе Продукты и артикулы .

Если вы не заказывали аккаунт этого клиента, вы можете перенести подписку .

Клиенты с customerType = 'team' могут приобретать только версии Google Workspace Essentials и Enterprise Essentials. При попытке приобрести любую другую подписку Google Workspace возникает ошибка: Customer is not eligible to purchase this subscription . Клиенты, приобретающие Essentials или подписки с оплатой по фактическому использованию, могут не иметь возможности использовать планы с годовыми обязательствами и иметь ограниченные возможности повышения и понижения уровня.

Создать подписку

Чтобы создать подписку для новой учетной записи клиента, используйте следующий запрос POST HTTP и включите токен авторизации:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

CUSTOMER_ID — это либо основное доменное имя клиента, либо уникальный идентификатор клиента, возвращаемый при извлечении учетной записи перепроданного клиента .

Создайте годовой план обязательств

Для подписок с годовым обязательством не все SKU имеют одинаковые настройки продления по умолчанию. Мы рекомендуем всегда передавать renewalSettings . Создайте годовую подписку с обязательством на 10 рабочих мест:

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"
}

Заменить следующее:

  • CUSTOMER_ID : либо основное доменное имя клиента, либо уникальный идентификатор клиента.
  • SKU_ID : уникальный идентификатор единицы хранения (SKU). Подробнее см. в разделе «Продукты и идентификаторы SKU» .
  • PURCHASE_ORDER_ID : необязательный идентификатор заказа на покупку, который можно использовать для отслеживания использования.

Успешный ответ возвращает статус HTTP 200 и новые настройки подписки для годового плана. ANNUAL_MONTHLY_PAY возвращается как ANNUAL во всех ответах API.

Ниже приведен пример ответа на годовой план:

{
  "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"
}

Создайте гибкий план

Чтобы создать гибкую подписку для новой учетной записи клиента, используйте следующий запрос POST HTTP и включите токен авторизации:

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"
}

Заменить следующее:

  • CUSTOMER_ID : либо основное доменное имя клиента, либо уникальный идентификатор клиента.
  • SKU_ID : уникальный идентификатор единицы хранения (SKU). Подробнее см. в разделе «Продукты и идентификаторы SKU» .
  • PURCHASE_ORDER_ID : необязательный идентификатор заказа на покупку, который можно использовать для отслеживания использования.

Ниже приведен пример ответа по гибкому плану:

{
  "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"
}

Создать бесплатную пробную версию

Чтобы создать 30-дневную бесплатную пробную подписку для новой учетной записи клиента, используйте следующий запрос POST HTTP и включите токен авторизации:

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"
}

Заменить следующее:

  • CUSTOMER_ID : либо основное доменное имя клиента, либо уникальный идентификатор клиента.
  • SKU_ID : уникальный идентификатор единицы хранения (SKU). Подробнее см. в разделе «Продукты и идентификаторы SKU» .
  • PURCHASE_ORDER_ID : необязательный идентификатор заказа на покупку, который можно использовать для отслеживания использования.

Ниже приведен пример ответа на 30-дневный бесплатный пробный план:

{
  "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"
}

Создать скидочную подписку

Google может предоставлять код предложения для создания подписок со скидкой. Чтобы предоставить скидку на подписку, необходимо указать код предложения при вызове insert подписки. Если клиент меняет свой исходный артикул, скидка аннулируется.

Чтобы создать скидочную годовую подписку для новой учетной записи клиента, используйте следующий запрос POST HTTP и включите токен авторизации:

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"
}

Заменить следующее:

  • CUSTOMER_ID : либо основное доменное имя клиента, либо уникальный идентификатор клиента.
  • SKU_ID : уникальный идентификатор единицы хранения (SKU). Подробнее см. в разделе «Продукты и идентификаторы SKU» .
  • PURCHASE_ORDER_ID : необязательный идентификатор заказа на покупку, который можно использовать для отслеживания использования.
  • GOOGLE_CONTRACT_DEAL_CODE : Код скидки, доступный от Google.

Ниже приведен пример ответа по годовому плану скидок:

{
  "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"
}

Перенести подписку

Если вы не заказали учетную запись клиента с помощью операции заказа новой учетной записи клиента , используйте токен перевода клиента при создании подписки для этого клиента.

Чтобы создать подписку для учетной записи клиента, которую вы не заказывали, используйте следующий POST HTTP-запрос: 

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE

Заменить следующее:

  • CUSTOMER_ID : либо основное доменное имя клиента, либо уникальный идентификатор клиента.
  • TOKEN_VALUE : токен перевода, предоставленный вашим клиентом. После генерации токена клиентом он действителен в течение 30 дней.

Дополнительную информацию о том, как клиенты получают токен переноса, можно найти в справочном центре Google Workspace .

Чтобы перенести подписку клиента с годовым планом, используйте следующий запрос POST HTTP и включите токен авторизации: 

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"
}

Заменить следующее:

  • CUSTOMER_ID : либо основное доменное имя клиента, либо уникальный идентификатор клиента.
  • SKU_ID : уникальный идентификатор единицы хранения (SKU). Подробнее см. в разделе «Продукты и идентификаторы SKU» .
  • PURCHASE_ORDER_ID : необязательный идентификатор заказа на покупку, который можно использовать для отслеживания использования.

Успешный ответ возвращает код статуса HTTP 200 и переданные настройки подписки для годового плана: 

{
  "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"
}

Ограничения на передачу

При переносе подписки Google Workspace вместе с подпиской на Google Диск или Google Сейф используйте batch операцию для переноса всех подписок со статусом ACTIVE . Поочередный перенос каждой подписки приводит к ошибке.

Перенос приостановленных подписок разрешен только в том случае, если причиной приостановки является PENDING_TOS_ACCEPTANCE , TRIAL_ENDED или RENEWAL_WITH_TYPE_CANCEL .

При переносе устаревшего SKU метод subscriptions.list возвращает skuId SKU, который необходимо перенести. skuId , который фактически есть у клиента, возвращается как transferInfo.currentLegacySkuId . Полный список идентификаторов skuIds и продуктов, используемых этими планами, см. в разделе «Продукты и SKU» .

Переводы не работают с кодами скидок.