Von v1 zu v2 migrieren

Letzte Aktualisierung: 06.12.2022

Anwendung migrieren

Für die Migration von v1 zu v2 müssen Sie Ihre Endpunkt-URLs für den Aufruf von v2 und Sie müssen Ihre Anwendung aktualisieren, um funktionsgefährdende Änderungen zu berücksichtigen.

API-Aufrufe von v1 auf v2 aktualisieren

Um v2 anstelle von v1 zu verwenden, müssen Sie Ihre Anfragen auf die neue Version v2 aktualisieren. Endpunkten.

Um beispielsweise die Methode advertisers.get mit v1 aufzurufen, verwenden Sie die folgende URL:

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

Ändern Sie für Version 2 die URL wie folgt:

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

Wenn Sie eine Clientbibliothek verwenden, um Anfragen an die API zu senden, verwenden Sie die aktuelle Version der Clientbibliothek und aktualisieren Sie Ihre Konfiguration für die Verwendung von v2.

Erforderliche Änderungen ausführen

Version 2 enthält eine Reihe funktionsgefährdender Änderungen. Überprüfen Sie Folgendes und nehmen Sie die erforderlichen Änderungen vor, die für Ihre Nutzung des Display- und Video 360 API

Aufrufe für Ausrichtungsmethoden aktualisieren

• Einige Targeting-Typen werden jetzt über enum-Werte anstelle von Targeting zugewiesen Options-IDs. Tablets werden jetzt z. B. direkt mit der DEVICE_TYPE_TABLET DeviceType-Enum, statt mit der ID der Ausrichtungsoption aus dem targetingTypes.targetingOptions-Dienst. Stringversionen von werden diese Enums in der neuen Feld assignedTargetingOptionIdAlias in diesen AssignedTargetingOption-Ressourcen und können beim Abrufen oder das vorhandene Targeting gelöscht wird. Der Wert assignedTargetingOptionId dieser AssignedTargetingOption Ressourcen haben sich nicht geändert.

  Aktualisieren Sie die Aufrufe, mit denen die folgenden Targeting-Typen verwaltet werden, um Enum-Werte zu verwenden:

  • 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

• Die Methode advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions wurde durch die Methode ersetzt. advertisers.lineItems.bulkEditAssignedTargetingOptions

• Die Methode advertisers.lineItems.bulkListLineItemAssignedTargetingOptions wurde durch die Methode ersetzt. advertisers.lineItems.bulkListAssignedTargetingOptions

• Anrufe aktualisieren, die TARGETING_TYPE_PROXIMITY_LOCATION_LIST verwalten eine festgelegte Radiusgröße und Distanzeinheit anstelle eines ProximityRadiusRange: Aufzählungswert

• Ausrichtungsmethoden, mit denen Ausrichtungsoptionen für mehrere Targeting-Typen unter einer einzelnen übergeordneten Ressource wurden umbenannt.

  Aktualisieren Sie die Aufrufe der folgenden Methoden, damit die neuen Namen verwendet werden:

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

Aufrufe des Dienstes advertisers.lineItems aktualisieren

• Das Feld inventorySourceIds wurde entfernt. Verwalten Zuweisung einer Inventarquelle mithilfe von AssignedTargetingOption-Ressourcen von TARGETING_TYPE_INVENTORY_SOURCE.

• Die folgenden LineItemWarningMessage-Enum-Werte haben in Version 2 eingestellt und wird nicht mehr in 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

• Das Feld triggerId wurde aus dem LineItemFlight-Objekt und das LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER-Wert wurde aus dem LineItemFlightDateType: Enum-Typ. Version 2 unterstützt keine Sie legen die Ausgaben für Werbebuchungen basierend auf der Aktivierung manueller Trigger fest.

Aufrufe des Dienstes customBiddingAlgorithms aktualisieren

Die customBiddingAlgorithmState und die modelReadiness -Felder wurden durch modelDetails ersetzt. , das die Bereitschaft angibt, und Sperrstatus des vorhandenen Algorithmus für jeden Werbetreibenden erstellen, der über eine Liste mit CustomBiddingModelDetails-Objekte.

Weitere Änderungen

Neben den oben aufgeführten funktionsgefährdenden Änderungen enthält Version 2 auch neue Funktionen.

Funktionen, die Version 2 nach der ersten Veröffentlichung hinzugefügt wurden, finden Sie in der Versionshinweise

Lesezugriff auf YouTube-Werbebuchungen

In Version 2 können YouTube-Werbebuchungen und ihre Targeting-Einstellungen mithilfe von advertisers.lineItems und advertisers.lineItems.targetingTypes.assignedTargetingOptions Google-Dienste. Die API bietet nur Lesezugriff, Bei versuchten Schreibanfragen für diese Werbebuchungen wird ein Fehler zurückgegeben. YouTube Werbebuchungen gehören zu einem der folgenden LineItemType Werte:

• 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

Neue Methoden für eine bessere Leistung

In Version 2 bietet der advertisers.lineItems-Dienst neue Methoden, die Sie anstelle von aufeinanderfolgenden Anfragen verwenden können, und reduzierter Kontingentnutzung:

• Mit advertisers.lineItems.bulkUpdate können Sie die für mehrere Werbebuchungen verwenden. Nur Aktualisierungen der Das Feld entityStatus wird derzeit unterstützt.
• Sie können advertisers.lineItems.bulkEditAssignedTargetingOptions um dieselben zugewiesenen Targeting-Optionen über mehrere Zeilen hinweg hinzuzufügen oder zu entfernen Elemente.
• Sie können advertisers.lineItems.bulkListAssignedTargetingOptions um die zugewiesenen Targeting-Optionen mehreren Werbebuchungen aufzulisten.
• Mit advertisers.lineItems.duplicate können Sie ein Duplikat erstellen. Werbebuchung innerhalb eines Anzeigenauftrags ein. Dabei werden alle Konfigurationen und Targeting-Einstellungen.

Teilweiser Schreibzugriff für das Targeting von Anzeigenaufträgen

In Version 2 können Sie einige Targeting-Einstellungen für InsertionOrder bearbeiten. Ressourcen mit neuen create und delete-Methoden im advertisers.insertionOrders.targetingTypes.assignedTargetingOptions. . Die folgenden Targeting-Typen können beim Einfügen vollständig verwaltet werden Bestellebene:

• 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