Von der Display & Video 360 API v4 zu v5 migrieren

Zuletzt aktualisiert: 22.10.2026

Warnung: v5 befindet sich in der offenen Betaphase. In der Betaversion von v5 können funktionsgefährdende Änderungen vorgenommen werden. Diese werden in den Versionshinweisen zur Display & Video 360 API aufgeführt. Dieses Dokument wird bei Bedarf aktualisiert, um die Live-Betaversion widerzuspiegeln.

Anwendung migrieren

Für die Migration von v4 zu v5 müssen Sie Ihre Endpunkt-URLs aktualisieren, um v5 aufzurufen, Ihre Anwendung aktualisieren, um funktionsgefährdende Änderungen zu berücksichtigen, und alle neuen Funktionen prüfen, die für Ihre Integration nützlich sein könnten.

API-Aufrufe von v4 auf v5 aktualisieren

Wenn Sie v5 anstelle von v4 verwenden möchten, müssen Sie Ihre Anfragen so aktualisieren, dass die neuen v5-Endpunkte verwendet werden.

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

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

Aktualisieren Sie die URL für v5 auf Folgendes:

GET https://displayvideo.googleapis.com/v5/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, um v5 zu verwenden.

Erforderliche Änderungen ausführen

In Version 5 der Display & Video 360 API werden einige funktionsgefährdende Änderungen eingeführt. Lesen Sie die folgende Anleitung und nehmen Sie die erforderlichen Änderungen vor, die für Ihre bestehende Nutzung der Display & Video 360 API relevant sind.

Eine vollständige Liste der Unterschiede zwischen Version 4 und Version 5 der Display & Video 360 API finden Sie in den Versionshinweisen.

Abruf und Targeting von Inventarquellen aktualisieren, um neue IDs und Typen zu verwenden

In der Display & Video 360 API v5 wird die Art und Weise geändert, wie Deals für Inventarquellen und Auktionspakete abgerufen und ausgerichtet werden.

In v4 stellen InventorySource-Ressourcen, die mit dem inventorySources-Dienst abgerufen werden, sowohl Deals für Inventarquellen als auch Auktionspakete dar. Sowohl Deals als auch Auktionspakete werden mit TARGETING_TYPE_INVENTORY_SOURCE ausgerichtet.

In v5 werden Deals und Auktionspakete von Inventarquellen separat behandelt:

• Deals für Inventarquellen werden mit TARGETING_TYPE_INVENTORY_SOURCE_DEAL ausgerichtet, mit den Diensten advertisers.inventorySources und partners.inventorySources abgerufen und mit dem Feld AssignedTargetingOption inventorySourceDetails ausgerichtet.
• Auktionspakete werden mit TARGETING_TYPE_AUCTION_PACKAGE ausgerichtet, mit dem Dienst targetingTypes.targetingOptions abgerufen und mit dem AssignedTargetingOption-Feld auctionPackageDetails ausgerichtet.

Durch dieses Update werden die IDs für vorhandene Deals und Auktionspakete geändert. Sie können daher nach der Migration keine zuvor im Cache gespeicherten InventorySource-Ressourcen-IDs mehr verwenden.

Zusätzlich zu diesen Änderungen wird in Version 5 auch die Möglichkeit entfernt, Zugriffsfunktionen für Inventarquellen zu erstellen, zu aktualisieren und zu bearbeiten.

Logik für das Zielgruppen-Targeting für Demand Gen- und YouTube-Ressourcen aktualisieren

In Version 5 der Display & Video 360 API wird die Logik für das Zielgruppen-Targeting für Demand Gen- und YouTube-Ressourcen aktualisiert, sodass für jede Zielgruppenliste, auf die das Targeting ausgerichtet ist, einzelne zugewiesene Optionen verwendet werden.

In v4 wird das gesamte Zielgruppen-Targeting über TARGETING_TYPE_AUDIENCE_GROUP verwaltet.

In v5 wird das Zielgruppen-Targeting für Demand Gen- und YouTube-Anzeigengruppen je nach Zielgruppentyp mit einem der folgenden Targeting-Typen und AssignedTargetingOption-Ressourcenfelder verwaltet:

• TARGETING_TYPE_COMBINED_AUDIENCE mit combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST mit customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE mit firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE mit googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE mit lookalikeAudienceDetails

Für Werbebuchungen wird weiterhin ein einzelnes TARGETING_TYPE_AUDIENCE_GROUP-AssignedTargetingOption verwendet, um das Zielgruppen-Targeting für alle Typen zu verwalten.

Auf die Data Manager API für die Verwaltung von Zielgruppen zum Kundenabgleich umstellen

In Version 5 der Display & Video 360 API ist es nicht mehr möglich, Zielgruppen zum Kundenabgleich zu erstellen und die Mitgliedschaft zu verwalten. Die folgenden Methoden wurden entfernt:

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

Wenn Sie weiterhin Zielgruppen zum Kundenabgleich verwalten möchten, müssen Sie Ihre Workflows auf die Data Manager API umstellen.

Unterstützung für das Abrufen von Anzeigenaufträgen für digitale Außenwerbung hinzufügen

In Version 5 der Display & Video 360 API wird das Abrufen von Anzeigenaufträgen für digitale Außenwerbung unterstützt.

Wenn Ihre Werbetreibenden digitale Außenwerbung verwenden, sollten Sie alle Integrationen aktualisieren, die advertisers.insertionOrders.list aufrufen, um die Einbeziehung von InsertionOrder-Ressourcen mit dem insertionOrderType-Feldwert OUT_OF_HOME vorzubereiten.

In v5 können Werbebuchungen unter Anzeigenaufträgen für digitale Außenwerbung weiterhin wie in v4 abgerufen werden.

Verweise auf Adloox in Peer39 aktualisieren

In v5 wurden Felder und Enum-Werte, die sich auf die Integration der Markeneignung von Drittanbietern in Display & Video 360 mit Adloox (auch als Scope3 bezeichnet) beziehen, auf Peer39 aktualisiert:

• Das Feld adloox von ThirdPartyVerifierAssignedTargetingOptionDetails wurde durch peer39 ersetzt.
• Die PartnerCostType-Enum-Werte PARTNER_COST_TYPE_ADLOOX und PARTNER_COST_TYPE_ADLOOX_PREBID wurden durch PARTNER_COST_TYPE_PEER39 und PARTNER_COST_TYPE_PEER39_PREBID ersetzt.

Felder für YouTube-Werbebuchungen, ‑Anzeigengruppen und ‑Anzeigen aktualisieren

In v5 wurden verschiedene Felder in den Ressourcen LineItem, AdGroup und AdGroupAd entfernt oder aktualisiert. Aktualisieren Sie Ihre Logik zum Abrufen von Ressourcen, um diese Änderungen zu berücksichtigen.

In der Ressource LineItem:

• Das Feld YoutubeAndPartnersSettings relatedVideoIds wurde durch relatedVideos ersetzt.

In den Ressourcen LineItem und AdGroup:

• Die Felder audienceExpansionSeedListExcluded und audienceExpansionLevel von TargetingExpansionConfig wurden entfernt.

In der Ressource AdGroupAd:

• Das Feld containsSyntheticMedia wurde hinzugefügt.
• Das Feld trackingUrl in den Objekten AudioAd, CommonInStreamAttribute und VideoPerformanceAd wurde in zwei Felder aufgeteilt: trackingUrl und userSpecifiedTrackingUrl. So kann zwischen der für das Tracking verwendeten URL und der vom Nutzer angegebenen Tracking-URL unterschieden werden.

Verweise auf eingestellte Enum-Werte entfernen

In v5 wurden zuvor verworfene Enum-Werte vollständig entfernt. Die Verwendung dieser Werte in Anfragen an die API würde in v4 zu einem Fehler führen. Mit dieser Änderung werden alle Verweise darauf aus den v5-Clientbibliotheken entfernt. Verweise auf diese verworfenen Werte in Ihrem Code können beim Upgrade auf Version 5 zu Fehlern führen.

Zu den Enum-Typen mit betroffenen Werten gehören ContentRatingTier, GoogleAudienceType, SdfVersion und SensitiveCategory. Eine vollständige Liste aller entfernten Enum-Werte finden Sie in unseren Versionshinweisen.

Neue Funktionen ansehen

Zusätzlich zu den funktionsgefährdenden Änderungen werden in v5 auch die folgenden neuen Funktionen eingeführt:

• Vollständige Verwaltung des ausschließenden Targetings für YouTube-Videos und -Kanäle auf Werbetreibendenebene unter den Targeting-Typen TARGETING_TYPE_YOUTUBE_VIDEO und TARGETING_TYPE_YOUTUBE_CHANNEL. In v4 war dieses Targeting schreibgeschützt.
• Die Möglichkeit, Ressourcen für digitale Außenwerbung (InsertionOrder) zu erstellen.
• Unterstützung für Anzeigengruppen, die zugewiesene Creatives verwenden, um Anzeigen zu generieren, durch Hinzufügen der AdGroup-Felder adSource und creativeAssignments sowie des AdGroupAd-Felds parentCreativeId.
• Die Möglichkeit, LookalikeAudience-Ressourcen zu erstellen und abzurufen.
• Ein neues containsSyntheticMedia-Feld in der AdGroupAd-Ressource.