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 Unterkünften auf Händlerebene, die mit der Integration der lokalen Feeds in Verbindung stehen
- 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 | Händler-API | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert
|
IDs |
{merchantId}/pos/ {targetMerchantId}
|
{parent} |
Im Folgenden finden Sie einen Beispielvergleich der Content API for Shopping für die Anfrage zum Einfügen eines Angebots mit der Partnership API für lokale Feeds:
Content API | Händler-API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
IDs | {merchantId}/pos/ {targetMerchantId} |
{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 | Händler-API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpStores:insert |
IDs | {merchantId}/pos/ {targetMerchantId} |
{parent} |
Methoden
Folgendes hat sich für die Store API-Methoden in der Partnership 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/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores:insert |
/pos {merchantId}/{targetMerchantId} |
{parent} | parent hat das Format accounts/{lfpPartnerAccountId} . |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name hat das Format accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode}. |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{merchantId}/pos/ {targetMerchantId}/store/ {storeCode} |
{name} | name hat das Format accounts/ {lfpPartnerAccountId}/lfpStores/ {targetMerchantId}~{storeCode}. |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId}/pos/ {targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores |
/{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} hat das Format accounts/ {lfpPartnerAccountId}. |
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/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpInventories:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | parent hat das Format accounts/ {lfpPartnerAccountId}. |
Folgendes hat sich für die Sales API-Methoden in der Partnerschafts-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/ {merchantId}/pos/ {targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent}/lfpSales:insert |
{merchantId}/pos/ {targetMerchantId} |
{parent} | {parent} hat das Format accounts/ {lfpPartnerAccountId} |
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 | Händler-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 enthalten sind, bleiben unverändert.
Content API for Shopping | Händler-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 |
Die Beschreibung von quantity wurde durch den Hinweis aktualisiert, dass diese Datei 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 Partnership API für lokale 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 | Händler-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. |