REST Resource: partners.customers

Nguồn lực: Công ty

Đại lý, nhà cung cấp hoặc khách hàng trong API khách hàng và đại lý tự động đăng ký.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên API của công ty. Tên tài nguyên có một trong các định dạng sau:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

Do máy chủ chỉ định.

companyId

string (int64 format)

Chỉ có đầu ra. Mã của công ty. Do máy chủ chỉ định.

companyName

string

Bắt buộc. Tên của công ty. Ví dụ: XYZ Corp. Hiển thị cho nhân viên của công ty trong cổng thiết lập tự động.

ownerEmails[]

string

Bắt buộc. Chỉ nhập. Địa chỉ email của người dùng trong vai trò chủ sở hữu của khách hàng. Phải có ít nhất một owner_email. Chủ sở hữu có quyền truy cập giống như quản trị viên nhưng cũng có thể thêm, xoá và chỉnh sửa người dùng cổng thông tin của tổ chức.

adminEmails[]

string

Không bắt buộc. Địa chỉ email của người dùng trong vai trò quản trị viên của khách hàng. Mỗi địa chỉ email phải được liên kết với một Tài khoản Google.

termsStatus

enum (TermsStatus)

Chỉ có đầu ra. Có người dùng nào của công ty đã chấp nhận Điều khoản dịch vụ (ToS) mới nhất hay không. Vui lòng xem TermsStatus.

skipWelcomeEmail

boolean

Chỉ nhập. Nếu bạn đặt chính sách này thành true, thì email chào mừng sẽ không được gửi cho khách hàng. Bạn nên bỏ qua email chào mừng nếu thiết bị được xác nhận quyền sở hữu thông qua dịch vụDEVICE_PROTECTION bổ sung, vì khách hàng sẽ nhận được email riêng vào thời điểm xác nhận thiết bị. Trường này sẽ bị bỏ qua nếu đây không phải là Khách hàng tự động đăng ký.

languageCode

string

Chỉ nhập. Ngôn ngữ ưu tiên của khách hàng đại diện dưới dạng mã ngôn ngữ BCP47. Trường này được xác thực khi nhập dữ liệu và yêu cầu chứa mã ngôn ngữ không được hỗ trợ sẽ bị từ chối.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Chỉ có đầu ra. Tài khoản Google Workspace liên kết với khách hàng này. Chỉ sử dụng cho Công ty của khách hàng.

TermsStatus

Việc một công ty chấp nhận Điều khoản dịch vụ (ToS) của quy trình thiết lập tự động. Người dùng riêng lẻ có thể chấp nhận Điều khoản dịch vụ cho công ty của họ qua cổng thông tin web.

Điều khoản dịch vụ có nhiều phiên bản. Tức là khi Điều khoản dịch vụ thay đổi, ít nhất một người dùng phải chấp nhận Điều khoản dịch vụ mới. Trạng thái điều khoản của công ty sẽ là TERMS_STATUS_STALE cho đến khi người dùng đầu tiên chấp nhận Điều khoản dịch vụ mới.

Enum
TERMS_STATUS_NOT_ACCEPTED Chưa có người dùng nào của công ty chấp nhận Điều khoản dịch vụ.
TERMS_STATUS_ACCEPTED Một (hoặc nhiều) người dùng của công ty đã chấp nhận Điều khoản dịch vụ.
TERMS_STATUS_STALE Người dùng của công ty chưa chấp nhận Điều khoản dịch vụ hiện tại, nhưng có ít nhất một người dùng chấp nhận Điều khoản dịch vụ trước đó.

GoogleWorkspaceAccount

Khách hàng Google Workspace.

Biểu diễn dưới dạng JSON
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Trường
customerId

string

Bắt buộc. Mã khách hàng.

preProvisioningTokens[]

string

Chỉ có đầu ra. Mã thông báo cấp phép trước dùng trước đây để xác nhận thiết bị.

Phương thức

create

Tạo khách hàng để thiết lập tự động.

list

Liệt kê những khách hàng đã đăng ký đại lý được xác định bằng đối số partnerId.