REST Resource: customers

Tài nguyên: Khách hàng

Khi tài khoản của khách hàng Google được đăng ký với một đại lý, các gói thuê bao của khách hàng đối với các dịch vụ của Google sẽ do đại lý này quản lý. Khách hàng được mô tả bằng tên miền chính và địa chỉ thực tế.

Biểu diễn dưới dạng JSON 
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Trường
customerId

string

Thuộc tính này sẽ luôn được trả về trong phản hồi dưới dạng giá trị nhận dạng duy nhất do Google tạo. Trong một yêu cầu, thuộc tính này có thể là miền chính hoặc giá trị nhận dạng duy nhất do Google tạo.
customerDomain

string

Chuỗi tên miền chính của khách hàng. Bạn phải có customerDomain khi tạo khách hàng mới. Không thêm tiền tố www vào miền khi thêm khách hàng.
postalAddress

object (Address)

Thông tin địa chỉ của khách hàng. Mỗi trường có giới hạn là 255 ký tự.
phoneNumber

string

Số điện thoại liên hệ của khách hàng. Phải bắt đầu bằng dấu "+", theo sau là mã quốc gia. Phần còn lại của số điện thoại có thể là các số liền nhau hoặc tuân theo quy ước định dạng số điện thoại địa phương, nhưng phải là số điện thoại thực chứ không phải "123" chẳng hạn. Trường này sẽ bị bỏ qua nếu không hợp lệ.
alternateEmail

string

Giống như "Email của khách hàng" trong các công cụ dành cho đại lý, email này là địa chỉ liên hệ phụ được dùng nếu có vấn đề xảy ra với dịch vụ của khách hàng, chẳng hạn như sự cố mất dịch vụ hoặc vấn đề bảo mật. Bạn phải có thuộc tính này khi tạo khách hàng "miền" mới và không được sử dụng cùng miền với customerDomain. Bạn không cần trường alternateEmail để tạo khách hàng "nhóm".
resourceUiUrl

string

URL đến trang tổng quan của Bảng điều khiển dành cho quản trị viên của khách hàng. URL chỉ có thể đọc do dịch vụ API tạo. Mã này được dùng nếu ứng dụng khách của bạn yêu cầu khách hàng hoàn tất một việc cần làm trong Bảng điều khiển dành cho quản trị viên.
customerDomainVerified

boolean

Liệu miền chính của khách hàng đã được xác minh hay chưa.
kind

string

Xác định tài nguyên là khách hàng. Giá trị: reseller#customer
customerType

enum (CustomerType)

Xác định loại khách hàng. Các giá trị được chấp nhận bao gồm:

  • domain: Ngụ ý khách hàng đã xác minh miền (mặc định).
  • team: Ngụ ý khách hàng được xác minh qua email.

Để biết thêm thông tin, hãy xem phần nhóm được quản lý.
primaryAdmin

object (PrimaryAdmin)

Thông tin chi tiết về quản trị viên đầu tiên của khách hàng, xuất hiện trong trường hợp khách hàng là NHÓM.

Địa chỉ

Mẫu JSON cho địa chỉ của khách hàng.

Biểu diễn dưới dạng JSON 
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Trường
countryCode

string

Để biết thông tin về countryCode, hãy xem các phần tử mã quốc gia ISO 3166. Xác minh rằng quốc gia đó được phê duyệt để bán lại các sản phẩm của Google. Bạn phải sử dụng thuộc tính này khi tạo khách hàng mới.
kind

string

Xác định tài nguyên là địa chỉ khách hàng. Giá trị: customers#address
region

string

Ví dụ về giá trị region là CA cho tiểu bang California.
addressLine2

string

Dòng 2 của địa chỉ.
locality

string

Ví dụ về giá trị locality là thành phố San Francisco.
addressLine3

string

Dòng 3 của địa chỉ.
postalCode

string

Ví dụ về postalCode là mã zip bưu chính, chẳng hạn như 94043. Bạn phải sử dụng thuộc tính này khi tạo khách hàng mới.
addressLine1

string

Địa chỉ thực tế của khách hàng. Địa chỉ có thể bao gồm từ một đến ba dòng. addressline2 và addressLine3 là không bắt buộc.
organizationName

string

Tên công ty hoặc bộ phận công ty. Đây là thông tin bắt buộc.
contactName

string

Tên người liên hệ của khách hàng. Đây là thông tin bắt buộc.

CustomerType

Loại khách hàng

Enum
customerTypeUnspecified Không xác định được loại khách hàng
domain Khách hàng có miền hoặc sở hữu miền
team Khách hàng không có miền hoặc đã xác minh qua email

PrimaryAdmin

Mẫu JSON cho quản trị viên chính trong trường hợp khách hàng là Nhóm

Biểu diễn dưới dạng JSON 
{
  "primaryEmail": string
}
Trường
primaryEmail

string

Email doanh nghiệp của quản trị viên chính của khách hàng.

Đường liên kết xác minh qua email sẽ được gửi đến địa chỉ email này tại thời điểm tạo khách hàng. Quản trị viên chính có quyền truy cập vào Bảng điều khiển dành cho quản trị viên của khách hàng, bao gồm cả quyền mời và xoá người dùng cũng như quản lý các nhu cầu quản trị của khách hàng.

Phương thức

get

 Lấy tài khoản khách hàng.

insert

 Đặt hàng tài khoản của khách hàng mới.

patch

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

update

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