反馈 编辑

创建 projectParticipation

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

使用此 API 在用户配置文件中创建新的 projectParticipation 对象。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） User.ReadWrite、User.ReadWrite.All
委派（个人 Microsoft 帐户） User.ReadWrite、User.ReadWrite.All
应用程序 User.ReadWrite.All

HTTP 请求

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

请求标头

名称 说明
Authorization Bearer {token}。必需。
Content-Type application/json. Required.

请求正文

在请求正文中，提供 projectParticipation 对象的 JSON 表示形式。

下表显示了在用户配置文件中创建新的 projectParticipation 对象时可以设置 的属性。

属性 类型 Description
allowedAudiences String 能够查看实体中包含的值的访问群体。 继承自 itemFacet。 可取值为：me、family、contacts、groupMembers、organization、federatedOrganizations、everyone、unknownFutureValue。
categories String 集合 包含用户与项目计划关联的类别 (例如，数字转换、国家/) 。
client companyDetail 包含有关项目用于的客户端的详细信息。
collaborationTags 字符串集合 包含用户与兴趣相关联的体验方案标记。 集合中允许的值为 askMeAbout ableToMentor ：、、、。 wantsToLearn wantsToImprove
同事 relatedPerson 集合 列出同样从事项目工作的人。
detail positionDetail 包含有关用户在项目上的角色的详细信息。
displayName String 包含项目的友好名称。
inference inferenceData 如果实体是由创建或修改应用程序推断出来的，则包含推断详细信息。 继承自 itemFacet。
source personDataSource 如果从另一个服务同步，则值源自何处。 继承自 itemFacet。
发起人 relatedPerson 集合 为项目提供赞助的一个或多个人员。

关系

响应

如果成功，此方法在 201, Created 响应正文中返回 响应代码和一个新的 projectParticipation 对象。

示例

请求

下面展示了示例请求。

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

{
  "categories": [
    "Branding"
  ],
  "client": {
    "displayName": "Contoso Ltd.",
    "department": "Corporate Marketing",
    "webUrl": "https://www.contoso.com"
  },
  "displayName": "Contoso Re-branding Project",
  "detail": {
    "company": {
      "displayName": "Adventureworks Inc.",
      "department": "Consulting",
      "webUrl": "https://adventureworks.com"
    },
    "description": "Rebranding of Contoso Ltd.",
    "jobTitle": "Lead PM Rebranding",
    "role": "project management",
    "summary": "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
  }
}

响应

下面展示了示例响应。

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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": [
    "Branding"
  ],
  "client": {
    "displayName": "Contoso Ltd.",
    "pronunciation": null,
    "department": "Corporate Marketing",
    "officeLocation": null,
    "address": null,
    "webUrl": "https://www.contoso.com"
  },
  "displayName": "Contoso Re-branding Project",
  "detail": {
    "company": {
      "displayName": "Adventureworks Inc.",
      "pronunciation": null,
      "department": "Consulting",
      "officeLocation": null,
      "address": null,
      "webUrl": "https://adventureworks.com"
    },
    "description": "Rebranding of Contoso Ltd.",
    "endMonthYear": "datetime-value",
    "jobTitle": "Lead PM Rebranding",
    "role": "project management",
    "startMonthYear": "datetime-value",
    "summary": "A 6 month project to help Contoso rebrand after they were divested from a parent organization."
  },
  "colleagues": null,
  "sponsors": null
}