Anwendungsfallleitfaden für Sellers API v1
Rufen Sie Informationen zum Verkäuferkonto und zur Marketplace-Site ab.
API-Version: v1
Was ist die Verkäufer-API?
The Selling Partner API for Sellers (Sellers API) provides information about seller accounts and marketplaces. The returned information includes:
- Die Marktplätze, auf denen der Verkäufer Artikel anbieten kann
- Die Standardsprache und Währung einer Marketplace-Site
- Ob der Verkäufer Angebote ausgesetzt hat
- Geschäftsinformationen des Verkäufers
For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.
Tutorial: Holen Sie sich die Kontoinformationen eines Verkäufers (nur EU)
Erfahren Sie, wie Sie die Kontoinformationen eines Verkäufers abrufen. Zu den Informationen, die Sie abrufen, gehören eine Liste der Marktteilnahmen, Geschäftsinformationen und Details zum Verkaufstarif. Dies ist nur in der EU-Region verfügbar.
Voraussetzungen
Um dieses Tutorial abzuschließen, müssen Sie die folgenden Voraussetzungen erfüllen:
- 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.
Kontoinformationen abrufen
Call the getAccount
operation.
Parameter anfordern
Keine.
Beispiel anfordern
GET /sellers/v1/account
Antworteigenschaften
Eine erfolgreiche Antwort umfasst die folgenden Eigenschaften:
Name | Beschreibung | Schema |
---|---|---|
business | Informationen über das Geschäft des Verkäufers. Abhängig vom Verkäufer businessType , Sie können bestimmte Felder weglassen. | Business |
businessType | Die Art des Unternehmens, für das das Verkäuferkonto registriert ist. | enum (BusinessType ) |
marketplaceParticipationList | Eine Liste der Marktteilnahmen. | < MarketplaceParticipationList > array |
primaryContact | Informationen über den Hauptansprechpartner des Verkäufers. | PrimaryContact |
sellingPlan | Einzelheiten zum Verkaufstarif. | enum (SellingPlan ) |
Beispiel für eine Antwort
{
"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"
}
}
}
Tutorial: Ermitteln Sie die Marktbeteiligung eines Verkäufers
Erfahren Sie, wie Sie eine Liste der Amazon-Marktplätze erhalten, auf denen der Verkäufer Artikel anbieten kann. Zu den Informationen, die Sie abrufen, gehören Marktplatzinformationen, der Name des Verkäufers auf der Marketplace-Site, ob der Verkäufer an der Marketplace-Site teilnimmt und ob der Verkäufer Angebote auf der Marketplace-Site ausgesetzt hat.
Voraussetzungen
Um dieses Tutorial abzuschließen, müssen Sie die folgenden Voraussetzungen erfüllen:
- 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.
Holen Sie sich Marktteilnahme
Call the getMarketplaceParticipations
operation.
Parameter anfordern
Keine.
Beispiel anfordern
GET /sellers/v1/marketplaceParticipations
Antwort
Eine erfolgreiche Antwort umfasst die folgenden Elemente:
Name | Beschreibung | Schema |
---|---|---|
marketplaceParticipationList | Eine Liste der Amazon-Marktplätze, auf denen der Verkäufer Artikel anbieten kann und Kunden Artikel ansehen und kaufen können. | < MarketplaceParticipationList > array |
Beispiel für eine Antwort
[
{
"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