Google Apps Script Documentation - UrlFech Services

Googleを追いかけろ！

home >> UrlFech Services >> Class UrlFechApp

Class UrlFechApp
.. インターネット上でHTTP要求を送信。 URLを回収して他のWeb上のアプリケーションやリソースと交信したりアクセスできるようにするサービスです。UrlFetch Serviceを利用したスクリプトはHTTP（HTTPS）リクエストやレスポンスの受信を発行できます。

UrlFetchApp : Members
member	Type	説明
fetch	HTTPResponse	URLを取得するようにリクエストする：この機能はHTTP経由でもHTTPS経由でも同様に動作する
addOAuthService	OAuthConfig	実験的に：OAuthのサービスの構成オブジェクトを返す

method fetch(url, optAdvancedArgs)

URLを取得するようにリクエストする：この機能はHTTP経由でもHTTPS経由でも同様に動作する

Arguments :
name	Type	説明
url	String	取得すべきURL
optAdvancedArgs	Object	未定義

Advanced Arguments :
name	Type	説明
contentType	String	コンテンツタイプ(初期値： 'application/x-www-form-urlencoded')
headers	Object	要求のHTTPヘッダーのJavaScriptのキー/値マップ
method	String	リクエストのHTTPメソッド：'post', 'get', 'put', 'delete'... （デフォルトは'get'）
payload	String	要求のペイロード（例えばPOST本体）：特定のHTTPメソッド（例：GET）は、ペイロードを持てない。
useIntranet	bool	SDCを介してドメインにリンクされたイントラネット内で指定されたURLを解決するようにフェッチに指示を出す
oAuthServiceName	String	oAuthのサービスの文字列識別子：例を参照
oAuthUseToken	String	OAuthのトークンの使用ポリシーを示す文字列（"always", "if_available", "never", "require_present"）：例を参照

戻り値 :
Type	説明
HTTPResponse	HTTP応答データ

サンプル :
// The code below shows the HTML code of the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Browser.msgBox(response.getContentText());

サンプル :

// This sample pulls in your tweets from Twitter and puts them in a spreadsheet.
// 
//  First: set up Script Properties "twitterConsumerKey" and 
// "twitterConsumerSecret" with values provided to you by Twitter.

var fields = {'in_reply_to_screen_name':true,'created_at':true,'text':true};

function tweet() {
  // Setup OAuthServiceConfig
  var oAuthConfig = UrlFetchApp.addOAuthService("twitter");
  oAuthConfig.setAccessTokenUrl("http://api.twitter.com/oauth/access_token");
  oAuthConfig.setRequestTokenUrl("http://api.twitter.com/oauth/request_token");
  oAuthConfig.setAuthorizationUrl("http://api.twitter.com/oauth/authorize");
  oAuthConfig.setConsumerKey(ScriptProperties.getProperty("twitterConsumerKey"));
  oAuthConfig.setConsumerSecret(ScriptProperties.getProperty("twitterConsumerSecret"));

  // Setup optional parameters to point request at OAuthConfigService.  The "twitter"
  // value matches the argument to "addOAuthService" above.
  var options =
    {
      "oAuthServiceName" : "twitter",
      "oAuthUseToken" : "always"
    };

  var result = UrlFetchApp.fetch("http://api.twitter.com/1/statuses/user_timeline.json", options);
  var o  = Utilities.jsonParse(result.getContentText());
  var doc = SpreadsheetApp.getActiveSpreadsheet();
  var cell = doc.getRange('a1');
  var index = 0;
  for (var i in o) {
    var row = o[i];
    var col = 0;
    for (var j in row) {
      if (fields[j]) {
        cell.offset(index, col).setValue(row[j]);
        col++;
      }
    }
    index++;
  }
}

method addOAuthService(id)

実験的に：OAuthのサービスの構成オブジェクトを返す
( 参考 :addOAuthService)

Arguments :
name	Type	説明
id	String	サービスの識別子："fetch"の呼び出しフィールド内で"oAuthServiceName"用に使用する

戻り値 :
Type	説明
OAuthConfig	構成オブジェクト

サンプル :

var oAuthConfig = UrlFetchApp.addOAuthService("twitter");
  oAuthConfig.setAccessTokenUrl("http://api.twitter.com/oauth/access_token");
  oAuthConfig.setRequestTokenUrl("http://api.twitter.com/oauth/request_token");
  oAuthConfig.setAuthorizationUrl("http://api.twitter.com/oauth/authorize");
  oAuthConfig.setConsumerKey(ScriptProperties.getProperty("twitterConsumerKey"));
  oAuthConfig.setConsumerSecret(ScriptProperties.getProperty("twitterConsumerSecret"));