Eseguire la migrazione dalla versione 3 alla versione 4

Ultimo aggiornamento: 31/07/2025

Eseguire la migrazione dell'applicazione

La migrazione dalla versione 3 alla versione 4 richiede l'aggiornamento degli URL degli endpoint per chiamare la versione 4 e l'aggiornamento dell'applicazione per tenere conto delle modifiche che causano interruzioni.

Aggiorna le chiamate API dalla versione 3 alla versione 4

Per utilizzare la versione 4 anziché la versione 3, aggiorna le richieste in modo che utilizzino i nuovi endpoint v4.

Ad esempio, per chiamare il metodo advertisers.get con la versione 3, utilizza il seguente URL:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Per la versione 4, aggiorna l'URL come segue:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

Se utilizzi una libreria client per effettuare richieste all'API, utilizza la versione più recente della libreria client e aggiorna la configurazione per utilizzare la versione 4.

Apporta le modifiche desiderate

Stiamo introducendo una serie di modifiche che provocano un errore nella versione 4. Esamina le seguenti istruzioni e apporta le modifiche necessarie in base all'utilizzo esistente dell'API Display & Video 360.

Aggiornamenti delle chiamate relative alle risorse dei segmenti di pubblico proprietari e di terze parti e al targeting correlato

Le risorse FirstAndThirdPartyAudience sono state sostituite dalle risorse FirstPartyAndPartnerAudience.

Questa modifica richiede l'aggiornamento di quanto segue:

• Riferimenti alle risorse FirstAndThirdPartyAudience per utilizzare la nuova risorsa FirstPartyAndPartnerAudience.
• Richieste esistenti ai metodi nel servizio v3 firstAndThirdPartyAudiences al nuovo servizio v4 firstPartyAndPartnerAudiences.
• Aspettative relative alle dimensioni predefinite della pagina per le richieste firstPartyAndPartnerAudiences.list da 100 a 5000 elementi.
• Riferimenti al campo firstAndThirdPartyAudienceType v3 al nuovo campo firstPartyAndPartnerAudienceType v4, utilizzando il nuovo tipo di enumerazione FirstPartyAndPartnerAudienceType, con i vecchi valori corrispondenti ai seguenti nuovi valori:
  • Da FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY a TYPE_FIRST_PARTY
  • Da FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY a TYPE_PARTNER

• Riferimenti al valore enum AudienceType LICENSED per utilizzare invece uno dei seguenti nuovi valori più specifici:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Riferimenti alle risorse AssignedTargetingOption di TargetingType TARGETING_TYPE_AUDIENCE_GROUP per sostituire i campi v3 in AudienceGroupAssignedTargetingOptionDetails con i seguenti nuovi campi v4:

  • excludedFirstAndThirdPartyAudienceGroup con excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups con includedFirstPartyAndPartnerAudienceGroups

Aggiornare le richieste di targeting degli elenchi collettivi dei gruppi di annunci esistenti

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions è stato rinominato advertisers.adGroups.bulkListAssignedTargetingOptions. Aggiorna le richieste esistenti per utilizzare il nuovo nome del metodo.

Includere un obiettivo di ottimizzazione durante la creazione degli ordini di inserzione

optimizationObjective è ora un campo obbligatorio nella risorsa InsertionOrder. Aggiorna le richieste advertisers.insertionOrders.create per verificare che questo campo sia impostato.

Rimuovi i riferimenti al campo risorsa creatività publisherReviewStatuses

Il campo publisherReviewStatuses è stato rimosso dall'oggetto ReviewStatusInfo nella risorsa Creative dopo essere stato ritirato a giugno 2024.