eBay Browse API keyword search を GAS で叩く方法（サンプルコード付き）

/***********************
 * eBay Browse API: keyword search（item_summary/search）
 * - キーワード（q）で検索し、itemSummaries を取得
 * - アプリ認証トークンは getItem と共通
 * - 出力形式は getItem と同じ [0..15] を 1商品＝1配列で返す
 *   → 返り値は「2次元配列（行：商品）」になります
 ***********************/

const CLIENT_ID  = PropertiesService.getScriptProperties().getProperty('CLIENT_ID1');
const CLIENT_SEC = PropertiesService.getScriptProperties().getProperty('CLIENT_SECRET1');
const MARKETPLACE_ID =
  PropertiesService.getScriptProperties().getProperty('MARKETPLACE_ID') || 'EBAY_US';

const EBAY_OAUTH_TOKEN_URL = 'https://api.ebay.com/identity/v1/oauth2/token';
const EBAY_BROWSE_SEARCH_BASE = 'https://api.ebay.com/buy/browse/v1/item_summary/search';

/** 動作テスト（開発時用：シンプル版） */
function demo_searchByKeyword() {
  const kw    = "Canon EF 24mm F2.8 Lens"; // ← テストしたいキーワード
  const limit = 5;                           // 取得件数（最大 200 まで指定可能）

  const rows = ebayBrowseSearchByKeyword(kw, limit); // options なし（filter/sort なし）
  //Logger.log(JSON.stringify(rows, null, 2)); // スプレッドシート貼り付け前に確認用
}

/** 動作テスト（filter / sort を指定する例） */
function demo_searchByKeywordWithFilter() {
  const kw    = "Canon EF";
  const limit = 20;

  // 例：日本出品の新品・中古のみ、価格の安い順
  const options = {
    filter: 'conditionIds:{1000|3000},itemLocationCountry:{JP}',
    sort:   'price' // 昇順。降順は '-price'
  };

  const rows = ebayBrowseSearchByKeyword(kw, limit, options);
  //Logger.log(JSON.stringify(rows, null, 2));
}

/**
 * キーワード検索の入口関数
 * @param {string} keyword   - 検索キーワード（q）
 * @param {number} [limit]   - 最大件数（1〜200, 省略時 10）
 * @param {Object} [options] - 追加パラメータ（例：{ filter, sort }）
 * @return {Array<Array>}    - 各行が [0..15] 形式の2次元配列
 */
function ebayBrowseSearchByKeyword(keyword, limit, options) {
  if (!CLIENT_ID || !CLIENT_SEC) {
    throw new Error("CLIENT_ID1 / CLIENT_SECRET1 が未設定です（スクリプトのプロパティに保存してください）");
  }
  if (!keyword) {
    throw new Error("検索キーワード（keyword）が空です");
  }

  const max = (typeof limit === "number" && limit > 0) ? limit : 10;

  // 追加パラメータ（filter / sort など）は options 経由で受け取る
  const extraParams = options || {}; // 例：{ filter: '...', sort: '...' }

  // ① トークン（キャッシュ優先）
  let token = getAppTokenCached();

  // ② API 実行
  let res = callSearchItems(keyword, max, token, extraParams);

  // 401（期限切れ等）の場合は 1 回だけトークン再取得 → 再試行
  if (res._httpCode === 401) {
    token = refreshAppToken();
    res = callSearchItems(keyword, max, token, extraParams);
  }

  // 200 以外は失敗としてログを残して終了
  if (res._httpCode !== 200 || !res._json) {
    Logger.log(`❌ search Error: ${res._httpCode}`);
    Logger.log(res._rawText);
    return [];
  }

  const json = res._json;

  // eBay 側エラー
  if ("errors" in json) {
    Logger.log("❌ APIエラー: " + JSON.stringify(json.errors));
    return [];
  }

  const items = Array.isArray(json.itemSummaries) ? json.itemSummaries : [];
  if (!items.length) {
    Logger.log("ℹ️ 該当する itemSummaries がありません");
    return [];
  }

  // itemSummary 1件ごとに [0..15] 配列へ整形
  const rows = items.map(displayItemSummary);

  Logger.log(`✅ keyword="${keyword}" / 件数=${rows.length}`);
  return rows;
}

/**
 * itemSummary から、getItem と同じ [0..15] 配列を生成
 * （description / itemSpecifics が無いことが多いので、ある範囲だけ埋める）
 * @param {Object} data - itemSummary
 * @return {Array}      - [0..15]
 */
function displayItemSummary(data) {
  // --- 基本情報の抽出 ---
  const title = data.title || "";
  const image = data.image?.imageUrl || "";
  const price = data.price?.value || "";
  const currency = data.price?.currency || "";

  // 送料（最初のオプション）
  const shippingOpt = data.shippingOptions?.[0] || {};
  const shipping = shippingOpt.shippingCost?.value || "";
  const shippingCurrency = shippingOpt.shippingCost?.currency || "";

  // 在庫・販売ステータス（itemEndDate ベース簡易判定）
  const status = "instock";

  // セラー情報
  const seller = data.seller?.username || "";
  const feedbackPercent = data.seller?.feedbackPercentage || "";
  const feedbackScore   = data.seller?.feedbackScore || "";

  // カテゴリ・コンディション
  const categoryId   = data.categoryId || "";
  const categoryName = data.categoryPath || "";
  const condition    = data.condition || "";
  const conditionId  = data.conditionId || "";

  // URL・所在地
  const itemUrl = data.itemWebUrl || "";
  const loc = data.itemLocation;
  const location = loc ? `${loc.postalCode || ""} ${loc.country || ""}`.trim() : "";

  // item_summary には通常 description は含まれない → shortDescription を代用 or 空
  let description = data.shortDescription || "";
  description = description
    .replace(/<br\s*\/?>(?i)/g, "\n")
    .replace(/<\/p>(?i)/g, "\n")
    .replace(/<[^>]*>/g, "")
    .trim();

  // item_summary では localizedAspects がない／少ないことが多い
  let itemSpecifics = [];
  if (Array.isArray(data.localizedAspects)) {
    itemSpecifics = data.localizedAspects.map(sp => {
      const name = sp.name || "";
      const value = Array.isArray(sp.value) ? sp.value.join(", ") : (sp.value || "");
      return [name, value];
    });
  }

  // 日付系（JST 文字列）
  const ListDate = toJST(data.itemCreationDate) || "";
  const EndDate  = toJST(data.itemEndDate) || "";

  // ログ（必要なら）
  Logger.log(`Title: ${title}`);
  Logger.log(`Price: ${price} ${currency} + Shipping: ${shipping} ${shippingCurrency}`);
  Logger.log(`Seller: ${seller} / Feedback: ${feedbackPercent}% (${feedbackScore})`);
  Logger.log(`Item URL: ${itemUrl}`);

  // --- getItem と同じ配列形式で返却（[0..15]） ---
  return [
    title,        // 0
    price,        // 1
    shipping,     // 2
    status,       // 3
    seller,       // 4
    feedbackScore,// 5
    categoryId,   // 6
    categoryName, // 7
    condition,    // 8
    conditionId,  // 9
    itemUrl,      //10
    image,        //11
    description,  //12
    ListDate,     //13
    EndDate,      //14
    itemSpecifics //15
  ];
}

/**
 * Browse API: item_summary/search 呼び出し（HTTP）
 * @param {string} keyword      - q=
 * @param {number} limit        - limit=
 * @param {string} token        - Bearer トークン
 * @param {Object} [extraParams]- 追加パラメータ（例：{ filter, sort }）
 * @return {{_httpCode:number,_rawText:string,_json:Object|null}}
 */
function callSearchItems(keyword, limit, token, extraParams) {
  // クエリパラメータを組み立て
  const params = {
    q: keyword,
    limit: String(limit),
    ...(extraParams || {}) // filter, sort などをマージ
  };

  const qs = Object.keys(params)
    .map(k => `${encodeURIComponent(k)}=${encodeURIComponent(params[k])}`)
    .join("&");

  const url = `${EBAY_BROWSE_SEARCH_BASE}?${qs}`;

  const headers = {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json",
    "X-EBAY-C-MARKETPLACE-ID": MARKETPLACE_ID,
    "Accept-Language": "en-US",
  };

  const opt = { method: "get", headers, muteHttpExceptions: true };
  const resp = UrlFetchApp.fetch(url, opt);
  const code = resp.getResponseCode();

  return {
    _httpCode: code,
    _rawText: resp.getContentText(),
    _json: safeJson(resp.getContentText())
  };
}

/** アプリトークン（client_credentials）をキャッシュ優先で取得 */
function getAppTokenCached() {
  const cache = CacheService.getScriptCache();
  const c = cache.get("EBAY_APP_TOKEN");
  if (c) return c;

  const t = refreshAppToken();
  if (t) cache.put("EBAY_APP_TOKEN", t, 60 * 25); // 25分キャッシュ（有効30分想定）
  return t;
}

/** 強制的に新しいトークンを発行（401時など） */
function refreshAppToken() {
  const basic = Utilities.base64Encode(`${CLIENT_ID}:${CLIENT_SEC}`);

  const payload =
    "grant_type=client_credentials&scope=" +
    encodeURIComponent("https://api.ebay.com/oauth/api_scope"); // Browseの読み取りはこれで十分

  const resp = UrlFetchApp.fetch(EBAY_OAUTH_TOKEN_URL, {
    method: "post",
    headers: {
      Authorization: `Basic ${basic}`,
      "Content-Type": "application/x-www-form-urlencoded",
    },
    payload: payload,
    muteHttpExceptions: true,
  });

  if (resp.getResponseCode() !== 200) {
    Logger.log("Token error");
    Logger.log(resp.getContentText());
    return null;
  }
  return JSON.parse(resp.getContentText()).access_token;
}

/** ISO8601 → JST "yyyy/mm/dd" 文字列に整形（表示用の簡易版） */
function toJST(iso) {
  if (!iso) return "";
  const d = new Date(iso);                         // UTC ベース
  const j = new Date(d.getTime() + 9 * 3600 * 1000); // JST = UTC+9
  const y = j.getFullYear();
  const m = String(j.getMonth() + 1).padStart(2, "0");
  const dd = String(j.getDate()).padStart(2, "0");
  return `${y}/${m}/${dd}`;
}

/** JSON を安全にパース（失敗時 null） */
function safeJson(txt) {
  try { return JSON.parse(txt); } catch (e) { return null; }
}