{"id":40520,"date":"2023-03-31T10:36:00","date_gmt":"2023-03-31T13:36:00","guid":{"rendered":"https:\/\/blog.locaweb.com.br\/?p=40520"},"modified":"2024-09-05T13:50:50","modified_gmt":"2024-09-05T16:50:50","slug":"como-usar-a-api-google-play-developer","status":"publish","type":"post","link":"https:\/\/www.locaweb.com.br\/blog\/temas\/codigo-aberto\/como-usar-a-api-google-play-developer\/","title":{"rendered":"Como usar a API Google Play Developer?"},"content":{"rendered":"\n

Automatize tarefas feitas pelo Google Play Console usando as funcionalidades dessas APIs<\/em><\/p>\n\n\n\n

A Google Play Developer APIs \u00e9 um conjunto de ferramentas essencial para qualquer pessoa programadora que trabalhe com desenvolvimento de aplicativos<\/a> para Android. Se voc\u00ea gerencia projetos pelo Google Play Console, vai descobrir que usar<\/strong> essas APIs \u00e9 bastante simples e pode oferecer uma s\u00e9rie de benef\u00edcios<\/strong>.<\/p>\n\n\n\n

A API do Google Play Developer tem dois componentes principais:<\/p>\n\n\n\n

Subscriptions and In-App Purchases API<\/h2>\n\n\n\n

Com ela, \u00e9 poss\u00edvel criar e gerenciar produtos para compras dentro do aplicativo, recuperar informa\u00e7\u00f5es de compra e gerenciar assinaturas.<\/p>\n\n\n\n

Publishing API<\/h2>\n\n\n\n

Com essa API<\/a>, as pessoas desenvolvedoras podem realizar v\u00e1rias tarefas, como criar um novo aplicativo, atualizar informa\u00e7\u00f5es de um aplicativo j\u00e1 existente<\/strong> (como o nome, descri\u00e7\u00e3o e \u00edcone) e gerenciar vers\u00f5es do app<\/strong>.<\/p>\n\n\n\n

Uma das vantagens de usar essas APIs \u00e9 a possibilidade de automatizar algumas tarefas que antes eram feitas manualmente na plataforma. Veja a seguir como voc\u00ea pode come\u00e7ar a aproveitar essas vantagens. <\/p>\n\n\n\n

Como come\u00e7ar a usar a API?<\/strong><\/h2>\n\n\n
\n
\"Mulher
API automatiza processos e facilita consulta a informa\u00e7\u00f5es de desempenho do app. (Fonte: Getty Images\/Reprodu\u00e7\u00e3o)<\/figcaption><\/figure>\n<\/div>\n\n\n

A API do Google Play Developer<\/strong> permite acessar e gerenciar os recursos do Google Play Console, como aplicativos, produtos no aplicativo e assinaturas. Para come\u00e7ar a us\u00e1-la, voc\u00ea precisar\u00e1 seguir os seguintes passos:<\/p>\n\n\n\n

Criar um projeto no Console de APIs do Google<\/h2>\n\n\n\n

A primeira coisa a fazer \u00e9 criar um projeto no Console do Google e habilitar a API do Google Play Developer para esse projeto. Isso \u00e9 necess\u00e1rio para que voc\u00ea possa criar credenciais de autentica\u00e7\u00e3o e acessar a API<\/a>. Para fazer isso, siga os passos abaixo:<\/p>\n\n\n\n

    \n
  1. Acesse o Console de APIs do Google: https:\/\/console.developers.google.com\/<\/li>\n\n\n\n
  2. Selecione ou crie um projeto no canto superior esquerdo da p\u00e1gina.<\/li>\n<\/ol>\n\n\n\n
    \"tela<\/figure>\n\n\n\n
      \n
    1. Na p\u00e1gina do projeto, clique em “Ativar APIs e servi\u00e7os”.<\/li>\n<\/ol>\n\n\n\n
      \"tela<\/figure>\n\n\n\n
        \n
      1. Na barra de pesquisa, digite “Google Play Android Developer API” e selecione a op\u00e7\u00e3o que aparecer.<\/li>\n<\/ol>\n\n\n\n
        \"tela<\/figure>\n\n\n\n
          \n
        1. Clique em “Ativar” para habilitar a API para o seu projeto.<\/li>\n<\/ol>\n\n\n
          \n
          \"tela<\/figure>\n<\/div>\n\n\n

          Ao clicar em \u201cAtivar\u201d voc\u00ea ser\u00e1 redirecionado para p\u00e1gina com detalhes sobre a API onde ter\u00e1 acesso \u00e0s m\u00e9tricas de consumo dela, \u00e0s cotas e \u00e0s suas credenciais. Um aviso no topo da tela vai indicar que voc\u00ea precisa criar essas credenciais para poder usar a API. <\/p>\n\n\n\n

          Criar credenciais de autentica\u00e7\u00e3o<\/h3>\n\n\n\n

          Para criar as credenciais de autentica\u00e7\u00e3o para acessar a API do Google Play Developer, siga os seguintes passos:<\/p>\n\n\n\n

            \n
          1. Clique no bot\u00e3o “Criar credenciais”.<\/li>\n<\/ol>\n\n\n
            \n
            \"tela<\/figure>\n<\/div>\n\n\n
              \n
            1. Escolha o tipo de dados voc\u00ea acessar\u00e1:<\/li>\n<\/ol>\n\n\n
              \n
              \"tela<\/figure>\n<\/div>\n\n\n

              Dados do usu\u00e1rio:<\/strong> isso significa que a sua aplica\u00e7\u00e3o ser\u00e1 autorizada a acessar as informa\u00e7\u00f5es de um usu\u00e1rio ap\u00f3s ele conceder o consentimento para a sua aplica\u00e7\u00e3o. Esse tipo de credencial \u00e9 \u00fatil para aplicativos que necessitam de acesso a dados de usu\u00e1rios, como um aplicativo que utiliza a API do Google Play Developer para enviar notifica\u00e7\u00f5es personalizadas.<\/p>\n\n\n\n

              Dados do aplicativo:<\/strong> se voc\u00ea precisa acessar informa\u00e7\u00f5es do seu pr\u00f3prio aplicativo, \u00e9 necess\u00e1rio criar uma conta de servi\u00e7o. Essa conta de servi\u00e7o \u00e9 uma identidade de autentica\u00e7\u00e3o que representa o seu aplicativo. Esse tipo de credencial \u00e9 \u00fatil quando voc\u00ea quer ter acesso a informa\u00e7\u00f5es do pr\u00f3prio aplicativo, como por exemplo, para obter informa\u00e7\u00f5es sobre o desempenho do aplicativo.<\/p>\n\n\n\n

              Para usar a API do Google Play Developer, o mais indicado \u00e9 criar uma credencial selecionando \u201cDados do aplicativo\u201d no item anterior, j\u00e1 que a API oferece relat\u00f3rios e m\u00e9tricas sobre o pr\u00f3prio app. <\/p>\n\n\n\n

              Instalar a biblioteca do Google no seu projeto<\/h3>\n\n\n\n

              Para facilitar o acesso \u00e0 API do Google Play Developer, o Google fornece bibliotecas de cliente em v\u00e1rias linguagens de programa\u00e7\u00e3o, incluindo Java, Python, Ruby, Node.js<\/em> e outras. Voc\u00ea pode escolher a biblioteca de cliente que melhor se adapta \u00e0s suas necessidades e seguir as instru\u00e7\u00f5es de instala\u00e7\u00e3o e configura\u00e7\u00e3o para come\u00e7ar a usar a API.<\/p>\n\n\n\n

              Por exemplo, digamos que seu projeto est\u00e1 em Node.js e voc\u00ea quer buscar pela API um relat\u00f3rio das \u00faltimas assinaturas que o seu app recebeu. O passo a passo seria esse:<\/p>\n\n\n\n

                \n
              1. Para utilizar a API do Google Play Developer com Node.js, primeiro \u00e9 preciso instalar a biblioteca de cliente googleapis via NPM (Node Package Manager). Para isso, basta executar o seguinte comando no terminal:<\/li>\n<\/ol>\n\n\n\n

                npm install googleapis<\/p>\n\n\n\n

                  \n
                1. Baixe o arquivo JSON das credenciais da conta de servi\u00e7o. Para fazer isso, basta acessar a aba \u201cCredenciais\u201d na p\u00e1gina de detalhes da API:<\/li>\n<\/ol>\n\n\n
                  \n
                  \"tela<\/figure>\n<\/div>\n\n\n

                  Depois disso, clique na conta de servi\u00e7o para a qual voc\u00ea quer gerar o JSON e selecione a aba \u201cChaves\u201d.<\/p>\n\n\n

                  \n
                  \"tela<\/figure>\n<\/div>\n\n\n

                  Ent\u00e3o, clique em \u201cAdicionar chave\u201d, \u201cCriar nova chave\u201d e selecione a opc\u00e3o JSON. O arquivo nesse formato com as credenciais da conta de servi\u00e7o ser\u00e1 baixado automaticamente para o seu computador. Certifique-se de guardar o arquivo JSON em um local seguro, pois ele cont\u00e9m informa\u00e7\u00f5es sens\u00edveis que permitem acesso \u00e0 API do Google Play Developer em nome da sua conta de servi\u00e7o.<\/p>\n\n\n\n

                    \n
                  1. Adicione o arquivo JSON de credenciais da conta de servi\u00e7o \u00e0 raiz do seu projeto.<\/li>\n\n\n\n
                  2. No seu c\u00f3digo, crie um novo cliente OAuth2 usando as credenciais da conta de servi\u00e7o:<\/li>\n<\/ol>\n\n\n\n

                    const { google } = require(‘googleapis’);<\/p>\n\n\n\n

                    const auth = new google.auth.GoogleAuth({<\/p>\n\n\n\n

                      keyFile: ‘.\/path\/to\/service-account-credentials.json’,<\/p>\n\n\n\n

                      scopes: [‘https:\/\/www.googleapis.com\/auth\/androidpublisher’]<\/p>\n\n\n\n

                    });<\/p>\n\n\n\n

                      \n
                    1. Use o cliente OAuth2 para criar um objeto da API do Google Play Developer:<\/li>\n<\/ol>\n\n\n\n

                      const androidpublisher = google.androidpublisher({<\/p>\n\n\n\n

                        version: ‘v3’,<\/p>\n\n\n\n

                        auth: auth<\/p>\n\n\n\n

                      });<\/p>\n\n\n\n

                        \n
                      1. Agora voc\u00ea pode enviar solicita\u00e7\u00f5es HTTP para acessar os recursos da API do Google Play Developer. Por exemplo, para buscar as \u00faltimas assinaturas do seu aplicativo, voc\u00ea pode usar o seguinte c\u00f3digo:<\/li>\n<\/ol>\n\n\n\n

                        const packageName = ‘com.example.app’;<\/p>\n\n\n\n

                        const response = await androidpublisher.purchases.subscriptions.list({<\/p>\n\n\n\n

                          packageName: packageName,<\/p>\n\n\n\n

                          maxResults: 10,<\/p>\n\n\n\n

                          token: undefined,<\/p>\n\n\n\n

                          startTime: undefined,<\/p>\n\n\n\n

                          endTime: undefined<\/p>\n\n\n\n

                        });<\/p>\n\n\n\n

                        const subscriptions = response.data.subscriptions;<\/p>\n\n\n\n

                        Este c\u00f3digo lista as 10 \u00faltimas assinaturas do aplicativo com o nome “com.example.app”. Observe que este exemplo usa a autentica\u00e7\u00e3o com conta de servi\u00e7o, que \u00e9 mais adequada para acessar dados do pr\u00f3prio aplicativo. Para acessar dados de usu\u00e1rios individuais, \u00e9 necess\u00e1rio usar a autentica\u00e7\u00e3o com OAuth2. Al\u00e9m disso, no c\u00f3digo acima, algumas propriedades do objeto s\u00e3o definidas como undefined, como o token, startTime e endTime. Isso ocorre porque essas propriedades s\u00e3o opcionais e podem ser deixadas em branco se n\u00e3o forem necess\u00e1rias para a solicita\u00e7\u00e3o.<\/p>\n\n\n\n

                        Leia tamb\u00e9m<\/strong>:<\/h3>\n\n\n\n