REST Resource: customers

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

Khi khách hàng Google đăng ký tài khoản của mình với đại lý, thì 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ả qua 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

Tài sản này sẽ luôn được trả về 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. Bạn phải nhập customerDomain khi tạo khách hàng mới. Đừ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ố có thể là các số liền nhau hoặc tuân theo quy ước định dạng địa phương của số điện thoại, nhưng đó phải là số điện thoại thực chứ không phải số điện thoại, ví dụ: "123". Trường này sẽ tự động bị bỏ qua nếu không hợp lệ.

alternateEmail

string

Chẳng hạn như "Email của khách hàng" trong các công cụ dành cho người bán lại, email này là địa chỉ liên hệ phụ được sử dụng nếu có vấn đề gì xảy ra với dịch vụ của khách hàng như ngừng dịch vụ hoặc sự cố bảo mật. Bạn phải cung cấp thuộc tính này khi tạo một "miền" mới khách hàng của bạn và không được sử dụng cùng một miền với customerDomain. Bạn không cần sử dụng trường alternateEmail để tạo một "nhóm" 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. URL chỉ đọc do dịch vụ API tạo. Tính năng 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 tác vụ 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 kiểu khách hàng. Các giá trị được chấp nhận bao gồm:

  • domain: Ngụ ý rằng khách hàng được xác minh bằng miền (mặc định).
  • team: Ngụ ý khách hàng được xác minh bằng 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, được cung cấp trong trường hợp khách hàng team.

Đị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 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 cung cấp 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ị regionCA cho tiểu bang California.

addressLine2

string

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

locality

string

Một ví dụ về giá trị locality là thành phố San Francisco.

addressLine3

string

Dòng địa chỉ 3.

postalCode

string

Ví dụ về postalCode là mã bưu chính, chẳng hạn như 94043. Bạn phải cung cấp 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. Một địa chỉ có thể bao gồm từ 1 đến 3 dòng. addressline2addressLine3 là không bắt buộc.

organizationName

string

Tên công ty hoặc bộ phận của 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 theo miền hoặc sở hữu theo miền
team Khách hàng không có miền hoặc được xác minh bằng email

PrimaryAdmin

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

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 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 cả khả năng mời và loại bỏ người dùng, đồng thời quản lý các nhu cầu quản trị của khách hàng.

Phương thức

get

Nhận tài khoản khách hàng.

insert

Đặt hàng bằ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.