Skip to content

Commit fd2ffdc

Browse files
shganganshgangan
committed
Merge branch 'newslinkpagedocs' of https://github.com/microsoftgraph/microsoft-graph-docs into newslinkpagedocs
2 parents 1a8e644 + 4a2eae9 commit fd2ffdc

File tree

8 files changed

+55
-61
lines changed

8 files changed

+55
-61
lines changed

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ In the request body, supply a JSON representation of the [newsLinkPage](../resou
4747

4848
> **Notes:**
4949
> * To ensure successful parsing of the request body, the `@odata.type=#microsoft.graph.newsLinkPage` must be included in the request body.
50-
> * 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).
50+
> * 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](../api/newslinkpage-create.md#example-2-create-a-news-link-page-and-upload-the-banner-image-file-content).
5151
5252
You can specify the following properties when you create a [newsLinkPage](../resources/newslinkpage.md).
5353

@@ -65,7 +65,7 @@ If successful, this method returns a `201 Created` response code and a [newsLink
6565

6666
### Example 1: Create a news link page with only the required properties
6767

68-
The following example shows how to create a [newsLinkPage](../resources/newslinkpage.md) page using only the required properties.
68+
The following example shows how to create a [news link page](../resources/newslinkpage.md) using only the required properties.
6969

7070
#### Request
7171
The following example shows a request.
@@ -77,15 +77,15 @@ prefer: include-unknown-enum-members
7777
Content-Type: application/json
7878
7979
{
80-
"@odata.type" : "#microsoft.graph.newsLinkPage",
80+
"@odata.type": "#microsoft.graph.newsLinkPage",
8181
"newsWebUrl":"https://someexternalnewssite.com/2024/11/11/contoso-unveils-first-self-driving-car",
8282
"title": "Contoso Unveils First Self-Driving Car"
8383
}
8484
```
8585

8686
#### Response
8787

88-
The following example shows how to create a [newsLinkPage](../resources/newslinkpage.md) page and using only required fields.
88+
The following example shows the response.
8989

9090
<!-- {
9191
"blockType": "response",
@@ -135,7 +135,7 @@ Content-type: application/json
135135

136136
### Example 2: Create a news link page and upload the banner image file content
137137

138-
The following example shows how to create a [newsLinkPage](../resources/newslinkpage.md) with a banner image. This requires a multipart request.
138+
The following example shows how to create a [news link page](../resources/newslinkpage.md) with a banner image. This process requires a multipart request.
139139

140140
#### Request
141141

@@ -156,11 +156,11 @@ Content-Disposition: form-data; name="request"
156156
Content-Type: application/json
157157
158158
{
159-
"@odata.type" : "#microsoft.graph.newsLinkPage",
160-
"title" : "Microsoft Build brings AI tools to the forefront for developers",
161-
"newsWebUrl" : "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
162-
"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.",
163-
"@microsoft.graph.bannerImageWebUrlContent" : "name:content"
159+
"@odata.type": "#microsoft.graph.newsLinkPage",
160+
"title": "Microsoft Build brings AI tools to the forefront for developers",
161+
"newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
162+
"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.",
163+
"@microsoft.graph.bannerImageWebUrlContent": "name:content"
164164
}
165165
166166
--MyPartBoundary198374

‎api-reference/beta/api/newslinkpage-get.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -91,16 +91,16 @@ Content-Type: application/json
9191
{
9292
"@odata.type": "#microsoft.graph.newsLinkPage",
9393
"createdDateTime": "2024-06-11T17:31:20Z",
94-
"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.",
94+
"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.",
9595
"eTag": "\"{179210C2-637E-4C61-8491-331D0D4A0C05},2\"",
9696
"id": "179210c2-637e-4c61-8491-331d0d4a0c05",
9797
"lastModifiedDateTime": "2024-06-11T17:31:21Z",
98-
"name": "Scientists-Discover-Secret-to-Eternal-Youth.aspx",
98+
"name": "microsoft-build-ai-tools-developers.aspx",
9999
"webUrl": "https://contoso.sharepoint.com/SitePages/Microsoft-Build-brings-AI-tools-to-the-forefront-for-developers.aspx",
100-
"title": "Scientists Discover Secret to Eternal Youth",
100+
"title": "Microsoft Build brings AI tools to the forefront for developers",
101101
"pageLayout": "newsLink",
102-
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/Scientists-Discover-Secret-to-Eternal-Youth/BannerImage.png",
103-
"newsWebUrl": "https://someexternalnewssite.com/2024/06/11/scientists-discover-secret-to-eternal-youth",
102+
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/microsoft-build-ai-tools-developers/BannerImage.png",
103+
"newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
104104
"createdBy": {
105105
"user": {
106106
"displayName": "John Doe",

‎api-reference/beta/api/newslinkpage-list.md

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ Content-Type: application/json
9595
"id": "179210c2-637e-4c61-8491-331d0d4a0c05",
9696
"lastModifiedDateTime": "2024-06-11T17:31:21Z",
9797
"name": "Scientists-Discover-Secret-to-Eternal-Youth.aspx",
98-
"webUrl": "https://contoso.sharepoint.com/SitePages/Microsoft-Build-brings-AI-tools-to-the-forefront-for-developers.aspx",
98+
"webUrl": "https://contoso.sharepoint.com/SitePages/Scientists-Discover-Secret-to-Eternal-Youth.aspx",
9999
"title": "Scientists Discover Secret to Eternal Youth",
100100
"pageLayout": "newsLink",
101101
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/Scientists-Discover-Secret-to-Eternal-Youth/BannerImage.png",
@@ -120,16 +120,16 @@ Content-Type: application/json
120120
{
121121
"@odata.type": "#microsoft.graph.newsLinkPage",
122122
"createdDateTime": "2024-06-11T17:31:20Z",
123-
"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.",
123+
"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.",
124124
"eTag": "\"{179210C2-637E-4C61-8491-331D0D4A0C05},2\"",
125125
"id": "179210c2-637e-4c61-8491-331d0d4a0c05",
126126
"lastModifiedDateTime": "2024-06-11T17:31:21Z",
127-
"name": "Scientists-Discover-Secret-to-Eternal-Youth.aspx",
127+
"name": "microsoft-build-ai-tools-developers.aspx",
128128
"webUrl": "https://contoso.sharepoint.com/SitePages/Microsoft-Build-brings-AI-tools-to-the-forefront-for-developers.aspx",
129-
"title": "Scientists Discover Secret to Eternal Youth",
129+
"title": "Microsoft Build brings AI tools to the forefront for developers",
130130
"pageLayout": "newsLink",
131-
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/Scientists-Discover-Secret-to-Eternal-Youth/BannerImage.png",
132-
"newsWebUrl": "https://someexternalnewssite.com/2024/06/11/scientists-discover-secret-to-eternal-youth",
131+
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/microsoft-build-ai-tools-developers/BannerImage.png",
132+
"newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
133133
"createdBy": {
134134
"user": {
135135
"displayName": "John Doe",
@@ -143,14 +143,8 @@ Content-Type: application/json
143143
}
144144
},
145145
"publishingState": {
146-
"level": "checkout",
147-
"versionId": "0.1",
148-
"checkedOutBy": {
149-
"user": {
150-
"displayName": "John Doe",
151-
"email": "jdoe@contoso.com"
152-
}
153-
}
146+
"level": "published",
147+
"versionId": "1.0"
154148
}
155149
}
156150
]

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,8 @@ PATCH /sites/{site-id}/pages/{pageId}/microsoft.graph.newsLinkPage
5151
|Property|Type|Description|
5252
|:---|:---|:---|
5353
|description|String|The descriptive text for the item. The maximum length limit is 250 characters. Inherited from [baseSitePage](../resources/basesitepage.md).|
54-
|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.|
55-
|title|String|Title of the **newsLinkPage**. Inherited from [baseSitePage](../resources/basesitepage.md).|
54+
|newsWebUrl|String|The URL of the news article referenced by the **newsLinkPage**. It can be an external link.|
55+
|title|String|Title of the **newsLinkPage**. The maximum length limit is 110 characters. Inherited from [baseSitePage](../resources/basesitepage.md).|
5656

5757
> **Notes:**
5858
> 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.
@@ -80,7 +80,7 @@ Content-Disposition:form-data; name="metadata"
8080
Content-Type: application/json
8181
8282
{
83-
"title": "External News | Scientists Discover Secret to Eternal Youth",
83+
"title": "External News | Microsoft Build brings AI tools to the forefront for developers",
8484
"@microsoft.graph.bannerImageWebUrlContent" : "name:content"
8585
}
8686
@@ -112,16 +112,16 @@ Content-Type: application/json
112112
{
113113
"@odata.type": "#microsoft.graph.newsLinkPage",
114114
"createdDateTime": "2024-06-11T17:31:20Z",
115-
"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.",
115+
"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.",
116116
"eTag": "\"{179210C2-637E-4C61-8491-331D0D4A0C05},2\"",
117117
"id": "179210c2-637e-4c61-8491-331d0d4a0c05",
118118
"lastModifiedDateTime": "2024-06-11T17:31:21Z",
119-
"name": "Scientists-Discover-Secret-to-Eternal-Youth.aspx",
119+
"name": "microsoft-build-ai-tools-developers.aspx",
120120
"webUrl": "https://contoso.sharepoint.com/SitePages/Microsoft-Build-brings-AI-tools-to-the-forefront-for-developers.aspx",
121-
"title": "External News | Scientists Discover Secret to Eternal Youth",
121+
"title": "External News | Microsoft Build brings AI tools to the forefront for developers",
122122
"pageLayout": "newsLink",
123-
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/Scientists-Discover-Secret-to-Eternal-Youth(1)/BannerImage.png",
124-
"newsWebUrl": "https://someexternalnewssite.com/2024/06/11/scientists-discover-secret-to-eternal-youth",
123+
"bannerImageWebUrl": "https://contoso.sharepoint.com/_layouts/15/getpreview.ashx?path=/SiteAssets/SitePages/microsoft-build-ai-tools-developers/BannerImage.png",
124+
"newsWebUrl": "https://someexternalnewssite.com/2024/05/23/microsoft-build-ai-tools-developers",
125125
"createdBy": {
126126
"user": {
127127
"displayName": "John Doe",

‎api-reference/beta/resources/newslinkpage.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Inherits from [baseSitePage](../resources/basesitepage.md).
3636
|bannerImageWebUrl|String|A link to the banner image for the **newsLinkPage**.|
3737
|createdBy|[identitySet](../resources/identityset.md) | Identity of the creator of this **newsLinkPage**. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md).|
3838
|createdDateTime|DateTimeOffset|The date and time when the **newsLinkPage** was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md).|
39-
|description|String|The descriptive text for the **newsLinkPage**. Inherited from [baseSitePage](../resources/basesitepage.md).|
39+
|description|String|The descriptive text for the **newsLinkPage**. The maximum length limit is 250 characters. Inherited from [baseSitePage](../resources/basesitepage.md).|
4040
|eTag|String|ETag for the **newsLinkPage**. Inherited from [baseSitePage](../resources/basesitepage.md).|
4141
|id|String|The unique identifier of the **newsLinkPage**. Inherited from [baseSitePage](../resources/basesitepage.md).|
4242
|lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the last modifier of this **newsLinkPage**. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md).|
@@ -47,7 +47,7 @@ Inherits from [baseSitePage](../resources/basesitepage.md).
4747
|pageLayout|[pageLayoutType](../resources/basesitepage.md#pagelayouttype-values)|The name of the page layout of the page. The possible values are: `microsoftReserved`, `article`, `home`, `unknownFutureValue`, `newsLink`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this evolvable enum: `newsLink`. Inherited from [baseSitePage](../resources/basesitepage.md).|
4848
|parentReference|[itemReference](../resources/itemreference.md)|Parent information if the **newsLinkPage** has a parent. Inherited from [baseSitePage](../resources/basesitepage.md).|
4949
|publishingState|[publicationFacet](../resources/publicationfacet.md)|The publishing status and the version of the page. Inherited from [baseSitePage](../resources/basesitepage.md).|
50-
|title|String|Title of the **newsLinkPage**. Inherited from [baseSitePage](../resources/basesitepage.md).|
50+
|title|String|Title of the **newsLinkPage**. The maximum length limit is 110 characters. Inherited from [baseSitePage](../resources/basesitepage.md).|
5151
|webUrl|String|URL that displays the resource in the browser. Read-only. Inherited from [baseSitePage](../resources/basesitepage.md).|
5252

5353
### Instance attributes

‎api-reference/beta/toc/sites-and-lists/toc.yml

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -272,6 +272,20 @@ items:
272272
href: ../../api/basesitepage-delete.md
273273
- name: Publish
274274
href: ../../api/newslinkpage-publish.md
275+
- name: Page template
276+
items:
277+
- name: Page template
278+
href: ../../resources/pagetemplate.md
279+
- name: List
280+
href: ../../api/pagetemplate-list.md
281+
- name: Create
282+
href: ../../api/pagetemplate-create.md
283+
- name: Get
284+
href: ../../api/pagetemplate-get.md
285+
- name: Update
286+
href: ../../api/pagetemplate-update.md
287+
- name: Delete
288+
href: ../../api/pagetemplate-delete.md
275289
- name: Site page
276290
items:
277291
- name: Site page
@@ -354,20 +368,6 @@ items:
354368
href: ../../resources/textwebpart.md
355369
- name: Standard web part
356370
href: ../../resources/standardwebpart.md
357-
- name: Page template
358-
items:
359-
- name: Page template
360-
href: ../../resources/pagetemplate.md
361-
- name: List
362-
href: ../../api/pagetemplate-list.md
363-
- name: Create
364-
href: ../../api/pagetemplate-create.md
365-
- name: Get
366-
href: ../../api/pagetemplate-get.md
367-
- name: Update
368-
href: ../../api/pagetemplate-update.md
369-
- name: Delete
370-
href: ../../api/pagetemplate-delete.md
371371
- name: Complex types
372372
items:
373373
- name: Save as template

‎api-reference/beta/toc/toc.mapping.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2695,9 +2695,9 @@
26952695
"resources": [
26962696
"baseSitePage",
26972697
"newsLinkPage",
2698+
"pageTemplate",
26982699
"sitePage",
2699-
"webPart",
2700-
"pageTemplate"
2700+
"webPart"
27012701
],
27022702
"complexTypes": [
27032703
"createFromTemplate",

‎changelog/Microsoft.FileServices.json

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -441,7 +441,7 @@
441441
"ApiChange": "Resource",
442442
"ChangedApiName": "newsLinkPage",
443443
"ChangeType": "Addition",
444-
"Description": "Added the [newsLinkPage](https://learn.microsoft.com/en-us/graph/api/resources/newsLinkPage?view=graph-rest-beta) resource and supported methods.",
444+
"Description": "Added the [newsLinkPage](https://learn.microsoft.com/en-us/graph/api/resources/newsLinkPage?view=graph-rest-beta) resource and associated methods.",
445445
"Target": "newsLinkPage"
446446
},
447447
{
@@ -457,22 +457,22 @@
457457
"ApiChange": "Term",
458458
"ChangedApiName": "bannerImageWebUrlContent",
459459
"ChangeType": "Addition",
460-
"Description": "Added the [bannerImageWebUrlContent](https://learn.microsoft.com/en-us/?view=graph-rest-beta) resource.",
461-
"Target": "oneDrive"
460+
"Description": "Added **bannerImageWebUrlContent** as an instance attribute that you can use with the [newsLinkPage](https://learn.microsoft.com/en-us/graph/api/resources/newsLinkPage?view=graph-rest-beta) resource.",
461+
"Target": "bannerImageWebUrlContent"
462462
},
463463
{
464464
"Id": "b4c3291a-d779-4cd5-a8e2-7310bfa50196",
465465
"ApiChange": "Term",
466466
"ChangedApiName": "bannerImageWebUrlContentError",
467467
"ChangeType": "Addition",
468-
"Description": "Added the [bannerImageWebUrlContentError](https://learn.microsoft.com/en-us/?view=graph-rest-beta) resource.",
469-
"Target": "oneDrive"
468+
"Description": "Added **bannerImageWebUrlContentError** as an instance attribute that you can use with the [newsLinkPage](https://learn.microsoft.com/en-us/graph/api/resources/newsLinkPage?view=graph-rest-beta) resource.",
469+
"Target": "bannerImageWebUrlContentError"
470470
}
471471
],
472472
"Id": "b4c3291a-d779-4cd5-a8e2-7310bfa50196",
473473
"Cloud": "Prod",
474474
"Version": "beta",
475-
"CreatedDateTime": "2024-08-08T20:39:16.9772979Z",
475+
"CreatedDateTime": "2024-11-28T20:39:16.9772979Z",
476476
"WorkloadArea": "Sites and lists",
477477
"SubArea": ""
478478
},

0 commit comments

Comments
 (0)