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 Google Workspace, cũng như thay đổi miền chính cho phiên bản 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à thêm mã thông báo uỷ quyền theo mô tả trong phần Uỷ quyền yêu cầu. customerKey có thể là customerId 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": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "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 một khách hàng hiện tại, hãy sử dụng yêu cầu PUT sau đây và thêm mã thông báo uỷ quyền được mô tả trong phần Uỷ quyền yêu cầu. customerKey có thể là customerId 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:

{
  "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"
}

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 PUT sau đây và thêm mã thông báo uỷ quyền như mô tả trong phần Uỷ quyền yêu cầu. customerKey phải là customerId hoặc my_customer duy nhất.

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": "yuri@example.com",
  "customerDomain": "example.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  }
}