Como consultar a API do Google Search Console

Como consultar a API do Google Search Console
cupom com desconto - o melhor site de cupom de desconto cupomcomdesconto.com.br


Se você é um SEO há pouco tempo, provavelmente conhece o Google Search Console (GSC). É uma ferramenta valiosa para obter informações sobre seu website e seu desempenho na pesquisa orgânica. Dito isto, ele tem suas limitações.

Neste artigo, você aprenderá como obter dados mais bem conectados do Google Search Console, além de aumentar o tamanho das suas exportações em 400%.

Limitações do Google Search Console

Embora o GSC tenha várias seções, focaremos no relatório “Desempenho”. No painel do GSC, há duas maneiras de acessar este relatório:

Como consultar a API do Google Search Console 1

Uma vez dentro do relatório “Desempenho”, os dados para consultas e páginas podem ser acessados:

Como consultar a API do Google Search Console 2

Isso revela um dos problemas do GSC: os dados da consulta e da página são separados.

Em outras palavras, se eu quiser ver as consultas para as quais uma página específica está classificada, primeiro clique em “Páginas”, selecione a página e clique em “voltar” para “Consultas”. É uma experiência muito complicada.

O outro problema (em duas partes) é com a exportação:

  • Os dados de desempenho para consultas e páginas devem ser exportados separadamente.
  • As exportações são limitadas a 1.000 linhas.

Procuraremos resolver esses problemas utilizando a API do GSC.

O que é a API do Google Search Console?

Agora sabemos que a interface do usuário do GSC tem limitações: conectar dados de consulta com dados da página é complicado e as exportações são limitadas.

Se a interface do usuário do GSC representa o padrão de fábrica, a API do GSC representa nossas configurações personalizadas. É preciso um pouco mais de esforço, mas nos dá mais controle e abre mais possibilidades (pelo menos no campo de consulta e dados da página).

A API GSC é uma maneira de nos conectarmos aos dados em nossa conta, fazer solicitações mais personalizadas e obter uma saída mais personalizada. Podemos até ignorar essas configurações padrão de fábrica, como exportações limitadas a 1.000 linhas, por exemplo.

Leia Também  Social Media Content Types & Ideas

Por que usar isso?

Lembra como eu disse anteriormente que os dados da consulta e da página são separados na interface do usuário do GSC “vanilla”? Bem, com a API, podemos conectar os dados da consulta com a página que a consulta classifica, para que você não precise mais clicar e esperar o carregamento das coisas.

Além disso, vimos que as exportações são limitadas a 1.000 linhas. Com a API, podemos solicitar até 5.000 linhas, um aumento de 400%!

Então, vamos nos conectar, fazer nossa solicitação e recuperar um conjunto de dados mais robusto e significativo.

Configuração

Faça login na conta GSC apropriada nesta página (canto superior direito). Por exemplo, se meu site for example.com e eu puder ver a conta do Search Console em [email protected], essa é a conta na qual vou fazer login.

Digite o URL da conta GSC apropriada:

Como consultar a API do Google Search Console 3

Configure sua solicitação:

  1. Defina startDate. Isso deve ser formatado como: AAAA-MM-DD.
  2. Defina endDate.
  3. Defina as dimensões. Uma dimensão pode ser:
      • inquerir
      • página
      • dispositivo
      • e / ou país
  4. Defina os filtros (opcional). Um filtro deve incluir:
      • dimensão (uma dimensão pode ser: consulta, página, dispositivo ou país)
      • operador (um operador pode ser: contains, notContains, equals, notEquals)
      • expressão (uma expressão pode ser qualquer valor associado às dimensões)
    1. Defina o rowLimit. Com a API do GSC, você pode solicitar até 5.000!
    2. A página compartilhada na etapa um facilita toda essa configuração, mas pode ser entediante e até confusa para alguns. Fiz toda a confusão para você e criei o JSON que você pode editar de forma rápida e fácil para obter o retorno da API que você deseja.

      Pedido não filtrado

      A solicitação a seguir não será filtrada. Definiremos nossas datas, dimensões e um limite de linhas preferenciais e, em seguida, faremos nossa solicitação.

      A ordem em que você coloca suas dimensões é a ordem em que elas serão devolvidas.

      A API retornará dados separados para computadores, dispositivos móveis e tablets. Os números que você vê na interface do usuário do GSC – cliques, por exemplo – são um agregado dos três (a menos que você aplique a filtragem do dispositivo).

      cupom com desconto - o melhor site de cupom de desconto cupomcomdesconto.com.br

      Lembre-se de que suas dimensões também podem incluir “país”, se você desejar.

      {

      “startDate”: “01/11/2019”,

      “endDate”: “2020-01-31”,

      “dimensões”:

      [[

      “inquerir”,

      “página”,

      “dispositivo”

      ],

      “rowLimit”: 3000

      }

      Pedido filtrado

      Esta versão da nossa solicitação incluirá filtros para ser mais específico sobre o que é retornado.

      Os filtros são indicados como dimensão / operador / expressão. Aqui estão alguns exemplos para mostrar o que é possível:

      • consulta contém ir pescar digital
      • a página é igual a https://gofishdigital.com/
      • dispositivo não contém tablet

      Parece que você só pode aplicar um filtro por dimensão, assim como na interface de usuário normal do GSC, mas se você souber de forma diferente, informe-nos nos comentários!

      {

      “startDate”: “01/11/2019”,

      “endDate”: “2020-01-31”,

      “dimensões”:

      [[

      “inquerir”,

      “página”,

      “dispositivo”

      ],

      “dimensionFilterGroups”:

      [[

      {

      “filtros”:

      [[

      {

      “dimension”: “device”,

      “operator”: “notContains”,

      “expression”: “tablet”

      }

      ]

      }

      ],

      “rowLimit”: 3000

      }

      Escolha um modelo, não filtrado ou filtrado, e preencha seus valores personalizados (qualquer coisa após dois pontos deve ser atualizada como seu próprio valor, a menos que você goste das minhas predefinições).

      Execute a solicitação

      Então aí está! Dois modelos de solicitação para você escolher e editar ao seu gosto. Agora é hora de fazer a solicitação. Clique no “Corpo da solicitação”, selecione tudo e cole no seu JSON personalizado:

      Como consultar a API do Google Search Console 4

      É aqui que você pode configurar manualmente suas chaves e valores de solicitação, mas, como afirmei anteriormente, isso pode ser entediante e um pouco confuso, por isso fiz esse trabalho para você.

      Role para baixo e clique em “Executar”. Você também pode ser solicitado a entrar aqui.

      Se tudo foi inserido corretamente e a solicitação pôde ser atendida, a API retornará seus dados. Se você receber um erro, audite sua solicitação primeiro e, em seguida, quaisquer outras etapas e entradas, se necessário.

      Clique na caixa no canto inferior direito (esta é a resposta da API), selecione tudo e copie as informações.

      Como consultar a API do Google Search Console 5

      Converter de JSON em CSV

      O Excel ou o Planilhas será uma maneira muito melhor de trabalhar com os dados, então vamos converter nossa saída JSON para CSV.

      Use um conversor como este e cole na sua saída JSON. Agora você pode exportar um CSV. Atualize os cabeçalhos das colunas conforme desejado.

      Consultar seus próprios dados

      A maioria dos SEOs é bastante confortável no Excel, então agora você pode consultar a saída de sua solicitação da maneira que desejar.

      Uma das tarefas mais comuns executadas é procurar dados associados a um conjunto específico de páginas. Isso é feito adicionando uma planilha ao seu conjunto de páginas e usando o VLOOKUP para indicar uma correspondência.

      A saída da API em uma planilha também permite as ações mais comuns no Excel, como classificação, filtragem e criação de gráficos.

      Aproveite ao máximo o Google Search Console

      O GSC oferece dados importantes para SEOs, e a saída da API do GSC oferece não apenas mais desses dados, mas em um formato que é muito menos complicado e mais coeso.

      Hoje, superamos dois obstáculos que frequentemente enfrentamos na interface do usuário padrão do GSC: a conexão de consulta / página e as exportações limitadas. Minha esperança é que a utilização da API do Google Search Console leve suas análises e ideias para o próximo nível.

      Embora meus modelos JSON abranjam os cenários mais comuns em termos do que você está interessado em solicitar, o Google oferece documentação que cobre um pouco mais de terreno, se você estiver interessado.

      Você tem outra maneira de usar a API do GSC? Existe outra API que você costuma usar como SEO? Deixe-me saber nos comentários!

cupom com desconto - o melhor site de cupom de desconto cupomcomdesconto.com.br

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *