Nachdem du ein Kundenkonto bestellt hast, kannst du verschiedene Abos erstellen:
- Ein Abo mit jährlicher Zusicherung
- Ein flexibles Abo
- 30-tägige Testversion
- Ein vergünstigtes Abo
Weitere Informationen zu den Produkten, die für diese Abos verwendet werden, finden Sie unter Produkte und Artikelnummern.
Wenn du das Konto dieses Kunden nicht bestellt hast, kannst du ein Abo übertragen.
Kunden mit customerType = 'team' können nur die Versionen Essentials und Enterprise Essentials von Google Workspace erwerben. Wenn Sie versuchen, eines der anderen Google Workspace-Abos zu erwerben, erhalten Sie die Fehlermeldung Customer is not eligible to purchase this subscription. Kunden, die Essentials- oder nutzungsbasierte Abos erwerben, können möglicherweise keine Jahresmitgliedschaft abschließen und haben nur eingeschränkte Upgrade- und Downgrade-Optionen.
Abo erstellen
Wenn du ein Abo für das Konto eines neu erstellten Kunden erstellen möchtest, verwende die folgende POST-HTTP-Anfrage und füge das Autorisierungstoken ein:
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 Reseller-Kunden zurückgegeben wird.
Jahrestarif erstellen
Bei Abos mit jährlicher Bindung haben nicht alle Artikelnummern dieselben Standardeinstellungen für die Verlängerung. Wir empfehlen, immer renewalSettings zu übergeben. So erstellen Sie ein Abo mit einer jährlichen Bindung und 10 Sitzen:
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 seine eindeutige Kennung.SKU_ID: Die eindeutige Artikelnummer (SKU). Weitere Informationen finden Sie unter Produkt- und Artikelnummern.PURCHASE_ORDER_ID: Optionale Bestellnummer, mit der Sie die Nutzung erfassen können.
Eine erfolgreiche Antwort gibt einen HTTP-200-Status und die Einstellungen des neuen Abos für ein Jahr zurück. ANNUAL_MONTHLY_PAY wird in allen API-Antworten als ANNUAL zurückgegeben.
Im Folgenden findest du 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 Plan erstellen
Wenn du ein flexibles Abo für das Konto eines neu erstellten Kunden erstellen möchtest, verwende die folgende POST-HTTP-Anfrage und füge 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 seine eindeutige Kennung.SKU_ID: Die eindeutige Artikelnummer (SKU). Weitere Informationen finden Sie unter Produkt- und Artikelnummern.PURCHASE_ORDER_ID: Optionale Bestellnummer, mit der Sie die Nutzung erfassen können.
Im Folgenden findest du ein Beispiel für eine Antwort für 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 du ein 30-tägiges Probeabo für das Konto eines neu erstellten Kunden erstellen möchtest, verwende die folgende POST-HTTP-Anfrage und füge 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 seine eindeutige Kennung.SKU_ID: Die eindeutige Artikelnummer (SKU). Weitere Informationen finden Sie unter Produkt- und Artikelnummern.PURCHASE_ORDER_ID: Optionale Bestellnummer, mit der Sie die Nutzung erfassen können.
Im Folgenden findest du ein Beispiel für eine Antwort zu einem 30-tägigen kostenlosen 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"
}
Rabatt-Abo erstellen
Google stellt möglicherweise einen Angebotscode für die Erstellung von Abos zu einem ermäßigten Preis zur Verfügung. Wenn du einen Rabatt auf ein Abo gewähren möchtest, musst du den Deal-Code im insert-Aufruf für das Abo angeben. Wenn der Kunde von seiner ursprünglichen SKU abweicht, wird der Rabatt entfernt.
Wenn du ein Jahresabo mit Rabatt für das Konto eines neu erstellten Kunden erstellen möchtest, verwende die folgende POST-HTTP-Anfrage und füge 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 seine eindeutige Kennung.SKU_ID: Die eindeutige Artikelnummer (SKU). Weitere Informationen finden Sie unter Produkt- und Artikelnummern.PURCHASE_ORDER_ID: Optionale Bestellnummer, mit der Sie die Nutzung erfassen können.GOOGLE_CONTRACT_DEAL_CODE: Ein von Google bereitgestellter Rabattcode.
Im Folgenden findest du ein Beispiel für eine Antwort zu einem Jahrestarif 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 du das Konto des Kunden nicht mit der Operation Neues Kundenkonto bestellen bestellt hast, verwende das Übertragungstoken des Kunden, wenn du ein Abo für diesen Kunden erstellst.
Wenn du ein Abo für ein Kundenkonto erstellen möchtest, das du nicht bestellt hast, verwende die folgende POST-HTTP-Anfrage:
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 seine eindeutige Kennung.TOKEN_VALUE: Ein von deinem 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 Google Workspace-Hilfe.
Wenn du das Abo eines Kunden mit einem Jahresvertrag übertragen möchtest, verwende die folgende POST-HTTP-Anfrage und füge 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 seine eindeutige Kennung.SKU_ID: Die eindeutige Artikelnummer (SKU). Weitere Informationen finden Sie unter Produkt- und Artikelnummern.PURCHASE_ORDER_ID: Optionale Bestellnummer, mit der Sie die Nutzung erfassen können.
Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und die Einstellungen des übertragenen Abos für ein Jahr 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 verknüpften Google Drive- oder Google Vault-Abo übertragen, verwenden Sie den Vorgang batch, um alle Abos mit dem Status ACTIVE zu übertragen. Wenn Sie jedes Abo einzeln übertragen, führt dies zu einem Fehler.
Die Übertragung von gesperrten Abos ist nur zulässig, wenn der Grund für die Sperrung PENDING_TOS_ACCEPTANCE, TRIAL_ENDED oder RENEWAL_WITH_TYPE_CANCEL ist.
Bei der Übertragung 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 mit diesen Plänen verwendet werden, finden Sie unter Produkte und SKUs.
Für Überweisungen können keine Rabattcodes verwendet werden.