Mengambil & memperbarui informasi akun pelanggan

Untuk mengambil dan memperbarui informasi pelanggan menggunakan Reseller API, Anda memiliki salah satu dari 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 ID unik atau nama domain pelanggan Anda.

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 lama Anda. Dengan Reseller API, Anda dapat mengelola akun dan setelan langganan pelanggan ini.

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

    1. Ambil semua langganan yang dapat ditransfer untuk pelanggan guna 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. 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 404 HTTP. Pelanggan baru menggunakan Google dan tidak memiliki akun. Untuk mengelola pelanggan ini, ikuti langkah-langkah berikut:

    1. Pastikan data pelanggan Anda tidak menyimpan data pelanggan lama dengan potensi ketidakcocokan nama domain utama pelanggan dan ID pelanggan Google yang unik. Jika Akun Google yang sebelumnya dihapus diaktifkan kembali, akun tersebut akan 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 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 pos pelanggan Anda—misalnya, 94043.
  • COUNTRY_CODE: Kode negara ISO 2 karakter milik pelanggan Anda.
  • EMAIL_ADDRESS: alamat email pelanggan Anda—misalnya, cruz@example.com.

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