Display- und Video 360 API Version 2 wird eingestellt. Verwenden Sie Display- und Video 360 API v3. Eine Anleitung zur Migration von Version 2 zu Version 3 finden Sie in unserer Migrationsanleitung.

Diese Seite wurde von der Cloud Translation API übersetzt.

Von Version 3 zu Version 4 migrieren

Auf dieser Seite
Anwendung migrieren
- API-Aufrufe von Version 3 auf Version 4 aktualisieren
- Erforderliche Änderungen ausführen

Letzte Aktualisierung: 27.03.2025

Anwendung migrieren

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

API-Aufrufe von Version 3 auf Version 4 aktualisieren

Wenn Sie v4 anstelle von v3 verwenden möchten, aktualisieren Sie Ihre Anfragen, um die neuen v4-Endpunkte zu verwenden.

Wenn du beispielsweise die Methode advertisers.get mit Version 3 aufrufen möchtest, verwende die folgende URL:

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

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

GET https://displayvideo.googleapis.com/v4/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 4.

Erforderliche Änderungen ausführen

In Version 4 gibt es eine Reihe von Änderungen, 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 zu Zielgruppenressourcen mit selbst erhobenen Daten und Drittanbieter-Zielgruppen sowie zu zugehörigem Targeting aktualisieren

FirstAndThirdPartyAudience-Ressourcen wurden durch FirstPartyAndPartnerAudience-Ressourcen ersetzt.

Aufgrund dieser Änderung müssen Sie Folgendes aktualisieren:

Verweise auf FirstAndThirdPartyAudience-Ressourcen, um die neue Ressource FirstPartyAndPartnerAudience zu verwenden.
Vorhandene Anfragen an Methoden im V3-Dienst firstAndThirdPartyAudiences werden an den neuen V4-Dienst firstPartyAndPartnerAudiences weitergeleitet.
Die Standardseitengröße für firstPartyAndPartnerAudiences.list-Anfragen wird von 100 auf 5.000 Elemente erhöht.
Verweise vom V3-Feld firstAndThirdPartyAudienceType auf das neue V4-Feld firstPartyAndPartnerAudienceType mit dem neuen FirstPartyAndPartnerAudienceType-Enumtyp, wobei die alten Werte den folgenden neuen Werten entsprechen:
- FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY nach TYPE_FIRST_PARTY
- FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY nach TYPE_PARTNER
Verweise auf den AudienceType-Enumwert LICENSED werden durch einen der folgenden neuen, spezifischeren Werte ersetzt:
- THIRD_PARTY
- COMMERCE
- LINEAR
Referenzen auf AssignedTargetingOption-Ressourcen von TargetingType TARGETING_TYPE_AUDIENCE_GROUP, um die v3-Felder in AudienceGroupAssignedTargetingOptionDetails durch die folgenden neuen v4-Felder zu ersetzen:
- excludedFirstAndThirdPartyAudienceGroup mit excludedFirstPartyAndPartnerAudienceGroup
- includedFirstAndThirdPartyAudienceGroups mit includedFirstPartyAndPartnerAudienceGroups

Anfragen für das Targeting auf Bulk-Listen von Anzeigengruppen aktualisieren

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions wurde in advertisers.adGroups.bulkListAssignedTargetingOptions umbenannt. Aktualisieren Sie Ihre vorhandenen Anfragen, damit der neue Methodenname verwendet wird.

Beim Erstellen von Anzeigenaufträgen ein Optimierungsziel angeben

optimizationObjective ist jetzt ein Pflichtfeld in der Ressource InsertionOrder. Prüfe, ob dieses Feld in deinen advertisers.insertionOrders.create-Anfragen festgelegt ist.

Alle Anfragen zum Verwalten oder Abrufen der Ausrichtung von Kampagnen oder Anzeigenaufträgen entfernen

Die Möglichkeit, das Targeting von Kampagnen oder Anzeigenaufträgen abzurufen oder zu verwalten, wurde entfernt. Entfernen Sie alle Anfragen an die folgenden Dienste oder Methoden:

advertisers.campaigns.targetingTypes.assignedTargetingOptions-Dienst
advertisers.insertionOrders.targetingTypes.assignedTargetingOptions-Dienst
Methode advertisers.campaigns.listAssignedTargetingOptions
Methode advertisers.insertionOrders.listAssignedTargetingOptions

Entfernen Sie Verweise auf das Creative-Ressourcenfeld `publisherReviewStatuses`.

Das Feld publisherReviewStatuses wurde aus dem Objekt ReviewStatusInfo unter der Ressource Creative entfernt, nachdem es im Juni 2024 eingestellt wurde.