Compartilhar via


Criar personAward

Namespace: microsoft.graph

Criar um novo objeto personAward 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

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) 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.

Solicitação HTTP

POST /me/profile/awards
POST /users/{id | userPrincipalName}/profile/awards

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 do pedido, forneça uma representação JSON do objeto personAward .

A tabela seguinte mostra as propriedades que são possíveis de definir ao criar um novo objeto personAward no perfil de um utilizador.

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
description Cadeia de caracteres Descpription do prémio ou honra.
displayName Cadeia de caracteres Nome do prémio ou honra.
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.
issuedDate Data A data em que o prémio ou honra foi concedido.
issuingAuthority Cadeia de caracteres Autoridade que concedeu o prémio ou honra.
source personDataSource Onde os valores tiveram origem se forem sincronizados a partir de outro serviço. Herdado do itemFacet.
thumbnailUrl Cadeia de caracteres URL que referencia uma miniatura do prémio ou honra.
webUrl String URL que referencia o prémio ou honra.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto personAward no corpo da resposta.

Exemplos

POST https://graph.microsoft.com/beta/me/profile/awards
Content-Type: application/json

{
  "description": "Lifetime Achievement award from the International Association of Branding Managers",
  "displayName": "Lifetime Achievement Award For Excellence in Branding",
  "issuedDate": "Date",
  "issuingAuthority": "International Association of Branding Management",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}

Resposta

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

HTTP/1.1 201 Created
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,
  "description": "Lifetime Achievement award from the International Association of Branding Managers",
  "displayName": "Lifetime Achievement Award For Excellence in Branding",
  "issuedDate": "Date",
  "issuingAuthority": "International Association of Branding Management",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}