出品者API v1ユースケースガイド

出品者アカウントとマーケットプレイス情報を取得します。

API バージョン:V1

セラーズAPIとは何ですか?

The Selling Partner API for Sellers (Sellers API) provides information about seller accounts and marketplaces. The returned information includes:

  • 出品者が商品を出品できるマーケットプレイス
  • マーケットプレイスのデフォルトの言語と通貨
  • 出品者が出品を停止しているかどうか
  • 販売者のビジネス情報

For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.

チュートリアル:販売者のアカウント情報を取得する (EU のみ)

出品者のアカウント情報を取得する方法をご覧ください。取得する情報には、マーケットプレイスへの参加、ビジネス情報、販売プランの詳細などが含まれます。これはEU地域でのみ利用可能です。

前提条件

このチュートリアルを完了するには、次の前提条件を満たす必要があります。

アカウント情報を取得

Call the getAccount operation.

リクエストパラメータ

[なし]。

リクエストの例

GET /sellers/v1/account

レスポンスプロパティ

成功レスポンスには、以下のプロパティが含まれます。

名前説明Schema
business販売者の事業に関する情報。出品者によって異なります。 businessType、特定のフィールドを省略できます。Business
businessType出品用アカウントが登録されている業種。enum (BusinessType)
marketplaceParticipationListマーケットプレイス参加のリスト。< MarketplaceParticipationList> array
primaryContact販売者の主な連絡先に関する情報。PrimaryContact
sellingPlan販売プランの詳細。enum (SellingPlan)

レスポンスの例

{ "businessType": "PRIVATE_LIMITED", "marketplaceParticipationList": [ { "marketplace": { "id": "ATVPDKIKX0DER", "name": "United States", "countryCode": "US", "domainName": "www.amazon.com" }, "storeName": "BestSellerStore", "participation": { "isParticipating": true, "hasSuspendedListings": false } } ], "sellingPlan": "PROFESSIONAL", "business": { "name": "BestSeller Inc.", "nonLatinName": "ベストセラー株式会社", "registeredBusinessAddress": { "addressLine1": "123 Main St", "addressLine2": "Suite 500", "city": "Seattle", "stateOrProvinceCode": "WA", "postalCode": "98101", "countryCode": "US" }, "companyRegistrationNumber": "123456789", "companyTaxIdentificationNumber": "987654321" }, "primaryContact": { "name": "John Doe", "nonLatinName": "ジョン・ドゥ", "address": { "addressLine1": "456 Oak St", "addressLine2": "Apt 12", "city": "Seattle", "stateOrProvinceCode": "WA", "postalCode": "98102", "countryCode": "US" } } }

チュートリアル:売り手の市場参加を得る

出品者が商品を出品できるAmazonマーケットプレイスのリストを取得する方法をご覧ください。取得する情報には、マーケットプレイス情報、マーケットプレイス内の出品者の店舗名、出品者がマーケットプレイスに参加しているかどうか、出品者がマーケットプレイスでの出品を停止しているかどうかなどが含まれます。

前提条件

このチュートリアルを完了するには、次の前提条件を満たす必要があります。

マーケットプレイスへの参加を取得

Call the getMarketplaceParticipations operation.

リクエストパラメータ

[なし]。

リクエストの例

GET /sellers/v1/marketplaceParticipations

レスポンス

成功レスポンスには、以下の要素が含まれます。

名前説明Schema
marketplaceParticipationList出品者が商品を出品し、購入者が商品を閲覧して購入できるAmazonマーケットプレイスのリスト。< MarketplaceParticipationList> array

レスポンスの例

[ { "marketplace": { "id": "ATVPDKIKX0DER", "name": "Amazon.com", "countryCode": "US", "defaultCurrencyCode": "USD", "defaultLanguageCode": "en_US", "domainName": "www.amazon.com" }, "storeName": "BestSellerStore", "participation": { "isParticipating": true, "hasSuspendedListings": false } } ]

このページは役に立ちましたか?