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

 スキーマを更新します。