Błędy i ostrzeżenia

Na tej stronie opisujemy różne typy błędów i ostrzeżeń, które mogą wystąpić podczas korzystania z Display & Display & Video 360 Interfejs Video 360 API.

Błędy API

Żądania wysyłane do interfejsu API, których nie można zrealizować, zwracają komunikat o błędzie. Żądania, które zwracają błędy, wliczają się do limitu użytkownika i są brane pod uwagę które uwzględniamy przy rozpatrywaniu próśb o zwiększenie limitu. Odpowiedzi na błędy powinny zostać przetworzone i obsłużone, aby uniknąć błędów w przyszłości.

Odpowiedź błędu ma następujący format i zawiera kod odpowiedzi HTTP: komunikat o błędzie i stan kodu RPC Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Poniżej znajdziesz listę typowych błędów interfejsu API wraz z zalecanymi działaniami .

Kod RPC Zalecane działanie
400 INVALID_ARGUMENT Wystąpił problem z Twoją prośbą. Zapoznaj się z w polu komunikatu w odpowiedzi na błąd i zmodyfikować Państwa prośbę.
401 UNAUTHENTICATED Nie udało się poprawnie uwierzytelnić Twojego żądania. Sprawdź, czy uwzględniasz prawidłowy protokół OAuth dane logowania w Twoim żądaniu. Więcej informacji na temat konfiguracji w tej sprawie, zapoznaj się z naszymi Przewodnik dla początkujących
403 PERMISSION_DENIED Nie masz uprawnień wymaganych do ukończenia na Twoją prośbę. Sprawdź, czy Twoje konto użytkownika ma odpowiednie uprawnienia odpowiedniego partnera lub reklamodawcy.
404 NOT_FOUND Zasób, który próbujesz pobrać, nie może można było znaleźć. Sprawdź, czy używany przez Ciebie dokument tożsamości to oraz typ pobieranego zasobu.
409 ABORTED Zasób, który próbujesz zmodyfikować, jest zmodyfikowane w innym miejscu. Zaczekaj kilka sekund ponów próbę.
429 RESOURCE_EXHAUSTED Przekroczono limit limit liczby żądań lub dzienny limit żądań. Sprawdź wykorzystanie interfejsu API za pomocą Konsolę interfejsów API Google i zmodyfikuj przepływ pracy, który działa w ramach istniejącego limitu i ograniczeniach. Więcej informacji znajdziesz na naszej stronie w sekcji Optymalizacja limitów.

Jeśli nie można ukończyć operacji w przy podanych limitach dziennych, żądanie dodatkowego limitu.
500 INTERNAL W interfejsie API wystąpił błąd wewnętrzny. Zaczekaj chwilę sekund i potem spróbuj ponownie. Jeśli błąd będzie się powtarzać, skontaktuj się z zespołem pomocy.
504 DEADLINE_EXCEEDED Realizacja żądania przez interfejs API trwała zbyt długo. Zaczekaj kilka sekund i spróbuj jeszcze raz. Jeśli błąd będzie się powtarzał, skontaktuj się z zespołem pomocy.

Błędy SDF

Wyświetlacz Interfejs Video 360 API używa metody asynchronicznej do generowania i pobierania plików uporządkowanych danych (SDF). Do tego celu powód, błędy zgłoszone podczas generowania pliku SDF są zwracane w gotowym pliku SDF. w zadaniu pobierania. Zadanie pobierania plików SDF, które kończy się w ciągu error, to oznaczono jako gotowe, ale zamiast nazwy zasobu multimediów zawiera wypełnione pole błędu w polu response, tak jak w tym skróconym przykładzie:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Jeśli podczas próby wygenerowania plików SDF pojawi się komunikat o błędzie z działaniem, należy postępować zgodnie z nim. Jeśli komunikat o błędzie nie daje podstaw do podjęcia działań w sposób jednoznaczny, zalecamy wykonanie tych czynności:

  • Sprawdź, czy użytkownik ma odpowiednie uprawnienia dla rodzica partnerów lub reklamodawców.
  • Sprawdź, czy identyfikatory podane w filtrze są prawidłowe. odpowiadają zamierzonemu typowi zasobu i są w kontekście dla danego identyfikatora głównego.
  • Sprawdź, czy nie przekraczasz limitu 20 jednoczesnych pobrań SDF zadań na użytkownika.

Jeśli błędy nadal występują, skontaktuj się z zespołem pomocy, aby je zgłosić. Twój problem.

Ostrzeżenia nieblokujące

Ostrzeżenia nieblokujące są przypisywane do elementów zamówienia, by sygnalizować, problem, który może mieć wpływ na wyświetlanie elementu zamówienia. Informowano o podobnych ostrzeżeniach w interfejsie za pomocą banera powiadomień. Te ostrzeżenia są pasywne i w polu warningMessages elementu zamówienia.

Choć problemy, które powodują takie ostrzeżenia, mogą wpływać na wyświetlanie elementu zamówienia do całkowitego zablokowania.

Profilaktyka

Wiele problemów, które powodują ostrzeżenia nieblokujące, można uniknąć, stosując odpowiednie konfigurację ustawień elementu zamówienia, w tym:

  • Wyświetlanie: jeśli okres wyświetlania elementu zamówienia jest nieprawidłowy lub upłynął okres wyświetlania nadrzędnego zamówienia reklamowego, element zamówienia wygeneruje i nie będą wyświetlane. Aby uniknąć tego drugiego problemu, upewnij się, że linia okres wyświetlania elementu nie kończy się później niż okres wyświetlania elementu nadrzędnego zamówienie.
  • Przypisane kreacje: jeśli nie ma prawidłowej kreacji. który zostanie przypisany do elementu zamówienia, wygeneruje on ostrzeżenie i nie będzie serwować.
  • Kierowanie: jeśli kierowanie elementu zamówienia nie jest element zamówienia może wygenerować ostrzeżenie, a wyświetlanie reklamy może lub całkowicie uniemożliwiono.

Jeśli replikujesz konfiguracje z istniejącego elementu zamówienia, upewnij się, że istniejący element zamówienia nie generuje nieprzewidzianych ostrzeżeń.

Monitorowanie

Problemy z ostrzeżeniami nieblokującymi mogą wystąpić, gdy element zamówienia jest realizowany lotu. Aby mieć pewność, że elementy zamówienia wyświetlają się prawidłowo, monitoruj aktywnych elementów zamówienia w przypadku nowo wygenerowanych ostrzeżeń. Można pobierać elementy zamówienia zbiorczo, korzystając z funkcji advertisers.lineItems.list. Jeśli element zamówienia generuje nieoczekiwane ostrzeżenie, rozwiąż ten problem natychmiast, aby ograniczyć wpływ tego problemu na wyświetlanie.

Problemy mogą się pojawić nawet wtedy, gdy ustawienia lub kierowanie elementu zamówienia nie uległy zmianie. Przykłady obejmują wstrzymanie lub wygaśnięcie nadrzędnego zamówienia reklamowego oraz wycofanie list użytkowników lub innych opcji kierowania.