Requisitos da integração

Geralmente, para implementar o Assine com o Google, é preciso concluir as tarefas de implementação abaixo, mas é possível que certas circunstâncias (como configurações específicas do site ou do back-end) tornem algumas delas desnecessárias. Nos requisitos de implementação, o termo "Editor" significa "Você" no Adendo do Assine com o Google no Contrato de distribuição para desenvolvedores do Google Play.

  1. Conta de desenvolvedor do Google Play:

    O Editor precisa criar uma conta de desenvolvedor do Google Play, fazer upload de um aplicativo e ativá-lo para faturamento. O Editor precisa publicar o aplicativo para o estágio de produção ou usar um de produção.

  2. Configuração de publicação: o Editor precisa trabalhar com os representantes das soluções técnicas do Google para definir determinados pontos de configuração exigidos para configurar a integração. Por exemplo, URLs de endpoints de API obrigatórios, logotipo e propriedades de branding, detalhes do SKU, URLs dos Termos de Serviço e da Política de Privacidade. Essa configuração precisa ser feita por publicação integrada.

  3. Marcação de página: o Editor precisa adicionar dados estruturados, que incluem um ID de publicação (igual ao da configuração da publicação) e um marcador de direito. Esses dados precisam ser incluídos em todas as páginas de matérias, inclusive documentos para dispositivos móveis ou computador.

  4. Integração com o cliente do swg.js: o Editor precisa integrar o cliente JavaScript do Google no site de publicação. O Editor precisa incluir a biblioteca de cliente swg.js em todas as páginas de matérias em que um paywall pode ser acionado, inclusive as que façam parte da implementação do paywall do lado do servidor. Além disso, é preciso chamar a função swg.js getEntitlements e processar a resposta dessa função adequadamente.

    Se o Editor criar versões para dispositivos móveis das páginas e elas acionarem paywalls, essas páginas precisam estar configuradas com um paywall para dispositivos móveis que use os direitos do Assine com o Google, para que os direitos dos usuários desse recurso sejam respeitados.

  5. Integração com o Android: se o Editor vender conjuntos de SKU divergentes no Android e na Web ou tiver vários apps para a mesma publicação, ele precisará atualizar os apps Android para conferir a compra de assinaturas, além de chamar a API Publication do Assine com o Google e conceder o acesso adequadamente.

  6. Fazer login com o Google: o Editor precisa incluir uma opção de Fazer login com o Google em todas as páginas de login da Web e implementar as bibliotecas SIG necessárias para os apps iOS e Android.

    Essa implementação de Fazer login com o Google precisa verificar a API Publication para que a Conta do Google (caso já tenha um direito vinculado ao Editor) seja associada à conta do usuário no site do Editor. Se a API Publication do Assine com o Google indicar que o usuário tem um direito de que o Editor não tem conhecimento, ele vai conceder o acesso apropriado a usuários conhecidos e iniciar um fluxo de criação de conta deferida se o usuário for desconhecido.

    Se o aplicativo para dispositivos móveis ou Web de um Editor fornecer uma experiência sem custos financeiros e não limitar o acesso com um paywall, o Fazer login com o Google não será necessário. Além disso, no caso incomum em que um Editor não tenha um sistema de gerenciamento de usuários, ou seja, em que depende apenas do Assine com o Google para gerenciar transações de usuários, a integração do Fazer login do Google não é necessária (nem possível).

  7. Gerenciador de criação de conta após a compra: os Editores precisam criar contas para os usuários após uma compra.

    Na Web, um Editor precisa enviar de volta os eventos de assinatura swg.js e os dados de direitos para a infraestrutura do Editor. Para compras feitas nas plataformas do Google ou no app, o Editor precisa usar o fluxo de criação de conta deferida para receber notificações de criação de conta pelo Pub/Sub ou pela API Publication.

    É preciso se inscrever nos eventos de Pub/Sub do Play Cloud ou da Receita dos leitores na infraestrutura do Editor.

    O Editor precisa usar os dados de compra dos eventos de assinatura para solicitar o perfil do usuário e os dados da assinatura da API Subscription Status do Google. Depois de receber esses dados, a API Account Management precisa:

    1. criar uma conta com as informações do perfil do usuário disponibilizadas pelo Google e associar a assinatura a essa conta; ou
    2. anexar o perfil do usuário do Google e os dados de assinatura a uma conta de usuário no site do Editor.

    Caso o Editor não tenha um sistema de gerenciamento de usuários, ou seja, dependa apenas do Assine com o Google para gerenciar transações de usuários, não é necessário (nem possível) criar uma conta após a compra.

  8. Integração do iOS: se o Editor tiver conteúdo com paywall associado a uma SKU do Assine com o Google em um app iOS, após o uso do Login do Google, ele deverá verificar se há direitos no back-end. Se não houver nenhum direito, ele precisará chamar a API Publication do Assine com o Google para verificar os direitos e, caso haja, conceder acesso.

  9. Vinculação de assinaturas: ao final de qualquer fluxo de compra que não seja processada pelo Assine com o Google, o Editor deve integrar a função de vincular assinaturas para permitir que os usuários possam vincular a Conta do Google. Para implementar a vinculação de assinaturas, os Editores precisam criar um projeto do Google Cloud.

  10. Exigências para Editores na Alemanha: os Editores da Alemanha precisam implementar o seguinte:

    1. Sempre exibir um botão de cancelamento legível e claro no site para assinantes da Alemanha, com uma mensagem como "Clique aqui para cancelar contratos" ["Verträge hier kündigen"], sem margem para ambiguidade.
    2. Direcionar os usuários da Alemanha que assinam sua publicação para o Assine com o Google e a clicar no botão específico para abrir o link https://support.google.com/googleplay/contact/cancel_sub_request e solicitar o cancelamento da assinatura.
    3. Quando um assinante que usou o Assine com o Google entrar em contato diretamente com você para cancelar uma assinatura, você deve avisar que ele precisa acessar o link https://support.google.com/googleplay/contact/cancel_sub_request para solicitar o cancelamento de um contrato comprado pelo Assine com o Google.