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.
Sub-API
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 specifica.
L'API Merchant include le seguenti API secondarie:
- Accounts: gestisci gli account Merchant Center su larga scala.
- Conversioni: gestisci le origini conversione per il tuo account.
- Origini dati: visualizza e gestisci le origini dati dei tuoi prodotti.
- Risoluzione dei problemi: ottieni i problemi che interessano il tuo account e crea una pagina di diagnostica in-app.
- Inventari: mostra i tuoi prodotti per negozio o regione su Google.
- Partnership per i feed locali: carica il feed di inventario locale dei prodotti.
- Notifiche: gestisci le iscrizioni alle notifiche.
- Monitoraggio degli ordini: fornisci i dati storici di monitoraggio degli ordini per migliorare le stime di spedizione e ottimizzare le schede con annotazioni sulla spedizione.
- Prodotti: gestisci i dati di prodotto, come prezzo e disponibilità.
- Product Studio: utilizza Google Product Studio per generare automaticamente immagini dei prodotti e suggerimenti di testo.
- Promozioni: crea e gestisci le promozioni per mostrare offerte speciali per i tuoi prodotti.
- Quota: controlla la quota API dei tuoi account.
- Report: visualizza i dati relativi ai tuoi prodotti, al rendimento e al panorama competitivo su Google.
- Recensioni: gestisci le recensioni dei prodotti e dei venditori.
Trasporto
Il meccanismo di trasporto predefinito dell'API Merchant è gRPC. Puoi anche utilizzare REST.
Per saperne di più, 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 poter gestire correttamente i valori non riconosciuti. Devi monitorare l'occorrenza di valori enum non riconosciuti e intervenire per mantenere aggiornato il codice.
Controllo delle versioni
Le API secondarie hanno versioni separate. Ciò significa che non devi fare nulla se aggiorniamo una sub-API che non utilizzi. Devi aggiornare il codice solo quando vengono rilasciate nuove versioni delle API secondarie che utilizzi. Per saperne di più, consulta Controllo delle versioni.