v1.0.0
eBay商品説明取得(Googleシート)
eBay の商品番号を並べると、公式 API で商品名と Description(商品説明)の HTML をまとめて取得する Google スプレッドシートです。取得した結果は CSV にして、「商品説明のタグ除去(CSV)」でそのまま開けます。
🔒 スプレッドシートは、あなたの Google ドライブにコピーして使います。eBay との通信は、コピーしたスプレッドシートの中(Google Apps Script)から行い、商品番号・説明・eBay の鍵を ToT のサーバーへ送ることはありません。
スプレッドシートをコピーする
Google のページが開き、「コピーを作成」を押すと、あなたの Google ドライブにコピーされます。無料・ToT の会員登録は要りません。
必要なもの
- Google アカウント(スプレッドシートを使うため)。
- eBay の開発者アカウントで発行した、本番(Production)の User Token(eBay Sign-in で作るトークン)。各自で用意します(ToT の鍵を貸し出す形ではありません)。
- 開発者アカウントの登録と、本番の Keyset・User Token の取り方は、ブログの「eBay API 実践講座」が参考になります:02 Developers Program 登録と Keyset 作成・05 Production Keyset と本番 User Token。
- 鍵がなくても、最初の「試験(モック)」で、eBay に接続せずにシートの動きを試せます。
使い方
- コピーする:上の「スプレッドシートをコピーする」から、自分の Google ドライブにコピーします。
- 最初の許可:コピーを開き、上のメニュー「eBay説明の取得」→「初期設定(シートを作る・整える)」を押します。「認証が必要です」→「OK」→ 自分のアカウントを選びます。「Google はこのアプリを確認していません」と出たら、「詳細」→「(安全ではないページ)に移動」→「許可」を押します。自分のドライブにコピーした、まだ審査を受けていないスクリプトなので、この表示が出ます。
- 試験(モック)で試す:「取得」シートの A 列(Item ID)に
123456780001などの番号を入れ、「未取得・失敗の行を取得(最大100件)」を押します。eBay には接続せず、試験データで動きを確かめられます。 - 本番にする:「設定・使い方」シートの「接続先」を「本番」にし、メニュー「eBayの認証を設定」を開きます。方式で「Auth'n'Auth のトークン」を選び、本番の User Token を貼って「保存」を押します(下の「講座との違い」も読んでください)。「接続を確認(商品は読まない)」で「OK:接続できました」と出れば準備完了です。
- 取得する:A 列に eBay の商品番号(または商品ページの URL)を 1 行に 1 つ入れ、「未取得・失敗の行を取得(最大100件)」を押します。B 列に商品名、C 列に説明の HTML、D 列に状態(成功・取得不可など)が入ります。
- CSV にする:「成功した行をCSVに出力」→「CSV をダウンロード」で、
ebay_descriptions_日付_時刻.csvを保存します。 - タグを外す:「商品説明のタグ除去(CSV)」で CSV を開くと、Item ID・Title・Description の列が自動で選ばれ、説明の HTML から文章を取り出せます。
講座との違い(鍵の保存場所)
- 「eBay API 実践講座」の 04・05 では、鍵を Apps Script のスクリプトプロパティ(
EBAY_APP_ID・EBAY_DEV_ID・EBAY_CERT_ID・EBAY_USER_TOKEN)に入れています。このシートでは、スクリプトプロパティには入れません。 - 代わりに、メニュー「eBayの認証を設定」の画面から入れ、ユーザープロパティ(このスクリプトの、あなた専用の保存場所)に保存します。スクリプトプロパティと違い、スプレッドシートの編集権限をほかの人に渡しても、その人からは見えません。値を表示する画面もありません(保存後は「設定済み」と保存した日時だけが出ます)。
- 入れるのは、講座 05 で取った本番の User Token(
EBAY_USER_TOKENに入れていた値)だけです。方式は「Auth'n'Auth のトークン」を選びます。App ID・Dev ID・Cert ID は、この方式では入れません。 - OAuth のリフレッシュトークンを使う場合は、方式で「OAuth」を選び、App ID(Client ID)・Cert ID(Client Secret)・Refresh Token を入れます。
- トークンを取り直したときや、消したいときも、同じ画面から入れ直す・「保存した認証を消す」を押します。Apps Script のエディタを開く必要はありません。
取得できる範囲
- eBay の公式 API(Trading API の GetItem)だけを使います。ページの読み取り(スクレイピング)はしません。
- 自分の出品(販売中・販売していないもの)と、ほかの出品者の出品中の商品を、商品番号で取得できます。
- 終了から 90 日を超えた出品は、eBay の API が情報を返さないため「取得不可」になります。
- 取得専用です。eBay の出品を変更・更新することはありません。自動の定期実行もしません。
回数と動き
- 1 回の実行で最大 100 件です。残りがあるときは件数を出すので、もう一度実行します。成功した行は上書きしません(取り直すときは、行を選んで「選んだ行を取り直す」)。
- 途中で止まっても、成功した行はその都度記録されます。もう一度実行すると続きから取得します。
- eBay の API の呼び出しには、あなたの鍵ごとに 1 日の上限があります(Trading API の既定は 1 日 5,000 回)。上限や認証の問題に当たったときは、それ以上呼び出さずに止めて知らせます。
- 長い説明(1 セル 50,000 文字を超えるもの)も、切り捨てずに全文を保存し、CSV に全文を出します。
データの扱い
- このページは、何も送信・保存しません。
- eBay の鍵とトークンは、コピーしたスプレッドシートの、あなた専用の保存場所(Apps Script のユーザープロパティ)に保存します。シート・ログ・CSV には出しません。スプレッドシートを共有・コピーしても、鍵は引き継がれません。
- 取得した商品名と説明は、あなたのスプレッドシートの中に保存します。ToT のサーバーには送りません。
- CSV は UTF-8(BOM 付き)です。値は API から返ったままで、= や + で始まる値は出力の画面で知らせます(Excel などで開くときは、式として読まれないよう注意してください)。
- スプレッドシートが使う Google の権限は、「このスプレッドシートの表示と編集」「外部サービスへの接続(eBay の API だけ)」「スプレッドシートでのダイアログの表示」の 3 つです。Google ドライブのほかのファイルや Gmail には触れません。
あわせて使うツール
- 商品説明のタグ除去(CSV):取得した CSV の説明から、タグを外した文章を取り出します。
- eBay商品説明編集(詳細版):取り出した文章を、見た目を整えた説明に作り直します。