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 Properties auf Unternehmensebene, die mit der Integration von Partnern für lokale Feeds zusammenhängen
- Eine Methode zum Senden einer Benachrichtigung an einen Händler
Weitere Informationen zu diesen Methoden finden Sie unter 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 ist ein Beispiel für den Vergleich der Content API for Shopping mit der Partnership 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 Partner-API 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 API für das Partnerprogramm 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=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 bei den Sales API-Methoden in der API für Partner mit lokalen 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 Local Feeds Partnership API 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 hinzugefügt, um verschiedene Geschäfte zu unterscheiden |
| 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 Partnership API für lokale Feeds nicht unterstützt. |
Folgendes hat sich beim Einfügen von Inventar 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, 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 aktualisiert und 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 API für das Partnerprogramm für lokale Feeds nicht unterstützt. |
Folgendes hat sich beim 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 API für das Partnerprogramm für lokale Feeds nicht unterstützt. |