Po zamówieniu konta klienta możesz utworzyć różne subskrypcje:
- Subskrypcja z rocznym zobowiązaniem
- Elastyczna subskrypcja
- Bezpłatny 30-dniowy okres próbny
- Subskrypcja z rabatem
Więcej informacji o usługach używanych w tych subskrypcjach znajdziesz w artykule Produkty i kody SKU.
Jeśli konto tego klienta nie zostało zamówione przez Ciebie, możesz przenieść subskrypcję.
Klienci korzystający z customerType = 'team' mogą kupić Google Workspace tylko w wersji Essentials i Enterprise Essentials. Jeśli spróbujesz kupić którąkolwiek z pozostałych subskrypcji Google Workspace, pojawi się błąd Customer is not eligible to purchase this subscription. Klienci kupujący korzystający z Essentials lub subskrypcji opartych na wykorzystaniu mogą nie być w stanie obsługiwać abonamentów rocznych i mają ograniczone opcje przejścia na wyższą lub niższą wersję usługi.
Tworzenie subskrypcji
Aby utworzyć subskrypcję dla nowo utworzonego konta klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID to nazwa domeny podstawowej klienta lub jego unikalny identyfikator zwracany podczas pobierania konta klienta sprzedawcy.
Tworzenie abonamentu z rocznym zobowiązaniem
W przypadku abonamentów z rocznym zobowiązaniem nie wszystkie kody SKU mają takie same domyślne ustawienia odnawiania. Zalecamy, aby zawsze przekazywać renewalSettings. Utwórz 10-osobową subskrypcję z rocznym zobowiązaniem:
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"
}
Zastąp następujące elementy:
CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Produkty i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.
Pomyślna odpowiedź zwraca stan HTTP 200 i ustawienia nowej subskrypcji dla abonamentu z rocznym zobowiązaniem. Wartość ANNUAL_MONTHLY_PAY jest zwracana jako ANNUAL we wszystkich odpowiedziach interfejsu API.
Oto przykład odpowiedzi na abonament roczny:
{
"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"
}
Tworzenie planu elastycznego
Aby utworzyć subskrypcję elastyczną dla nowo utworzonego konta klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:
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"
}
Zastąp następujące elementy:
CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Produkty i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.
Oto przykład odpowiedzi na abonament elastyczny:
{
"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"
}
Tworzenie bezpłatnej wersji próbnej
Aby utworzyć 30-dniową bezpłatną subskrypcję próbną dla nowo utworzonego konta klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:
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"
}
Zastąp następujące elementy:
CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Produkty i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.
Oto przykład odpowiedzi na 30-dniowy bezpłatny okres próbny:
{
"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"
}
Utwórz subskrypcję z rabatem
Google może udostępnić kod zniżkowy umożliwiający tworzenie subskrypcji po obniżonej cenie. Aby obniżyć rabat na subskrypcję, musisz podać kod zniżkowy w wywołaniu funkcji insert subskrypcji. Jeśli klient zmieni kod SKU, rabat zostanie usunięty.
Aby utworzyć subskrypcję z rabatem na nowo utworzone konto klienta, użyj tego żądania HTTP POST i dołącz token autoryzacji:
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"
}
Zastąp następujące elementy:
CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Produkty i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.GOOGLE_CONTRACT_DEAL_CODE: kod zniżkowy dostępny od Google.
Oto przykład odpowiedzi na pytanie o zniżkę na abonament roczny:
{
"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"
}
Przenoszenie subskrypcji
Jeśli konto klienta nie zostało zamówione za pomocą operacji Zamów nowe konto klienta, podczas tworzenia subskrypcji dla tego klienta użyj tokena przeniesienia klienta.
Aby utworzyć subskrypcję dla konta klienta, które nie zostało przez Ciebie zamówione, skorzystaj z tego żądania HTTP POST:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Zastąp następujące elementy:
CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.TOKEN_VALUE: token przeniesienia udostępniony przez klienta. Token jest ważny przez 30 dni od momentu wygenerowania przez klienta.
Więcej informacji o tym, jak klienci otrzymują token przeniesienia, znajdziesz w Centrum pomocy Google Workspace.
Aby przenieść subskrypcję klienta korzystającego z abonamentu z rocznym zobowiązaniem, użyj tego żądania HTTP POST i dołącz token autoryzacji:
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"
}
Zastąp następujące elementy:
CUSTOMER_ID: nazwa domeny podstawowej klienta lub jego unikalny identyfikator.SKU_ID: unikalny identyfikator jednostki magazynowej (SKU). Więcej informacji znajdziesz w artykule Produkty i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, którego możesz używać do śledzenia wykorzystania.
Pomyślna odpowiedź zwraca kod stanu HTTP 200 i ustawienia przeniesionej subskrypcji dla abonamentu z rocznym zobowiązaniem:
{
"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"
}
Ograniczenia transferu
Jeśli przenosisz subskrypcję Google Workspace z powiązaną subskrypcją Dysku Google lub Google Vault, użyj operacji batch, aby przenieść wszystkie subskrypcje ze stanem ACTIVE. Przenoszenie subskrypcji pojedynczo kończy się błędem.
Przenoszenie zawieszonych subskrypcji jest możliwe tylko wtedy, gdy powód zawieszenia to PENDING_TOS_ACCEPTANCE, TRIAL_ENDED lub RENEWAL_WITH_TYPE_CANCEL.
Podczas przenoszenia starszego kodu SKU subscriptions.list zwraca skuId kodu SKU, który należy przenieść. skuIdKod SKU zwrócony przez klienta jest zwracany jako transferInfo.currentLegacySkuId. Pełną listę skuIds oraz usług używanych w ramach tych abonamentów znajdziesz w artykule Usługi i kody SKU.
Przenoszenie nie działa w przypadku kodów zniżkowych.