Von v1 zu v2 migrieren

Letzte Aktualisierung: 06.12.2022

Anwendung migrieren

Wenn Sie von Version 1 zu Version 2 migrieren möchten, müssen Sie Ihre Endpunkt-URLs so aktualisieren, dass sie Version 2 aufrufen, und Ihre Anwendung so aktualisieren, dass sie die entscheidenden Änderungen berücksichtigt.

API-Aufrufe von Version 1 auf Version 2 aktualisieren

Wenn Sie v2 anstelle von v1 verwenden möchten, müssen Sie Ihre Anfragen so aktualisieren, dass sie die neuen v2-Endpunkte verwenden.

Wenn Sie beispielsweise die Methode advertisers.get mit v1 aufrufen möchten, verwenden Sie die folgende URL:

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

Aktualisieren Sie die URL für Version 2 auf Folgendes:

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

Wenn Sie eine Clientbibliothek verwenden, um Anfragen an die API zu senden, verwenden Sie die neueste Version der Clientbibliothek und aktualisieren Sie Ihre Konfiguration auf Version 2.

Erforderliche Änderungen ausführen

In Version 2 führen wir eine Reihe von Änderungen ein, die die Kompatibilität beeinträchtigen. Lesen Sie sich die folgende Anleitung durch und nehmen Sie die erforderlichen Änderungen vor, die sich auf Ihre aktuelle Nutzung der Display & Video 360 API beziehen.

Aufrufe von Targeting-Methoden aktualisieren

• Einige Targeting-Typen werden jetzt mithilfe von Aufzählungwerten anstelle von Targeting-Optionen-IDs zugewiesen. Beispielsweise wird jetzt direkt über die Aufzählung DEVICE_TYPE_TABLET DeviceType auf Tablets ausgerichtet, anstatt über die ID der Ausrichtungsoption aus dem Dienst targetingTypes.targetingOptions. Stringversionen dieser Enumerationen sind in diesen Ressourcen vom Typ AssignedTargetingOption im neuen Feld assignedTargetingOptionIdAlias enthalten. Sie können zum Abrufen oder Löschen vorhandener Targeting-Informationen verwendet werden. Der assignedTargetingOptionId-Wert dieser AssignedTargetingOption-Ressourcen hat sich nicht geändert.

  Aktualisieren Sie Aufrufe, die die folgenden Targeting-Typen verwalten, 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 advertisers.lineItems.bulkEditAssignedTargetingOptions ersetzt.

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

• Aktualisieren Sie Aufrufe, die TARGETING_TYPE_PROXIMITY_LOCATION_LIST verwalten, sodass anstelle eines Aufzählungswerts von ProximityRadiusRange eine festgelegte Radiusgröße und Einheit für Entfernungen verwendet wird.

• Targeting-Methoden, mit denen Targeting-Optionen für mehrere Targeting-Typen unter einer einzigen übergeordneten Ressource abgerufen oder bearbeitet werden, wurden umbenannt.

  Aktualisieren Sie die Aufrufe der folgenden Methoden, um die neuen Namen zu verwenden:

  • 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 an den advertisers.lineItems-Dienst aktualisieren

• Das Feld inventorySourceIds wurde entfernt. Verwaltung der Zuweisung von Inventarquellen mit AssignedTargetingOption-Ressourcen von TARGETING_TYPE_INVENTORY_SOURCE

• Die folgenden LineItemWarningMessage-Eintragstypen wurden in Version 2 eingestellt und werden in LineItem.warningMessages nicht mehr angezeigt:

  • 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 Objekt LineItemFlight entfernt und der Wert LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER aus dem Enumerationstyp LineItemFlightDateType. In Version 2 können Werbebuchungen nicht mehr so eingerichtet werden, dass Ausgaben basierend auf der Aktivierung manueller Trigger erfolgen.

Aufrufe an den customBiddingAlgorithms-Dienst aktualisieren

Die Felder customBiddingAlgorithmState und modelReadiness wurden durch das Feld modelDetails ersetzt. Dieses enthält den Status Bereit und Sperrung des vorhandenen Algorithmusmodells für jeden Werbetreibenden, der über eine Liste von CustomBiddingModelDetails-Objekten Zugriff hat.

Weitere Änderungen

Zusätzlich zu den oben aufgeführten Änderungen werden mit Version 2 auch neue Funktionen eingeführt.

Informationen zu den Funktionen, die nach der Erstveröffentlichung hinzugefügt wurden, finden Sie in den Versionshinweisen.

Lesezugriff auf YouTube-Werbebuchungen

In Version 2 können YouTube-Werbebuchungen und ihre Targeting-Einstellungen mit den Diensten advertisers.lineItems und advertisers.lineItems.targetingTypes.assignedTargetingOptions abgerufen werden. Die API bietet Lesezugriff. Alle Schreibanfragen an diese Werbebuchungen schlagen fehl. YouTube-Werbebuchungen haben einen 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 Dienst advertisers.lineItems neue Methoden an, die anstelle von Batchanfragen verwendet werden können, um die Leistung zu verbessern und das Kontingent zu schonen:

• Mit advertisers.lineItems.bulkUpdate können Sie dieselben Feldwerte für mehrere Werbebuchungen festlegen. Derzeit werden nur Aktualisierungen des Felds entityStatus unterstützt.
• Mit der Taste advertisers.lineItems.bulkEditAssignedTargetingOptions können Sie denselben zugewiesenen Targeting-Optionen mehrere Werbebuchungen hinzufügen oder sie daraus entfernen.
• Mit advertisers.lineItems.bulkListAssignedTargetingOptions können Sie zugewiesene Targeting-Optionen für mehrere Werbebuchungen auflisten.
• Mit advertisers.lineItems.duplicate können Sie eine vorhandene Werbebuchung im selben Anzeigenauftrag duplizieren und dabei alle Konfigurationen und Targeting-Einstellungen kopieren.

Teilweiser Schreibzugriff auf das Targeting von Anzeigenaufträgen

In Version 2 können Sie die Einstellungen für das Targeting auf eine Teilmenge von InsertionOrder-Ressourcen mit den neuen Methoden create und delete im Dienst advertisers.insertionOrders.targetingTypes.assignedTargetingOptions bearbeiten. Die folgenden Targeting-Typen können vollständig auf Anzeigenauftragsebene verwaltet werden:

• 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