Обновление profileSource

Пространство имен: microsoft.graph

Обновление свойств объекта profileSource .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	PeopleSettings.ReadWrite.All	Недоступно.
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	PeopleSettings.ReadWrite.All	Недоступно.

Важно!

Для делегированного доступа с использованием рабочих или учебных учетных записей администратору должна быть назначена поддерживаемая роль Microsoft Entra. People администратор является наименее привилегированной ролью, поддерживаемой для этой операции.

HTTP-запрос

PATCH /admin/people/profileSources(sourceId='{sourceId}')

Параметры функции

В URL-адресе запроса укажите приведенный ниже параметр и действительное значение.

Параметр	Тип	Описание
sourceId	String	Идентификатор источника профиля, используемый в качестве альтернативного ключа. Обязательный.

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

Примечание: Чтобы избежать проблем с кодировкой, которые искажены для полезных данных, используйте Content-Type: application/json; charset=utf-8.

Текст запроса

В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.

В следующей таблице указаны свойства, которые можно обновить.

Свойство	Тип	Описание
displayName	String	Имя источника профиля, предназначенного для информирования пользователей об имени источника профиля.
kind	String	Тип источника профиля.
Локализации	коллекция profileSourceLocalization	Альтернативные локализованные метки, указанные администратором.
sourceId	String	Идентификатор источника профиля, используемый в качестве альтернативного ключа.
webUrl	String	URL-адрес источника профиля, который направляет пользователей в представление страницы данных профиля.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект profileSource в тексте отклика.

Примеры

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='bamboohr1')
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.profileSource",
  "sourceId": "bamboohr1",
  "kind": "BambooHR",
  "displayName": "BambooHR Updated",
  "webUrl": "https://bamboohr.contoso.com/login",
  "localizations": [
    {
      "displayName": "HR-Platform",
      "webUrl": "http://bamboohr.contoso.com/en-us/login",
      "languageTag": "en-us"
    },
    {
      "displayName": "HR-Plattform",
      "webUrl": "http://bamboohr.contoso.com/de/login",
      "languageTag": "de"
    }
  ]
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new ProfileSource
{
	OdataType = "#microsoft.graph.profileSource",
	SourceId = "bamboohr1",
	Kind = "BambooHR",
	DisplayName = "BambooHR Updated",
	WebUrl = "https://bamboohr.contoso.com/login",
	Localizations = new List<ProfileSourceLocalization>
	{
		new ProfileSourceLocalization
		{
			DisplayName = "HR-Platform",
			WebUrl = "http://bamboohr.contoso.com/en-us/login",
			LanguageTag = "en-us",
		},
		new ProfileSourceLocalization
		{
			DisplayName = "HR-Plattform",
			WebUrl = "http://bamboohr.contoso.com/de/login",
			LanguageTag = "de",
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Admin.People.ProfileSourcesWithSourceId("{sourceId}").PatchAsync(requestBody);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewProfileSource()
sourceId := "bamboohr1"
requestBody.SetSourceId(&sourceId) 
kind := "BambooHR"
requestBody.SetKind(&kind) 
displayName := "BambooHR Updated"
requestBody.SetDisplayName(&displayName) 
webUrl := "https://bamboohr.contoso.com/login"
requestBody.SetWebUrl(&webUrl) 


profileSourceLocalization := graphmodels.NewProfileSourceLocalization()
displayName := "HR-Platform"
profileSourceLocalization.SetDisplayName(&displayName) 
webUrl := "http://bamboohr.contoso.com/en-us/login"
profileSourceLocalization.SetWebUrl(&webUrl) 
languageTag := "en-us"
profileSourceLocalization.SetLanguageTag(&languageTag) 
profileSourceLocalization1 := graphmodels.NewProfileSourceLocalization()
displayName := "HR-Plattform"
profileSourceLocalization1.SetDisplayName(&displayName) 
webUrl := "http://bamboohr.contoso.com/de/login"
profileSourceLocalization1.SetWebUrl(&webUrl) 
languageTag := "de"
profileSourceLocalization1.SetLanguageTag(&languageTag) 

localizations := []graphmodels.ProfileSourceLocalizationable {
	profileSourceLocalization,
	profileSourceLocalization1,
}
requestBody.SetLocalizations(localizations)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sourceId := "{sourceId}"
profileSources, err := graphClient.Admin().People().ProfileSourcesWithSourceId(&sourceId).Patch(context.Background(), requestBody, nil)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ProfileSource profileSource = new ProfileSource();
profileSource.setOdataType("#microsoft.graph.profileSource");
profileSource.setSourceId("bamboohr1");
profileSource.setKind("BambooHR");
profileSource.setDisplayName("BambooHR Updated");
profileSource.setWebUrl("https://bamboohr.contoso.com/login");
LinkedList<ProfileSourceLocalization> localizations = new LinkedList<ProfileSourceLocalization>();
ProfileSourceLocalization profileSourceLocalization = new ProfileSourceLocalization();
profileSourceLocalization.setDisplayName("HR-Platform");
profileSourceLocalization.setWebUrl("http://bamboohr.contoso.com/en-us/login");
profileSourceLocalization.setLanguageTag("en-us");
localizations.add(profileSourceLocalization);
ProfileSourceLocalization profileSourceLocalization1 = new ProfileSourceLocalization();
profileSourceLocalization1.setDisplayName("HR-Plattform");
profileSourceLocalization1.setWebUrl("http://bamboohr.contoso.com/de/login");
profileSourceLocalization1.setLanguageTag("de");
localizations.add(profileSourceLocalization1);
profileSource.setLocalizations(localizations);
ProfileSource result = graphClient.admin().people().profileSourcesWithSourceId("{sourceId}").patch(profileSource);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ProfileSource;
use Microsoft\Graph\Generated\Models\ProfileSourceLocalization;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ProfileSource();
$requestBody->setOdataType('#microsoft.graph.profileSource');
$requestBody->setSourceId('bamboohr1');
$requestBody->setKind('BambooHR');
$requestBody->setDisplayName('BambooHR Updated');
$requestBody->setWebUrl('https://bamboohr.contoso.com/login');
$localizationsProfileSourceLocalization1 = new ProfileSourceLocalization();
$localizationsProfileSourceLocalization1->setDisplayName('HR-Platform');
$localizationsProfileSourceLocalization1->setWebUrl('http://bamboohr.contoso.com/en-us/login');
$localizationsProfileSourceLocalization1->setLanguageTag('en-us');
$localizationsArray []= $localizationsProfileSourceLocalization1;
$localizationsProfileSourceLocalization2 = new ProfileSourceLocalization();
$localizationsProfileSourceLocalization2->setDisplayName('HR-Plattform');
$localizationsProfileSourceLocalization2->setWebUrl('http://bamboohr.contoso.com/de/login');
$localizationsProfileSourceLocalization2->setLanguageTag('de');
$localizationsArray []= $localizationsProfileSourceLocalization2;
$requestBody->setLocalizations($localizationsArray);


$result = $graphServiceClient->admin()->people()->profileSourcesWithSourceId('{sourceId}', )->patch($requestBody)->wait();

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.profile_source import ProfileSource
from msgraph.generated.models.profile_source_localization import ProfileSourceLocalization
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ProfileSource(
	odata_type = "#microsoft.graph.profileSource",
	source_id = "bamboohr1",
	kind = "BambooHR",
	display_name = "BambooHR Updated",
	web_url = "https://bamboohr.contoso.com/login",
	localizations = [
		ProfileSourceLocalization(
			display_name = "HR-Platform",
			web_url = "http://bamboohr.contoso.com/en-us/login",
			language_tag = "en-us",
		),
		ProfileSourceLocalization(
			display_name = "HR-Plattform",
			web_url = "http://bamboohr.contoso.com/de/login",
			language_tag = "de",
		),
	],
)

result = await graph_client.admin.people.profile_sources_with_source_id("{sourceId}").patch(request_body)

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.profileSource",
  "id": "27f1af7b-b166-4f5b-b994-ae135a581547",
  "sourceId": "bamboohr1",
  "kind": "BambooHR",
  "displayName": "BambooHR Updated",
  "webUrl": "https://bamboohr.contoso.com/login",
  "localizations": [
    {
      "displayName": "HR-Platform",
      "webUrl": "http://bamboohr.contoso.com/en-us/login",
      "languageTag": "en-us"
    },
    {
      "displayName": "HR-Plattform",
      "webUrl": "http://bamboohr.contoso.com/de/login",
      "languageTag": "de"
    }
  ]
}

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-04-15

Обновление profileSource

Разрешения

HTTP-запрос

Параметры функции

Заголовки запросов

Текст запроса

Отклик

Примеры

Запрос

Отклик

Обратная связь

Дополнительные ресурсы