PRD: Reviews history beyond the 7-day window (GCS CSV reports)

[PollyGlot]

Statut

PRD planifié — promu depuis le parking le 2026-05-31 (Route 1.x, voir ROADMAP.md). Spike d'investigation d'abord (voir checklist plus bas). En miroir de docs/BACKLOG.md §"Reviews — au-delà de la fenêtre 7 jours" (les autres sections du BACKLOG ont déjà leur issue parking ; celle-ci manquait).

Contexte

gplay reviews list (#92, issue #61) ne couvre que ce que l'endpoint reviews.list expose : les 7 derniers jours. La Play Console (site web) montre l'historique complet des reviews — l'API Developer, elle, ne le fait pas. C'est une limite de l'API, pas de gplay (le CLI affiche d'ailleurs un WARN permanent à ce sujet).

Le canal à utiliser

Google expose l'historique long via des CSV reports déposés dans un bucket GCS dédié au développeur :

gs://pubsite_prod_rev_<developer-id>/reviews/reviews_<package>_YYYYMM.csv

C'est le canal officiel pour l'historique reviews au-delà de 7 jours (le même bucket sert aussi aux stats/vitals exports).

Pourquoi plus tard

• Auth différente : scope OAuth GCS (devstorage.read_only) en plus du scope androidpublisher — à résoudre depuis le service account existant.
• Parseur CSV séparé : schéma propre aux reports Play (colonnes par locale, encodage).
• Utile pour l'analyse longitudinale, pas pour le flow CI standard.

À investiguer (avant tout PRD)

• Confirmer le format/chemin actuel des CSV reports et le nommage par mois.
• Déterminer le scope/credential GCS et comment le dériver du service account déjà résolu.
• Décider de la surface CLI : commande dédiée (gplay reviews history ?) vs flag (reviews list --since), et le rendu (table/json).

Refs

• docs/BACKLOG.md §"Reviews — au-delà de la fenêtre 7 jours"
• PRD: Reviews (list with 7-day window, reply, batch) #6 (PRD Reviews), Reviews: gplay reviews list (7-day window, auto-paginated, --stars filter) #61 (reviews list), Reviews: gplay reviews reply (single + --batch) #62 (reviews reply)

[PollyGlot]

This was generated by AI during triage.

Promu : type:parking → type:prd

Transition : Parking → PRD planifié (Route 1.x), le 2026-05-31.

• Labels : -type:parking +type:prd (garde area:reviews)
• Titre : Parking: … → PRD: …
• Position PRD: Releases (upload, promote, rollout state machine) #4 dans ROADMAP.md § Route 1.x — PRD planifiés.

⚠️ Pas encore PRD-ready : la checklist d'investigation du corps (format/chemin des CSV, scope OAuth GCS dérivé du service account, surface CLI) doit être levée par un spike avant tout PRD complet. C'est pourquoi il est ordonné en dernier.