newsLinkPage resource type
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a news link page in a site pages list.
Inherits from baseSitePage.
Methods
| Method | Return type | Description |
|---|---|---|
| List | newsLinkPage collection | Get a list of the newsLinkPage objects and their properties. |
| Create | newsLinkPage | Create a new newsLinkPage in the site pages list of a site. |
| Get | newsLinkPage | Get the metadata of a newsLinkPage in the site pages list of a site. |
| Update | newsLinkPage | Update the properties of a newsLinkPage object. |
| Delete | None | Delete a newsLinkPage object. |
| Publish | None | Publish the latest version of a newsLinkPage resource that makes the version available to all users. |
Properties
| Property | Type | Description |
|---|---|---|
| bannerImageWebUrl | String | A link to the banner image for the newsLinkPage. |
| createdBy | identitySet | Identity of the creator of this newsLinkPage. Read-only. Inherited from baseSitePage. |
| 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. |
| description | String | The descriptive text for the newsLinkPage. The maximum length limit is 250 characters. Inherited from baseSitePage. |
| eTag | String | ETag for the newsLinkPage. Inherited from baseSitePage. |
| id | String | The unique identifier of the newsLinkPage. Inherited from baseSitePage. |
| lastModifiedBy | identitySet | Identity of the last modifier of this newsLinkPage. Read-only. Inherited from baseSitePage. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the newsLinkPage was last modified. 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. |
| name | String | The name of the newsLinkPage. Inherited from baseSitePage. |
| newsSharepointIds | sharepointIds | The SharePoint IDs of the referenced news article if it's recognized as a SharePoint resource. Read-only. |
| newsWebUrl | String | The URL of the news article referenced by the newsLinkPage. It can be an external link. |
| pageLayout | pageLayoutType | 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. |
| parentReference | itemReference | Parent information if the newsLinkPage has a parent. Inherited from baseSitePage. |
| publishingState | publicationFacet | The publishing status and the version of the page. Inherited from baseSitePage. |
| title | String | Title of the newsLinkPage. The maximum length limit is 110 characters. Inherited from baseSitePage. |
| webUrl | String | URL that displays the resource in the browser. Read-only. Inherited from baseSitePage. |
Instance attributes
Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.
| Property name | Type | Description |
|---|---|---|
| @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.
Relationships
| Relationship | Type | Description |
|---|---|---|
| createdByUser | user | Identity of the user who created the newsLinkPage. Read-only. Inherited from baseSitePage. |
| lastModifiedByUser | user | Identity of the user who last modified the newsLinkPage. Read-only. Inherited from baseSitePage. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.newsLinkPage",
"bannerImageWebUrl": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"description": "String",
"eTag": "String",
"id": "String (identifier)",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"name": "String",
"newsSharepointIds": {"@odata.type": "microsoft.graph.sharepointIds"},
"newsWebUrl": "String",
"pageLayout": "String",
"parentReference": {"@odata.type": "microsoft.graph.itemReference"},
"publishingState": {"@odata.type": "microsoft.graph.publicationFacet"},
"title": "String",
"webUrl": "String"
}