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. |