Esegui la migrazione dalla versione v1 alla versione 2

Ultimo aggiornamento: 06/12/2022

Esegui la migrazione dell'applicazione

La migrazione da v1 a v2 richiede l'aggiornamento degli URL degli endpoint per chiamare la versione v2 e aggiornare l'applicazione per tenere conto delle modifiche che provocano un errore.

Aggiorna le chiamate API da v1 a v2

Per utilizzare la versione v2 anziché la versione 1, devi aggiornare le richieste in modo da utilizzare la nuova versione v2 endpoint.

Ad esempio, per chiamare il metodo advertisers.get con v1, devi utilizza il seguente URL:

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

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

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

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

Apporta le modifiche desiderate

Stiamo introducendo una serie di modifiche che provocano un errore nella versione 2. Esamina quanto segue istruzioni e apportare le modifiche necessarie pertinenti all'utilizzo esistente dei Display e l'API Video 360.

Aggiorna le chiamate ai metodi di targeting

• Alcuni tipi di targeting vengono ora assegnati utilizzando valori enum anziché il targeting ID opzione. Ad esempio, i dispositivi tablet vengono ora indirizzati direttamente DEVICE_TYPE_TABLET DeviceType enum, anziché l'ID opzione di targeting targetingTypes.targetingOptions. Versioni stringa di queste enumerazioni sono rappresentate nel nuovo assignedTargetingOptionIdAlias in questi campi Risorse AssignedTargetingOption e può essere utilizzata durante il recupero o eliminando il targeting esistente. Il valore assignedTargetingOptionId di queste AssignedTargetingOption risorse non sono cambiate.

  Aggiorna le chiamate che gestiscono i seguenti tipi di targeting per utilizzare i valori enum:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

• Il metodo advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions è stato sostituito dal metodo advertisers.lineItems.bulkEditAssignedTargetingOptions.

• Il metodo advertisers.lineItems.bulkListLineItemAssignedTargetingOptions è stato sostituito dal metodo advertisers.lineItems.bulkListAssignedTargetingOptions.

• Aggiorna la gestione delle chiamate di TARGETING_TYPE_PROXIMITY_LOCATION_LIST utilizzare dimensioni del raggio e unità di misura della distanza invece di una Valore enum ProximityRadiusRange.

• Metodi di targeting che recuperano o modificano le opzioni di targeting in più i tipi di targeting in una singola risorsa padre sono stati rinominati.

  Aggiorna le chiamate ai seguenti metodi per utilizzare i nuovi nomi:

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions dal giorno a advertisers.editAssignedTargetingOptions
  • advertisers.bulkListAdvertiserAssignedTargetingOptions dal giorno a advertisers.listAssignedTargetingOptions
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions dal giorno a advertisers.campaigns.listAssignedTargetingOptions
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions dal giorno a advertisers.insertionOrders.listAssignedTargetingOptions
  • Da partners.bulkEditPartnerAssignedTargetingOptions a partners.editAssignedTargetingOptions

Aggiorna le chiamate al servizio advertisers.lineItems

• Il campo inventorySourceIds è stato rimosso. Gestisci assegnazione dell'origine dell'inventario utilizzando le risorse di AssignedTargetingOption di TARGETING_TYPE_INVENTORY_SOURCE.

• I seguenti valori enum LineItemWarningMessage hanno sono stati deprecati nella versione 2 e non verranno più visualizzati LineItem.warningMessages:

  • NO_POSITIVE_AUDIENCE_LIST_TARGETED
  • APP_INSTALL_NO_CONVERSION_PIXEL
  • TARGETING_REVOKED_OR_CLOSED_USER_LIST
  • APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
  • CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
  • NO_CREATIVE_FOR_TARGETED_DEALS
  • TARGETING_DEPRECATED_GEO_TARGET

• Il campo triggerId è stato rimosso dalla LineItemFlight e Il valore LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER è stato rimosso dal Tipo di enum LineItemFlightDateType. v2 non supporta Impostare gli elementi pubblicitari da spendere in base all'attivazione di attivatori manuali.

Aggiorna le chiamate al servizio customBiddingAlgorithms

customBiddingAlgorithmState e modelReadiness campi sono stati sostituiti con il tag modelDetails , che fornisce il idoneità e sospensione dell'algoritmo esistente modello per ogni inserzionista che ha accesso tramite un elenco CustomBiddingModelDetails oggetti.

Ulteriori modifiche

Oltre alle modifiche che provocano un errore, la versione 2 introduce anche nuove le funzionalità di machine learning.

Le funzioni aggiunte alla versione 2 dopo il lancio iniziale sono disponibili nella nostra note di rilascio.

Accesso di sola lettura agli elementi pubblicitari YouTube

Nella versione 2, gli elementi pubblicitari YouTube e le relative impostazioni di targeting possono essere recuperati utilizzando advertisers.lineItems e advertisers.lineItems.targetingTypes.assignedTargetingOptions e servizi correlati, rispettivamente. L'API fornisce accesso di sola lettura, vale a dire richieste di scrittura effettuate a questi elementi pubblicitari restituiranno un errore. YouTube gli elementi pubblicitari saranno di uno dei seguenti LineItemType valori:

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Nuovi metodi per migliorare le prestazioni

Nella versione 2, il servizio advertisers.lineItems fornisce nuove da utilizzare al posto delle richieste in batch per migliorare delle prestazioni e il consumo di quote ridotto:

• Puoi utilizzare advertisers.lineItems.bulkUpdate per impostare gli stessi valori dei campi per più elementi pubblicitari. Si aggiorna solo alla I campi entityStatus sono attualmente supportati.
• Puoi utilizzare advertisers.lineItems.bulkEditAssignedTargetingOptions per aggiungere o rimuovere le stesse opzioni di targeting assegnate su più righe elementi.
• Puoi utilizzare advertisers.lineItems.bulkListAssignedTargetingOptions per elencare le opzioni di targeting assegnate a più elementi pubblicitari.
• Puoi utilizzare advertisers.lineItems.duplicate per creare un duplicato. di un elemento pubblicitario esistente nello stesso ordine di inserzione, copiando configurazioni e impostazioni di targeting.

Accesso parziale in scrittura per il targeting degli ordini di inserzione

Nella versione v2, puoi modificare le impostazioni di targeting di un sottoinsieme per InsertionOrder di risorse utilizzando le nuove create e delete nella sezione advertisers.insertionOrders.targetingTypes.assignedTargetingOptions completamente gestito di Google Cloud. I seguenti tipi di targeting possono essere completamente gestiti al momento dell'inserimento Livello di ordine:

• TARGETING_TYPE_AGE_RANGE
• TARGETING_TYPE_BROWSER
• TARGETING_TYPE_CATEGORY
• TARGETING_TYPE_CHANNEL
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
• TARGETING_TYPE_ENVIRONMENT
• TARGETING_TYPE_GENDER
• TARGETING_TYPE_KEYWORD
• TARGETING_TYPE_LANGUAGE
• TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
• TARGETING_TYPE_OPERATING_SYSTEM
• TARGETING_TYPE_PARENTAL_STATUS
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
• TARGETING_TYPE_VIEWABILITY