如何上传/操作Apple News JSON文件?

时间:2017-04-26 15:39:28

标签: ios json apple-news

我是Apple News的独立发布商,使用News Publisher创建文章。我正在寻找一些关于我的文章格式化和呈现方式的灵活性,并且想知道如何为将来的文章上传JSON文档 - 我以前从未使用它。熟悉该服务或语言的人是否知道如何将此类内容与Apple News联系起来?我已经查看了他们的帮助部分,但是看起来更多的问题而不是答案。谢谢!

-Tyler

1 个答案:

答案 0 :(得分:3)

基本文章看起来像这样

{
    "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中提供examples of implementing the code。您可以单独上传文章或包含文章及其链接文件的包。

已编辑:使用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以获取有关预览和发布上传文章的说明。