Często zadawane pytania dotyczące dostępu programistycznego do danych analizy

W tym artykule opisano często zadawane pytania dotyczące programowego uzyskiwania dostępu do danych analitycznych w Centrum partnerskim dla ofert platformy handlowej.

Odpowiedzi interfejsu API

Jakie są różne scenariusze, w których mogę otrzymać odpowiedź interfejsu API inną niż 200 (powodzenie)?

W tej tabeli opisano odpowiedzi interfejsu API i czynności, które należy wykonać, jeśli je otrzymasz.

Opis błędu Kod błędu Rozwiązywanie problemów
Brak autoryzacji 401 Jest to wyjątek uwierzytelniania. Sprawdź poprawność tokenu usługi Azure Active Directory (Azure AD). Token Azure AD jest ważny przez 60 minut. Po upływie tego czasu należy ponownie wygenerować token Azure AD.
Nieprawidłowa nazwa tabeli 400 Nazwa zestawu danych jest nieprawidłowa. Ponownie sprawdź nazwę zestawu danych, wywołując interfejs API "Pobierz wszystkie zestawy danych".
Nieprawidłowa nazwa kolumny 400 Nazwa kolumny w zapytaniu jest niepoprawna. Ponownie sprawdź nazwę kolumny, wywołując interfejs API "Pobierz wszystkie zestawy danych" lub odwołując się do nazw kolumn w następujących tabelach:
Brak wartości null lub brakującej 400 W ramach ładunku żądania interfejsu API może brakować obowiązkowych parametrów.
Nieprawidłowe parametry raportu 400 Upewnij się, że parametry raportu są poprawne. Na przykład możesz podać wartość mniejszą niż 4 dla RecurrenceInterval parametru.
Interwał cyklu musi należeć do przedziału od 4 do 90 400 Upewnij się, że wartość parametru RecurrenceInterval żądania wynosi od 4 do 90.
Nieprawidłowy identyfikator kwerendy 400 Ponownie sprawdź wygenerowany QueryIdelement .
Nieprawidłowe parametry raportu do utworzenia — godzina rozpoczęcia raportu powinna trwać co najmniej 4 godziny od bieżącej godziny UTC — 400 Parametr Godzina rozpoczęcia w ramach ładunku żądania nie powinien znajdować się w przeszłości. Godzina rozpoczęcia raportu powinna trwać co najmniej 4 godziny od bieżącej godziny UTC.
Nie można odnaleźć żądanej wartości "string" 400 Sprawdź, czy zaktualizowano parametry callbackurl żądania, czy format.
Nie znaleziono elementu z podanymi filtrami. 404 reportID Sprawdź parametr używany w interfejsie API pobierania wykonań raportów.
Nie ma żadnych wykonań, które wystąpiły dla podanych warunków filtrowania. Sprawdź ponownie identyfikator reportId lub executionId i ponów próbę interfejsu API po zaplanowanym czasie wykonywania raportu 404 Upewnij się, że parametr reportId jest poprawny. Ponów próbę wykonania interfejsu API po zaplanowanym czasie wykonywania raportu określonym w ładunku żądania.
Wystąpił błąd wewnętrzny podczas tworzenia raportu. Identyfikator korelacji <> 500 Upewnij się, że format daty dla pól "StartTime", "QueryStartTime" i "QueryEndTime" jest poprawny.
Usługa niedostępna 500 Jeśli stale otrzymujesz usługę niedostępną (błąd 5xx), utwórz bilet pomocy technicznej.

Brak rekordów

Otrzymuję odpowiedź interfejsu API 200 po pobraniu raportu z bezpiecznej lokalizacji. Dlaczego nie otrzymuję żadnych rekordów?

Sprawdź, czy ciąg w zapytaniu ma jedną z dozwolonych wartości nagłówka kolumny. Na przykład to zapytanie zwróci zero wyników:

"SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = 'Paided' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH"

W tym przykładzie dozwolone wartości skuBillingType są płatne lub bezpłatne. Zapoznaj się z następującymi tabelami, aby zapoznać się ze wszystkimi możliwymi wartościami dla różnych kolumn:

Następne kroki