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 Anschrift 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 Eigenschaft wird in der Antwort immer als die von Google generierte eindeutige Kennung zurückgegeben. In einer Anfrage kann diese Eigenschaft entweder die primäre Domain oder die von Google generierte eindeutige Kennung sein.

customerDomain

string

Der String des primären Domainnamens des Kunden. customerDomain ist beim Erstellen eines neuen Kunden erforderlich. Geben Sie beim Hinzufügen eines Kunden nicht das Präfix www in der Domain an.

postalAddress

object (Address)

Die Adressinformationen eines Kunden. Jedes Feld darf maximal 255 Zeichen enthalten.

phoneNumber

string

Telefonnummer des Kundenkontakts Muss mit „+“ beginnen gefolgt von der Landesvorwahl. Der Rest der Nummer kann zusammenhängende Nummern sein oder die örtlichen Formatkonventionen für Telefonnummern einhalten. Es muss sich jedoch um eine echte Telefonnummer handeln, nicht z. B. „123“. Dieses Feld wird bei einem ungültigen Feld ignoriert.

alternateEmail

string

Z. B. „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. ein Dienstausfall oder ein Sicherheitsproblem. Diese Property ist erforderlich, wenn eine neue „Domain“ erstellt wird Kunde und sollte nicht dieselbe Domain wie customerDomain verwenden. Das Feld alternateEmail ist zum Erstellen eines Teams nicht erforderlich Kunden.

resourceUiUrl

string

URL zum Dashboard der Admin-Konsole des Kunden Die schreibgeschützte URL wird vom API-Dienst generiert. Diese Option wird verwendet, wenn der Kunde für Ihre Clientanwendung eine Aufgabe in der Admin-Konsole ausführen muss.

customerDomainVerified

boolean

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

kind

string

Kennzeichnet die Ressource als Kunde. Wert: reseller#customer

customerType

enum (CustomerType)

Identifiziert den Typ des Kunden. Zulässige Werte:

  • domain: Impliziert einen Kunden mit bestätigter Domain (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 (bei TEAM-Kunden vorhanden).

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 findest du unter ISO 3166-Ländercodeelemente. Prüfen Sie, ob das Land für den Weiterverkauf von Google-Produkten freigegeben ist. Diese Property ist beim Erstellen eines neuen Kunden erforderlich.

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 beim Erstellen eines neuen Kunden erforderlich.

addressLine1

string

Die Anschrift eines Kunden. Eine Adresse kann aus ein bis drei Zeilen bestehen. addressline2 und addressLine3 sind optional.

organizationName

string

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

contactName

string

Name des Kundenkontakts. Das ist ein Pflichtfeld.

CustomerType

Art der Kundschaft

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

PrimaryAdmin

JSON-Vorlage für primären Administrator im Fall von 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 beim Erstellen des Kunden 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 das Konto eines Neukunden.

patch

Aktualisiert die Einstellungen eines Kundenkontos.

update

Aktualisiert die Einstellungen eines Kundenkontos.