Ativa, suspende ou cancela o acesso de um assinante a um produto
Upsert por (parceiro, assinante, produto): chamar novamente com o mesmo assinante/produto e um status diferente atualiza o entitlement existente — não cria duplicado. Por ser um upsert, repetir a mesma chamada é seguro; não há (nem é necessário) um header Idempotency-Key — esse mecanismo chegou a ser proposto, mas não está implementado.
Enquanto o SSO não existe, o entitlement fica registrado em uma tabela própria de parceiro no projeto do produto (partner_subscribers) — ele não cria nem altera a assinatura de nenhuma conta do app oficial. Ver Modelo de dados.
Authorizations
Client credentials — para Entitlements (escrita), Subscriber Status e Billing (leitura). Cada endpoint exige o escopo correspondente; um token sem o escopo recebe 403.
Body
Identificador do assinante no sistema do parceiro.
novelai, novelaudio, historinhai active, suspended, canceled Plano contratado pelo assinante no parceiro (mapeado para um plano interno Googa). Opcional.
"reader-plus"
Response
Entitlement aplicado.
true