Répertorier les applications du catalogue d’applications Microsoft Teams.
Cela inclut les applications du Magasin Microsoft Teams et les applications du catalogue d’applications de votre organization (le catalogue d’applications client). Pour obtenir des applications à partir du catalogue d’applications de votre organization uniquement, spécifiez organization en tant que distributionMethod dans la requête.
Remarque
En général, l’ID d’une ressource teamsApp est généré par le serveur. Il n’est pas identique à l’ID spécifié dans un manifeste d’application Teams, sauf si sa méthode de distribution est store. Dans d’autres cas, l’ID fourni par le développeur dans le cadre du manifeste de l’application Teams est marqué comme externalId dans la ressource teamsApp .
Les autorisations Directory.Read.All et Directory.ReadWrite.All sont prises en charge uniquement pour la compatibilité descendante. Nous vous recommandons de mettre à jour vos solutions pour utiliser une autre autorisation et éviter d’utiliser ces autorisations à l’avenir.
Requête HTTP
GET /appCatalogs/teamsApps
Paramètres facultatifs de la requête
Cette méthode prend en charge les $filterparamètres de requête OData , $selectet $expand pour vous aider à personnaliser la réponse.
L’utilisation $expand=AppDefinitions de renvoie plus d’informations sur l’état de l’application, comme publishingState, qui reflète la révision de la soumission de l’application status et indique si une application est approuvée, rejetée ou reste en cours d’examen.
Note: Vous pouvez filtrer sur l’un des champs de l’objet teamsApp pour raccourcir la liste des résultats. Vous pouvez utiliser l’une des opérations de filtre suivantes : Égal à, différent et, ou, et non.
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=distributionMethod eq 'organization'
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AppCatalogs.TeamsApps.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Filter = "distributionMethod eq 'organization'";
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TeamsAppCollectionResponse result = graphClient.appCatalogs().teamsApps().get(requestConfiguration -> {
requestConfiguration.queryParameters.filter = "distributionMethod eq 'organization'";
});
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=id eq 'b1c5353a-7aca-41b3-830f-27d5218fe0e5'
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AppCatalogs.TeamsApps.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Filter = "id eq 'b1c5353a-7aca-41b3-830f-27d5218fe0e5'";
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TeamsAppCollectionResponse result = graphClient.appCatalogs().teamsApps().get(requestConfiguration -> {
requestConfiguration.queryParameters.filter = "id eq 'b1c5353a-7aca-41b3-830f-27d5218fe0e5'";
});
Exemple 3 : Rechercher une application basée sur l’ID de manifeste d’application Teams
L’exemple suivant répertorie les applications qui correspondent à l’ID spécifié dans le manifeste de l’application Teams. Dans l’exemple, l’ID de manifeste de l’application Teams est cf1ba4c7-f94e-4d80-ba90-5594b641a8ee.
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=externalId eq 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee'
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AppCatalogs.TeamsApps.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Filter = "externalId eq 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee'";
});
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TeamsAppCollectionResponse result = graphClient.appCatalogs().teamsApps().get(requestConfiguration -> {
requestConfiguration.queryParameters.filter = "externalId eq 'cf1ba4c7-f94e-4d80-ba90-5594b641a8ee'";
});
Exemple 4 : Répertorier les applications avec un ID donné et retourner l’état de révision de la soumission
L’exemple suivant répertorie les applications avec un ID donné et développe appDefinitions pour renvoyer l’objet publishingState, qui reflète l’état de révision de la soumission de l’application. Submitted signifie que la révision est en attente, published que l’administrateur a approuvé l’application et rejected que l’administrateur a rejeté l’application.
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=id eq '876df28f-2e78-423b-94a5-44181bd0e225'&$expand=appDefinitions
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AppCatalogs.TeamsApps.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Filter = "id eq '876df28f-2e78-423b-94a5-44181bd0e225'";
requestConfiguration.QueryParameters.Expand = new string []{ "appDefinitions" };
});
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc app-catalogs teams-apps list --filter "id eq '876df28f-2e78-423b-94a5-44181bd0e225'" --expand "appDefinitions"
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TeamsAppCollectionResponse result = graphClient.appCatalogs().teamsApps().get(requestConfiguration -> {
requestConfiguration.queryParameters.filter = "id eq '876df28f-2e78-423b-94a5-44181bd0e225'";
requestConfiguration.queryParameters.expand = new String []{"appDefinitions"};
});
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$expand=appDefinitions($expand=bot)&$filter=appDefinitions/any(a:a/bot ne null)
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AppCatalogs.TeamsApps.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Expand = new string []{ "appDefinitions($expand=bot)" };
requestConfiguration.QueryParameters.Filter = "appDefinitions/any(a:a/bot ne null)";
});
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc app-catalogs teams-apps list --filter "appDefinitions/any(a:a/bot ne null)" --expand "appDefinitions(\$expand=bot)"
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TeamsAppCollectionResponse result = graphClient.appCatalogs().teamsApps().get(requestConfiguration -> {
requestConfiguration.queryParameters.expand = new String []{"appDefinitions($expand=bot)"};
requestConfiguration.queryParameters.filter = "appDefinitions/any(a:a/bot ne null)";
});
Exemple 7 : Répertorier les applications avec un ID donné et retourner uniquement les autorisations spécifiques à la ressource requises par l’application
L’exemple suivant répertorie les applications avec un ID donné et retourne les autorisations spécifiques à la ressource qui lui sont associées.
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=id+eq+'a5228c26-a9ae-4702-90e0-79a5246d2f7d'&$expand=appDefinitions($select=id,authorization)
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AppCatalogs.TeamsApps.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Filter = "id eq 'a5228c26-a9ae-4702-90e0-79a5246d2f7d'";
requestConfiguration.QueryParameters.Expand = new string []{ "appDefinitions($select=id,authorization)" };
});
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc app-catalogs teams-apps list --filter "id eq 'a5228c26-a9ae-4702-90e0-79a5246d2f7d'" --expand "appDefinitions(\$select=id,authorization)"
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TeamsAppCollectionResponse result = graphClient.appCatalogs().teamsApps().get(requestConfiguration -> {
requestConfiguration.queryParameters.filter = "id eq 'a5228c26-a9ae-4702-90e0-79a5246d2f7d'";
requestConfiguration.queryParameters.expand = new String []{"appDefinitions($select=id,authorization)"};
});
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.