Błędy i ostrzeżenia

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

Błędy interfejsu API

Żądania wysłane do interfejsu API, których nie udało się zrealizować, zwracają komunikat o błędzie. Prośby z błędami są uwzględniane w limitach użytkowników i będą brane pod uwagę podczas rozpatrywania próśb o dodatkowe limity. Odpowiedzi na błędy należy przetworzyć i obsługiwać, aby uniknąć błędów w przyszłości.

Odpowiedź na błąd ma następujący format i zawiera kod odpowiedzi HTTP, komunikat o błędzie oraz kod 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, które należy podjąć, jeśli wystąpią:

Kod RPC Zalecane działanie
400 INVALID_ARGUMENT Wystąpił problem z Twoim żądaniem. Sprawdź pole message w odpowiedzi na błąd i w odpowiednim stopniu zmodyfikuj żądanie.
401 UNAUTHENTICATED Nie udało się poprawnie uwierzytelnić Twojego żądania. Sprawdź, czy w żądaniu są podane prawidłowe poświadczenia OAuth. Więcej informacji na ten temat znajdziesz w przewodniku Pierwsze kroki.
403 PERMISSION_DENIED Nie masz uprawnień potrzebnych do przetworzenia Twojej prośby. Sprawdź, czy Twoje konto użytkownika ma odpowiednie uprawnienia dla danego partnera lub reklamodawcy.
404 NOT_FOUND Nie udało się znaleźć zasobu, który próbujesz pobrać. Sprawdź, czy używany identyfikator jest prawidłowy i czy odpowiada pobieranemu typowi zasobu.
409 ABORTED Zasób, który próbujesz zmodyfikować, jest modyfikowany w innym miejscu. Zaczekaj kilka sekund i spróbuj ponownie.
429 RESOURCE_EXHAUSTED Przekroczono limit częstotliwości lub dzienny limit żądań. Sprawdź wykorzystanie interfejsu API za pomocą Konsoli interfejsów API Google i zmodyfikuj przepływ pracy, aby działał w ramach istniejących limitów. Więcej informacji znajdziesz na stronie Optymalizacja limitu.
500 INTERNAL W interfejsie API wystąpił błąd wewnętrzny. Zaczekaj kilka sekund i spróbuj ponownie. Jeśli błąd będzie się powtarzał, skontaktuj się z zespołem pomocy.
504 DEADLINE_EXCEEDED Interfejs API potrzebował zbyt dużo czasu na wykonanie żądania. Zaczekaj kilka sekund i spróbuj ponownie. Jeśli błąd będzie się powtarzał, skontaktuj się z zespołem pomocy.

Błędy SDF

Interfejs Display & Video 360 API używa metody asynchronicznej do generowania i pobierania plików uporządkowanych danych (SDF). Z tego powodu błędy zgłaszane podczas generowania SDF są zwracane w ramach ukończonego zadania pobierania SDF. Zadania pobierania SDF zakończonego w error jest oznaczone jako ukończone, ale w polu response zamiast nazwy zasobu multimedialnego jest wypełnione pole błędu, 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, postępuj zgodnie z instrukcjami. Jeśli komunikat o błędzie nie zawiera wyraźnych wskazówek, wykonaj te czynności:

  • Sprawdź, czy użytkownik ma odpowiednie uprawnienia do zasobów partnera lub reklamodawcy nadrzędnych.
  • Sprawdź, czy identyfikatory podane w filtrze są prawidłowe, odpowiadają docelowym typom zasobów i są zgodne z podanym identyfikatorem głównym.
  • Upewnij się, że nie przekraczasz limitu 20 jednoczesnych zadań pobierania plików SDF na użytkownika.

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

Ostrzeżenia nieblokujące

Ostrzeżenia nieblokujące są przypisywane do elementów zamówienia, aby wskazać problem, który może wpływać na wyświetlanie elementu zamówienia. Podobne ostrzeżenia są wyświetlane w interfejsie za pomocą banera z powiadomieniem. Te ostrzeżenia są pasywne i znajdują się w polu warningMessages elementu zamówienia.

Chociaż te problemy nie wymagają interwencji, mogą mieć wpływ na wyświetlanie produktu w linii do tego stopnia, że może on w ogóle nie zostać wyświetlony.

Profilaktyka

Wiele problemów, które powodują wyświetlanie ostrzeżeń nieblokujących, można uniknąć, odpowiednio konfigurując ustawienia elementu zamówienia, m.in.:

  • Termin wyświetlania: jeśli termin wyświetlania elementu zamówienia jest nieprawidłowy lub termin wyświetlania zamówienia nadrzędnego wygasł, element zamówienia wygeneruje ostrzeżenie i nie będzie się wyświetlać. Aby uniknąć tego problemu, sprawdź, czy okres wyświetlania elementu zamówienia nie kończy się później niż okres wyświetlania jego nadrzędnego zamówienia na wstawkę.
  • Przypisane kreacje: jeśli do elementu zamówienia nie jest przypisana prawidłowa kreacja, element zamówienia wygeneruje ostrzeżenie i nie będzie się wyświetlać.
  • Kierowanie: jeśli kierowanie elementu zamówienia nie jest prawidłowo przypisane, może wyświetlić ostrzeżenie, a wyświetlanie może zostać całkowicie zablokowane lub ograniczone.

Jeśli powielasz konfiguracje z bieżącego elementu zamówienia, upewnij się, że nie generuje on żadnych nieoczekiwanych ostrzeżeń.

Monitorowanie

Problemy, które powodują ostrzeżenia nieblokujące, mogą wystąpić, gdy element zamówienia jest w trakcie przetwarzania. Aby mieć pewność, że elementy zamówienia są wyświetlane prawidłowo, sprawdzaj swoje aktywne elementy zamówienia pod kątem nowo wygenerowanych ostrzeżeń. Elementy zamówienia można pobierać zbiorczo za pomocą funkcji advertisers.lineItems.list. Jeśli element zamówienia generuje nieoczekiwane ostrzeżenie, natychmiast rozwiąż ten problem, aby zminimalizować wpływ na wyświetlanie reklam.

Problemy mogą wystąpić nawet wtedy, gdy ustawienia lub kierowanie elementu zamówienia się nie zmieniły. Może to być na przykład wstrzymanie lub wygaśnięcie zamówienia reklamowego nadrzędnego czy wycofanie list użytkowników lub innych ustawień kierowania.