リソース: User
Directory API を使用すると、アカウントのユーザー、ユーザー エイリアス、ユーザーの Google プロフィール写真を作成、管理できます。一般的なタスクの詳細については、ユーザー アカウント デベロッパー ガイドとユーザー エイリアス デベロッパー ガイドをご覧ください。
JSON 表現 |
---|
{
"id": string,
"primaryEmail": string,
"password": value,
"hashFunction": string,
"isAdmin": boolean,
"isDelegatedAdmin": boolean,
"agreedToTerms": boolean,
"suspended": boolean,
"changePasswordAtNextLogin": boolean,
"ipWhitelisted": boolean,
"name": {
object ( |
フィールド | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
ユーザーの一意の ID。ユーザー |
||||||||||||||||||||||||||||||||||||||||||
primaryEmail |
ユーザーのメインのメールアドレス。このプロパティは、ユーザー アカウントを作成するリクエストに必須です。 |
||||||||||||||||||||||||||||||||||||||||||
password |
ユーザー アカウントのパスワードを保存します。ユーザー アカウントの作成時に、ユーザーのパスワード値は必須です。ユーザーを更新する場合は省略可能です。ユーザーがアカウントのパスワードを更新する場合にのみ指定します。パスワード値が API のレスポンス本文で返されることはありません。 |
||||||||||||||||||||||||||||||||||||||||||
hashFunction |
プレフィックスの一部としてラウンドを指定する場合は、10,000 以下にする必要があります。 |
||||||||||||||||||||||||||||||||||||||||||
isAdmin |
出力のみ。特権管理者権限を持つユーザーを示します。 |
||||||||||||||||||||||||||||||||||||||||||
isDelegatedAdmin |
出力のみ。ユーザーが代理管理者かどうかを示します。 |
||||||||||||||||||||||||||||||||||||||||||
agreedToTerms |
出力のみ。ユーザーが最初のログインを完了し、利用規約に同意した場合、このプロパティは |
||||||||||||||||||||||||||||||||||||||||||
suspended |
ユーザーが停止中かどうかを示します。 |
||||||||||||||||||||||||||||||||||||||||||
changePasswordAtNextLogin |
次回ログイン時にユーザーにパスワードの変更を要求するかどうかを示します。ユーザーがサードパーティの ID プロバイダを使用してログインする場合、この設定は適用されません。 |
||||||||||||||||||||||||||||||||||||||||||
ipWhitelisted |
|
||||||||||||||||||||||||||||||||||||||||||
name |
ユーザーの姓と名、および読み取り専用の |
||||||||||||||||||||||||||||||||||||||||||
kind |
出力のみ。API リソースのタイプ。ユーザー リソースの場合、値は |
||||||||||||||||||||||||||||||||||||||||||
etag |
出力のみ。リソースの ETag。 |
||||||||||||||||||||||||||||||||||||||||||
emails |
ユーザーのメールアドレスのリスト。指定できるデータサイズは最大 10 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
externalIds |
従業員の外部 ID(従業員 ID やネットワーク ID など)のリスト。指定できるデータサイズは最大 2 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
relations |
ユーザーと他のユーザーとの関係のリスト。このフィールドに指定できるデータサイズは最大 2 KB です。詳しくは、ユーザー アカウントを管理するをご覧ください。
|
||||||||||||||||||||||||||||||||||||||||||
aliases[] |
出力のみ。ユーザーのエイリアス メールアドレスのリスト。 |
||||||||||||||||||||||||||||||||||||||||||
isMailboxSetup |
出力のみ。ユーザーの Google メールボックスが作成されているかどうかを示します。このプロパティは、ユーザーに Gmail ライセンスが割り当てられている場合にのみ適用されます。 |
||||||||||||||||||||||||||||||||||||||||||
customerId |
出力のみ。すべてのアカウント ユーザーを取得するためのお客様 ID。 |
||||||||||||||||||||||||||||||||||||||||||
addresses |
ユーザーのアドレスのリスト。指定できるデータサイズは最大 10 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
organizations |
ユーザーが所属する組織のリスト。指定できるデータサイズは最大 10 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
lastLoginTime |
出力のみ。ユーザーが最後にユーザーのアカウントにログインした日時。値は、ISO 8601 の日付と時刻の形式です。時刻は、完全な日付に時、分、秒を加えた形式で、 |
||||||||||||||||||||||||||||||||||||||||||
phones |
ユーザーの電話番号のリスト。指定できるデータサイズは最大 1 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
suspensionReason |
出力のみ。停止時に管理者または Google によってユーザー アカウントが停止された理由があるこのプロパティは、 |
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoUrl |
出力のみ。ユーザーのプロフィール写真の URL。URL は一時的なものか、非公開の URL の可能性があります。 |
||||||||||||||||||||||||||||||||||||||||||
languages |
ユーザーの言語のリスト。指定できるデータサイズは最大 1 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
posixAccounts |
ユーザーの POSIX アカウント情報のリスト。
|
||||||||||||||||||||||||||||||||||||||||||
creationTime |
出力のみ。ユーザーのアカウントが作成された時刻。値は、ISO 8601 の日付と時刻の形式です。時刻は、完全な日付に時、分、秒を加えた形式で、 |
||||||||||||||||||||||||||||||||||||||||||
nonEditableAliases[] |
出力のみ。ユーザーの編集不可のエイリアス メールアドレスのリスト。通常は、アカウントのプライマリ ドメインまたはサブドメインに含まれません。 |
||||||||||||||||||||||||||||||||||||||||||
sshPublicKeys |
SSH 公開鍵のリスト。
|
||||||||||||||||||||||||||||||||||||||||||
notes |
ネストされたオブジェクトとしてのユーザー向けのメモ。
|
||||||||||||||||||||||||||||||||||||||||||
websites |
ユーザーのウェブサイトのリスト。
|
||||||||||||||||||||||||||||||||||||||||||
locations |
ユーザーの勤務地のリスト。指定できるデータサイズは最大 10 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
includeInGlobalAddressList |
ドメインで連絡先の共有機能が有効になっている場合、ユーザーのプロフィールが Google Workspace のグローバル アドレス一覧に表示されるかどうかを示します。ユーザー プロファイルの除外について詳しくは、管理者向けヘルプセンターをご覧ください。 |
||||||||||||||||||||||||||||||||||||||||||
keywords |
ユーザーのキーワードのリスト。指定できるデータサイズは最大 1 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
deletionTime |
出力のみ。ユーザーのアカウントが削除された時刻。値は、ISO 8601 の日付と時刻の形式です。時刻は、完全な日付に時、分、秒を加えた形式で、 |
||||||||||||||||||||||||||||||||||||||||||
gender |
ユーザーの性別を含むネストされたオブジェクト。このフィールドに指定できるデータサイズは最大 1 KB です。
|
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoEtag |
出力のみ。ユーザーの写真の ETag(読み取り専用) |
||||||||||||||||||||||||||||||||||||||||||
ims |
ユーザーのインスタント メッセンジャー(IM)アカウント。1 つのユーザー アカウントに複数の
|
||||||||||||||||||||||||||||||||||||||||||
customSchemas |
ユーザーのカスタム フィールド。キーは
|
||||||||||||||||||||||||||||||||||||||||||
isEnrolledIn2Sv |
出力のみ。2 段階認証プロセスに登録している(読み取り専用) |
||||||||||||||||||||||||||||||||||||||||||
isEnforcedIn2Sv |
出力のみ。2 段階認証プロセスが適用されている(読み取り専用) |
||||||||||||||||||||||||||||||||||||||||||
archived |
ユーザーがアーカイブされているかどうかを示します。 |
||||||||||||||||||||||||||||||||||||||||||
orgUnitPath |
ユーザーに関連付けられている親組織のフルパス。親組織が最上位の場合はスラッシュ( |
||||||||||||||||||||||||||||||||||||||||||
recoveryEmail |
ユーザーの再設定用のメールアドレス。 |
||||||||||||||||||||||||||||||||||||||||||
recoveryPhone |
ユーザーの再設定用の電話番号。電話番号は、プラス記号(+)で始まる E.164 形式で入力してください(例: +16506661212)。 |
UserName
JSON 表現 |
---|
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string } |
フィールド | |
---|---|
fullName |
姓と名の値を連結して形成されたユーザーのフルネーム。 |
familyName |
ユーザーの姓。ユーザー アカウントの作成時に必須。 |
givenName |
ユーザーの名。ユーザー アカウントの作成時に必須。 |
displayName |
ユーザーの表示名。上限: 半角 256 文字(全角 128 文字) |
Methods |
|
---|---|
|
ユーザーを削除します。 |
|
ユーザーを取得します。 |
|
ユーザーを作成します。 |
|
削除済みのユーザーまたはドメイン内のすべてのユーザーのリストをページ分けして取得します。 |
|
ユーザーを特権管理者にします。 |
|
パッチ セマンティクスを使用してユーザーを更新します。 |
|
ユーザーをすべてのウェブ セッションとデバイス セッションからログアウトさせ、ログイン Cookie をリセットします。 |
|
ユーザーの削除を取り消します。 |
|
ユーザーを更新します。 |
|
ユーザーリストの変更を監視します。 |