Trang này được dịch bởi Cloud Translation API.

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 cách sử dụng API đại lý, bạn có thể tra cứu khách hàng theo một trong hai cách sau đây:

Mã 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à bao gồ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 duy nhất hoặc tên miền của khách hàng.

Trả về câu trả lờ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ề chế độ cài đặt đầy đủ 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. Sử dụng API Đại lý, bạn có thể quản lý chế độ cài đặt tài khoản và gói thuê bao của khách hàng này.
Trả về thông tin tài khoản khách hàng tối thiểu. 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 cho khách hàng để tìm hiểu xem gói thuê bao có thể chuyển được hay không và số giấy phép 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 liên kết với một hoặc nhiều khách hàng theo nhóm. Để 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 cho tài khoản khách hàng.
2. Để tạo khách hàng được xác minh bằng 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 chứa dữ liệu khách hàng cũ do tên miền chính của khách hàng có khả năng không khớp với 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ữ lại cùng một 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 API Đại lý, 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 duy nhất cho khách hàng của bạn:

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

Nội dung yêu cầu JSON cập nhật các chế độ cài đặt sau đây cho 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ế các đoạn mã 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ã ZIP hoặc mã bưu chính của khách hàng, ví dụ: 94043.
COUNTRY_CODE: mã quốc gia ISO gồm 2 ký tự của khách hàng của bạn.
EMAIL_ADDRESS: địa chỉ email của khách hàng – ví dụ: cruz@example.com.

Phản hồi JSON thành công sẽ trả về mã trạng thái HTTP 200 và các chế độ cài đặt khách hàng được 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"
}