Listar referenceDefinitions

Namespace: microsoft.graph.industryData

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.

Obtenha uma lista dos objetos referenceDefinition e suas propriedades.

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) IndustryData.ReadBasic.All IndustryData-ReferenceDefinition.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application IndustryData.ReadBasic.All IndustryData-ReferenceDefinition.ReadWrite.All

Solicitação HTTP

GET /external/industryData/referenceDefinitions

Parâmetros de consulta opcionais

Este método dá suporte a alguns parâmetros de consulta OData para ajudar a personalizar a resposta. 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.

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 microsoft.graph.industryData.referenceDefinition no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/external/industryData/referenceDefinitions

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

{
  "value": [
    {
      "code": "home",
      "createdDateTime": "0001-01-01T00:00:00Z",
      "displayName": "Home/personal",
      "id": "RefEmailAddressType-home",
      "isDisabled": false,
      "lastModifiedDateTime": "0001-01-01T00:00:00Z",
      "referenceType": "RefEmailAddressType",
      "sortIndex": 10,
      "source": "CEDS"
    },
    {
      "code": "01",
      "createdDateTime": "0001-01-01T00:00:00Z",
      "displayName": "First grade",
      "id": "RefGradeLevel-01",
      "isDisabled": false,
      "lastModifiedDateTime": "0001-01-01T00:00:00Z",
      "referenceType": "RefGradeLevel",
      "sortIndex": 60,
      "source": "CEDS"
    },
    {
      "code": "02",
      "createdDateTime": "0001-01-01T00:00:00Z",
      "displayName": "Second grade",
      "id": "RefGradeLevel-02",
      "isDisabled": false,
      "lastModifiedDateTime": "0001-01-01T00:00:00Z",
      "referenceType": "RefGradeLevel",
      "sortIndex": 70,
      "source": "CEDS"
    },
    {
      "code": "undergraduate",
      "createdDateTime": "0001-01-01T00:00:00Z",
      "displayName": "Undergraduate",
      "id": "RefGradeLevel-undergraduate",
      "isDisabled": false,
      "lastModifiedDateTime": "0001-01-01T00:00:00Z",
      "referenceType": "RefGradeLevel",
      "sortIndex": 270,
      "source": "Contoso"
    },
    {
      "code": "username",
      "createdDateTime": "0001-01-01T00:00:00Z",
      "displayName": "Username",
      "id": "RefIdentifierType-username",
      "isDisabled": false,
      "lastModifiedDateTime": "0001-01-01T00:00:00Z",
      "referenceType": "RefIdentifierType",
      "sortIndex": 40,
      "source": "IMS Global"
    },
    {
      "code": "academicTrust",
      "createdDateTime": "0001-01-01T00:00:00Z",
      "displayName": "Academic Trust",
      "id": "RefOrgType-academicTrust",
      "isDisabled": false,
      "lastModifiedDateTime": "0001-01-01T00:00:00Z",
      "referenceType": "RefOrgType",
      "sortIndex": 140,
      "source": "Contoso"
    }
  ]
}