出品者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地域でのみ利用可能です。
前提条件
このチュートリアルを完了するには、次の前提条件を満たす必要があります。
- The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
- Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
- The app registration page for your application must include the Finance and Accounting role.
アカウント情報を取得
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マーケットプレイスのリストを取得する方法をご覧ください。取得する情報には、マーケットプレイス情報、マーケットプレイス内の出品者の店舗名、出品者がマーケットプレイスに参加しているかどうか、出品者がマーケットプレイスでの出品を停止しているかどうかなどが含まれます。
前提条件
このチュートリアルを完了するには、次の前提条件を満たす必要があります。
- The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
- Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
- The app registration page for your application must include the Finance and Accounting role.
- The marketplace identifier of the marketplace for which you want data. For a list of marketplace identifiers, refer to Marketplace IDs.
マーケットプレイスへの参加を取得
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
}
}
]
Updated about 2 months ago