REST Resource: schemas

リソース: Schema

API リソースのタイプ。スキーマ リソースの場合、これは常に admin#directory#schema です。

JSON 表現
{
  "schemaId": string,
  "schemaName": string,
  "fields": [
    {
      object (SchemaFieldSpec)
    }
  ],
  "displayName": string,
  "kind": string,
  "etag": string
}
フィールド
schemaId

string

スキーマの一意の識別子(読み取り専用)

schemaName

string

スキーマ名。

schemaName は 1 つの顧客内で一意である必要があります。名前を再利用すると、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

フィールドの一意の識別子(読み取り専用)

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

スキーマを更新する。