eBay Trading API で商品を出品する方法（スプレッドシート+GAS）

// 出品シート
const SHEET_NAME_LIST        = '出品';
const ADDR_TITLE             = 'D17';          // 出品タイトル
const ADDR_LIST_PRICE        = 'D21';          // 販売価格
const ADDR_BEST_OFFER        = 'D22';          // BestOffer設定
const ADDR_MIN_PRICE         = 'D23';          // BestOffer最低出品価格
const ADDR_HTML_FILE         = 'D27';          // 商品説明
const ADDR_SALES_QTY         = 'D72';          // 出品数（数量）
const ADDR_CUSTOM_LABEL      = 'E73';          // カスタムラベル（SKU）
const ADDR_EBAY_CAT_ID       = 'D70';          // eBayカテゴリID
const ADDR_CONDITION_ID      = 'D65';          // ConditionID
const ADDR_COND_DESCRIPTION  = 'D66';          // コンディション説明
const ADDR_SHIPPING_POLICY   = 'D79';          // 送料ポリシー名
const ADDR_RETURN_POLICY     = 'D77';          // 返品ポリシー名
const ADDR_PAYMENT_POLICY    = 'D78';          // 支払ポリシー名
const ADDR_LIST_LOCATION     = 'D71';          // 発送元ロケーション
const ADDR_IMG_LIST          = 'D84:AA84';     // 画像URL一覧（横並び）
const ADDR_ITEM_SPECIFICS    = 'D90:AA91';     // ItemSpecifics用

// 結果出力（出品結果）
const ADDR_RESULT_STAT       = 'D102';         // Ack（Success / Failure）
const ADDR_RESULT_ID         = 'F102';         // ItemID もしくはエラーメッセージ
const ADDR_RESULT_RES        = 'D103';         // 生レスポンス（XML文字列）

// 設定シート（APIキー類）
const SHEET_NAME_SETTING     = '設定';
const ADDR_SET_APPID         = 'E6';           // 設定シート内 APPID（CERT-NAME 用）
const ADDR_SET_DEVID         = 'E7';           // 設定シート内 DEVID（DEV-NAME 用）
const ADDR_SET_AUTHTOKEN     = 'E8';           // 設定シート内 eBayAuthToken

// シートオブジェクト（コンテナバインド前提）
const setsheet  = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME_SETTING);
const listsheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME_LIST);

function makedesc() {
  // 1. シートから HTML ファイル名を取得
  const filename = listsheet.getRange(ADDR_HTML_FILE).getValue();
 
  // 2. 同じフォルダ内からファイル ID を取得（実装は環境に合わせて）
  const htmlId = getFileIdFromSameFolder(filename);
 
  // 3. ファイル内容を文字列で取得
  let html = DriveApp.getFileById(htmlId)
                    .getBlob()
                    .getDataAsString();
 
  // 4. よく使う HTML エンティティをデコード
  html = decodeHtmlEntities(html);
 
  // 5. 改行を削除（XML に埋め込むため 1 行に整形）
  html = html.replace(/[\n\r]/g, '');
 
  return html;
}

function decodeHtmlEntities(str) {
  return str
    .replace(/ /g, ' ')
    .replace(/&(?!nbsp;)/g, '&')
    .replace(/"/g, '"')
    .replace(/'/g, "'");
}

function getFileIdFromSameFolder(filename) {
  const ssId   = SpreadsheetApp.getActive().getId();
  const ssFile = DriveApp.getFileById(ssId);

  // 親フォルダ（通常は1つ）
  const parents = ssFile.getParents();
  const folder  = parents.hasNext() ? parents.next() : DriveApp.getRootFolder();

  // ---- ファイル名一致で検索（最速） ----
  let it = folder.getFilesByName(filename);
  if (it.hasNext()) return it.next().getId();

  // ---- 念のため Search API で補強 ----
  it = DriveApp.searchFiles(`'${folder.getId()}' in parents and title = '${filename}'`);
  if (it.hasNext()) return it.next().getId();

  throw new Error(`同フォルダ内に "${filename}" が見つかりません（フォルダ: ${folder.getName()}）`);
}

// =======================================
// メイン処理：出品データを読み取り、Trading API(AddItem)で出品
// 戻り値: [stat, tim, iid]
//   stat : Ack（Success / Failure）
//   tim  : Timestamp
//   iid  : ItemID またはエラーメッセージ
// =======================================
function listdata() {

  // --- 設定シートから認証情報を取得 ---
  const appid     = setsheet.getRange(ADDR_SET_APPID).getValue();
  const devid     = setsheet.getRange(ADDR_SET_DEVID).getValue();
  const authtoken = setsheet.getRange(ADDR_SET_AUTHTOKEN).getValue();

  // --- 出品シートから入力項目を取得 ---
  const sku                 = listsheet.getRange(ADDR_CUSTOM_LABEL).getValue();      // カスタムラベル(SKU)
  const categoryID          = listsheet.getRange(ADDR_EBAY_CAT_ID).getValue();      // eBayカテゴリID
  const title               = listsheet.getRange(ADDR_TITLE).getValue();            // タイトル
  const condition           = listsheet.getRange(ADDR_CONDITION_ID).getValue();     // ConditionID
  const conditionDescription= listsheet.getRange(ADDR_COND_DESCRIPTION).getValue(); // コンディション説明
  const description         = makedesc();                                           // HTML説明文（別関数で生成）
  const pictureURL          = listsheet.getRange(ADDR_IMG_LIST).getValues()[0];     // 画像URL配列（1行分）
  const quantity            = listsheet.getRange(ADDR_SALES_QTY).getValue();        // 数量
  const startPrice          = listsheet.getRange(ADDR_LIST_PRICE).getValue();       // 販売価格
  const bestOfferEnabled    = 1;                                                    // 現状は常に BestOffer ON
  const minimumBestOfferPrice = listsheet.getRange(ADDR_MIN_PRICE).getValue();      // BestOffer 最低価格（※セル定義は別途）
  const listingDuration     = 'GTC';                                                // 期間固定（Good ’Til Cancelled）
  const listingType         = 'FixedPriceItem';                                     // 固定価格出品
  const location            = listsheet.getRange(ADDR_LIST_LOCATION).getValue();    // 発送元ロケーション
  const galleryType         = 'Gallery';                                            // ギャラリー表示
  const shippingProfileName = listsheet.getRange(ADDR_SHIPPING_POLICY).getValue();  // 送料ポリシー名
  const returnProfileName   = listsheet.getRange(ADDR_RETURN_POLICY).getValue();    // 返品ポリシー名
  const paymentProfileName  = listsheet.getRange(ADDR_PAYMENT_POLICY).getValue();   // 支払ポリシー名
  const spec                = getItemSpecificsArray();                              // ItemSpecifics配列 [Name, Value, Name, Value, ...]

  // --- デバッグログ（必要に応じて削除可） ---
  Logger.log([sku, categoryID, title, condition, conditionDescription]);
  Logger.log(pictureURL);
  Logger.log(condition);

  // =======================================
  // AddItem 用 <Item> ブロック生成
  // =======================================
  let xmllist = '<Item>';

  xmllist += `<SKU>${sku}</SKU>`;
  xmllist += `<PrimaryCategory><CategoryID>${categoryID}</CategoryID></PrimaryCategory>`;
  xmllist += `<Title>${title}</Title>`;
  xmllist += `<ConditionID>${condition}</ConditionID>`;

  // コンディション説明（任意）
  if (conditionDescription !== '') {
    xmllist += `<ConditionDescription>${conditionDescription}</ConditionDescription>`;
  }

  // 説明文は CDATA でラップ（HTMLタグをそのまま渡すため）
  xmllist += `<Description><![CDATA[${description}]]></Description>`;

  // 画像
  xmllist += '<PictureDetails>';
  xmllist += `<GalleryType>${galleryType}</GalleryType>`;

  for (let k = 0; k < pictureURL.length; k++) {
    if (!pictureURL[k]) continue;
    Logger.log(pictureURL[k]);
    xmllist += `<PictureURL><![CDATA[${pictureURL[k]}]]></PictureURL>`;
  }

  xmllist += '</PictureDetails>';

  // 数量・価格
  xmllist += `<Quantity>${quantity}</Quantity>`;
  xmllist += `<StartPrice>${startPrice}</StartPrice>`;

  // Best Offer
  if (bestOfferEnabled > 0) {
    xmllist += '<BestOfferDetails><BestOfferEnabled>true</BestOfferEnabled></BestOfferDetails>';
    xmllist += `<ListingDetails><MinimumBestOfferPrice currencyID="USD">${minimumBestOfferPrice}</MinimumBestOfferPrice></ListingDetails>`;
  }

  // 出品期間・セラープロファイル
  xmllist += `<ListingDuration>${listingDuration}</ListingDuration>`;
  xmllist += '<SellerProfiles>';
  xmllist += `<SellerPaymentProfile><PaymentProfileName>${paymentProfileName}</PaymentProfileName></SellerPaymentProfile>`;
  xmllist += `<SellerReturnProfile><ReturnProfileName>${returnProfileName}</ReturnProfileName></SellerReturnProfile>`;
  xmllist += `<SellerShippingProfile><ShippingProfileName>${shippingProfileName}</ShippingProfileName></SellerShippingProfile>`;
  xmllist += '</SellerProfiles>';

  xmllist += `<ListingType>${listingType}</ListingType>`;
  xmllist += `<Location>${location}</Location>`;

  // ItemSpecifics
  xmllist += '<ItemSpecifics>';
  for (let k = 0; k < spec.length; k += 2) {
    if (!spec[k]) continue;
    xmllist += `<NameValueList><Name>${spec[k]}</Name><Value>${spec[k + 1]}</Value></NameValueList>`;
  }
  xmllist += '</ItemSpecifics>';

  // 共通情報（国・通貨・サイト）
  xmllist += '<Country>JP</Country><Currency>USD</Currency><Site>US</Site></Item>';

  // 特殊文字処理
  // ※CDAT A部分は影響を受けませんが、他要素内の & を一括でエスケープ
  xmllist = xmllist.replace(/&/g, '&amp;');

  // =======================================
  // Trading API（AddItem）呼び出し
  // =======================================
  const url = 'https://api.ebay.com/ws/api.dll';

  const headers = {
    'X-EBAY-API-DEV-NAME': devid,       // Developer ID
    'X-EBAY-API-CERT-NAME': appid,      // Cert ID（ここではappidに格納）
    'X-EBAY-API-CALL-NAME': 'AddItem',  // 'AddItem' or 'VerifyAddItem'
    'X-EBAY-API-SITEID': '0',           // US = 0
    'X-EBAY-API-REQUEST-ENCODING': 'XML',
    'X-EBAY-API-COMPATIBILITY-LEVEL': '1119',
  };

  // AddItemRequest 本体
  const xml =
    '<?xml version="1.0" encoding="utf-8"?>' +
    '<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">' +
      '<RequesterCredentials>' +
        `<eBayAuthToken>${authtoken}</eBayAuthToken>` +
      '</RequesterCredentials>' +
      '<ErrorLanguage>en_US</ErrorLanguage>' +
      '<WarningLevel>High</WarningLevel>' +
      xmllist +
    '</AddItemRequest>';

  Logger.log(xml);

  const options = {
    method: 'post',
    contentType: 'application/xml',
    headers: headers,
    payload: xml,
  };

  // API呼び出し
  let response = UrlFetchApp.fetch(url, options).getContentText();
  Logger.log(response);

  // =======================================
  // レスポンス解析
  // =======================================
  let stat = '';
  let tim  = '';
  let iid  = '';
  let errmsg = '';

  try {
    stat = String(response).split('<Ack>')[1].split('</Ack>')[0];
  } catch (e) {
    stat = '';
  }

  try {
    tim = String(response).split('<Timestamp>')[1].split('</Timestamp>')[0];
  } catch (e) {
    tim = '';
  }

  try {
    iid = String(response).split('<ItemID>')[1].split('</ItemID>')[0];
  } catch (e) {
    iid = '';
  }

  try {
    const tmpcnt = String(response).split('<LongMessage>');
    for (let kk = 1; kk < tmpcnt.length; kk++) {
      const msg = String(response).split('<LongMessage>')[kk].split('</LongMessage>')[0];
      errmsg += '\n' + msg;
    }
  } catch (e) {
    errmsg = '';
  }

  // Failure時は ItemID の代わりにエラーメッセージを返す
  if (stat === 'Failure') {
    iid = errmsg;
  }

  // 結果をシートに書き込み
  listsheet.getRange(ADDR_RESULT_STAT).setValue(stat);
  listsheet.getRange(ADDR_RESULT_ID).setValue(iid);
  listsheet.getRange(ADDR_RESULT_RES).setValue(String(response));

  // 呼び出し元にも返却
  return [stat, tim, iid];
}

// =======================================
// ItemSpecifics（例: D90:AA91）を
// [Name1, Value1, Name2, Value2, ...] に変換する関数
// =======================================
function getItemSpecificsArray() {

  // ItemSpecifics 領域を取得
  const values = listsheet.getRange(ADDR_ITEM_SPECIFICS).getValues();

  const names = values[0];   // 上段：項目名
  const specs = values[1];   // 下段：値
  const result = [];

  for (let i = 0; i < names.length; i++) {
    let name  = names[i];
    let value = specs[i];

    // Name が空ならスキップ
    if (!name) continue;

    // UPC が空なら "Does Not Apply"
    if (name === 'UPC' && (value === '' || value == null)) {
      value = 'Does Not Apply';
    }

    result.push(name);
    result.push(value);
  }

  Logger.log(result);  // 必要に応じて削除可
  return result;
}