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。

結構定義欄位規格

您可以使用架構,為使用者設定檔新增自訂欄位。您可以使用這些欄位來儲存資訊,例如使用者執行的專案、實際位置、聘僱日期,或是任何符合您業務需求的其他項目。詳情請參閱自訂使用者欄位

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:布林值。
  • DATEISO-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

更新結構定義。