Avvia la migrazione

In questa pagina forniamo indicazioni sulla pianificazione della migrazione delle API.

Poi, esaminiamo i passaggi necessari per la migrazione.

Pianifica la migrazione

  1. Mappa i metodi dell'API Content for Shopping con i 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 tua migrazione.

    Ti consigliamo di esaminare e tenere a mente le seguenti risorse, che ti saranno utili per la migrazione:

    • Migrazione dalla panoramica dell'API Content: vengono descritte le principali modifiche da tenere presenti nell'API Merchant
    • Guide alla migrazione specifiche per le API secondarie: consulta le guide alla migrazione specifiche per le API secondarie 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 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 API secondarie di cui prevedi di eseguire la migrazione e che vuoi implementare.

    Determina due cose:

    • 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 API secondarie su cui lavorare.

    Ti consigliamo di eseguire la migrazione di tutti i dati o del maggior numero 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 API secondarie.

Passi per la migrazione

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

  2. Prova diversi metodi per aumentare gradualmente la spesa. 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 librerie client.

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

    Inoltre, incorporiamo snippet di codice campione nelle nostre guide. Ad esempio, vedi Aggiungere un prodotto.

  4. Testa percorsi utente semplici.

    Esegui test del percorso utente su tutte le API secondarie e le funzionalità che prevedi di migrare con i seguenti obiettivi:

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

Pianificare l'implementazione

Ti consigliamo di procedere come segue:

  • Implementa una sub-API o un metodo alla volta.
  • Esegui l'implementazione solo per un piccolo segmento dell'attività alla volta.
  • Monitora i problemi in qualsiasi momento.

Implementare 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.