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.