Migracja z interfejsu Display & Video 360 API w wersji 4 do wersji 5

Ostatnia aktualizacja: 22 października 2026 r.

Ostrzeżenie: wersja 5 jest w otwartej wersji beta. W wersji 5 mogą zostać wprowadzone zmiany powodujące niezgodność, gdy będzie ona w fazie beta. Zostaną one wymienione w informacjach o wersji interfejsu Display & Video 360 API. Ten dokument będzie aktualizowany w miarę potrzeb, aby odzwierciedlał aktualną wersję beta.

Migracja aplikacji

Migracja z wersji 4 do wersji 5 wymaga zaktualizowania adresów URL punktów końcowych, aby wywoływały wersję 5, zaktualizowania aplikacji w celu uwzględnienia zmian powodujących niezgodność oraz sprawdzenia nowych funkcji, które mogą być przydatne w integracji.

Aktualizowanie wywołań interfejsu API z wersji 4 do wersji 5

Aby używać wersji 5 zamiast wersji 4, musisz zaktualizować żądania, aby korzystały z nowych punktów końcowych wersji 5.

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

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

W przypadku wersji 5 zaktualizuj adres URL w ten sposób:

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

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

Wprowadzanie wymaganych zmian

Display & Video 360 API w wersji 5 wprowadza szereg zmian powodujących niezgodność. Zapoznaj się z poniższymi instrukcjami i wprowadź wymagane zmiany, które są istotne dla Twojego obecnego sposobu korzystania z interfejsu Display & Video 360 API.

Pełną listę różnic między interfejsem Display & Video 360 API w wersji 4 i 5 znajdziesz w informacjach o wersji.

Zaktualizuj pobieranie źródeł zasobów reklamowych i kierowanie na nie, aby używać nowych identyfikatorów i typów.

Display & Video 360 API w wersji 5 zmienia sposób pobierania umów dotyczących źródeł zasobów reklamowych i pakietów aukcji oraz kierowania na nie reklam.

W wersji 4 zasoby InventorySource pobrane za pomocą usługi inventorySources reprezentują zarówno umowy dotyczące źródeł zasobów reklamowych, jak i pakiety aukcji. Zarówno umowy, jak i pakiety aukcji są kierowane za pomocą TARGETING_TYPE_INVENTORY_SOURCE.

W wersji 5 umowy dotyczące źródeł zasobów reklamowych i pakiety aukcji są obsługiwane oddzielnie:

• Umowy dotyczące źródła zasobów reklamowych są kierowane za pomocą TARGETING_TYPE_INVENTORY_SOURCE_DEAL, pobierane za pomocą usług advertisers.inventorySources i partners.inventorySources oraz kierowane za pomocą pola AssignedTargetingOption inventorySourceDetails.
• Pakiety aukcji są kierowane za pomocą TARGETING_TYPE_AUCTION_PACKAGE, pobierane za pomocą usługi targetingTypes.targetingOptions i kierowane za pomocą pola AssignedTargetingOption auctionPackageDetails.

Ta aktualizacja zmienia identyfikatory używane w przypadku dotychczasowych umów i pakietów aukcji, więc po migracji nie będzie można używać żadnych wcześniej zapisanych w pamięci podręcznej identyfikatorów zasobów InventorySource.

Oprócz tych zmian w wersji 5 usunęliśmy też możliwość tworzenia, aktualizowania i edytowania akcesorów źródeł zasobów reklamowych.

Aktualizacja logiki kierowania na odbiorców w przypadku zasobów kampanii generujących popyt i zasobów YouTube

W interfejsie Display & Video 360 API w wersji 5 zaktualizowaliśmy logikę kierowania na odbiorców w przypadku zasobów kampanii generujących popyt i zasobów YouTube, aby używać poszczególnych przypisanych opcji na każdej liście odbiorców, na którą kierowane są reklamy.

W interfejsie API w wersji 4 całym kierowaniem na odbiorców zarządza się za pomocą TARGETING_TYPE_AUDIENCE_GROUP.

W wersji 5 kierowanie na odbiorców przypisane do grup reklam generujących popyt i grup reklam w YouTube jest zarządzane za pomocą jednego z tych typów kierowania i pól zasobów AssignedTargetingOption, w zależności od typu odbiorców:

• TARGETING_TYPE_COMBINED_AUDIENCE za pomocą combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST za pomocą customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE za pomocą firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE za pomocą googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE za pomocą lookalikeAudienceDetails

Elementy zamówienia będą nadal używać jednego TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption do zarządzania kierowaniem na odbiorców wszystkich typów.

Przejście na interfejs Data Manager API na potrzeby zarządzania odbiorcami kierowania na listę klientów

Display & Video 360 API w wersji 5 nie umożliwia już tworzenia list odbiorców kierowania na listę klientów ani zarządzania ich członkostwem, ponieważ usunięto te metody:

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

Aby nadal zarządzać odbiorcami kierowania na listę klientów, zaktualizuj swoje procesy, aby korzystać z interfejsu Data Manager API.

Dodawanie obsługi pobierania zamówień reklamowych dotyczących cyfrowych reklam zewnętrznych

Display & Video 360 API w wersji 5 obsługuje pobieranie zamówień reklamowych na cyfrowe reklamy zewnętrzne.

Jeśli Twoi reklamodawcy korzystają z cyfrowych reklam zewnętrznych, uaktualnij wszystkie integracje wywołujące advertisers.insertionOrders.list, aby uwzględnić zasoby InsertionOrder z wartością pola insertionOrderType równą OUT_OF_HOME.

W wersji 5 elementy zamówienia w zamówieniach reklamowych na cyfrowe reklamy zewnętrzne będą nadal pobierane tak samo jak w wersji 4.

Aktualizacja odniesień do Adloox na Peer39

W wersji 5 pola i wartości wyliczeniowe odwołujące się do integracji Display & Video 360 z firmą Adloox (nazywaną też Scope3) w zakresie dopasowania do marki zostały zaktualizowane do Peer39:

• Pole ThirdPartyVerifierAssignedTargetingOptionDetails adloox zostało zastąpione przez peer39.
• Wartości enum PARTNER_COST_TYPE_ADLOOX i PARTNER_COST_TYPE_ADLOOX_PREBID w PartnerCostType zostały zastąpione przez PARTNER_COST_TYPE_PEER39 i PARTNER_COST_TYPE_PEER39_PREBID.

Aktualizowanie pól elementów zamówienia, grup reklam i reklam w YouTube

W wersji 5 usunęliśmy lub zaktualizowaliśmy różne pola w zasobach LineItem, AdGroup i AdGroupAd. Zaktualizuj logikę pobierania zasobów, aby uwzględnić te zmiany.

W zasobie LineItem:

• Pole YoutubeAndPartnersSettings relatedVideoIds zostało zastąpione przez relatedVideos.

W zasobach LineItem i AdGroup:

• Pola TargetingExpansionConfig audienceExpansionSeedListExcluded i audienceExpansionLevel zostały usunięte.

W zasobie AdGroupAd:

• Dodano pole containsSyntheticMedia.
• Pole trackingUrl w obiektach AudioAd, CommonInStreamAttribute i VideoPerformanceAd zostało podzielone na 2 pola: trackingUrl i userSpecifiedTrackingUrl, aby odróżnić adres URL używany do śledzenia od linku monitorującego określonego przez użytkownika.

Usuwanie odwołań do wycofanych wartości typu wyliczeniowego

W wersji 5 usunęliśmy wcześniej wycofane wartości enum. Użycie tych wartości w żądaniach do interfejsu API powodowało błąd w wersji 4, ale ta zmiana usuwa wszelkie odwołania do nich z bibliotek klienta w wersji 5. Wszelkie odwołania do tych wycofanych wartości w kodzie mogą powodować błędy podczas uaktualniania do wersji 5.

Typy wyliczeniowe, które mają wartości, na które ma to wpływ, to m.in. ContentRatingTier, GoogleAudienceType, SdfVersion i SensitiveCategory. Pełną listę wszystkich usuniętych wartości typu wyliczeniowego znajdziesz w informacjach o wersji.

Sprawdzanie nowych funkcji

Oprócz zmian powodujących niezgodność wersja 5 wprowadza też te nowe funkcje:

• Pełne zarządzanie kierowaniem na wykluczenia filmów i kanałów w YouTube na poziomie reklamodawcy w ramach typów kierowania TARGETING_TYPE_YOUTUBE_VIDEO i TARGETING_TYPE_YOUTUBE_CHANNEL. W wersji 4 to kierowanie było tylko do odczytu.
• Możliwość tworzenia zasobów cyfrowych reklam zewnętrznych InsertionOrder.
• Obsługa grup reklam, które używają przypisanych kreacji do generowania reklam, dzięki dodaniu pól AdGroup adSource i creativeAssignments oraz pola AdGroupAd parentCreativeId.
• Możliwość tworzenia i pobierania zasobów LookalikeAudience.
• Nowe pole containsSyntheticMedia w zasobie AdGroupAd.