Auf dieser Seite wird beschrieben, wie Sie ein Merchant Center-Konto erstellen und ein Beispielprodukt mithilfe der Merchant API hochladen.
Hinweis
Aktivieren Sie die Merchant API in Ihrem Google Cloud-Projekt.
Konto erstellen
Wenn Sie die Merchant API verwenden möchten, benötigen Sie ein Merchant Center-Konto. Informationen zum Erstellen eines Merchant Center-Kontos finden Sie unter Einstieg in das Merchant Center.
Konto-ID abrufen
Sie können die Konto-ID mit der Methode accounts.list abrufen.
Sie können den Google APIs Explorer verwenden, um Merchant API-Anfragen auszuführen. Für die Authentifizierung wird im APIs Explorer Google OAuth 2.0 verwendet. Achten Sie vor dem Ausführen der Anfragen darauf, dass das Kästchen Google OAuth 2.0 angeklickt ist.
Wenn Sie sich mit OAuth 2.0 authentifizieren möchten, müssen Sie sich zuerst in Ihrem Google-Konto und dann in APIs Explorer anmelden. Außerdem müssen Sie APIs Explorer erlauben, Ihre Produkteinträge und Konten zu verwalten.
In der folgenden Anfrage wird gezeigt, wie Sie Ihre Konto-ID abrufen:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
Nach der erfolgreichen Ausführung der Anfrage wird die folgende Antwort angezeigt:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Kopieren Sie die {ACCOUNT_ID}, da Sie sie zum Ausführen anderer Anfragen benötigen.
Primäre Datenquelle für Produkte erstellen
Zum Einfügen eines Produkts benötigen Sie eine primäre Produktdatenquelle. In der folgenden Anfrage wird gezeigt, wie Sie eine Datenquelle erstellen, mit der Sie ein Produkt in Ihr Konto einfügen können:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
Ersetzen Sie {ACCOUNT_ID} durch die ID des von Ihnen erstellten Merchant Center-Kontos.
Nach der erfolgreichen Ausführung dieser Anfrage wird die folgende Antwort angezeigt:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
Kopieren Sie den Wert des Felds name, da Sie ihn zum Einfügen eines Produkts benötigen.
Es dauert einige Minuten, bis die erstellte Datenquelle zum Einfügen von Produkten verfügbar ist.
Sie können diese Datenquelle in der Merchant Center-Benutzeroberfläche aufrufen. Weitere Informationen finden Sie unter Tab „Datenquellen“ aufrufen.
Produkt einfügen
Führen Sie die folgende Anfrage aus, um ein Beispielprodukt in Ihr Konto einzufügen:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
Ersetzen Sie {DATASOURCE_NAME} durch den Wert, den Sie zuvor kopiert haben.
Nach der erfolgreichen Ausführung dieser Anfrage wird die folgende Antwort angezeigt:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
Die Produkt-ID des neu erstellten Produkts lautet online~en~US~tshirt-123. Mit der Methode accounts.products.get können Sie Details zu diesem Produkt abrufen. Sie können sich dieses Produkt auch über die Merchant Center-Benutzeroberfläche ansehen.