Avvia la migrazione

Questa pagina fornisce indicazioni sulla pianificazione della migrazione dell'API e descrive i passaggi necessari.

Pianifica la migrazione

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

    Scopri i nuovi metodi e le nuove risorse richiesti per l'API Merchant.

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

    Consulta le seguenti risorse per assistenza con 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: esamina 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.
    • I riferimenti dell'API Merchant forniscono 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.

    Se inizialmente non riesci a eseguire la migrazione dell'intera implementazione dell'API Content, dai la priorità alle seguenti API secondarie in base all'importanza e alla complessità.

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 nella pagina Panoramica.

  2. Prova diversi metodi per aumentare la tua produttività. 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.

    Le guide includono snippet di esempio di codice. 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.
  • Implementa solo un piccolo segmento dell'attività alla volta.
  • Monitora sempre la presenza di problemi.

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.