# Airtableへの接続 開始する前に * 現在、AirtableのIDはAdaloにテキストとして取り込まれます。数値形式でないIDをサポートできないため、MagicTextでAirtable IDを使用することはできません。 2023年から2024年にかけてAirtableが導入した新しい変更があり、この統合の設定方法に影響を与える可能性があります。特定のユースケースに応じて指示に従うようにしてください。
Airtableを初めて設定している場合 以下の手順に従ってください。
すでにAPIキーでAirtableを設定している場合 2024年2月1日にAPIキーが廃止されるため、APIキーの代わりに個人アクセス トークンを使用する必要があります。この変更を行うには、以下の手順に従ってください。
すべてが明確であることを確認するために、これらの変更の重要な日付は次のとおりです: **2023年8月1日:** ユーザーは新しいAPIキーを作成できなくなります。 **2024年2月1日（来年）:** 既存のAPIキーを使用してAirtable APIにアクセスすることはできません。 ### 1) 個人アクセス トークンを生成する 外部コレクションを介してAirtableデータベースをAdaloに接続するためには、個人アクセス トークンが必要です。[/create/tokens](https://airtable.com/create/tokens) から、「新しいトークンを作成」ボタンをクリックして新しい個人アクセス トークンを作成してください。これらの手順は[Airtableのドキュメント](https://airtable.com/developers/web/guides/personal-access-tokens?utm_ID=recdXE5vJZZ5vR0mh\&utm_source=lifecycle_team\&utm_medium=email\&utm_campaign=it_ss_ss_api_depreciation\&utm_content=email-blast_api_key_users) に記載されていますが、ここで共有しているので簡単にアクセスできます。
1. Airtableにログイン 2. 右上のアカウントをクリック 3. 中央下部で < > Developer HUB を選択 4. トークンを作成をクリック 5. トークンにユニークな名前を付けます。 6. トークンに付与する[スコープ](https://airtable.com/developers/web/api/scopes)を選択します。これにより、トークンが使用できるAPIエンドポイントが制御されます。 7. トークンにベースまたはワークスペースへのアクセス権を付与するために「ベースを追加」をクリックします。 {% hint style="info" %} 任意の組み合わせや数のベースやワークスペースへのアクセス権を付与できます。アカウント内のすべてのワークスペースとベースへのアクセス権を付与することもできます。ただし、トークンは割り当てられたベースとワークスペース内のデータの読み取りと書き込みしかできませんことを念頭に置いてください。 {% endhint %} 8. トークンが作成されると、Airtableは1度だけ表示されるため、クリップボードにコピーして安全な場所に保存することを強くお勧めします。[create/tokens](https://airtable.com/create/tokens) で管理できますが、センシティブなトークン自体はセキュリティ上の理由から保存されません。 ### 2) Airtable内のテーブルのAPIベースURLを見つける Airtable APIをAdaloに接続するには、Base URLを取得し、認証を設定する必要があります。*注意*：一部のAPIは認証を必要としない場合がありますが、Airtableではそのようなことはありません。詳細な手順については個々のスクリーンショットを参照してください。 1. Adaloの有料プランにアップグレードしていることを確認し、Adaloにログインします。Adaloにログイン > アカウントに移動 > 設定 > チームと請求 > プランを選択 > クレジットカード情報を入力します。 2. Adaloの左側のナビゲーションバーで、データベースアイコンをクリックし、外部コレクション（APIに接続）の下にある+ コレクションリンクを選択します。 ![](/files/mqfx31GgjQmBmnmSzCwm) 3. コレクションに名前を付けます。コレクション名はAirtableのテーブルと同じ名前にする必要があります。 4. Airtableにサインインし、使用したいベースを開きます。 5. 右上のヘルプリンクをクリックします。 6. 右下のAPIドキュメントを選択します。
7. 左側で、Adaloと統合したいテーブルをクリックします。 8. レコードの一覧をクリックします。
9. コードの先頭にあるURLがあります。これがBaseURLです。\_https:\_から?の前までをコピーします。?やその後の部分はコピーしないでください。このBaseURLをAdaloのBaseURLセクションに入力します。
## 3) 認証の設定 1. 認証を設定するには、+ アイテムをクリックしてからヘッダーを選択します。
2. コード例のBaseURLのすぐ下にHがあることに注意してください。Airtableを使用する場合、ヘッダーは常に必要ですが、一部のAPIはクエリや複数の認証形式を使用します。 3. 名前欄に"Authorization"を入力します。 4. 値欄に、最初に生成した"Bearer YOUR\_ACCESS\_TOKEN"を入力します。 ### 3) APIエンドポイントの設定 エンドポイントは、データを操作するためのメソッドをプログラムで作成する単語です。通常、以下のように表されます：\ Get = レコードの取得（すべてを取得するか、パラメータを使用して1つを取得する）\ Post = レコードの作成\ Delete = レコードの削除\ PutまたはPatch = レコードの更新 Airtableでは、テストが成功するために必要な非常に特定の機能があります。GET ALLエンドポイントのアコーディオンでは、Results Keyとして**records**という単語を使用する必要があります。(*注意*：一部のAPIではResults Keyがない場合があり、これを空白のままにしておくことができます。他のAPIでは異なるキーワードがある場合があります。Results Keyの場所は下の中央の画像で確認できます。) ![](/files/iq9KPWEOor1Nryphnadv) Airtableは、レコードを更新するためにPUTまたはPATCHを使用する機能を両方提供する点でもユニークです。通常、APIはこれらのうちの1つしか使用しません。Airtableに接続する際は、PATCHエンドポイントを使用することをお勧めします。これにより、テーブル内の特定のフィールドが更新され、他の入力はそのままになります。PUTエンドポイントを使用すると、編集したフィールドが更新されますが、その行の他のフィールドが削除されます。 ![Adalo\_Endpoints\_Put-Patch](/files/zdfTdBvek5o72upcLPC8) この時点で、「次へ」をクリックする準備が整いました。API接続でテストを実行し、成功し、新しい外部コレクションがAdaloプロジェクトに追加されることを期待します。 ![Adalo\_API\_test\_successful](/files/8kI74a7qCRcUxqE29J59) Adalo内で再度外部データベースに接続する必要はありません（上記の手順に従ってください）**Airtableベースに新しいプロパティ列を追加しない限り**。新しい行は自動的に更新されます。外部データベースに再度接続するには、コレクションの横にある3つのボタンメニューを選択し、設定を編集して、最後まで進んでください。フィールドを再度更新する必要はありません。 ![Adalo\_API\_reconnect](/files/cSwHnZpStb0Urkoo8bba) ### トラブルシューティング **Q.** なぜAirtableのプロパティがAdaloの外部コレクションに表示されなかったのですか？\ **A.** Airtableの列全体が空の場合、そのプロパティはAdaloに転送されません。すべての列が完了したレコードが少なくとも1つ必要です。 **Q.** Adaloに表示されるこれらの追加プロパティフィールドや異なる名前は何ですか？\ **A.** 接続が発生すると、各プロパティの前に「フィールド」という単語が付加されます。フォームのラベルを使用する際にこれらを編集できます。id、attachments > id、attachments > thumbnailsなど、不要な追加のフィールド/プロパティがAdaloの外部コレクションに表示されることがあります。これらは必要ない場合は削除できます。idやcreatedTimeのプロパティは決して使用しないでください。 **Q.** Adaloの外部コレクションにはなぜ1つの画像/添付ファイルしか表示されないのですか？\ **A.** 1つのプロパティに複数の添付ファイルをサポートしていないため、Adaloは最初の添付ファイルのみを表示します。Airtableでそれらをそれぞれの列に分ける必要があります。 **Q.** なぜプロパティの分類が一致しないのですか？\ **A.** AirtableにはAdaloよりも多くのプロパティフィールドの分類が含まれています。一致する分類がない場合、Adaloではデータがテキストプロパティに配置されます。 **Q.** なぜAirtableのデータベースの計算式が更新されなかったのですか？\ **A.** 当社のプラットフォームは、Airtableの計算式プロパティにエントリの更新を行いません。 *例:* Airtableに「商品の価格」のプロパティがあり、価格の半額を示す別のプロパティがあり、「商品の価格/2」が設定されています。Adaloは、このプロパティを更新できません。価格のプロパティを更新する必要があります。 **Q.** Airtableの「選択肢」プロパティがAdaloにドロップダウンメニューとして転送されなかったのはなぜですか？ **A.** 現時点では、Airtable のドロップダウンプロパティはサポートされていません。ユーザーがドロップダウンから正しいアイテムを選択した場合は受け入れられますが、そうでない場合は転送されません。ユーザーに入力オプションを伝えるか、このプロパティを使用しないようにすることが重要です。 **Q.** データを更新しようとしたら、データベースの他の部分が消えてしまいました。\ **A.** エンドポイントを設定する際に、更新セクションに PUT の代わりに PATCH を入力したか確認してください。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.adalo.com/ja/integrations/airtable/connecting-to-airtable.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.