Google広告と天気APIの連動について

Question

Google広告と天気APIの連動をしたいのですが、ドキュメントにある以下の箇所について2つ質問です。

ドキュメントURL：https://developers.google.com/google-ads/scripts/docs/solutions/weather-based-campaign-management#generic-weather

【該当箇所】

/**
 * Make a call to the OpenWeatherMap server.
 *
 * @param {string} endpoint the server endpoint.
 * @param {string} location the location for which weather
 *     information is retrieved.
 * @return {Object} the server response.
 */
function callWeatherServer(endpoint, location) {
    var url = Utilities.formatString(
      '%s?APPID=%s&q=%s',
      endpoint,
      encodeURIComponent(OPEN_WEATHER_MAP_API_KEY),
      encodeURIComponent(location));
  var response = UrlFetchApp.fetch(url);
  if (response.getResponseCode() != 200) {
    throw Utilities.formatString(
        'Error returned by API: %s, Location searched: %s.',
        response.getContentText(), location);
  }

  var result = JSON.parse(response.getContentText());

  // OpenWeatherMap's way of returning errors.
  if (result.cod != 200) {
    throw Utilities.formatString(
        'Error returned by API: %s,  Location searched: %s.',
        response.getContentText(), location);
  }
  return result;
}

【質問①】

      '%s?APPID=%s&q=%s',

ここにはAPIコールのURL(今回はOpenWeatherMap)を入れるといいでしょうか。これが指している意味がよく分からずでして...

【質問②】

'Error returned by API: %s, Location searched: %s.',

質問①と似ていますが、ここも%のところを取得したい地名にするという意味でしょうか。

初歩的な質問ですみません。
よろしくお願いします。

Comments

[Lhankor_Mhy]

Google App Script でしたら、そのように質問タグを追加することをおすすめします。
https://teratail.com/tags/Google+Apps+Script

[gomasan]

有難うございます。Google App Scriptのタグは元々ありましたが、JSもつけていましたので、JSを外しました！対応が間違っていたらすみません、、

[Lhankor_Mhy]

え、そうでしたか、それは失礼いたしました。見間違っていたようです。

Answer 1

ドキュメント formatString(template, args) にあるように template のなかのフォーマット文字列を第２パラメータ以降で順に置き換えた文字列を返します。

質問１の

Utilities.formatString(

  '%s?APPID=%s&q=%s',
  endpoint,
  encodeURIComponent(OPEN_WEATHER_MAP_API_KEY),
  encodeURIComponent(location));

の '%s?APPID=%s&q=%s', であれば、

1つめの %s は、endpoint の内容で
2つめの %s は、encodeURIComponent(OPEN_WEATHER_MAP_API_KEY)の内容で
3つめの %s は、encodeURIComponent(location)の内容で
それぞれ置き換えられて、変数 url に代入されます。

Comments

[gomasan]

なるほど、、！ありがとうございます！！！