创建 itemPublication

项目
07/18/2022

命名空间：microsoft.graph

权限

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

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

HTTP 请求

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

请求标头

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

请求正文

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

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

属性	类型	Description
allowedAudiences	String	能够查看实体中包含的值的访问群体。继承自 itemFacet。可取值为：`me`、`family`、`contacts`、`groupMembers`、`organization`、`federatedOrganizations`、`everyone`、`unknownFutureValue`。
createdBy	identitySet	提供创建实体的用户和/或应用程序的标识符。继承自 itemFacet。
createdDateTime	DateTimeOffset	提供实体创建时的日期时间Offset。继承自 itemFacet。
说明	String	出版物的说明。
displayName	String	出版物的标题。
id	String	用于单独寻址实体的标识符。继承自实体
inference	inferenceData	如果实体是由创建或修改应用程序推断出来的，则包含推断详细信息。继承自 itemFacet。
lastModifiedBy	identitySet	提供上次修改实体的用户和/或应用程序的标识符。继承自 itemFacet。
lastModifiedDateTime	DateTimeOffset	提供实体创建时的日期时间Offset。继承自 itemFacet。
publishedDate	Date	出版物的发布日期。
发布者	String	出版物Publisher出版物。
source	personDataSource	如果从另一个服务同步，则值源自何处。继承自 itemFacet。
thumbnailUrl	String	引用出版物缩略图的 URL。
WebUrl	String	引用出版物的 URL。

响应

如果成功，此方法在响应正文中返回响应代码和 201 Created itemPublication 对象。

示例

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


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var itemPublication = new ItemPublication
{
    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 = new Date(1900,1,1),
    Publisher = "International Association of Branding Management Publishing",
    ThumbnailUrl = "https://iabm.io/sdhdfhsdhshsd.jpg",
    WebUrl = "https://www.iabm.io"
};

await graphClient.Me.Profile.Publications
    .Request()
    .AddAsync(itemPublication);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


const options = {
    authProvider,
};

const client = Client.init(options);

const itemPublication = {
  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'
};

await client.api('/me/profile/publications')
    .version('beta')
    .post(itemPublication);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/profile/publications"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphItemPublication *itemPublication = [[MSGraphItemPublication alloc] init];
[itemPublication setDescription:@"One persons journey to the top of the branding management field."];
[itemPublication setDisplayName:@"Got Brands? The story of Innocenty Popov and his journey to the top."];
[itemPublication setPublishedDate:@"Date"];
[itemPublication setPublisher:@"International Association of Branding Management Publishing"];
[itemPublication setThumbnailUrl:@"https://iabm.io/sdhdfhsdhshsd.jpg"];
[itemPublication setWebUrl:@"https://www.iabm.io"];

NSError *error;
NSData *itemPublicationData = [itemPublication getSerializedDataWithError:&error];
[urlRequest setHTTPBody:itemPublicationData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

ItemPublication itemPublication = new ItemPublication();
itemPublication.description = "One persons journey to the top of the branding management field.";
itemPublication.displayName = "Got Brands? The story of Innocenty Popov and his journey to the top.";
itemPublication.publishedDate = new DateOnly(1900,1,1);
itemPublication.publisher = "International Association of Branding Management Publishing";
itemPublication.thumbnailUrl = "https://iabm.io/sdhdfhsdhshsd.jpg";
itemPublication.webUrl = "https://www.iabm.io";

graphClient.me().profile().publications()
    .buildRequest()
    .post(itemPublication);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewItemPublication()
description := "One persons journey to the top of the branding management field."
requestBody.SetDescription(&description)
displayName := "Got Brands? The story of Innocenty Popov and his journey to the top."
requestBody.SetDisplayName(&displayName)
publishedDate := "Date"
requestBody.SetPublishedDate(&publishedDate)
publisher := "International Association of Branding Management Publishing"
requestBody.SetPublisher(&publisher)
thumbnailUrl := "https://iabm.io/sdhdfhsdhshsd.jpg"
requestBody.SetThumbnailUrl(&thumbnailUrl)
webUrl := "https://www.iabm.io"
requestBody.SetWebUrl(&webUrl)
result, err := graphClient.Me().Profile().Publications().Post(requestBody)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


Import-Module Microsoft.Graph.People

$params = @{
    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"
}

# A UPN can also be used as -UserId.
New-MgUserProfilePublication -UserId $userId -BodyParameter $params

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

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

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

创建 itemPublication

权限

HTTP 请求

请求标头

请求正文

响应

示例

响应

反馈