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
。
高度なサービス メソッドを使用する場合は、Apps Script が 承認フローとオファー 予測入力のサポート。ただし、 拡張サービスを有効にします。 できます。また、一部の拡張サービスでは、 API で利用できる機能について説明します
UrlFetch
メソッドを使用して API に直接アクセスする場合、次のようになります。
Google API を Google API を
外部 API。この方法では
使用できます。ただし、これを使用するには API を
承認します。また、必要なヘッダーを作成し、
作成されます。
一般的には、可能な限り高度なサービスを使用するのが最も簡単です。
拡張サービスで詳細な分析情報が提供されない場合は、UrlFetch
メソッドを使用します。
必要な機能だけを提供します。
要件
拡張サービスを使用するには、次の要件を満たしている必要があります。 要件:
- 拡張サービスを有効にする必要があります。 必要があります。
拡張サービスに対応する API が有効になっていることを確認する必要があります Cloud Platform(GCP)プロジェクト内 表示されます。
スクリプト プロジェクトがデフォルトの GCP プロジェクトを使用する場合 作成された場合、API は自動的に有効になります。 拡張サービスを有効にしてスクリプト プロジェクトを保存した後、もし まだ実施していない場合は、 Google Cloud Google API の利用規約が適用されます。
スクリプト プロジェクトで 標準の GCP プロジェクト 古いデフォルトの GCP プロジェクトなので 拡張サービスに対応する API を有効にする必要があります。 手動で行う必要はありません。GCP プロジェクトの編集権限が必要です。 この変更を行います。
Cloud Platform プロジェクトをご覧ください。 をご覧ください。
拡張サービスを有効にする
Google の拡張サービスを使用する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- 左側の [エディタ] をクリックします。
- 左側の [サービス] の横にある [サービスを追加] をクリックします。 。
- Google の拡張サービスを選択し、[追加] をクリックします。
有効にした拡張サービスは、予測入力で使用できるようになります。
メソッド シグネチャの決定方法
拡張サービスでは一般に、同じオブジェクト、メソッド名、パラメータを使用する。 ただし、メソッド シグネチャは対応する公開 API として認識されますが、 使用するスクリプトです。スクリプト エディタの 予測入力関数 通常は開始するのに十分な情報が提供されますが、以下のルールで Apps Script が公開 Google API からメソッド シグネチャを生成する仕組み。
Google API へのリクエストでは、さまざまな種類のデータ、 (パスパラメータ、クエリ パラメータ、リクエスト本文、メディア イベント、 添付ファイルをアップロードしてください。一部の高度なサービスでは、特定の HTTP リクエストを受け入れ、 ヘッダー(たとえば、 Calendar Advanced Service を参照)。
Google Apps Script の対応するメソッド シグネチャは次のとおりです。 引数:
- リクエスト本文(通常はリソース)。JavaScript オブジェクトで指定します。
- パスまたは必須パラメータ(個別の引数)。
- メディア アップロードの添付ファイル(
Blob
形式) 渡します。 - オプションのパラメータ。パラメータ名を 使用できます。
- HTTP リクエスト ヘッダー。ヘッダー名をヘッダーにマッピングする JavaScript オブジェクトとして解釈されます。 使用できます。
メソッドが特定のカテゴリにアイテムを持たない場合、 署名は省略されます。
以下の特別な例外にご注意ください。
- メディア アップロードを受け入れるメソッドの場合、パラメータ
uploadType
が設定されます。 自動的に適用されます。 - Google API で
delete
という名前のメソッドは、Apps Script ではremove
という名前になっています。delete
は JavaScript の予約語であるためです。 - 拡張サービスが HTTP リクエスト ヘッダーを受け入れるように構成されていて、 リクエスト ヘッダーの JavaScript オブジェクトを設定する場合は、オプションの parameters JavaScript オブジェクト(使用していない場合は空のオブジェクト) オプション パラメータ)。
拡張サービスのサポート
拡張サービスは単にシンラッパーであり、これを使用して Google Cloud の 使用することもできます。そのため、使用中に発生した問題は 通常は Apps Script 自体ではなく、基になる API の問題です。
拡張サービスの使用中に問題が発生した場合は、 基になる API のサポート手順に沿って報告されます。これらへのリンク サポート手順については、 Apps Script のリファレンス セクション。