Merge branch 'newslinkpagedocs' of https://github.com/microsoftgraph/microsoft-graph-docs into newslinkpagedocs

Author: shgangan

api-reference/beta/api/newslinkpage-create.md

@@ -43,12 +43,11 @@ POST /sites/{site-id}/pages
 
 ## Request body
 
-In the request body, supply a JSON representation of the [newsLinkPage](../resources/newslinkpage.md) object.
-The body must contain required properties placed directly in the request body, but to set a banner image by uploading an image it must contain multipart message format as shown in the example. For the banner image upload, since you're sending binary data, then you must send a multipart request.
+In the request body, supply a JSON representation of the [newsLinkPage](../resources/newslinkpage.md) object. The body must contain required properties placed directly in the request body; however, to set a banner image by uploading an image, it must be in a multipart message format as shown in the example. For the banner image upload, you must send a multipart request because it involves binary data.
 
 > **Notes:**
 > * To ensure successful parsing of the request body, the `@odata.type=#microsoft.graph.newsLinkPage` must be included in the request body.
-> * Currently, to set the **bannerImageWebUrl**, we provide the capability to upload the image bytes directly, which gets auto saved in the site assets library, and the **bannerImageWebUrl** is then generated based on the persisted file. The way to do that would be to make a multipart request and set the `@microsoft.graph.bannerImageWebUrlContent` annotation to send the image content, as illustrated in the example.
+> * Currently, to set the **bannerImageWebUrl**, the capability exists to upload the image bytes directly. These bytes get auto-saved in the site assets library, and the **bannerImageWebUrl** is then generated based on the persisted file. To achieve this, make a multipart request and set the `@microsoft.graph.bannerImageWebUrlContent` annotation to send the image content. For more details, see [Example 2](../resources/newslinkpage.md#example-2-create-a-news-link-page-and-upload-the-banner-image-file-content).
 
 You can specify the following properties when you create a [newsLinkPage](../resources/newslinkpage.md).
 
@@ -79,8 +78,8 @@ Content-Type: application/json
 
 {
   "@odata.type" : "#microsoft.graph.newsLinkPage",
-  "newsWebUrl":"https://someexternalnewssite.com/2023/09/08/tech-giant-unveils-first-self-driving-bicycle",
-  "title": "Tech Giant Unveils First Self-Driving Bicycle"
+  "newsWebUrl":"https://someexternalnewssite.com/2024/11/11/contoso-unveils-first-self-driving-car",
+  "title": "Contoso Unveils First Self-Driving Car"
 }
 ```
 

api-reference/beta/api/newslinkpage-publish.md

@@ -69,7 +69,7 @@ POST https://graph.microsoft.com/beta/sites/c1370818-f5e0-4a40-a99b-be4520640642
 ### Response
 
 The following example shows the response.
->**Note:** The response object shown here might be shortened for readability.
+
 <!-- {
   "blockType": "response",
   "truncated": true

api-reference/beta/api/newslinkpage-update.md

@@ -46,9 +46,6 @@ PATCH /sites/{site-id}/pages/{pageId}/microsoft.graph.newsLinkPage
 
 ## Request body
 
-> **Notes:**
-> You can update the **bannerImage** property by uploading the image bytes of the new banner image you want to set. The banner image is autosaved in the site assets library, and the banner image URL is then generated based on the persisted file. Make a multipart request and set the @microsoft.graph.bannerImageWebUrlContent annotation to send the image content, as shown in the example.
-
 [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
 
 |Property|Type|Description|
@@ -57,6 +54,9 @@ PATCH /sites/{site-id}/pages/{pageId}/microsoft.graph.newsLinkPage
 |newsWebUrl|String|The URL of the news article referenced by the **newsLinkPage**. It can be an external link. The maximum length limit is 110 characters.|
 |title|String|Title of the **newsLinkPage**. Inherited from [baseSitePage](../resources/basesitepage.md).|
 
+> **Notes:**
+> You can update the **bannerImage** property by uploading the image bytes of the new banner image you want to set. The banner image is autosaved in the site assets library, and the banner image URL is then generated based on the persisted file. Make a multipart request and set the `@microsoft.graph.bannerImageWebUrlContent` annotation to send the image content, as shown in the example.
+
 ## Response
 
 If successful, this method returns a `200 OK` response code and an updated [newsLinkPage](../resources/newslinkpage.md) object in the response body.

api-reference/beta/resources/basesitepage.md

@@ -52,7 +52,7 @@ Inherits from [baseItem](../resources/baseitem.md).
 | article            | The page is an article page.                                    |
 | home               | The page is a home page.                                        |
 | unknownFutureValue | Marker value for future compatibility.                          |
-| newsLinkPage       | The page is a news link page that allows you to add a link to content from your site or another website. The linked content appears as a news post.|
+| newsLink           | The page is a news link page that allows you to add a link to content from your site or another website. The linked content appears as a news post.|
 
 ## Relationships
 

api-reference/beta/resources/newslinkpage.md

@@ -23,11 +23,11 @@ Inherits from [baseSitePage](../resources/basesitepage.md).
 |Method|Return type|Description|
 |:---|:---|:---|
 |[List](../api/newslinkpage-list.md)|[newsLinkPage](../resources/newslinkpage.md) collection|Get a list of the [newsLinkPage](../resources/newslinkpage.md) objects and their properties.|
-|[Create](../api/newslinkpage-create.md)|[newsLinkPage](../resources/newslinkpage.md) |Create a new [newsLinkPage](../resources/newslinkpage.md) object.|
-|[Get](../api/newslinkpage-get.md)|[newsLinkPage](../resources/newslinkpage.md)|Read the properties and relationships of a [newsLinkPage](../resources/newslinkpage.md) object.|
+|[Create](../api/newslinkpage-create.md)|[newsLinkPage](../resources/newslinkpage.md) |Create a new [newsLinkPage](../resources/newslinkpage.md) in the site pages [list](../resources/list.md) of a [site](../resources/site.md).|
+|[Get](../api/newslinkpage-get.md)|[newsLinkPage](../resources/newslinkpage.md)|Get the metadata of a [newsLinkPage](../resources/newslinkpage.md) in the site pages [list](../resources/list.md) of a [site](../resources/site.md).|
 |[Update](../api/newslinkpage-update.md)|[newsLinkPage](../resources/newslinkpage.md)|Update the properties of a [newsLinkPage](../resources/newslinkpage.md) object.|
 |[Delete](../api/basesitepage-delete.md)|None|Delete a [newsLinkPage](../resources/newslinkpage.md) object.|
-|[Publish](../api/newslinkpage-publish.md)|None|Publish a [newsLinkPage](../resources/newslinkpage.md) object. |
+|[Publish](../api/newslinkpage-publish.md)|None|Publish the latest version of a [newsLinkPage](../resources/newslinkpage.md) resource that makes the version available to all users. |
 
 ## Properties
 
@@ -59,7 +59,7 @@ Instance attributes are properties with special behaviors. These properties are
 |@microsoft.graph.bannerImageWebUrlContent|String|This annotation is used to send the image content in a multipart request.|
 |@microsoft.graph.bannerImageWebUrlContentError|String|If a failure occurs when you upload or persist the banner image during a **newsLinkPage** creation, the response contains `@microsoft.graph.bannerImageWebUrlContentError` that provides details about the error.|
 
-For a POST request example, see [Create newsLinkPage)](../api/newslinkpage-create.md).
+For a POST request example, see [Create newsLinkPage](../api/newslinkpage-create.md).
 
 ## Relationships
 

changelog/Microsoft.FileServices.json

@@ -444,6 +444,14 @@
           "Description": "Added the [newsLinkPage](https://learn.microsoft.com/en-us/graph/api/resources/newsLinkPage?view=graph-rest-beta) resource and supported methods.",
           "Target": "newsLinkPage"
         },
+        {
+          "Id": "b4c3291a-d779-4cd5-a8e2-7310bfa50196",
+          "ApiChange": "Method",
+          "ChangedApiName": "publish",
+          "ChangeType": "Addition",
+          "Description": "Added the [publish](https://learn.microsoft.com/en-us/graph/api/newsLinkPage-publish?view=graph-rest-beta) method to the [newsLinkPage](https://learn.microsoft.com/en-us/graph/api/resources/newsLinkPage?view=graph-rest-beta) resource.",
+          "Target": "newsLinkPage"
+        },
         {
           "Id": "b4c3291a-d779-4cd5-a8e2-7310bfa50196",
           "ApiChange": "Term",

concepts/whats-new-overview.md

@@ -63,6 +63,10 @@ The new Microsoft Defender for Cloud apps API in Microsoft Graph is designed to
 - [discoveredCloudAppDevice](/graph/api/resources/security-discoveredcloudappdevice?view=graph-rest-beta&preserve-view=true)
 - [endpointDiscoveredCloudAppDetail](/graph/api/resources/security-endpointdiscoveredcloudappdetail?view=graph-rest-beta&preserve-view=true)
 
+### Sites and lists
+
+Create and manage a [news link page](/graph/api/resources/newslinkpage?view=graph-rest-beta&preserve-view=true) in SharePoint.
+
 ### Teamwork and communications | AI interactions
 
 Use the [getAllEnterpriseInteractions](/graph/api/aiInteractionHistory-getAllEnterpriseInteractions) method to get Microsoft 365 Copilot interaction data, including user prompts to Copilot and Copilot responses.