Google Apps Script は、ウェブ全体から API と対話できます。このガイドでは、スクリプトでさまざまなタイプの API を使用する方法について説明します。
公開 API に接続する
UrlFetch
サービスを使用して、API リクエストを直接送信できます。
次の例では、GitHub API を使用して、「Apps Script」に言及しているスターが 100 個以上あるリポジトリを検索します。この API リクエストには認証や API キーは必要ありません。
var query = '"Apps Script" stars:">=100"';
var url = 'https://api.github.com/search/repositories'
+ '?sort=stars'
+ '&q=' + encodeURIComponent(query);
var response = UrlFetchApp.fetch(url, {'muteHttpExceptions': true});
Logger.log(response);
OAuth を使用してサービスにリクエストを送信する
通常、ユーザーの代理として動作する API は承認を必要とし、多くの場合は OAuth プロトコルを使用します。Apps Script はこのプロトコルの組み込みサポートを提供していませんが、オープンソース ライブラリを使用して OAuth フローを実行し、リクエストで認証情報を送信できます。
- OAuth1 for Apps Script: OAuth 1.0、1.0a と互換性があります。
- OAuth2 for Apps Script: OAuth2 と互換性があります。
JSON を操作する
JSON オブジェクトの操作は XML の操作と似ていますが、JSON オブジェクトの解析またはエンコードが非常に簡単です。
リクエストされた API がリクエストに対して未加工の JSON レスポンスを返す場合、HTTPResponse.getContentText()
メソッドを使用して JSON 文字列レスポンスにアクセスできます。この文字列を取得したら、文字列で JSON.parse()
を呼び出すだけで、ネイティブ オブジェクト表現を取得できます。
// Make request to API and get response before this point.
var json = response.getContentText();
var data = JSON.parse(json);
Logger.log(data.title);
同様に、リクエストを行うために JavaScript オブジェクトの文字列表現を作成するには、JSON.stringify()
を使用します。
var data = {
'entry': {
'group': {
'title': 'Dog Skateboarding',
'description': 'My dog gets some serious air'
},
'keywords': 'dog, skateboard'
}
}
var payload = JSON.stringify(data);
// Make request to API with payload after this point.
XML を解析する
外部 API がリクエストに対して未加工の XML レスポンスを返す場合、HTTPResponse.getContentText()
メソッドを使用して XML レスポンスにアクセスできます。
// Make request to API and get response before this point.
var xml = response.getContentText();
var doc = XmlService.parse(xml);
API に XML リクエストを送信する場合は、XmlService
メソッドを使用して送信する XML を作成します。
var root = XmlService.createElement('entry')
.setAttribute('keywords', 'dog, skateboard');
var group = XmlService.createElement('group')
.setAttribute('title', 'Dog Skateboarding');
.setAttribute('description', 'My dog gets some serious air');
root.addContent(group);
var document = XmlService.createDocument(root);
var payload = XmlService.getPrettyFormat().format(document);
// Make request to API with payload after this point.