Najczęstsze pytania

Ogólne

Jaka jest najnowsza wersja interfejsu API?

Najnowsza wersja interfejsu API, której dotyczy ten dokument, to v4.

Czy za pomocą tego interfejsu API mogę pobierać dane o skuteczności?

Nie. Do tworzenia, pobierania i uruchamiania raportów Display & Video 360 offline służy interfejs Bid Manager API.

Korzystanie z interfejsu API

Jakiego adresu URL używam, aby uzyskać dostęp do interfejsu API?

https://displayvideo.googleapis.com

Jakie metody uwierzytelniania są obsługiwane?

OAuth 2.0 to jedyna obsługiwana metoda uwierzytelniania.

Żądania do interfejsu Display & Video 360 API muszą być autoryzowane w ramach tego zakresu:

  • https://www.googleapis.com/auth/display-video

Prośby kierowane do usługi users muszą też być autoryzowane w ramach tego dodatkowego zakresu:

  • https://www.googleapis.com/auth/display-video-user-management

Chcę pisać kod. Gdzie znajdę biblioteki klienta?

Zapoznaj się z przewodnikiem po bibliotece klienta.

Co zrobić, jeśli nie chcę używać biblioteki klienta?

Zalecamy użycie jednej z naszych bibliotek klienta, ale możesz też wchodzić w interakcję z interfejsem Display & Video 360 API, wysyłając bezpośrednie żądania HTTP.

Niektóre bardziej złożone metody, takie jak advertisers.assets.upload i media.upload, trudniej jest przekształcić bezpośrednio w żądania HTTP. Przykłady żądań HTTP do tych metod za pomocą cURL znajdziesz w instrukcjach dotyczących kreacji i określania stawek niestandardowych.

Jakich uprawnień do Display & Video 360 potrzebuję?

Aby korzystać z interfejsu API Display & Video 360, uwierzytelniające konto Google musi należeć do użytkownika Display & Video 360, który ma dostęp do odpowiednich partnerów lub reklamodawców.

Aby móc wykonywać te czynności, użytkownik Display & Video 360 musi mieć jedną z tych ról użytkownika w przypadku odpowiednich partnerów lub reklamodawców:

  • Tylko do odczytu: umożliwia pobieranie zasobów za pomocą wywołań get lub list z wyjątkiem zasobów user.
  • Standardowy: umożliwia pobieranie, tworzenie i aktualizowanie zasobów. Pobieraj zasoby user z uprawnieniami do tych samych partnerów lub reklamodawców.
  • Administrator: umożliwia pobieranie, tworzenie i aktualizowanie zasobów. Pobierać, tworzyć i przyznawać dostęp do zasobów user partnerom lub reklamodawcom, którymi zarządzasz.

Jak zaktualizować zasoby dotyczące YouTube i sieci partnerów za pomocą interfejsu API?

Interfejs Display & Video 360 API nie obsługuje tworzenia ani aktualizowania zasobów YouTube & Partners. Tworzenie i aktualizowanie zasobów YouTube i partnerów zbiorczo przez przesłanie plików uporządkowanych danych (SDF) w interfejsie Display & Video 360. Więcej informacji o przesyłaniu plików SDF znajdziesz na stronie z przewodnikiem dotyczącą zasobów YouTube i partnerów.

Jak kierować reklamy na lokalizacje geograficzne?

Kierowanie geograficzne można przypisać do elementów zamówienia za pomocą tych typów kierowania:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Pobierz identyfikatory opcji kierowania dla 3 pierwszych typów kierowania za pomocą targetingTypes.targetingOptions.search. Pobieraj zasoby listy lokalizacji i zarządzaj nimi za pomocą usługi advertisers.locationLists.

Możesz też utworzyć opcję kierowania TARGETING_TYPE_POIID, aby kierować reklamy bezpośrednio na obszar wokół określonych współrzędnych geograficznych.

Widzę, że mogę pobrać pliki uporządkowanych danych (SDF) za pomocą interfejsu API, ale jak je przesłać?

Interfejs API Display & Video 360 nie obsługuje przesyłania plików SDF. Zalecamy zarządzanie zasobami za pomocą metod CREATE, PATCH i DELETE udostępnionych przez interfejs API. Jeśli nadal chcesz zarządzać zasobami za pomocą plików SDF, możesz je aktualizować w interfejsie Display & Video 360.

Pomoc

Czy istnieją jakieś znane problemy lub ograniczenia dotyczące interfejsu API?

Liczba żądań, które projekt może wysyłać w sekundzie, jest ograniczona. Limity te zostały opisane w przewodniku dotyczącym limitów wykorzystania.