Обновление organizationalBrandingLocalization
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновите свойства объекта organizationalBrandingLocalization для конкретной локализации.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
В делегированных сценариях только пользователи с рольюадминистратора фирменной символики организации Microsoft Entra могут полностью управлять фирменной символикой организации.
HTTP-запрос
Чтобы обновить типы данных String, такие как signInPageText и usernameHintText, используйте метод PATCH. Для обновления Stream типов данных, таких как backgroundLogo и backgroundImage, используйте метод PUT. Вы не можете обновить типы Stream с другими типами данных в том же запросе.
PATCH /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}
PUT /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}/{Stream object type such as backgroundImage}
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
Укажите в тексте запроса только значения обновляемых свойств. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
Свойство | Тип | Описание |
---|---|---|
backgroundColor | String | Цвет, который отображается вместо фонового изображения в подключениях с низкой пропускной способностью. Рекомендуется использовать основной цвет логотипа баннера или цвет организации. Укажите его в шестнадцатеричном формате, например белый — #FFFFFF . |
Backgroundimage | Поток | Изображение, отображающееся в качестве фона страницы входа. Допустимые типы: PNG или JPEG размером не менее 300 КБ и размером не более 1920 × 1080 пикселей. Изображение меньшего размера снизит требования к пропускной способности и ускорит загрузку страницы. |
bannerLogo | Поток | Баннерная версия логотипа вашей компании, которая отображается на странице входа. Допустимые типы: PNG или JPEG размером не более 36 × 245 пикселей. Рекомендуется использовать прозрачное изображение без набивки вокруг логотипа. |
contentНастройка | contentНастройка | Представляет различные параметры содержимого, которые необходимо настроить в потоке проверки подлинности для клиента. ПРИМЕЧАНИЕ: Поддерживается только клиентом Microsoft Entra ID для клиентов. |
customAccountResetCredentialsUrl | String | Настраиваемый URL-адрес для сброса учетных данных учетной записи. Этот URL-адрес должен быть в формате ASCII или символы, отличные от ASCII, должны быть закодированы и не должны превышать 128 символов. |
customCannotAccessYourAccountText | String | Строка, заменяющая текст гиперссылки по умолчанию "Не удается получить доступ к учетной записи?" для самостоятельного сброса пароля (SSPR) на странице входа. Этот текст должен быть в формате Юникода и не превышать 256 символов. |
customCSS | Поток | Стили CSS, отображаемые на странице входа. Допустимый формат только .css и не превышает 25 КБ. |
customForgotMyPasswordText | String | Строка, заменяющая текст гиперссылки по умолчанию "Забыли пароль" в форме входа. Этот текст должен быть в формате Юникода и не превышать 256 символов. |
customPrivacyAndCookiesText | String | Строка, заменяющая текст гиперссылки по умолчанию "Конфиденциальность и файлы cookie" в нижнем колонтитуле. Этот текст должен быть в формате Юникода и не превышать 256 символов. |
customPrivacyAndCookiesUrl | String | Настраиваемый URL-адрес, заменяющий URL-адрес гиперссылки "Конфиденциальность и файлы cookie" по умолчанию в нижнем колонтитуле. Этот URL-адрес должен быть в формате ASCII или символы, отличные от ASCII, должны быть закодированы и не должны превышать 128 символов. |
customTermsOfUseText | String | Строка для замены текста гиперссылки "Условия использования" по умолчанию в нижнем колонтитуле. Этот текст должен быть в формате Юникода и не превышать 256 символов. |
customTermsOfUseUrl | String | Настраиваемый URL-адрес, заменяющий URL-адрес гиперссылки "Условия использования" по умолчанию в нижнем колонтитуле. Этот URL-адрес должен иметь формат ASCII или символы, отличные от ASCII, должны быть закодированы и не должны превышать 128 символов. |
Значок | Поток | Настраиваемый значок (favicon) для замены favicon продукта Майкрософт по умолчанию в клиенте Microsoft Entra. |
headerBackgroundColor | String | Цвет RGB, применяемый для настройки цвета заголовка. |
headerLogo | Поток | Логотип компании, который отображается в заголовке страницы входа. Допустимые типы: PNG или JPEG размером не более 36 × 245 пикселей. Рекомендуется использовать прозрачное изображение без набивки вокруг логотипа. |
loginPageLayoutConfiguration | loginPageLayoutConfiguration | Представляет конфигурацию макета, отображаемую на странице входа для клиента. |
loginPageTextVisibilitySettings | loginPageTextVisibilitySettings | Представляет различные тексты, которые можно скрыть на странице входа для клиента. Все свойства можно обновить. |
signInPageText | String | Текст, отображаемый в нижней части поля входа. Используйте его для передачи дополнительных сведений, таких как номер телефона в службу поддержки или юридическое заявление. Текст должен быть в формате Юникода и не превышать 1024 символов. |
squareLogo | Поток | Квадратная версия логотипа вашей компании, которая отображается в Windows 10 встроенных интерфейсов (OOBE) и при включении Windows Autopilot для развертывания. Допустимые типы: PNG или JPEG размером не более 240 x 240 пикселей и размером не более 10 КБ. Рекомендуется использовать прозрачное изображение без набивки вокруг логотипа. |
squareLogoDark | Поток | Квадратная темная версия логотипа компании, которая отображается в Windows 10 встроенных интерфейсов (OOBE) и при включении Windows Autopilot для развертывания. Допустимые типы: PNG или JPEG размером не более 240 x 240 пикселей и размером не более 10 КБ. Рекомендуется использовать прозрачное изображение без набивки вокруг логотипа. |
usernameHintText | String | Строка, которая отображается в виде подсказки в текстовом поле имя пользователя на экране входа. Этот текст должен быть юникодом, без ссылок или кода и не может превышать 64 символов. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 No Content
.
Примеры
Пример 1. Настройка bannerLogo для локализации fr-FR с помощью PUT
Следующий запрос обновляет логотип баннера для локализации fr-FR.
Запрос
Ниже показан пример запроса.
PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR/bannerLogo
Content-Type: image/jpeg
<Image>
Отклик
HTTP/1.1 204 No Content
Пример 2. Обновление backgroundColor и signInPageText для локализации fr-FR с помощью PATCH
Следующий запрос обновляет логотип баннера для локализации fr-FR
.
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR
Content-Type: application/json
{
"backgroundColor":"#00000F",
"signInPageText": "Welcome to Contoso France"
}
Отклик
HTTP/1.1 204 No Content
Пример 3. Переопределение значения фирменной символики по умолчанию пустой строкой
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR
Content-Type: application/json
{
"signInPageText": "Welcome to Contoso France.",
"usernameHintText":" "
}
Отклик
После запроса usernameHintText для fr-FR
локализации будет пустым вместо наследования значения от объекта фирменной символики по умолчанию.
HTTP/1.1 204 No Content
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по