GetReader
GetReader consente a un editore di verificare se uno dei suoi lettori con un PPID noto ha collegato il proprio abbonamento a Google. Tramite una richiesta GET, il publisher esegue una query per trovare un PPID appartenente a un determinato ID pubblicazione.
Richiesta
//GET /v1/publications/dailybugle.com/readers/6789
Risposta
L'endpoint restituirà un codice 200 con un corpo JSON contenente il created_time dell'abbonamento collegato o un errore se non viene trovato alcun PPID per la pubblicazione. Per ulteriori informazioni, consulta la sezione relativa agli errori.
{
"name": "publications/gtech-demo.appspot.com/readers/81112",
"create_time": "2022-04-19T04:53:40+00:00"
}
GetReaderEntitlements
GetReaderEntitlements consente a un editore di eseguire query per verificare i diritti per un PPID che ha fornito in precedenza. Con una richiesta GET, l'editore richiede i diritti fornendo un PPID e un ID pubblicazione.
Richiesta
//GET /v1/publications/dailybugle.com/readers/6789/entitlements
Risposta
Per una richiesta andata a buon fine, il formato di restituzione è identico a quello utilizzato per archiviare i diritti con
UpdateReaderEntitlements Richiesta 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"
}
]
}
Per gli utenti che non hanno diritti, ma dispongono di un PPID collegato (ad esempio, un diritto scaduto ed eliminato definitivamente), una richiesta di diritti restituirà un array di diritti vuoto come parte dell'oggetto Diritti standard.
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"createTime": "2023-02-07T17:38:57.425577Z"
}
UpdateReaderEntitlements
UpdateReaderEntitlements viene utilizzato per creare e aggiornare i diritti di un lettore in base al suo PPID.
Questo payload di esempio concede al lettore con diritti PPID 6789 tre ID prodotto per il Daily Bugle: dailybugle.com:basic, dailybugle.com:premium e dailybugle.com:deluxe. Quando in un secondo momento il lettore 6789 utilizza le piattaforme Google per la Ricerca e Discover, l'elenco "Dai tuoi abbonamenti" mostrerà tutti i risultati pertinenti degli articoli di Dailybugle.com taggati con uno di questi ID prodotto.
Richiesta
//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"
}
]
}
Risposta
Dopo un'operazione PATCH riuscita, l'oggetto entitlements salvato verrà
restituito, nello stesso formato di GetReaderEntitlements.
DeleteReader
DeleteReader consente a un editore di eliminare manualmente l'abbonamento collegato di un lettore. Con una richiesta DELETE, l'editore invia un PPID per un ID pubblicazione da eliminare.
Richiesta
//DELETE /v1/publications/dailybugle.com/readers/6789
Risposta
Un'eliminazione riuscita restituisce un codice 200 con un oggetto JSON vuoto {}.
{}