Directory API: Mengelola Pelanggan

Anda dapat menggunakan Directory API untuk mengelola pelanggan secara terprogram. Metode dalam API ini memungkinkan Anda memperbarui informasi kontak di domain Google Workspace, serta mengubah domain utama untuk instance Anda.

Mengambil Pelanggan

Untuk mengambil pelanggan yang sudah ada, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam Mengotorisasi permintaan. customerKey dapat berupa customerId atau my_customer unik untuk menunjukkan pelanggan saat ini.

GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Respons yang berhasil akan menampilkan kode status HTTP 200. Selain kode status, respons JSON mencakup informasi pelanggan:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Memperbarui pelanggan lama

Untuk memperbarui pelanggan yang ada, gunakan permintaan PUT berikut dan sertakan token otorisasi yang dijelaskan dalam Permintaan otorisasi. customerKey dapat berupa customerId unik pelanggan, atau my_customer untuk menunjukkan pelanggan saat ini.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Respons yang berhasil akan menampilkan kode status HTTP 200. Selain kode status, respons JSON mencakup informasi pelanggan yang baru diperbarui:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Mengubah nama domain primer pelanggan

Untuk mengubah domain utama pelanggan, gunakan permintaan PUT berikut dan sertakan token otorisasi yang dijelaskan dalam Mengotorisasi permintaan. customerKey harus berupa customerId, atau my_customer yang unik.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Isi permintaan JSON harus menyertakan nilai customerDomain baru:

{
  "alternateEmail": "yuri@example.com",
  "customerDomain": "example.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  }
}