Avvia la migrazione

In questa pagina forniamo indicazioni sulla pianificazione della migrazione dell'API.

Poi esaminiamo i passaggi necessari per la migrazione.

Pianifica la migrazione

1. Mappa i metodi dell'API Content for Shopping ai metodi dell'API Merchant.

   È molto utile comprendere chiaramente i nuovi metodi e le nuove risorse necessari per l'API Merchant.

2. Comprendi le modifiche più significative che si applicano alla migrazione.

   Ti consigliamo di esaminare e tenere presenti le seguenti risorse, in quanto ti saranno utili per la migrazione:

   • Panoramica della migrazione dall'API Content: descrive in dettaglio le principali modifiche di cui devi essere a conoscenza nell'API Merchant.
   • Guide alla migrazione specifiche per le sub-API: esamina le guide alla migrazione specifiche per le sub-API di cui hai bisogno, in quanto forniscono informazioni fondamentali come le nuove mappature dei campi. Per un esempio, vedi Eseguire la migrazione della gestione dei prodotti.
   • Il riferimento dell'API Merchant fornisce i dettagli delle risorse e dei metodi dell'API Merchant.
   • La guida Guida rapida mostra come iniziare rapidamente a utilizzare l'API Merchant per creare un account e caricare un prodotto di esempio.
   • Guide specifiche per funzionalità: per l'implementazione di nuove funzionalità o per ulteriori chiarimenti, puoi consultare le guide alle funzionalità fornite nella navigazione.

3. Identifica le sub-API di cui prevedi di eseguire la migrazione e che vuoi implementare.

   Determina due cose:

   • Le funzionalità dell'API Merchant di cui devi eseguire la migrazione
   • Le nuove funzionalità che vuoi implementare

   Una volta fatto, puoi determinare la quantità di lavoro e un elenco di priorità delle sub-API su cui lavorare.

   Ti consigliamo di eseguire la migrazione di tutto o della maggior parte possibile. Se inizialmente non riesci a eseguire la migrazione dell'intera implementazione dell'API Content, a causa dell'importanza e della complessità, dai la priorità alle seguenti sub-API.

   • Account
   • Prodotti
   • Origini dati
   • Report
   Nota: Puoi affrontare questo problema caso per caso, a seconda del tuo tipo di integrazione. Ad esempio, una funzionalità come Inventari potrebbe avere una priorità più alta.

Passi per la migrazione

1. Registrati come sviluppatore : per utilizzare l'API Merchant, devi creare un link tra il tuo progetto Google Cloud e il tuo account Merchant Center principale. Questa registrazione una tantum è obbligatoria per ogni progetto Google Cloud che utilizzi con l'API Merchant. Puoi seguire l'intera procedura qui.

2. Testa diversi metodi per aiutarti a velocizzare l'operazione. Ti consigliamo di utilizzare Google APIs Explorer per eseguire test di base.

   Il formato degli URL delle richieste per l'API Merchant è

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. Sfrutta i nostri esempi di codice e le nostre librerie client.

   Per ridurre i tempi di implementazione e sfruttare i vantaggi di gRPC, utilizza le librerie client e gli esempi di codice.

   Incorporiamo anche snippet di esempio di codice nelle nostre guide. Ad esempio, vedi Aggiungere un prodotto.

4. Testa i percorsi utente semplici.

   Esegui test del percorso utente su tutte le sub-API e le funzionalità di cui prevedi di eseguire la migrazione con i seguenti obiettivi:

   • Le risorse e le chiamate di cui hai eseguito la migrazione hanno risultati di risposta corretti.
   • Il tasso di errore rimane basso.

Pianifica il lancio

Ti consigliamo il seguente approccio:

• Implementa una sub-API o un metodo alla volta.
• Implementa solo un piccolo segmento dell'attività alla volta.
• Monitora sempre eventuali problemi.

Implementa la migrazione

1. Lavora alla codifica utilizzando le nuove risorse e i nuovi endpoint.

   Dopo i test iniziali e lo sviluppo di un piano di rilascio, integra l'API Merchant nei tuoi workflow.

2. Monitora.

   Preparati ad affrontare potenziali problemi.