Mit der 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 Unternehmensattributen, die mit der Integration des Partnership-Programms für lokale Feeds zusammenhängen
- Methode zum Senden einer Benachrichtigung an einen Einzelhändler
Weitere Informationen zu diesen Methoden finden Sie in der API für das Partnerprogramm für lokale Feeds.
Anfragen
Verwenden Sie das folgende Anfrage-URL-Format für die Local Feeds Partnership API:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Weitere Informationen finden Sie unter Methode: accounts.lfpInventories.insert.
Hier sehen Sie einen Beispielvergleich der Content API for Shopping mit der Partner-API für lokale Feeds 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 sehen Sie einen Beispielvergleich der Content API for Shopping mit der Partner-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 sehen Sie einen Beispielvergleich der Content API for Shopping mit der API für Partner für lokale Feeds 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 für die Sales API-Methoden in der 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}/lfpSales:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} hat das Format accounts/ {IFP_PARTNER_ACCOUNT_ID}. |
Ressourcen
Folgendes hat sich für die Store-Ressource in der Partner-API 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 Partner-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, in 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 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 Partner-API 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, in 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 Partner-API für lokale Feeds nicht unterstützt. |