Mit der Merchant API können Sie Ihre Inventar-, Geschäfts- und Verkaufsdaten für eine bessere Sichtbarkeit und Verwaltung mit Google teilen.
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 Händlerebene im Zusammenhang mit der Integration von lokalen Feeds
- Eine 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 für die API für lokale Feedpartnerschaften das folgende Anfrage-URL-Format:
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Weitere Informationen finden Sie unter Methode: accounts.lfpInventories.insert.
Hier sehen Sie ein Beispiel für einen Vergleich der Content API for Shopping mit der API für die Partnerschaft mit lokalen Feeds für die Anfrage zum Einfügen von Inventar:
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/v1beta/ {PARENT}/lfpInventories:insert
|
IDs |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}
|
{PARENT} |
Hier sehen Sie einen Beispielvergleich der Content API for Shopping mit der API für die Partnerschaft mit lokalen 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/v1beta/ {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 die Partnerschaft mit lokalen 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/v1beta/ {PARENT}/lfpStores:insert |
IDs | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
Methoden
Folgendes hat sich bei den Store 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 | IDs in der Content API for Shopping | IDs 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/v1beta/ {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/v1beta/ {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/v1beta/ {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/v1beta/ {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 | IDs in der Content API for Shopping | IDs 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/v1beta/ {PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | parent hat das Format accounts/ {IFP_PARTNER_ACCOUNT_ID}. |
Folgendes hat sich für die Methoden der Sales API in der Local Feeds Partnership API geändert:
Methode | URL in der Content API for Shopping | URL in der Merchant API | IDs in der Content API for Shopping | IDs 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/v1beta/ {PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} hat das Format accounts/ {IFP_PARTNER_ACCOUNT_ID}. |
Ressourcen
Hier sind die Änderungen an der Store-Ressource in der API für das Partnerprogramm für lokale Feeds. Felder, die hier nicht aufgeführt sind, bleiben unverändert.
Content API for Shopping | Merchant API | Beschreibung |
Nicht unterstützt | name: string |
Neues Feld hinzugefügt, um verschiedene Geschäfte zu unterscheiden |
Nicht unterstützt | targetAccount: integer |
Das Händlerkonto, 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 die Partnerschaft mit lokalen Feeds nicht unterstützt. |
Das Einfügen von Inventar hat sich geändert. Felder, die hier nicht aufgeführt 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 Händlerkonto, 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 mit dem Hinweis aktualisiert, dass es optional ist. |
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 die Partnerschaft mit lokalen Feeds nicht unterstützt. |
Das Einfügen von Verkäufen hat sich geändert. Felder, die hier nicht aufgeführt 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 Händlerkonto, 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 die Partnerschaft mit lokalen Feeds nicht unterstützt. |