ユーザーを更新 - Box Dev Docs

承認

Authorization

string

header

必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

user_id

string

必須

ユーザーのID。

クエリパラメータ

fields

string[]

レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。

このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。

ボディ

application/json

enterprise

string | null

これをnullに設定すると、ユーザーが企業のメンバーではなくなり、無料ユーザーになります。

例:

null

notify

boolean

ユーザーが企業のメンバーでなくなった後もメールを受信できるようにするかどうか。

例:

true

name

string

ユーザーの名前。

Maximum string length: 50

例:

"Aaron Levie"

ユーザーがログインに使用するメールアドレス

注: ターゲットユーザーのメールアドレスが確認されていない場合は、プライマリログインアドレスを変更できません。

例:

"somename@box.com"

role

enum<string>

ユーザーの企業でのロール。

利用可能なオプション:

coadmin,

user

例:

"user"

language

string

修正版のISO 639-1形式で表されるユーザーの言語。

例:

"en"

is_sync_enabled

boolean

ユーザーがBox Syncを使用できるかどうか。

例:

true

job_title

string

ユーザーの役職。

Maximum string length: 100

例:

"CEO"

phone

string

ユーザーの電話番号。

Maximum string length: 100

例:

"6509241374"

address

string

ユーザーの住所。

Maximum string length: 255

例:

"900 Jefferson Ave, Redwood City, CA 94063"

tracking_codes

追跡コード · object[]

追跡コードを使用すると、管理者は管理コンソールからレポートを生成し、特定のグループのユーザーに属性を割り当てることができます。この設定を使用するには、会社に対して有効にしておく必要があります。

Show child attributes

can_see_managed_users

boolean

ユーザーが自身の連絡先リストで企業の他のユーザーを参照できるかどうか。

例:

true

timezone

string<timezone>

ユーザーのタイムゾーン。

例:

"Africa/Bujumbura"

is_external_collab_restricted

boolean

ユーザーが社外のユーザーとのコラボレーションを許可されているかどうか。

例:

true

is_exempt_from_device_limits

boolean

企業のデバイス制限からユーザーを除外するかどうか。

例:

true

ユーザーが2要素認証を使用する必要があるかどうか。

例:

true

is_password_reset_required

boolean

ユーザーにパスワードのリセットを義務付けるかどうか。

例:

true

status

enum<string>

ユーザーのアカウントのステータス。

利用可能なオプション:

active,

inactive,

cannot_delete_edit,

cannot_delete_edit_upload

例:

"active"

space_amount

integer<int64>

ユーザーが利用可能な容量の合計 (バイト数)。これを-1に設定するとストレージ容量が無制限になります。

例:

11345156112

notification_email

object

通知メールが送信される代替の通知用メールアドレス。確認されると、通知メールはプライマリメールアドレスではなくこのメールアドレスに送信されます。

これをnullに設定すると、通知メールが削除されます。

Show child attributes

external_app_user_id

string

ユーザーの検索に使用できる、App Userの外部識別子。これを使用して、外部IDプロバイダのユーザーIDをBoxユーザーに結び付けることができます。

注: このフィールドを更新するには、App Userを作成したアプリケーションを使用してトークンをリクエストする必要があります。

例:

"my-user-1234"

レスポンス

更新されたユーザーオブジェクトを返します。

任意のユーザーAPIエンドポイントから返される可能性があるユーザーのFull版の表示。

string

必須

このユーザーの一意の識別子。

例:

"11446498"

type

enum<string>

必須

値は常にuserになります。

利用可能なオプション:

user

例:

"user"

name

string

このユーザーの表示名。

Maximum string length: 50

例:

"Aaron Levie"

このユーザーのプライマリメールアドレス。

例:

"ceo@example.com"

created_at

string<date-time>

ユーザーオブジェクトが作成された日時。

例:

"2012-12-12T10:53:43-08:00"

modified_at

string<date-time>

ユーザーオブジェクトが最後に変更された日時。

例:

"2012-12-12T10:53:43-08:00"

language

string

修正版のISO 639-1形式で表されるユーザーの言語。

例:

"en"

timezone

string<timezone>

ユーザーのタイムゾーン。

例:

"Africa/Bujumbura"

space_amount

integer<int64>

ユーザーが利用可能な容量の合計 (バイト数)。

例:

11345156112

space_used

integer<int64>

ユーザーが現在使用している容量。

例:

1237009912

max_upload_size

integer<int64>

ユーザーが所有できる個々のファイルの最大サイズ (バイト単位)。

例:

2147483648

status

enum<string>

ユーザーのアカウントのステータス。

利用可能なオプション:

active,

inactive,

cannot_delete_edit,

cannot_delete_edit_upload

例:

"active"

job_title

string

ユーザーの役職。

Maximum string length: 100

例:

"CEO"

phone

string

ユーザーの電話番号。

Maximum string length: 100

例:

"6509241374"

address

string

ユーザーの住所。

Maximum string length: 255

例:

"900 Jefferson Ave, Redwood City, CA 94063"

avatar_url

string

ユーザーのアバター画像のURL。

例:

"https://www.box.com/api/avatar/large/181216415"

notification_email

object

Show child attributes

role

enum<string>

ユーザーの企業でのロール。

利用可能なオプション:

admin,

coadmin,

user

例:

"admin"

tracking_codes

追跡コード · object[]

Show child attributes

can_see_managed_users

boolean

ユーザーが自身の連絡先リストで企業の他のユーザーを参照できるかどうか。

例:

true

is_sync_enabled

boolean

ユーザーがBox Syncを使用できるかどうか。

例:

true

is_external_collab_restricted

boolean

ユーザーが社外のユーザーとのコラボレーションを許可されているかどうか。

例:

true

is_exempt_from_device_limits

boolean

企業のデバイス制限からユーザーを除外するかどうか。

例:

true

ユーザーが2要素認証を使用する必要があるかどうか。

例:

true

enterprise

Enterprise · object

ユーザーの企業のレプリゼンテーション。

Show child attributes

my_tags

string[]

ユーザーが所有するすべてのファイルとフォルダのタグ。返される値にはリクエスト元によって設定されたタグのみが含まれます。

例:

["important"]

hostname

string

ユーザーに対して生成する必要があるリンクのルート (プロトコル、サブドメイン、ドメイン)。

例:

"https://example.app.box.com/"

is_platform_access_only

boolean

ユーザーがApp Userであるかどうか。

例:

true

external_app_user_id

string

ユーザーの検索に使用できる、App Userの外部識別子。これを使用して、外部IDプロバイダのユーザーIDをBoxユーザーに結び付けることができます。

例:

"my-user-1234"

Documentation Index

承認

パスパラメータ

クエリパラメータ

ボディ

レスポンス