Box Developerドキュメント
 
    最新バージョン

    最近アクセスした項目のリストを取得

    get
    https://api.box.com/2.0
    /recent_items

    このエンドポイントはバージョン2024.0です。引き続き使用するために 変更は必要ありません。詳細については、 **Box APIのバージョン管理**を参照してください。

    過去90日間、または最大1,000項目まで遡って、ユーザーが最近アクセスした項目に関する情報を返します。

    リクエスト

    bearer [ACCESS_TOKEN]
    application/json

    クエリパラメータ

    string arrayクエリ内省略可能
    id,type,name

    レスポンスに含める属性のコンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。

    このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、Mini版の表示のフィールドしか返されないことに注意してください。

    integer (int64)クエリ内省略可能
    1000
    1000

    返す項目の1ページあたりの最大数。

    stringクエリ内省略可能
    JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

    結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。

    これを使用するには、usemarkertrueに設定する必要があります。

    レスポンス

    最近ユーザーがアクセスした項目のリストを返します。

    予期しないクライアントエラー。

    get
    最近アクセスした項目のリストを取得
    このドキュメント内で一部のAPIを試せるようになりました。
    ログイン

    リクエストの例

    cURL
    curl -i -X GET "https://api.box.com/2.0/recent_items" \
         -H "authorization: Bearer <ACCESS_TOKEN>"

    レスポンスの例

    {
      "entries": [
        {
          "interacted_at": "2018-04-13T13:53:23-07:00",
          "interaction_shared_link": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg",
          "interaction_type": "item_preview",
          "item": {
            "etag": "1",
            "id": "12345",
            "type": "file",
            "file_version": {
              "id": "12345",
              "type": "file_version",
              "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
            },
            "name": "Contract.pdf",
            "sequence_id": "3",
            "sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37",
            "content_created_at": "2012-12-12T10:53:43-08:00",
            "content_modified_at": "2012-12-12T10:53:43-08:00",
            "created_at": "2012-12-12T10:53:43-08:00",
            "created_by": {
              "id": "11446498",
              "type": "user",
              "login": "ceo@example.com",
              "name": "Aaron Levie"
            },
            "description": "Contract for Q1 renewal",
            "item_status": "active",
            "modified_at": "2012-12-12T10:53:43-08:00",
            "modified_by": {
              "id": "11446498",
              "type": "user",
              "login": "ceo@example.com",
              "name": "Aaron Levie"
            },
            "owned_by": {
              "id": "11446498",
              "type": "user",
              "login": "ceo@example.com",
              "name": "Aaron Levie"
            },
            "parent": {
              "etag": "1",
              "id": "12345",
              "type": "folder",
              "name": "Contracts",
              "sequence_id": "3"
            },
            "path_collection": {
              "entries": [
                {
                  "etag": "1",
                  "id": "12345",
                  "type": "folder",
                  "name": "Contracts",
                  "sequence_id": "3"
                }
              ],
              "total_count": 1
            },
            "purged_at": "2012-12-12T10:53:43-08:00",
            "shared_link": {
              "access": "open",
              "download_count": 3,
              "download_url": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg",
              "effective_access": "company",
              "effective_permission": "can_download",
              "is_password_enabled": true,
              "permissions": {
                "can_download": true,
                "can_edit": false,
                "can_preview": true
              },
              "preview_count": 3,
              "unshared_at": "2018-04-13T13:53:23-07:00",
              "url": "https://www.box.com/s/vspke7y05sb214wjokpk",
              "vanity_name": "my_url",
              "vanity_url": "https://acme.app.box.com/v/my_url/"
            },
            "size": 629644,
            "trashed_at": "2012-12-12T10:53:43-08:00",
            "allowed_invitee_roles": [
              "editor"
            ],
            "classification": {
              "color": "#FF0000",
              "definition": "Content that should not be shared outside the company.",
              "name": "Top Secret"
            },
            "comment_count": 10,
            "disposition_at": "2012-12-12T10:53:43-08:00",
            "expires_at": "2012-12-12T10:53:43-08:00",
            "expiring_embed_link": {
              "access_token": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ",
              "expires_in": 3600,
              "restricted_to": [
                {
                  "object": {
                    "etag": "1",
                    "id": "12345",
                    "type": "folder",
                    "name": "Contracts",
                    "sequence_id": "3"
                  },
                  "scope": "item_download"
                }
              ],
              "token_type": "bearer",
              "url": "https://cloud.app.box.com/preview/expiring_embed/..."
            },
            "extension": "pdf",
            "has_collaborations": true,
            "is_accessible_via_shared_link": true,
            "is_associated_with_app_item": true,
            "is_externally_owned": true,
            "is_package": true,
            "lock": {
              "app_type": "office_wopiplus",
              "created_at": "2012-12-12T10:53:43-08:00",
              "created_by": {
                "id": "11446498",
                "type": "user",
                "login": "ceo@example.com",
                "name": "Aaron Levie"
              },
              "expired_at": "2012-12-12T10:53:43-08:00",
              "id": "11446498",
              "is_download_prevented": true,
              "type": "lock"
            },
            "metadata": {
              "enterprise_27335": {
                "marketingCollateral": {
                  "$canEdit": true,
                  "$id": "01234500-12f1-1234-aa12-b1d234cb567e",
                  "$parent": "folder_59449484661",
                  "$scope": "enterprise_27335",
                  "$template": "marketingCollateral",
                  "$type": "properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0",
                  "$typeVersion": 2,
                  "$version": 1
                }
              }
            },
            "permissions": {
              "can_delete": true,
              "can_download": true,
              "can_invite_collaborator": true,
              "can_rename": true,
              "can_set_share_access": true,
              "can_share": true,
              "can_annotate": true,
              "can_comment": true,
              "can_preview": true,
              "can_upload": true,
              "can_view_annotations_all": true,
              "can_view_annotations_self": true
            },
            "representations": {
              "entries": [
                {
                  "content": {
                    "url_template": "https://dl.boxcloud.com/api/2.0/internal_files/123/versions/345/representations/png_paged_2048x2048/content/{+asset_path}?watermark_content=4567"
                  },
                  "info": {
                    "url": "https://api.box.com/2.0/internal_files/123/versions/345/representations/png_paged_2048x2048"
                  },
                  "properties": {
                    "dimensions": "2048x2048",
                    "paged": "true",
                    "thumb": "true"
                  },
                  "representation": "png",
                  "status": {
                    "state": "success"
                  }
                }
              ]
            },
            "shared_link_permission_options": [
              "can_preview"
            ],
            "tags": [
              "approved"
            ],
            "uploader_display_name": "Ellis Wiggins",
            "version_number": "1",
            "watermark_info": {
              "is_watermarked": true
            }
          },
          "type": "recent_item"
        }
      ],
      "limit": 1000,
      "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii",
      "prev_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVih"
    }