利用 SharePoint REST API 设置网站欢迎页，提升用户体验

2024-03-15 07:58:23

利用 SharePoint REST API 设置网站欢迎页

在数字世界中，网站欢迎页是给新访客留下的第一印象。对于 SharePoint 网站来说，它至关重要，因为它展示了网站的重要信息和导航选项。通过利用 SharePoint REST API，您可以轻松高效地设置网站欢迎页。本文将指导您完成设置过程，并解决常见问题，帮助您完善网站体验。

获取请求摘要

请求摘要是一个令牌，可验证您的请求的真实性。在设置欢迎页之前，我们需要获取请求摘要：

def request_digest(self, site_url):
    api_call = "/_api/contextinfo"
    url = f"{site_url}{api_call}"

    headers = {
        "Authorization": f"Bearer {str(self.O365_TOKEN)}",
        "Accept": "application/json;odata=verbose"
    }

    response = requests.post(url, headers=headers)
    return response.json()['d']['GetContextWebInformation']['FormDigestValue']

设置欢迎页

有了请求摘要，我们就可以设置欢迎页了：

def set_homepage(self, site_url):
    RequestDigest = self.request_digest(site_url)

    api_call = "/_api/Web/RootFolder"
    url = f"{site_url}{api_call}"

    payload = {
        "__metadata": {
            "type": "SP.Folder"
        },
        "WelcomePage": "SitePages/Home.aspx"
    }

    headers = {
        "X-HTTP-Method": "PATCH",
        "Authorization": f"Bearer {str(self.O365_TOKEN)}",
        "Accept-Language": "en-GB,en-US;q=0.9,en;q=0.8",
        "Accept": "application/json;odata=verbose",
        "Content-Type": "application/json;odata=verbose",
        "Content-Length": str(len(json.dumps(payload).encode('utf-8'))),
        "X-RequestDigest": RequestDigest,
        "IF-MATCH": "*"
    }

    response = requests.post(url, headers=headers, json=payload)