Migracja z wersji 2 do 3

Ostatnia aktualizacja: 31.10.2023

Migracja aplikacji

Migracja z wersji 2 do wersji 3 wymaga zaktualizowania adresów URL punktów końcowych tak, aby wywoływały wersję 3, oraz zaktualizowania aplikacji pod kątem zmian powodujących niezgodność.

Zaktualizuj wywołania interfejsu API z wersji 2 do 3

Aby używać wersji 3 zamiast wersji 2, musisz zaktualizować żądania, aby używały nowych punktów końcowych w wersji 3.

Aby na przykład wywołać metodę advertisers.get za pomocą wersji 2, użyj tego adresu URL:

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

W przypadku wersji 3 zaktualizuj adres URL do takiego adresu:

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

Jeśli do wysyłania żądań do interfejsu API używasz biblioteki klienta, użyj najnowszej wersji biblioteki klienta i zaktualizuj konfigurację tak, aby używała wersji 3.

Wprowadzanie wymaganych zmian

Wprowadzamy w wersji 3 zmiany powodujące niezgodność. Zapoznaj się z podanymi niżej instrukcjami i wprowadź wymagane zmiany związane z dotychczasowym korzystaniem z interfejsu Display & Video 360 API.

Zaktualizuj połączenia, które pobierają zasoby YouTube i powiązane z nimi ustawienia kierowania

• Zasoby YoutubeAdGroup i YoutubeAdGroupAd zostały zastąpione zasobami AdGroup i AdGroupAd. Te nowe zasoby dostarczają niemal identyczne informacje jak zasoby w wersji 2, ale mogą korzystać ze zaktualizowanych nazw pól lub typów wyliczeniowych. W ramach integracji zastąp wykorzystanie zasobów YoutubeAdGroup lub YoutubeAdGroupAd zasobami AdGroup i AdGroupAd oraz zaktualizuj wywołania następujących usług w wersji 2, aby odpowiadały odpowiedniej usłudze w wersji 3:
  • advertisers.youtubeAdGroupAds do advertisers.adGroupAds
  • advertisers.youtubeAdGroups do advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions – advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Odniesienia do obiektów YoutubeAndPartnersBiddingStrategy zostały przeniesione do nowego pola youtubeAndPartnersBid w ogólnym obiekcie BiddingStrategy. Pole biddingStrategy zostało usunięte z obiektu YoutubeAndPartnersSettings. Zaktualizuj integrację, aby pobierać strategię ustalania stawek na potrzeby elementów zamówienia lub grup reklam YouTube z obiektu BiddingStrategy w polu bidStrategy w zasobie LineItem lub AdGroup.
• Nazwa pola thirdPartyMeasurementSettings w obiekcie YoutubeAndPartnersSettings została zmieniona na thirdPartyMeasurementConfigs, a obiekt YoutubeAndPartnersThirdPartyMeasurementSettings – na ThirdPartyMeasurementConfigs. Zaktualizuj integrację, aby za pomocą nowego pola i obiektu pobierać informacje o konfiguracji zewnętrznej usługi pomiarowej.

Podczas tworzenia reklamodawców uwzględnij wymagane konfiguracje płatności

Pole billingConfig jest teraz wymagane w zasobie Advertiser. Zaktualizuj żądania advertisers.create, aby sprawdzić, czy to pole jest ustawione. Domyślne informacje rozliczeniowe można pobierać dla partnera nadrzędnego za pomocą nowego pola zasobu Partner billingConfig.

Użyj nowego pola, aby kontrolować kierowanie zoptymalizowane

Nowe pole wartości logicznej enableOptimizedTargeting zastąpiło pole targetingExpansionLevel w obiekcie TargetingExpansionConfig.

Zaktualizuj integrację zamówienia reklamowego, aby użyć nowego pola KPI

Nowe pole kpi zastąpiło pole performanceGoal w zasobie InsertionOrder. To nowe pole używa obiektu Kpi zamiast obiektu PerformanceGoal oraz wykorzystuje nowe pola i wyliczenia.

Usuń odwołania do wycofanych usług i pól

W wersji 3 usunęliśmy różne elementy, aby dostosować je do wycofanych funkcji:

• Usługa advertisers.manualTriggers została usunięta, ponieważ reguły ręczne zostały wycofane.
• Pole billableOutcome zostało usunięte z zasobu InsertionOrder, ponieważ kupowanie na podstawie wyników zostało wycofane.

Dodatkowe zmiany

Oprócz wymienionych powyżej zmian powodujących niezgodność wersja 3 wprowadza też nowe funkcje.

Funkcje dodane do wersji 3 po jej opublikowaniu znajdziesz w informacjach o wersji.

Zarządzanie listą pobliskich lokalizacji

W wersji 3 możesz w pełni zarządzać listami zbliżonych lokalizacji, co pozwala używać usługi advertisers.locationLists.assignedLocations do tworzenia i usuwania lokalizacji przypisanych do zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Lokalizacje określa się na podstawie identyfikatorów zasobów TARGETING_TYPE_POI TargetingOption. Można je pobrać za pomocą narzędzia targetingTypes.targetingOptions.search.

Możliwość tworzenia algorytmów ustalania stawek niestandardowych na podstawie reguł

W wersji 3 możesz tworzyć i pobierać algorytmy ustalania stawek niestandardowych na podstawie reguł za pomocą usług customBiddingAlgorithms, media i customBiddingAlgorithms.rules.

Ta funkcja jest w wersji beta i jest dostępna tylko dla partnerów z listy dozwolonych. Jeśli Twojego partnera nie ma na liście dozwolonych, żądanie zwróci błąd.