sitePage 资源类型

命名空间：microsoft.graph

重要

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

此资源表示 sitePages 列表中的页面。 它包含标题、布局和 webParts 的集合。

继承自 baseSitePage。

方法

方法	返回类型	说明
列出 sitePages	sitePage 集合	获取 sitePage 对象及其属性的列表。
创建 sitePage	sitePage	创建新的 sitePage 对象。
获取 sitePage	sitePage	读取 sitePage 对象的属性和关系。
更新 sitePage	sitePage	更新 sitePage 对象的属性。
删除 sitePage	无	删除 sitePage 对象。
发布 sitePage	无	发布 sitePage 对象。
按位置信息获取 Web 部件的集合	webPart 集合	通过提供 webPartPosition 信息获取 WebPart 的 集合。

属性

属性	类型	说明
contentType	contentTypeInfo	此项的内容类型。 继承自 baseSitePage。
createdBy	identitySet	此项的创建者的标识。 只读。 继承自 baseSitePage。
createdDateTime	DateTimeOffset	项的创建日期和时间。 此为只读属性。 继承自 baseSitePage。
说明	String	项目的描述性文本。 继承自 baseSitePage。
eTag	String	该项目的 ETag。 继承自 baseSitePage。
id	String	项的唯一标识符。 继承自 baseSitePage。
lastModifiedBy	identitySet	此项最后一个修饰符的 TIdentity。 此为只读属性。 继承自 baseSitePage。
lastModifiedDateTime	DateTimeOffset	上次修改项目的日期和时间。 此为只读属性。 继承自 baseSitePage。
name	String	项目名称。 继承自 baseSitePage。
pageLayout	pageLayoutType	页面的页面布局的名称。 可能的值包括 microsoftReserved、article、home、unknownFutureValue。 继承自 baseSitePage。
parentReference	itemReference	父信息（如果此项具有父级）。 继承自 baseSitePage。
promotionKind	pagePromotionType	指示 sitePage 的促销类型。 可能的值包括 microsoftReserved、page、newsPost、unknownFutureValue。
publishingState	publicationFacet	页面的发布状态和 MM.mm 版本。 继承自 baseSitePage。
反应	reactionsFacet	页面的反应信息。
showComments	布尔值	确定是否在页面底部显示批注。
showRecommendedPages	布尔值	确定是否在页面底部显示建议的页面。
thumbnailWebUrl	String	sitePage 缩略图的 URL
title	String	sitePage 的标题。 继承自 baseSitePage。
titleArea	titleArea	SharePoint 页面上的标题区域。
webUrl	String	在浏览器中显示此资源的 URL。 此为只读属性。 继承自 baseSitePage。

pagePromotionType 值

值	说明
microsoftReserved	页面是一种特殊类型，仅供 Microsoft 使用。 使用 Create sitePage 方法创建页面时，不能使用此值。
page	页面被提升为普通页面
newsPost	页面被提升为新闻帖子
unknownFutureValue	用于将来兼容性的标记值。

关系

关系	类型	说明
canvasLayout	canvasLayout	指示给定 SharePoint 页面中内容的布局，包括水平部分和垂直部分。
createdByUser	user	此项的创建者的标识。 只读。 继承自 baseSitePage。
lastModifiedByUser	user	此项的最后一个修饰符的标识。 只读。 继承自 baseSitePage。
webParts	webPart 集合	SharePoint 页面上的 Web 部件集合。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.sitePage",
  "id": "String (identifier)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "contentType": {
    "@odata.type": "microsoft.graph.contentTypeInfo"
  },
  "description": "String",
  "eTag": "String",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "name": "String",
  "parentReference": {
    "@odata.type": "microsoft.graph.itemReference"
  },
  "webUrl": "String",
  "title": "String",
  "pageLayout": "String",
  "promotionKind": "String",
  "publishingState": {
    "@odata.type": "microsoft.graph.publicationFacet"
  },
  "reactions": {
    "@odata.type": "microsoft.graph.reactionsFacet"
  },
  "showComments": "Boolean",
  "showRecommendedPages": "Boolean",
  "thumbnailWebUrl": "String",
  "titleArea": {
    "@odata.type": "microsoft.graph.titleArea"
  }
}