Von Version 3 zu Version 4 migrieren

Letzte Aktualisierung: 31.07.2025

Anwendung migrieren

Für die Migration von Version 3 zu Version 4 müssen Sie Ihre Endpunkt-URLs aktualisieren, um Version 4 aufzurufen, und Ihre Anwendung aktualisieren, um wesentliche Änderungen zu berücksichtigen.

API-Aufrufe von Version 3 auf Version 4 aktualisieren

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

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

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

Aktualisieren Sie für Version 4 die URL 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 aktuelle Version der Clientbibliothek und aktualisieren Sie Ihre Konfiguration, um Version 4 zu verwenden.

Erforderliche Änderungen ausführen

In Version 4 führen wir eine Reihe von Änderungen ein, die nicht abwärtskompatibel sind. Sehen Sie sich die folgenden Anleitungen an und nehmen Sie die erforderlichen Änderungen vor, die für Ihre aktuelle Nutzung der Display & Video 360 API relevant sind.

Aktualisierung von Aufrufen in Bezug auf Ressourcen für Zielgruppen mit selbst erhobenen Daten und Drittanbieter-Zielgruppen sowie die zugehörige Ausrichtung

FirstAndThirdPartyAudience-Ressourcen wurden durch FirstPartyAndPartnerAudience-Ressourcen ersetzt.

Diese Änderung erfordert, dass Sie Folgendes aktualisieren:

• Verweise auf FirstAndThirdPartyAudience-Ressourcen, um die neue FirstPartyAndPartnerAudience-Ressource zu verwenden.
• Vorhandene Anfragen an Methoden im v3-Dienst firstAndThirdPartyAudiences an den neuen v4-Dienst firstPartyAndPartnerAudiences.
• Erwartungen an die Standardseitengröße für firstPartyAndPartnerAudiences.list-Anfragen von 100 bis 5.000 Elementen.
• Verweise auf das Feld firstAndThirdPartyAudienceType in Version 3 auf das neue Feld firstPartyAndPartnerAudienceType in Version 4 mit dem neuen Enum-Typ FirstPartyAndPartnerAudienceType, 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-Enum-Wert LICENSED sollten stattdessen einen der folgenden neuen, spezifischeren Werte verwenden:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Verweise auf AssignedTargetingOption-Ressourcen von TargetingType TARGETING_TYPE_AUDIENCE_GROUP zum Ersetzen der v3-Felder in AudienceGroupAssignedTargetingOptionDetails durch die folgenden neuen v4-Felder:

  • excludedFirstAndThirdPartyAudienceGroup mit excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups mit includedFirstPartyAndPartnerAudienceGroups

Vorhandene Bulk-Listenanfragen für das Targeting von Anzeigengruppen aktualisieren

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

Optimierungsziel beim Erstellen von Anzeigenaufträgen angeben

optimizationObjective ist jetzt ein Pflichtfeld in der Ressource InsertionOrder. Aktualisieren Sie Ihre advertisers.insertionOrders.create-Anfragen, um zu prüfen, ob dieses Feld festgelegt ist.

Entfernen Sie Verweise auf das Creative-Ressourcenfeld publisherReviewStatuses.

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