Skip to main content
一般的に、アプリケーションでは以下のようにサービス利用規約を使用します。 ユーザーとして認証されたアプリケーションが、関連するサービス利用規約にユーザーが同意している必要があるBox内の項目にアクセスしようとすると、TERMS_OF_SERVICE_REQUIREDエラーが返されます。
アプリケーションは、を呼び出してサービス利用規約の情報をリクエストします。
その後、アプリケーションはサービス利用規約のテキストをユーザーに表示できます。 ユーザーが利用規約を同意または拒否すると、最初のエラーによってレスポンスでtos_user_status_idが返されたかどうかに応じて、またはが呼び出されます。

サーバー認証とユーザー代理操作

JWT、クライアント資格情報許可 (CCG)、またはOAuth 2.0を使用するアプリケーションは、、または管理対象ユーザーとして動作することができます。サービス利用規約の適用は、APIリクエストのコンテキスト上のユーザーによって異なります。

プログラムによるサービス利用規約への同意

管理対象ユーザーが管理対象ユーザー用サービス利用規約に同意していない場合、そのユーザーに代わって行われるほとんどのAPIコールはterms_of_service_requiredを返します。ユーザーにBoxウェブアプリケーションへのサインインを求めずに解決するには、次の手順を実行します。
  1. サーバー認証のアクセストークン (JWTまたはCCG) を取得します。
  2. ヘッダーに管理対象ユーザーのIDを設定し、以降のリクエストがそのユーザーのコンテキストで実行されるようにします。
  3. サービス利用規約への同意が未完了でも利用できるサービス利用規約のエンドポイントを呼び出します。
    • 規約のテキストを取得する:
    • 同意または拒否する: または
  4. 元のAPIコールを再試行します。
管理者は、他のユーザーとして動作するためのAs-Userヘッダーを使用せずに、そのユーザーの管理対象ユーザー用サービス利用規約に同意することはできません。同意は、サービス利用規約の対象となるユーザーに対して記録される必要があります。
最終更新日 2026年7月8日