Esegui la migrazione della partnership per i feed locali

Puoi utilizzare l'API Merchant per condividere con Google i dati di inventario, negozi e vendite per una migliore visibilità e gestione.

Nuove funzionalità

Oltre alle funzionalità dell'API Content, l'API Merchant offre le seguenti nuove funzionalità:

• Un metodo per recuperare lo stato delle proprietà a livello di commerciante relative all'integrazione del programma di partnership per i feed locali
• Un metodo per inviare una notifica a un rivenditore

Per informazioni dettagliate su questi metodi, consulta l'API per i partner per i feed locali.

Richieste

Utilizza il seguente formato dell'URL di richiesta per l'API di partnership per i feed locali:

POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert

Per ulteriori informazioni, consulta Metodo: accounts.lfpInventories.insert.

Di seguito è riportato un esempio di confronto tra l'API Content for Shopping e l'API di partnership per i feed locali per la richiesta di inserimento di un inventario:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
Identificatori	{merchantId}/pos/{targetMerchantId}	{parent}

Ecco un esempio di confronto tra l'API Content for Shopping e l'API di partnership per i feed locali per la richiesta di inserimento di una vendita:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert
Identificatori	{merchantId}/pos/{targetMerchantId}	{parent}

Ecco un esempio di confronto tra l'API Content for Shopping e l'API di partnership per i feed locali per la richiesta di inserimento di un negozio:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert
Identificatori	{merchantId}/pos/{targetMerchantId}	{parent}

Metodi

Ecco cosa è cambiato per i metodi dell'API Store nell'API per i feed locali:

Metodo	URL nell'API Content for Shopping	URL nell'API Merchant	Identificatori nell'API Content for Shopping	Identificatori nell'API Merchant	Descrizione
insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert	{merchantId}/pos/{targetMerchantId}	{parent}	parent è nel formato 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 è nel formato 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 è nel formato 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} è nel formato accounts/{lfpPartnerAccountId}

Ecco cosa è cambiato per i metodi dell'API di inventario nell'API per i feed locali:

Metodo	URL nell'API Content for Shopping	URL nell'API Merchant	Identificatori nell'API Content for Shopping	Identificatori nell'API Merchant	Descrizione
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 è nel formato accounts/{lfpPartnerAccountId}

Ecco cosa è cambiato per i metodi dell'API Sales nell'API Partnership per i feed locali:

Metodo	URL nell'API Content for Shopping	URL nell'API Merchant	Identificatori nell'API Content for Shopping	Identificatori nell'API Merchant	Descrizione
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} è nel formato accounts/{lfpPartnerAccountId}

Risorse

Ecco cosa è cambiato per la risorsa negozio nell'API per le partnership per i feed locali. I campi non inclusi qui rimangono invariati.

API Content per Shopping	API Merchant	Descrizione
Non supportata	name: string	È stato aggiunto un nuovo campo per distinguere i diversi negozi
Non supportata	targetAccount: integer	L'account commerciante per cui inserire gli inventari
targetCountry: string	regionCode: string	targetCountry è stato rinominato in regionCode
websiteUrl: string	websiteUri: string	websiteUrl è stato rinominato in websiteUri
kind: string	Non supportata	L'API kind non è supportata nell'API di partnership per i feed locali

Ecco cosa è cambiato per l'inserimento di un inventario. I campi non inclusi qui rimangono invariati.

API Content per Shopping	API Merchant	Descrizione
Non supportata	name: string	È stato aggiunto un nuovo campo per distinguere i diversi inventari
Non supportata	targetAccount: integer	L'account commerciante per cui inserire gli inventari.
targetCountry: string	regionCode: string	targetCountry è stato rinominato in regionCode. Il codice territorio CLDR per il paese in cui viene venduto il prodotto.
itemId: string	offerId: string	itemId è stato rinominato in offerId
quantity: string	quantity: string	quantity è stato aggiornato e ora è facoltativo
Non supportata	availability: string	È obbligatorio specificare il campo availability
price: { object (Price) }	price: { object (Price) }	La definizione del prezzo è cambiata. Per ulteriori informazioni, consulta Prezzo.
timestamp: string	collectionTime: string	timestamp è stato rinominato in collectionTime
kind: string	Non supportata	L'API kind non è supportata nell'API di partnership per i feed locali.

Ecco cosa è cambiato per l'inserimento di una svendita. I campi non inclusi qui rimangono invariati.

API Content per Shopping	API Merchant	Descrizione
Non supportata	name: string	È stato aggiunto un nuovo campo per distinguere i diversi inventari
Non supportata	targetAccount:integer	L'account commerciante per cui inserire le vendite
targetCountry: string	regionCode: string	Il codice territorio CLDR per il paese in cui viene venduto il prodotto.
itemId: string	offerId: string	itemId è stato rinominato in offerId
price: { object (Price) }	price: { object (Price) }	La definizione del prezzo è cambiata. Per ulteriori informazioni, consulta Prezzo.
timestamp: string	saleTime: string	timestamp è stato rinominato in saleTime
kind: string	Non supportata	kind non è supportato nell'API Partnership per i feed locali.