GetReader
GetReader cho phép nhà xuất bản xác thực xem một trong những độc giả có PPID đã biết có liên kết gói thuê bao của họ với Google hay không. Khi sử dụng yêu cầu GET, nhà xuất bản sẽ truy vấn PPID thuộc một Mã ấ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ề mã 200 với nội dung JSON chứa created_time của gói thuê bao được liên kết hoặc một 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 một PPID mà nhà xuất bản đã cung cấp trước đó. Bằng cách sử dụng yêu cầu GET, nhà xuất bản yêu cầu các quyền bằng cách cung cấp PPID và Mã ấn bản.
Yêu cầu
//GET /v1/publications/dailybugle.com/readers/6789/entitlements
Phản hồi
Đối với yêu cầu thành công, định dạng trả về giống với định dạng dùng để lưu trữ các quyền bằng yêu cầu PATCH UpdateReaderEntitlements.
{
"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 được liên kết (ví dụ: quyền đã hết hạn và bị xoá), yêu cầu quyền sẽ trả về một mảng quyền trống trong đố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 dùng để tạo và cập nhật quyền cho một người đọc, dựa trên PPID của họ.
Trọng tải mẫu này cấp cho trình đọc có quyền PPID 6789 đối với ba mã sản phẩm cho The Daily Bugle: dailybugle.com:basic, dailybugle.com:premium và dailybugle.com:deluxe. Sau đó, khi người đọc 6789 sử dụng các nền tảng của Google cho Tìm kiếm và Khám phá, danh sách "Từ các gói thuê bao của bạn" sẽ hiển thị mọi kết quả có liên quan từ các bài viết trên dailybugle.com được gắn thẻ bằng 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 thao tác PATCH thành công, đối tượng entitlements đã lưu sẽ được trả về, theo đị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 sẽ gửi một PPID cho một Mã ấ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ề mã 200 với đối tượng JSON trống {}.
{}