リソース: User
Directory API を使用すると、アカウントのユーザー、ユーザー エイリアス、Gmail のチャット プロフィール写真を作成、管理できます。一般的なタスクの詳細については、ユーザー アカウント デベロッパー ガイドおよびユーザー エイリアス デベロッパー ガイドをご覧ください。
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 リソースのタイプ。Users リソースの場合、値は |
||||||||||||||||||||||||||||||||||||||||||
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(読み取り専用) |
||||||||||||||||||||||||||||||||||||||||||
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 |
ユーザーの Instant Messenger(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 文字)。 |
Methods |
|
---|---|
|
ユーザーを削除します。 |
|
ユーザーを取得します。 |
|
ユーザーを作成します。 |
|
削除されたユーザーまたはドメイン内のすべてのユーザーのページ分けされたリストを取得します。 |
|
ユーザーを特権管理者にします。 |
|
パッチのセマンティクスを使用してユーザーを更新します。 |
|
すべてのウェブ セッションとデバイス セッションからユーザーをログアウトし、ログイン Cookie をリセットします。 |
|
削除されたユーザーの削除を取り消します。 |
|
ユーザーを更新します。 |
|
ユーザーリストの変更を監視します。 |