GetReader
GetReader cho phép nhà xuất bản xác thực xem một trong các độc giả có PPID đã biết đã liên kết gói thuê bao của họ với Google hay chưa. Khi sử dụng yêu cầu GET, nhà xuất bản sẽ truy vấn một PPID thuộc về một Mã nhận dạng ấn bản cụ thể.
Yêu cầu
//GET /v1/publications/dailybugle.com/readers/6789
Phản hồi
Điểm cuối sẽ trả về giá trị 200 với nội dung JSON chứa created_time của gói thuê bao được liên kết, hoặc trả về lỗi nếu không tìm thấy PPID cho ấn bản. Hãy xem phần lỗi để biết thêm thông tin.
{
"name": "publications/gtech-demo.appspot.com/readers/81112",
"create_time": "2022-04-19T04:53:40+00:00"
}
GetReaderEntitlements
GetReaderEntitlements cho phép nhà xuất bản truy vấn các quyền đối với PPID mà nhà xuất bản đã cung cấp trước đó. Khi sử dụng yêu cầu GET, nhà xuất bản yêu cầu cấp các quyền đó bằng cách cung cấp PPID và Mã nhận dạng ấn bản.
Yêu cầu
//GET /v1/publications/dailybugle.com/readers/6789/entitlements
Phản hồi
Đối với một yêu cầu thành công, định dạng trả về phải giống với định dạng dùng để lưu trữ các quyền có
UpdateReaderEntitlements Yêu cầu 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"
}
]
}
Đối với những người dùng không có quyền nhưng có PPID liên kết (ví dụ: một quyền đã hết hạn và đã bị xoá hoàn toàn), yêu cầu cấp quyền sẽ trả về một mảng quyền trống như một phần của đối tượng quyền tiêu chuẩn.
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"createTime": "2023-02-07T17:38:57.425577Z"
}
UpdateReaderEntitlements
UpdateReaderEntitlements được dùng để tạo và cập nhật quyền cho người đọc, dựa trên PPID của họ.
Tải trọng mẫu này cấp cho người đọc quyền sử dụng PPID 6789 đối với 3 mã sản phẩm của The Daily Bugle: dailybugle.com:basic, dailybugle.com:premium và dailybugle.com:deluxe. Sau đó, khi độc giả 6789 sử dụng các nền tảng của Google dành cho Tìm kiếm và Khám phá, danh sách "Từ các gói thuê bao của bạn" sẽ giới thiệu mọi kết quả có liên quan từ các bài viết của Dailybugle.com được gắn thẻ bất kỳ mã sản phẩm nào trong số này.
Yêu cầu
//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"
}
]
}
Phản hồi
Sau khi thực hiện thao tác PATCH thành công, đối tượng entitlements đã lưu sẽ là
được trả về, ở định dạng giống như GetReaderEntitlements.
DeleteReader
DeleteReader cho phép nhà xuất bản xoá gói thuê bao đã liên kết của độc giả theo cách thủ công. Khi sử dụng yêu cầu DELETE, nhà xuất bản gửi một PPID để yêu cầu Mã nhận dạng ấn bản cần xoá.
Yêu cầu
//DELETE /v1/publications/dailybugle.com/readers/6789
Phản hồi
Thao tác xoá thành công sẽ trả về kết quả 200 với đối tượng JSON trống {}.
{}