REST Resource: partners.customers

Resource: Perusahaan

Reseller, vendor, atau pelanggan di reseller zero-touch dan API pelanggan.

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

string

Hanya output. Nama resource API perusahaan. Nama resource adalah salah satu format berikut:

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

Ditetapkan oleh server.

companyId

string (int64 format)

Hanya output. ID perusahaan. Ditetapkan oleh server.

companyName

string

Wajib diisi. Nama perusahaan. Misalnya XYZ Corp. Ditampilkan kepada karyawan perusahaan di portal pendaftaran zero-touch.

ownerEmails[]

string

Wajib diisi. Hanya input. Alamat email pengguna pelanggan dalam peran pemilik. Diperlukan minimal satu owner_email. Pemilik memiliki akses yang sama seperti admin, tetapi juga dapat menambahkan, menghapus, dan mengedit pengguna portal organisasi Anda.

adminEmails[]

string

Opsional. Alamat email pengguna pelanggan dalam peran admin. Setiap alamat email harus dikaitkan dengan Akun Google.

termsStatus

enum (TermsStatus)

Hanya output. Apakah pengguna dari perusahaan telah menyetujui Persyaratan Layanan (ToS) terbaru. Lihat TermsStatus.

skipWelcomeEmail

boolean

Hanya input. Jika disetel ke benar (true), email selamat datang tidak akan dikirim ke pelanggan. Sebaiknya lewati email selamat datang jika perangkat akan diklaim dengan layanan DEVICE_PROTECTION tambahan, karena pelanggan akan menerima email terpisah pada waktu klaim perangkat. Kolom ini diabaikan jika ini bukan pelanggan Zero-touch.

languageCode

string

Hanya input. Lokal pilihan pelanggan yang diwakili sebagai kode bahasa BCP47. Kolom ini divalidasi pada input dan permintaan yang berisi kode bahasa yang tidak didukung akan ditolak. K kepada

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Hanya output. Akun Google Workspace yang dikaitkan dengan pelanggan ini. Hanya digunakan untuk Perusahaan pelanggan.

StatusPersyaratan

Perusahaan menyetujui Persyaratan Layanan pendaftaran zero-touch (ToS). Satu pengguna dapat menyetujui ToS untuk perusahaannya menggunakan portal web.

ToS diberi versi. Artinya, ketika ToS berubah, setidaknya satu pengguna harus menyetujui ToS baru. Hingga pengguna pertama menyetujui ToS baru, status persyaratan perusahaan adalah TERMS_STATUS_STALE.

Enumerasi
TERMS_STATUS_NOT_ACCEPTED Tidak ada pengguna perusahaan yang menyetujui ToS.
TERMS_STATUS_ACCEPTED Satu (atau beberapa) pengguna perusahaan telah menyetujui ToS.
TERMS_STATUS_STALE Tidak satu pun pengguna perusahaan yang telah menyetujui ToS saat ini, tetapi setidaknya satu pengguna menyetujui ToS sebelumnya.

AkunGoogleWorkspace

Pelanggan Google Workspace.

Representasi JSON
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Kolom
customerId

string

Wajib diisi. ID pelanggan.

preProvisioningTokens[]

string

Hanya output. Token pra-penyediaan yang sebelumnya digunakan untuk mengklaim perangkat.

Metode

create

Membuat pelanggan untuk pendaftaran zero-touch.

list

Mencantumkan pelanggan yang terdaftar ke reseller yang diidentifikasi oleh argumen partnerId.