Search Analytics
Para ver uma lista de métodos desse recurso, consulte o final desta página.
Representações de recursos
Não há dados permanentes associados a este recurso.
Métodos
- query
Consulte seus dados de tráfego de pesquisa com filtros e parâmetros definidos por você. O método retorna zero ou mais linhas agrupadas pelas chaves de linha (dimensões) que você define. Você deve definir um período de um ou mais dias.
Quando a data é uma das dimensões, os dias sem dados são omitidos da lista de resultados. Para saber quais dias têm dados, faça uma consulta sem filtros agrupados por data no período de interesse.
Os resultados são classificados por contagem de cliques em ordem decrescente. Se duas linhas tiverem a mesma contagem de cliques, elas serão classificadas de maneira arbitrária.
Consulte o exemplo do Python para chamar este método.
A API é limitada por limitações internas do Search Console e não garante o retorno de todos
em linhas de dados,
mas sim as superiores.
Veja os limites da quantidade de dados disponíveis.
Exemplo de JSON POST:
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
"startDate": "2015-04-01",
"endDate": "2015-05-01",
"dimensions": ["country","device"]
}
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-08-29 UTC.
[null,null,["Última atualização 2024-08-29 UTC."],[[["The Search Analytics API allows you to query your website's search traffic data with custom filters and parameters, returning results grouped by specified dimensions."],["You can define date ranges for your queries, but the API might not return all data rows due to internal limitations, prioritizing top results instead."],["Results are sorted by click count in descending order, with arbitrary sorting for rows with identical click counts, and days without data are omitted from the result list."],["When querying with \"date\" as a dimension, you can identify days with data by performing a filter-less query grouped by date for the desired date range."],["The API offers a \"query\" method to retrieve search traffic data and provides a Python sample for utilizing this method."]]],["The core content details querying search traffic data using the `query` method. This method retrieves data rows grouped by defined dimensions, such as date, country, or device, within a specified date range. Results are sorted by click count in descending order. The API may not return all data rows and it's limited by Search Console's capabilities. It includes a JSON POST example for specifying start and end dates and dimensions. There is no persistent data.\n"]]
