Migra de v1 a v2

Última actualización: 6 de diciembre de 2022

Migra tu aplicación

Para migrar de v1 a v2, es necesario actualizar las URLs de tu extremo para llamar a v2 y actualizando tu aplicación para dar cuenta de los cambios rotundos.

Actualiza tus llamadas a la API de v1 a v2

Para usar v2 en lugar de v1, debes actualizar tus solicitudes para usar la nueva v2 en los extremos.

Por ejemplo, para llamar al método advertisers.get con v1, debes usa la siguiente URL:

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

Para la v2, actualiza la URL a lo siguiente:

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

Si usas una biblioteca cliente para realizar solicitudes a la API, usa el a la versión más reciente de la biblioteca cliente y actualiza tu configuración para usar v2.

Realiza los cambios necesarios

Presentamos varios cambios rotundos en la versión 2. Revisa lo siguiente instrucciones y realizar los cambios necesarios que sean relevantes para su uso actual del Anuncios gráficos y API de Video 360.

Cómo actualizar las llamadas a los métodos de segmentación

• Algunos tipos de segmentación ahora se asignan con valores de enumeración en lugar de la segmentación IDs de las opciones. Por ejemplo, ahora se orienta directamente a los dispositivos tableta con la DEVICE_TYPE_TABLET DeviceType enumeración, en lugar del ID de la opción de orientación servicio targetingTypes.targetingOptions. Versiones de cadena de estas enumeraciones están representadas en el nuevo campo assignedTargetingOptionIdAlias en estas AssignedTargetingOption y se pueden usar cuando se recuperan o borrando la segmentación existente. El valor assignedTargetingOptionId de estos AssignedTargetingOption recursos no cambiaron.

  Actualiza las llamadas mediante la administración de los siguientes tipos de segmentación para usar valores de enumeración:

  • 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

• El método advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions se reemplazó por el método advertisers.lineItems.bulkEditAssignedTargetingOptions

• El método advertisers.lineItems.bulkListLineItemAssignedTargetingOptions se reemplazó por el método advertisers.lineItems.bulkListAssignedTargetingOptions

• Actualiza las llamadas que administran TARGETING_TYPE_PROXIMITY_LOCATION_LIST para usar un tamaño de radio establecido y unidad de distancia en lugar de una El valor de enumeración ProximityRadiusRange.

• Métodos de orientación que recuperan o modifican las opciones de orientación en varios de los tipos de segmentación en un solo recurso superior.

  Actualiza las llamadas a los siguientes métodos para usar sus nombres nuevos:

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

Actualiza las llamadas al servicio de advertisers.lineItems

• Se quitó el campo inventorySourceIds. Administrar Asignación de fuentes de inventario con recursos AssignedTargetingOption de TARGETING_TYPE_INVENTORY_SOURCE.

• Los siguientes valores enum LineItemWarningMessage tienen dejó de estar disponible en la v2 y ya no aparecerá en 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

• El campo triggerId se quitó de la LineItemFlight y El valor LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER se quitó de la LineItemFlightDateType. La versión 2 no es compatible configurar líneas de pedido para invertir en función de la activación de activadores manuales.

Actualiza las llamadas al servicio de customBiddingAlgorithms

Los elementos customBiddingAlgorithmState y modelReadiness Los campos se reemplazaron por modelDetails. , que proporciona el campo readiness estados de suspensión del algoritmo existente para cada anunciante que tiene acceso a través de una lista de CustomBiddingModelDetails objetos.

Cambios adicionales

Además de los cambios rotundos mencionados anteriormente, la v2 también presenta atributos.

Las funciones que se agregaron a la v2 después del lanzamiento inicial pueden encontrarse en nuestra notas de la versión.

Acceso de solo lectura a las líneas de pedido de YouTube

En la v2, las líneas de pedido de YouTube y su configuración de segmentación pueden recuperarse el advertisers.lineItems y advertisers.lineItems.targetingTypes.assignedTargetingOptions servicios, respectivamente. La API proporciona acceso de solo lectura, lo que significa que cualquier las solicitudes de escritura que se hagan a estas líneas de pedido mostrarán un error. YouTube Las líneas de pedido serán de una de las siguientes LineItemType valores:

• 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

Nuevos métodos que permiten un mejor rendimiento

En la v2, el servicio de advertisers.lineItems proporciona nuevas métodos para usar en lugar de las solicitudes por lotes para mejorar y reducir el consumo de cuota:

• Puedes usar advertisers.lineItems.bulkUpdate para establecer la los mismos valores de campo para varias líneas de pedido. Solo se actualiza el Por el momento, se admiten los campos entityStatus.
• Puedes usar advertisers.lineItems.bulkEditAssignedTargetingOptions para agregar o quitar las mismas opciones de segmentación asignadas en varias líneas elementos.
• Puedes usar advertisers.lineItems.bulkListAssignedTargetingOptions para enumerar las opciones de segmentación asignadas en varias líneas de pedido.
• Puedes usar advertisers.lineItems.duplicate para crear un duplicado de una línea de pedido existente dentro del mismo pedido de inserción, copiar todo parámetros de configuración y de segmentación.

Acceso de escritura parcial para la segmentación de pedidos de inserción

En la versión 2, puedes editar un subconjunto de la configuración de la segmentación para InsertionOrder recursos con el nuevo create y métodos delete en la advertisers.insertionOrders.targetingTypes.assignedTargetingOptions servicio. Los siguientes tipos de segmentación se pueden administrar completamente en el nivel a nivel del pedido:

• 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