---
title: "転送元 - Box | TROCCO Docs"
slug: "data-source-box"
updated: 2026-06-19T00:17:31Z
published: 2026-06-19T00:17:31Z
canonical: "documents.trocco.io/data-source-box"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documents.trocco.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 転送元 - Box

## 概要

Boxからデータを転送する設定のDocsです。

## 制約

Box APIの一部のトークン・コード・URLには、有効期限が設定されています。 詳しくは、[トークンおよびURLの有効期限](https://ja.developer.box.com/guides/api-calls/permissions-and-errors/expiration/)を参照ください。

              アクセストークンの有効期限

              

転送元Boxからデータを取得する際に、**アクセストークン**が利用されます。 アクセストークンの有効期限は、**60分間**です。

有効期限内に転送元Boxから転送対象のデータを取得できなかった場合、該当のデータは転送されません。 万一有効期限内にデータの取得が終わらない場合は、転送対象のデータサイズを小さくするといった対応を取ってください。

              更新トークンの有効期限

              

認証方式として**OAuth 2.0認証**を選択した接続情報を利用している場合、転送元Boxからデータを取得する際に、**更新トークン**が利用されます。 更新トークンの有効期限は、更新トークンの作成または利用を起点に、**60日間**です。

接続情報の作成または前回のデータ転送から起算して、60日間データ転送が行われなかった場合、更新トークンは有効期限切れとなります。 更新トークンの有効期限が切れた場合は、接続情報の編集画面から**Boxアカウント再認証**を再度行ってください。

## 設定項目

### STEP1 基本設定

| 項目名 | 必須 | デフォルト値 | 内容 |
| --- | --- | --- | --- |
| Box接続情報 | Yes | - | Boxの接続情報を選択します。 詳しくは、[Boxの接続情報](/docs/connection-configuration-box)を参照ください。 |
| フォルダーID | Yes | - | フォルダーIDを入力します。 Boxの管理画面より転送対象のフォルダーに遷移し、URLよりフォルダーIDを取得してください。 ![ds_box_001](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/data-source-box-2024-08-29-5-35-0.png) |
| ファイルプレフィックス | Yes | - | 取得対象のファイル名のプレフィックスを入力します。 なお、**フォルダーID**にて指定したフォルダー直下（第1階層）のファイルデータのみ、取得可能です。 |
| 解凍形式 | No | - | 転送元のデータが圧縮されている場合に、解凍形式を指定する必要があります。 以下の解凍形式に対応しています。転送対象のデータの圧縮形式に沿って選択してください。 なお、転送対象のデータが**非圧縮ファイル**の場合は、解凍形式を**選択しないでください**。 - `bzip2` - `gzip` - `tar.gz` - `zip` 変更後は、STEP2に進む際に必ず**自動データ設定**を行ってください。 |
| 解凍後の相対パス (正規表現) | No | - | 解凍形式にて`zip`または`tar.gz`を選択した場合に入力できます。 圧縮ファイル内の特定のフォルダまたはファイルを転送したい場合に入力してください。 パス区切り文字を含める場合は、バックスラッシュ（`\`）を用いてエスケープしてください。 |
| 入力ファイル形式 | Yes | CSV/TSV | 入力ファイルの形式を指定してください。 詳しくは、[入力ファイル形式の設定について](/docs/configuration-of-input-files)を参照ください。 |

### STEP1 詳細設定

| 項目名 | 必須 | デフォルト値 | 内容 |
| --- | --- | --- | --- |
| 指定のパスにファイルが存在しなかった場合に転送を続行するか | Yes | 転送を続行する | 基本設定にて指定したパスにファイルが見つからなかった場合に転送を続行させるかどうかお選びいただけます。 **転送を続行する**を選択した場合は0件転送したとして転送ジョブが完了します。 **転送を中止し、エラーにする**を選択した場合はエラーとして転送ジョブを中止します。 |
| APIリトライ上限回数 | Yes | 3 | Box APIのレートリミット（HTTP 429）等で失敗した場合のリトライ上限回数を指定します。 設定できる最大値は`10`です。 `0`を指定するとリトライしません。 |
