eBayツール開発

あなたは、eBay輸出に必要なAPIについてご存じですか?本記事では、中小企業庁認定越境EC支援機関、経済産業省認定情報処理支援機関、越境EC起業家、著者、越境ECビジネスのプロフェッショナルである一条が、ツール開発に必要となるAPIについて解説します。eBay輸出を実践しているとどこかのタイミングで市販ツールについて物足りなくなると思います。その場合は、当記事を参考にツール開発に切り変えるとよいと思います。

eBay輸出ツール開発・利用に必要なAPI取得手順[完全保存版]

eBayツール開発に必要なAPI導入ガイド

2016年の11月からリサーチツールの開発を進めています。いよいよ、プロトタイプの最終段階に入りました!

1つだけうまくいかない事があり、いろいろと調査を進めています。

このサイトは非常に有益なサイトですのでブックマークを推奨します。

今後、あなたが、ツール開発で行き詰まった時は、是非、参考にして下さい。以前は英語版しかなかったと思いますが、現在は、日本語で詳細に解説されています。

eBay API導入ガイド

eBay APIについて詳細を知りたい方はイーベイデベロッパーポータルをご覧ください。

eBayデベロッパーアカウントの登録

APIとはApplication Programming Interfaceの略です。アプリケーションを繋ぐものということです。

API利用手順は以下の手順になります。この情報をメモしてください。

  • アカウント登録
  • Sandboxユーザ登録(利用しません)
  • アプリケーションキーの取得
  • ユーザトークン取得

デベロッパーアカウント登録動画解説

【目次】
00:00:00 はじめに
00:01:06 eBay ディベロッパーアカウント登録 Join
00:02:54 メールによる認証の確認

デベロッパーアカウント登録手順

APIを利用するには、eBay developer programでデベロッパーアカウントの登録をする必要があります。eBay developer programにアクセスし、 Registerリンクから新規登録フォームを送信します。 送信後は、登録のメールに受信した案内にしたがって、アカウントを有効化します。 登録するとeBayの承認待ちの連絡がきます。1日かかります。

2023年3月現在はパスワードが強化されています。長さ、数字と文字、記号の組み合わせが必要です。全てチェックが揃ったら「JOIN」を押下します。

デペロッパーアカウント登録後、メールが届きます。

メール添付のURLからアクセスしたら「Wellcome」の表示がでます。

その後ログインすると、アカウント有効化は完了しました。

デベロッパーアカウント登録

デベロッパーアカウントへのサインイン

アプリケーションキーの名前の登録

2024年1月時点では、画面が以下のように、何も表示されなくなりました。

ここで、アプリケーションキーの名前をタイトル欄へ入力して、Production側から「Create a keyset」ボタンを押下します。

アプリケーションキー、トークンの取得

アプリケーションキー、トークン取得の解説動画

アプリケーションキーはeBay APIを呼び出す際にデベロッパーを識別するユニークキーです。 My Accountページにあるボタンから、Productionのキーを生成します。 キーを生成すると、DevID、AppID、CertID の3つが生成されます。この3つで一つのキーセットとなるので、API呼び出し時に必要になります。

  • AppID: アプリケーションを識別するキー
  • DevID : デベロッパーアカウントを識別するキー
  • Cert ID : API呼び出し時にアプリケーションを認証するキー

【目次】
00:00:00 はじめに
00:00:50 eBayアカウント削除/閉鎖通知のワークフローの手続き
00:04:40 トークン情報の取得
00:06:40 アプリケーションIDの取得

eBay APIアカウント 削除/閉鎖通知の設定

2021年10月以降APIを取得される場合は、以下の記事を必ず確認して、eBay APIアカウント 削除/閉鎖通知の設定の手続きを行ってください。

そのまま、ログインすると、アプリケーションキーのProductionの設定がブラックアウト画面になっています。青文字をクリックします。

eBayアカウント削除/閉鎖通知のワークフロー

eBayアカウント削除/閉鎖通知のワークフローについて処理を行う必要があります(eBayジャパン関連記事)。

Not persisting eBay dataにチェック

I do not persist eBay data にチェックを入れて、Submitします。
I am an eBay vendor and handle data as per my contractual/legal agreement with eBay ではありません。

アプリケーションキーの登録照会

以下のように、App ID、Dev ID、Cert IDが表示されます。

アプリケーションキーの登録

トークンの発行

App IDにあるUser Tokenをクリックすると、Tokenの発行画面になります。

環境をProduction環境を選択し、Get a User Token Hereで、そのままSign in します。

すると、赤枠の所に、文字が現れますので、それがトークンです。そのままコピーします。

うまく登録できない場合の対応

APIに登録するメールアドレスと紐付けるebayのIDの登録内容と全て違っていてもAPIは取得できますか?

3-2でeBay APIユーザーとeBayユーザーアカウントを紐づけるので、別でも問題ありません。

Welcomeメールがとどきません。

届いているはずです。迷惑メールなどをご確認ください。

ログイン画面で登録したメールアドレスとパスワードを入れるとエラーになる

Your account registration was rejected due to problems with the data provided or other irregularities.
If you believe this rejection is in error, please see our FAQs and Contact Channels page or work with your eBay representative directly.

提供されたデータの問題またはその他の不規則性のため、アカウント登録は拒否されました。
この拒否が誤っていると思われる場合は、よくある質問と連絡先チャネルのページを参照するか、eBayの担当者に直接連絡してください。

リセットの手順は以下の通りです。

リセットできないなら以下の手順のようです。よろしくお願いいたします。
https://developer.ebay.com/contact-us
I cannot reset my eBay developer username or password

If you forgot your developer username, please login with the email that you used to register.

  • Note: We will not reset the eBay developer username or password manually due to the sensitive nature of the data. Please follow the steps below (To reset your developer password) or register a new account here.
  • If you cannot access your registered email, see the next topic on this page.
  • Your developer account is separate from your eBay member account.
  • Use your eBay member account to login to the developer forums.
  • For Sandbox login issues, see Help with the eBay Sandbox

開発者のユーザー名を忘れた場合は、登録に使用したメールでログインしてください。

注: データの機密性のため、eBay 開発者のユーザー名またはパスワードを手動でリセットすることはありません。 以下の手順(開発者パスワードをリセットするには)に従うか、こちらで新しいアカウントを登録してください。

登録した電子メールにアクセスできない場合は、このページの次のトピックを参照してください。

開発者アカウントは、eBay メンバー アカウントとは別のものです。

eBay メンバー アカウントを使用して、開発者フォーラムにログインします。

サンドボックスのログインの問題については、eBay サンドボックスのヘルプを参照してください

To reset your developer password:

  1. Go to https://developer.ebay.com/fyp
    This screen lets you select where to receive a PIN.
  2. Enter your username or email.
  3. Select Email the PIN.
  4. Enter the CAPTCHA text on the form.
  5. Click Send Now to verify your email.
  6. On the second form, verify that the email shown is the correct email.
  7. Enter the new CAPTCHA text on the second form.
  8. Click Confirm.
    If a developer account matches your email, you will receive the PIN within a few minutes.
  9. If you do not receive a PIN within 30 minutes, please check the following article for more details.
  10. If you feel you have completed all steps successfully, and did not receive a PIN, please fill in the form below for assistance.

開発者パスワードをリセットするには:

  1. https://developer.ebay.com/fyp にアクセスしてください
    この画面では、PIN を受け取る場所を選択できます。
  2. ユーザー名または電子メールを入力します。
  3. [PIN をメールで送信] を選択します。
  4. フォームに CAPTCHA テキストを入力します。
  5. [今すぐ送信] をクリックしてメールを確認します。
  6. 2 番目のフォームで、表示されている電子メールが正しい電子メールであることを確認します。
  7. 2 番目のフォームに新しい CAPTCHA テキストを入力します。
  8. [確認] をクリックします。
    開発者アカウントがメールと一致する場合は、数分以内に PIN が届きます。
  9. 30 分以内に PIN が届かない場合は、次の記事で詳細を確認してください。
  10. すべての手順を正常に完了し、PIN を受け取っていないと思われる場合は、以下のフォームにご記入ください

アカウント登録が拒否されました「Your account registration was rejected due to problems with the data provided or other irregularities. If you believe this rejection is in error, please see our FAQs and Contact Channels page or work with your eBay representative directly.」

eBay APIアカウント 削除/閉鎖通知の設定を行う必要があります。

Your account registration was rejected due to problems with the data provided or other irregularities. If you believe this rejection is in error, please see our FAQs and Contact Channels page or work with your eBay representative directly.

アカウント登録が拒否されました。この拒否が誤りであると思われる場合は、よくある質問と連絡先ページをご覧になるか、eBayの担当者に直接お問い合わせください。

SKUが取得できず、SKUの欄に以下のエラーが表示されます。「Validation of the authentication token in API request faild」

eBayデベロッパーアカウントは登録したが、「Validation of the authentication token in API request faild」というエラーメッセージがでる場合があります。これは、eBayデベロッパーアカウントとeBayアカウントのID、パスワードからログインして

  • 「トークンの発行」を行っていない
  • 異なるトークンをコピーしていた
  • トークンが期限切れである が原因になります。

この場合の対応は、「2-4 トークンの発行」になります。

再度、eBayデベロッパーアカウントとeBayアカウントのID、パスワードからログインして、トークンを取得、そのトークン情報をツールへ再設定を行った所、正常に取得できます。

アプリケーション側のトークン情報をご確認ください。

トークンはアプリによって取り消されました。This token has been revoked by app. the end user must complete the Auth Auth consent flow again to general a valid token.

トークンが期限切れなどのため、デベロッパーアカウントに再ログインしてご確認よろしくお願いいたします

まとめ

いかがでしたか?本記事ではeBay輸出のツール開発に必要となるAPIについて解説します。eBay輸出を実践しているとどこかのタイミングで市販ツールについて物足りなくなると思います。その場合は、当記事を参考にツール開発に切り変えるとよいと思います。