Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp
Berechtigungen mit den geringsten Berechtigungen
Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)
User.ReadWrite
User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)
User.ReadWrite
Nicht verfügbar.
Anwendung
Nicht unterstützt
Nicht unterstützt
HTTP-Anforderung
POST /me/profile/educationalActivities
POST /users/{id | userPrincipalName}/profile/educationalActivities
Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen eines neuen educationalActivity-Objekts im Profil eines Benutzers festgelegt werden können.
Eigenschaft
Typ
Beschreibung
allowedAudiences
String
Die Zielgruppen, die die in der Entität enthaltenen Werte sehen können. Geerbt von itemFacet. Mögliche Werte: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
completionMonthYear
Datum
Der Monat und das Jahr, in dem der Benutzer die Aktivität abgeschlossen oder abgeschlossen hat.
endMonthYear
Datum
Der Monat und das Jahr, auf den der Benutzer die referenzierte Bildungsaktivität abgeschlossen hat.
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);
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
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"\
}\
'
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
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)
educationalActivities, err := graphClient.Me().Profile().EducationalActivities().Post(context.Background(), requestBody, nil)
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-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);
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-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);
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EducationalActivity;
use Microsoft\Graph\Generated\Models\InstitutionData;
use Microsoft\Graph\Generated\Models\PhysicalAddress;
use Microsoft\Graph\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();
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-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
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.
from msgraph import GraphServiceClient
from msgraph.generated.models.educational_activity import EducationalActivity
from msgraph.generated.models.institution_data import InstitutionData
from msgraph.generated.models.physical_address import PhysicalAddress
from msgraph.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)
Wichtig
Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.