我是 Apple News 的独立发布者,并使用 News Publisher 创建文章。我一直在为我的文章的格式和呈现方式寻找一些灵活性,并且想知道如何为以后的文章上传 JSON 文档——我以前从未使用过它。熟悉该服务或语言的人是否知道如何将此类内容连接到 Apple News?我已经查看了他们的帮助部分,但问题多于答案。谢谢!
-泰勒
我是 Apple News 的独立发布者,并使用 News Publisher 创建文章。我一直在为我的文章的格式和呈现方式寻找一些灵活性,并且想知道如何为以后的文章上传 JSON 文档——我以前从未使用过它。熟悉该服务或语言的人是否知道如何将此类内容连接到 Apple News?我已经查看了他们的帮助部分,但问题多于答案。谢谢!
-泰勒
一篇基本的文章是这样的
{
"version": "1.4",
"identifier": "sketchyTech_Demo",
"title": "My First Article",
"language": "en",
"layout": {},
"components": [
{
"role": "title",
"text": "My First Article"
},
{
"role": "body",
"text": "This is just over the minimum amount of JSON required to create a valid article in Apple News Format. If you were to delete the dictionary enclosing this text, you'd be there."
}
],
"componentTextStyles": {}
}
并始终保存为article.json
. 在 components 数组中,您可以展示任何Apple News Components。(注意:您不必使用纯 json,您可以使用 markdown 或 html 代替文本以简化样式。)
我在GitHub 上整理了这组更广泛的示例,您还将在那里找到有关使用News Preview测试文章的详细信息,这将通过列出错误等来帮助您。
一旦您准备好上传到您使用首先注册的API的服务,Python 中提供了实现代码的示例。您可以单独上传文章,也可以上传包含文章及其链接文件的捆绑包。
已编辑:使用 Python 上传文章
将以下代码复制并粘贴到文本编辑器中并另存为upload.py
#!/usr/bin/python
import requests
import base64
from hashlib import sha256
import hmac
from datetime import datetime
import glob
import argparse
import os
import mimetypes
from requests.packages.urllib3.filepost import encode_multipart_formdata
from requests.packages.urllib3.fields import RequestField
arg_parser = argparse.ArgumentParser(description='Publish an article using the Apple News API')
arg_parser.add_argument('article_directory', metavar='ARTICLE_DIR', type=str, help='A directory containing an article.json file and resources')
args = arg_parser.parse_args()
channel_id = '[YOUR CHANNEL-ID]'
api_key_id = '[YOUR API-KEY]'
api_key_secret = '[YOUR API KEY-SECRET]'
method = 'POST'
url = 'https://news-api.apple.com/channels/%s/articles' % channel_id
session = requests.Session()
session.verify = False
def part(filename):
name = os.path.basename(filename)
with open(filename) as f:
data = f.read()
part = RequestField(name, data)
part.headers['Content-Disposition'] = 'form-data; filename="%s"; size=%d' % (name, os.stat(filename).st_size)
part.headers['Content-Type'] = 'application/json' if name.endswith('.json') else 'application/octet-stream'
return part
def send_signed_request(method, url, filenames):
body, content_type = encode_multipart_formdata([part(f) for f in filenames])
req = requests.Request(method, url, data=body, headers={'Content-Type': content_type})
req = req.prepare()
date = datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')
canonical_request = method + url + str(date) + content_type + body
key = base64.b64decode(api_key_secret)
hashed = hmac.new(key, canonical_request, sha256)
signature = hashed.digest().encode('base64').rstrip('\n')
authorization = 'HHMAC; key=%s; signature=%s; date=%s' % (api_key_id, str(signature), date)
req.headers['Authorization'] = authorization
return session.send(req)
response = send_signed_request(method, url, glob.glob('%s/*' % args.article_directory))
print response.status_code
print response.text
接下来将以下元素的值更改为 Apple 提供给您的您自己的值:
channel_id = '[YOUR CHANNEL-ID]'
api_key_id = '[YOUR API-KEY]'
api_key_secret = '[YOUR API KEY-SECRET]'
最后打开终端并从 Finder 中将upload.py
您创建的文件拖到命令行中,然后在拖入包含article.json
文件的文件夹之前留出一个空格,以便两个路径在一行上彼此相邻显示(第一个是upload.py
文件,第二个是包含您的文件的文件夹article.json
)。最后按 Enter。
您应该会看到一些返回的 JSON。现在打开 iCloud.com 内的 News Publisher 并导航到Articles > Drafts from CMS
有关预览和发布已上传文章的说明。