Auflisten von Paketen

Ruft eine Liste aller im Mandanten verfügbaren Pakete ab.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages

Anforderungsheader

Optionale Abfrageparameter

Diese Methode unterstützt den $filterOData-Abfrageparameter , um die Antwort anzupassen. Die folgenden Eigenschaften werden vom $filter OData-Abfrageparameter unterstützt. Beispiele für die Verwendung des $filter Abfrageparameters finden Sie unter Beispiele.

Nach Anforderungseigenschaften filtern

Die requestStatus und-Eigenschaften requestType beschreiben eine Anforderung, die ein Benutzer in der organization für ein Paket gesendet hat. Das Filtern nach einer der beiden Eigenschaften gibt die Pakete zurück, die Benutzer angefordert haben.

Das ungefilterte GET /copilot/admin/catalog/packages Verhalten bleibt unverändert.

Die folgenden Filterausdrücke werden unterstützt:

• requestStatus eq 'pending', wodurch die offene Anforderungswarteschlange ausgewählt wird. Andere requestStatus Mitglieder werden in einem Filter nicht unterstützt.
• Ein einzelner eq Vergleich von requestType, mit einem der publishactivate, , access, oder update Elemente. Filtern Sie nicht nach dem unknownFutureValue Sentinel-Mitglied.
• Diese beiden Vergleiche verbanden sich mit and.
• Einer oder beide Vergleiche kombiniert mit einer lastModifiedDateTime Grenze. Geben Sie eine ge Grenze, eine le Grenze oder beide an, um einen inklusiven Bereich auszudrücken.

Sie können die and Konjunktionen in beliebiger Reihenfolge schreiben.

Eine lastModifiedDateTime Bindung gilt für den Wert des lastModifiedDateTime Pakets, der derselbe Wert ist, der für diese Eigenschaft zurückgegeben wird. Es wird nicht danach gefiltert, wann ein Benutzer die Anforderung gesendet hat. Ein Paket, das keinen lastModifiedDateTime Wert hat, stimmt nicht überein, solange eine Bindung vorhanden ist.

Das Filtern lastModifiedDateTime nach sich ist ein normales Katalogverhalten und gibt die Anforderungswarteschlange nicht zurück.

Die folgenden werden nicht unterstützt und kehren zurück:400 Bad Request

• Kombinieren einer Anforderungseigenschaft mit supportedHosts, elementTypesoder platform.
• gtDer eq, , oder-Operator lt für lastModifiedDateTime, oder mehr als eine lastModifiedDateTime Grenze in derselben Richtung, z. B. zwei ge Begrenzungen.
• Die orOperatoren , ne, und contains
• $count mit einem Anforderungsfilter.

Die Anforderungseigenschaften können nicht sortiert werden.

requestType sind requestStatus evolvierbare Enumerationen, sodass eine spätere Version des Diensts ein Mitglied zurückgeben kann, das Ihr Client nicht erkennt. Weitere Informationen finden Sie unter Behandeln zukünftiger Member in evolvablen Enumerationen.

Paging einer gefilterten Sammlung

Das Paging ist servergesteuert, sodass der Dienst bestimmt, wie viele Einträge jede Seite enthält. Als nicht transparente URL behandeln @odata.nextLink : Sie fordert sie genau so an, wie sie zurückgegeben wurde, ohne Abfrageoptionen hinzuzufügen oder zu ändern.

Antworten auf eine Anforderung, die nach einer Anforderungseigenschaft filtert, enthalten keine @odata.count Eigenschaft. Weitere Informationen finden Sie unter Paging der Microsoft Graph-Daten in Ihrer App.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und eine Auflistung von copilotPackage-Objekten im Antworttext zurück.

Beispiele

Beispiel 1: Alle Pakete auflisten

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Diligent Teams Document Uploader",
      "type": "external",
      "shortDescription": "Allows direct upload of documents from Microsoft Office into Diligent Teams for sharing",
      "isBlocked": false,
      "supportedHosts": ["outlook", "word", "excel", "powerPoint"],
      "lastModifiedDateTime": "2023-11-20T19:02:02.241Z",
      "publisher": "Diligent Corporation",
      "availableTo": "all",
      "deployedTo": "none",
      "elementTypes": ["officeAddIn"],
      "platform": "web",
      "version": "1.0.0",
      "manifestVersion": "1.1",
      "manifestId": "diligent-teams-uploader",
      "appId": "aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb",
      "assetId": "asset-00001"
    }
  ]
}

Beispiel 2: Auflisten gefiltert nach unterstütztem Host gefilterte Pakete

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=supportedHosts/any(h:h eq 'Word')

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=supportedHosts/any(h:h eq 'Word')

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-cb65-505a-3d42-156df75a4xxy",
      "displayName": "Contoso Document Formatter",
      "type": "external",
      "shortDescription": "Formats Word documents according to company style guide",
      "isBlocked": false,
      "supportedHosts": ["Word"],
      "lastModifiedDateTime": "2025-10-06T00:07:20.1467852Z",
      "availableTo": "all",
      "deployedTo": "all"
    }
  ]
}

Beispiel 3: Nach Elementtyp gefilterte Pakete auflisten

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=elementTypes/any(h:h eq 'OfficeAddIns')

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=elementTypes/any(h:h eq 'OfficeAddIns')

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-505a-3492-9871-134df75a4xxy",
      "displayName": "Northwind Traders Account Lookup",
      "type": "external",
      "shortDescription": "Look up customer account details in Outlook and add them to email",
      "isBlocked": false,
      "supportedHosts": ["Outlook"],
      "lastModifiedDateTime": "2025-10-06T00:07:20.1467852Z",
      "availableTo": "all",
      "deployedTo": "all"
    }
  ]
}

Beispiel 4: Auflisten von Paketen nach Datum/Uhrzeit der letzten Aktualisierung

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=lastModifiedDateTime ge 2026-01-01T00:00:00.0000000Z

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=lastModifiedDateTime ge 2026-01-01T00:00:00.0000000Z

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Contoso HR Agent",
      "type": "custom",
      "shortDescription": "Agent that can answer HR questions",
      "isBlocked": false,
      "supportedHosts": ["Copilot"],
      "lastModifiedDateTime": "2026-01-06T00:07:20.1467852Z",
      "availableTo": "all",
      "deployedTo": "all"
    }
  ]
}

Beispiel 5: Alle Agents auflisten

Um alle Agents aufzulisten, verwenden Sie einen Filter für supportedHostsCopilot

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=supportedHosts/any(h:h eq 'Copilot')

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=supportedHosts/any(h:h eq 'Copilot')

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Contoso HR Agent",
      "type": "custom",
      "shortDescription": "Agent that can answer HR questions",
      "isBlocked": false,
      "supportedHosts": ["Copilot"],
      "lastModifiedDateTime": "2026-01-06T00:07:20.1467852Z",
      "availableTo": "all",
      "deployedTo": "all"
    }
  ]
}

Beispiel 6: Auflisten von Paketen, die von Benutzern angefordert wurden

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die die Pakete mit einer offenen Anforderung zurückgibt.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=requestStatus eq 'pending'

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=requestStatus eq 'pending'

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Contoso HR Agent",
      "type": "custom",
      "shortDescription": "Agent that can answer HR questions",
      "isBlocked": false,
      "supportedHosts": ["Copilot"],
      "lastModifiedDateTime": "2026-08-06T00:07:20.1467852Z",
      "availableTo": "none",
      "deployedTo": "none",
      "requestType": "publish",
      "requestStatus": "pending"
    },
    {
      "id": "P_38cd4yy2-71de-4f6b-9c05-284ef86b5zzt",
      "displayName": "Northwind Traders Account Lookup",
      "type": "external",
      "shortDescription": "Look up customer account details in Outlook and add them to email",
      "isBlocked": false,
      "supportedHosts": ["Outlook"],
      "lastModifiedDateTime": "2026-08-11T18:22:04.5510000Z",
      "availableTo": "some",
      "deployedTo": "some",
      "requestType": "update",
      "requestStatus": "pending"
    }
  ]
}

Beispiel 7: Auflisten von Paketen, deren Veröffentlichung von Benutzern angefordert wurde

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die nur die Pakete zurückgibt, um deren Veröffentlichung Benutzer gebeten haben.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=requestType eq 'publish'

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=requestType eq 'publish'

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Contoso HR Agent",
      "type": "custom",
      "shortDescription": "Agent that can answer HR questions",
      "isBlocked": false,
      "supportedHosts": ["Copilot"],
      "lastModifiedDateTime": "2026-08-06T00:07:20.1467852Z",
      "availableTo": "none",
      "deployedTo": "none",
      "requestType": "publish",
      "requestStatus": "pending"
    }
  ]
}

Beispiel 8: Beide Anforderungsfilter kombinieren

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die die beiden Anforderungseigenschaften mit andkombiniert.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=requestStatus eq 'pending' and requestType eq 'publish'

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=requestStatus eq 'pending' and requestType eq 'publish'

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Contoso HR Agent",
      "type": "custom",
      "shortDescription": "Agent that can answer HR questions",
      "isBlocked": false,
      "supportedHosts": ["Copilot"],
      "lastModifiedDateTime": "2026-08-06T00:07:20.1467852Z",
      "availableTo": "none",
      "deployedTo": "none",
      "requestType": "publish",
      "requestStatus": "pending"
    }
  ]
}

Beispiel 9: Auflisten ausstehender Anforderungen nach lastModifiedDateTime

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die die Pakete mit einer offenen Anforderung zurückgibt, deren lastModifiedDateTime Wert am oder nach einem Datum liegt.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=requestStatus eq 'pending' and lastModifiedDateTime ge 2026-08-10T00:00:00.0000000Z

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=requestStatus eq 'pending' and lastModifiedDateTime ge 2026-08-10T00:00:00.0000000Z

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_38cd4yy2-71de-4f6b-9c05-284ef86b5zzt",
      "displayName": "Northwind Traders Account Lookup",
      "type": "external",
      "shortDescription": "Look up customer account details in Outlook and add them to email",
      "isBlocked": false,
      "supportedHosts": ["Outlook"],
      "lastModifiedDateTime": "2026-08-11T18:22:04.5510000Z",
      "availableTo": "some",
      "deployedTo": "some",
      "requestType": "update",
      "requestStatus": "pending"
    }
  ]
}

Beispiel 10: Auflisten eines Anforderungstyps innerhalb eines lastModifiedDateTime Bereichs

Anforderung

Das folgende Beispiel zeigt eine Anforderung, die die Pakete zurückgibt, um deren Veröffentlichung Benutzer gebeten haben, beschränkt auf diejenigen, deren lastModifiedDateTime Wert in einen inklusiven Bereich fällt.

GET https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages?$filter=requestType eq 'publish' and lastModifiedDateTime ge 2026-08-01T00:00:00.0000000Z and lastModifiedDateTime le 2026-08-31T23:59:59.9999999Z

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages?$filter=requestType eq 'publish' and lastModifiedDateTime ge 2026-08-01T00:00:00.0000000Z and lastModifiedDateTime le 2026-08-31T23:59:59.9999999Z

Antwort

Das folgende Beispiel zeigt die Antwort. Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
      "displayName": "Contoso HR Agent",
      "type": "custom",
      "shortDescription": "Agent that can answer HR questions",
      "isBlocked": false,
      "supportedHosts": ["Copilot"],
      "lastModifiedDateTime": "2026-08-06T00:07:20.1467852Z",
      "availableTo": "none",
      "deployedTo": "none",
      "requestType": "publish",
      "requestStatus": "pending"
    }
  ]
}