【Power Automate】Boxコネクタのファイル一覧が取れない場合の権限確認

Power AutomateでBoxコネクタを利用してファイル一覧を取得しようとした際、何も返ってこない、またはエラーが発生するケースがあります。原因の多くはBox側の権限設定にありますが、フローの構成や接続設定にも問題が潜んでいることがあります。本記事では、Power AutomateのBoxコネクタでファイル一覧が取得できない場合に、権限確認を中心とした具体的な切り分け手順を解説します。

1. Power AutomateでBoxファイル一覧を取得する代表的なフロー構成

まず、Boxコネクタを使ってファイル一覧を取得する典型的なフローを確認します。多くの場合、次のようなトリガーとアクションで構成されます。

• トリガー: 「ファイルが作成されたとき」や「一定間隔でのスケジュール」など
• アクション: 「フォルダー内のファイルを一覧表示」または「検索(query)でファイルを取得」

例えば、「Box – フォルダー内のファイルを一覧表示」アクションには、対象のフォルダーIDを指定する必要があります。このフォルダーIDはBoxのWeb UIから取得できます。ファイル一覧が取れない場合、まずはフォルダーIDが正しいか確認してください。

1.1. フォルダーIDの確認方法

BoxのWeb UIで該当フォルダーを開き、URLの末尾にある数字がフォルダーIDです。例えば「https://app.box.com/folder/123456789」の「123456789」の部分です。Power Automateのアクションに入力する際は、引用符や余計な文字を含めず数字のみにしてください。

2. ファイル一覧が取れない原因の切り分け

原因を特定するために、以下の切り分け表を参考にしてください。

症状	考えられる原因	確認・対処
空の配列が返る(0件)	Boxサービスアカウントにフォルダーへのアクセス権限がない	Box管理者にアプリのサービスアカウントに権限を付与してもらう
「アクセスが拒否されました」エラー	OAuthトークンが無効、またはスコープ不足	接続を再作成し、必要なスコープを確認
「指定されたフォルダーが見つかりません」エラー	フォルダーIDが誤っている、または削除された	フォルダーIDを再取得
フローがタイムアウト	対象フォルダーに大量のファイルがある	フィルターを使用または分割実行を検討

2.1. Boxサービスアカウントの権限を確認する手順

Power AutomateがBoxにアクセスする際は、Boxアプリとして登録された「サービスアカウント」が使用されます。このサービスアカウントに、対象フォルダーへの適切な権限(「閲覧者」以上)が必要です。以下の手順で権限を確認できます。

1. Boxの管理コンソールに管理者としてログインします。
2. 左メニューから「アプリ」→「カスタムアプリマネージャー」を開きます。
3. 使用しているPower Automate用のアプリを選択し、「承認」タブでスコープを確認します。「ファイルの読み取り」や「すべてのファイル」など必要な権限が設定されているか確認します。
4. 「サービスアカウント情報」の「ユーザーID」をメモします。
5. 対象フォルダーに移動し、右上の「共有」→「共同作業者を追加」で上記のサービスアカウントのメールアドレス(例: AutomationUser_xxxxx@box.com)を追加し、権限レベルを「閲覧者」または「アップロード者」など必要に応じて設定します。

これでサービスアカウントがフォルダーにアクセスできるようになります。

3. Power Automate側の接続設定の確認

権限が正しく設定されていても、Power Automateの接続に問題がある場合があります。以下の点を確認してください。

3.1. 接続の再作成

古いトークンが原因でアクセスできないことがあります。フローエディターの「データ」→「接続」からBoxの接続を削除し、新規に作成し直してください。その際、同意画面で必要な権限(スコープ)がすべて許可されていることを確認します。

3.2. スコープの不足

Boxアプリの設定で、Power Automateに必要なスコープが不足しているとファイル一覧を取得できません。最低限「ファイルの内容を読み取る」と「フォルダー構造を読み取る」スコープが必要です。Box開発者コンソールでアプリのスコープを確認し、不足があれば追加して再認証してください。

4. 失敗パターンとその対策

実際によくある失敗パターンを挙げます。

• パターン1: ルートフォルダーのID指定 – Boxアプリのサービスアカウントはルートフォルダーにアクセスできないことがあります。明示的に任意のフォルダーを指定してください。
• パターン2: 権限の伝搬 – サービスアカウントを親フォルダーに追加した場合、子フォルダーにも権限が継承されますが、既存の子フォルダーには自動反映されない場合があります。個別に追加するか、管理コンソールで権限の継承を有効にします。
• パターン3: Boxアプリの認証方法の誤り – Power AutomateではOAuth 2.0(ユーザー認証)またはJWT(サーバー認証)のどちらかを使用します。企業環境ではJWTが推奨されますが、設定が複雑です。ユーザー認証の場合、そのユーザーがBoxから退職すると接続が使えなくなります。

5. 管理者に伝えるべき情報

問題が解決しない場合、Box管理者またはPower Automate管理者に以下の情報を伝えるとスムーズです。

• Power Automateフローのエラーメッセージのスクリーンショット
• 使用しているBoxアプリの名前とサービスアカウントID
• 対象のフォルダーIDとそのパス
• Box管理コンソールで確認したアプリのスコープ一覧

6. よくある質問

Q1. Boxコネクタの「フォルダー内のファイルを一覧表示」で「ルート」を指定してもエラーになります。

サービスアカウントはルートフォルダーにアクセスできない設計になっています。必ず特定のフォルダーIDを指定してください。

Q2. ファイル一覧は取得できるが、特定のファイルだけ取得できない。

そのファイルがサービスアカウントからアクセス可能なフォルダーにあるか確認してください。また、ファイル名に特殊文字が含まれていないかもチェックしてください。

Q3. 権限を追加したのにすぐに反映されない。

Boxの権限反映には数分かかることがあります。また、Power Automateの接続がキャッシュしている可能性もあるため、接続を再作成してみてください。

7. まとめ

Power AutomateでBoxコネクタのファイル一覧が取れない場合、まずはフォルダーIDの指定とBoxサービスアカウントの権限設定を確認してください。切り分けの際は、エラーメッセージの内容と、取得結果が空かどうかが重要な手がかりになります。権限付与はBox管理者に依頼する必要があるため、社内の窓口に連絡する前に本記事の手順を試しておくとスムーズです。これらの確認を順番に行うことで、多くの問題は解決できます。

🔐

会社アカウント・認証トラブル完全解決データベース 職場または学校アカウント、MFA、Authenticator、VPN、権限、会社ポリシーで止まる問題を横断的に確認できます。