操作・設定マニュアル

プログラミングの知識がなくても使えるように書いています。最初の設定（約30分・1回だけ）が終われば、あとはスプレッドシートを開くだけです。
※画面の文言はGoogle・eBay側の更新で少し変わることがあります。

1. 全体の流れ

このツールは、次の3つだけで動いています。外部の有料サービスは使いません。

• eBay公式API：eBayが開発者向けに無料で公開している、商品情報を取得するための正式な窓口です。
• Google Apps Script：スプレッドシートに付属しているプログラムの実行機能です。Googleのサーバー上で1時間ごとに自動で動きます。
• Googleスプレッドシート：取得した新着商品が並ぶ管理表です。

スプレッドシートは次の3シート（＋非表示1シート）でできています。

2. eBay APIキーの取得（初回のみ・無料）

eBayの公式APIを使うための「鍵」を発行します。発注者様ご自身のアカウントで発行していただくことで、外注者に依存しない運用になります。

1. eBay Developers Program（developer.ebay.com）を開き、「Register」から開発者アカウントを登録します（無料）。
   登録後、利用開始の承認まで最大1営業日ほどかかることがあります。
2. ログイン後、右上のメニューから Application Keys（アプリケーションキー）を開きます。
3. アプリ名（例：ebay-new-listing-sheet）を入力し、Production（本番）側の「Create a keyset」を押します。
4. キー作成時に、eBayから「アカウント削除通知（Marketplace Account Deletion）」の設定を求められます。画面の案内に沿って設定してください。ここは分かりにくいところなので、ご契約後、実際の画面に合わせた手順をお送りし、一緒に確認しながら進めます。
5. 表示された App ID（Client ID） と Cert ID（Client Secret） を控えます。
   Dev ID は使いません。Sandbox（テスト用）ではなく Production のキーを使ってください。

3. スプレッドシートの準備

方法A（おすすめ）：テンプレートをコピー

1. 納品時にお送りするテンプレートのスプレッドシートを開きます。
2. メニュー「ファイル」→「コピーを作成」を押します。
3. 発注者様のGoogleドライブに、プログラムごとコピーされます。以降はこのコピーを使います。

方法B：新しいスプレッドシートに貼り付け

1. Googleスプレッドシートで新しいファイルを作ります。
2. メニュー「拡張機能」→「Apps Script」を開きます。
3. 最初からある内容をすべて消し、Code.gs の中身を貼り付けて、💾保存します。
4. スプレッドシートの画面に戻り、ページを再読み込みします。メニューに eBay新着ツール が表示されればOKです。

初めて実行するときの「承認」について

最初にメニューを押すと「承認が必要です」と表示されます。「続行」→ご自身のGoogleアカウントを選択→「詳細」→「（プロジェクト名）に移動」→「許可」の順に進んでください。
「Googleで確認されていません」と表示されるのは、発注者様専用に作ったプログラムで、一般公開アプリとしての審査を受けていないためです。許可する内容は「このスプレッドシートの編集」「外部（eBay）への接続」「エラー通知メールの送信」「定期実行」の4つです。

4. 初期設定（メニュー①〜⑤を上から順に）

スプレッドシート上部のメニュー eBay新着ツール を開き、上から順に押していきます。動作デモで同じ操作を試せます。

5. ふだんの使い方

• 「新着一覧」シートを開くだけです。新しい商品ほど上に並びます。「区分」が 新規 の行が、前回のチェック以降に見つかった新着です。
• フィルタ・並べ替え・色付け・行の削除は自由に行って大丈夫です。削除した商品が再び登録されることはありません（重複判定は非表示シートで行っています）。
• メモ欄などを追加したい場合は、J列より右に追加してください。A〜I列の並び順は変えないでください。
• 商品URLをクリックすると、eBayの商品ページが開きます。

6. 稼働状況の確認方法

1. 設定シートの B16「最終実行」：日時が1時間〜1時間半以内で「（正常）」と出ていれば、正しく動いています。
2. メニュー「稼働状況を確認」：APIキー・自動実行のON/OFF・最終実行・各セラーの状況をまとめて表示します。最終実行から2時間以上経っている場合は警告が出ます。
3. 「ログ」シート：毎回「チェック完了：新着 ○件を追加」と記録されます。ERROR や WARN の行があれば、エラーが出たときをご覧ください。
4. エラー通知メール：エラーが起きると、スプレッドシート所有者のGmail（または設定シート B14 のアドレス）にメールが届きます。同じ通知は6時間に1回までです。
5. （詳しく見たい場合）「拡張機能」→「Apps Script」→ 左側の 実行数：過去の実行履歴と所要時間が一覧で見られます。

7. 対象セラーの変更・追加

セラーIDの調べ方

1. eBayで対象セラーの商品ページを開き、セラー名をクリックしてプロフィールページを開きます。
2. アドレス欄が https://www.ebay.com/usr/○○○○ のようになっていれば、○○○○ がセラーIDです。
3. このURLをそのまま B列に貼り付けても、セラーIDだけを自動で取り出します（_ssn=○○○○ を含む検索URLにも対応）。

※ストア名（Store名）とセラーIDは異なる場合があります。ストアページ（/str/〜）のURLでは判別できないため、プロフィールページのURLをお使いください。

操作

8. エラーが出たとき

まず「ログ」シートと、設定シートの「結果」列（F列）を見てください。よくあるものと対処は次のとおりです。

9. eBayの仕様変更などで動かなくなったとき

1. ログのエラー内容を控えます（「#12001」のような番号があれば、それも）。
2. 予備の取得方式に切り替えます。このツールは通常「セラー指定・全カテゴリ」で検索しています。eBay側がこの検索方法を変えた場合は、設定シートの D列「カテゴリID（任意）」 に、そのセラーが主に出品しているカテゴリのIDを入力すると、カテゴリごとに取得する方式に切り替わります（カンマ区切りで複数可）。

   カテゴリ（eBay.com の例）	カテゴリID
   Cameras & Photo	625
   Video Games & Consoles	1249
   Toys & Hobbies	220
   Jewelry & Watches	281
   Musical Instruments & Gear	619
   Collectibles	1

   カテゴリIDは、eBayでカテゴリを開いたときのURLの数字で確認できます。カテゴリを増やすほどAPIの使用回数も増えます（5名×5カテゴリでも1日600回程度で、上限5,000回には十分収まります）。
3. それでも直らない場合や、eBay APIそのものの終了・大きな変更があった場合は、ご連絡ください。納品後15日間は無料で対応します。それ以降は、内容を確認してから事前にお見積りをお出しします（勝手に費用が発生することはありません）。
4. 直るまでの間、エラーメールを止めたい場合は「自動実行をOFF」にしてください。

10. 制限事項・取得漏れの可能性

• 出品から次のチェックまで（最大約1時間）の間に売れた・終了した商品は、取得できない場合があります。
• チェックは「約1時間ごと」です。Googleの仕様で、実行時刻は毎回数分ずれます。
• eBayの検索結果への反映に時間がかかる出品は、毎回6時間さかのぼって再確認することで拾っています。6時間以上反映が遅れた場合は取得できないことがあります（通常はほぼありません）。
• 1回のチェックで確認できるのは、1セラーあたり最大1,000件です。
• 再出品（Relist）は、eBay上「元の出品日」が引き継がれるため、新着として扱われない場合があります。
• オークション・即決（Buy It Now）どちらの出品も対象です。
• 価格はeBayが返す表示価格（eBay.comならUSD）です。オークションの場合は、その時点の入札価格です。

11. 費用・無料枠について

いずれも無料枠の範囲で動くため、月額費用は0円です。

12. アカウント・権限について

• スプレッドシート・プログラム・自動実行の設定・eBay APIキーは、すべて発注者様のアカウントに属します。
• 自動実行は「⑤ 自動実行をON」を押したアカウント（発注者様）の権限で動くため、外注者のアカウントがなくなっても止まりません。
• 設定作業のために編集権限を共有いただいた場合は、納品後に「共有」設定から外注者のアカウントを削除してください。
• プログラム（Code.gs）は、発注者様が自由に編集・複製できます。

ご不明な点は、Lancersのメッセージからお気軽にお問い合わせください。
LYCデザイン