REST Resource: schemas

資源：結構定義

API 資源的類型。對結構定義資源而言，這個項目一律為 admin#directory#schema。

JSON 表示法 
{
  "schemaId": string,
  "schemaName": string,
  "fields": [
    {
      object (SchemaFieldSpec)
    }
  ],
  "displayName": string,
  "kind": string,
  "etag": string
}
欄位
schemaId

string

結構定義的專屬 ID (唯讀)
schemaName

string

結構定義的名稱。

每個 schemaName 在客戶中都必須是唯一的。重複使用名稱會導致 409: Entity already exists 錯誤。
fields[]

object (SchemaFieldSpec)

結構定義中的欄位清單。
displayName

string

結構定義的顯示名稱。
kind

string

資源的類型。
etag

string

資源的 ETag。

SchemaFieldSpec

您可以使用結構定義，在使用者設定檔中新增自訂欄位。您可以使用這些欄位儲存資訊，例如使用者所從事的專案、實際位置、聘用日期，或其他符合業務需求的資訊。詳情請參閱「自訂使用者欄位」。

JSON 表示法 
{
  "fieldName": string,
  "fieldId": string,
  "fieldType": string,
  "multiValued": boolean,
  "kind": string,
  "etag": string,
  "indexed": boolean,
  "displayName": string,
  "readAccessType": string,
  "numericIndexingSpec": {
    "minValue": number,
    "maxValue": number
  }
}
欄位
fieldName

string

欄位名稱。
fieldId

string

欄位的專屬 ID (唯讀)
fieldType

string

欄位的類型。

可接受的值如下：

  • BOOL：布林值。
  • DATE：日期，格式為 ISO-8601。
  • DOUBLE：雙精度浮點值。
  • EMAIL：電子郵件地址。
  • INT64：64 位元整數值。
  • PHONE：電話號碼。
  • STRING：字串值。
multiValued

boolean

布林值，指出此欄位是否為多值欄位。預設值：false。
kind

string

這個項目的資源類型。對結構定義欄位而言，這個項目一律為 admin#directory#schema#fieldspec。
etag

string

欄位的 ETag。
indexed

boolean

布林值，指出是否已為欄位建立索引。預設值：true。
displayName

string

欄位的顯示名稱。
readAccessType

string

指定哪些使用者可以查看這個欄位的值。詳情請參閱「以非管理員身分擷取使用者資料」。

注意：這個欄位的變更最多可能需要 24 小時才會生效。

可接受的值如下：

  • ADMINS_AND_SELF：只有管理員和相關使用者可以查看值。
  • ALL_DOMAIN_USERS：網域內的任何使用者都可以查看值。
numericIndexingSpec

object

數值欄位的索引規格。根據預設，系統僅支援數值欄位的完全比對查詢。設定 numericIndexingSpec 可支援範圍查詢。
numericIndexingSpec.minValue

number

這個欄位的最小值。這項規定僅供參考，並非強制規定。系統仍會為超出這個範圍的值建立索引，但搜尋功能的效能可能會降低。
numericIndexingSpec.maxValue

number

這個欄位的最大值。這項規定僅供參考，並非強制規定。系統仍會為超出這個範圍的值建立索引，但搜尋功能的效能可能會降低。

方法

delete

 刪除結構定義。

get

 擷取結構定義。

insert

 建立結構定義。

list

 擷取客戶的所有結構定義。

patch

 修補結構定義。

update

 更新結構定義。