Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Espaço de nomes: 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 respetivas propriedades.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| 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, este método devolve 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"
}
]
}