REST Resource: partners.customers

Tài nguyên: Công ty

Đại lý, nhà cung cấp hoặc khách hàng trong API khách hàng và đại lý không tiếp xúc.

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)
  }
}
Các trường
name

string

Chỉ đầu ra. Tên tài nguyên API của công ty. Tên tài nguyên là 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ỉ đầu ra. Mã nhận dạng 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 đăng ký thiết lập tự động.

ownerEmails[]

string

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

adminEmails[]

string

Không bắt buộc. Địa chỉ email của người dùng của khách hàng có vai trò quản trị. 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ỉ đầu ra. Liệu người dùng của công ty có 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ỉ thiết bị vào. Nếu đặt thành đúng, email chào mừng sẽ không được gửi đến khách hàng. Bạn nên bỏ qua email chào mừng nếu thiết bị sẽ được xác nhận quyền sở hữu bằng dịch vụ THIẾT BỊ_DỮ LIỆU bổ sung, vì khách hàng sẽ nhận được email riêng vào thời điểm xác nhận quyền sở hữu thiết bị. Trường này sẽ bị bỏ qua nếu bạn không phải là khách hàng không chạm.

languageCode

string

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

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

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

Trạng thái

Sự chấp nhận của công ty đối với Điều khoản dịch vụ thiết lập tự động (ToS). Một người dùng có thể chấp nhận Điều khoản dịch vụ của công ty họ bằng cách sử dụng cổng thông tin web.

Điều khoản dịch vụ đã được tạo phiên bản. Điều này có nghĩa 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 này 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 Không 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 Không có người dùng nào của công ty chấp nhận Điều khoản dịch vụ hiện tại nhưng ít nhất một người dùng đã chấp nhận Điều khoản dịch vụ trước đó.

Tài khoản Google Workspace

Bạn là khách hàng Google Workspace.

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

string

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

preProvisioningTokens[]

string

Chỉ đầu ra. Các mã thông báo cấp phép trước dùng để xác nhận quyền sở hữu thiết bị.

Phương pháp

create

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

list

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