Directory API: Quản lý khách hàng

Bạn có thể sử dụng Directory API để quản lý khách hàng theo phương thức lập trình. Các phương thức trong API này cho phép bạn cập nhật thông tin liên hệ trên miền G Suite, cũng như thay đổi miền chính cho thực thể của bạn.

Truy xuất khách hàng

Để truy xuất một khách hàng hiện tại, hãy sử dụng yêu cầu HTTP GET sau đây và đưa mã uỷ quyền được mô tả trong yêu cầu uỷ quyền. customerKey có thể là mã khách hàng duy nhất hoặc my_customer để cho biết khách hàng hiện tại.

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

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi JSON bao gồm thông tin của khách hàng:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Cập nhật khách hàng hiện tại

Để cập nhật khách hàng hiện tại, hãy sử dụng yêu cầu HTTP PUT sau đây và đưa mã uỷ quyền được mô tả trong yêu cầu uỷ quyền. customerKey có thể là mã khách hàng duy nhất của khách hàng hoặc my_customer để cho biết khách hàng hiện tại.

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

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi JSON bao gồm thông tin khách hàng mới cập nhật:

{
  "alternateEmail": "marty.mcfly@gmail.com",
  "customerDomain": "amatchmadeinspace.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi JSON bao gồm thông tin của khách hàng:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Thay đổi tên miền chính của khách hàng

Để thay đổi miền chính của khách hàng, hãy sử dụng yêu cầu HTTP PUT sau đây và đưa mã thông báo uỷ quyền được mô tả trong phần yêu cầu uỷ quyền. customerKey phải là mã khách hàng duy nhất hoặc my_customer.

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

Nội dung yêu cầu JSON phải bao gồm giá trị customerDomain mới:

{
  "alternateEmail": "marty.mcfly@gmail.com",
  "customerDomain": "fluxcapacitor.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi JSON bao gồm thông tin của khách hàng:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "fluxcapacitor.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}