GetReader
借助 GetReader
,发布商可以验证其某个具有已知 PPID 的读者是否已将其订阅关联到 Google。发布商使用 GET
请求查询属于特定发布内容 ID 的 PPID。
请求
//GET /v1/publications/dailybugle.com/readers/6789
响应
端点会返回 200(带有包含关联订阅的 created_time
的 JSON 正文),或者如果找不到发布内容的 PPID,则返回错误。如需了解详情,请参阅“错误”部分。
{
"name": "publications/gtech-demo.appspot.com/readers/81112",
"create_time": "2022-04-19T04:53:40+00:00"
}
GetReaderEntitlements
借助 GetReaderEntitlements
,发布商可以查询发布商之前提供的 PPID 的使用权。使用 GET 请求,发布商可以通过提供 PPID 和发布内容 ID 来请求使用权。
请求
//GET /v1/publications/dailybugle.com/readers/6789/entitlements
响应
对于成功的请求,返回格式与通过 UpdateReaderEntitlements
PATCH
请求存储使用权的格式相同。
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"entitlements": [
{
"product_id": "dailybugle.com:basic",
"subscription_token": "dnabhdufbwinkjanvejskenfw",
"detail": "This is our basic plan",
"expire_time": "2022-08-19T04:53:40+00:00"
},
{
"product_id": "dailybugle.com:premium",
"subscription_token": "wfwhddgdgnkhngfw",
"detail": "This is our premium plan",
"expire_time": "2022-07-19T04:53:40+00:00"
},
{
"product_id": "dailybugle.com:deluxe",
"subscription_token": "fefcbwinkjanvejfefw",
"detail": "This is our deluxe plan",
"expire_time": "2022-08-20T04:53:40+00:00"
}
]
}
对于没有使用权但拥有关联的 PPID(例如,已过期并已完全清除的许可)的用户,使用权请求将返回空的使用权数组作为标准使用权对象的一部分。
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"createTime": "2023-02-07T17:38:57.425577Z"
}
UpdateReaderEntitlements
UpdateReaderEntitlements
用于根据读者的 PPID 为其创建和更新授权。
此示例载荷会向读者授予 PPID 6789 使用权,以便读者访问 Daily Bugle 的三个产品 ID:dailybugle.com:basic
、dailybugle.com:premium
和 dailybugle.com:deluxe
。如果读者 6789 随后使用 Google Surfaces for Google 搜索和 Google 探索,“来自您的订阅项目”列表将会显示来自 dailybugle.com 文章的所有相关结果,这些文章带有上述任何产品 ID。
请求
//PATCH /v1/publications/dailybugle.com/readers/6789/entitlements
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"entitlements": [
{
"product_id": "dailybugle.com:basic",
"subscription_token": "dnabhdufbwinkjanvejskenfw",
"detail": "This is our basic plan",
"expire_time": "2022-08-19T04:53:40+00:00"
},
{
"product_id": "dailybugle.com:premium",
"subscription_token": "wfwhddgdgnkhngfw",
"detail": "This is our premium plan",
"expire_time": "2022-07-19T04:53:40+00:00"
},
{
"product_id": "dailybugle.com:deluxe",
"subscription_token": "fefcbwinkjanvejfefw",
"detail": "This is our deluxe plan",
"expire_time": "2022-08-20T04:53:40+00:00"
}
]
}
响应
PATCH 操作成功后,系统将返回已保存的 entitlements
对象,格式与 GetReaderEntitlements
相同。
DeleteReader
借助 DeleteReader
,发布商可以手动删除读者的关联订阅。发布商使用 DELETE
请求提交要删除的发布内容 ID 的 PPID。
请求
//DELETE /v1/publications/dailybugle.com/readers/6789
响应
如果删除成功,则返回 200 及空的 JSON 对象 {}
。
{}