Apps Script の高度なサービスを使用すると、経験豊富なデベロッパーは、HTTP インターフェースを使用する場合よりも少ない設定で、特定のパブリック Google API に接続できます。拡張サービスは、基本的にこれらの Google API をラップしたものです。これらのサービスは、Apps Script の組み込みサービスとよく似ています。たとえば、オートコンプリート機能があり、認可フローは Apps Script によって自動的に処理されます。ただし、スクリプトで拡張サービスを使用できるようにするには、拡張サービスを有効にする必要があります。
拡張サービスとして利用できる Google API を確認するには、リファレンスの高度な Google サービス セクションをご覧ください。上級者向けサービスとして利用できない Google API を使用する場合は、他の外部 API と同様に接続します。
高度なサービスと HTTP のどちらですか？
各 Google 拡張サービスは、公開 Google API に関連付けられています。Apps Script では、拡張サービス経由でこれらの API にアクセスできます。また、UrlFetch を使用して API リクエストを直接行うこともできます。
高度なサービス メソッドを使用する場合、Apps Script は承認フローを処理し、予測入力のサポートを提供します。ただし、拡張サービスを使用する前に、拡張サービスを有効にする必要があります。また、一部の高度なサービスでは、API で利用可能な機能のサブセットのみが提供されます。
UrlFetch メソッドを使用して API に直接アクセスする場合、基本的に Google API は外部 API として扱われます。この方法では、API のすべての側面を使用できます。ただし、API の認可はご自身で処理する必要があります。また、必要なヘッダーを作成し、API レスポンスを解析する必要があります。
一般的に、可能な限り拡張サービスを使用し、拡張サービスで必要な機能が提供されない場合にのみ UrlFetch メソッドを使用するのが最も簡単です。
要件
拡張サービスを使用するには、次の要件を満たす必要があります。
- スクリプト プロジェクトで高度なサービスを有効にする必要があります。
スクリプトで使用する Cloud Platform（GCP）プロジェクトで、高度なサービスに対応する API が有効になっていることを確認する必要があります。
2019 年 4 月 8 日以降に作成されたデフォルトの GCP プロジェクトをスクリプト プロジェクトで使用している場合、拡張サービスを有効にしてスクリプト プロジェクトを保存すると、API が自動的に有効になります。まだ同意していない場合は、Google Cloud と Google API の利用規約への同意を求められる場合もあります。
スクリプト プロジェクトで 標準の GCP プロジェクトまたは古いデフォルトの GCP プロジェクトを使用している場合は、GCP プロジェクトで高度なサービスの対応する API を有効にする必要があります。この変更を行うには、GCP プロジェクトに対する編集権限が必要です。
詳細については、Cloud Platform プロジェクトをご覧ください。
高度なサービスを有効にする
Google の拡張サービスを使用する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- 左側の [エディタ] をクリックします。
- 左側の [サービス] の横にある [サービスを追加] をクリックします。
- 高度な Google サービスを選択し、[追加] をクリックします。
高度なサービスを有効にすると、そのサービスが自動入力で使用できるようになります。
メソッド シグネチャの決定方法
一般に、Advanced Service は、対応する公開 API と同じオブジェクト、メソッド名、パラメータを使用しますが、メソッド シグネチャは Apps Script で使用するために変換されます。通常、スクリプト エディタの自動補完機能で十分な情報が得られますが、以下のルールでは、Apps Script が公開 Google API からメソッド シグネチャを生成する方法について説明します。
Google API へのリクエストは、パスパラメータ、クエリ パラメータ、リクエスト本文、メディア アップロードの添付ファイルなど、さまざまな種類のデータを受け入れることができます。一部の高度なサービスでは、特定の HTTP リクエスト ヘッダーを受け入れることもできます（カレンダーの高度なサービスなど）。
Google Apps Script の対応するメソッド シグネチャには、次の引数があります。
- リクエスト本文（通常はリソース）を JavaScript オブジェクトとして指定します。
- パスまたは必須パラメータ（個別の引数として）。
- メディア アップロード アタッチメント（
Blob引数）。 - オプション パラメータ（パラメータ名を値にマッピングする JavaScript オブジェクト）。
- HTTP リクエスト ヘッダー（ヘッダー名をヘッダー値にマッピングする JavaScript オブジェクト）。
メソッドに特定のカテゴリの項目がない場合、その部分はシグネチャから省略されます。
ただし、次のような特別な例外があります。
- メディア アップロードを受け入れることができるメソッドの場合、パラメータ
uploadTypeは自動的に設定されます。 - Google API で
deleteという名前の関数は、JavaScript の予約語であるため、Apps Script ではremoveという名前になります。delete - 拡張サービスが HTTP リクエスト ヘッダーを受け入れるように構成されており、リクエスト ヘッダーの JavaScript オブジェクトを設定する場合は、オプション パラメータの JavaScript オブジェクト（オプション パラメータを使用しない場合は空のオブジェクト）も設定する必要があります。
高度なサービスのサポート
拡張サービスは、Apps Script 内で Google API を使用できるようにするシンラッパーにすぎません。そのため、使用中に発生する問題は通常、Apps Script 自体の問題ではなく、基盤となる API の問題です。
高度なサービスを使用しているときに問題が発生した場合は、基盤となる API のサポート手順に沿って報告する必要があります。これらのサポート手順へのリンクは、Apps Script のリファレンス セクションの各拡張サービス ガイドに記載されています。