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

Bạn có thể sử dụng API Directory để quản lý khách hàng của mình 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ủa bạn, 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 khách hàng hiện tại, hãy sử dụng yêu cầu HTTP GET sau đây và thêm mã thông báo uỷ quyền được mô tả trong phần 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à bao gồm mã thông báo 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 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à thêm mã thông báo uỷ quyền được mô tả trong phần yêu cầu cấp 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 còn 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"
}