APIキーは、ImageToTable.aiアカウントの認証情報です。外部ツールがあなたのアカウントとして動作できるようにします。Google Sheets アドオンはサインインの代わりにAPIキーで接続でき、v1 APIは毎回の呼び出しでAPIキーを使用します。このページでは、キーの場所、交換方法、交換後に更新すべき内容について説明します。
APIキーの確認方法
キーはプロフィールページのAPIキーというセクションにあります。アプリの右上隅にあるアカウントメニュー（アバターとユーザー名が表示されているメニュー）を開き、プロフィールを選択してください。
そのセクションには、キーに必要な情報がすべて表示されます：
- キー自体は、デフォルトではドットで隠されています。目のボタンで表示し、コピーボタンでコピーできます。
- キーがすでに存在する場合はAPIキーを再生成、まだ存在しない場合はAPIキーを生成というボタンが表示されます（その場合、セクションにはAPIキーがまだありませんと表示されます）。
- キーが外部ツール用であること、秘密に保つよう注意を促す短いメモ、およびAPIドキュメントへのリンクがあります。
キーはパスワードと同じように扱ってください。キーは特定のツールではなくアカウントに属しているため、同じ値がキーを受け付けるすべての場所で機能します。そして、キーを持っている人は誰でもあなたのアカウントとして操作できます。そのため、セクションでは秘密に保つよう注意を促しています。
APIキーの再生成
アカウントにはAPIキーが1つだけ保持されます。再生成は2つ目のキーを追加するのではなく、その値を置き換えるため、有効なキーは常に1つだけです。確認手順はアカウントのサインイン方法によって異なります。Googleサインインで作成されたアカウントには、ここで入力するパスワードがないためです。
パスワードでサインインするアカウントの場合
APIキーを再生成を選択すると、パスワードの入力を求めるプロンプトが表示されます。キーがすでに存在する場合、プロンプトはパスワードを尋ねる前に現在のキーが無効化されることを示します。キーがまだない場合は、作成するためにパスワードを求めます。アカウントのパスワードを入力して確認すると完了します。
パスワードが一致しない場合、何も変更されず、ページにパスワードが正しくなかったことが表示されます。
Googleサインインに連携しているアカウントの場合
Googleでサインインするアカウントの場合、確認はパスワードではなくGoogleサインインの手順になります。APIキーを再生成を選択すると、本人確認というタイトルのダイアログが開き、Googleを通じて確認するよう求められます。アカウントにキーがすでにある場合、ダイアログは現在のキーが最初に無効化されることを通知します。
これは、上記のパスワードプロンプトが利用できない場合に使用する方法です。Googleサインインで作成されたアカウントが該当します。
再生成後：キーを使用している場所を更新する
新しいキーの生成はすぐに有効になります。以前の値はその時点で機能しなくなり、猶予期間も両方のキーを有効に保つ方法もありません。古いキーを送信しているものはすべて、新しいキーが渡されるまで拒否されます。
| キーの使用場所 | 再生成後の対応 |
|---|---|
| Google Sheets アドオン | サイドバーのアカウントセクションを開き、APIキーを貼り付けボックスに新しいキーを貼り付けます。代わりにGoogleでサインインで接続している場合、キーはまったく使用されないため変更は不要です。 |
| v1 API | アプリケーションがキーを保存しているすべての場所で、古いキーを新しいキーに置き換えます。古いキーを使用した呼び出しは認証されなくなるため、次回の実行前にキーを更新してください。 |
再生成で変更されるのはキーのみです。ファイル、テンプレート、クレジット、プランは変更されず、新しいキーは古いキーと同じアクセス権を持ちます。
よくある質問
キーを紛失しました。再度確認できますか？
はい、サインインできれば可能です。プロフィールページには常に現在のキーが表示されており、目のボタンで表示するまでドットで隠されています。そこからコピーできます。再利用するよりも置き換えたい場合は、APIキーを再生成を使用してください。
同時に複数のキーを持つことはできますか？
いいえ。アカウントにはAPIキーが1つだけ保持されます。再生成すると置き換えられるため、新しいキーが生成された時点で以前の値は機能しなくなります。
Google Sheets アドオンは常にキーが必要ですか？
いいえ。アドオンはGoogleでサインインするか、APIキーを貼り付けるかのいずれかで接続できます。Googleサインインで接続した場合、サイドバーはキーを使用せず、キーを再生成してもその接続には影響しません。キー自体を使用している場所のみ更新が必要です。Google Sheets アドオンをご覧ください。
v1 APIはこのキーを使用しますか？
はい。すべてのv1 API呼び出しはキーで認証されるため、再生成後は古いキーを交換する必要があります。APIアクセスでは、APIの対象者と必要な要件について説明しています。完全なリファレンスは開発者ドキュメントサイトにあります。