После заказа учетной записи клиента вы можете создать несколько различных подписок:
- Годовая обязательная подписка
- Гибкая подписка
- 30-дневная бесплатная пробная версия
- Подписка со скидкой
Дополнительные сведения о продуктах, используемых в этих подписках, см. в разделе Продукты и SKU .
Если вы не заказывали аккаунт этого клиента, вы можете передать подписку .
Клиенты с 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 и настройки новой подписки для годового плана обязательств. 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"
}
Создайте гибкий план
Чтобы создать гибкую подписку для вновь созданной учетной записи клиента, используйте следующий 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 подписки. Если клиент меняет исходный артикул, скидка аннулируется.
Чтобы создать годовую подписку со скидкой для вновь созданной учетной записи клиента, используйте следующий 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 Диск или Google Сейф используйте batch операцию для переноса всех подписок со статусом ACTIVE . Передача каждой подписки по одной приводит к ошибке.
Перенос приостановленных подписок разрешен только в том случае, если причиной приостановки является PENDING_TOS_ACCEPTANCE , TRIAL_ENDED или RENEWAL_WITH_TYPE_CANCEL .
При переносе устаревшего SKU subscriptions.list возвращает skuId SKU, который необходимо перенести. skuId SKU, который фактически имеется у клиента, возвращается как transferInfo.currentLegacySkuId . Полный список skuIds и продуктов, используемых в этих планах, см. в разделе «Продукты и SKU» .
Переводы не работают с кодами скидочных сделок.