GetReader
GetReader permite que o editor valide se um dos leitores com um PPID conhecido vinculou a assinatura ao Google. O editor pode usar uma solicitação GET para consultar um PPID pertencente a um determinado ID de publicação.
Solicitação
//GET /v1/publications/dailybugle.com/readers/6789
Resposta
O endpoint retornará 200 com um corpo JSON contendo o created_time da assinatura vinculada ou um erro, se nenhum PPID for encontrado para a publicação. Para mais informações, consulte a seção de erros.
{
"name": "publications/gtech-demo.appspot.com/readers/81112",
"create_time": "2022-04-19T04:53:40+00:00"
}
GetReaderEntitlements
GetReaderEntitlements permite que o editor consulte os direitos para um PPID fornecido anteriormente pelo editor. Com uma solicitação GET, o editor pode solicitar os direitos fornecendo um PPID e um ID de publicação.
Solicitação
//GET /v1/publications/dailybugle.com/readers/6789/entitlements
Resposta
Para que a solicitação funcione, o formato de retorno precisa ser idêntico ao usado para armazenar direitos com a
solicitação 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"
}
]
}
Para usuários que não têm direitos, mas têm um PPID vinculado (por exemplo, um direito que expirou e foi limpo), uma solicitação de direitos retornará uma matriz de direitos vazia como parte do objeto de direitos padrão.
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"createTime": "2023-02-07T17:38:57.425577Z"
}
UpdateReaderEntitlements
O UpdateReaderEntitlements é usado para criar e atualizar direitos para um leitor com base no PPID dele.
Esta amostra de payload concede ao leitor os direitos de PPID 6789 para três IDs de produto do The Daily Bugle: dailybugle.com:basic, dailybugle.com:premium e dailybugle.com:deluxe. Quando o leitor 6789 usar as plataformas do Google para a Pesquisa e o Discover, a lista "Das suas assinaturas" vai mostrar os resultados relevantes de artigos do dailybugle.com marcados com qualquer um desses IDs de produto.
Solicitação
//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"
}
]
}
Resposta
Após uma operação PATCH bem-sucedida, o objeto entitlements salvo será
retornado no mesmo formato que GetReaderEntitlements.
DeleteReader
DeleteReader permite que o editor exclua manualmente a assinatura vinculada de um leitor. O editor deve usar uma solicitação DELETE para enviar um PPID para que um ID de publicação seja excluído.
Solicitação
//DELETE /v1/publications/dailybugle.com/readers/6789
Resposta
A exclusão retorna um código 200 com um objeto JSON vazio {}.
{}