Veelgestelde vragen over programmatische toegang tot analysegegevens voor commerciële marketplace
In dit artikel worden veelgestelde vragen behandeld over het programmatisch openen van analysegegevens in partnercentrum voor uw aanbiedingen voor commerciële marketplace.
Foutberichten in API-antwoord
In deze tabel worden de mogelijke foutberichten in API-antwoorden en stappen voor probleemoplossing beschreven.
Foutbeschrijving | Foutcode | Problemen oplossen |
---|---|---|
Niet geautoriseerd | 401 | Deze uitzondering is gerelateerd aan verificatie. Controleer of u het juiste Microsoft Entra-token gebruikt. Het token is 60 minuten geldig. Daarna moet u het token opnieuw genereren. |
Ongeldige tabelnaam | 400 | U hebt een onjuiste naam voor de gegevensset ingevoerd. Gebruik de API gegevenssets ophalen om de naam van de gegevensset te valideren. Zorg ervoor dat de juiste naam van de gegevensset wordt gebruikt. |
Onjuiste kolomnaam | 400 | U hebt een onjuiste kolomnaam ingevoerd. Gebruik de API gegevenssets ophalen om de kolomnamen voor de gegevensset te valideren. |
Null-waarde of ontbrekende waarde | 400 | U mist verplichte parameters in de nettolading van de aanvraag van de API. Zorg ervoor dat u de juiste waarde opgeeft voor verplichte parameters. |
Ongeldige rapportparameters voor het maken- StartTime moet de notatie volgen: jjjj-MM-ddTHH:mm:ssZ | 400 | StartTime in de API volgt de voorgestelde indeling niet. Zorg ervoor dat de StartTime volgende notatie volgt: jjjj-MM-ddTHH:mm:ssZ |
Ongeldige rapportparameters voor het maken- EndTime moet groter zijn dan StartTime | 400 | Zorg ervoor dat deze EndTime groter is dan StartTime |
Ongeldige rapportparameters voor het maken- EndTime moet de notatie volgen: jjjj-MM-ddTHH:mm:ssZ | 400 | EndTime in de API volgt de voorgestelde indeling niet. Zorg ervoor dat de EndTime volgende notatie volgt: jjjj-MM-ddTHH:mm:ssZ |
Ongeldige rapportparameters voor het maken: de rapportindeling moet csv/tsv zijn | 400 | Zorg ervoor dat u een CSV- of TSV-bestand oplevert Format . |
Ongeldige rapportparameters voor het maken - Ongeldig teken (;) in ReportName | 400 | Verwijder ongeldig teken (;) uit de ReportName parameter. |
Ongeldige rapportparameters voor het maken- CallbackMethod kan alleen GET of POST zijn | 400 | Zorg ervoor dat deze CallbackMethod is ingesteld als GET of POST. |
Ongeldige rapportparameters voor het maken: het aantal terugkeerpatronen moet een positief geheel getal zijn | 400 | Geef een positief geheel getal op in RecurrenceCount de parameter. |
Ongeldige rapportparameters voor het maken: de lengte van ReportName en Beschrijving beperken tot 256 tekens of minder | 400 | Zorg ervoor dat ReportName en Description niet langer zijn dan 256 tekens. |
Ongeldige rapportparameters voor het maken: de begintijd van het rapport moet ten minste 4 uur zijn vanaf de huidige UTC-tijd | 400 | StartTime parameter als onderdeel van de nettolading van de aanvraag mag zich niet in het verleden bevinden. De begintijd van het rapport moet ten minste 4 uur vanaf de huidige UTC-tijd zijn. |
Ongeldige QueryId | 400 | U hebt een onjuiste QueryId gebruikt. Valideer het QueryId gebruik. |
Herhalingsinterval moet tussen 1 en 17520 zijn | 400 | Zorg ervoor dat de waarde van de RecurrenceInterval aanvraagparameter tussen 1 en 17520 ligt. |
Het maken van rapporten is niet toegestaan omdat de maximaal toegestane uitvoeringen voor rapporten per uur binnen 30 dagen moeten zijn | 400 | Als RecurrenceInterval het tussen 1 en 23 ligt, EndTime mag dit niet langer zijn dan 30 dagen. Werk de RecurrenceCount of EndTime dienovereenkomstig bij. |
Het maken van rapporten is niet toegestaan omdat de maximaal toegestane uitvoeringen voor dagelijkse rapporten binnen 6 maanden moeten zijn | 400 | Als RecurrenceInterval het tussen de 24 en 168 ligt, EndTime mag dit niet langer zijn dan 6 maanden. Werk de RecurrenceCount of EndTime dienovereenkomstig bij. |
Het maken van rapporten is niet toegestaan omdat de maximaal toegestane uitvoeringen voor wekelijkse rapporten binnen 1 jaar moeten zijn | 400 | Als RecurrenceInterval het tussen de 169 en 720 ligt, EndTime mag dit niet meer dan 1 jaar zijn. Werk de RecurrenceCount of EndTime dienovereenkomstig bij. |
Het maken van rapporten is niet toegestaan omdat de maximaal toegestane uitvoeringen voor maandelijkse rapporten binnen 2 jaar moeten zijn | 400 | Als RecurrenceInterval het tussen 721 en 8760 ligt, EndTime mag dit niet meer dan 2 jaar zijn. Werk de RecurrenceCount of EndTime dienovereenkomstig bij. |
Het maken van rapporten is niet toegestaan omdat de maximaal toegestane uitvoeringen voor jaarlijkse rapporten binnen 5 jaar moeten zijn | 400 | Als RecurrenceInterval het tussen 8761 en 17520 ligt, EndTime mag dit niet meer dan 5 jaar zijn. Werk de RecurrenceCount of EndTime dienovereenkomstig bij. |
Gebruiker heeft het quotum voor het maken van rapporten van 50 actieve rapporten overschreden | 400 | U hebt het quotum van 50 actieve rapporten overschreden. Controleer uw actieve rapporten en verwijder de rapporten die niet worden gebruikt. |
Gebruiker heeft het quotum voor het maken van het ExecuteNow-rapport van 5 rapporten/60 minuten overschreden | 400 | U hebt in de afgelopen 60 minuten vijf rapporten gegenereerd met ExecuteNow=True . Wacht voordat u een ander rapport genereert. Overweeg het rapport te plannen op basis van uw behoeften en u bereikt het quotum niet. |
Aangevraagde waarde 'tekenreeks' is niet gevonden | 400 | Controleer of u de aanvraagparameters callbackurl hebt bijgewerkt of format . |
Het aantal query's is overschreden. Enkele query's verwijderen voordat u nieuwe query's maakt | 400 | U hebt het quotum van 100 actieve query's overschreden. Bekijk en verwijder ongebruikte query's voordat u nieuwe query's maakt. |
Er is geen item gevonden met opgegeven filters | 404 | Controleer de reportID parameter die wordt gebruikt in de API rapportuitvoeringen ophalen. |
Er zijn geen uitvoeringen die zijn uitgevoerd voor de opgegeven filtervoorwaarden. Controleer de reportId of executionId opnieuw en voer de API opnieuw uit na de geplande uitvoeringstijd van het rapport | 404 | Zorg ervoor dat de reportId juiste is. Voer de API opnieuw uit na de geplande uitvoeringstijd van het rapport, zoals opgegeven in de nettolading van de aanvraag. |
Er is een interne fout opgetreden tijdens het maken van een rapport. Correlatie-id <> | 500 | Zorg ervoor dat de notatie van de datum voor de velden StartTime QueryStartTime en QueryEndTime juist is. |
Service niet beschikbaar | 500 | Als u continu een service niet beschikbaar hebt (5xx-fout), maakt u een ondersteuningsticket. |
Geen records
Ik heb API-antwoord 200 ontvangen voor het ophalen van de API voor het uitvoeren van rapporten. Waarom zijn er geen records in het gedownloade bestand?
Controleer of de tekenreeks in de query een van de mogelijke waarden voor de kolomkop heeft.
SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = 'Paided' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH
In dit voorbeeld worden de mogelijke waarden voor SKUBillingType betaald of gratis en omdat u een andere waarde gebruikt, retourneert de query geen record.
Raadpleeg de volgende tabellen voor alle mogelijke waarden voor de verschillende kolommen:
- Dashboard Klanten
- Dashboard Orders
- Gebruiksdashboard
- Marketplace Insights-dashboard
- Omzetdashboard
- Quality of Service-dashboard
- Dashboard voor klantretentie
- Licentiedashboard
- Quality of Service-dashboard
Volgende stappen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub Issues geleidelijk uitfaseren als het feedbackmechanisme voor inhoud. Het wordt vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor