Truy xuất & cập nhật thông tin tài khoản của khách hàng

Để truy xuất và cập nhật thông tin của khách hàng bằng Reseller API, bạn có thể tra cứu khách hàng theo một trong hai cách sau:

• Giá trị nhận dạng duy nhất của khách hàng, ví dụ: C0123456
• Tên miền của khách hàng, ví dụ: example.com

Truy xuất thông tin tài khoản của khách hàng

Để truy xuất thông tin tài khoản của khách hàng, hãy sử dụng yêu cầu GET sau đây và thêm mã thông báo uỷ quyền:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Thay thế CUSTOMER_ID bằng tên miền hoặc giá trị nhận dạng duy nhất của khách hàng.

Trả về phản hồi

Khi truy xuất thông tin tài khoản của khách hàng, bạn có thể nhận được một trong các phản hồi sau:

• Trả về toàn bộ chế độ cài đặt của khách hàng. Khách hàng là một trong những khách hàng hiện tại của bạn. Khi sử dụng API Đại lý, bạn có thể quản lý tài khoản và chế độ cài đặt gói thuê bao của khách hàng này.

• Trả về thông tin tối thiểu về tài khoản khách hàng. Nếu phản hồi chỉ trả về customerId, customerDomain và customerType, thì Google hoặc một đại lý khác sẽ quản lý khách hàng. Bạn không thể tạo một khách hàng khác được xác minh qua email cho khách hàng này. Để quản lý khách hàng này, hãy làm theo các bước sau:

  1. Truy xuất tất cả gói thuê bao có thể chuyển cho khách hàng để biết liệu có thể chuyển gói thuê bao hay không và số lượng ghế người dùng tối thiểu để chuyển.
  2. Chuyển gói thuê bao.

• Trả về Multiple teams exist on this domain. Miền này có một hoặc nhiều khách hàng theo nhóm được liên kết. Để thêm một nhóm khác vào miền này, hãy làm theo các bước sau:

  1. Đặt hàng tài khoản khách hàng.
  2. Để tạo một khách hàng đã xác minh miền cho miền đó, hãy yêu cầu khách hàng mua gói thuê bao trực tiếp qua Google và xác minh miền của họ, tiếp quản các nhóm hiện có, sau đó chuyển gói thuê bao đó sang tài khoản của bạn.

• Trả về lỗi HTTP 404. Khách hàng mới sử dụng Google và chưa có tài khoản. Để quản lý khách hàng này, hãy làm theo các bước sau:

  1. Xác nhận rằng hồ sơ khách hàng của bạn không chứa dữ liệu khách hàng cũ có thể không khớp với tên miền chính của khách hàng và giá trị nhận dạng khách hàng duy nhất của Google. Khi một Tài khoản Google đã xoá trước đó được khôi phục, tài khoản đó sẽ được coi là tài khoản mới và có giá trị customerId mới mặc dù tài khoản có thể giữ nguyên giá trị customerDomain.
  2. Đặt tài khoản khách hàng mới.
  3. Tạo gói thuê bao cho tài khoản khách hàng mới này.

Cập nhật chế độ cài đặt của khách hàng

Khi sử dụng Reseller API, bạn không thể cập nhật customerType nhưng có thể xác minh miền của khách hàng team và trở thành khách hàng domain.

Để cập nhật chế độ cài đặt của khách hàng, hãy sử dụng yêu cầu PUT sau đây và thêm mã nhận dạng duy nhất cho khách hàng:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Nội dung yêu cầu JSON sẽ cập nhật các chế độ cài đặt khách hàng sau:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Thay thế nội dung sau:

• DOMAIN_NAME: miền của khách hàng, ví dụ: example.com
• NAME: tên khách hàng của bạn, ví dụ: Alex Cruz.
• ORGANIZATION_NAME: tên tổ chức của khách hàng, ví dụ: Example Organization.
• POSTAL_CODE: mã bưu chính hoặc mã zip của khách hàng, ví dụ: 94043.
• COUNTRY_CODE: Mã quốc gia theo tiêu chuẩn ISO gồm 2 ký tự của khách hàng.
• EMAIL_ADDRESS: địa chỉ email của khách hàng, ví dụ: [e-mail].

Phản hồi JSON thành công sẽ trả về mã trạng thái HTTP 200 và chế độ cài đặt mới cập nhật của khách hàng:

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