Mengambil & memperbarui informasi akun pelanggan

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

Hasil respons

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

  • Menampilkan setelan lengkap pelanggan. Pelanggan adalah salah satu pelanggan lama Anda. Dengan Reseller API, Anda dapat mengelola setelan langganan dan akun pelanggan ini.

  • Menampilkan informasi akun pelanggan minimal. Jika respons hanya menampilkan customerId, customerDomain, dan customerType, berarti 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 untuk memahami apakah langganan dapat ditransfer dan jumlah minimum slot pengguna untuk transfer atau tidak.
    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. Memesan akun pelanggan.
    2. Agar dapat membuat pelanggan yang diverifikasi domain untuk domain, minta pelanggan membeli langganan langsung melalui Google dan memverifikasi domainnya, mengambil alih tim yang ada, lalu mentransfer langganan ke akun Anda.

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

    1. Pastikan data pelanggan Anda tidak menyimpan data pelanggan lama, dengan potensi ketidakcocokan antara nama domain primer 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 dapat 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 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"
}