Box Developerドキュメント

サービス利用規約のユーザーステータスのリストを取得

get
https://api.box.com/2.0
/terms_of_service_user_statuses

ユーザーとそのユーザーに適用されるサービス利用規約のステータスの概要 (ユーザーが利用規約に同意したかどうかや、いつ同意したかなど) を取得します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

クエリパラメータ

stringクエリ内必須
324234

サービス利用規約のID。

stringクエリ内省略可能
123334

指定したユーザーIDのみに結果を絞り込みます。

レスポンス

サービス利用規約のステータスのリストを返します。

予期しないクライアントエラー。

get
サービス利用規約のユーザーステータスのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -i -X GET "https://api.box.com/2.0/terms_of_service_user_statuses?tos_id=324234" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
TypeScript Gen
await client.termsOfServiceUserStatuses.getTermsOfServiceUserStatuses({
  tosId: tos.id,
  userId: user.id,
} satisfies GetTermsOfServiceUserStatusesQueryParams);
Python Gen
client.terms_of_service_user_statuses.get_terms_of_service_user_statuses(
    tos.id, user_id=user.id
)
.NET Gen
await client.TermsOfServiceUserStatuses.GetTermsOfServiceUserStatusesAsync(queryParams: new GetTermsOfServiceUserStatusesQueryParams(tosId: tos.Id) { UserId = user.Id });
Node
client.termsOfService.getUserStatus('11111', { user_id: '22222' })
	.then(tosStatus => {
		/* tosStatus -> {
			type: 'terms_of_service_user_status',
			id: '12345',
			tos: { type: 'terms_of_service', id: '11111' },
			user: { type: 'user', id: '22222' },
			is_accepted: true,
			created_at: '2018-04-11T15:33:49-07:00',
			modified_at: '2018-04-11T15:33:49-07:00' }
		*/
	});

レスポンスの例

{
  "entries": [
    {
      "id": "11446498",
      "type": "terms_of_service_user_status",
      "tos": {
        "id": "11446498",
        "type": "terms_of_service"
      },
      "user": {
        "id": "11446498",
        "type": "user",
        "name": "Aaron Levie",
        "login": "ceo@example.com"
      },
      "is_accepted": true,
      "created_at": "2012-12-12T10:53:43-08:00",
      "modified_at": "2012-12-12T10:53:43-08:00"
    }
  ],
  "total_count": 2
}