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 formatoaccounts/{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 formatoaccounts/{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 formatoaccounts/{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 formatoaccounts/{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 formatoaccounts/{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 formatoaccounts/{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 inregionCode | 
| websiteUrl: string | websiteUri: string | websiteUrlè stato rinominato inwebsiteUri | 
| kind: string | Non supportata | kindnon è 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 inregionCode. Il codice territorio CLDR per il paese in cui viene venduto il prodotto. | 
| itemId: string | offerId: string | itemIdè stato rinominato inofferId | 
| quantity: string | quantity: string | quantityè stato aggiornato per essere facoltativo | 
| Non supportata | availability: string | È obbligatorio specificare il campo availability | 
| 
 | 
 | La definizione di prezzo è cambiata. Per ulteriori informazioni, vedi Prezzo. | 
| timestamp: string | collectionTime: string | timestampè stato rinominato incollectionTime | 
| kind: string | Non supportata | kindnon è 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 inofferId | 
|  | 
 | La definizione di prezzo è cambiata. Per ulteriori informazioni, vedi Prezzo. | 
| timestamp: string | saleTime: string | timestampè stato rinominato insaleTime | 
| kind: string | Non supportata | kindnon è supportato nell'API Partnership per i feed locali. |