Migracja z wersji 2 do 3

Ostatnia aktualizacja: 31.10.2023

Migracja aplikacji

Migracja 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ędnić zmiany powodujące przerwanie działania.

Aktualizowanie wywołań interfejsu API z wersji 2 na wersję 3

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

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 tego:

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

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

Wprowadzanie wymaganych zmian

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

Zaktualizuj wywołania, 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 zawierają informacje niemal identyczne jak zasoby w wersji 2, ale mogą używać zaktualizowanych nazw pól lub typów enumeracji. W integracji zastąp zasoby YoutubeAdGroup lub YoutubeAdGroupAd zasobami AdGroup i AdGroupAd oraz zaktualizuj wywołania tych usług w wersji 2 na wywołania odpowiednich usług w wersji 3:
- advertisers.youtubeAdGroupAds na advertisers.adGroupAds
- advertisers.youtubeAdGroups na advertisers.adGroups
- advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions na 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 zasobach LineItem lub AdGroup.
Nazwa pola thirdPartyMeasurementSettings została zmieniona na thirdPartyMeasurementConfigs w obiekcie YoutubeAndPartnersSettings, a nazwa obiektu YoutubeAndPartnersThirdPartyMeasurementSettings została zmieniona na ThirdPartyMeasurementConfigs. Zaktualizuj integrację, aby pobierać informacje o konfiguracji pomiarów zewnętrznych za pomocą nowego pola i obiektu.

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 partnera nadrzędnego można pobrać w nowym polu Partner zasobu billingConfig.

Używanie nowego pola do kontrolowania kierowania zoptymalizowanego

W obiekcie TargetingExpansionConfig zostało zastąpione nowe pole logiczne enableOptimizedTargeting polem targetingExpansionLevel.

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 typów.

Usuwanie odwołań do wycofanych usług i pól

W wersji 3 usunięto różne elementy, aby dostosować je do wcześniejszych wycofań funkcji:

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

Dodatkowe zmiany

Oprócz zmian o charakterze łamiącym kompatybilność wymienionych powyżej wersja 3 zawiera też nowe funkcje.

Funkcje dodane do wersji 3 po jej pierwszym udostępnieniu można znaleźć w notatkach do wersji.

Zarządzanie listą lokalizacji zbliżonych

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 partner nie znajduje się na liście dozwolonych, żądanie zwróci błąd.