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 riêng biệ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 mã nhận dạng riêng biệt hoặc tên miền 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. Bằng cách sử dụng Reseller API, 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 đã xác minh bằng 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ả các gói thuê bao có thể chuyển nhượng cho khách hàng để biết liệu gói thuê bao có thể chuyển nhượng hay không và số lượng tối thiểu giấy phép người dùng để chuyển nhượng.
  2. Chuyển gói thuê bao.

• Trả lại 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. Sắp xếp 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ó rồi 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 lưu giữ dữ liệu cũ của khách hàng có khả năng không khớp giữa 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 đã bị xoá trước đó được khôi phục, tài khoản đó sẽ được coi là một tài khoản mới và có giá trị customerId mới, ngay cả khi tài khoản đó có thể giữ nguyên giá trị customerDomain.
  2. Đặt hàng 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 giá trị nhận dạng riêng biệ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 sau đây của khách hàng:

{
  "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 của khách hàng – 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 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 khách hàng đã cập nhật:

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