Criar workPositionCreate workPosition

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs sob /beta a versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível na versão 1.0, use o seletor de versão.To determine whether an API is available in v1.0, use the Version selector.

Use esta API para criar um novo workPosition no perfilde um usuário.Use this API to create a new workPosition 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/positions
POST /users/{id | userPrincipalName}/profile/positions

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 workPosition .In the request body, supply a JSON representation of workPosition object.

A tabela a seguir mostra as propriedades que são possíveis de definir quando você cria um novo objeto workPosition no perfilde um usuário.The following table shows the properties that are possible to set when you create a new workPosition 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.
categoriescategories Coleção de cadeias de caracteresString collection Categorias que o usuário tenha associado a esta posição.Categories that the user has associated with this position.
conhecidoscolleagues coleção relatedPersonrelatedPerson collection Colegas associados a esta posição.Colleagues that are associated with this position.
detalhadadetail positionDetailpositionDetail Contém informações detalhadas sobre a posição.Contains detailed information about the position.
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.
IsCurrentisCurrent BoolianoBoolean Indica se a posição é ou não atual.Denotes whether or not the position is current.
managermanager relatedPersonrelatedPerson Contém detalhes do gerente do usuário nesta posição.Contains detail of the user's manager in this position.
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.

RespostaResponse

Se bem-sucedido, este método retorna 201, Created um código de resposta e um novo objeto workPosition no corpo da resposta.If successful, this method returns 201, Created response code and a new workPosition object in the response body.

ExemplosExamples

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

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
}

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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
}