Esegui la migrazione della partnership per i feed locali

Puoi utilizzare l'API Merchant per condividere i dati di inventari, negozi e vendite con Google 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 attività correlate 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 Local Feeds Partnership.

Richieste

Utilizza il seguente formato dell'URL della richiesta per l'API Local Feeds Partnership:

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

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

Ecco 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 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/v1/{PARENT}/lfpInventories:insert
Identificatori	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Ecco un confronto di esempio tra l'API Content for Shopping e l'API per la partnership con 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/v1/{PARENT}/lfpSales:insert
Identificatori	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Ecco un confronto di esempio tra l'API Content for Shopping e l'API di partnership dei 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/v1/{PARENT}/lfpStores:insert
Identificatori	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}

Metodi

Ecco cosa è cambiato per i metodi dell'API Store 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/v1/{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/v1/{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/v1/{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/v1/{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 Inventory 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/v1/{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 Local Feeds 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/v1/{PARENT}/lfpSales:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	{PARENT} è nel formato accounts/{IFP_PARTNER_ACCOUNT_ID}

Risorse

Ecco cosa è cambiato per la risorsa Store nell'API 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 Merchant Center in 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 per il programma 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	Aggiunto un nuovo campo per differenziare i diversi inventari
Non supportata	targetAccount: integer	L'account Merchant Center in 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 per essere facoltativo
Non supportata	availability: string	È obbligatorio specificare il campo availability
price: { object (Price) }	price: { object (Price) }	La definizione di prezzo è cambiata. Per ulteriori informazioni, vedi 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 vendita. I campi non inclusi qui rimangono invariati.

API Content per Shopping	API Merchant	Descrizione
Non supportata	name: string	Aggiunto un nuovo campo per differenziare i diversi inventari
Non supportata	targetAccount:integer	L'account Merchant Center in 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 di prezzo è cambiata. Per ulteriori informazioni, vedi Prezzo.
timestamp: string	saleTime: string	timestamp è stato rinominato in saleTime
kind: string	Non supportata	kind non è supportato nell'API Partnership per i feed locali.