GASでPA-API(Amazon API)を使えるようにした

お久しぶりです．

はじめに
本題
まとめ

はじめに

今回はAmazonアソシエイトに含まれるProduct Advertising API 5.0 (PA-API 5.0) をGAS(Google Apps Script)で実装した話です．

まずAmazonアソシエイトとはなんぞや，ってところです

アフィリエイトという言葉を日本語訳すると「提携する」ことを意味します。一般的なアフィリエイト・プログラムとは、個人や企業のホームページから、ECサイト（広告主）にリンクをはり、閲覧者がそのリンクを経由して広告主のサービスや商品を購入した場合にリンク元の運営者に報酬が支払われるという広告手段です。Amazon.co.jpではこれを独自にAmazon アソシエイト・プログラムと呼んでいます。

ざっくりいうと自分の情報が含まれたリンクから誰かが商品を買ったときにいくばくかの報酬がもらえる，というものです．

これを利用するためには事前に登録して審査に合格する必要があるのですが，詳細は各々調べてみてください．

そんなAmazonアソシエイトの中にPA-APIと呼ばれる機能があります．

これを利用するとプログラムからAPIを叩くことで商品情報などを取得できるようになります．

PA-APIにはSDKと呼ばれる開発キットが用意されており，簡単に使うことができます．

が，用意されているSDKはPHP，Java，Node.js，Pythonに限られており，他の言語で使用する際には別途コードを書く必要があります．

Railsなどで実装してみた，という記事はいくつかあるのですが，GASで実装した例は見つからなかったため情報共有したいと思い，この記事を書いています．

本題

参考にしたページ

実装初期

API何もわからん，署名version4?なにそれ，なにもできん

...

とても困ったのでお世話になっている

intee（インティ） | スキルアップ型就活支援サービスのエンジニアの方など詳しい方から話を聞いて勉強しました．

Scratchpad使ったら一時的な署名が手に入るのか～など，右往左往しながら進んできたのですが，ここはあまり需要がないと思うので最短経路になるような部分だけ書くことにします．

実装の流れ

公式のドキュメント内にSDKを使わない実装例としてJavaとPHPのコードが紹介されています．

私はどちらの言語もわからないのですが，XAMPPというフリーソフトを使ってPHPを動かすことができたので，今回はPHPのコードを参考にして実装することにしました．

2つのコードが紹介されているのですが，両方ダウンロードしてincludeしたら正しく常時されるようになりました．

PHPではechoを使って文字列の出力が行えるため，これを使ってありとあらゆるパラメータを表示してコードの内容を理解しました．

コードの流れ

payloadの作成
正規リクエストの作成(prepareCanonicalRequest)
署名文字列の作成(prepareStringToSign)
署名を計算する(calculateSignature)
署名を含めたヘッダーを作成
APIを叩く

ここで2~4がPHPコード内の

    public function getHeaders() {
        $this->awsHeaders ['x-amz-date'] = $this->xAmzDate;
        ksort ( $this->awsHeaders );
        $canonicalURL = $this->prepareCanonicalRequest ();
        $stringToSign = $this->prepareStringToSign ( $canonicalURL );
        $signature = $this->calculateSignature ( $stringToSign );
        if ($signature) {
            $this->awsHeaders ['Authorization'] = $this->buildAuthorizationString ( $signature );
            return $this->awsHeaders;
        }
    }

に相当します．

実際のコード

function main() {

  var word = "宇宙よりも遠い場所";
  //日本語入力時のための処理
  word = escape(word);
  word = word.toLowerCase();
  word = word.replace(/%/g, "\\");
  word = word.replace(/\\2\d/g, " ");

  var Partner_Tag = PropertiesService.getScriptProperties().getProperty("PartnerTag");
  var Access_Key = PropertiesService.getScriptProperties().getProperty("AccessKey");
  var Secret_Key = PropertiesService.getScriptProperties().getProperty("SecretKey");

  //検索パラーメータ
  var payload = '{"ItemCount":10,"PartnerType":"Associates","PartnerTag":"' + Partner_Tag + '","Keywords":"' + word + '","SearchIndex":"Books","Resources":["Images.Primary.Medium","ItemInfo.Title","ItemInfo.ByLineInfo"]}';


  //日時の取得
  var now = new Date();
  var yyyymmdd = Utilities.formatDate(now, "GMT", "yyyyMMdd")
  var timestamp = yyyymmdd + "T" + Utilities.formatDate(now, "GMT", "HHmmss") + "Z";


  //署名の処理
  var canonicalURL = prepareCanonicalRequest(timestamp, payload);
  var stringToSign = prepareStringToSign(timestamp, yyyymmdd, canonicalURL);
  var signature = calculateSignature(Secret_Key, yyyymmdd, "us-west-2", "ProductAdvertisingAPI", stringToSign);

  var Authorization = "AWS4-HMAC-SHA256 Credential=" + Access_Key + "/" + yyyymmdd + "/us-west-2/ProductAdvertisingAPI/aws4_request,SignedHeaders=content-encoding;content-type;host;x-amz-date;x-amz-target,Signature=" + signature;

  var headers = {
    'content-type': 'application/json; charset=utf-8',
    'x-amz-date': timestamp,
    'x-amz-target': 'com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems',
    'content-encoding': 'amz-1.0',
    'Authorization': Authorization
  };

  var options = {
    method: 'POST',
    headers: headers,
    payload: payload,
    muteHttpExceptions: true,
  };

  var url = 'https://webservices.amazon.co.jp/paapi5/searchitems';
  var response = UrlFetchApp.fetch(url, options);
  Logger.log(response);

  //必要なデータのみ取り出す
  var json = JSON.parse(response.getContentText());
  var my_url = {};
  var my_author = {};
  var my_title = {};
  var my_picture_url = {};

  for (i = 0; i < 10; i++) {
    try {
      my_url[i] = json["SearchResult"]["Items"][i]["DetailPageURL"];
    } catch (e) {
      my_url[i] = "";
    }
    try {
      my_author[i] = json["SearchResult"]["Items"][i]["ItemInfo"]["ByLineInfo"]["Contributors"][0]["Name"];
    } catch (e) {
      my_author[i] = "";
    }
    try {
      my_title[i] = json["SearchResult"]["Items"][i]["ItemInfo"]["Title"]["DisplayValue"];
    } catch (e) {
      my_picture_url[i] = "";
    }
    try {
      my_picture_url[i] = json["SearchResult"]["Items"][i]["Images"]["Primary"]["Medium"]["URL"];
    } catch (e) {
      my_picture_url[i] = "";
    }
  }

  value = {
    affiliate_url: my_url,
    author: my_author,
    title: my_title,
    pictur_url: my_picture_url,
  };
  Logger.log(value);

  var result = {
    message: value
  }

  var out = ContentService.createTextOutput();

  //Mine TypeをJSONに
  out.setMimeType(ContentService.MimeType.JSON);

  //JSONテキストをセット
  out.setContent(JSON.stringify(result));

  return out;
}


function prepareCanonicalRequest(timestamp, payload) {
  var canonicalUrl = "POST\n";
  canonicalUrl = canonicalUrl + "/paapi5/searchitems" + "\n\n";
  canonicalUrl = canonicalUrl + "content-encoding:amz-1.0" + "\n";
  canonicalUrl = canonicalUrl + "content-type:application/json; charset=utf-8" + "\n";
  canonicalUrl = canonicalUrl + "host:webservices.amazon.co.jp" + "\n";
  canonicalUrl = canonicalUrl + "x-amz-date:" + timestamp + "\n";
  canonicalUrl = canonicalUrl + "x-amz-target:com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems" + "\n\n";
  canonicalUrl = canonicalUrl + "content-encoding;content-type;host;x-amz-date;x-amz-target" + "\n";
  canonicalUrl = canonicalUrl + SHA256(payload);
  return canonicalUrl;
}

function prepareStringToSign(timestamp, yyyymmdd, canonicalURL) {
  var stringToSign = "AWS4-HMAC-SHA256" + "\n";
  stringToSign = stringToSign + timestamp + "\n";
  stringToSign = stringToSign + yyyymmdd + "/us-west-2/ProductAdvertisingAPI/aws4_request" + "\n";
  stringToSign = stringToSign + SHA256(canonicalURL);
  return stringToSign;
}



function calculateSignature(secretAccessKey, currentDate, regionName, serviceName, stringToSign) {
  var kDate = my_HMAC_keytext(currentDate, "AWS4" + secretAccessKey);
  var kRegion = my_HMAC_keyB64(regionName, kDate);
  var kService = my_HMAC_keyB64(serviceName, kRegion);
  var kSigning = my_HMAC_keyB64("aws4_request", kService);
  var signatureKey = kSigning;
  var signature = my_HMAC_keyB64_HEXOutput(stringToSign, signatureKey);
  // Logger.log(signature);
  return signature;
}



function SHA256(input) {
  var rawHash = Utilities.computeDigest(Utilities.DigestAlgorithm.SHA_256, input);
  var txtHash = '';
  for (i = 0; i < rawHash.length; i++) {
    var hashVal = rawHash[i];
    if (hashVal < 0) {
      hashVal += 256;
    }
    if (hashVal.toString(16).length == 1) {
      txtHash += '0';
    }
    txtHash += hashVal.toString(16);
  }
  return txtHash;
}


function my_HMAC_keytext(value, key) {
  const shaObj = new jsSHA("SHA-256", "TEXT", {
    hmacKey: { value: key, format: "TEXT" },
  });
  shaObj.update(value);
  const hmac = shaObj.getHash("B64");
  return hmac;
}

function my_HMAC_keytext_HEXOutput(value, key) {
  const shaObj = new jsSHA("SHA-256", "TEXT", {
    hmacKey: { value: key, format: "TEXT" },
  });
  shaObj.update(value);
  const hmac = shaObj.getHash("HEX");
  return hmac;
}

function my_HMAC_keyB64(value, key) {
  const shaObj = new jsSHA("SHA-256", "TEXT", {
    hmacKey: { value: key, format: "B64" },
  });
  shaObj.update(value);
  const hmac = shaObj.getHash("B64");
  return hmac;
}

function my_HMAC_keyB64_HEXOutput(value, key) {
  const shaObj = new jsSHA("SHA-256", "TEXT", {
    hmacKey: { value: key, format: "B64" },
  });
  shaObj.update(value);
  const hmac = shaObj.getHash("HEX");
  return hmac;
}

/**
* A JavaScript implementation of the SHA family of hashes - defined in FIPS PUB 180-4, FIPS PUB 202,
* and SP 800-185 - as well as the corresponding HMAC implementation as defined in FIPS PUB 198-1.
*
* Copyright 2008-2020 Brian Turek, 1998-2009 Paul Johnston & Contributors
* Distributed under the BSD License
* See http://caligatio.github.com/jsSHA/ for more information
*
* Two ECMAScript polyfill functions carry the following license:
*
* Copyright (c) Microsoft Corporation. All rights reserved.
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
*
* THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED,
* INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
* MERCHANTABLITY OR NON-INFRINGEMENT.
*
* See the Apache Version 2.0 License for specific language governing permissions and limitations under the License.
*/
!function (t, r) { "object" == typeof exports && "undefined" != typeof module ? module.exports = r() : "function" == typeof define && define.amd ? define(r) : (t = t || self).jsSHA = r() }(this, (function () { "use strict"; var t = function (r, n) { return (t = Object.setPrototypeOf || { __proto__: [] } instanceof Array && function (t, r) { t.__proto__ = r } || function (t, r) { for (var n in r) r.hasOwnProperty(n) && (t[n] = r[n]) })(r, n) }; var r = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; function n(t, r, n, i) { var e, o, u, s = r || [0], f = (n = n || 0) >>> 3, h = -1 === i ? 3 : 0; for (e = 0; e < t.length; e += 1)o = (u = e + f) >>> 2, s.length <= o && s.push(0), s[o] |= t[e] << 8 * (h + i * (u % 4)); return { value: s, binLen: 8 * t.length + n } } function i(t, i, e) { switch (i) { case "UTF8": case "UTF16BE": case "UTF16LE": break; default: throw new Error("encoding must be UTF8, UTF16BE, or UTF16LE") }switch (t) { case "HEX": return function (t, r, n) { return function (t, r, n, i) { var e, o, u, s; if (0 != t.length % 2) throw new Error("String of HEX type must be in byte increments"); var f = r || [0], h = (n = n || 0) >>> 3, a = -1 === i ? 3 : 0; for (e = 0; e < t.length; e += 2) { if (o = parseInt(t.substr(e, 2), 16), isNaN(o)) throw new Error("String of HEX type contains invalid characters"); for (u = (s = (e >>> 1) + h) >>> 2; f.length <= u;)f.push(0); f[u] |= o << 8 * (a + i * (s % 4)) } return { value: f, binLen: 4 * t.length + n } }(t, r, n, e) }; case "TEXT": return function (t, r, n) { return function (t, r, n, i, e) { var o, u, s, f, h, a, c, w, v = 0, E = n || [0], A = (i = i || 0) >>> 3; if ("UTF8" === r) for (c = -1 === e ? 3 : 0, s = 0; s < t.length; s += 1)for (u = [], 128 > (o = t.charCodeAt(s)) ? u.push(o) : 2048 > o ? (u.push(192 | o >>> 6), u.push(128 | 63 & o)) : 55296 > o || 57344 <= o ? u.push(224 | o >>> 12, 128 | o >>> 6 & 63, 128 | 63 & o) : (s += 1, o = 65536 + ((1023 & o) << 10 | 1023 & t.charCodeAt(s)), u.push(240 | o >>> 18, 128 | o >>> 12 & 63, 128 | o >>> 6 & 63, 128 | 63 & o)), f = 0; f < u.length; f += 1) { for (h = (a = v + A) >>> 2; E.length <= h;)E.push(0); E[h] |= u[f] << 8 * (c + e * (a % 4)), v += 1 } else for (c = -1 === e ? 2 : 0, w = "UTF16LE" === r && 1 !== e || "UTF16LE" !== r && 1 === e, s = 0; s < t.length; s += 1) { for (o = t.charCodeAt(s), !0 === w && (o = (f = 255 & o) << 8 | o >>> 8), h = (a = v + A) >>> 2; E.length <= h;)E.push(0); E[h] |= o << 8 * (c + e * (a % 4)), v += 2 } return { value: E, binLen: 8 * v + i } }(t, i, r, n, e) }; case "B64": return function (t, n, i) { return function (t, n, i, e) { var o, u, s, f, h, a, c = 0, w = n || [0], v = (i = i || 0) >>> 3, E = -1 === e ? 3 : 0, A = t.indexOf("="); if (-1 === t.search(/^[a-zA-Z0-9=+/]+$/)) throw new Error("Invalid character in base-64 string"); if (t = t.replace(/=/g, ""), -1 !== A && A < t.length) throw new Error("Invalid '=' found in base-64 string"); for (o = 0; o < t.length; o += 4) { for (f = t.substr(o, 4), s = 0, u = 0; u < f.length; u += 1)s |= r.indexOf(f.charAt(u)) << 18 - 6 * u; for (u = 0; u < f.length - 1; u += 1) { for (h = (a = c + v) >>> 2; w.length <= h;)w.push(0); w[h] |= (s >>> 16 - 8 * u & 255) << 8 * (E + e * (a % 4)), c += 1 } } return { value: w, binLen: 8 * c + i } }(t, n, i, e) }; case "BYTES": return function (t, r, n) { return function (t, r, n, i) { var e, o, u, s, f = r || [0], h = (n = n || 0) >>> 3, a = -1 === i ? 3 : 0; for (o = 0; o < t.length; o += 1)e = t.charCodeAt(o), u = (s = o + h) >>> 2, f.length <= u && f.push(0), f[u] |= e << 8 * (a + i * (s % 4)); return { value: f, binLen: 8 * t.length + n } }(t, r, n, e) }; case "ARRAYBUFFER": try { new ArrayBuffer(0) } catch (t) { throw new Error("ARRAYBUFFER not supported by this environment") } return function (t, r, i) { return function (t, r, i, e) { return n(new Uint8Array(t), r, i, e) }(t, r, i, e) }; case "UINT8ARRAY": try { new Uint8Array(0) } catch (t) { throw new Error("UINT8ARRAY not supported by this environment") } return function (t, r, i) { return n(t, r, i, e) }; default: throw new Error("format must be HEX, TEXT, B64, BYTES, ARRAYBUFFER, or UINT8ARRAY") } } function e(t, n, i, e) { switch (t) { case "HEX": return function (t) { return function (t, r, n, i) { var e, o, u = "", s = r / 8, f = -1 === n ? 3 : 0; for (e = 0; e < s; e += 1)o = t[e >>> 2] >>> 8 * (f + n * (e % 4)), u += "0123456789abcdef".charAt(o >>> 4 & 15) + "0123456789abcdef".charAt(15 & o); return i.outputUpper ? u.toUpperCase() : u }(t, n, i, e) }; case "B64": return function (t) { return function (t, n, i, e) { var o, u, s, f, h, a = "", c = n / 8, w = -1 === i ? 3 : 0; for (o = 0; o < c; o += 3)for (f = o + 1 < c ? t[o + 1 >>> 2] : 0, h = o + 2 < c ? t[o + 2 >>> 2] : 0, s = (t[o >>> 2] >>> 8 * (w + i * (o % 4)) & 255) << 16 | (f >>> 8 * (w + i * ((o + 1) % 4)) & 255) << 8 | h >>> 8 * (w + i * ((o + 2) % 4)) & 255, u = 0; u < 4; u += 1)a += 8 * o + 6 * u <= n ? r.charAt(s >>> 6 * (3 - u) & 63) : e.b64Pad; return a }(t, n, i, e) }; case "BYTES": return function (t) { return function (t, r, n) { var i, e, o = "", u = r / 8, s = -1 === n ? 3 : 0; for (i = 0; i < u; i += 1)e = t[i >>> 2] >>> 8 * (s + n * (i % 4)) & 255, o += String.fromCharCode(e); return o }(t, n, i) }; case "ARRAYBUFFER": try { new ArrayBuffer(0) } catch (t) { throw new Error("ARRAYBUFFER not supported by this environment") } return function (t) { return function (t, r, n) { var i, e = r / 8, o = new ArrayBuffer(e), u = new Uint8Array(o), s = -1 === n ? 3 : 0; for (i = 0; i < e; i += 1)u[i] = t[i >>> 2] >>> 8 * (s + n * (i % 4)) & 255; return o }(t, n, i) }; case "UINT8ARRAY": try { new Uint8Array(0) } catch (t) { throw new Error("UINT8ARRAY not supported by this environment") } return function (t) { return function (t, r, n) { var i, e = r / 8, o = -1 === n ? 3 : 0, u = new Uint8Array(e); for (i = 0; i < e; i += 1)u[i] = t[i >>> 2] >>> 8 * (o + n * (i % 4)) & 255; return u }(t, n, i) }; default: throw new Error("format must be HEX, B64, BYTES, ARRAYBUFFER, or UINT8ARRAY") } } var o = [1116352408, 1899447441, 3049323471, 3921009573, 961987163, 1508970993, 2453635748, 2870763221, 3624381080, 310598401, 607225278, 1426881987, 1925078388, 2162078206, 2614888103, 3248222580, 3835390401, 4022224774, 264347078, 604807628, 770255983, 1249150122, 1555081692, 1996064986, 2554220882, 2821834349, 2952996808, 3210313671, 3336571891, 3584528711, 113926993, 338241895, 666307205, 773529912, 1294757372, 1396182291, 1695183700, 1986661051, 2177026350, 2456956037, 2730485921, 2820302411, 3259730800, 3345764771, 3516065817, 3600352804, 4094571909, 275423344, 430227734, 506948616, 659060556, 883997877, 958139571, 1322822218, 1537002063, 1747873779, 1955562222, 2024104815, 2227730452, 2361852424, 2428436474, 2756734187, 3204031479, 3329325298], u = [3238371032, 914150663, 812702999, 4144912697, 4290775857, 1750603025, 1694076839, 3204075428], s = [1779033703, 3144134277, 1013904242, 2773480762, 1359893119, 2600822924, 528734635, 1541459225]; function f(t) { var r = { outputUpper: !1, b64Pad: "=", outputLen: -1 }, n = t || {}, i = "Output length must be a multiple of 8"; if (r.outputUpper = n.outputUpper || !1, n.b64Pad && (r.b64Pad = n.b64Pad), n.outputLen) { if (n.outputLen % 8 != 0) throw new Error(i); r.outputLen = n.outputLen } else if (n.shakeLen) { if (n.shakeLen % 8 != 0) throw new Error(i); r.outputLen = n.shakeLen } if ("boolean" != typeof r.outputUpper) throw new Error("Invalid outputUpper formatting option"); if ("string" != typeof r.b64Pad) throw new Error("Invalid b64Pad formatting option"); return r } function h(t, r) { return t >>> r | t << 32 - r } function a(t, r) { return t >>> r } function c(t, r, n) { return t & r ^ ~t & n } function w(t, r, n) { return t & r ^ t & n ^ r & n } function v(t) { return h(t, 2) ^ h(t, 13) ^ h(t, 22) } function E(t, r) { var n = (65535 & t) + (65535 & r); return (65535 & (t >>> 16) + (r >>> 16) + (n >>> 16)) << 16 | 65535 & n } function A(t, r, n, i) { var e = (65535 & t) + (65535 & r) + (65535 & n) + (65535 & i); return (65535 & (t >>> 16) + (r >>> 16) + (n >>> 16) + (i >>> 16) + (e >>> 16)) << 16 | 65535 & e } function p(t, r, n, i, e) { var o = (65535 & t) + (65535 & r) + (65535 & n) + (65535 & i) + (65535 & e); return (65535 & (t >>> 16) + (r >>> 16) + (n >>> 16) + (i >>> 16) + (e >>> 16) + (o >>> 16)) << 16 | 65535 & o } function d(t) { return h(t, 7) ^ h(t, 18) ^ a(t, 3) } function l(t) { return h(t, 6) ^ h(t, 11) ^ h(t, 25) } function R(t) { return "SHA-224" == t ? u.slice() : s.slice() } function U(t, r) { var n, i, e, u, s, f, R, U, y, b, T, m, F = []; for (n = r[0], i = r[1], e = r[2], u = r[3], s = r[4], f = r[5], R = r[6], U = r[7], T = 0; T < 64; T += 1)F[T] = T < 16 ? t[T] : A(h(m = F[T - 2], 17) ^ h(m, 19) ^ a(m, 10), F[T - 7], d(F[T - 15]), F[T - 16]), y = p(U, l(s), c(s, f, R), o[T], F[T]), b = E(v(n), w(n, i, e)), U = R, R = f, f = s, s = E(u, y), u = e, e = i, i = n, n = E(y, b); return r[0] = E(n, r[0]), r[1] = E(i, r[1]), r[2] = E(e, r[2]), r[3] = E(u, r[3]), r[4] = E(s, r[4]), r[5] = E(f, r[5]), r[6] = E(R, r[6]), r[7] = E(U, r[7]), r } return function (r) { function n(t, n, e) { var o = this; if ("SHA-224" !== t && "SHA-256" !== t) throw new Error("Chosen SHA variant is not supported"); var u = e || {}; return (o = r.call(this, t, n, e) || this).t = o.i, o.o = !0, o.u = -1, o.s = i(o.h, o.v, o.u), o.A = U, o.p = function (t) { return t.slice() }, o.l = R, o.R = function (r, n, i, e) { return function (t, r, n, i, e) { for (var o, u = 15 + (r + 65 >>> 9 << 4), s = r + n; t.length <= u;)t.push(0); for (t[r >>> 5] |= 128 << 24 - r % 32, t[u] = 4294967295 & s, t[u - 1] = s / 4294967296 | 0, o = 0; o < t.length; o += 16)i = U(t.slice(o, o + 16), i); return "SHA-224" === e ? [i[0], i[1], i[2], i[3], i[4], i[5], i[6]] : i }(r, n, i, e, t) }, o.U = R(t), o.T = 512, o.m = "SHA-224" === t ? 224 : 256, o.F = !1, u.hmacKey && o.B(function (t, r, n, e) { var o = t + " must include a value and format"; if (!r) { if (!e) throw new Error(o); return e } if (void 0 === r.value || !r.format) throw new Error(o); return i(r.format, r.encoding || "UTF8", n)(r.value) }("hmacKey", u.hmacKey, o.u)), o } return function (r, n) { function i() { this.constructor = r } t(r, n), r.prototype = null === n ? Object.create(n) : (i.prototype = n.prototype, new i) }(n, r), n }(function () { function t(t, r, n) { var i = n || {}; if (this.h = r, this.v = i.encoding || "UTF8", this.numRounds = i.numRounds || 1, isNaN(this.numRounds) || this.numRounds !== parseInt(this.numRounds, 10) || 1 > this.numRounds) throw new Error("numRounds must a integer >= 1"); this.g = t, this.Y = [], this.H = 0, this.S = !1, this.I = 0, this.C = !1, this.L = [], this.N = [] } return t.prototype.update = function (t) { var r, n = 0, i = this.T >>> 5, e = this.s(t, this.Y, this.H), o = e.binLen, u = e.value, s = o >>> 5; for (r = 0; r < s; r += i)n + this.T <= o && (this.U = this.A(u.slice(r, r + i), this.U), n += this.T); this.I += n, this.Y = u.slice(n >>> 5), this.H = o % this.T, this.S = !0 }, t.prototype.getHash = function (t, r) { var n, i, o = this.m, u = f(r); if (this.F) { if (-1 === u.outputLen) throw new Error("Output length must be specified in options"); o = u.outputLen } var s = e(t, o, this.u, u); if (this.C && this.t) return s(this.t(u)); for (i = this.R(this.Y.slice(), this.H, this.I, this.p(this.U), o), n = 1; n < this.numRounds; n += 1)this.F && o % 32 != 0 && (i[i.length - 1] &= 16777215 >>> 24 - o % 32), i = this.R(i, o, 0, this.l(this.g), o); return s(i) }, t.prototype.setHMACKey = function (t, r, n) { if (!this.o) throw new Error("Variant does not support HMAC"); if (this.S) throw new Error("Cannot set MAC key after calling update"); var e = i(r, (n || {}).encoding || "UTF8", this.u); this.B(e(t)) }, t.prototype.B = function (t) { var r, n = this.T >>> 3, i = n / 4 - 1; if (1 !== this.numRounds) throw new Error("Cannot set numRounds with MAC"); if (this.C) throw new Error("MAC key already set"); for (n < t.binLen / 8 && (t.value = this.R(t.value, t.binLen, 0, this.l(this.g), this.m)); t.value.length <= i;)t.value.push(0); for (r = 0; r <= i; r += 1)this.L[r] = 909522486 ^ t.value[r], this.N[r] = 1549556828 ^ t.value[r]; this.U = this.A(this.L, this.U), this.I = this.T, this.C = !0 }, t.prototype.getHMAC = function (t, r) { var n = f(r); return e(t, this.m, this.u, n)(this.i()) }, t.prototype.i = function () { var t; if (!this.C) throw new Error("Cannot call getHMAC without first setting MAC key"); var r = this.R(this.Y.slice(), this.H, this.I, this.p(this.U), this.m); return t = this.A(this.N, this.l(this.g)), t = this.R(r, this.m, this.T, t, this.m) }, t }()) }));

今回のコードを作成するにあたって

とにかく早く実装すること
使用する機能が変わらない

という前提があったため，本来なら変数を使うべきところを直接書き込んでいるなど，よろしくない点はありますが，ご了承ください．

例えば，検索カテゴリを本だけに限定している，検索パラメータの固定など....

もしこのコードを参考にされる方は自己責任の上，適宜変更してください．

工夫した点

日本語検索への対応

アルファベットで構成された文字列で検索する場合には不要な処理なのですが，日本語を含む文字列を含んだ情報を署名化しようとすると適切な値が取得されませんでした．

そこでお手本としたPHPのコードを参考に，文字をエンコードすればいいのだろうと推測し，escape関数とtoLowerCase()メソッドを用いて文字列の変換を行っています．

これだけでは半角スペースなどがおかしくなるので例外処理をその下に記述しています．

取得データの分解

Amazonから取得したデータは物によってデータが欠けていたりするため，try...catch文を用いてエラーが起きてもコードが継続するようにしています．

SHA256

ハッシュ関数としてGASで使えるcomputeHmacSha256Signatureではなく，

jsSHA - SHA Hashes in JavaScriptを利用しています．

これはPHPコード内の"hash_hmac"関数の引数がtrueとなっており，バイナリデータが出力されているのですが，computeHmacSha256Signatureではこれが実現できなさそうだったためです．

ただ，jsSHAを導入してから明らかにコードが重くなったので別のやり方があればご教授いただきたいですね．

まとめ

今回はGASを用いてPA-APIを実装した話を簡単にまとめました．

もしかしたら内容的に間違っている点やおかしい点があるかもしれませんが，お許しください．

ご指摘いただければ幸いです．

実装ははじめに悩んでいた期間も含めれば2週間ほどかかりました．

結構苦しんだので，「よく頑張ったな」，って方は

www.amazon.co.jp

このリンクを踏んでから何か購入してくれると紹介料が入るのでお願いします．

また，今回の実装はNoCodeCamp杯 – コードを使わないアプリ開発に参加するなかで必要な機能でした．

そのため今回の機能をAPI化し，NoCodeツールであるBubbleから呼び出しています．

そっちの話も余裕があれば書こうと思っているので，書ければ書きます．

ハッカソンで実際に制作したアプリが

shark0731.bubbleapps.ioこちらです．

まだベータ版の段階で，現状PA-APIの機能は実装されていませんが，今後実装して改良するつもりなので，ぜひ触ってみてフィードバックいただければ幸いです．

以上，長くなりましたが今回はここまでです．

読んでいただき，ありがとうございました．

nacarの独り言

マイクロマウス作ってるらしいです