Solução de problemas

As informações neste documento ajudam a resolver problemas que podem surgir ao implementar a API Subscription Linking.

A solicitação da API Subscription Linking trava na tela de carregamento

Exemplo de erro:

Símbolo de carregamento

Figura 1. A solicitação da API Subscription Linking não carrega.

Para resolver esse problema, verifique o seguinte:

  • Adicione as origens das páginas, incluindo subdomínios de teste, como URLs extras nas configurações de publicação da Central do Editor.
  • Para implementações do Acesso completo ou Reader Revenue Manager Enterprise, adicione as origens das páginas, incluindo subdomínios de teste, às origens JavaScript autorizadas do cliente OAuth 2.0 que você configurou para essa implementação. Faça isso no console do Google Cloud.

Não foi possível vincular a conta

Exemplo de erro:

Não foi possível vincular a conta

Figura 2. Problema: não foi possível vincular a conta.

Para resolver esse problema, verifique o seguinte:

  • Aceite os Termos de Serviço da API Subscription Linking na Central do Editor. Acesse as configurações da API Subscription Linking e clique em Assinar os Termos de Serviço da vinculação de assinaturas.
  • Se a Conta do Google já tiver sido vinculada, você vai receber uma mensagem de erro quando tentar vincular a assinatura novamente. Para repetir o teste de integração do cliente, desvincule a assinatura na página de assinaturas da Conta do Google.

Erro de permissão ao chamar a API Subscription Linking

Exemplo de erro:

Código 403
Mensagem 'readerrevenuesubscriptionlinking.readerEntitlements.update' negado no recurso
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements'
(ou ele pode não existir)."

Para resolver esse problema, verifique o seguinte:

  • Use o mesmo projeto do GCP especificado nas configurações da API Subscription Linking.
  • Verifique se a API Subscription Linking está ativada no seu projeto do GCP.
  • No IAM do GCP, verifique se a conta do serviço tem o papel Administrador de vinculação de assinaturas.
  • Se você usa a API REST, use também o ID da publicação que você forneceu na configuração da API Subscription Linking. Por exemplo, se o ID da publicação é example.com, ele precisa estar incluído no URL da solicitação.
    • ✅ Use apenas o ID de publicação configurado: publications/example.com/readers/10078823/entitlements
    • ❌ Não use um ID de publicação diferente daquele especificado na configuração da Subscription Linking: publications/example-staging.com/readers/10078823/entitlements
    • ❌ Não inclua o produto da publicação na solicitação: publications/example.com:premium/readers/10078823/entitlements

Erro de argumento inválido ao atualizar o direito de acesso

Exemplo de erro:

Mensagem Erro: a solicitação contém um argumento inválido

Para resolver esse problema, verifique o seguinte:

  • Confirme se você está fornecendo o objeto entitlements no formato correto. Confira este exemplo.
  • Confirme se product_id está no formato publication_id:product.
    • ✅ Exemplo válido: "product_id":"example.com:basic"
    • ❌ Exemplo inválido: "product_id":"example.com"

Artigos destacados não aparecem nos resultados da pesquisa

Para resolver esse problema, verifique o seguinte: