Nachdem Sie das Konto eines Kunden bestellt haben, können Sie eine Reihe verschiedener Abos erstellen:
- Ein Abo mit jährlicher Zusicherung
- Ein flexibles Abo
- 30-tägiger kostenloser Testzeitraum
- Abo mit Rabatt
Weitere Informationen zu den Produkten, die für diese Abos verwendet werden, finden Sie unter Produkte und Artikel.
Wenn Sie das Konto des Kunden nicht bestellt haben, können Sie ein Abo übertragen.
Kunden mit customerType = 'team' können nur die Google Workspace-Versionen Google Workspace Essentials und Google Workspace Enterprise Essentials erwerben. Wenn Sie versuchen, andere Google Workspace-Abos zu kaufen, erhalten Sie die Fehlermeldung Customer is not eligible to purchase this subscription.
Kunden, die Essentials- oder nutzungsbasierte Abos erwerben, können möglicherweise keine Jahrestarife mit Mindestabnahme nutzen und haben nur eingeschränkte Upgrade- und Downgrade-Optionen.
Abo erstellen
Verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, um ein Abo für das Konto eines neuen Kunden zu erstellen:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID ist entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden, die beim Abrufen des Kontos eines weiterverkauften Kunden zurückgegeben wird.
Jahreszusicherungstarif erstellen
Bei Abos mit Jahrestarif haben nicht alle SKUs dieselben Standardeinstellungen für die Verlängerung. Wir empfehlen, renewalSettings immer zu übergeben. Erstellen Sie ein Jahresabo mit Zusicherung mit 10 Arbeitsplätzen:
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 Kennung der Artikelnummer (Stock Keeping Unit, SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Eine erfolgreiche Antwort gibt den HTTP-Status 200 und die Einstellungen des neuen Abos für einen Jahresvertrag zurück. ANNUAL_MONTHLY_PAY wird in allen API-Antworten als ANNUAL zurückgegeben.
Hier ist ein Beispiel für eine Antwort auf einen Jahresplan:
{
"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 Plan erstellen
Wenn Sie ein flexibles Abo für das Konto eines neuen Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
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 Kennung der Artikelnummer (Stock Keeping Unit, SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Hier ist ein Beispiel für eine Antwort auf einen flexiblen Plan:
{
"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 30-tägiges kostenloses Probeabo für das Konto eines neuen Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
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 Kennung der Artikelnummer (Stock Keeping Unit, SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Hier ist ein Beispiel für eine Antwort auf ein 30‑tägiges Probeabo:
{
"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"
}
Abo mit Rabatt erstellen
Google stellt möglicherweise einen Angebotscode zur Verfügung, mit dem du Abos zu einem ermäßigten Preis erstellen kannst. Wenn Sie ein Abo rabattieren möchten, müssen Sie den Angebotscode im insert-Aufruf für das Abo angeben. Wenn der Kunde die ursprüngliche SKU ändert, wird der Rabatt entfernt.
Wenn Sie ein Jahresabo mit Rabatt für das Konto eines neuen Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
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 Kennung der Artikelnummer (Stock Keeping Unit, SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.GOOGLE_CONTRACT_DEAL_CODE: Ein von Google bereitgestellter Rabattcode.
Hier ist ein Beispiel für eine Antwort auf ein Jahresabo mit Rabatt:
{
"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 Sie das Konto des Kunden nicht mit dem Vorgang Neues Kundenkonto bestellen bestellt haben, verwenden Sie das Übertragungstoken des Kunden, wenn Sie ein Abo für diesen Kunden erstellen.
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 von Ihrem Kunden bereitgestelltes Übertragungstoken. 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 Admin-Hilfe.
Wenn Sie das Abo eines Kunden mit Jahresvertrag übertragen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
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 Kennung der Artikelnummer (Stock Keeping Unit, SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und die Einstellungen des übertragenen Abos für einen Jahresvertrag 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"
}
Einschränkungen bei der Übertragung
Wenn Sie ein Google Workspace-Abo mit einem zugehörigen Google Drive- oder Google Vault-Abo übertragen, verwenden Sie den batch-Vorgang, um alle Abos mit dem Status ACTIVE zu übertragen. Wenn Sie jedes Abo einzeln übertragen, tritt ein Fehler auf.
Die Übertragung gesperrter Abos ist nur zulässig, wenn der Grund für die Sperrung PENDING_TOS_ACCEPTANCE, TRIAL_ENDED oder RENEWAL_WITH_TYPE_CANCEL ist.
Beim Übertragen einer alten Artikelnummer gibt subscriptions.list eine skuId der zu übertragenden Artikelnummer zurück. Die skuId der SKU, die der Kunde tatsächlich hat, wird als transferInfo.currentLegacySkuId zurückgegeben. Eine vollständige Liste der skuIds und der Produkte, die in diesen Tarifen verwendet werden, finden Sie unter Produkte und SKUs.
Übertragungen funktionieren nicht mit Rabattcodes.