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:
- Tabela szczegółów zamówień
- Tabela szczegółów użycia
- Tabela szczegółów klienta
- Tabela szczegółów szczegółowych informacji dotyczących witryny Marketplace
- Pulpit nawigacyjny przychodów
- Pulpit nawigacyjny jakości usług
- Pulpit nawigacyjny przechowywania klienta