Neues Kundenkonto bestellen

Beachten Sie Folgendes, bevor Sie ein neues Kundenkonto erstellen:

Kundenkonto erstellen

  1. Verwenden Sie zum Erstellen eines Kundenkontos die folgende POST-Anfrage und fügen Sie das Autorisierungstoken ein:

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

  2. Erstellen Sie einen Nutzer im Konto des Neukunden. 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. Ordnen Sie den Nutzer der Rolle „Super Admin“ zu. Beim Erstellen des Administratorkontos können Sie entweder ein temporäres Zufallspasswort generieren oder den Kunden zur Eingabe eines Passworts auffordern.

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

Arten von Kunden

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

  • Kunden mit Domainbestätigung Diese Kunden benötigen Gmail und benötigen vollständigen Administratorzugriff. Legen Sie beim Erstellen dieses Kundentyps customerType auf domain fest.
  • E-Mail-Bestätigung. Diese Kunden sind nicht Inhaber oder Administrator ihrer Domain. Legen Sie beim Erstellen dieses Kundentyps customerType auf team fest. Diese Kunden können die Essentials- und Enterprise Essentials-Versionen 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"
}

Dabei gilt:

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

Eine erfolgreiche Antwort gibt den HTTP-Statuscode 200 und die Informationen des Neukunden zurück:

{
  "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 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"
}

Eine erfolgreiche Antwort gibt den HTTP-Statuscode 200 und die Informationen des Neukunden zurück:

{
  "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 des 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.

Ein neu erstellter Kunde hat eine Standardsprache auf Englisch. Wenn Sie die Standardsprache ändern möchten, verwenden Sie die Aufrufe PATCH oder UPDATE vom Endpunkt Customers 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"
}

Dabei gilt:

  • CUSTOMER_ID: eine eindeutige Kennung für Ihren Kunden, z. B. C0123456
  • LANGUAGE_CODE: ein akzeptierter Sprachcode, z. B. es für Spanisch.

Eine erfolgreiche JSON-Antwort gibt den HTTP-Statuscode 200 und die aktualisierte Kundenressource zurück:

{
  "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