Neues Kundenkonto bestellen

Bevor Sie ein neues Kundenkonto erstellen, sollten Sie Folgendes berücksichtigen:

Kundenkonto erstellen

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

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

  2. Erstellen Sie einen Nutzer im Konto des neuen Kunden. Wenn die Antwort den HTTP-Statuscode 409 Conflict zurückgibt, ist 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. Nutzer auf Super Admin-Rolle hochstufen Beim Erstellen des Administratorkontos können Sie entweder ein temporäres zufälliges Passwort generieren oder den Kunden zur Eingabe eines Passworts auffordern.

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

Kundentypen

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

  • Kunden mit Domainbestätigung: Diese Kunden benötigen Gmail und vollständigen Administratorzugriff. Wenn Sie diesen Kundentyp erstellen, legen Sie customerType auf domain fest.
  • Kunden mit bestätigter E-Mail-Adresse: Diese Kunden sind nicht Inhaber und Administrator ihrer Domain. Wenn Sie diesen Kundentyp erstellen, legen Sie customerType auf team fest. Diese Kundentypen können Essentials und Enterprise Essentials von Google Workspace erwerben.

Der folgende JSON-Anfragetext ist ein Beispiel für einen Kunden mit Domainbestätigung:

{
  "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 Ihres Kunden, z. B. example.com
  • NAME: der Name Ihres Kunden, z. B. Alex Cruz
  • ORGANIZATION_NAME: der Organisationsname Ihres Kunden, z. B. Example Organization.
  • POSTAL_CODE: die Postleitzahl des Kunden, z. B. 94043
  • COUNTRY_CODE: Der zweistellige ISO-Ländercode Ihres Kunden.
  • EMAIL_ADDRESS: die E-Mail-Adresse Ihres Kunden, z. B. cruz@example.com

Bei einer erfolgreichen Antwort werden der HTTP-Statuscode 200 und die Informationen des Neukunden 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"
}

Der folgende JSON-Anfragetext ist ein Beispiel für einen Kunden mit E-Mail-Bestätigung:

{
  "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 werden der HTTP-Statuscode 200 und die Informationen des Neukunden 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 wird nur auf neue Nutzer angewendet, wenn diese erstellt werden. Bestehende Nutzer behalten ihre aktuelle Sprache, auch nachdem Sie die Standardsprache aktualisiert haben. Daher müssen Sie die Standardsprache des Kunden festlegen, bevor Sie Nutzer erstellen.

Für einen neu erstellten Kunden ist Englisch als Standardsprache eingestellt. Verwenden Sie zum Ändern der Standardsprache die PATCH- oder UPDATE-Aufrufe des Customers-Endpunkts der Directory API.

Verwenden Sie die Directory API, um den Standardwert language für einen Kunden zu aktualisieren:

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 Kennzeichnung für den Kunden, z. B. C0123456
  • LANGUAGE_CODE: ein akzeptierter Sprachcode, z. B. es für Spanisch.

Bei einer erfolgreichen JSON-Antwort werden 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