REST Resource: partners.customers

Ressource: Unternehmen

Ein Reseller, Anbieter oder Kunde in der Zero-Touch-API für Reseller und Kunden

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 in der Inhaberrolle. Mindestens ein owner_email ist erforderlich. Inhaber haben denselben Zugriff wie Administratoren, können aber auch Portalnutzer 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äteanforderung separate E-Mails 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. 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.

Nutzungsstatus

Ein Unternehmen akzeptiert die 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 der Änderung der Nutzungsbedingungen mindestens ein Nutzer die neuen Nutzungsbedingungen akzeptieren muss. Bis der erste Nutzer die neuen Nutzungsbedingungen akzeptiert, lautet der Status der Nutzungsbedingungen für das Unternehmen TERMS_STATUS_STALE.

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

GoogleWorkspace-Konto

Ein 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 Beanspruchen von Geräten verwendet wurden.

Methoden

create

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

list

 Listet die Kunden auf, die für den Reseller registriert sind, der durch das Argument partnerId identifiziert wird.