Błędy i ostrzeżenia

Interfejs Display & Video 360 API może zwracać różne błędy i ostrzeżenia. Prawidłowo działające rozwiązanie API musi obsługiwać te błędy.

Błędy interfejsu API

Żądania do interfejsu API, które nie wykonują zamierzonego działania, zwracają błąd. Należy przechwytywać i obsługiwać odpowiedzi o błędach.

Odpowiedź na błąd interfejsu API zawiera kod odpowiedzi HTTP, komunikat o błędzie i stan kodu RPC Google. Ma on taki format:

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

Poniżej znajdziesz listę typowych błędów interfejsu API i zalecanych działań:

Kody błędów
400 INVALID_ARGUMENT
Wystąpił problem z Twoją prośbą. Sprawdź pole komunikatu w odpowiedzi z błędem i odpowiednio zaktualizuj żądanie.
401 UNAUTHENTICATED
Nie udało się prawidłowo uwierzytelnić Twojej prośby. Sprawdź, czy w żądaniu podajesz prawidłowe dane logowania OAuth. Więcej informacji znajdziesz w naszym krótkim przewodniku.
403 PERMISSION_DENIED
Nie masz uprawnień potrzebnych do wykonania tego działania. Sprawdź, czy Twoje konto użytkownika ma odpowiednie uprawnienia w przypadku danego partnera lub reklamodawcy.
404 NOT_FOUND
Nie można znaleźć zasobu, który próbujesz pobrać. Sprawdź, czy używany identyfikator jest prawidłowy i czy dotyczy pobieranego typu zasobu.
409 ABORTED
 Zasób, który próbujesz zmodyfikować, jest modyfikowany w innym miejscu. Zaczekaj kilka sekund i spróbuj jeszcze raz.
429 RESOURCE_EXHAUSTED
Przekroczono limit szybkości lub dzienny limit żądań. Aby sprawdzić wykorzystanie interfejsu API, użyj konsoli Google Cloud. Zaktualizuj przepływ pracy, aby mieścił się w dotychczasowych limitach. Więcej informacji znajdziesz w naszym przewodniku po optymalizacji wykorzystania.
500 INTERNAL
W interfejsie API wystąpił błąd wewnętrzny. Zaczekaj kilka sekund i spróbuj jeszcze raz. Jeśli błąd będzie się powtarzał, skontaktuj się z zespołem pomocy.
504 DEADLINE_EXCEEDED
Interfejs API zbyt długo przetwarzał żądanie. 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

Interfejs Display & Video 360 API używa długotrwałych zadań do tworzenia plików uporządkowanych danych (SDF). Błędy podczas tworzenia plików SDF są zwracane w ukończonym pliku operation. Szczegóły znajdziesz w polu error. Oto skrócony przykład:

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

Jeśli komunikat o błędzie jest niejasny, zalecamy wykonanie tych czynności:

  • Sprawdź, czy użytkownik ma co najmniej rolę Standard w przypadku partnera lub reklamodawcy wyższego poziomu.
  • Sprawdź, czy identyfikatory podane w filtrze są prawidłowe. Identyfikatory muszą odpowiadać zamierzonemu typowi zasobu i muszą być zasobami podrzędnymi identyfikatora głównego.
  • Upewnij się, że użytkownik ma mniej niż 20 równoczesnych zadań pobierania plików SDF.

Jeśli błędy nadal występują, skontaktuj się z zespołem pomocy.

Ostrzeżenia nieblokujące

Ostrzeżenia nieblokujące wskazują problem, który może mieć wpływ na wyświetlanie reklam w przypadku elementu zamówienia. Podobne ostrzeżenia są widoczne w interfejsie. Te ostrzeżenia są pasywne i wyświetlane w elemencie zamówienia.

Główna przyczyna ostrzeżenia może mieć wpływ na wyświetlanie elementu zamówienia. W niektórych przypadkach może to całkowicie uniemożliwić wyświetlanie reklam.

Profilaktyka

Niektóre ostrzeżenia nieblokujące są spowodowane nieprawidłową konfiguracją elementu zamówienia:

  • Okres wyświetlania: element zamówienia nie będzie wyświetlać reklam, jeśli jego okres wyświetlania jest nieprawidłowy lub jeśli okres wyświetlania zamówienia reklamowego wygasł. Upewnij się, że okres wyświetlania elementu zamówienia mieści się w okresie wyświetlania zamówienia reklamowego.
  • Przypisane kreacje: element zamówienia nie może się wyświetlać, jeśli nie jest do niego przypisana prawidłowa kreacja.
  • Kierowanie: wyświetlanie reklam w elemencie zamówienia może być ograniczone lub całkowicie uniemożliwione, jeśli jego kierowanie nie jest prawidłowo przypisane.

Zanim użyjesz konfiguracji istniejącego elementu zamówienia w nowym elemencie zamówienia, upewnij się, że nie generuje on żadnych ostrzeżeń.

Monitorowanie

Ostrzeżenia nieblokujące mogą się pojawiać w trakcie okresu wyświetlania elementu zamówienia. Sprawdzaj aktywne elementy zamówienia pod kątem nowych ostrzeżeń, aby mieć pewność, że wyświetlają się prawidłowo. Pobieranie elementów zamówienia zbiorczo za pomocą żądania list. Jeśli element zamówienia zwróci nieoczekiwane ostrzeżenie, jak najszybciej rozwiąż problem, aby zmniejszyć wpływ na wyświetlanie.

Ostrzeżenia mogą być dodawane nawet wtedy, gdy ustawienia lub kierowanie nie uległy zmianie. Przykłady:

  • Zamówienie reklamowe jest wstrzymane lub wygasa.
  • Lista użytkowników lub opcja kierowania jest wycofana.