Najczęstsze pytania

Ogólne

Jaka jest najnowsza wersja interfejsu API?

Najnowsza wersja interfejsu API, do której odnosi się ten dokument, to v3.

Czy mogę pobierać dane o skuteczności przy użyciu tego interfejsu API?

Nie. Do tworzenia, pobierania i generowania raportów offline z Display & Video 360 używaj interfejsu Bid Manager API.

Korzystanie z interfejsu API

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

https://displayvideo.googleapis.com

Jakie metody uwierzytelniania są obsługiwane?

Jedyną obsługiwaną metodą uwierzytelniania jest OAuth 2.0.

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

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

Żądania wysyłane do usługi users muszą też być autoryzowane w tym zakresie dodatkowym:

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

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

Zapoznaj się z przewodnikiem po bibliotece klienta.

Co zrobić, jeśli nie chcę korzystać z biblioteki klienta?

Zalecamy użycie jednej z naszych bibliotek klienta, ale z interfejsem Display & Video 360 API możesz też korzystać za pomocą bezpośrednich żądań HTTP.

Niektóre bardziej wymagające metody, takie jak advertisers.assets.upload i media.upload, są trudniejsze do przełożenia bezpośrednio na żądania HTTP. Przykłady żądań HTTP wysyłanych do tych metod za pomocą cURL znajdziesz w przewodnikach dotyczących kreacji i ustalania stawek niestandardowych.

Jakie uprawnienia w Display & Video 360 są mi potrzebne?

Aby korzystać z interfejsu Display & Video 360 API, konto Google uwierzytelniające musi być użytkownikiem Display & Video 360 z dostępem do odpowiednich partnerów lub reklamodawców.

Aby odpowiedni partnerzy lub reklamodawcy mogli wykonywać te czynności, użytkownik Display & Video 360 musi mieć jedną z tych ról:

  • Tylko do odczytu: pobieraj zasoby za pomocą wywołań get lub list (z wyjątkiem zasobów user).
  • Standardowy: pobieranie, tworzenie i aktualizowanie zasobów. Pobierz user zasobów z uprawnieniami tym samym partnerom lub reklamodawcom.
  • Administrator: pobieranie, tworzenie i aktualizowanie zasobów. Pobieraj, twórz i przyznawaj dostęp do zasobów user na potrzeby zarządzanych przez Ciebie partnerów lub reklamodawców.

Jak aktualizować zasoby YouTube i sieci partnerów wideo Google za pomocą interfejsu API?

Interfejs Display & Video 360 API nie obsługuje tworzenia ani aktualizowania zasobów dotyczących YouTube i sieci partnerów wideo Google. Zbiorcze tworzenie i aktualizowanie zasobów YouTube i sieci partnerów wideo Google przez przesłanie plików uporządkowanych danych (SDF) w interfejsie Display & Video 360. Więcej informacji o korzystaniu z przesyłania SDF znajdziesz w przewodniku z materiałami dotyczącymi YouTube i sieci partnerów wideo Google.

Jak kierować reklamy na lokalizacje geograficzne?

Kierowanie geograficzne można przypisać do elementów zamówienia, korzystając z 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 pierwszych 3 typów kierowania za pomocą parametru targetingTypes.targetingOptions.search. Pobieranie zasobów listy lokalizacji i zarządzanie nimi przy użyciu usługi advertisers.locationLists.

Możesz też utworzyć identyfikator opcji kierowania TARGETING_TYPE_POI, aby kierować reklamy bezpośrednio na obszar o określonym promieniu wokół określonych współrzędnych szerokości i długości geograficznej.

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

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

Pomoc

Czy z interfejsem API są znane jakieś problemy lub ograniczenia?

Istnieją limity liczby żądań, które może przesłać projekt na sekundę. Zostały one opisane w naszym przewodniku po limitach wykorzystania.