Von Version 2 zu Version 3 migrieren

Letzte Aktualisierung: 31.10.2023

Anwendung migrieren

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

API-Aufrufe von Version 2 auf Version 3 aktualisieren

Wenn Sie v3 anstelle von v2 verwenden möchten, müssen Sie Ihre Anfragen aktualisieren, um neue v3-Endpunkte zu verwenden.

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

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

Aktualisieren Sie die URL für v3 wie folgt:

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

Wenn Sie Anfragen an die API über eine Clientbibliothek senden, verwenden Sie die neueste Version und aktualisieren Sie Ihre Konfiguration auf Version 3.

Erforderliche Änderungen ausführen

In Version 3 wurden mehrere funktionsgefährdende Änderungen eingeführt. Lesen Sie die folgende Anleitung und nehmen Sie die erforderlichen Änderungen für Ihre vorhandene Verwendung der Display & Video 360 API vor.

Anrufe aktualisieren, bei denen YouTube-Ressourcen und die zugehörige Ausrichtung abgerufen werden

• Ressourcen YoutubeAdGroup und YoutubeAdGroupAd wurden durch die Ressourcen AdGroup und AdGroupAd ersetzt. Diese neuen Ressourcen bieten nahezu identische Informationen wie die Ressourcen von V2, können aber aktualisierte Feldnamen oder Enum-Typen verwenden. Ersetzen Sie in Ihrer Integration die Verwendung von YoutubeAdGroup- oder YoutubeAdGroupAd-Ressourcen durch AdGroup- und AdGroupAd-Ressourcen und aktualisieren Sie Aufrufe der folgenden V2-Dienste auf den entsprechenden V3-Dienst:
  • advertisers.youtubeAdGroupAds nach advertisers.adGroupAds
  • advertisers.youtubeAdGroups nach advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions bis advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Verweise auf YoutubeAndPartnersBiddingStrategy-Objekte wurden in ein neues youtubeAndPartnersBid-Feld innerhalb des allgemeinen BiddingStrategy-Objekts verschoben. Das Feld biddingStrategy wurde aus dem Objekt YoutubeAndPartnersSettings entfernt. Aktualisieren Sie Ihre Integration, um die Gebotsstrategie für YouTube-Werbebuchungen oder -Anzeigengruppen aus dem Objekt BiddingStrategy im Feld bidStrategy der Ressource LineItem oder AdGroup abzurufen.
• Das Feld thirdPartyMeasurementSettings wurde im Objekt YoutubeAndPartnersSettings in thirdPartyMeasurementConfigs und das Objekt YoutubeAndPartnersThirdPartyMeasurementSettings in ThirdPartyMeasurementConfigs umbenannt. Aktualisieren Sie Ihre Integration, um mit dem neuen Feld und Objekt Informationen zur Konfiguration von Analyselösungen von Drittanbietern abzurufen.

Erforderliche Abrechnungskonfigurationen beim Erstellen von Werbetreibenden einschließen

billingConfig ist jetzt ein Pflichtfeld in der Ressource Advertiser. Prüfen Sie in Ihren advertisers.create-Anfragen, ob dieses Feld festgelegt ist. Die standardmäßigen Abrechnungsinformationen können für den übergeordneten Partner über das neue Feld der Partner-Ressource billingConfig abgerufen werden.

Optimiertes Targeting mit neuem Feld steuern

Das Feld targetingExpansionLevel im Objekt TargetingExpansionConfig wurde durch ein neues boolesches Feld enableOptimizedTargeting ersetzt.

Anzeigenauftragsintegration aktualisieren, um neues KPI-Feld zu verwenden

Das Feld performanceGoal in der Ressource InsertionOrder wurde durch das neue Feld kpi ersetzt. Dieses neue Feld verwendet ein Kpi-Objekt anstelle des PerformanceGoal-Objekts sowie neue Felder und Enums.

Verweise auf eingestellte Dienste und Felder entfernen

In Version 3 wurden verschiedene Entitäten entfernt, um der Funktion in der Vergangenheit gerecht zu werden, die verworfen wurden:

• Der Dienst advertisers.manualTriggers wurde entfernt, da manuelle Trigger verworfen wurden.
• Das Feld billableOutcome wurde aus der Ressource InsertionOrder entfernt, da ergebnisbasierte Käufe eingestellt wurden.

Weitere Änderungen

Zusätzlich zu den oben aufgeführten funktionsgefährdenden Änderungen werden in Version 3 neue Funktionen eingeführt.

Funktionen, die nach der Ersteinführung in Version 3 hinzugefügt wurden, finden Sie in unseren Versionshinweisen.

Listen mit Umgebungsstandorten verwalten

In Version 3 können Sie Listen mit Umgebungen vollständig verwalten, sodass Sie mit dem Dienst advertisers.locationLists.assignedLocations Standorte erstellen und löschen können, die TARGETING_LOCATION_TYPE_PROXIMITY LocationList-Ressourcen zugewiesen sind. Standorte werden über die ID von TARGETING_TYPE_POI TargetingOption-Ressourcen identifiziert. Diese können mit targetingTypes.targetingOptions.search abgerufen werden.

Regelbasierte Algorithmen für die benutzerdefinierte Gebotseinstellung erstellen

In Version 3 können Sie regelbasierte Algorithmen für die benutzerdefinierte Gebotseinstellung mit den Diensten customBiddingAlgorithms, media und customBiddingAlgorithms.rules erstellen und abrufen.

Diese Funktion befindet sich in der Betaphase und ist nur für Partner auf der Zulassungsliste verfügbar. Wenn Ihr Partner nicht auf der Zulassungsliste steht, gibt Ihre Anfrage einen Fehler zurück.