Po zamówieniu konta klienta możesz utworzyć kilka różnych subskrypcji:
- subskrypcja roczna,
- subskrypcja elastyczna.
- 30-dniowy bezpłatny okres próbny
- subskrypcja z rabatem,
Więcej informacji o usługach, których dotyczą te subskrypcje, znajdziesz w artykule Produkty i identyfikatory SKU.
Jeśli nie zamówiłeś(-aś) konta tego klienta, możesz przenieść subskrypcję.
Klienci z customerType = 'team' mogą kupować tylko wersje Essentials i Enterprise Essentials Google Workspace. Jeśli spróbujesz kupić inną subskrypcję Google Workspace, pojawi się błąd Customer is not eligible to purchase this subscription. Klienci kupujący subskrypcje Essentials lub subskrypcje oparte na wykorzystaniu mogą nie mieć dostępu do planów z roczną umową i mieć ograniczone opcje uaktualniania i obniżania subskrypcji.
Tworzenie subskrypcji
Aby utworzyć subskrypcję na nowo utworzonym koncie klienta, wyślij to POSTżądanie HTTP, dołączając token autoryzacji:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
Wartość CUSTOMER_ID to albo nazwa domeny podstawowej klienta, albo jego unikalny identyfikator zwracany podczas pobierania konta klienta sprzedanego.
Tworzenie planu rocznego
W przypadku abonamentów z rocznym zobowiązaniem nie wszystkie kody SKU mają takie same domyślne ustawienia odnowienia. Zalecamy zawsze przekazywanie argumentu renewalSettings. Utwórz subskrypcję roczną z 10 miejscami:
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 Usługi i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, który możesz wykorzystać do śledzenia wykorzystania.
Pomyślna odpowiedź zwraca stan HTTP 200 oraz ustawienia nowej subskrypcji w przypadku rocznego zobowiązania. Wartość ANNUAL_MONTHLY_PAY jest zwracana jako ANNUAL we wszystkich odpowiedziach interfejsu API.
Oto przykład odpowiedzi na pakiet 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ć elastyczny abonament dla nowo utworzonego konta klienta, wyślij to POSTżądanie HTTP 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 Usługi i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, który możesz wykorzystać do śledzenia wykorzystania.
Oto przykład odpowiedzi dotyczącej planu elastycznego:
{
"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 wersji próbnej
Aby utworzyć 30-dniowy bezpłatny okres próbny na nowo utworzonym koncie klienta, użyj tego żądania HTTP POST i uwzględnij 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 Usługi i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, który możesz wykorzystać 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"
}
Tworzenie subskrypcji z rabatem
Google może udostępnić kod rabatowy na tworzenie subskrypcji po obniżonej cenie. Aby zastosować rabat na subskrypcję, musisz podać kod zniżkowy w wywołaniu subskrypcji insert. Jeśli klient zmieni pierwotny kod SKU, rabat zostanie usunięty.
Aby utworzyć roczny abonament 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 Usługi i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, który możesz wykorzystać do śledzenia wykorzystania.GOOGLE_CONTRACT_DEAL_CODE: kod zniżkowy dostępny w Google.
Oto przykład odpowiedzi na roczny plan z rabatem:
{
"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 nie zamówisz konta klienta za pomocą operacji zamawiania nowego konta klienta, podczas tworzenia subskrypcji dla tego klienta użyj tokena przeniesienia klienta.
Aby utworzyć subskrypcję na koncie klienta, którego nie zamówiłeś/nie zamówiłaś, użyj tego POSTżądania HTTP:
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 dostarczony przez klienta. Token wygenerowany przez klienta jest ważny przez 30 dni.
Więcej informacji o tym, jak klienci mogą uzyskać token przeniesienia, znajdziesz w Centrum pomocy Google Workspace.
Aby przenieść subskrypcję klienta korzystającego z rocznego abonamentu, użyj tego POSTżądania HTTP 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 Usługi i identyfikatory SKU.PURCHASE_ORDER_ID: opcjonalny identyfikator zamówienia, który możesz wykorzystać do śledzenia wykorzystania.
Pomyślna odpowiedź zwraca kod stanu HTTP 200 oraz ustawienia przenoszonej subskrypcji w ramach rocznego abonamentu:
{
"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 dotyczące przenoszenia
Jeśli przenosisz abonament Google Workspace z powiązanym Dyskiem Google lub abonamentem Google Vault, użyj operacji batch, aby przenieść wszystkie abonamenty o stanie ACTIVE. Przenoszenie każdej subskrypcji osobno powoduje błąd.
Przeniesienie zawieszonych subskrypcji jest możliwe tylko wtedy, gdy przyczyną zawieszenia jest PENDING_TOS_ACCEPTANCE, TRIAL_ENDED lub RENEWAL_WITH_TYPE_CANCEL.
Podczas przenoszenia starszego kodu SKU funkcja subscriptions.list zwraca kod skuIdkodu SKU, który należy przenieść. Wartość skuIdelementu SKU, który ma klient, jest zwracana jako transferInfo.currentLegacySkuId. Pełną listę skuIds oraz usług, w których są używane te plany, znajdziesz w sekcji Usługi i kody SKU.
Transfery nie działają z kodami zniżkowymi.