获取 SitePage
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Sites.Read.All | Sites.ReadWrite.All |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Sites.Read.All | Sites.ReadWrite.All |
HTTP 请求
GET /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage
可选的查询参数
此方法支持 $select
和 $expand
OData 查询参数,以帮助自定义响应。 若要了解一般信息,请参阅 OData 查询参数。
如果项具有 =canvasLayout 关系,则检索项的元数据时,可以使用$expand=canvasLayout
查询字符串参数包含项的内容。
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
Content-Type | application/json. 必需。 |
接受 | application/json;odata.metadata=none。 可选。 从响应中删除所有 OData 元数据。 建议在响应将用于另一个请求时包括此标头。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法在 200
响应正文中返回 和 sitePage 对象。
示例
示例 1:获取网站网站页面列表中的页面
请求
GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage
响应
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.type": "microsoft.graph.sitePage",
"description": "Here's the page description",
"id": "65e59907-59d5-44ff-a038-7c0bf3098c01",
"name": "Home.aspx",
"webUrl": "https://contoso.sharepoint.com/SitePages/Home.aspx",
"title": "Organization Home",
"thumbnailWebUrl": "https://cdn.hubblecontent.osi.office.net/m365content/publish/00210d24-bba0-42e6-9a31-1d452a95dd75/thumbnails/large.jpg?file=163352059.jpg",
"promotionKind": "page",
"pageLayout": "home",
"showComments": true,
"showRecommendedPages": false,
"createdBy": {
"user": {
"displayName": "Rahul Mittal",
"email": "rahmit@contoso.com"
}
},
"lastModifiedBy": {
"user": {
"displayName": "Rahul Mittal",
"email": "rahmit@contoso.com"
}
},
"publishingState": {
"level": "published",
"versionId": "1.0"
},
"reactions": {
"commentCount": 1
}
}
示例 2:使用 select 和 expand 获取页面
请求
使用 $select
和 $expand
语句,可以在单个请求中检索 sitePage 元数据和页面内容。
GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage?$select=id,name
响应
以下示例显示了相应的响应。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.etag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"",
"id": "f45354cb-d634-45df-8b88-2b4e96a1dc45",
"name": "Electronic Convertible.aspx"
}
示例 3:获取包含页面内容的页面
请求
可以使用 $expand 查询参数展开 URL 中的引用。 若要访问包含页面内容的页面,请追加 ?$expand=canvasLayout
查询字符串。
GET /sites/7f50f45e-714a-4264-9c59-3bf43ea4db8f/pages/df69e386-6c58-4df2-afc0-ab6327d5b202/microsoft.graph.sitePage?$expand=canvasLayout
响应
{
"description": "Reiciendis placeat dolores.",
"eTag": "\"{F45354CB-D634-45DF-8B88-2B4E96A1DC45},8\"",
"id": "f45354cb-d634-45df-8b88-2b4e96a1dc45",
"lastModifiedDateTime": "2023-04-16T10:01:41Z",
"name": "autotest Electronic Convertible.aspx",
"webUrl": "https://contoso.sharepoint.com/SitePages/autotest Electronic Convertible.aspx",
"title": "autotest Electronic Convertible",
"pageLayout": "article",
"thumbnailWebUrl": "https://media.akamai.odsp.cdn.office.net/sitepagethumbnail.png",
"promotionKind": "page",
"showComments": false,
"showRecommendedPages": true,
"createdBy": {
"user": {
"displayName": "Rahul Mittal",
"email": "rahmit@contoso.com"
}
},
"lastModifiedBy": {
"user": {
"displayName": "Rahul Mittal",
"email": "rahmit@contoso.com"
}
},
"parentReference": {
"listId": "468fc883-e278-4773-ba09-91351a1e42ed",
"siteId": "45bb2a3b-0a4e-46f4-8c68-749c3fea75d3"
},
"contentType": {
"id": "0x0101009D1CB255DA76424F860D91F20E6C4118009E6554A5E299E84FB2E07731DD6C6D4A",
"name": "Site Page"
},
"publishingState": {
"level": "draft",
"versionId": "0.4"
},
"reactions": {},
"canvasLayout": {
"horizontalSections": [
{
"layout": "threeColumns",
"id": "1",
"emphasis": "neutral",
"columns": [
{
"id": "1",
"width": 4,
"webparts": [
{
"@odata.type": "#oneDrive.textWebPart",
"id": "f6d0ef70-c977-45e4-ae4b-4676a30d5aab",
"innerHtml": "<h1>sample content</h1>"
}
]
},
{
"id": "2",
"width": 4,
"webparts": [
{
"@odata.type": "#oneDrive.textWebPart",
"id": "99f59f91-c853-433e-9e75-ad7a32e46106",
"innerHtml": "<h1>sample content</h1>"
}
]
},
{
"id": "3",
"width": 4,
"webparts": [
{
"@odata.type": "#oneDrive.textWebPart",
"id": "48998492-9633-48b8-a7e9-d293533b4fa6",
"innerHtml": "<h1>sample content</h1>"
}
]
}
]
}
]
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈