Để 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 dành cho người bán lại, bạn có một trong hai cách để tra cứu khách hàng:
- 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
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ã duy nhất của khách hàng của bạn
giá trị nhận dạng hoặc tên miền của bạn.
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 câu trả lờ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. Khi sử dụng API dành cho người bán lại, bạn có thể quản lý việc này chế độ cài đặt gói thuê bao và tài khoản của khách hàng.
Trả về thông tin tài khoản khách hàng tối thiểu. Nếu chỉ trả lời trả về
customerId
,customerDomain
vàcustomerType
, Google hoặc một đại lý khác quản lý khách hàng. Bạn không thể tạo một tài khoản khác xác minh bằng email cho khách hàng. Để quản lý khách hàng này, hãy làm theo các bước sau:- Truy xuất tất cả gói thuê bao có thể chuyển cho khách hàng nắm được liệu có thể chuyển gói thuê bao hay không và số lượng giấy phép người dùng tối thiểu để chuyển.
- 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 nhóm được liên kết. Để thêm một đội khác với miền này, hãy làm theo các bước sau:- Đặt hàng một tài khoản khách hàng.
- Để tạo một 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ó 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 này mới sử dụng Google và không có tài khoản. Để quản lý khách hàng này, hãy làm theo các bước sau:- Xác nhận rằng hồ sơ khách hàng của bạn không lưu giữ dữ liệu khách hàng cũ bằng
tên miền chính của khách hàng và tên duy nhất có thể không khớp
Mã nhận dạng khách hàng của Google. Khi một Tài khoản Google đã bị xoá trước đó
đã khôi phục thì tài khoản này sẽ được coi là một tài khoản mới và có
customerId
mới mặc dù tài khoản có thể giữ lại cùng mộtcustomerDomain
giá trị. - Đặt hàng một tài khoản khách hàng mới.
- Tạo gói thuê bao cho tài khoản khách hàng mới này.
- Xác nhận rằng hồ sơ khách hàng của bạn không lưu giữ dữ liệu khách hàng cũ bằng
tên miền chính của khách hàng và tên duy nhất có thể không khớp
Mã nhận dạng khách hàng của Google. Khi một Tài khoản Google đã bị xoá trước đó
đã khôi phục thì tài khoản này sẽ được coi là một tài khoản mới và có
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 cập nhật được 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 và thêm
giá trị nhận dạng riêng biệ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 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ế đoạn mã sau:
DOMAIN_NAME
: miền của khách hàng của bạn (ví dụ:example.com
NAME
: tên khách hàng của bạn (ví dụ:Alex Cruz
).ORGANIZATION_NAME
: tổ chức của khách hàng của bạn tên (ví dụ:Example Organization
).POSTAL_CODE
: mã ZIP hoặc mã bưu điện của khách hàng của bạn—cho ví dụ:94043
.COUNTRY_CODE
: 2 ký tự của khách hàng của bạn Mã quốc gia theo ISO.EMAIL_ADDRESS
: địa chỉ email của khách hàng của bạn—cho 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ài đặt 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" }