REST Resource: customers

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

Khi tài khoản của khách hàng trên Google được đăng ký với đại lý, thì các gói thuê bao dịch vụ của Google của khách hàng 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)
  }
}
Các 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, tài sản 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. customerDomain là bắt buộc khi tạo khách hàng mới. Không bao gồm tiền tố www trong 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 "+" theo sau là mã quốc gia. Số còn lại có thể là số liền kề hoặc tuân theo quy ước định dạng cục bộ của điện thoại, nhưng phải là số điện thoại thực và không được là số ví dụ như "123". Trường này sẽ bị ngầm bỏ qua nếu không hợp lệ.
alternateEmail

string

Giống như "Email của khách hàng" trong công cụ dành cho người bán lại, email này là người liên hệ phụ được sử 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ư ngừng dịch vụ hoặc sự cố bảo mật. Thuộc tính này là bắt buộc khi tạo khách hàng mới "domain" và không được sử dụng cùng một miền với customerDomain. Trường alternateEmail không cần thiết để tạo "team" khách hàng.
resourceUiUrl

string

URL đến trang tổng quan Bảng điều khiển dành cho quản trị viên của khách hàng. Dịch vụ API tạo URL chỉ có thể đọc. Tệp này được dùng nếu ứng dụng của bạn yêu cầu khách hàng hoàn thành một thao tác 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ụ ý một khách hàng đã xác minh miền (mặc định).
  • team: Ngụ ý một khách hàng đã xác minh email.

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

object (PrimaryAdmin)

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

Address (Đị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
}
Các trường
countryCode

string

Để biết thông tin về countryCode, hãy xem các thành phần trong mã quốc gia theo tiêu chuẩn 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 bắt buộc 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ỉ của 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 địa chỉ 2.
locality

string

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

string

Dòng địa chỉ 3.
postalCode

string

Ví dụ postalCode là mã bưu chính của bưu điện, chẳng hạn như 94043. Bạn bắt buộc 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 của khách hàng. Một địa chỉ có thể bao gồm 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 tên bộ phận của công ty. Đây là thông tin bắt buộc.
contactName

string

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

Kiểu khách hàng

Kiểu khách hàng

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

Quản trị viên chính

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

Biểu diễn dưới dạng JSON 
{
  "primaryEmail": string
}
Các 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 email đượ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 khả năng mời và thanh toán người dùng và quản lý các nhu cầu quản trị của khách hàng.

Phương pháp

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 các chế độ cài đặt của tài khoản khách hàng.

update

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