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

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

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

コラボレーションに効力のある利用規約に関する情報を調べるには、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内で返されます。