Design dell'API Merchant

Abbiamo progettato l'API Merchant in modo che sia familiare agli sviluppatori dell'API Content for Shopping, ma più semplice e flessibile. Ecco alcune informazioni dettagliate sulla progettazione dell'API Merchant.

API secondarie

L'API Merchant è una raccolta di API secondarie. Le API secondarie sono gruppi di servizi e risorse correlati. Questo design ti consente di scegliere di utilizzare solo le sub-API necessarie per la tua integrazione unica.

L'API Merchant include le seguenti API secondarie:

  • Account: gestisci gli account Merchant Center su larga scala.
  • Prodotti: gestisci i dati di prodotto, come prezzo e disponibilità.
  • Origini dati: visualizza e gestisci le origini dati per i tuoi prodotti.
  • Inventari: mostra i tuoi prodotti per negozio o regione su Google.
  • Report: visualizza i dati su prodotti, rendimento e panorama competitivo su Google.
  • Promozioni: crea e gestisci le promozioni per mettere in evidenza le offerte speciali per i tuoi prodotti.
  • Partnership con i feed locali: carica il feed di inventario locale dei prodotti.
  • Origini conversione: gestisci le origini conversione per il tuo account.
  • Notifiche: gestisci gli abbonamenti alle notifiche.
  • Quota: controlla la quota API dei tuoi account.

Trasporto

Il meccanismo di trasporto predefinito dell'API Merchant è gRPC. Puoi anche utilizzare REST.

Per ulteriori informazioni, consulta la guida rapida.

Enum

I campi enum nell'API Merchant potrebbero mostrare nuovi valori in futuro. Il codice deve essere strutturato in modo da gestire correttamente i valori non riconosciuti. Devi monitorare la presenza di valori enum non riconosciuti e intervenire per mantenere aggiornato il codice.

Controllo delle versioni

Le API secondarie sono versionate separatamente. Ciò significa che non devi fare nulla se aggiorniamo una sotto-API che non utilizzi. Devi aggiornare il codice solo quando vengono rilasciate nuove versioni delle API secondarie che utilizzi. Per ulteriori informazioni, vedi Controllo delle versioni.

Le versioni che terminano con "beta" sono soggette a modifiche o rimozione.