更新 personCertification
本文内容
命名空间：microsoft.graph
从用户配置文件 更新 personCertification 对象 的属性 。
权限
要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限 。
权限类型
权限（从最低特权到最高特权）
委派（工作或学校帐户）
User.ReadWrite、User.ReadWrite.All
委派（个人 Microsoft 帐户）
User.ReadWrite、User.ReadWrite.All
应用程序
User.ReadWrite.All
HTTP 请求
PATCH /me/profile/certifications/{id}
PATCH /users/{id | userPrincipalName}/profile/certifications/{id}
名称
说明
Authorization
Bearer {token}。必需。
Content-Type
application/json. Required.
请求正文
在请求正文中，提供应更新的相关字段的值。 请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。 为了获得最佳性能，请勿加入尚未更改的现有值。
属性
类型
说明
allowedAudiences
String
能够查看实体中包含的值的访问群体。 继承自 itemFacet 。 可取值为：me、family、contacts、groupMembers、organization、federatedOrganizations、everyone、unknownFutureValue。
certificationId
String
证书的可引用标识符。
说明
String
认证说明。
displayName
String
认证的标题。
endDate
日期
认证到期的日期。
inference
inferenceData 如果实体是由创建或修改应用程序推断出来的，则包含推断详细信息。 继承自 itemFacet 。
issuedDate
Date
颁发证书的日期。
issuingAuthority
String
授予证书的颁发机构。
issuingCompany
String
授予证书的颁发机构。
startDate
日期
认证生效的日期。
thumbnailUrl
String
引用认证缩略图的 URL。
WebUrl
String
引用证书的 URL。
响应
如果成功，此方法在响应正文中返回 响应代码和更新的 200 OK personCertification 对象。
示例
请求
PATCH https://graph.microsoft.com/beta/users/{userId}/profile/certifications/{id}
Content-Type: application/json
{
"issuingAuthority": "International Academy of Marketing Excellence",
"issuingCompany": "International Academy of Marketing Excellence"
}
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var personCertification = new PersonCertification
{
IssuingAuthority = "International Academy of Marketing Excellence",
IssuingCompany = "International Academy of Marketing Excellence"
};
await graphClient.Users["{user-id}"].Profile.Certifications["{personCertification-id}"]
.Request()
.UpdateAsync(personCertification);
const options = {
authProvider,
};
const client = Client.init(options);
const personCertification = {
issuingAuthority: 'International Academy of Marketing Excellence',
issuingCompany: 'International Academy of Marketing Excellence'
};
await client.api('/users/{userId}/profile/certifications/{id}')
.version('beta')
.update(personCertification);
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/{userId}/profile/certifications/{id}"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
MSGraphPersonCertification *personCertification = [[MSGraphPersonCertification alloc] init];
[personCertification setIssuingAuthority:@"International Academy of Marketing Excellence"];
[personCertification setIssuingCompany:@"International Academy of Marketing Excellence"];
NSError *error;
NSData *personCertificationData = [personCertification getSerializedDataWithError:&error];
[urlRequest setHTTPBody:personCertificationData];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
PersonCertification personCertification = new PersonCertification();
personCertification.issuingAuthority = "International Academy of Marketing Excellence";
personCertification.issuingCompany = "International Academy of Marketing Excellence";
graphClient.users("{userId}").profile().certifications("{id}")
.buildRequest()
.patch(personCertification);
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewPersonCertification()
issuingAuthority := "International Academy of Marketing Excellence"
requestBody.SetIssuingAuthority(&issuingAuthority)
issuingCompany := "International Academy of Marketing Excellence"
requestBody.SetIssuingCompany(&issuingCompany)
userId := "user-id"
personCertificationId := "personCertification-id"
graphClient.UsersById(&userId).Profile().CertificationsById(&personCertificationId).Patch(requestBody)
Import-Module Microsoft.Graph.People
$params = @{
IssuingAuthority = "International Academy of Marketing Excellence"
IssuingCompany = "International Academy of Marketing Excellence"
}
Update-MgUserProfileCertification -UserId $userId -PersonCertificationId $personCertificationId -BodyParameter $params
响应
注意： 为了提高可读性，可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
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,
"certificationId": "KB-1235466333663322",
"description": "Blackbelt in Marketing - Brand Management",
"displayName": "Marketing Blackbelt - Brand Management",
"endDate": "Date",
"issuedDate": "Date",
"issuingAuthority": "International Academy of Marketing Excellence",
"issuingCompany": "International Academy of Marketing Excellence",
"startDate": "Date",
"thumbnailUrl": "https://iame.io/dfhdfdfd334.jpg",
"webUrl": "https://www.iame.io/blackbelt"
}