Uzyskiwanie API raportów dla komercyjnego rynku

Ten interfejs API pobiera wszystkie zaplanowane raporty.

Składnia żądania

metody	URI żądania
POBIERZ	https://api.partnercenter.microsoft.com/insights/v1.1/cmp/ScheduledReport?reportId={Report ID}&reportName={Report Name}&queryId={Query ID}

nagłówek żądania

Nagłówek	typu	Opis
Autoryzacja	struna	Wymagane. Token dostępu firmy Microsoft Entra w formie Bearer <token>
Typ zawartości	struna	Application/JSON

parametr ścieżki

Żaden

parametr zapytania

nazwa parametru	wymagane	typu	opis
reportId	Nie	struna	Filtruj, aby uzyskać szczegółowe informacje dotyczące tylko raportów z reportId podanymi w tym argumencie. Wiele reportId można określić, oddzielając je średnikiem (;)
reportName	Nie	struna	Filtruj, aby uzyskać szczegółowe informacje o tylko raportach z reportName podanymi w tym argumencie
queryId	Nie	boolean	Uwzględnij wstępnie zdefiniowane zapytania systemowe w odpowiedzi

Słownik

Żaden

odpowiedzi

Ładunek odpowiedzi ma strukturę w formacie JSON w następujący sposób:

Kod odpowiedzi: 200, 400, 401, 403, 404, 500

Ładunek odpowiedzi:

{
  "Value": [
    {
      "ReportId": "string",
      "ReportName": "string",
      "Description": "string",
      "QueryId": "string",
      "Query": "string",
      "User": "string",
      "CreatedTime": "string",
      "ModifiedTime": "string",
      "StartTime": "string",
      "ReportStatus": "string",
      "RecurrenceInterval": 0,
      " RecurrenceCount": 0,
      "CallbackUrl": "string",
      "Format": "string"
    }
  ],
  "TotalCount": 0,
  "Message": "string",
  "StatusCode": 0
}

Słownik

W tej tabeli wymieniono kluczowe definicje elementów w odpowiedzi.

Parametr	Opis
ReportId	Unikatowy identyfikator (UUID) utworzonego raportu
ReportName	Nazwa podana w ładunku żądania podczas tworzenia raportu
Description	Opis podany w ładunku żądania podczas tworzenia raportu
QueryId	Identyfikator zapytania podany w ładunku żądania podczas tworzenia raportu
Query	Tekst zapytania, który zostanie wykonany dla tego raportu
User	Identyfikator użytkownika używany do tworzenia raportu
CreatedTime	Czas UTC utworzenia raportu w tym formacie: rrrr-MM-ddTHH:mm:ssZ
ModifiedTime	Czas UTC ostatniej modyfikacji raportu w tym formacie: rrrr-MM-ddTHH:mm:ssZ
ExecuteNow	Parametr ExecuteNow podany w ciele żądania podczas tworzenia raportu
queryStartTime	Czas rozpoczęcia zapytania podany w ładunku żądania podczas tworzenia raportu. Ma to zastosowanie tylko wtedy, gdy ExecuteNow jest ustawiona na wartość "True"
queryEndTime	Czas zakończenia zapytania podany w ładunku żądania podczas tworzenia raportu. Ma to zastosowanie tylko wtedy, gdy ExecuteNow jest ustawiona na wartość "True"
StartTime	Godzina rozpoczęcia podana w ładunku żądania podczas tworzenia raportu
ReportStatus	Stan wykonania raportu. Możliwe wartości to Wstrzymane, Aktywnei Nieaktywne.
RecurrenceInterval	Okres powtarzania podany w treści żądania podczas tworzenia raportu
RecurrenceCount	Pozostająca liczba powtórzeń dla raportu
CallbackUrl	Adres URL wywołania zwrotnego podany w ładunku żądania podczas tworzenia raportu
CallbackMethod	Metoda wywołania zwrotnego podana w ładunku żądania podczas tworzenia raportu
Format	Format plików raportu podanych w ładunku żądania podczas tworzenia raportu
EndTime	Godzina zakończenia podana w treści żądania podczas tworzenia raportu. Ma to zastosowanie tylko wtedy, gdy ExecuteNow jest ustawiona na wartość "True"
TotalRecurrenceCount	RecurrenceCount podane w ładunku żądania podczas tworzenia raportu
nextExecutionStartTime	Sygnatura czasowa UTC, kiedy rozpocznie się następne wykonanie raportu
TotalCount	Liczba rekordów w tablicy Value
StatusCode	Kod wyniku. Możliwe wartości to 200, 400, 401, 403, 500
message	Komunikat o statusie działania interfejsu API