REST Resource: partners.customers

Ressource: Unternehmen

Ein Reseller, Anbieter oder Kunde in den Zero-Touch-Reseller- und Kunden-APIs.

JSON-Darstellung
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Felder
name

string

Nur Ausgabe. Der API-Ressourcenname des Unternehmens. Der Ressourcenname hat eines der folgenden Formate:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

Vom Server zugewiesen.

companyId

string (int64 format)

Nur Ausgabe. Die ID des Unternehmens. Vom Server zugewiesen.

companyName

string

Erforderlich. Der Name des Unternehmens. Beispiel: XYZ Corp. Wird den Mitarbeitern des Unternehmens im Portal für die Zero-Touch-Registrierung angezeigt.

ownerEmails[]

string

Erforderlich. Nur Eingabe. E-Mail-Adresse der Nutzer des Kunden mit der Rolle „Inhaber“. Mindestens ein owner_email ist erforderlich. Inhaber haben denselben Zugriff wie Administratoren. Als Inhaber können sie aber auch die Nutzer des Portals Ihrer Organisation hinzufügen, löschen und bearbeiten.

adminEmails[]

string

Optional. E-Mail-Adresse der Nutzer des Kunden mit der Administratorrolle. Jede E-Mail-Adresse muss mit einem Google-Konto verknüpft sein.

termsStatus

enum (TermsStatus)

Nur Ausgabe. Gibt an, ob ein Nutzer des Unternehmens die aktuellen Nutzungsbedingungen akzeptiert hat. TermsStatus ansehen.

skipWelcomeEmail

boolean

Nur Eingabe. Wenn die Richtlinie auf „true“ gesetzt ist, wird keine Begrüßungs-E-Mail an den Kunden gesendet. Wir empfehlen, die Begrüßungs-E-Mail zu überspringen, wenn Geräte mit dem zusätzlichen DEVICE_PROTECTION-Dienst beansprucht werden, da der Kunde zum Zeitpunkt der Geräteaktivierung eine separate E-Mail erhält. Dieses Feld wird ignoriert, wenn es sich nicht um einen Zero-Touch-Kunden handelt.

languageCode

string

Nur Eingabe. Die bevorzugte Sprache des Kunden, dargestellt als BCP47-Sprachcode. Dieses Feld wird bei der Eingabe validiert und Anfragen mit nicht unterstützten Sprachcodes werden abgelehnt.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Nur Ausgabe. Das mit diesem Kunden verknüpfte Google Workspace-Konto. Wird nur für Kundenunternehmen verwendet.

TermsStatus

Zustimmung eines Unternehmens zu den Nutzungsbedingungen für die Zero-Touch-Registrierung. Ein einzelner Nutzer kann die Nutzungsbedingungen für sein Unternehmen über das Webportal akzeptieren.

Die Nutzungsbedingungen sind versioniert. Das bedeutet, dass bei einer Änderung der Nutzungsbedingungen mindestens ein Nutzer den neuen Nutzungsbedingungen zustimmen muss. Bis der erste Nutzer den neuen Nutzungsbedingungen zustimmt, hat das Unternehmen den Status „TERMS_STATUS_STALE“.

Enums
TERMS_STATUS_NOT_ACCEPTED Keiner der Nutzer des Unternehmens hat die Nutzungsbedingungen akzeptiert.
TERMS_STATUS_ACCEPTED Mindestens ein Nutzer des Unternehmens hat die Nutzungsbedingungen akzeptiert.
TERMS_STATUS_STALE Keiner der Nutzer des Unternehmens hat die aktuellen Nutzungsbedingungen akzeptiert, aber mindestens ein Nutzer hat eine vorherige akzeptiert.

GoogleWorkspaceAccount

Sie sind Google Workspace-Kunde.

JSON-Darstellung
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Felder
customerId

string

Erforderlich. Die Kundennummer.

preProvisioningTokens[]

string

Nur Ausgabe. Die Tokens für die Vorab-Bereitstellung, die zuvor zum Freischalten von Geräten verwendet wurden.

Methoden

create

Erstellt einen Kunden für die Zero-Touch-Registrierung.

list

Listet die Kunden auf, die bei dem Reseller registriert sind, der durch das Argument partnerId identifiziert wird.