Nachdem du das Konto eines Kunden bestellt hast, kannst du verschiedene Abos erstellen:
- Jahresabo
- Ein flexibles Abo
- 30 Tage kostenlos testen
- Ein vergünstigtes Abo
Weitere Informationen zu den Produkten, die von diesen Abos verwendet werden, findest du unter Produkte und SKUs.
Wenn Sie das Konto dieses Kunden nicht bestellt haben, können Sie ein Abo übertragen.
Kunden mit customerType = 'team'
können nur Essentials- und Enterprise Essentials-Versionen von Google Workspace erwerben. Wenn Sie versuchen, eines der anderen Google Workspace-Abos zu kaufen, wird der Fehler Customer is not eligible to purchase this subscription
angezeigt. Kunden, die Essentials oder nutzungsbasierte Abos erwerben, können möglicherweise keine Jahrestarife mit jährlicher Zusicherung ausführen und haben eingeschränkte Upgrade- und Downgradeoptionen.
Abo erstellen
Verwenden Sie die folgende POST
-HTTP-Anfrage und fügen Sie das Autorisierungstoken hinzu, um ein Abo für ein neu erstelltes Kundenkonto zu erstellen:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
Die CUSTOMER_ID
ist entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden, die beim Abrufen des Kontos eines Kunden eines Resellers zurückgegeben wird.
Jahrestarif erstellen
Bei Abos mit Jahrestarif haben nicht alle SKUs dieselben Standardeinstellungen für die Verlängerung. Wir empfehlen, immer renewalSettings
zu übergeben. Erstellen Sie ein Jahresabo mit 10 Lizenzen:
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" }
Ersetzen Sie Folgendes:
CUSTOMER_ID
: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID
: Die eindeutige Artikelnummer (SKU) Weitere Informationen findest du unter Produkte und SKU-IDs.PURCHASE_ORDER_ID
: Eine optionale Auftrags-ID, mit der Sie die Nutzung verfolgen können.
Bei einer erfolgreichen Antwort werden der HTTP-Status 200
und die Einstellungen des neuen Abos für einen Jahrestarif zurückgegeben. ANNUAL_MONTHLY_PAY
wird in allen API-Antworten als ANNUAL
zurückgegeben.
Im Folgenden finden Sie ein Beispiel für eine Antwort auf einen Jahrestarif:
{
"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"
}
Flexiblen Tarif erstellen
Verwenden Sie die folgende POST
-HTTP-Anfrage und fügen Sie das Autorisierungstoken hinzu, um ein flexibles Abo für ein neu erstelltes Kundenkonto zu erstellen:
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" }
Ersetzen Sie Folgendes:
CUSTOMER_ID
: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID
: Die eindeutige Artikelnummer (SKU) Weitere Informationen findest du unter Produkte und SKU-IDs.PURCHASE_ORDER_ID
: Eine optionale Auftrags-ID, mit der Sie die Nutzung verfolgen können.
Das folgende Beispiel zeigt eine Antwort für einen flexiblen Tarif:
{
"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"
}
Kostenlosen Testzeitraum erstellen
Wenn Sie ein kostenloses 30-tägiges Probeabo für ein neu erstelltes Kundenkonto erstellen möchten, verwenden Sie die folgende POST
-HTTP-Anfrage und fügen Sie das Autorisierungstoken hinzu:
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" }
Ersetzen Sie Folgendes:
CUSTOMER_ID
: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID
: Die eindeutige Artikelnummer (SKU) Weitere Informationen findest du unter Produkte und SKU-IDs.PURCHASE_ORDER_ID
: Eine optionale Auftrags-ID, mit der Sie die Nutzung verfolgen können.
Im Folgenden finden Sie ein Beispiel für eine Antwort auf einen kostenlosen 30-tägigen Testzeitraum:
{
"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"
}
Rabattabo erstellen
Google kann einen Angebotscode für das Erstellen von Abos zu einem reduzierten Preis anbieten. Wenn du einen Rabatt auf ein Abo gewähren möchtest, musst du den Deal-Code im insert
-Aufruf des Abos angeben. Wenn der Kunde von seiner ursprünglichen Artikelnummer wechselt, wird der Rabatt entfernt.
Wenn Sie ein ermäßigtes Abo mit Jahrestarif für ein neu erstelltes Kundenkonto erstellen möchten, verwenden Sie die folgende POST
-HTTP-Anfrage und fügen Sie das Autorisierungstoken hinzu:
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" }
Ersetzen Sie Folgendes:
CUSTOMER_ID
: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID
: Die eindeutige Artikelnummer (SKU) Weitere Informationen findest du unter Produkte und SKU-IDs.PURCHASE_ORDER_ID
: Eine optionale Auftrags-ID, mit der Sie die Nutzung verfolgen können.GOOGLE_CONTRACT_DEAL_CODE
: Ein Rabattcode von Google.
Hier ein Beispiel für eine Antwort auf einen rabattierten Jahrestarif:
{
"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"
}
Abo übertragen
Wenn du das Konto des Kunden nicht mit dem Vorgang Neues Kundenkonto bestellen bestellt hast, verwende das Übertragungstoken des Kunden beim Erstellen eines Abos für diesen Kunden.
Verwenden Sie die folgende POST
-HTTP-Anfrage, um ein Abo für ein Kundenkonto zu erstellen, das Sie nicht bestellt haben:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Ersetzen Sie Folgendes:
CUSTOMER_ID
: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.TOKEN_VALUE
: Ein Übertragungstoken, das der Kunde bereitstellt. Nachdem der Kunde das Token generiert hat, ist es 30 Tage lang gültig.
Weitere Informationen dazu, wie Kunden ein Übertragungstoken erhalten, finden Sie in der Google Workspace-Hilfe.
Verwenden Sie die folgende POST
-HTTP-Anfrage und fügen Sie das Autorisierungstoken hinzu, um das Abo eines Kunden mit Jahrestarif zu übertragen:
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" }
Ersetzen Sie Folgendes:
CUSTOMER_ID
: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID
: Die eindeutige Artikelnummer (SKU) Weitere Informationen findest du unter Produkte und SKU-IDs.PURCHASE_ORDER_ID
: Eine optionale Auftrags-ID, mit der Sie die Nutzung verfolgen können.
Bei einer erfolgreichen Antwort werden der HTTP-Statuscode 200
und die Einstellungen des übertragenen Abos für einen Jahrestarif zurückgegeben:
{
"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"
}
Übertragungseinschränkungen
Wenn Sie ein Google Workspace-Abo mit einem verknüpften Google Drive- oder Google Vault-Abo übertragen möchten, verwenden Sie den Vorgang batch
, um alle Abos mit dem Status ACTIVE
zu übertragen. Wenn jedes Abo einzeln übertragen wird, tritt ein Fehler auf.
Die Übertragung von gesperrten Abos ist nur zulässig, wenn der Sperrungsgrund PENDING_TOS_ACCEPTANCE
, TRIAL_ENDED
oder RENEWAL_WITH_TYPE_CANCEL
ist.
Beim Übertragen einer alten Artikelnummer gibt subscriptions.list
eine skuId
der Artikelnummer zurück, die übertragen werden soll. Die skuId
der Artikelnummer, die der Kunde tatsächlich hat, wird als transferInfo.currentLegacySkuId
zurückgegeben. Eine vollständige Liste der skuIds
und der Produkte, die von diesen Plänen verwendet werden, finden Sie unter Produkte und SKUs.
Übertragungen funktionieren nicht mit Rabattcodes.