最新バージョン
サービス利用規約のユーザーステータスのリストを取得
APIバージョン 2024.0
ユーザーとそのユーザーに適用されるサービス利用規約のステータスの概要 (ユーザーが利用規約に同意したかどうかや、いつ同意したかなど) を取得します。
リクエスト
bearer [ACCESS_TOKEN]
application/json
クエリパラメータ
stringクエリ内必須
324234サービス利用規約のID。
stringクエリ内省略可能
123334指定したユーザーIDのみに結果を絞り込みます。
レスポンス
application/jsonサービス利用規約のユーザーステータス
サービス利用規約のステータスのリストを返します。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
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": [
{
"created_at": "2012-12-12T10:53:43-08:00",
"id": "11446498",
"is_accepted": true,
"modified_at": "2012-12-12T10:53:43-08:00",
"tos": {
"id": "11446498",
"type": "terms_of_service"
},
"type": "terms_of_service_user_status",
"user": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
}
}
],
"total_count": 2
}