REST Resource: customers

Resource: Pelanggan

Jika akun pelanggan Google didaftarkan ke reseller, langganan pelanggan untuk layanan Google dikelola oleh reseller ini. Pelanggan dijelaskan dengan nama domain primer dan alamat fisik.

Representasi JSON
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Kolom
customerId

string

Properti ini akan selalu ditampilkan sebagai respons sebagai ID unik yang dibuat oleh Google. Dalam permintaan, properti ini dapat berupa domain primer atau ID unik yang dibuat oleh Google.

customerDomain

string

String nama domain primer pelanggan. customerDomain diperlukan saat membuat pelanggan baru. Jangan menyertakan awalan www di domain saat menambahkan pelanggan.

postalAddress

object (Address)

Informasi alamat pelanggan. Setiap isian memiliki batas 255 karakter.

phoneNumber

string

Nomor telepon kontak pelanggan. Harus diawali dengan "+" diikuti dengan kode negara. Nomor telepon lainnya dapat berupa angka berurutan atau mengikuti konvensi format lokal telepon, tetapi harus berupa nomor telepon sungguhan dan bukan, misalnya, "123". Kolom ini akan diabaikan secara diam-diam jika tidak valid.

alternateEmail

string

Seperti "Email pelanggan" di alat pengecer, email ini adalah kontak sekunder yang digunakan jika terjadi sesuatu pada layanan pelanggan seperti pemadaman layanan atau masalah keamanan. Properti ini wajib ada saat membuat "domain" baru pelanggan dan tidak boleh menggunakan domain yang sama dengan customerDomain. Kolom alternateEmail tidak diperlukan untuk membuat "tim" juga merupakan pelanggan Google Workspace.

resourceUiUrl

string

URL ke dasbor konsol Admin pelanggan. URL hanya-baca dibuat oleh layanan API. Jenis ini digunakan jika aplikasi klien mengharuskan pelanggan untuk menyelesaikan tugas di konsol Admin.

customerDomainVerified

boolean

Apakah domain primer pelanggan telah diverifikasi.

kind

string

Mengidentifikasi resource sebagai pelanggan. Nilai: reseller#customer

customerType

enum (CustomerType)

Mengidentifikasi jenis pelanggan. Nilai yang dapat diterima mencakup:

  • domain: Menyiratkan pelanggan yang diverifikasi domain (default).
  • team: Menunjukkan pelanggan yang diverifikasi email.

Untuk mengetahui informasi selengkapnya, lihat tim terkelola.

primaryAdmin

object (PrimaryAdmin)

Detail admin pertama pelanggan, yang ada dalam kasus pelanggan TIM.

Alamat

Template JSON untuk alamat pelanggan.

Representasi JSON
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Kolom
countryCode

string

Untuk mengetahui informasi tentang countryCode, lihat elemen kode negara ISO 3166. Pastikan negara tersebut disetujui untuk penjualan kembali produk Google. Properti ini diperlukan saat membuat pelanggan baru.

kind

string

Mengidentifikasi resource sebagai alamat pelanggan. Nilai: customers#address

region

string

Contoh nilai region adalah CA untuk negara bagian California.

addressLine2

string

Baris 2 alamat.

locality

string

Contoh nilai locality adalah kota San Francisco.

addressLine3

string

Baris 3 alamat.

postalCode

string

Contoh postalCode adalah kode pos seperti 94043. Properti ini diperlukan saat membuat pelanggan baru.

addressLine1

string

Alamat fisik pelanggan. Sebuah alamat dapat terdiri dari satu hingga tiga baris. addressline2 dan addressLine3 bersifat opsional.

organizationName

string

Nama divisi perusahaan atau perusahaan. Ini wajib diisi.

contactName

string

Nama kontak pelanggan. Ini wajib diisi.

CustomerType

Jenis pelanggan

Enum
customerTypeUnspecified Jenis pelanggan tidak diketahui
domain Pelanggan yang memiliki domain atau pemilik domain
team Pelanggan tanpa domain atau diverifikasi email

PrimaryAdmin

Template JSON untuk admin utama jika ada pelanggan TIM

Representasi JSON
{
  "primaryEmail": string
}
Kolom
primaryEmail

string

Email bisnis administrator utama pelanggan.

Tautan verifikasi email dikirimkan ke alamat email ini pada saat pembuatan pelanggan. Administrator utama memiliki akses ke Konsol Admin pelanggan, termasuk kemampuan untuk mengundang dan mengeluarkan pengguna serta mengelola kebutuhan administratif pelanggan.

Metode

get

Mendapatkan akun pelanggan.

insert

Memesan akun pelanggan baru.

patch

Memperbarui setelan akun pelanggan.

update

Memperbarui setelan akun pelanggan.