Błędy i ostrzeżenia

Na tej stronie opisujemy różne typy błędów i ostrzeżeń, które możesz napotkać podczas korzystania z interfejsu Display & Video 360 API.

Błędy API

Żądania do interfejsu API, których nie można ukończyć, zwracają komunikat o błędzie. Żądania zwracające błędy są wliczane do limitu użytkowników i będą uwzględniane podczas sprawdzania próśb o zwiększenie limitu. Odpowiedzi na błędy powinny być przetwarzane i obsługiwane, aby uniknąć błędów w przyszłości.

Odpowiedź o błędzie ma poniższy format i zawiera kod odpowiedzi HTTP, komunikat o błędzie oraz stan kodu RPC Google:

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

Poniżej znajduje się lista częstych błędów interfejsu API wraz z zalecanymi działaniami, które należy podjąć w przypadku ich zwracania:

Kod RPC Zalecane działanie
400 INVALID_ARGUMENT Wystąpił problem z Twoją prośbą. Sprawdź pole komunikatu w odpowiedzi o błędzie i odpowiednio zmodyfikuj żądanie.
401 UNAUTHENTICATED Nie udało się prawidłowo uwierzytelnić żądania. Sprawdź, czy żądanie zawiera prawidłowe dane uwierzytelniające protokołu OAuth. Więcej informacji na ten temat znajdziesz w przewodniku dla początkujących.
403 PERMISSION_DENIED Nie masz uprawnień wymaganych do realizacji żądania. Sprawdź, czy Twoje konto użytkownika ma odpowiednie uprawnienia odpowiedniego 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 typ pobieranego zasobu jest prawidłowy.
409 ABORTED Zasób, który próbujesz zmodyfikować, jest modyfikowany w innym miejscu. Zaczekaj kilka sekund, a potem wyślij prośbę ponownie.
429 RESOURCE_EXHAUSTED Przekroczono limit żądań lub dzienny limit żądań. Sprawdź wykorzystanie interfejsu API za pomocą Konsoli interfejsów API Google i zmodyfikuj przepływ pracy w taki sposób, aby mieścił się w obowiązujących limitach. Więcej informacji znajdziesz na stronie o optymalizacji limitów.

Jeśli operacji nie można wykonać w podanym limicie dziennym, możesz poprosić o dodatkowy limit.
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 Wykonanie żądania przez interfejs API trwało zbyt długo. 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 korzysta z metody asynchronicznej do generowania i pobierania plików uporządkowanych danych (SDF). Z tego względu błędy zgłoszone podczas generowania pliku SDF są zwracane w zakończonym zadaniu pobierania. Zadanie pobierania SDF ukończone w interfejsie error jest oznaczone jako wykonane, ale w polu response zamiast nazwy zasobu multimedialnego jest wypełnione pole błędu, 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 czynnością, wykonaj odpowiednie czynności. Jeśli komunikat o błędzie nie wymaga wyraźnego działania, zalecamy wykonanie tych czynności:

  • Sprawdź, czy użytkownik ma odpowiednie uprawnienia do nadrzędnych zasobów partnera lub reklamodawcy.
  • Sprawdź, czy identyfikatory podane w filtrze są dokładne, odpowiadają odpowiedniemu typowi zasobu i znajdują się w kontekście podanego identyfikatora głównego.
  • Sprawdź, czy nie przekraczasz limitu 20 jednoczesnych zadań pobierania plików SDF na użytkownika.

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

Nieblokujące ostrzeżenia

Ostrzeżenia nieblokujące są przypisywane do elementów zamówienia, aby wskazywać problem, który może mieć wpływ na wyświetlanie danego elementu. Podobne ostrzeżenia są przekazywane w interfejsie na banerze powiadomień. Te ostrzeżenia są pasywne i wyświetlają się w polu warningMessages elementu zamówienia.

Problemy, które powodują te ostrzeżenia, są pasywne, ale mogą całkowicie uniemożliwić wyświetlanie elementu zamówienia.

profilaktyki,

Wielu problemów, które powodują ostrzeżenia o nieblokowaniu, można uniknąć dzięki prawidłowej konfiguracji ustawień elementu zamówienia. Oto niektóre z nich:

  • Okres wyświetlania: jeśli okres wyświetlania elementu zamówienia jest nieprawidłowy lub okres wyświetlania nadrzędnego zamówienia reklamowego minął, element zamówienia wygeneruje ostrzeżenie i nie będzie się wyświetlać. Aby uniknąć tego drugiego problemu, upewnij się, że okres wyświetlania elementu zamówienia nie kończy się później niż okres wyświetlania w ramach nadrzędnego zamówienia reklamowego.
  • Przypisane kreacje: jeśli do elementu zamówienia nie jest przypisana żadna prawidłowa kreacja, element zamówienia wygeneruje ostrzeżenie i nie będzie go wyświetlać.
  • Kierowanie: jeśli kierowanie elementu zamówienia nie jest prawidłowo przypisane, element zamówienia może wygenerować ostrzeżenie, a wyświetlanie może mieć wpływ na jego wyświetlanie lub całkowicie je zablokować.

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

Monitorowanie

Problemy, które powodują ostrzeżenia o nieblokowaniu, mogą się pojawić w trakcie wyświetlania elementu zamówienia. Aby mieć pewność, że elementy zamówienia wyświetlają się prawidłowo, obserwuj 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, musisz natychmiast rozwiązać ten problem, aby ograniczyć wpływ na wyświetlanie reklam.

Problemy mogą się pojawić 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 nadrzędnego zamówienia reklamowego oraz wycofanie list użytkowników lub innych ustawień kierowania.