Поделиться через

Создание newsLinkPage

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Создайте новый объект newsLinkPage в списке страниц сайта.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Sites.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Sites.ReadWrite.All Недоступно.

HTTP-запрос

POST /sites/{site-id}/pages

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json для содержимого JSON, включая обязательное свойство title в многокомпонентных запросах. Многокомпонентные запросы используют multipart/form-data; boundary=тип контента вашей границы. Обязательно.
Prefer include-unknown-enum-members. Prefer: include-unknown-enum-members Используйте заголовок запроса, чтобы получить следующее значение в pageLayoutType, которое является изменяемым перечислением: newsLink.

Текст запроса

В тексте запроса укажите представление объекта newsLinkPage в формате JSON. Текст должен содержать обязательные свойства, размещенные непосредственно в тексте запроса; Однако чтобы задать изображение баннера путем отправки изображения, оно должно быть в формате многокомпонентного сообщения, как показано в примере. Для отправки изображения баннера необходимо отправить многокомпонентный запрос, так как он включает двоичные данные.

Примечания.

  • Чтобы обеспечить успешное синтаксический анализ текста запроса, @odata.type=#microsoft.graph.newsLinkPage необходимо включить в текст запроса.
  • В настоящее время, чтобы задать bannerImageWebUrl, существует возможность отправки байтов изображения напрямую. Эти байты автоматически сохраняются в библиотеке ресурсов сайта, а затем на основе сохраненного файла создается баннерImageWebUrl . Для этого сделайте многокомпонентный запрос и задайте заметку @microsoft.graph.bannerImageWebUrlContent для отправки содержимого изображения. Дополнительные сведения см. в разделе Пример 2.

При создании newsLinkPage можно указать следующие свойства.

Свойство Тип Описание
description String Текст с описанием элемента. Максимальная длина составляет 250 символов. Необязательный параметр. Наследуется от baseSitePage.
newsWebUrl String URL-адрес новостной статьи, на которую ссылается newsLinkPage. Это может быть внешняя ссылка. Обязательно.
title String Название newsLinkPage. Максимальная длина — 110 символов. Обязательно. Наследуется от baseSitePage.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект newsLinkPage в тексте ответа.

Примеры

Пример 1. Создание страницы ссылки на новости только с необходимыми свойствами

В следующем примере показано, как создать страницу ссылки на новости , используя только необходимые свойства.

Запрос

Ниже показан пример запроса.

POST /sites/c1370818-f5e0-4a40-a99b-be4520640642/pages
prefer: include-unknown-enum-members
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.newsLinkPage",
  "newsWebUrl":"https://someexternalnewssite.com/2024/11/11/contoso-unveils-first-self-driving-car",
  "title": "Contoso Unveils First Self-Driving Car"
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 201 Created
Content-type: application/json

{
  "eTag": "\"{6A34958A-6F84-4571-A26E-B2CEB20261EB},3\"",
  "id": "6a34958a-6f84-4571-a26e-b2ceb20261eb",
  "lastModifiedDateTime": "2023-09-10T18:46:23Z",
  "name": "contoso-unveils-first-self-driving-car.aspx",
  "webUrl": "https://contoso.sharepoint.com/SitePages/contoso-unveils-first-self-driving-car.aspx",
  "title": "Contoso Unveils First Self-Driving Car",
  "pageLayout": "newsLink",
  "newsWebUrl": "https://someexternalnewssite.com/2024/11/11/contoso-unveils-first-self-driving-car",
  "createdBy": {
    "user": {
      "displayName": "Jane Doe"
    }
  },
  "lastModifiedBy": {
    "user": {
      "displayName": "Jane Doe"
    }
  },
  "contentType": {
    "id": "0x0101009D1CB255DA76424F860D91F20E6C4118002A50BFCFB7614729B56886FADA02339B000B27C676C81DC54289A1417148759BF3",
    "name": "Repost Page"
  },
  "publishingState": {
    "level":"checkout",
    "versionId":"0.1",
    "checkedOutBy": {
      "user": {
        "displayName":"Jane Doe",
        "email":"JaneDoe@contoso.sharepoint.com"
      }
    }
  }
}

Пример 2. Создание страницы ссылки на новости и отправка содержимого файла изображения баннера

В следующем примере показано, как создать страницу ссылки на новости с изображением баннера. Для этого процесса требуется многокомпонентный запрос.

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/sites/c1370818-f5e0-4a40-a99b-be4520640642/pages
Prefer: include-unknown-enum-members
Content-type: multipart/form-data; boundary=MyPartBoundary198374

--MyPartBoundary198374
Content-Disposition: form-data; name="request"
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.newsLinkPage",
  "title": "Microsoft Build brings AI tools to the forefront for developers",
  "newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
  "description": "You only need two simple letters to accurately convey the major shift in the technology space this year: A and I. Beyond those letters, however, is a complex, evolving and exciting way in which we work, communicate and collaborate.",
  "@microsoft.graph.bannerImageWebUrlContent": "name:content"
}

--MyPartBoundary198374
Content-Disposition: form-data; name="content"; filename="b3.jpg"
Content-Type: image/jpeg

... binary image data ...

--MyPartBoundary198374

Отклик

Ниже показан пример отклика. Если при отправке или сохранении изображения баннера происходит сбой, ответ содержит @microsoft.graph.bannerImageWebUrlContentError описательное сообщение об ошибке.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.newsLinkPage",
  "createdDateTime": "2024-06-11T17:31:20Z",
  "description": "You only need two simple letters to accurately convey the major shift in the technology space this year: A and I. Beyond those letters, however, is a complex, evolving and exciting way in which we work, communicate and collaborate.",
  "eTag": "\"{179210C2-637E-4C61-8491-331D0D4A0C05},2\"",
  "id": "179210c2-637e-4c61-8491-331d0d4a0c05",
  "lastModifiedDateTime": "2024-06-11T17:31:21Z",
  "name": "microsoft-build-ai-tools-developers.aspx",
  "webUrl": "https://contoso.sharepoint.com/SitePages/Microsoft-Build-brings-AI-tools-to-the-forefront-for-developers.aspx",
  "title": "Microsoft Build brings AI tools to the forefront for developers",
  "pageLayout": "newsLink",
  "bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/microsoft-build-ai-tools-developers/BannerImage.png",
  "newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
  "createdBy": {
    "user": {
      "displayName": "John Doe",
      "email": "jdoe@contoso.com"
    }
  },
  "lastModifiedBy": {
    "user": {
      "displayName": "John Doe",
      "email": "jdoe@contoso.com"
    }
  },
  "publishingState": {
    "level": "checkout",
    "versionId": "0.1",
    "checkedOutBy": {
      "user": {
        "displayName": "John Doe",
        "email": "jdoe@contoso.com"
      }
    }
  }
}