Compartilhar via


Criar itemPublicação

Namespace: microsoft.graph

Criar um novo objeto itemPublication 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/publications
POST /users/{id | userPrincipalName}/profile/publications

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

A tabela seguinte mostra as propriedades que são possíveis de definir ao criar um novo objeto itemPublication 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
createdBy identitySet Fornece o identificador do utilizador e/ou aplicação que criou a entidade. Herdado do itemFacet.
createdDateTime DateTimeOffset Fornece dateTimeOffset para quando a entidade foi criada. Herdado do itemFacet.
description Cadeia de caracteres Descrição da publicação.
displayName Cadeia de caracteres Título da publicação.
id Cadeia de caracteres Identificador utilizado para endereçar individualmente a entidade. Herdado da entidade
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.
lastModifiedBy identitySet Fornece o identificador do utilizador e/ou aplicação que modificou a entidade pela última vez. Herdado do itemFacet.
lastModifiedDateTime DateTimeOffset Fornece dateTimeOffset para quando a entidade foi criada. Herdado do itemFacet.
publishedDate Data A data em que a publicação foi publicada.
publicador Cadeia de caracteres Publicação ou Publicador para a publicação.
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 da publicação.
webUrl String URL que referencia a publicação.

Resposta

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

Exemplos

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

{
  "description": "One persons journey to the top of the branding management field.",
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",
  "publishedDate": "Date",
  "publisher": "International Association of Branding Management Publishing",
  "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": "One persons journey to the top of the branding management field.",
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",
  "publishedDate": "Date",
  "publisher": "International Association of Branding Management Publishing",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}