Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Atualize as propriedades de um objeto educationalActivity no perfil de um utilizador.
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
As tabelas seguintes mostram as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. 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.
Permissões para a seguinte sintaxe HTTP:
PATCH /me/profile/educationalActivities/{id}
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | User.ReadWrite | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | User.ReadWrite | Indisponível. |
| Aplicativo | Sem suporte. | Sem suporte. |
Permissões para a seguinte sintaxe HTTP:
PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | User.ReadWrite | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | User.ReadWrite | Indisponível. |
| Aplicativo | User.ReadWrite.All | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy |
Solicitação HTTP
PATCH /me/profile/educationalActivities/{id}
PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.
| Propriedade | Tipo | Descrição |
|---|---|---|
| allowedAudiences | Cadeia de caracteres | As audiências que conseguem ver os valores contidos na entidade. Herdado do itemFacet. Os valores possíveis são: me, , contactsfamily, , organizationgroupMembers, federatedOrganizations, , . unknownFutureValueeveryone |
| completionMonthYear | Data | O mês e o ano em que o utilizador se formou ou concluiu a atividade. |
| endMonthYear | Data | O mês e o ano em que o utilizador concluiu a atividade educativa referenciada. |
| inferência | inferenceData | Contém detalhes de inferência se a entidade for inferida pela aplicação de criação ou modificação. Herdado do itemFacet. |
| instituição | institutionData | Contém detalhes da instituição estudada em. |
| programa | educationActivityDetail | Contém informações expandidas sobre o programa ou curso. |
| startMonthYear | Data | O mês e o ano em que o utilizador iniciou a atividade referenciada. |
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto educationalActivity atualizado no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/beta/me/profile/educationalActivities/{id}
Content-type: application/json
{
"institution": {
"location": {
"type": "business",
"postOfficeBox": null,
"street": "12000 E Prospect Rd",
"city": "Fort Collins",
"state": "Colorado",
"countryOrRegion": "USA",
"postalCode": "80525"
}
}
}
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
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"source": null,
"completionMonthYear": "Date",
"endMonthYear": "Date",
"institution": {
"description": null,
"displayName": "Colorado State University",
"location": {
"type": "business",
"postOfficeBox": null,
"street": "12000 E Prospect Rd",
"city": "Fort Collins",
"state": "Colorado",
"countryOrRegion": "USA",
"postalCode": "80525"
},
"webUrl": "https://www.colostate.edu"
},
"program": {
"abbreviation": "MBA",
"activities": null,
"awards": null,
"description": "Master of Business Administration with a major in Entreprenuership and Finance.",
"displayName": "Master of Business Administration",
"fieldsOfStudy": null,
"grade": "3.9",
"notes": null,
"webUrl": "https://biz.colostate.edu"
},
"startMonthYear": "Date"
}