Listar applicationTemplates

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Recupere uma lista de objetos applicationTemplate da galeria de aplicativos do Microsoft Entra. Detalhes sobre propriedades de risco opcionais, como riskScore e riskFactors, estão disponíveis com a licença do Suíte do Microsoft Entra ou do Acesso à Internet do Microsoft Entra.

Se uma propriedade de risco for incluída na solicitação sem a licença apropriada, uma @microsoft.graph.licenseRequired anotação OData será retornada na resposta.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Permissões adicionais não são necessárias para chamar essa API, desde que seu aplicativo tenha um token de acesso válido para chamar o Microsoft Graph.

Solicitação HTTP

GET /applicationTemplates

Parâmetros de consulta opcionais

Este método dá suporte a alguns parâmetros de consulta OData para ajudar a personalizar a resposta.

  • Você pode usar $filter, $orderby, $top, e $skip parâmetros de consulta em qualquer solicitação GET.

Para obter informações gerais, acesse Parâmetros de consulta OData.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Prefer: odata.maxpagesize={int-value} Opcional. int-value é um número de até 2.800 quando os parâmetros de consulta não são aplicados; ou até 200 quando parâmetros de consulta são aplicados.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos applicationTemplate no corpo da resposta.

Exemplos

Exemplo 1: Listar todos os modelos de aplicativo

O exemplo a seguir mostra como recuperar todos os modelos de aplicativo.

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/applicationTemplates

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates?$select=categories,configurationUris",
    "value": [
        {
            "id": "de92ca39-7b85-4b4c-90d8-2885eff5100b",
            "displayName": "LinkedIn Lookup",
            "homePageUrl": "www.linkedin.com",
            "supportedSingleSignOnModes": [
                "saml",
                "external"
            ],
            "supportedProvisioningTypes": [
                "sync"
            ],
            "logoUrl": "https://galleryapplogos1.azureedge.net/app-logo/linkedinlookup_B8D516A4_215.png",
            "categories": [
                "collaboration",
                "social"
            ],
            "publisher": "LinkedIn",
            "deprecationDate": null,
            "description": "LinkedIn Lookup is the easiest way to find coworkers and teams at your company. Lookup is a new people search tool that combines employees' LinkedIn profile information and Active Directory information, allowing you to quickly find and contact your coworkers, on desktop or mobile. Requires an existing Lookup company subscription.",
            "endpoints": [
                "linkedin.com",
                "licdn.com",
                "platform-alib.linkedin.cn",
                "platform-akam.linkedin.cn",
                "platform-qtil.linkedin.cn",
                "www.linkedin.com"
            ],
            "lastModifiedDateTime": "2025-08-01T21:05:17.943549Z",
            "isEntraIntegrated": true,
            "informationalUrls": {
                "singleSignOnDocumentationUrl": "https://go.microsoft.com/fwlink/?linkid=847714",
                "appSignUpUrl": null
            },
            "supportedClaimConfiguration": {
                "nameIdPolicyFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified"
            },
            "configurationUris": [
                {
                    "usage": "identifierUri",
                    "appliesToSingleSignOnMode": "saml",
                    "values": [
                        "https://www.linkedin.com/lookup/*"
                    ],
                    "examples": [
                        "https://www.linkedin.com/lookup/EXAMPLE"
                    ],
                    "isRequired": true
                },
                {
                    "usage": "redirectUri",
                    "appliesToSingleSignOnMode": "saml",
                    "values": [
                        "https://www.linkedin.com/checkpoint/enterprise/*"
                    ],
                    "examples": [
                        "https://www.linkedin.com/checkpoint/enterprise/*"
                    ],
                    "isRequired": true
                }
            ]
        }
    ]
}

Exemplo 2: Listar todos os modelos de aplicativo com propriedades opcionais (com licença apropriada)

O exemplo a seguir mostra como recuperar todos os modelos de aplicativo com propriedades opcionais.

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/applicationTemplates?$select=id,displayName,riskScore,riskFactors

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates?$select=categories,configurationUris",
    "value": [
        {
            "id": "de92ca39-7b85-4b4c-90d8-2885eff5100b",
            "displayName": "LinkedIn Lookup",
            "riskScore": {
                "total": 9.910557,
                "security": 9.95,
                "provider": 9.611832,
                "compliance": 9.931034,
                "legal": 10.0
            },
            "riskFactors": {
                "general": {
                    "hasDisasterRecoveryPlan": true
                    // ... omitted for brewity
                },
                "security": {
                    "hasMFA": true
                    // ... omitted for brewity
                },
                "compliance": {
                    "cobit": true
                    // ... omitted for brewity
                },
                "legal": {
                    "hasDmca": null
                    // ... omitted for brewity
                }
            }
        }
    ]
}

Exemplo 3: Listar todos os modelos de aplicativo com propriedades opcionais (sem a licença apropriada)

O exemplo a seguir mostra como recuperar todos os modelos de aplicativo com propriedades opcionais quando o locatário não tem assinatura de Suíte do Microsoft Entra ou de Acesso à Internet do Microsoft Entra.

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/applicationTemplates?$select=id,displayName,riskScore,riskFactors

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates",
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applicationTemplates?$select=categories,configurationUris",
    "@microsoft.graph.licenseRequired": "An Entra Suite or Entra Internet Access license is required to show riskScore or riskFactors properties. For more info see aka.ms/applicationTemplateEndpointLicensing",
    "value": [
        {
            "id": "de92ca39-7b85-4b4c-90d8-2885eff5100b",
            "displayName": "LinkedIn Lookup",
            "riskScore": null,
            "riskFactors": null
        }
    ]
}

Exemplo 4: listar modelos de aplicativo com filtragem e ordenação

O exemplo a seguir mostra como obter os dois principais modelos de aplicativo, classificados por pontuação de risco total, classificados na contentSharingcategoria.

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/applicationTemplates?$select=id,displayName,riskScore,categories&$filter=categories/any(c: c eq 'contentSharing')&$top=2&$orderBy=riskScore/total desc

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applicationTemplates",
    "value": [
        {
            "id": "2af39c45-8bb3-5369-9341-696181ebfa55",
            "displayName": "Contoso network",
            "categories": [
                "contentSharing"
            ],
            "riskScore": {
                "total": 9.610546,
                "security": 9.833333,
                "provider": 9.475291,
                "compliance": 9.923077,
                "legal": 9.142858
            }
        },
        {
            "id": "e0e5def8-f27e-5445-93f3-02ea8733a811",
            "displayName": "Fourth Coffee",
            "categories": [
                "contentSharing"
            ],
            "riskScore": {
                "total": 8.562663,
                "security": 8.266666,
                "provider": 8.833883,
                "compliance": 8.142858,
                "legal": 9.142858
            }
        }
    ]
}