Über die Merchant API können Sie Ihre Inventar-, Geschäfts- und Verkaufsdaten mit Google teilen, um die Sichtbarkeit und Verwaltung zu verbessern.
Neue Funktionen
Zusätzlich zu den Funktionen der Content API bietet die Merchant API die folgenden neuen Funktionen:
- Eine Methode zum Abrufen des Status von Properties auf Unternehmensebene im Zusammenhang mit der Integration der Partnerschaft für lokale Feeds
- Eine Methode zum Senden einer Benachrichtigung an einen Einzelhändler
Weitere Informationen zu diesen Methoden finden Sie unter Local Feeds Partnership API.
Anfragen
Verwenden Sie für die Local Feeds Partnership API das folgende Anfrage-URL-Format:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Weitere Informationen finden Sie unter Methode: accounts.lfpInventories.insert.
Hier ist ein Beispiel für einen Vergleich der Content API for Shopping mit der Local Feeds Partnership API für die Anfrage zum Einfügen eines Inventars:
| Content API | Merchant API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| IDs |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
Hier ist ein Beispiel für einen Vergleich der Content API for Shopping mit der Partnership API für lokale Feeds für die Anfrage zum Einfügen eines Angebots:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| IDs | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Hier ist ein Beispiel für einen Vergleich der Content API for Shopping mit der Local Feeds Partnership API für die Anfrage zum Einfügen eines Geschäfts:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| IDs | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Methoden
Folgendes hat sich bei den Store API-Methoden in der Local Feeds Partnership API geändert:
| Methode | URL in der Content API for Shopping | URL in der Merchant API | Kennzeichnungen in der Content API for Shopping | Kennzeichnungen in der Merchant API | Beschreibung |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
/pos {MERCHANT_ID}/{TARGETMERCHANT_ID} |
{PARENT} | parent hat das Format accounts/{IFP_PARTNER_ACCOUNT_ID}. |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name hat das Format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}. |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name hat das Format accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}. |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} hat das Format accounts/{IFP_PARTNER_ACCOUNT_ID}. |
Folgendes hat sich bei den Inventar-API-Methoden in der Partner-API für lokale Feeds geändert:
| Methode | URL in der Content API for Shopping | URL in der Merchant API | Kennzeichnungen in der Content API for Shopping | Kennzeichnungen in der Merchant API | Beschreibung |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent hat das Format accounts/{IFP_PARTNER_ACCOUNT_ID}. |
Folgendes hat sich bei den Sales API-Methoden in der Local Feeds Partnership API geändert:
| Methode | URL in der Content API for Shopping | URL in der Merchant API | Kennzeichnungen in der Content API for Shopping | Kennzeichnungen in der Merchant API | Beschreibung |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} hat das Format accounts/{IFP_PARTNER_ACCOUNT_ID}. |
Ressourcen
Folgendes hat sich für die Geschäftsressource in der API für das Partnerprogramm für lokale Feeds geändert. Felder, die hier nicht enthalten sind, bleiben unverändert.
| Content API for Shopping | Merchant API | Beschreibung |
| Nicht unterstützt | name: string |
Neues Feld zur Unterscheidung verschiedener Geschäfte hinzugefügt |
| Nicht unterstützt | targetAccount: integer |
Das Merchant Center-Konto, für das Inventare eingefügt werden sollen |
targetCountry: string |
regionCode: string |
„targetCountry“ wurde in „regionCode“ umbenannt |
websiteUrl: string |
websiteUri: string |
„websiteUrl“ wurde in „websiteUri“ umbenannt |
kind: string |
Nicht unterstützt | kind wird in der API für lokale Feeds nicht unterstützt |
Folgendes hat sich beim Einfügen von Inventar geändert: Felder, die hier nicht enthalten sind, bleiben unverändert.
| Content API for Shopping | Merchant API | Beschreibung |
| Nicht unterstützt | name: string |
Neues Feld zur Unterscheidung verschiedener Inventare hinzugefügt |
| Nicht unterstützt | targetAccount: integer |
Das Merchant Center-Konto, für das Inventare eingefügt werden sollen. |
targetCountry: string |
regionCode: string |
„targetCountry“ wurde in „regionCode“ umbenannt. Der CLDR-Regionalcode für das Land, in dem das Produkt verkauft wird. |
itemId: string |
offerId: string |
„itemId“ wurde in „offerId“ umbenannt |
quantity: string |
quantity: string |
quantity wurde aktualisiert und ist jetzt optional. |
| Nicht unterstützt | availability: string |
availability ist erforderlich |
|
|
Die Preisdefinition hat sich geändert. Weitere Informationen finden Sie unter Preis. |
timestamp: string |
collectionTime: string |
„timestamp“ wurde in „collectionTime“ umbenannt |
kind: string |
Nicht unterstützt | kind wird in der API für das Partnerprogramm für lokale Feeds nicht unterstützt. |
Folgendes hat sich beim Einfügen eines Verkaufs geändert. Felder, die hier nicht enthalten sind, bleiben unverändert.
| Content API for Shopping | Merchant API | Beschreibung |
| Nicht unterstützt | name: string |
Neues Feld zur Unterscheidung verschiedener Inventare hinzugefügt |
| Nicht unterstützt | targetAccount:integer |
Das Merchant Center-Konto, für das Verkäufe eingefügt werden sollen |
targetCountry: string |
regionCode: string |
Der CLDR-Regionalcode für das Land, in dem das Produkt verkauft wird. |
itemId: string |
offerId: string |
„itemId“ wurde in „offerId“ umbenannt |
|
|
Die Preisdefinition hat sich geändert. Weitere Informationen finden Sie unter Preis. |
timestamp: string |
saleTime: string |
„timestamp“ wurde in „saleTime“ umbenannt |
kind: string |
Nicht unterstützt | kind wird in der API für das Partnerprogramm für lokale Feeds nicht unterstützt. |