Controllo delle versioni nell'API Search Ads 360 Reporting

L'API Search Ads 360 Reporting utilizza il controllo delle versioni semantico.

Esistono versioni principali e secondarie con formato vMAJOR_MINOR. Ad esempio, v0_0 è la prima versione principale e v0_1 la prima versione secondaria. Il suffisso del numero di versione indica il tipo di versione: per le versioni principali è sempre zero e per le versioni secondarie è sempre maggiore di zero.

Versioni principali

Le release principali introducono modifiche che provocano errori, ovvero modifiche non compatibili con le versioni precedenti.

Ogni versione principale ha un endpoint separato, ad esempio:

https://searchads360.googleapis.com/v0

https://searchads360.googleapis.com/v1

Quando esegui l'upgrade da una versione principale a un'altra, potrebbe essere necessario modificare il codice prima di passare al nuovo endpoint della versione principale.

Se utilizzi una libreria client, devi eseguire l'upgrade alla versione più recente. Le nuove versioni principali forniscono una guida alla migrazione per aiutarti a correggere eventuali modifiche che provocano un errore nel codice.

Ecco alcuni esempi di modifiche che provocano un errore:

  • Rimozione o ridenominazione di un servizio, un'interfaccia, un campo, un metodo o un valore di enumerazione.
  • Modifica del tipo di un campo.
  • Modifica del formato del nome di una risorsa.
  • Modifica del formato dell'URL nella definizione HTTP.
  • Modificare i formati di output, ad esempio cambiare il valore predefinito di 0 in --.
  • Modifica del motivo dell'errore restituito da A a B.

Versioni secondarie

Le versioni minori introducono solo modifiche compatibili con le versioni precedenti.

Quando viene rilasciata una versione secondaria, l'endpoint già in uso viene aggiornato automaticamente. Questa operazione non causa l'interruzione del codice. Puoi continuare a utilizzare la tua libreria client esistente.

Le versioni secondarie includono nuove funzionalità o aggiornamenti che non influiscono sul codice esistente. Se vuoi utilizzare le nuove funzionalità, devi eseguire l'upgrade della tua libreria client alla versione più recente.

Tramonti

Quando è pianificato il ritiro di una versione precedente dell'API Search Ads 360 Reporting, pubblichiamo una notifica nel gruppo di Google searchads-api-announcements.