Migracja z wersji 2 do 3

Ostatnia aktualizacja: 31.10.2023

Migracja aplikacji

Przejście z wersji 2 na wersję 3 wymaga zaktualizowania adresów URL punktów końcowych, aby wywoływać wersję 3, oraz zaktualizowania aplikacji, aby uwzględniała zmiany powodujące niezgodność.

Aktualizowanie wywołań interfejsu API z wersji 2 do wersji 3

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

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

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

W przypadku wersji 3 zaktualizuj adres URL do następującego:

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ę, aby korzystać z wersji 3.

Wprowadzanie wymaganych zmian

W wersji 3 wprowadzamy szereg zmian powodujących niezgodność. Zapoznaj się z tymi instrukcjami i wprowadź wymagane zmiany w sposobie, w jaki korzystasz z interfejsu Display & Video 360 API.

Aktualizowanie wywołań pobierających zasoby YouTube i powiązane z nimi kierowanie

• Zasoby YoutubeAdGroup i YoutubeAdGroupAd zostały zastąpione zasobami AdGroup i AdGroupAd. Te nowe zasoby zawierają niemal identyczne informacje jak zasoby w wersji 2, ale mogą używać zaktualizowanych nazw pól lub typów wyliczeniowych. W integracji zastąp używane zasoby YoutubeAdGroup lub YoutubeAdGroupAd zasobami AdGroup i AdGroupAd oraz zaktualizuj wywołania tych usług w wersji 2, aby korzystać z odpowiednich usług w wersji 3:
  • advertisers.youtubeAdGroupAds do advertisers.adGroupAds
  • advertisers.youtubeAdGroups do advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions–advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Odwołania 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 dla elementów zamówienia lub grup reklam w YouTube z obiektu BiddingStrategy w polu bidStrategy w zasobie LineItem lub AdGroup.
• Pole thirdPartyMeasurementSettings zostało zmienione na thirdPartyMeasurementConfigs w obiekcie YoutubeAndPartnersSettings, a obiekt YoutubeAndPartnersThirdPartyMeasurementSettings został zmieniony na ThirdPartyMeasurementConfigs. Zaktualizuj integrację, aby pobierać informacje o konfiguracji pomiarów zewnętrznych za pomocą nowego pola i obiektu.

Podczas tworzenia reklamodawców uwzględniaj 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 pobrać dla partnera nadrzędnego za pomocą nowego pola zasobu Partner billingConfig.

Używanie nowego pola do kontrolowania kierowania zoptymalizowanego

Nowe pole logiczne enableOptimizedTargeting zastąpiło pole targetingExpansionLevel w obiekcie TargetingExpansionConfig.

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

W zasobie InsertionOrder pole performanceGoal zostało zastąpione nowym polem kpi. To nowe pole używa obiektu Kpi zamiast obiektu PerformanceGoal oraz nowych pól i wyliczeń.

Usuwanie odniesień do wycofanych usług i pól

W wersji 3 usunięto różne elementy, aby dostosować ją do wycofanych w przeszłości funkcji:

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

Dodatkowe zmiany

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

Funkcje dodane do wersji 3 po jej początkowym wprowadzeniu znajdziesz w naszych informacjach o wersji.

Zarządzanie listą lokalizacji w pobliżu

W wersji 3 możesz w pełni zarządzać listami lokalizacji zbliżonych, co pozwala Ci używać usługi advertisers.locationLists.assignedLocations do tworzenia i usuwania lokalizacji przypisanych do zasobów TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Lokalizacje są identyfikowane za pomocą identyfikatora zasobów TARGETING_TYPE_POI TargetingOption. Można je pobrać za pomocą 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 oparte na regułach 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 Twój partner nie znajduje się na liście dozwolonych, żądanie zwróci błąd.