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

ガイド セキュリティ サービス利用規約 コラボレーションの利用規約の検索

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

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

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

返されるレスポンスには、簡易版の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内で返されます。