Mengambil & memperbarui informasi akun pelanggan

Untuk mengambil dan memperbarui informasi pelanggan menggunakan Reseller API, Anda dapat mencari pelanggan dengan salah satu dari dua cara berikut:

• 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 ID unik atau nama domain pelanggan.

Respons yang ditampilkan

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

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

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

  1. Ambil semua langganan yang dapat ditransfer untuk pelanggan guna memahami kemampuan transfer dan jumlah minimum kursi pengguna.
  2. Transfer 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. Pesan akun pelanggan.
  2. Untuk membuat pelanggan yang diverifikasi domain, minta pelanggan untuk membeli langganan langsung dan memverifikasi domainnya, lalu transfer langganan tersebut.

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

  1. Pastikan catatan Anda tidak memiliki data pelanggan lama dengan ketidakcocokan antara nama domain utama dan ID pelanggan Google yang unik. Saat akun yang dihapus dipulihkan, akun tersebut akan diperlakukan sebagai akun baru dengan customerId baru.
  2. Pesan akun pelanggan baru.
  3. Buat langganan untuk akun pelanggan baru.

Memperbarui setelan pelanggan

Dengan menggunakan Reseller API, Anda tidak dapat memperbarui customerType, tetapi Anda dapat memverifikasi domain pelanggan team agar 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—misalnya, example.com.
• NAME: Nama pelanggan—misalnya, Alex Cruz.
• ORGANIZATION_NAME: Nama organisasi pelanggan—misalnya, Example Organization.
• POSTAL_CODE: Kode pos pelanggan—misalnya, 94043.
• COUNTRY_CODE: Kode negara ISO 2 karakter pelanggan.
• EMAIL_ADDRESS: Alamat email pelanggan—misalnya, [e-mail].

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

{
  "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"
}