Neues Kundenkonto bestellen

Beachten Sie vor dem Erstellen eines neuen Kundenkontos Folgendes:

Kundenkonto erstellen

  1. Verwenden Sie die folgende POST-Anfrage, um ein Kundenkonto zu erstellen, und fügen Sie das Autorisierungstoken ein:

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

  2. Erstellen Sie im Konto des neuen Kunden, einen Nutzer. Wenn die Antwort den HTTP-Statuscode 409 Conflict zurückgibt, ist die customerId bereits vorhanden. Bevor Sie das Kundenkonto registrieren, müssen Sie die Abos des Kunden übertragen.

  3. Ändern Sie gegebenenfalls die Standardsprache des Kunden.

  4. Erheben Sie den Nutzer zur Super Admin-Rolle. Beim Erstellen des Administratorkontos können Sie entweder ein temporäres Zufallspasswort generieren oder den Kunden auffordern, ein Passwort anzugeben.

  5. Teilen Sie dem Kunden mit, dass er sich in der Admin-Konsole anmelden und die Google Workspace-Vereinbarung für Reseller unterzeichnen muss, um sein Konto zu aktivieren. Reseller dürfen die Nutzungsbedingungen nicht im Namen des Kunden unterzeichnen.

Kundentypen

Sie können zwei Arten von Kunden in Google Workspace erstellen:

  • Kunden mit bestätigter Domain: Diese Kunden benötigen Gmail und vollständigen Administratorzugriff. Wenn Sie diesen Kundentyp erstellen, legen Sie für customerType den Wert domain fest.
  • Kunden mit bestätigter E-Mail-Adresse: Diese Kunden sind nicht Inhaber ihrer Domain und verwalten sie auch nicht. Wenn Sie diesen Kundentyp erstellen, legen Sie für customerType den Wert team fest. Diese Kunden können die Google Workspace-Versionen Google Workspace Essentials und Google Workspace Enterprise Essentials erwerben.

Das folgende JSON-Anfrageobjekt ist ein Beispiel für einen Kunden mit bestätigter Domain:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Ersetzen Sie Folgendes:

  • DOMAIN_NAME: Die Domain des Kunden, z. B. example.com.
  • NAME: Der Name des Kunden, z. B. Alex Cruz.
  • ORGANIZATION_NAME: Der Name der Organisation des Kunden, z. B. Example Organization.
  • POSTAL_CODE: Die Postleitzahl des Kunden, z. B. 94043.
  • COUNTRY_CODE: Der zweistellige ISO-Ländercode des Kunden.
  • EMAIL_ADDRESS: Die E-Mail-Adresse des Kunden, z. B. cruz@example.com.

Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und die Informationen des neuen Kunden zurückgegeben:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Das folgende JSON-Anfrageobjekt ist ein Beispiel für einen Kunden mit bestätigter E-Mail-Adresse:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und die Informationen des neuen Kunden zurückgegeben:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Standardsprache eines Kunden ändern

Die Standardsprache eines Kunden gilt nur für neue Nutzer. Bestehende Nutzer behalten ihre Sprache bei, nachdem Sie die Standardsprache aktualisiert haben. Legen Sie daher die Standardsprache des Kunden fest, bevor Sie Nutzer erstellen.

Die Standardsprache eines neuen Kunden ist Englisch. Verwenden Sie die Methoden PATCH oder UPDATE des Directory API-Endpunkts „Customers“, um die Standard sprache zu ändern.

So aktualisieren Sie den Standardwert für language für einen Kunden mit der Directory API:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Fügen Sie den folgenden JSON-Anfragetext ein:

{
  "language":"LANGUAGE_CODE"
}

Ersetzen Sie Folgendes:

  • CUSTOMER_ID: Eine eindeutige ID für den Kunden, z. B. C0123456.
  • LANGUAGE_CODE: Ein akzeptierter Sprachcode, z. B. es für Spanisch.

Bei einer erfolgreichen JSON-Antwort wird der HTTP-Statuscode 200 und die aktualisierte Kundenressource zurückgegeben:

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Nächste Schritte