REST Resource: partners.customers

Resource: Perusahaan

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

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. Nama perusahaan. Misalnya XYZ Corp. Ditampilkan kepada karyawan perusahaan di portal pendaftaran zero-touch.

ownerEmails[]

string

Wajib. Input saja. Alamat email pengguna pelanggan dalam peran pemilik. Setidaknya satu owner_email diperlukan. 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 ada pengguna dari perusahaan yang telah menyetujui Persyaratan Layanan (ToS) terbaru. Lihat TermsStatus.

skipWelcomeEmail

boolean

Input saja. Jika disetel ke benar (true), email selamat datang tidak akan dikirim ke pelanggan. Sebaiknya lewati email sambutan ini 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

Input saja. Lokal pilihan pelanggan direpresentasikan sebagai kode bahasa BCP47. Kolom ini divalidasi pada input dan permintaan yang berisi kode bahasa yang tidak didukung akan ditolak. Kode bahasa yang didukung: Arab.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

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

TermsStatus

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

ToS memiliki beberapa versi. Artinya, saat ToS berubah, setidaknya satu pengguna harus menyetujui ToS baru. Sebelum pengguna pertama menyetujui ToS baru, status persyaratan perusahaannya adalah TERMS_STATUS_STALE.

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

GoogleWorkspaceAccount

Pelanggan Google Workspace.

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

string

Wajib. ID pelanggan.

preProvisioningTokens[]

string

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

Metode

create

Membuat pelanggan untuk pendaftaran zero-touch.

list

Menampilkan daftar pelanggan yang terdaftar ke reseller yang diidentifikasi oleh argumen partnerId.