> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API do Google AI Overviews: texto da visão geral, fontes e SERP

> Busque no Google e receba o AI Overview com suas fontes, produtos e chips de citação, mais a página de resultados ao redor.

`GOOGLE` busca no google.com e retorna o AI Overview junto com a página de resultados de busca em que ele aparece.

| | |
| - | - |
| taskType | `GOOGLE` |
| Aliases | `GOOGLE_AIO` |
| Lê | `query` (recorre a `prompt`) |
| Créditos | 1,25 |
| País | Opcional, padrão `US`. `CN` consulta o mercado dos EUA do Google a partir de um dispositivo em Pequim. |
| Localização | Aceita `payload.location`. Veja [Regiões e localização](/pt/engines/capacity.md). |

## Requisição

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US" } }'
```

## Resposta

A resposta é um envelope de resultados de busca que traz o AI Overview como um membro anulável, `aioverview`.

> [!WARNING]
>
> `aioverview: null` significa que **o Google não exibiu um AI Overview** para a consulta. Não é erro: a tarefa é concluída, e os campos de resultados ao redor continuam preenchidos.

| Campo | Tipo | Descrição |
| - | - | - |
| `aioverview` | object ou `null` | O AI Overview. Campos abaixo. |
| `organicResults` | array | Resultados orgânicos. |
| `peopleAlsoAsk` | array | O painel "As pessoas também perguntam". |
| `relatedSearches` | array | Buscas relacionadas. |
| `knowledgeGraph` | object | O painel de conhecimento. |
| `ads` | array | Anúncios do topo e do rodapé. |
| `map` | array | O pacote local: `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews`, `category`, `price`, `snippet`, `image`. |
| `serp` | object | Outros painéis: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`. |
| `rawContent` | string | O HTML renderizado da página de resultados. Só com `include.rawResponse`. |
| `text`, `sources` | | Cópias obsoletas de `aioverview.text` e `aioverview.sources`. Em código novo, leia `aioverview.*`. |

Os painéis de resultados são **omitidos** quando a página não os tem, nunca enviados como `null` ou `[]`. Trate cada um como opcional.

### `aioverview`

| Campo | Tipo | Descrição |
| - | - | - |
| `text` | string | O texto da visão geral. Os títulos dos cartões de produto ficam nele. |
| `sources` | array | `position`, `url`, `label` e `description`. |
| `markdown` | string | A visão geral em Markdown. Só com `include.markdown` ou `include.aioverview.markdown`. |
| `shoppingCards` | array | Blocos de produto ao lado da resposta: `title`, `position`, `price`, `oldPrice`, `store`, `rating`, `reviews`, `thumbnail`, `productLink`. |
| `inlineProducts` | array | Nomes de produto com link na resposta: `title`, `position`, `productLink`. |
| `citationPills` | array | Uma entrada por fonte por trás de cada chip de citação. |
| `videos` | array | Vídeos que a visão geral mostra: `title`, `link`, `platform`, `channel`, `duration`. |
| `sponsored` | array | Itens patrocinados dentro da visão geral: `label`, `title`, `advertiser`. |

Os campos de produto, chip, vídeo e patrocínio só aparecem quando a visão geral os mostra. `price.currency` é o símbolo como exibido (`$`, `€`), `reviews` mantém a abreviação do Google (`2.3K`) e `productLink` é a página de produto do Google.

Em `citationPills`, as fontes do mesmo chip compartilham um `citationPillId`, numerado na ordem da resposta, e `position` aponta para a entrada correspondente de `aioverview.sources`. Uma página citada só por um chip também está em `aioverview.sources`, depois das páginas que a visão geral lista, e seu `label` fica vazio quando o Google não mostra um título. Cada entrada tem `label`, `url`, `domain` e, quando o Google os mostra, `site`, `description` e `thumbnail`. Quando a resposta traz `markdown`, `markdownOffset` indica o lugar do chip nele; as entradas de `sponsored` trazem `labelOffset`, `markdownOffset` e `noteOffset` do mesmo jeito.

Por exemplo:

```json theme={"theme":"css-variables"}
{
  "aioverview": {
    "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
    "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }],
    "citationPills": [
      { "label": "CRM guide for small teams", "citationPillId": 1, "url": "https://www.example.com/crm-guide", "domain": "example.com", "position": 1 }
    ]
  },
  "organicResults": [
    { "position": 1, "title": "The best CRM for small teams", "link": "https://www.example.com/crm-guide", "snippet": "..." }
  ],
  "relatedSearches": [{ "query": "free crm for small team" }],
  "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }]
}
```

## Flags include

| Flag | Efeito |
| - | - |
| `markdown` | Adiciona `aioverview.markdown`. `include.aioverview.markdown` faz o mesmo. |
| `rawResponse` | Adiciona `rawContent`, a página de resultados renderizada. |
| `html` | Adiciona `html`, a página de resultados como um arquivo compartilhável. Veja [Páginas HTML](/pt/engines/html-pages.md). |
| `analysis` | Adiciona `analysis`, 1 crédito. Veja [Análise da resposta](/pt/engines/answer-analysis.md). |
| `citationAnalysis` | Executa uma [Citation Analysis](/pt/research/citation-analysis.md) sobre a visão geral. |

`searchQueries`, `ads` e `shopping` não têm efeito. Veja [Markdown e respostas brutas](/pt/engines/response-options.md). Para resultados orgânicos sem a visão geral, mais rápido e por 1 crédito, use o [Google Search](/pt/engines/google-serp.md).

## China

O Google não mostra AI Overview no mercado da China. Por isso, uma tarefa `CN` consulta o mercado dos EUA do Google (`gl=us`) a partir de um dispositivo localizado em Pequim, como as pessoas na China continental acessam o Google. Uma tarefa com sua própria `payload.location` usa essa localização.

## Relacionados

* [Página do produto Google AI Overviews](https://querying.ai/pt/engines/google-ai-overviews)
* [Google AI Mode](/pt/engines/google-ai-mode.md)
* [Visão geral dos mecanismos](/pt/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.