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
iYoutubeAdGroupAd
zostały zastąpione zasobamiAdGroup
iAdGroupAd
. 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ówYoutubeAdGroup
lubYoutubeAdGroupAd
zasobamiAdGroup
iAdGroupAd
oraz zaktualizuj wywołania następujących usług w wersji 2, aby odpowiadały odpowiedniej usłudze w wersji 3:advertisers.youtubeAdGroupAds
doadvertisers.adGroupAds
advertisers.youtubeAdGroups
doadvertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
–advertisers.adGroups.targetingTypes.assignedTargetingOptions
- Odniesienia do obiektów
YoutubeAndPartnersBiddingStrategy
zostały przeniesione do nowego polayoutubeAndPartnersBid
w ogólnym obiekcieBiddingStrategy
. PolebiddingStrategy
zostało usunięte z obiektuYoutubeAndPartnersSettings
. Zaktualizuj integrację, aby pobierać strategię ustalania stawek na potrzeby elementów zamówienia lub grup reklam YouTube z obiektuBiddingStrategy
w polubidStrategy
w zasobieLineItem
lubAdGroup
. - Nazwa pola
thirdPartyMeasurementSettings
w obiekcieYoutubeAndPartnersSettings
została zmieniona nathirdPartyMeasurementConfigs
, a obiektYoutubeAndPartnersThirdPartyMeasurementSettings
– naThirdPartyMeasurementConfigs
. 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 zasobuInsertionOrder
, 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.