コラボレーションの利用規約の検索

コラボレーションに効力のあるサービス利用規約に関する情報を調べるには、GET /collaborations/:id APIを呼び出してクエリパラメータfields=acceptance_requirements_statusを渡します。

curl -X GET https://api.box.com/2.0/collaborations/2342342?fields=acceptance_requirements_status \
    -H "authorization: Bearer <ACCESS_TOKEN>"

返されるレスポンスには、Mini版のterms_of_serviceオブジェクトを含む新しいacceptance_requirementsオブジェクトが含まれます。

{
  "type": "collaboration",
  "id": 2342342>,
  "acceptance_requirements": {
    "terms_of_service": {
      "type": "terms_of_service",
      "id": 6766677
    }
  }
}

この情報が返されるのは、外部ユーザーのサービス利用規約が企業で有効になっており、リクエストを実行するユーザーにサービス利用規約を表示するための権限がある場合のみです。これは、管理者とエンドユーザーの両方に当てはまりますが、特定のサービス利用規約タイプが無効になっている場合でも、一般的に、管理者はAPIを介してユーザーのサービス利用規約情報を表示できます。

サービス利用規約タイプが有効になっていない場合は、APIによって空の結果が返されます。

{
  "type": "collaboration",
  "id": 2342342>,
  "acceptance_requirements": {
    "terms_of_service": null
  }
}

すでにユーザーが同意している場合でも、terms_of_serviceの情報はacceptance_requirements内で返されます。