Mit der Merchant API können Sie Ihre Inventare, Geschäfte und Verkaufsdaten mit Google teilen, um die Sichtbarkeit zu erhöhen und die 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 Eigenschaften auf Unternehmensebene im Zusammenhang mit der Partnerintegration für lokale Feeds
- Eine Methode zum Senden einer Benachrichtigung an einen Händler
Weitere Informationen zu diesen Methoden finden Sie unter Local feeds partnership API.
Anfragen
Verwenden Sie das folgende URL-Format für Anfragen an 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 Vergleich zwischen der Content API for Shopping und 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 sehen Sie einen Vergleich zwischen der Content API for Shopping und der Local feeds partnership API für die Anfrage zum Einfügen eines Verkaufs:
| 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 Vergleich zwischen der Content API for Shopping und 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 für die API-Methoden für Geschäfte 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/v1/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{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 für die API-Methoden für Inventare 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/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 API-Methoden für Verkäufe 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/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 Ressource „Geschäft“ in der Local feeds partnership API 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 hinzugefügt, um verschiedene Geschäfte zu unterscheiden |
| 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 |
websiteUrl: string |
websiteUri: string |
websiteUrl wurde in websiteUri umbenannt |
kind: string |
Nicht unterstützt | kind wird in der Local feeds partnership API nicht unterstützt |
Folgendes hat sich für das Einfügen eines Inventars 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 hinzugefügt, um verschiedene Inventare zu unterscheiden |
| 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 Local feeds partnership API nicht unterstützt. |
Folgendes hat sich für das Einfügen eines Verkaufs 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 hinzugefügt, um verschiedene Inventare zu unterscheiden |
| 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 Local feeds partnership API nicht unterstützt. |