После оформления учетной записи клиента вы можете создать несколько различных подписок:
- Годовая подписка с обязательством
- Гибкая подписка
- 30-дневная бесплатная пробная версия
- Подписка со скидкой
Для получения более подробной информации о продуктах, используемых в рамках этих подписок, см. раздел «Продукты и артикулы» .
Если вы не оформляли учетную запись клиента, вы можете перенести подписку .
Клиенты с customerType = 'team' могут приобрести только версии Google Workspace Essentials и Google Workspace 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 might provide a deal code for creating subscriptions at a discounted rate. To discount a subscription, you must provide the deal code in the subscription insert call. If the customer changes their original SKU, the discount is removed.
Для создания подписки со скидкой на годовой абонемент для нового клиента используйте следующий 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 дней.
Для получения более подробной информации о том, как клиенты получают токен для перевода средств, см. Центр поддержки администраторов .
Для переноса подписки клиента с годовым тарифным планом используйте следующий 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, который необходимо перенести. В качестве параметра transferInfo.currentLegacySkuId возвращается skuId SKU, который фактически есть у клиента. Полный список skuIds и продуктов, используемых в этих тарифных планах, см. в разделе «Продукты и SKU» .
Переводы средств не работают с промокодами на скидку.