Mengambil & memperbarui informasi akun pelanggan

Untuk mengambil dan memperbarui informasi pelanggan menggunakan Reseller API, Anda memiliki salah satu dari dua cara untuk mencari pelanggan Anda:

• ID unik pelanggan—misalnya, C0123456
• Nama domain pelanggan—misalnya, example.com

Mengambil informasi akun pelanggan

Untuk mengambil informasi akun pelanggan, gunakan permintaan GET berikut dan sertakan token otorisasi:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Ganti CUSTOMER_ID dengan unik pelanggan Anda atau nama domain.

Respons yang ditampilkan

Saat Anda mengambil informasi akun pelanggan, Anda mungkin menerima salah satu tanggapan berikut:

• Menampilkan setelan pelanggan lengkap. Pelanggan adalah salah satu pelanggan yang sudah ada. Dengan menggunakan Reseller API, Anda dapat mengelola setelan langganan dan akun pelanggan.

• Menampilkan informasi akun pelanggan minimal. Jika jawaban hanya menampilkan customerId, customerDomain, dan customerType, Google atau reseller lain mengelola pelanggan. Anda tidak dapat membuat yang lain pelanggan yang diverifikasi email untuk pelanggan tersebut. Untuk mengelola pelanggan ini, ikuti langkah-langkah berikut:

  1. Mengambil semua langganan yang dapat ditransfer untuk pelanggan untuk memahami apakah langganan dapat ditransfer dan jumlah minimum slot pengguna untuk transfer.
  2. Mentransfer langganan.

• Menampilkan Multiple teams exist on this domain. Domain ini memiliki satu atau beberapa pelanggan tim yang terkait dengannya. Untuk menambahkan tim lain ke domain ini, ikuti langkah-langkah berikut:

  1. Memesan akun pelanggan.
  2. Agar dapat membuat pelanggan yang diverifikasi domain untuk domain, minta pelanggan untuk melakukannya membeli langganan langsung melalui Google dan memverifikasi domain, mengambil alih tim yang ada Lalu mentransfer langganan ke akun Anda.

• Menampilkan error 404 HTTP. Pelanggan baru di Google dan belum memiliki akun. Untuk mengelola pelanggan ini, ikuti langkah-langkah berikut:

  1. Konfirmasikan bahwa catatan pelanggan Anda tidak menyimpan data pelanggan lama dengan potensi ketidakcocokan antara nama domain primer pelanggan dan ID pelanggan Google. Jika akun Google yang sebelumnya dihapus diaktifkan kembali, akun tersebut diperlakukan sebagai akun baru dan memiliki customerId baru meskipun akun mungkin mempertahankan customerDomain yang sama dengan sejumlah nilai.
  2. Memesan akun pelanggan baru.
  3. Membuat langganan untuk akun pelanggan baru ini.

Memperbarui setelan pelanggan

Dengan menggunakan Reseller API, Anda tidak dapat memperbarui customerType, tetapi Anda dapat memverifikasi domain pelanggan team dan menjadi pelanggan domain.

Untuk memperbarui setelan pelanggan, gunakan permintaan PUT berikut dan sertakan ID unik untuk pelanggan Anda:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Isi permintaan JSON memperbarui setelan pelanggan berikut:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Ganti kode berikut:

• DOMAIN_NAME: domain pelanggan Anda—misalnya, example.com
• NAME: nama pelanggan Anda—misalnya, Alex Cruz.
• ORGANIZATION_NAME: organisasi pelanggan Anda nama—misalnya, Example Organization.
• POSTAL_CODE: kode pos pelanggan Anda—untuk contoh, 94043.
• COUNTRY_CODE: 2 karakter pelanggan Anda Kode negara ISO.
• EMAIL_ADDRESS: alamat email pelanggan Anda—untuk contoh, [e-mail].

Respons JSON yang berhasil akan menampilkan kode status HTTP 200 dan kode status terbaru setelan pelanggan:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}