REST Resource: customers

Ressource: Kunde

Wenn das Konto eines Google-Kunden bei einem Reseller registriert ist, werden die Abos des Kunden für Google-Dienste von diesem Reseller verwaltet. Ein Kunde wird durch einen primären Domainnamen und eine physische Adresse beschrieben.

JSON-Darstellung 
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Felder
customerId

string

Diese Property wird in einer Antwort immer als von Google generierte eindeutige Kennung zurückgegeben. In einer Anfrage kann diese Property entweder die primäre Domain oder die von Google generierte eindeutige Kennung sein.
customerDomain

string

Der String mit dem primären Domainnamen des Kunden. customerDomain ist beim Erstellen eines neuen Kunden erforderlich. Fügen Sie beim Hinzufügen eines Kunden nicht das Präfix www in die Domain ein.
postalAddress

object (Address)

Die Adressinformationen eines Kunden. Jedes Feld ist auf 255 Zeichen beschränkt.
phoneNumber

string

Telefonnummer des Kundenkontakts. Muss mit „+“ gefolgt von der Landesvorwahl beginnen. Der Rest der Nummer kann aus zusammenhängenden Zahlen bestehen oder den lokalen Formatkonventionen für Telefonnummern entsprechen. Es muss sich jedoch um eine echte Telefonnummer handeln und nicht z. B. um „123“. Dieses Feld wird ignoriert, wenn es ungültig ist.
alternateEmail

string

Ähnlich wie die „Kunden-E-Mail-Adresse“ in den Reseller-Tools ist diese E-Mail-Adresse die sekundäre Kontaktadresse, die verwendet wird, wenn ein Problem mit dem Dienst des Kunden auftritt, z. B. ein Dienstausfall oder ein Sicherheitsproblem. Diese Property ist erforderlich, wenn Sie einen neuen Domainkunden erstellen. Sie darf nicht dieselbe Domain wie customerDomain verwenden. Das Feld alternateEmail ist nicht erforderlich, um einen Teamkunden zu erstellen.
resourceUiUrl

string

URL zum Admin-Konsole-Dashboard des Kunden. Die schreibgeschützte URL wird vom API-Dienst generiert. Diese Option wird verwendet, wenn der Kunde in Ihrer Clientanwendung eine Aufgabe in der Admin-Konsole erledigen muss.
customerDomainVerified

boolean

Gibt an, ob die primäre Domain des Kunden bestätigt wurde.
kind

string

Die Ressource wird als Kunde identifiziert. Wert: reseller#customer
customerType

enum (CustomerType)

Gibt den Kundentyp an. Zulässige Werte:

  • domain: Kunden mit Domainbestätigung (Standard).
  • team: Kunden mit bestätigter E-Mail-Adresse.

Weitere Informationen finden Sie unter Verwaltete Teams.
primaryAdmin

object (PrimaryAdmin)

Die ersten Administratordetails des Kunden, vorhanden bei TEAM-Kunden.

Adresse

JSON-Vorlage für die Adresse eines Kunden.

JSON-Darstellung 
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Felder
countryCode

string

Informationen zu countryCode finden Sie unter ISO 3166-Ländercode-Elemente. Prüfen Sie, ob das Land für den Weiterverkauf von Google-Produkten genehmigt ist. Diese Property ist beim Erstellen eines neuen Kunden erforderlich.
kind

string

Gibt an, dass die Ressource eine Kundenadresse ist. Wert: customers#address
region

string

Ein Beispiel für einen region-Wert ist CA für den US-Bundesstaat Kalifornien.
addressLine2

string

Zeile 2 der Adresse.
locality

string

Ein Beispiel für einen locality-Wert ist die Stadt San Francisco.
addressLine3

string

Zeile 3 der Adresse.
postalCode

string

Ein Beispiel für postalCode ist eine Postleitzahl wie 94043. Diese Property ist beim Erstellen eines neuen Kunden erforderlich.
addressLine1

string

Die physische Adresse eines Kunden. Eine Adresse kann aus einer bis drei Zeilen bestehen. addressline2 und addressLine3 sind optional.
organizationName

string

Der Name des Unternehmens oder der Unternehmensabteilung. Das ist ein Pflichtfeld.
contactName

string

Der Name des Kundenkontakts. Das ist ein Pflichtfeld.

CustomerType

Art des Kunden

Enums
customerTypeUnspecified Kundentyp nicht bekannt
domain Kunden mit Domain oder Domaininhaber
team Kunden ohne Domain oder mit E-Mail-Bestätigung

PrimaryAdmin

JSON-Vorlage für den Hauptadministrator bei TEAM-Kunden

JSON-Darstellung 
{
  "primaryEmail": string
}
Felder
primaryEmail

string

Die geschäftliche E-Mail-Adresse des primären Administrators des Kunden.

Der Link zur E-Mail-Bestätigung wird beim Erstellen des Kunden an diese E-Mail-Adresse gesendet. Hauptadministratoren haben Zugriff auf die Admin-Konsole des Kunden. Sie können Nutzer einladen und entfernen sowie die administrativen Anforderungen des Kunden verwalten.

Methoden

get

 Ruft ein Kundenkonto ab.

insert

 Er bestellt das Konto eines neuen Kunden.

patch

 Aktualisiert die Einstellungen eines Kundenkontos.

update

 Aktualisiert die Einstellungen eines Kundenkontos.