Airtableの添付ファイルURLが後から開けないとき、期限付きURLと保存先を確認する

Airtableから取得した添付URLが後日開けない場合は、まずリンクのdomainと取得方法を調べます。

AIものさし編集部

まず結論:URLの種類と取得経路を見分ける

Airtableから取得した添付URLが後日開けない場合は、まずリンクのdomainと取得方法を調べます。Airtableには、baseまたはinterfaceへのアクセスが必要なattachment viewer URLと、Airtableへログインしなくても開ける一方で期限があるdownload URLがあります。APIやCSVに含まれるdownload URLは長期保管用の恒久リンクではありません。必要なファイルはリンクを記録するだけでなく、利用目的と権限を確認したうえで、有効なうちにファイル本体を許可された保存先へ取得してください。

Airtableの現行Helpによると、download URLは短時間で失効し、発行後少なくとも2時間は利用できるよう保証されます。正確な時間枠はAirtableが変更する可能性があると明記されています。したがって「必ず2時間で切れる」と決めつけず、長期利用には向かない前提で設計します。

URLのdomainで切り分ける

まず失敗するURLのhostを確認します。Airtable Helpは、viewer URLはairtable.com domain、expiring download URLはairtableusercontent.com domainに表示されると説明しています。URL全文を公開チケットやチャットへ貼ると、期限内はログイン不要でファイルへアクセスできることがあります。調査時にはtoken風のquery文字列やファイル名など、不要な機密情報を伏せて共有してください。

表は横にスクロールできます

URLの種類Airtable login / base access主な使い道期限・注意
Attachment viewer URLAirtableへログインし、対象base/interfaceへアクセスできる必要がある同僚がAirtable内で閲覧するHelpは添付またはrecordが削除されると使えなくなると説明
Expiring download URLURLを持つ人はAirtable loginなしでアクセス可能短時間の取得や連携処理短時間で失効。公開CDNや長期共有に使わない
Airtable外のURL fieldリンク先サービスの権限次第DriveやBox等、外部保存先のリンクAirtable attachment URLの失効仕様とは別

Airtable Helpによると、Airtableのattachment viewer URLは添付を削除するかrecordを削除するまで有効で、base/interface collaboratorに限ってアクセスできます。download URLはログインなしで利用できるため、URL自体を秘密のように扱い、アクセスできる相手と保存先を確認してください。Single line text等へ保存した外部URLは、Airtableに保存されたattachmentとは別です。

取得した経路を特定する

API response、CSV export、Automation、Zapier等の連携、Airtable UIのどこからURLを得たかを記録します。公式Helpは、APIやCSVから取得するattachment download URLは短期間で失効するため、CSVからのリンクは失効前にdownloadし、API連携では取得直後に処理するよう勧めています。URLをアーカイブへ保存して、数日後に利用する運用は適しません。

確認項目は次の通りです。

  1. URLのdomainがairtable.comかairtableusercontent.comか。

  2. 取得元がviewer、API、CSV、automation、third-party integrationのどれか。

  3. URLを取得した日時と、初回に開けなくなった日時。

  4. 今アクセスする人がbase/interface collaboratorか。

  5. 添付または元recordが削除・変更されたか。

  6. URLを長期保管、社外共有、Web公開に使う必要があるか。

  7. その用途に許可された保存先や共有手段が存在するか。

URLから期限を正確に逆算するのは避けます。Helpは最低保証と「短時間」という説明を併記し、正確な時間枠が変わる可能性を明記しています。成功・失敗した時刻は自分の運用記録として使い、次回も同じ時間で必ず動く保証だとは扱いません。

用途ごとに保存方法を決める

Airtable内の共同作業者が見るだけなら、baseまたはinterface accessを確認してattachment viewer URLを使います。Airtable外の相手へ一時的に渡す用途では、期限付きdownload URLの失効時期を前提にします。後日も利用するアーカイブ、外部サイト配信、公開CDNには、Airtable download URLを直接置かないでください。Airtableは公開ファイルhosting用途をサポートしないと説明し、長期の外部共有も推奨していません。

長期保存が必要なら、Airtableのattachment APIまたはCSVからファイルを取得し、組織が承認したstorageへコピーする構成を検討します。ファイルの権利、個人情報、アクセス制御、保持期間、削除依頼、backupを確認する前にコピーしないでください。コピー後には、保存先の権限を必要な人に限定し、保持期限と削除担当を決めます。これはAirtableが自動で行うことではなく、組織側の保管設計です。

表は横にスクロールできます

必要な用途推奨する確認・方式避けること
Airtable利用者が閲覧viewer URL、base/interface access、recordの存続URLだけ渡して権限も不要と説明
API連携で直ちに処理attachment取得直後にdownloadし、応答を検証URLを後日のjobへそのまま保存
CSVで一括確認export後、download URLを早めに取得CSVを長期保存すればファイルも保持されると考える
長期アーカイブ許可済みstorageへ実ファイルをコピー、retentionを定義Airtableを公開CDNとして使う
外部の長期共有組織の承認済み共有先・access policyを選択期限付きの公開可能URLを恒久リンクにする

Automation / Zapierを使う場合

Airtableの公式Helpには、Zapier連携でattachment URLではなく添付file contentsを使い、後続stepで「(Attachment field name) File」項目を参照する設定例があります。実際に使えるfieldや動作は対象Zap、trigger、plan、接続先appに依存するため、現在の画面で確認します。Airtable Automationでもviewer URLとexpiring download URLは別のpropertyとして扱われ、後者は一時的なdownload linkを提供する用途です。

ファイル本体を連携で渡す設定に変更する前に、容量、対象レコード、外部サービスへの転送、権限、保持先を確認します。URLをfile contentsに変えれば長期保管も自動で解決する、とは限りません。連携先で添付を一時処理するのか、複製保存するのか、処理後に削除するのかをフロー図にします。

失敗原因を診断する

失効したURLを再利用しているのか、viewer URLの権限がないのか、元添付が削除されたのかを分けます。

表は横にスクロールできます

観測原因候補次の確認
airtableusercontent.com URLが後日失敗expiring download URLの期限切れAirtableから新しいURLを取得し、直ちに利用
airtable.com viewer URLで認証画面・拒否loginまたはbase/interface access不足collaborator権限と対象recordを確認
URLが404 / 利用不可添付・record削除、古いdownload URLAirtable内でrecordと添付の現状を確認
CSV archiveから画像を取得できないCSVの期限付きURLを長期保存再exportし、取得直後にdownload
Webサイトの画像URLとして使っていたAirtableを公開host/CDN代わりに使用承認済みobject storage等への移行を検討

HTTP statusやエラー表示だけで原因を断定しないでください。アクセス権、削除状態、失効、URLの誤コピー、ネットワーク制限が重なる場合があります。まずAirtable UIで添付が残っているか確認し、同じユーザーでviewer URLを開き、download URLを新たに生成できる場合は新URLをすぐ試します。外部保存へ移す場合は、公開共有を広げず、権限を最小化します。

取得・保存の実務チェックリスト

  • URLの種類とdomainを確認した

  • API / CSV / automation / viewerのどの経路か記録した

  • URL取得時刻を記録し、download URLを速やかに利用する

  • URLを長期保存用のfile IDと混同していない

  • Viewer URLの利用者がbase/interfaceへアクセスできる

  • 元recordやattachmentが残っている

  • CSVやAPIの添付ファイルは期限前に実体を取得した

  • 外部storageが組織から承認されている

  • コピーの権利、privacy、保持期間、削除方法を確認した

  • URL全文やtoken風parameterを公開ログへ残していない

  • 公開Web配信にAirtableをCDN代わりに使っていない

  • 保存後に想定ユーザーで権限を再確認した

次に行うこと

今開けないURLのdomain、取得経路、取得日時を記録し、Airtable内でrecordとattachmentが残っているか確認します。viewer URLなら、ログインユーザーのbase/interface accessを確認します。download URLなら古いリンクを恒久リンクとして使い続けず、API、CSV、またはAutomationから新しいURLやfile contentsを取得し、直ちに処理します。長期保存が必要なら、組織で許可された保存先、retention、アクセス権、削除方法を決めてからファイル本体を移します。

このガイドでは特定のAirtable base、plan、外部storage、automationを確認していません。実際のURLの寿命や組織の保存方針は、現在の公式Helpと自社の設定で確認してください。

Sources