Update organizationalBranding

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

更新 由组织品牌 资源指定的默认品牌对象的属性。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） OrganizationalBranding.ReadWrite.All Organization.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 OrganizationalBranding.ReadWrite.All Organization.ReadWrite.All

对于委派方案，只有具有组织品牌管理员Microsoft Entra角色的用户才能完全管理组织的品牌。

HTTP 请求

若要更新 String 数据类型（如 signInPageText 和 usernameHintText），请使用 PATCH 方法。 若要更新Stream数据类型（如 backgroundLogo 和 backgroundImage），请使用 PUT 方法。 不能在同一请求中使用其他数据类型更新Stream类型。

PATCH /organization/{organizationId}/branding
PUT /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}/{Stream object type such as backgroundImage}

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。
Accept-Language 有效的 ISO 639-1 区域设置或 0 默认区域设置。 必填。

请求正文

在请求正文中，仅提供应更新的属性的值。 请求正文中未包含的现有属性会保留其以前的值，或者根据对其他属性值的更改重新计算。

下表指定可更新的属性。

属性 类型 说明
backgroundColor String 在低带宽连接中代替背景图像显示的颜色。 建议使用横幅徽标或组织颜色的主要颜色。 以十六进制格式指定此项，例如，白色 为 #FFFFFF。
backgroundImage Stream 显示为登录页背景的图像。 允许的类型为不小于 300 KB 且不大于 1920 × 1080 像素的 PNG 或 JPEG。 较小的映像将降低带宽要求，并加快页面加载速度。
bannerLogo Stream 登录页上显示的公司徽标的横幅版本。 允许的类型为不大于 245 x 36 像素的 PNG 或 JPEG。 建议使用徽标周围没有填充的透明图像。
contentCustomization contentCustomization 表示要在整个租户身份验证流中自定义的各种内容选项。

注意：仅受客户租户Microsoft Entra ID支持。
customAccountResetCredentialsUrl String 用于重置帐户凭据的自定义 URL。 此 URL 必须采用 ASCII 格式，或者非 ASCII 字符必须经过 URL 编码，且不超过 128 个字符。
customCannotAccessYourAccountText String 一个字符串，用于替换登录页上的默认“无法访问帐户？”自助服务密码重置 (SSPR) 超链接文本。 此文本必须采用 Unicode 格式，且不超过 256 个字符。
customCSS Stream 登录页上显示的 CSS 样式。 允许的格式仅.css格式，且不大于 25KB。
customForgotMyPasswordText String 用于替换登录表单上默认的“忘记密码”超链接文本的字符串。 此文本必须采用 Unicode 格式，且不超过 256 个字符。
customPrivacyAndCookiesText String 用于替换页脚中默认的“隐私和 Cookie”超链接文本的字符串。 此文本必须采用 Unicode 格式，且不超过 256 个字符。
customPrivacyAndCookiesUrl String 用于替换页脚中“隐私和 Cookie”超链接的默认 URL 的自定义 URL。 此 URL 必须采用 ASCII 格式，或者非 ASCII 字符必须经过 URL 编码，且不超过 128 个字符。
customTermsOfUseText String 用于替换页脚中默认的“使用条款”超链接文本的字符串。 此文本必须采用 Unicode 格式，且不超过 256 个字符。
customTermsOfUseUrl String 用于替换页脚中“使用条款”超链接的默认 URL 的自定义 URL。 此 URL 必须采用 ASCII 格式，或者非 ASCII 字符必须经过 URL 编码，且不超过 128 个字符。
favicon Stream 自定义图标 (favicon) 替换Microsoft Entra租户上的默认 Microsoft 产品 favicon。
headerBackgroundColor String 要应用于自定义标头颜色的 RGB 颜色。
headerLogo Stream 显示在登录页标题中的公司徽标。 允许的类型为不大于 245 x 36 像素的 PNG 或 JPEG。 建议使用徽标周围没有填充的透明图像。
loginPageLayoutConfiguration loginPageLayoutConfiguration 表示要显示在租户登录页上的布局配置。
loginPageTextVisibilitySettings loginPageTextVisibilitySettings 表示可在租户的登录页上隐藏的各种文本。 可以更新所有属性。
signInPageText String 登录框底部显示的文本。 使用它来传达其他信息，例如电话号码到技术支持或法律声明。 此文本必须采用 Unicode 格式，且不超过 1024 个字符。
squareLogo Stream (OOBE) 以及启用 Windows Autopilot 进行部署时，Windows 10现成体验中显示的公司徽标的方形版本。 允许的类型为不大于 240 x 240 像素且大小不超过 10 KB 的 PNG 或 JPEG。 建议使用徽标周围没有填充的透明图像。
squareLogoDark Stream (OOBE) 以及启用 Windows Autopilot 进行部署时，Windows 10现成体验中显示的公司徽标的方形深色版本。 允许的类型为不大于 240 x 240 像素且大小不超过 10 KB 的 PNG 或 JPEG。 建议使用徽标周围没有填充的透明图像。
usernameHintText String 在登录屏幕的“用户名”文本框中显示为提示的字符串。 此文本必须是 Unicode，没有链接或代码，并且不能超过 64 个字符。

响应

如果成功，此方法返回 204 No Content 响应代码。

示例

示例 1：更新默认品牌

请求

以下示例显示了一个请求。

PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
Content-Type: application/json
Accept-Language: 0

{
    "signInPageText":"Default",
    "usernameHintText":"DefaultHint"
}

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content

示例 2：更新默认品牌打造的 bannerLogo

以下请求更新默认品牌打造的横幅徽标。 若要更新Stream对象类型，请使用 PUT HTTP 方法，并在 URL 路径中包含区域设置 ID。

请求

以下示例显示了一个请求。

PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/0/bannerLogo
Content-Type: image/jpeg

<Image>

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content