Criar itemPublication

Namespace: microsoft.graph

Crie um novo objeto itemPublication no perfil de um usuário.

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) 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 da solicitação, forneça uma representação JSON do objeto itemPublication .

A tabela a seguir mostra as propriedades que são possíveis definir ao criar um novo objeto itemPublication no perfil de um usuário.

Propriedade Tipo Descrição
allowedAudiences Cadeia de caracteres Os públicos que podem ver os valores contidos na entidade. Herdado de itemFacet. Os valores possíveis são: me, family, contacts, groupMembersorganization, , federatedOrganizations, , everyone, . unknownFutureValue
createdBy identitySet Fornece o identificador do usuário e/ou aplicativo que criou a entidade. Herdado de itemFacet.
createdDateTime DateTimeOffset Fornece o dateTimeOffset de quando a entidade foi criada. Herdado de itemFacet.
description Cadeia de caracteres Descrição da publicação.
displayName Cadeia de caracteres Título da publicação.
id Cadeia de caracteres Identificador usado para endereçar individualmente a entidade. Herdado da entidade
de inferência inferenceData Contém detalhes de inferência se a entidade for inferida pelo aplicativo de criação ou modificação. Herdado de itemFacet.
lastModifiedBy identitySet Fornece o identificador do usuário e/ou aplicativo que modificou a entidade pela última vez. Herdado de itemFacet.
lastModifiedDateTime DateTimeOffset Fornece o dateTimeOffset de quando a entidade foi criada. Herdado de itemFacet.
publishedDate Data A data em que a publicação foi publicada.
publicador Cadeia de caracteres Publicação ou Editora para a publicação.
source personDataSource De onde os valores se originaram, se sincronizados de outro serviço. Herdado de itemFacet.
thumbnailUrl Cadeia de caracteres URL que faz referência a uma miniatura da publicação.
webUrl String URL que faz referência à publicação.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created 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"
}