amazon マーケットプレイス webサービス入門ガイド...amazon...

25
Amazon マーケットプレイス Web サービス入門ガイド (API Version 2009-01-01)

Upload: others

Post on 27-Jul-2020

1 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービス入門ガイド

(API Version 2009-01-01)

Page 2: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

2

Amazon マーケットプレイス Web サービス入門 ガイド (API Version 2009-01-01)

Copyright © 2009-2010 Amazon.com, Inc. or its affiliates AMAZON and AMAZON.COM are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.

Page 3: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

3

目次

はじめに................................................................................................................................................................................. 5

対象者................................................................................................................................................................................. 5

前提となる知識とスキル ................................................................................................................................................. 5

関連資料............................................................................................................................................................................. 6

更新履歴................................................................................................................................................................................. 7

Amazon マーケットプレイス Web サービスの紹介 ......................................................................................................... 8

Amazon マーケットプレイス Web サービスの概要 ..................................................................................................... 8

入門ガイド ............................................................................................................................................................................. 9

出品用アカウントの登録方法 ........................................................................................................................................... 10

MWS への登録方法 ............................................................................................................................................................. 11

開発環境のセットアップ ................................................................................................................................................... 14

Java.................................................................................................................................................................................. 14

C# .................................................................................................................................................................................... 14

PHP ................................................................................................................................................................................... 14

サンプルコードのダウンロード ....................................................................................................................................... 15

Java.................................................................................................................................................................................. 15

C# .................................................................................................................................................................................... 15

PHP ................................................................................................................................................................................... 16

アクセスキー(アクセスキーID/秘密キー)の設定 ...................................................................................................... 17

Java.................................................................................................................................................................................. 17

C# .................................................................................................................................................................................... 18

PHP ................................................................................................................................................................................... 19

サンプルコードの実行 ....................................................................................................................................................... 20

Java.................................................................................................................................................................................. 20

C# .................................................................................................................................................................................... 20

PHP ................................................................................................................................................................................... 21

補足事項............................................................................................................................................................................... 22

Page 4: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

4

MWS アプリケーションの開発 ......................................................................................................................................... 23

MWS アクセスキー ............................................................................................................................................................. 24

MWS アクセスキーと ID の確認方法 ........................................................................................................................... 24

MWS エンドポイント一覧 ................................................................................................................................................. 25

Page 5: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

5

はじめに

ようこそ

トピック

対象者

前提となる知識とスキル

開発環境のセットアップ

この章では、本ガイドの対象者、前提とされる知識とスキル、Amazon マーケットプレイス Web サービスに関連するその他の関連資

料について説明します。

Amazon マーケットプレイス Web サービスは本ガイド内で単に「Amazon MWS」または「MWS」と記載されている場合がありま

すが、著作権と法的保護は同様に適用されます。

対象者

本ガイドは、Amazon マーケットプレイス Web サービスを使用して Amazon 出品者用の商品情報登録、注文情報のダウンロード、

出荷通知、その他の管理タスクなどを行なうためのアプリケーションを開発する開発者を対象としています。

※ Amazon MWS を使用するには、大口出品の出品用アカウントと Amazon MWS への登録が必要です。詳しくは、入門ガイドの

トピックを参照してください。

前提となる知識とスキル

XML に関する知識(概要については、 W3 Schools XML Tutorial を参照してください)。

Web サービスに関する基本的な知識(概要については、 W3 Schools Web Services Tutorial を参照してください)。

プログラミング言語の知識。

Amazon 上での販売についての基本的な知識(概要については、以下を参照してください)。

o DE: https://sellercentral.amazon.de/gp/help/

o FR: https://sellercentral.amazon.fr/gp/help/

o JP: https://sellercentral.amazon.co.jp/gp/help/

o UK: https://sellercentral.amazon.co.uk/gp/help/

o US: https://sellercentral.amazon.com/gp/help

Page 6: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

6

関連資料

下記は、Amazon MWS の関連資料になります。

説明 資料

Amazon マーケットプレイス Web サー

ビスに関する情報を提供する Web サイ

ト。この MWS 開発者用ガイドでは本サ

ービスの詳細な技術情報を確認すること

ができます。アーキテクチャの概要、プ

ログラミングリファレンス、API リファ

レンスが収録されています。

DE: http://developer.amazonservices.de

FR: http://developer.amazonservices.fr

JP: http://developer.amazonservices.jp

UK: http://developer.amazonservices.co.uk

US: http://developer.amazonservices.com

Selling on Amazon Guide to XML に

は、XML を用いた出品商品データの更

新方法とレポートに関する情報が記載さ

れております。

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/XML_Documentation_Intl.pdf

テキストファイルを用いた出品商品デー

タの更新方法とレポートに関する情報が

記載されております。

DE: https://sellercentral.amazon.de/gp/help/

FR: https://sellercentral.amazon.fr/gp/help/

JP: https://sellercentral.amazon.co.jp/gp/help/

UK: https://sellercentral.amazon.co.uk/gp/help/

US: https://sellercentral.amazon.com/gp/help

Amazon MWS に関する開発者向けの

技術コミュニティサイトです。

http://www.amazonsellercommunity.com/forums/category.jspa?categoryID=4

Page 7: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

7

更新履歴

下記表は、本ガイドの更新履歴で、最終更新日は 2010 年 7 月 8 日になります。

バージョン 説明 リリース日

初回リリース

API Version 2009-01-01

Amazon マーケットプレイス Web サービス入門ガイド(日本語版)リリース 2010 年 6 月

Page 8: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

8

Amazon マーケットプレイス Web サービスの紹介

本章では、Amazon MWS サービスの概要と、主な機能について説明します。

Amazon マーケットプレイス Web サービスの概要

Amazon マーケットプレイス Web サービスを使用することにより、Amazon 上で商品を販売するための自分の出品用アカウントや

他の出品者用向けに、販売する商品の検索、出荷手続き用の注文情報のダウンロード、定期レポートのダウンロードなどを行うための

アプリケーションを開発することができます。これらを実装するための方法として、REST に似た API を提供しております。

Amazon MWS は主に以下の機能を提供します:

在庫管理 - 在庫の一括アップロード、商品の追加、在庫数の確認、価格情報の調整やその他の在庫管理業務を行うことがで

きます。

注文管理 - 注文情報のダウンロード、決済情報の取得、注文の確認、定期レポートの設定を行うことができます。

レポート管理 -カスタマイズしたレポートを作成し、ダウンロードすることができます。

Page 9: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

9

入門ガイド

この章では下記の項目について説明します。

出品用アカウントの登録方法

MWS への登録方法

開発環境のセットアップ

サンプルコードのダウンロード

アクセスキーの設定

サンプルコードの実行

Page 10: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

10

出品用アカウントの登録方法

Amazon MWS を使用するには、大口出品用アカウントが必要です。大口出品用アカウントの作成方法は、以下を参照してください。

尚、現在 Amazon の個人出品者は MWS を利用できません。

DE: http://www.amazon.de/gp/seller-account/mm-product-page.html?topic=200331350

FR: http://www.amazon.fr/gp/seller-account/mm-product-page.html?topic=200328420

JP: http://www.amazonservices.jp/jp/services/sell-on-amazon.htm

UK: http://services.amazon.co.uk/services/sell-on-amazon/how-it-works/index.html

US: http://www.amazonservices.com/content/sell-on-amazon.htm

次に、Amazon MWS への登録を行います。詳しくは、次章「MWS への登録方法」の項を参照してください。

Page 11: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

11

MWS への登録方法

Amazon MWS を使用するには、MWS のポータルサイトでアカウントを登録する必要があります。登録方法は利用方法に応じて下

記の 3 通りがあります。

出品用アカウントでマーケットプレイス Web サービスを利用する場合

現在利用している Amazon 出品用アカウントを MWS に登録すると、開発者アカウント ID は出品用アカウントに割り当て

られます。MWS を使用する場合、開発者アカウント ID に関連づけられたアクセスキー、出品用 ID、マーケットプレイス

ID が必要になります。アクセスキーは、登録画面の最後に表示されます。

アプリケーションを使って、マーケットプレイス Web サービスにアクセスする場合

委託した開発者が MWS を使用する場合、その開発者にアクセス権限を付与する必要があります。まず、開発者は MWS 開

発者アカウント ID を取得します。次に開発者が出品者のアカウントにアクセスできるようにするために、出品者がその開発

者アカウント ID を MWS のポータルサイトで登録する必要があります。MWS の登録手続きの最後のページに、出品者

ID ・マーケットプレイス ID が表示されますので、委託する開発先にこれらの ID を提供することで、アクセスできるよう

になります。

開発者が、私の出品用アカウントでマーケットプレイス Web サービスを使用する場合

第三者が作成したアプリケーションを使用して、自分の Amazon 出品用アカウントにアクセスする場合は、MWS の登録手

続きの際に、開発元の開発者アカウント ID を登録する必要があります。また、アプリケーションを使用して自身の出品用ア

カウントにアクセスする際には、出品者 ID ・ マーケットプレイス ID・アクセスキーが必要になります。これらの設定方法

に関しては各アプリケーションの提供元に確認してください。

出品用アカウントでマーケットプレイス Web サービスを利用する場合。

1. 以下のサイトにアクセスしてください。

DE: http://developer.amazonservices.de

FR: http://developer.amazonservices.fr

JP: http://developer.amazonservices.jp

UK: http://developer.amazonservices.co.uk

US: http://developer.amazonservices.com

2. 「登録する」をクリックします。

3. Amazon 出品用アカウントにログインします。

4. 「 出品用アカウントでマーケットプレイス Web サービスを利用します。」を選択します。

5. 「次へ」をクリックします。

6. 問題がなければ、Amazon マーケットプレイス Web サービス・ライセンス契約に同意します。

Page 12: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

12

7. 「送信」をクリックします。

出品者 ID・マーケットプレイス ID・開発者アカウント ID・アクセスキーID、秘密アクセスキーが表示されます。

アプリケーションを使って、マーケットプレイス Web サービスにアクセスする場合。

1. 以下のサイトにアクセスしてください。

DE: http://developer.amazonservices.de

FR: http://developer.amazonservices.fr

JP: http://developer.amazonservices.jp

UK: http://developer.amazonservices.co.uk

US: http://developer.amazonservices.com

2. 「登録する」をクリックします。

3. Amazon 出品用アカウントにログインします。

4. 「アプリケーションを使って、マーケットプレイス Web サービスにアクセスすることを希望します。」を選択します。

5. 「次へ」をクリックします。

6. 開発者の氏名を入力します。

7. 開発者のアカウント ID を入力します。(必須項目)

8. 問題がなければ、Amazon マーケットプレイス Web サービス・ライセンス契約に同意します。

9. 「送信」をクリックします。

出品者 ID・マーケットプレイス ID が表示されます。委託する開発先にこれらの ID を提供することで、アクセス可能となり

ます。

開発者が、私の出品用アカウントでマーケットプレイス Web サービスを使用する場合。

1. 以下のサイトにアクセスします。

DE: http://developer.amazonservices.de

FR: http://developer.amazonservices.fr

JP: http://developer.amazonservices.jp

Page 13: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

13

UK: http://developer.amazonservices.co.uk

US: http://developer.amazonservices.com

2. 「登録する」をクリックします。

3. Amazon 出品用アカウントにログインします。

4. 「開発者が、私の出品用アカウントでマーケットプレイス Web サービスを使用することを許諾します。」を選択します。

5. 「次へ」をクリックします。

6. アプリケーション名を入力します。

7. アプリケーション提供者の開発者アカウント ID を入力します。(必須項目)

8. 問題がなければ Amazon マーケットプレイス Web サービス・ライセンス契約に同意します。

9. 「送信」をクリックします。

出品者 ID・ マーケットプレイス ID が表示されます。

Page 14: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

14

開発環境のセットアップ

このガイドに含まれるサンプルコードを使用する場合は、各言語別に必要なソフトウェアを事前にインストールする必要があります。

Java

Amazon マーケットプレイス Web サービスのサンプルコードを実行するには、Java 2 Platform Standard Edition 5.0

Development Kit (JDK 5.0) 以降が必要です。JDK が 5.0 より以前のバージョンの場合は、新しいバージョンをインストールして

ください。詳しくは、http://java.sun.com/javase/downloads/index.jsp を参照してください。

JDK をインストールするには

1. JDK をインストールするには、Sun Java の Web サイトに記載されている手順に従ってください。

2. JAVA_HOME の環境変数を JDK のインストール先に指定します。

C#

C#のサンプルコードを実行するには、Microsoft から提供される以下のソフトウェアをインストールしてください。

Microsoft Visual Studio (詳しくは、http://msdn.microsoft.com/vstudio)を参照。)または Microsoft Visual C#

Express Edition (詳しくは、http://msdn2.microsoft.com/en-us/express/aa975050.asp を参照。)

.NET Framework 2.0 (詳しくは、http://msdn.microsoft.com/netframework を参照。)

PHP

PHP サンプルコードを実行するには、以下のソフトウェアをインストールしてください。

PHP 5.2.8 以降 http://www.php.net/downloads.php

cURL 7.18.0 以降 http://curl.haxx.se/download.html

Page 15: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

15

サンプルコードのダウンロード

サンプルコードは以下のページからダウンロードしてください。

DE: http://developer.amazonservices.de

FR: http://developer.amazonservices.fr

JP: http://developer.amazonservices.jp

UK: http://developer.amazonservices.co.uk

US: http://developer.amazonservices.com

Java

サンプルコードをダウンロード後、任意のディレクトリに解凍してください。

Eclipse でプロジェクトを設定するには

1. メニューより「ファイル」→「新規」→「プロジェクト」を選択し、”新規の Java プロジェクト”を作成します。

2. “パッケージエクスプローラ”内で先ほど作成したプロジェクトを展開し、”src”フォルダー上で右クリックし「削除」を選

択してください。その後、「OK」をクリックしファイルを削除します。

3. ビルドパスを設定します。プロジェクト上で右クリックして、「ビルドパス」→「ビルドパスの設定」を選択します。

4. “ソース”タブをクリックして、ダウンロードしたサンプルコードの src ディレクトリを設定したビルドパスに関連づけます。

“ソースを関連づけ”ボタンをクリックして、ダウンロードしたサンプルコードを解凍したディレクトリ内の”src”フォルダを

選択してください。

5. “ライブラリ”タブをクリックし、third-party/*ディレクトリの下にあるすべての JAR ファイルを、ビルドパスに追加しま

す。

MWS Java クライアントライブラリを解凍したディレクトリ内の third-party フォルダへ移動し、最初のフォルダを開いて

JAR ファイルを選択します。

必要な JAR ファイルは 9 つありますので全て追加してください。

6. さらに、dist\lib 内にある MWS の Java クライアントライブラリファイルもビルドパスに追加します。

Amazon MWS Java クライアントライブラリに含まれるサンプルを実行するには、アカウントに割り当てられたアクセスキーを設定

する必要があります。詳しくは、アクセスキー(アクセスキーID/秘密キー)の設定を参照してください。

C#

1. C# プロジェクトファイルをダウンロードし、任意のディレクトリに解凍してください。

Page 16: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

16

2. プロジェクトファイルとライブラリをダウンロード後、ご利用の環境に合わせてプロジェクトを設定してください。

Amazon MWS C# クライアントライブラリに含まれるサンプルを実行するには、アカウントに割り当てられたアクセスキーを設定

する必要があります。詳しくは、アクセスキー(アクセスキーID/秘密キー)の設定トピックを参照してください。

PHP

1. PHP プロジェクトファイルをダウンロードし、任意のディレクトリに解凍してください。

2. プロジェクトファイルとライブラリをダウンロード後、ご利用の環境に合わせてプロジェクトを設定してください。

Amazon MWS PHP クライアントライブラリに含まれるサンプルを実行するには、アカウントに割り当てられたアクセスキーを設定

必要があります。詳しくは、アクセスキー(アクセスキーID/秘密キー)の設定トピックを参照してください。

Page 17: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

17

アクセスキー(アクセスキーID/秘密キー)の設定

MWS クライアントライブラリには、各サービスの API のコードサンプルが含まれています。これらのサンプルコードを実行するには、

出品用アカウントに割り当てられたアクセスキーを設定する必要があります。

注意

Amazon MWS を利用するためには、MWS に登録する必要があります。詳しくは、MWS への登録方法を参照してください。

MWS クライアントライブラリのダウンロードに関しては、サンプルコードのダウンロードを参照してください。

MWS アクセスキーの取得に関しては、MWS アクセスキーを参照してください。

MWS エンドポイントに関しては、MWS エンドポイント一覧を参照してください。

Java

1. src\com.amazonaws.mws.samples フォルダにあるサンプルコードを開きます。

2. 該当地域のエンドポイント部分のコメントを外し、MWS エンドポイントを設定します。

// US

// config.setServiceURL("https://mws.amazonservices.com");

// UK

// config.setServiceURL("https://mws.amazonservices.co.uk");

// JP

// config.setServiceURL("https://mws.amazonservices.jp");

// Germany

// config.setServiceURL("https://mws.amazonservices.de");

// France

// config.setServiceURL("https://mws.amazonservices.fr");

3. <Your Access Key ID>を自分のアクセスキーID に、<Your Secret Access Key>の部分を秘密キーにそれぞれ置き換え

ます。

final String accessKeyId = "<Your Access Key ID>";

final String secretAccessKey = "<Your Secret Access Key>";

4. アプリケーションまたは会社名、およびバージョンを設定します。

final String appName = "<Your Application or Company Name>";

final String appVersion = "<Your Application Version or Build Number or Release Date>";

5. マーケットプレイス ID と出品者 ID を設定します。

Page 18: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

18

final String MarketplaceId = "マーケットプレイス ID";

final String MerchantId = "出品者 ID";

Amazon MWS Java クライアントライブラリ内に含まれるサンプルを実行するには、サンプルコードの実行を参照してください。

C#

1. MarketplaceWebService.sln プロジェクトファイルを開きます。

2. MarketplaceWebServicesSample.cs ファイルを開きます。

3. 該当地域のエンドポイント部分のコメントを外し、MWS エンドポイントを設定します。

// United States:

// config.ServiceURL = "https://mws.amazonservices.com";

//

// United Kingdom:

// config.ServiceURL = "https://mws.amazonservices.co.uk";

//

// Japan:

// config.ServiceURL = "https://mws.amazonservices.jp";

//

// Germany:

// config.ServiceURL = "https://mws.amazonservices.de";

//

// France:

// config.ServiceURL = "https://mws.amazonservices.fr";

4. <Your AWS Access Key ID>を自分のアクセスキーID に、<Your AWS Secret Access Key>の部分を秘密キーにそれぞ

れ置き換えます 。

String accessKeyId = "<Your AWS Access Key>";

String secretAccessKey = "<Your AWS Secret Key>";

5. アプリケーションまたは会社名、およびバージョンを設定します。

const string applicationName = "<Your Application Name>";

const string applicationVersion = "<Your Application Version>";

6. マーケットプレイス ID と 出品者 ID を設定します。

const string merchantId = "<Your Merchant ID>";

Page 19: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

19

const string marketplaceId = "<Your Marketplace ID >";

Amazon MWS C# クライアントライブラリ内に含まれるサンプルコードを実行するには、サンプルコードの実行を参照してくださ

い。

PHP

1. サンプルディレクトリにある.config.inc.php ファイルを開きます。

2. 該当地域のエンドポイント部分のコメントを外し、MWS エンドポイントを設定します。

// United States:

//$serviceUrl = "https://mws.amazonservices.com";

// United Kingdom

//$serviceUrl = "https://mws.amazonservices.co.uk";

// Japan

//$serviceUrl = "https://mws.amazonservices.jp";

// Germany

//$serviceUrl = "https://mws.amazonservices.de";

// France

//$serviceUrl = "https://mws.amazonservices.fr";

7. <Your AWS Access Key ID>を自分のアクセスキーID に、<Your AWS Secret Access Key>の部分を秘密キーにそれぞ

れ置き換えます 。

define('AWS_ACCESS_KEY_ID', '<Your Access Key ID>');

define('AWS_SECRET_ACCESS_KEY', '<Your Secret Access Key>');

3. アプリケーションまたは会社名、およびバージョンを設定します。

define('APPLICATION_NAME', '<Your Application Name>');

define('APPLICATION_VERSION', '<Your Application Version or Build Number>');

4. マーケットプレイス ID と出品者 ID を設定します。

define ('MERCHANT_ID', '<Your Merchant ID>');

define ('MARKETPLACE_ID', '<Your Marketplace ID>');

Amazon MWS PHP クライアントライブラリ内に含まれるサンプルコードを実行するには、サンプルの実行を参照してください。

Page 20: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

20

サンプルコードの実行

MWS クライアントライブラリには、各サービスの API のコードサンプルが含まれています。これらのサンプルコードを実行するには、

アクセスキーを設定する必要があります。詳しくは、アクセスキー(アクセスキーID/秘密キー)の設定を参照してください。

Java

アクセスキーをサンプルコードに設定した後に、サンプルコードが実行できます。例えば、GetFeedSubmissionCountSample ファ

イルでは、次の手順に従います。

1. 以下の行のコメントを外します。

// invokeGetFeedSubmissionCount(service, request);

2. コンパイルして、サンプルコードを実行します。

以下の出力結果が表示されます。

GetFeedSubmissionCountResponse

GetFeedSubmissionCountResult

Count

72

ResponseMetadata

RequestId

a555ef03-d2c1-4f42-bae1-e82aee7488c6

C#

アクセスキーをサンプルコードに設定した後に、サンプルコードが実行できます。例えば、GetFeedSubmissionCountSample を実

行するには、以下の手順に従います。

1. 以下の 4 行のコメントを外します。

//GetFeedSubmissionCountRequest request = new GetFeedSubmissionCountRequest();

//request.Merchant = merchantId;

//request.Marketplace = marketplaceId;

// @TODO: set additional request parameters here

//GetFeedSubmissionCountSample.InvokeGetFeedSubmissionCount(service, request);

2. F5 キーを押してサンプルコードを実行します。

以下の出力結果が表示されます。

Page 21: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

21

GetFeedSubmissionCountResponse

GetFeedSubmissionCountResult

Count

72

ResponseMetadata

RequestId

a555ef03-d2c1-4f42-bae1-e82aee7488c6

PHP

アクセスキーを config.inc.php ファイルに設定した後に、サンプルが実行できます。例えば、GetFeedSubmissionCountSample

を実行するには、以下の手順に従います。

以下の 5 行のコメントを外します。

//$request = new MarketplaceWebService_Model_GetFeedSubmissionCountRequest();

//$request->setMerchant(MERCHANT_ID);

//$request->setMarketplace(MARKETPLACE_ID);

//object or array of parameters

//invokeGetFeedSubmissionCount($service, $request);

以下の出力結果が表示されます。

GetFeedSubmissionCountResponse

GetFeedSubmissionCountResult

Count

72

ResponseMetadata

RequestId

a555ef03-d2c1-4f42-bae1-e82aee7488c6

Page 22: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

22

補足事項

MWS アプリケーションの開発

MWS アクセスキー

MWS エンドポイント

Page 23: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

23

MWS アプリケーションの開発

Amazon MWS を使用して自身の出品用アカウント用のアプリケーションを開発する場合は、自分の出品者アカウントの Email アド

レスを MWS に登録してください。詳しくは、MWS への登録方法を参照してください。

MWS を使って、出品者のためにソフトウェアを開発する場合は、まず、大口出品の出品用アカウントで MWS に登録してください。

開発したサービスやアプリケーションを出品者が使用する際は、開発者アカウント ID を提供する必要があります。

MWS のサービスやアプリケーションを開発してテストする際には、出品用アカウントで MWS に開発者アカウント ID を登録する必

要があります。出品者アカウントで MWS のポータルサイトにログインし、開発者アカウント ID を登録します。その後、出品者

ID ・ マーケットプレイス ID をアプリケーションに設定することにより、MWS が利用できるようになります。

MWS を使用した出品者用のソフトウェアを販売する場合は、http://developer.amazonservices.com までご連絡ください。より

大規模なソリューションを開発できるようサポートいたします。

アプリケーションの開発にあたり、さらなるサポートが必要な場合は、Amazon MWS のその他の資料をご確認ください。詳しくは、

「関連資料」の項を参照してください。

注意

MWS のアプリケーション開発および認証手続きについて詳しくは、以下のサイトから「よくある質問」もご覧ください。

DE: http://developer.amazonservices.de

FR: http://developer.amazonservices.fr

JP: http://developer.amazonservices.jp

UK: http://developer.amazonservices.co.uk

US: http://developer.amazonservices.com

Page 24: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

24

MWS アクセスキー

MWS のポータルサイトで自分の Amazon 出品用アカウントを登録すると、MWS を使用する際に必要な開発者アカウント ID とアク

セスキー(アクセスキーID/秘密キー)が発行されます。もし開発したアプリケーションを他の出品者が使用する場合は、アプリケー

ションを利用する出品者は、MWS のポータルサイトでこの開発者アカウント ID を登録する必要があります。MWS への登録方法と

アクセスキーの取得に関する情報は、MWS への登録方法トピックを参照してください。

MWS 開発者アカウント ID は、以下のような形式となっております。

開発者アカウント ID(12 桁の数字列)

例:1234-3214-4321

MWS 開発者アクセスキーは、以下のような形式となっております。

アクセスキー ID (20 文字のアルファベットと数字からなる文字列)

例:022QF0EXAMPLEH9DHM02

秘密キー (40 文字の文字列)

例: kWcrlEXAMPLEM/LtmEENI/aVmYvHNif5zB+d9+ct

注意事項!!

出品者アカウントの責任者は、アカウントの秘密キーの取り扱いには十分に気をつけてください。MWS の送信リクエストに含

めたり、Email などでこの情報を他人に送らないでください。また、Amazon の関係者を装った者がこの情報に関して問い合

わせをしてくるかもしれませんが、決してこの情報を関係者以外の人と共有しないでください。Amazon がアカウントの秘密

キーについて問い合わせを行なうことはありません。

MWS に登録されているアクセスキーID をリクエストに含めることで、MWS リクエストの認証が行われます。

アクセスキーID は公開しても構いません。リクエストの送信者であることを証明するには、デジタル署名の同封が必要です。

Amazon MWS クライアントライブラリを使用して作成されたリクエスト以外のリクエストは、秘密キーを用いてデジタル署名を作

成します。MWS はリクエストに含まれるアクセスキーID をもとに秘密キーを探し出し、そのペアによりデジタル署名を作成します。

MWS の作成するデジタル署名と送信されてきたデジタル署名が一致する場合のみリクエストは許可されます。一致しない場合は認証

が失敗するため、リクエストは許可されません。

MWS アクセスキーと ID の確認方法

アクセスキーID、秘密キー、開発者アカウント ID は、MWS の登録時に表示されます。これらの情報は Email では通知されません。

ページを印刷するか、ファイルに保存しておいてください。これらの情報を再度表示する場合は、MWS の登録手続きを一通り繰り返

すことで表示され、登録手続きは何度でも行うことが可能です。開発者アカウント ID、アクセスキーは、出品者 ID・ マーケットプ

レイス ID と同様、登録手続きの最終ページに表示されます。

Page 25: Amazon マーケットプレイス Webサービス入門ガイド...Amazon マーケットプレイスWebサービ入門 ガイド (API Version 2009-01-01) 11 MWS への登録方法

Amazon マーケットプレイス Web サービ入門 ガイド (API Version 2009-01-01)

25

MWS エンドポイント一覧

Amazon マーケットプレイス

MWS エンドポイント MWS Web サイト

DE https://mws.amazonservices.de/ http://developer.amazonservices.de

FR https://mws.amazonservices.fr/ http://developer.amazonservices.fr

JP https://mws.amazonservices.jp/ http://developer.amazonservices.jp

UK https://mws.amazonservices.co.uk/ http://developer.amazonservices.co.uk

US https://mws.amazonservices.com/ http://developer.amazonservices.com