Mengambil & memperbarui informasi akun pelanggan

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

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

Respons yang ditampilkan

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

• Menampilkan setelan pelanggan lengkap. Pelanggan adalah salah satu pelanggan lama Anda. 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 terverifikasi email lain 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 kursi 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. Pesan akun pelanggan.
  2. Untuk membuat pelanggan yang diverifikasi domain untuk domain tersebut, minta pelanggan untuk membeli langganan langsung melalui Google dan memverifikasi domain mereka, mengambil alih tim yang ada lalu mentransfer langganan ke akun Anda.

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

  1. Pastikan bahwa catatan pelanggan Anda tidak menyimpan data pelanggan lama dengan potensi ketidakcocokan nama domain utama pelanggan dan ID pelanggan Google yang unik. Saat Akun Google yang sebelumnya dihapus diaktifkan kembali, akun tersebut diperlakukan sebagai akun baru dan memiliki nilai customerId baru meskipun akun tersebut mungkin mempertahankan nilai customerDomain yang sama.
  2. Pesan akun pelanggan baru.
  3. Buat 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: nama organisasi pelanggan Anda—misalnya, Example Organization.
• POSTAL_CODE: kode ZIP atau kode pos pelanggan Anda—misalnya, 94043.
• COUNTRY_CODE: 2 karakter kode negara ISO pelanggan Anda.
• EMAIL_ADDRESS: alamat email pelanggan Anda—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"
}