Criar a multipúblicoCreate itemPublication

Namespace: microsoft.graphNamespace: microsoft.graph

Criar um novo objeto Dopublication no perfilde um usuário.Create a new itemPublication object in a user's profile.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) User. ReadWrite, User. ReadWrite. AllUser.ReadWrite, User.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) User. ReadWrite, User. ReadWrite. AllUser.ReadWrite, User.ReadWrite.All
AplicativoApplication User.ReadWrite.AllUser.ReadWrite.All

Solicitação HTTPHTTP request

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

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto Dopublication .In the request body, supply a JSON representation of the itemPublication object.

A tabela a seguir mostra as propriedades que são possíveis de definir ao criar um novo objeto de multipúblico no perfilde um usuário.The following table shows the properties that are possible to set when creating a new itemPublication object in a user's profile.

PropriedadeProperty TipoType DescriçãoDescription
allowedAudiencesallowedAudiences StringString As audiências que podem ver os valores contidos na entidade.The audiences that are able to see the values contained within the entity. Herdado de MyFace.Inherited from itemFacet. Os valores possíveis são: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.Possible values are: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
createdBycreatedBy identitySetidentitySet Fornece o identificador do usuário e/ou aplicativo que criou a entidade.Provides the identifier of the user and/or application that created the entity. Herdado de MyFace.Inherited from itemFacet.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Fornece o dateTimeOffset para quando a entidade foi criada.Provides the dateTimeOffset for when the entity was created. Herdado de MyFace.Inherited from itemFacet.
descriptiondescription StringString Descrição da publicação.Description of the publication.
displayNamedisplayName StringString Título da publicação.Title of the publication.
idid StringString Identificador usado para o endereçamento individual da entidade.Identifier used for individually addressing the entity. Herdado da entidadeInherited from entity
fracassainference inferenceDatainferenceData Contém detalhes de inferência se a entidade for inferida pelo aplicativo de criação ou modificação.Contains inference detail if the entity is inferred by the creating or modifying application. Herdado de MyFace.Inherited from itemFacet.
lastModifiedBylastModifiedBy identitySetidentitySet Fornece o identificador do usuário e/ou aplicativo que modificou a entidade pela última vez.Provides the identifier of the user and/or application that last modified the entity. Herdado de MyFace.Inherited from itemFacet.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Fornece o dateTimeOffset para quando a entidade foi criada.Provides the dateTimeOffset for when the entity was created. Herdado de MyFace.Inherited from itemFacet.
publishedDatepublishedDate DataDate A data em que a publicação foi publicada.The date that the publication was published.
publicadorpublisher StringString Publicação ou editor para a publicação.Publication or Publisher for the publication.
sourcesource personDataSourcepersonDataSource Onde os valores são originados se forem sincronizados a partir de outro serviço.Where the values originated if synced from another service. Herdado de MyFace.Inherited from itemFacet.
thumbnailUrlthumbnailUrl StringString URL que faz referência a uma miniatura da publicação.URL referencing a thumbnail of the publication.
webUrlwebUrl StringString URL que faz referência à publicação.URL referencing the publication.

RespostaResponse

Se tiver êxito, este método retornará um 201 Created código de resposta e um objeto dopublication no corpo da resposta.If successful, this method returns a 201 Created response code and an itemPublication object in the response body.

ExemplosExamples

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

{
  "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"
}

RespostaResponse

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.Note: The response object shown here might be shortened for readability.

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"
}