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

Список новостейLinkPage

  • Статья

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

Важно!

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

Получите список объектов newsLinkPage и их свойств.

Разрешения

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

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

HTTP-запрос

GET /sites/{site-id}/pages/microsoft.graph.newsLinkPage

Необязательные параметры запросов

Этот метод поддерживает $countпараметры запроса OData , $expand$filter, $orderBy, , $selectи $top для настройки ответа.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Prefer include-unknown-enum-members. Prefer: include-unknown-enum-members Используйте заголовок запроса для получения следующих значений в pageLayoutType, который является изменяемым перечислением: newsLink.

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

Не указывайте текст запроса для этого метода.

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/sites/056d8292-ef8a-44fe-bd22-97abf08659b1/pages/microsoft.graph.newsLinkPage

Отклик

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

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#sites('056d8292-ef8a-44fe-bd22-97abf08659b1')/pages/microsoft.graph.newsLinkPage",
  "value": [
    {
      "@odata.type": "#microsoft.graph.newsLinkPage",
      "createdDateTime": "2024-06-11T17:31:20Z",
      "description": " In a groundbreaking study, a team of scientists has reportedly discovered the secret to eternal youth. The research, conducted in a top-secret laboratory, claims to have identified a unique combination of natural ingredients that can halt the aging process.",
      "eTag": "\"{179210C2-637E-4C61-8491-331D0D4A0C05},2\"",
      "id": "179210c2-637e-4c61-8491-331d0d4a0c05",
      "lastModifiedDateTime": "2024-06-11T17:31:21Z",
      "name": "Scientists-Discover-Secret-to-Eternal-Youth.aspx",
      "webUrl": "https://contoso.sharepoint.com/SitePages/Scientists-Discover-Secret-to-Eternal-Youth.aspx",
      "title": "Scientists Discover Secret to Eternal Youth",
      "pageLayout": "newsLink",
      "bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/Scientists-Discover-Secret-to-Eternal-Youth/BannerImage.png",
      "newsWebUrl": "https://someexternalnewssite.com/2024/06/11/scientists-discover-secret-to-eternal-youth",
      "createdBy": {
        "user": {
          "displayName": "John Doe",
          "email": "jdoe@contoso.com"
        }
      },
      "lastModifiedBy": {
        "user": {
          "displayName": "John Doe",
          "email": "jdoe@contoso.com"
        }
      },
      "publishingState": {
        "level": "published",
        "versionId": "1.0"
      }
    },
    {
      "@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": "published",
        "versionId": "1.0"
      }
    }
  ]
}