Article

Text that appears alongside article headlines — author name, channel name, subtitle, and so on.

Maximum length: 100 characters.

Default value: metadata.authors from the Apple News Format article.

The date and time the article was created.

The content of the article, as an Apple News Format document.

The unique identifier of the article.

A Boolean value that indicates whether this article should be considered for featuring in Apple News.

Default value: false

A Boolean value that indicates whether this article should be public (live) or should be a preview that’s only visible to members of your channel. Set isPreview to false to publish the article immediately and make it visible to all News users.

If your channel hasn’t been approved to publish articles in Apple News Format, setting isPreview to false results in an ONLY_PREVIEW_ALLOWED error.

Default value: true if your channel hasn’t yet been approved to publish articles in Apple News Format; false if your channel has been approved.

A Boolean value that indicates whether this article consists of sponsored content for promotional purposes. You must mark sponsored content as such; channels that don’t follow this policy may be suspended.

When using isSponsored, if you don’t want the sponsored article to appear in your channel’s feed, set sections to [] (an empty array).

Default value: false

The URL of the channel in which the article appears.

A string value that indicates the viewing audience for the content. The types of audiences or ratings are KIDS, MATURE, and GENERAL, or null if unspecified. A MATURE rating indicates explicit content that’s only appropriate for a specific audience.

Default value: null

The date and time this article was last modified.

The current revision token for the article.

You must send the latest revision when issuing a request to Update an Article.

The value of this field must match the latest revision from an earlier Create, Read, or Update Article call. This field prevents multiple users from updating an article simultaneously, which results in data loss.

Required: Yes

The URL to the article within the News app.

The current state of the article, which can be one of the following:

• PROCESSING: The article has been published and is processing.

• LIVE: The article has been published, has finished processing, and is visible in the News app.

• PROCESSING_UPDATE: A previous version of the article is visible in the News app, and an update is currently in processing.

• TAKEN_DOWN: The article was previously visible in the News app, but was taken down.

• FAILED_PROCESSING: The article failed during processing and isn’t visible in the News app.

• FAILED_PROCESSING_UPDATE: A previous version of the article is visible in the News app, but an update failed during processing.

• DUPLICATE. The article is a duplicate of another article and isn’t visible in the News app.

The title of the article, as specified in the Apple News Format document.

The article.

A list of warning messages indicating nonfatal problems with the article.