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

あなたは、eBay輸出に必要なAPIについてご存じですか？本記事では、中小企業庁認定越境EC支援機関、経済産業省認定情報処理支援機関、越境EC起業家、越境ECビジネスのプロフェッショナルである著者が、ツール開発に必要となるeBay Developer Account、アプリケーションキー、ユーザートークン、APIの取得手順について解説させていただきます。

eBay輸出ツール開発・利用に必要なeBay Developer Account、アプリケーションキー、ユーザートークン、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からアクセスしたら「Welcome」の表示がでます。

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

アプリケーションキーの発行

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

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

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

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

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

アプリケーションキーはeBay APIを呼び出す際にデベロッパーを識別するユニークキーです。 My Accountページにあるボタンから、Productionのキーを生成します。キーを生成すると、DevID、AppID、CertID の３つが生成されます。この３つで一つのキーセットとなるので、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が表示されます。

トークンの発行

Production環境へサインイン

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

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

まず、eBayデベロッパーアカウントにログインすると、App IDが表示されています。その下にあるユーザートークン「User Token」をクリックしました。

すると、ユーザートークンにサインイン画面になりますので、Sign in Productionボタンを押下します。

ここでログインします。

次の画面でeBayデベロッパーアカウントとeBayアカウントを認証するかという画面が表示されますので、Agree(同意)ボタンを押下します。

トークン情報の取得（Copy Token to Clipboard）

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

トークン情報のテキスト保存

ダイレクトにコピー＆ペーストはHtml形式になるため、形式が異なってできないので、一旦、コピー＆ペーストでテキストに保存します。

その後、テキストをコピーして、ツール側へペーストして貼り付けてください。

トークンの再発行

トークンの期限が切れてしまった場合は、トークンを再発行します。

まず、eBayデベロッパーアカウントにログインすると、App IDが表示されています。その下にあるユーザートークン「User Token」をクリックしました。

すると、ユーザートークンにサインイン画面になりますので、Sign in Productionボタンを押下します。

ここでログインします。

次の画面でeBayデベロッパーアカウントとeBayアカウントを認証するかという画面が表示されますので、Agree(同意)ボタンを押下します。

すると、以下のように、新しいトークン情報が発行されます。これをツールへ設定します。

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

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

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

Welcomeメールが届きません。

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

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

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

アカウント登録が拒否されました「Your account registration was rejected due to problems with the data provided or other irregularities.」

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の担当者に直接お問い合わせください。

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

リセットできないなら以下の手順のようです。よろしくお願いいたします。
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:

Go to https://developer.ebay.com/fyp
This screen lets you select where to receive a PIN.

Enter your username or email.

Select Email the PIN.

Enter the CAPTCHA text on the form.

Click Send Now to verify your email.

On the second form, verify that the email shown is the correct email.

Enter the new CAPTCHA text on the second form.

Click Confirm.
If a developer account matches your email, you will receive the PIN within a few minutes.

If you do not receive a PIN within 30 minutes, please check the following article for more details.

If you feel you have completed all steps successfully, and did not receive a PIN, please fill in the form below for assistance.

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

https://developer.ebay.com/fyp にアクセスしてください
この画面では、PIN を受け取る場所を選択できます。

ユーザー名または電子メールを入力します。

[PIN をメールで送信] を選択します。

フォームに CAPTCHA テキストを入力します。

[今すぐ送信] をクリックしてメールを確認します。

2 番目のフォームで、表示されている電子メールが正しい電子メールであることを確認します。

2 番目のフォームに新しい CAPTCHA テキストを入力します。

[確認] をクリックします。
開発者アカウントがメールと一致する場合は、数分以内に PIN が届きます。

30 分以内に PIN が届かない場合は、次の記事で詳細を確認してください。

すべての手順を正常に完了し、PIN を受け取っていないと思われる場合は、以下のフォームにご記入ください

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

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