После оформления учетной записи клиента вы можете создать несколько различных подписок:
- Годовая подписка с обязательством
- Гибкая подписка
- 30-дневная бесплатная пробная версия
- Подписка со скидкой
Для получения более подробной информации о продуктах, используемых в рамках этих подписок, см. раздел «Продукты и артикулы» .
Если вы не оформляли учетную запись этого клиента, вы можете перенести подписку .
Клиенты с customerType = 'team' могут приобретать только версии Google Workspace Essentials и Enterprise Essentials. При попытке приобрести любую другую подписку Google Workspace вы получите ошибку Customer is not eligible to purchase this subscription ». Клиенты, приобретающие подписки Essentials или подписки с оплатой по факту использования, могут не иметь возможности использовать планы с годовым обязательством и иметь ограниченные возможности по обновлению и понижению версии подписки.
Создать подписку
Для создания подписки для новой учетной записи клиента используйте следующий HTTP-запрос POST и укажите токен авторизации:
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 и настройки новой подписки для годового плана. Во всех ответах API возвращается ANNUAL_MONTHLY_PAY со значением ANNUAL .
Ниже приведён пример ответа на запрос о составлении годового плана:
{
"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"
}
Создайте гибкий план.
Для создания гибкой подписки для новой учетной записи клиента используйте следующий HTTP-запрос POST и укажите токен авторизации:
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-дневной бесплатной пробной подписки для новой учетной записи клиента используйте следующий HTTP-запрос POST и укажите токен авторизации:
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 подписки. Если клиент меняет свой первоначальный SKU, скидка отменяется.
Для создания подписки со скидкой на годовой абонемент для нового клиента используйте следующий HTTP-запрос POST и укажите токен авторизации:
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"
}
Перенос подписки
Если вы не создавали учетную запись клиента с помощью операции «Создать новую учетную запись клиента» , используйте токен перевода клиента при создании подписки для этого клиента.
Чтобы создать подписку для учетной записи клиента, которую вы не оформляли, используйте следующий HTTP-запрос POST :
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Замените следующее:
-
CUSTOMER_ID: либо основное доменное имя клиента, либо уникальный идентификатор клиента. -
TOKEN_VALUE: Токен перевода, предоставленный вашим клиентом. После генерации клиентом токен действителен в течение 30 дней.
Для получения более подробной информации о том, как клиенты получают токен для перевода средств, см. справочный центр Google Workspace .
Для переноса подписки клиента с годовым тарифным планом используйте следующий HTTP-запрос POST и укажите токен авторизации:
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 Drive или Google Vault, используйте batch операцию для переноса всех подписок со статусом ACTIVE . Перенос каждой подписки по отдельности приведет к ошибке.
Перенос приостановленных подписок разрешен только в том случае, если причиной приостановления является PENDING_TOS_ACCEPTANCE , TRIAL_ENDED или RENEWAL_WITH_TYPE_CANCEL .
При переносе устаревшего SKU subscriptions.list возвращает skuId SKU, который необходимо перенести. skuId SKU, фактически имеющегося у клиента, возвращается в виде transferInfo.currentLegacySkuId . Полный список skuIds и продуктов, используемых этими тарифными планами, см. в разделе «Продукты и SKU» .
Переводы средств не работают с промокодами на скидку.