GetReader
GetReader permet à un éditeur de vérifier si l'un de ses lecteurs avec un PPID connu a associé son abonnement à Google. À l'aide d'une requête GET, l'éditeur interroge un PPID appartenant à un ID de publication particulier.
Requête
//GET /v1/publications/dailybugle.com/readers/6789
Réponse
Le point de terminaison renvoie un code 200 avec un corps JSON contenant le created_time de l'abonnement associé, ou une erreur si aucun PPID n'a été trouvé pour la publication. Pour en savoir plus, consultez la section Erreurs.
{
"name": "publications/gtech-demo.appspot.com/readers/81112",
"create_time": "2022-04-19T04:53:40+00:00"
}
GetReaderEntitlements
GetReaderEntitlements permet à un éditeur d'interroger les droits d'accès pour un PPID qu'il a précédemment fourni. À l'aide d'une demande GET, l'éditeur demande les droits d'accès en fournissant un PPID et un ID de publication.
Requête
//GET /v1/publications/dailybugle.com/readers/6789/entitlements
Réponse
Si une requête aboutit, le format renvoyé est identique à celui utilisé pour stocker les droits d'accès avec la requête 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"
}
]
}
Pour les utilisateurs qui ne disposent pas de droits d'accès, mais qui possèdent un PPID associé (par exemple, un droit d'accès qui a expiré et qui a été supprimé définitivement), une requête de droits d'accès renvoie un tableau correspondant vide dans l'objet Entitlements standard.
{
"name": "publications/dailybugle.com/readers/6789/entitlements",
"createTime": "2023-02-07T17:38:57.425577Z"
}
UpdateReaderEntitlements
UpdateReaderEntitlements permet de créer et mettre à jour les droits d'accès d'un lecteur en fonction de son PPID.
Cet exemple de charge utile accorde au lecteur avec le PPID 6789 des droits d'accès à trois ID produit pour The Daily Bugle : dailybugle.com:basic, dailybugle.com:premium et dailybugle.com:deluxe. Lorsque le lecteur 6789 utilise ensuite les surfaces Google pour la recherche et Discover, la liste "Source : vos abonnements" affiche tous les résultats pertinents des articles issus de dailybugle.com qui sont associés à l'un de ces ID produit.
Requête
//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"
}
]
}
Réponse
Lorsqu'une opération PATCH réussit, l'objet entitlements enregistré est renvoyé, au même format que GetReaderEntitlements.
DeleteReader
DeleteReader permet à un éditeur de supprimer manuellement l'abonnement associé d'un lecteur. À l'aide d'une requête DELETE, l'éditeur envoie un PPID pour qu'un ID de publication soit supprimé.
Requête
//DELETE /v1/publications/dailybugle.com/readers/6789
Réponse
Une suppression réussie renvoie un code 200 avec un objet JSON vide {}.
{}