Veelgestelde vragen over programmatische toegang tot analysegegevens voor commerciële marketplace

  • Artikel

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 QueryIdgebruikt. 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 StartTimeQueryStartTime 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:

Volgende stappen