Crear itemPublication

Espacio de nombres: microsoft.graph

Cree un nuevo objeto itemPublication en el perfil de un usuario.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) User.ReadWrite AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All
Delegado (cuenta personal de Microsoft) User.ReadWrite No disponible.
Aplicación No admitida. No admitida.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto itemPublication .

En la tabla siguiente se muestran las propiedades que se pueden establecer al crear un nuevo objeto itemPublication en el perfil de un usuario.

Propiedad Tipo Descripción
allowedAudiences Cadena Las audiencias que pueden ver los valores contenidos dentro de la entidad. Heredado de itemFacet. Los valores posibles son: me, family, contacts, groupMembersorganization, federatedOrganizations, , everyone, , . unknownFutureValue
createdBy identitySet Proporciona el identificador del usuario o aplicación que creó la entidad. Heredado de itemFacet.
createdDateTime DateTimeOffset Proporciona el dateTimeOffset para cuando se creó la entidad. Heredado de itemFacet.
description Cadena Descripción de la publicación.
displayName Cadena Título de la publicación.
id Cadena Identificador que se usa para dirigirse individualmente a la entidad. Heredado de entidad
de inferencia inferenciaData Contiene detalles de inferencia si la entidad se deduce mediante la aplicación de creación o modificación. Heredado de itemFacet.
lastModifiedBy identitySet Proporciona el identificador del usuario o aplicación que modificó por última vez la entidad. Heredado de itemFacet.
lastModifiedDateTime DateTimeOffset Proporciona el dateTimeOffset para cuando se creó la entidad. Heredado de itemFacet.
fechadepublicación Fecha La fecha de publicación de la publicación.
publisher Cadena Publicación o editor de la publicación.
source personDataSource Dónde se originaron los valores si se sincronizaron desde otro servicio. Heredado de itemFacet.
thumbnailUrl Cadena URL que hace referencia a una miniatura de la publicación.
webUrl Cadena Dirección URL que hace referencia a la publicación.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto itemPublication en el cuerpo de la respuesta.

Ejemplos

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

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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