REST Resource: schemas

Tài nguyên: Giản đồ

Loại tài nguyên API. Đối với các tài nguyên Giản đồ, giá trị này luôn là admin#directory#schema.

Biểu diễn dưới dạng JSON 
{
  "schemaId": string,
  "schemaName": string,
  "fields": [
    {
      object (SchemaFieldSpec)
    }
  ],
  "displayName": string,
  "kind": string,
  "etag": string
}
Trường
schemaId

string

Giá trị nhận dạng duy nhất của giản đồ (Chỉ đọc)
schemaName

string

Tên của giản đồ.

Mỗi schemaName phải là duy nhất trong một khách hàng. Việc sử dụng lại tên sẽ dẫn đến lỗi 409: Entity already exists.
fields[]

object (SchemaFieldSpec)

Danh sách các trường trong giản đồ.
displayName

string

Tên hiển thị cho giản đồ.
kind

string

Đó là một loại tài nguyên.
etag

string

ETag của tài nguyên.

SchemaFieldSpec

Bạn có thể sử dụng giản đồ để thêm các trường tuỳ chỉnh vào hồ sơ người dùng. Bạn có thể sử dụng các trường này để lưu trữ thông tin, chẳng hạn như dự án mà người dùng đang làm, vị trí thực tế, ngày tuyển dụng của họ hoặc bất kỳ thông tin nào khác phù hợp với nhu cầu kinh doanh của bạn. Để biết thêm thông tin, hãy xem bài viết Trường người dùng tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "fieldName": string,
  "fieldId": string,
  "fieldType": string,
  "multiValued": boolean,
  "kind": string,
  "etag": string,
  "indexed": boolean,
  "displayName": string,
  "readAccessType": string,
  "numericIndexingSpec": {
    "minValue": number,
    "maxValue": number
  }
}
Trường
fieldName

string

Tên của trường.
fieldId

string

Giá trị nhận dạng duy nhất của trường (Chỉ đọc)
fieldType

string

Loại trường.

Các giá trị được chấp nhận là:

  • BOOL: Giá trị boolean
  • DATE: Ngày ở định dạng ISO-8601.
  • DOUBLE: Giá trị dấu phẩy động có độ chính xác gấp đôi.
  • EMAIL: Địa chỉ email.
  • INT64: Giá trị số nguyên 64 bit.
  • PHONE: Số điện thoại.
  • STRING: Giá trị chuỗi.
multiValued

boolean

Giá trị boolean chỉ định liệu đây có phải là trường nhiều giá trị hay không. Mặc định: false.
kind

string

Loại tài nguyên này là. Đối với các trường giản đồ, giá trị này luôn là admin#directory#schema#fieldspec.
etag

string

ETag của trường.
indexed

boolean

Giá trị boolean chỉ định liệu trường có được lập chỉ mục hay không. Mặc định: true.
displayName

string

Tên hiển thị của trường.
readAccessType

string

Chỉ định người có thể xem các giá trị của trường này. Xem Truy xuất người dùng dưới dạng không phải quản trị viên để biết thêm thông tin.

Lưu ý: Có thể mất tối đa 24 giờ để các thay đổi đối với trường này được phản ánh.

Các giá trị được chấp nhận là:

  • ADMINS_AND_SELF: Chỉ quản trị viên và người dùng được liên kết mới có thể xem giá trị.
  • ALL_DOMAIN_USERS: Mọi người dùng trong miền của bạn đều có thể thấy các giá trị.
numericIndexingSpec

object

Thông số lập chỉ mục cho trường số. Theo mặc định, chỉ những truy vấn khớp chính xác mới được hỗ trợ cho trường số. Việc đặt numericIndexingSpec sẽ cho phép hỗ trợ các truy vấn phạm vi.
numericIndexingSpec.minValue

number

Giá trị tối thiểu của trường này. Quy định này nhằm mục đích cung cấp thông tin chứ không phải để thực thi. Các giá trị không nằm trong phạm vi này vẫn sẽ được lập chỉ mục nhưng kết quả tìm kiếm có thể không đạt hiệu suất như mong đợi.
numericIndexingSpec.maxValue

number

Giá trị tối đa của trường này. Quy định này nhằm mục đích cung cấp thông tin chứ không phải để thực thi. Các giá trị không nằm trong phạm vi này vẫn sẽ được lập chỉ mục nhưng kết quả tìm kiếm có thể không đạt hiệu suất như mong đợi.

Phương thức

delete

 Xoá một giản đồ.

get

 Truy xuất giản đồ.

insert

 Tạo một giản đồ.

list

 Truy xuất tất cả giản đồ cho một khách hàng.

patch

 Vá một giản đồ.

update

 Cập nhật giản đồ.