Esegui la migrazione della partnership per i feed locali

Puoi utilizzare l'API Merchant per condividere con Google i dati su inventari, 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 Partnership per i feed locali:

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

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

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 inventario:

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

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

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

Di seguito è riportato un confronto di esempio 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert
Identificatori	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Metodi

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

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	parent è nel formato 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/v1beta/{name=accounts/*/lfpStores/*}	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE}	{NAME}	name è nel formato 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/v1beta/{name=accounts/*/lfpStores/*}	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE}	{NAME}	name è nel formato 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/v1beta/{parent=accounts/*}/lfpStores	/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	{PARENT} è nel formato accounts/{IFP_PARTNER_ACCOUNT_ID}

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	parent è nel formato accounts/{IFP_PARTNER_ACCOUNT_ID}

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	{PARENT} è nel formato accounts/{IFP_PARTNER_ACCOUNT_ID}

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	kind non è supportato 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	Il valore quantity è stato aggiornato in modo da essere 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	kind non è supportato nell'API 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.