API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения
Разрешения с наименьшими привилегиями
Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)
User.ReadWrite
User.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)
User.ReadWrite
Недоступно.
Для приложений
Не поддерживается.
Не поддерживается.
HTTP-запрос
POST /me/profile/educationalActivities
POST /users/{id | userPrincipalName}/profile/educationalActivities
В тексте запроса укажите представление объекта educationalActivity в формате JSON.
В следующей таблице показаны свойства, которые можно задать при создании нового объекта educationalActivity в профиле пользователя.
Свойство
Тип
Описание
allowedAudiences
String
Аудитории, которые могут видеть значения, содержащиеся в сущности. Наследуется от itemFacet. Возможные значения: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
completionMonthYear
Date
Месяц и год, когда пользователь завершил или завершил действие.
endMonthYear
Date
Месяц и год, когда пользователь завершил учебное действие, на которое ссылается ссылка.
POST https://graph.microsoft.com/beta/me/profile/educationalActivities
Content-type: application/json
{
"completionMonthYear": "Date",
"endMonthYear": "Date",
"institution": {
"description": null,
"displayName": "Colorado State University",
"location": {
"type": "business",
"postOfficeBox": null,
"street": "12000 E Prospect Rd",
"city": "Fort Collins",
"state": "Colorado",
"countryOrRegion": "USA",
"postalCode": "80525"
},
"webUrl": "https://www.colostate.edu"
},
"program": {
"abbreviation": "MBA",
"activities": null,
"awards": null,
"description": "Master of Business Administration with a major in Entreprenuership and Finance.",
"displayName": "Master of Business Administration",
"fieldsOfStudy": null,
"grade": "3.9",
"notes": null,
"webUrl": "https://biz.colostate.edu"
},
"startMonthYear": "Date"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new EducationalActivity
{
CompletionMonthYear = new Date(DateTime.Parse("Date")),
EndMonthYear = new Date(DateTime.Parse("Date")),
Institution = new InstitutionData
{
Description = null,
DisplayName = "Colorado State University",
Location = new PhysicalAddress
{
Type = PhysicalAddressType.Business,
PostOfficeBox = null,
Street = "12000 E Prospect Rd",
City = "Fort Collins",
State = "Colorado",
CountryOrRegion = "USA",
PostalCode = "80525",
},
WebUrl = "https://www.colostate.edu",
},
Program = new EducationalActivityDetail
{
Abbreviation = "MBA",
Activities = null,
Awards = null,
Description = "Master of Business Administration with a major in Entreprenuership and Finance.",
DisplayName = "Master of Business Administration",
FieldsOfStudy = null,
Grade = "3.9",
Notes = null,
WebUrl = "https://biz.colostate.edu",
},
StartMonthYear = new Date(DateTime.Parse("Date")),
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Profile.EducationalActivities.PostAsync(requestBody);
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
mgc-beta users profile educational-activities create --user-id {user-id} --body '{\
"completionMonthYear": "Date",\
"endMonthYear": "Date",\
"institution": {\
"description": null,\
"displayName": "Colorado State University",\
"location": {\
"type": "business",\
"postOfficeBox": null,\
"street": "12000 E Prospect Rd",\
"city": "Fort Collins",\
"state": "Colorado",\
"countryOrRegion": "USA",\
"postalCode": "80525"\
},\
"webUrl": "https://www.colostate.edu"\
},\
"program": {\
"abbreviation": "MBA",\
"activities": null,\
"awards": null,\
"description": "Master of Business Administration with a major in Entreprenuership and Finance.",\
"displayName": "Master of Business Administration",\
"fieldsOfStudy": null,\
"grade": "3.9",\
"notes": null,\
"webUrl": "https://biz.colostate.edu"\
},\
"startMonthYear": "Date"\
}\
'
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewEducationalActivity()
completionMonthYear := date
requestBody.SetCompletionMonthYear(&completionMonthYear)
endMonthYear := date
requestBody.SetEndMonthYear(&endMonthYear)
institution := graphmodels.NewInstitutionData()
description := null
institution.SetDescription(&description)
displayName := "Colorado State University"
institution.SetDisplayName(&displayName)
location := graphmodels.NewPhysicalAddress()
type := graphmodels.BUSINESS_PHYSICALADDRESSTYPE
location.SetType(&type)
postOfficeBox := null
location.SetPostOfficeBox(&postOfficeBox)
street := "12000 E Prospect Rd"
location.SetStreet(&street)
city := "Fort Collins"
location.SetCity(&city)
state := "Colorado"
location.SetState(&state)
countryOrRegion := "USA"
location.SetCountryOrRegion(&countryOrRegion)
postalCode := "80525"
location.SetPostalCode(&postalCode)
institution.SetLocation(location)
webUrl := "https://www.colostate.edu"
institution.SetWebUrl(&webUrl)
requestBody.SetInstitution(institution)
program := graphmodels.NewEducationalActivityDetail()
abbreviation := "MBA"
program.SetAbbreviation(&abbreviation)
activities := null
program.SetActivities(&activities)
awards := null
program.SetAwards(&awards)
description := "Master of Business Administration with a major in Entreprenuership and Finance."
program.SetDescription(&description)
displayName := "Master of Business Administration"
program.SetDisplayName(&displayName)
fieldsOfStudy := null
program.SetFieldsOfStudy(&fieldsOfStudy)
grade := "3.9"
program.SetGrade(&grade)
notes := null
program.SetNotes(¬es)
webUrl := "https://biz.colostate.edu"
program.SetWebUrl(&webUrl)
requestBody.SetProgram(program)
startMonthYear := date
requestBody.SetStartMonthYear(&startMonthYear)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
educationalActivities, err := graphClient.Me().Profile().EducationalActivities().Post(context.Background(), requestBody, nil)
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EducationalActivity educationalActivity = new EducationalActivity();
LocalDate completionMonthYear = LocalDate.parse("Date");
educationalActivity.setCompletionMonthYear(completionMonthYear);
LocalDate endMonthYear = LocalDate.parse("Date");
educationalActivity.setEndMonthYear(endMonthYear);
InstitutionData institution = new InstitutionData();
institution.setDescription(null);
institution.setDisplayName("Colorado State University");
PhysicalAddress location = new PhysicalAddress();
location.setType(PhysicalAddressType.Business);
location.setPostOfficeBox(null);
location.setStreet("12000 E Prospect Rd");
location.setCity("Fort Collins");
location.setState("Colorado");
location.setCountryOrRegion("USA");
location.setPostalCode("80525");
institution.setLocation(location);
institution.setWebUrl("https://www.colostate.edu");
educationalActivity.setInstitution(institution);
EducationalActivityDetail program = new EducationalActivityDetail();
program.setAbbreviation("MBA");
program.setActivities(null);
program.setAwards(null);
program.setDescription("Master of Business Administration with a major in Entreprenuership and Finance.");
program.setDisplayName("Master of Business Administration");
program.setFieldsOfStudy(null);
program.setGrade("3.9");
program.setNotes(null);
program.setWebUrl("https://biz.colostate.edu");
educationalActivity.setProgram(program);
LocalDate startMonthYear = LocalDate.parse("Date");
educationalActivity.setStartMonthYear(startMonthYear);
EducationalActivity result = graphClient.me().profile().educationalActivities().post(educationalActivity);
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
const options = {
authProvider,
};
const client = Client.init(options);
const educationalActivity = {
completionMonthYear: 'Date',
endMonthYear: 'Date',
institution: {
description: null,
displayName: 'Colorado State University',
location: {
type: 'business',
postOfficeBox: null,
street: '12000 E Prospect Rd',
city: 'Fort Collins',
state: 'Colorado',
countryOrRegion: 'USA',
postalCode: '80525'
},
webUrl: 'https://www.colostate.edu'
},
program: {
abbreviation: 'MBA',
activities: null,
awards: null,
description: 'Master of Business Administration with a major in Entreprenuership and Finance.',
displayName: 'Master of Business Administration',
fieldsOfStudy: null,
grade: '3.9',
notes: null,
webUrl: 'https://biz.colostate.edu'
},
startMonthYear: 'Date'
};
await client.api('/me/profile/educationalActivities')
.version('beta')
.post(educationalActivity);
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\EducationalActivity;
use Microsoft\Kiota\Abstractions\Types\Date;
use Microsoft\Graph\Beta\Generated\Models\InstitutionData;
use Microsoft\Graph\Beta\Generated\Models\PhysicalAddress;
use Microsoft\Graph\Beta\Generated\Models\PhysicalAddressType;
use Microsoft\Graph\Beta\Generated\Models\EducationalActivityDetail;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EducationalActivity();
$requestBody->setCompletionMonthYear(new Date('Date'));
$requestBody->setEndMonthYear(new Date('Date'));
$institution = new InstitutionData();
$institution->setDescription(null);
$institution->setDisplayName('Colorado State University');
$institutionLocation = new PhysicalAddress();
$institutionLocation->setType(new PhysicalAddressType('business'));
$institutionLocation->setPostOfficeBox(null);
$institutionLocation->setStreet('12000 E Prospect Rd');
$institutionLocation->setCity('Fort Collins');
$institutionLocation->setState('Colorado');
$institutionLocation->setCountryOrRegion('USA');
$institutionLocation->setPostalCode('80525');
$institution->setLocation($institutionLocation);
$institution->setWebUrl('https://www.colostate.edu');
$requestBody->setInstitution($institution);
$program = new EducationalActivityDetail();
$program->setAbbreviation('MBA');
$program->setActivities(null);
$program->setAwards(null);
$program->setDescription('Master of Business Administration with a major in Entreprenuership and Finance.');
$program->setDisplayName('Master of Business Administration');
$program->setFieldsOfStudy(null);
$program->setGrade('3.9');
$program->setNotes(null);
$program->setWebUrl('https://biz.colostate.edu');
$requestBody->setProgram($program);
$requestBody->setStartMonthYear(new Date('Date'));
$result = $graphServiceClient->me()->profile()->educationalActivities()->post($requestBody)->wait();
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
Import-Module Microsoft.Graph.Beta.People
$params = @{
completionMonthYear = "Date"
endMonthYear = "Date"
institution = @{
description = $null
displayName = "Colorado State University"
location = @{
type = "business"
postOfficeBox = $null
street = "12000 E Prospect Rd"
city = "Fort Collins"
state = "Colorado"
countryOrRegion = "USA"
postalCode = "80525"
}
webUrl = "https://www.colostate.edu"
}
program = @{
abbreviation = "MBA"
activities = $null
awards = $null
description = "Master of Business Administration with a major in Entreprenuership and Finance."
displayName = "Master of Business Administration"
fieldsOfStudy = $null
grade = "3.9"
notes = $null
webUrl = "https://biz.colostate.edu"
}
startMonthYear = "Date"
}
# A UPN can also be used as -UserId.
New-MgBetaUserProfileEducationalActivity -UserId $userId -BodyParameter $params
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.educational_activity import EducationalActivity
from msgraph_beta.generated.models.institution_data import InstitutionData
from msgraph_beta.generated.models.physical_address import PhysicalAddress
from msgraph_beta.generated.models.physical_address_type import PhysicalAddressType
from msgraph_beta.generated.models.educational_activity_detail import EducationalActivityDetail
graph_client = GraphServiceClient(credentials, scopes)
request_body = EducationalActivity(
completion_month_year = "Date",
end_month_year = "Date",
institution = InstitutionData(
description = None,
display_name = "Colorado State University",
location = PhysicalAddress(
type = PhysicalAddressType.Business,
post_office_box = None,
street = "12000 E Prospect Rd",
city = "Fort Collins",
state = "Colorado",
country_or_region = "USA",
postal_code = "80525",
),
web_url = "https://www.colostate.edu",
),
program = EducationalActivityDetail(
abbreviation = "MBA",
activities = None,
awards = None,
description = "Master of Business Administration with a major in Entreprenuership and Finance.",
display_name = "Master of Business Administration",
fields_of_study = None,
grade = "3.9",
notes = None,
web_url = "https://biz.colostate.edu",
),
start_month_year = "Date",
)
result = await graph_client.me.profile.educational_activities.post(request_body)
Важно!
Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.