認証とAPIキー

APIキーの送り方、保持できるキーの数、キーでできること・できないこと、キーが漏れたときの対処、AIアシスタントの接続を解除する方法です。

最終更新日：2026/10/11

キーはAuthorizationヘッダーで送る

Authorization: Bearer YOUR_API_KEY

APIがキーを読み取るのは、このヘッダーだけです。

キーをURLに含めないでください（?api_key=…）。URLはログ、ブラウザの履歴、共有したリンクに残ります。APIはそのようなリクエストを400 api_key_in_queryで拒否します。そのキーは漏えいしたものとして扱い、無効にして新しいキーを作成してください。
https://gloriads.com/api/v1を正確に呼び出してください。リダイレクトをたどって別のアドレスに移るクライアントは、途中でキーを落とします。
APIは、スプレッドシート、スクリプト、サーバーから呼び出してください。Webページのコードから呼び出すと、ページの訪問者が誰でもキーを読み取れてしまいます。

設定 → API → キーを作成。

名前は40文字まで入力できます。あとで無効にするキーがわかるよう、ツールの名前を付けてください。
キーが表示されるのは1回だけです。保存するのはキーのフィンガープリントだけなので、誰も（Gloriadsでさえ）キーを再表示できません。パスワードマネージャーや、ツールのシークレット設定に保管してください。
同時に保持できるキーは10個です。
公開デモアカウントではキーを作成できません。

各キーには、名前、最初の数文字（key_live_ab12…）、作成日、最終使用日が表示されます。

「最終使用日」の更新は最大で1時間に1回のため、数分前に使ったキーでも、それより前の時刻が表示されることがあります。

キーの**⋯**メニューを開き、無効にするを選びます。

すぐに反映されます。そのキーを使った次のリクエストには401 unauthorizedが返されます。存在しないキーと同じレスポンスです。無効にしたキーは元に戻せません。新しいキーを作成してください。

claude.aiとChatGPTはキーを使いません。アシスタントからGloriadsにログインし、許可をクリックします。アシスタントには、読み取り専用の個別のアクセス権が付与されます。接続方法はAIアシスタントを接続をご覧ください。

設定 → API → 接続済みのアプリに、各アシスタント、アクセスを求めたアドレス、接続日、最後にアカウントを読み取った日時（更新は最大で1時間に1回）が表示されます。
名前の横の未確認は、そのアプリが自分のアドレスを証明せずに登録したことを示します。ご自身で接続した場合だけ、そのままにしてください。
接続を止めるには、**⋯**メニューを開き、接続を解除を選びます。すぐに反映されます。再び使うには、アシスタントからもう一度接続します。

レスポンス	理由	対処
`401 unauthorized`	`Authorization`ヘッダーがない、またはキーが誤っているか無効にされている	ヘッダーとキーを確認する
`403 subscription_inactive`	サブスクリプションが終了している	設定 → 請求で登録する
`400 api_key_in_query`	キーがURLに含まれていた	キーをヘッダーに移し、そのキーを無効にする

ほかのすべてのコードは、制限とエラーで説明しています。

APIリファレンスのTry itボタンには、公開キーが入力済みです。このキーが読み取るのはデモアカウントだけで、すべての訪問者で共有する1分あたり10リクエストに制限されています。ご自身のアカウントは読み取れないため、その場合はご自身のキーを使ってください。