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

Respons 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, Google atau reseller lain mengelola pelanggan. Anda tidak dapat membuat pelanggan terverifikasi email lain untuknya. Untuk mengelola pelanggan ini, ikuti langkah-langkah berikut:

    1. Ambil semua langganan yang dapat ditransfer untuk pelanggan untuk memahami kemampuan transfer dan jumlah minimum kursi pengguna.
    2. Mentransfer langganan.

  • Pengembalian 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 mentransfer langganan.

  • Menampilkan error HTTP 404: Pelanggan baru di 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. Jika akun yang dihapus diaktifkan kembali, akun tersebut akan dianggap sebagai akun baru dengan customerId baru.
    2. Pesan akun pelanggan baru.
    3. Buat langganan untuk akun pelanggan baru.

Memperbarui setelan pelanggan

Dengan Reseller API, Anda tidak dapat memperbarui customerType, tetapi Anda dapat memverifikasi domain pelanggan team untuk 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: 2 karakter kode negara ISO pelanggan.
  • EMAIL_ADDRESS: Alamat email pelanggan—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"
}