Abo erstellen oder übertragen

Nachdem Sie das Konto eines Kunden bestellen, können Sie verschiedene Abos erstellen:

  • Ein Abo mit Jahrestarif
  • Ein flexibles Abo
  • 30-tägige kostenlose Testversion
  • Ein vergünstigtes Abo

Weitere Informationen zu den Produkten, die für diese Abos verwendet werden, findest du unter Produkte und Artikelnummern

Wenn Sie das Konto dieses Kunden nicht bestellt haben, können Sie Abo übertragen

Kunden mit customerType = 'team' können nur Essentials und Enterprise Essentials-Versionen von Google Workspace Wenn Sie versuchen, eines anderen Google Workspace-Abos erhalten, Fehler: Customer is not eligible to purchase this subscription. Kunden ist der Kauf von Essentials oder nutzungsbasierten Abos möglicherweise nicht Jahrestarife mit begrenzten Optionen für Upgrades und Downgrades.

Abo erstellen

Um ein Abo für ein neu erstelltes Kundenkonto zu erstellen, verwenden Sie die POST-HTTP-Anfrage hinzu und geben Sie dabei das Autorisierungstoken an:

POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions

CUSTOMER_ID ist entweder der den primären Domainnamen des Kunden oder die eindeutige Kennung des Kunden, die zurückgegeben wird, wenn Abrufen des Kontos eines Kunden eines Resellers.

Jahrestarif erstellen

Bei Abos mit Jahrestarif haben nicht alle Artikelnummern dieselben Standard-Verlängerungseinstellungen. Wir empfehlen, immer renewalSettings zu übergeben. Erstellen 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 die primäre Domain des Kunden Name oder die eindeutige Kennung des Kunden.
  • SKU_ID: die eindeutige Artikelnummer Kennung. Weitere Informationen finden Sie unter Produkte und SKU-IDs
  • PURCHASE_ORDER_ID: Eine optionale Bestellung ID, mit der Sie die Nutzung erfassen können.

Bei einer erfolgreichen Antwort werden der HTTP-Status 200 und der Wert Einstellungen für einen Jahrestarif. ANNUAL_MONTHLY_PAY wird zurückgegeben als: ANNUAL in allen API-Antworten.

Hier sehen 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

Um ein flexibles Abo für ein neu erstelltes Kundenkonto zu erstellen, 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": "FLEXIBLE"
  },
  "seats": {
    "kind": "subscriptions#seats",
    "maximumNumberOfSeats": 10
  },
  "purchaseOrderId": "PURCHASE_ORDER_ID"
}

Ersetzen Sie Folgendes:

  • CUSTOMER_ID: Entweder die primäre Domain des Kunden Name oder die eindeutige Kennung des Kunden.
  • SKU_ID: die eindeutige Artikelnummer Kennung. Weitere Informationen finden Sie unter Produkte und SKU-IDs
  • PURCHASE_ORDER_ID: Eine optionale Bestellung ID, mit der Sie die Nutzung erfassen können.

Hier sehen Sie ein Beispiel für eine Antwort mit flexiblem 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

Um ein 30-tägiges kostenloses Testabo für das Abo eines neu erstellten Kunden zu erstellen -Konto haben, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie die Autorisierung ein, Token:

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 die primäre Domain des Kunden Name oder die eindeutige Kennung des Kunden.
  • SKU_ID: die eindeutige Artikelnummer Kennung. Weitere Informationen finden Sie unter Produkte und SKU-IDs
  • PURCHASE_ORDER_ID: Eine optionale Bestellung ID, mit der Sie die Nutzung erfassen können.

Hier sehen Sie ein Beispiel für eine Antwort auf einen 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"
}

Rabattabo erstellen

Google stellt möglicherweise einen Angebotscode zum Erstellen von Abos zu einem Rabatt zur Verfügung. zu zahlen. Wenn Sie einen Rabatt für ein Abo gewähren möchten, müssen Sie den Deal-Code in insert-Aboaufruf. Wenn die Kundschaft der ursprünglichen Artikelnummer, wird der Rabatt entfernt.

Um ein rabattiertes Jahresabo mit Jahrestarif für eine neu erstellte Kundenkonto erstellen, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie Autorisierungstoken:

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 die primäre Domain des Kunden Name oder die eindeutige Kennung des Kunden.
  • SKU_ID: die eindeutige Artikelnummer Kennung. Weitere Informationen finden Sie unter Produkte und SKU-IDs
  • PURCHASE_ORDER_ID: Optionaler Auftrag ID, mit der Sie die Nutzung erfassen können.
  • GOOGLE_CONTRACT_DEAL_CODE: Rabattcode verfügbar von Google.

Das folgende Beispiel zeigt die Antwort auf den 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 Sie das Konto des Kunden nicht über das ein neues Kundenkonto zu bestellen Vorgang: Verwenden Sie das Übertragungstoken des Kunden, wenn Sie ein Abo für dieser Kundschaft.

Um ein Abo für ein Kundenkonto zu erstellen, das Sie nicht bestellt haben, verwenden Sie 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 die primäre Domain des Kunden Name oder die eindeutige Kennung des Kunden.
  • TOKEN_VALUE: ein von Ihrem Kunden. 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 Sie das Abo eines Kunden mit Jahrestarif übertragen möchten, verwenden Sie die POST-HTTP-Anfrage hinzu und geben Sie dabei das Autorisierungstoken an:

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 die primäre Domain des Kunden Name oder die eindeutige Kennung des Kunden.
  • SKU_ID: die eindeutige Artikelnummer Kennung. Weitere Informationen finden Sie unter Produkte und SKU-IDs
  • PURCHASE_ORDER_ID: Optionaler Auftrag ID, mit der Sie die Nutzung erfassen können.

Eine erfolgreiche Antwort gibt den HTTP-Status 200 zurück und die Einstellungen des übertragenen Abos für eine 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": "example.com_annual_1",
  "status": "ACTIVE",
  "resourceUiUrl": "URL to customer's Admin console dashboard",
  "skuName": "Google Workspace Business Standard"
}

Übertragungsbeschränkungen

Wenn Sie ein Google Workspace-Abo mit einem verknüpften Google Drive-Konto übertragen oder Google Vault-Abo haben, verwenden Sie batch-Vorgang , um alle Abos mit dem Status ACTIVE zu übertragen. Übertragung jedes einzelnen eines Abonnements führt zu einem Fehler.

Die Übertragung gesperrter Abos ist nur zulässig, wenn der folgende Grund für die Sperrung angegeben wurde: PENDING_TOS_ACCEPTANCE, TRIAL_ENDED oder RENEWAL_WITH_TYPE_CANCEL.

Bei der Übertragung einer alten Artikelnummer gibt subscriptions.list eine skuId zurück. der Artikelnummer, die übertragen werden soll. Die skuId der Artikelnummer, die der „customervactually“ wird als transferInfo.currentLegacySkuId zurückgegeben. Für eine Vollständige Liste von skuIds und dazu, welche Produkte von diesen Tarifen verwendet werden, siehe Produkte und SKUs.

Übertragungen funktionieren nicht mit Rabattcodecodes.