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 mit einem primären Domainnamen und einer physischen 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 immer in einer Antwort 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 Name des primären Domainnamens des Kunden. customerDomain ist erforderlich, wenn Sie einen neuen Kunden erstellen. Fügen Sie das Präfix www nicht in der Domain ein, wenn Sie einen Kunden hinzufügen.
postalAddress

object (Address)

Die Adresse eines Kunden. Jedes Feld kann maximal 255 Zeichen enthalten.
phoneNumber

string

Telefonnummer des Kundenkontakts: Muss mit "+" beginnen, gefolgt vom Ländercode. Der Rest der Nummer kann aufeinanderfolgend sein oder die lokalen Formatkonventionen des Telefons einhalten. Es muss sich dabei jedoch um eine echte Telefonnummer handeln, z. B. „123"“. Dieses Feld wird ohne Meldung ignoriert, wenn es ungültig ist.
alternateEmail

string

Wie bei der E-Mail-Adresse des Kunden in den Reseller-Tools ist diese E-Mail-Adresse der sekundäre Kontakt, der verwendet wird, wenn beim Dienst des Kunden etwas passiert, z. B. aufgrund eines Dienstausfalls oder eines Sicherheitsproblems. Diese Property ist erforderlich, wenn Sie eine neue Domain erstellen, und darf nicht dieselbe Domain wie customerDomain verwenden. Das Feld alternateEmail ist nicht erforderlich, um einen Kunden zu erstellen.
resourceUiUrl

string

URL zum Dashboard der Admin-Konsole des Kunden. Die schreibgeschützte URL wird vom API-Dienst generiert. Er wird verwendet, wenn Ihre Clientanwendung erfordert, dass der Kunde eine Aufgabe in der Admin-Konsole ausführt.
customerDomainVerified

boolean

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

string

Kennzeichnet die Ressource als Kunden. Wert: reseller#customer
customerType

enum (CustomerType)

Kennzeichnet den Kundentyp. Zulässige Werte:

  • domain: Impliziert einen Kunden mit Domainbestätigung (Standardeinstellung).
  • team: Impliziert einen Kunden mit E-Mail-Bestätigung.

Weitere Informationen finden Sie unter Verwaltete Teams.
primaryAdmin

object (PrimaryAdmin)

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

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

Weitere Informationen zu countryCode findest du in den ISO 3166-Ländercodeelementen. Prüfen Sie, ob das Land für den Weiterverkauf von Google-Produkten genehmigt ist. Diese Property ist erforderlich, wenn Sie einen neuen Kunden erstellen.
kind

string

Kennzeichnet die Ressource als Kundenadresse. Wert: customers#address
region

string

Ein Beispiel für einen region-Wert ist CA für den 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 postalCode-Beispiel ist eine Postleitzahl wie 94043. Diese Property ist erforderlich, wenn Sie einen neuen Kunden erstellen.
addressLine1

string

Anschrift eines Kunden Eine Adresse kann aus einer oder drei Zeilen bestehen. addressline2 und addressLine3 sind optional.
organizationName

string

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

string

Der Name des Ansprechpartners beim Kunden. Das ist ein Pflichtfeld.

Kundentyp

Art des Kunden

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

Primärer Administrator

JSON-Vorlage für primären Administrator für TEAM-Kunden

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

string

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

Der E-Mail-Bestätigungslink wird zum Zeitpunkt der Kundenerstellung an diese E-Mail-Adresse gesendet. Primäre Administratoren haben Zugriff auf die Admin-Konsole des Kunden, einschließlich der Möglichkeit, Nutzer einzuladen und zu entfernen und die administrativen Anforderungen des Kunden zu verwalten.

Methoden

get

 Ruft ein Kundenkonto ab.

insert

 Bestellt ein neues Kundenkonto.

patch

 Aktualisiert die Einstellungen eines Kundenkontos

update

 Aktualisiert die Einstellungen eines Kundenkontos