Häufig gestellte Fragen zum programmgesteuerten Zugriff auf Analysedaten

In diesem Artikel werden häufig gestellte Fragen zum programmgesteuerten Zugriff auf Analysedaten in Partner Center für Ihre Angebote im kommerziellen Marketplace behandelt.

API-Antworten

In welchen verschiedenen Szenarien kann ich eine andere API-Antwort als 200 (Erfolg) erhalten?

In dieser Tabelle werden die API-Antworten und die Vorgehensweisen beim Empfang beschrieben.

Fehlerbeschreibung Fehlercode Problembehandlung
Nicht autorisiert 401 Dies ist eine Authentifizierungsausnahme. Prüfen Sie die Richtigkeit des Azure AD-Tokens (Azure Active Directory). Das Azure AD-Token ist 60 Minuten lang gültig. Danach müssen Sie es neu generieren.
Ungültiger Tabellenname 400 Der Name des Datasets ist falsch. Überprüfen Sie den Datasetnamen, indem Sie die API zum Abrufen aller Datasets aufrufen.
Falscher Spaltenname 400 Der Name der Spalte in der Abfrage ist falsch. Überprüfen Sie den Spaltennamen, indem Sie die API zum Abrufen aller Datasets aufrufen, oder sehen Sie sich die Spaltennamen in den folgenden Tabellen an:
Nullwert oder fehlender Wert 400 Es fehlen möglicherweise erforderliche Parameter als Teil der Anforderungsnutzlast der API.
Ungültige Berichtsparameter 400 Stellen Sie sicher, dass die Berichtsparameter korrekt sind. Für den Parameter RecurrenceInterval könnte beispielsweise ein kleinerer Wert als 4 angeben sein.
Zeitintervall muss zwischen 4 und 90 liegen 400 Stellen Sie sicher, dass der Wert des Anforderungsparameters RecurrenceInterval zwischen 4 und 90 liegt.
Ungültige Abfrage-ID (QueryId) 400 Prüfen Sie die generierte QueryId.
Ungültige Berichtsparameter für Erstellung: Startzeit des Berichts sollte sich mindestens vier Stunden von der aktuellen UTC-Zeit unterscheiden 400 Der Startzeitparameter als Teil der Anforderungsnutzlast sollte nicht in der Vergangenheit liegen. Die Startzeit des Berichts sollte sich mindestens vier Stunden von der aktuellen UTC-Zeit unterscheiden.
Angeforderter Wert „string“ wurde nicht gefunden 400 Prüfen Sie, ob Sie die Anforderungsparameter callbackurl oder format aktualisiert haben.
Es wurde kein Element mit den angegebenen Filtern gefunden. 404 Überprüfen Sie den in der API zum Abrufen von Berichtsausführungen verwendeten Parameter reportID.
Es haben keine Ausführungen für die angegebenen Filterbedingungen stattgefunden. Überprüfen Sie die Berichts-ID (reportId) oder Ausführungs-ID (executionId), und wiederholen Sie die API nach der geplanten Ausführungszeit des Berichts. 404 Stellen Sie sicher, dass die reportId korrekt ist. Wiederholen Sie die API nach der geplanten Ausführungszeit des Berichts, wie in der Anforderungsnutzlast angegeben.
Interner Fehler beim Erstellen des Berichts. Korrelations-ID <> 500 Stellen Sie sicher, dass das Datumsformat für die Felder „StartTime“, „QueryStartTime“ und „QueryEndTime“ korrekt ist.
Dienst nicht verfügbar 500 Wenn Sie ständig die Fehlermeldung erhalten, dass der Dienst nicht verfügbar ist (5xx-Fehler), erstellen Sie ein Supportticket.

Keine Datensätze

Ich erhalte die API-Antwort 200, wenn ich den Bericht vom sicheren Speicherort herunterladen. Warum erhalte ich keine Datensätze?

Überprüfen Sie, ob die Zeichenfolge in der Abfrage einen der zulässigen Werte für den Spaltenheader aufweist. Die folgende Abfrage gibt beispielsweise keine Ergebnisse zurück:

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

Die zulässigen Werte für „SKUBillingType“ sind in diesem Beispiel „Paid“ oder „Free“. In den folgenden Tabellen sind alle möglichen Werte für die verschiedenen Spalten aufgeführt:

Nächste Schritte