Crear workPosition

Espacio de nombres: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en v1.0, use el selector de versiones.

Use esta API para crear una nueva workPosition en el perfil de un usuario.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) User.ReadWrite, User.ReadWrite.All
Delegado (cuenta personal de Microsoft) User.ReadWrite, User.ReadWrite.All
Aplicación User.ReadWrite.All

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

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

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

Propiedad Tipo Descripción
allowedAudiences Cadena Audiencias que pueden ver los valores contenidos en la entidad. Heredado de itemFacet. Los valores posibles son: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone y unknownFutureValue.
categories Colección string Categorías que el usuario ha asociado a esta posición.
compañeros colección relatedPerson Compañeros asociados a esta posición.
detalle positionDetail Contiene información detallada sobre la posición.
inferencia inferenceData Contiene detalles de inferencia si la entidad se deduce mediante la creación o modificación de la aplicación. Heredado de itemFacet.
isCurrent Booleano Indica si la posición es actual o no.
manager relatedPerson Contiene detalles del administrador del usuario en esta posición.
source personDataSource Donde se originaron los valores si se sincronizaron desde otro servicio. Heredado de itemFacet.

Respuesta

Si se realiza correctamente, este método devuelve 201, Created código de respuesta y un nuevo objeto workPosition en el cuerpo de la respuesta.

Ejemplos

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/beta/me/profile/positions
Content-type: application/json

{
  "detail": {
    "company": {
      "displayName": "Adventureworks Ltd.",
      "department": "Consulting",
      "officeLocation": "AW23/344",
      "address": {
        "type": "business",
        "street": "123 Patriachy Ponds",
        "city": "Moscow",
        "countryOrRegion": "Russian Federation",
        "postalCode": "RU-34621"
      },
      "webUrl": "https://www.adventureworks.com"
    },
    "jobTitle": "Senior Product Branding Manager II",
    "role": "consulting"
  },
  "isCurrent": true
}

Respuesta

Este es un ejemplo de la 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,
  "categories": null,
  "detail": {
    "company": {
      "displayName": "Adventureworks Ltd.",
      "pronunciation": null,
      "department": "Consulting",
      "officeLocation": "AW23/344",
      "address": {
        "type": "business",
        "postOfficeBox": null,
        "street": "123 Patriachy Ponds",
        "city": "Moscow",
        "state": null,
        "countryOrRegion": "Russian Federation",
        "postalCode": "RU-34621"
      },
      "webUrl": "https://www.adventureworks.com"
    },
    "description": null,
    "endMonthYear": null,
    "jobTitle": "Senior Product Branding Manager II",
    "role": "consulting",
    "startMonthYear": "datetime-value",
    "summary": null
  },
  "manager": null,
  "colleagues": null,
  "isCurrent": true
}