APIとは？
サービス同士をつなぐ「決められた窓口」

APIは「人ではなく、ソフトが使う受付窓口」

人がサービスを使うときは、ボタンや入力フォームなどの画面を操作します。一方APIは、別のプログラムがそのサービスを使うための入口です。

MDNでは、APIを「ソフトウェアが外部とやり取りするための機能や規則の集まり」と説明しています。

たとえば何に使うの？

• ネットショップから決済サービスへ支払いを依頼する
• 予約システムからGoogle Calendarへ予定を登録する
• 業務ツールから顧客情報を取得・更新する
• AIサービスへ文章を送り、生成結果を受け取る
• 配送サービスへ送り状の作成を依頼する
• 天気・地図・在庫など外部サービスのデータを取得する

「別々のサービスなのに連携できる」のは、間にAPIが用意されているから、というケースが多くあります。

APIを使うときに出てくる言葉

最初から用語を全部覚える必要はありません。「お願いを送る → 結果が返る」が分かれば、基本のイメージとして十分です。

APIキーって何？

APIによっては、「誰が使っているか」「その利用者に権限があるか」を確認するために、APIキーやアクセストークンなどの認証情報を使います。

すべてのAPIがAPIキー方式ではありません。ログイン連携で使われるOAuthなど、用途に応じて別の認証方法もあります。

GASからAPIを使うこともできる

Google Apps Scriptには、外部のWeb APIへリクエストを送るための機能があります。そのため、Google Workspaceの中だけでなく、外部サービスと連携する自動化も作れます。

ただし、APIの料金・回数制限・認証・利用規約は、連携先サービスごとに確認する必要があります。

APIを使えば何でも自動化できる？

APIが提供されていない機能は、そのAPI経由では操作できません。また、APIがあっても利用できる範囲や回数、料金、契約プランが決まっている場合があります。

• 必要な機能がAPIで公開されているか
• API利用に料金がかかるか
• 1分・1日などの利用回数制限があるか
• どんな権限・認証が必要か
• 顧客情報などを外部へ送ってよいか

そのため、「連携できそうだからAPIを使う」ではなく、業務とデータの扱いに合うかを確認してから使います。

APIとWebhookは何が違う？

ざっくり言うと、APIはこちらから聞きに行く・お願いするときに使い、Webhookは何か起きたら向こうから知らせてもらうときによく使われます。

よくある質問

参考資料

関連ガイド