> ## 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.

# Google AIによる概要 API: 概要テキスト、出典、SERP

> Googleで検索し、AIによる概要を出典、商品、引用チップとともに、周囲の検索結果ページと一緒に受け取ります。

`GOOGLE` は google.com で検索し、AIによる概要を、それが表示された検索結果ページと一緒に返します。

| | |
| - | - |
| taskType | `GOOGLE` |
| エイリアス | `GOOGLE_AIO` |
| 読むフィールド | `query`(なければ `prompt`) |
| クレジット | 1.25 |
| 国 | 任意、既定は `US`。`CN` は北京の端末から Google の米国市場に質問します。 |
| 位置情報 | `payload.location` を受け付けます。[地域と位置情報](/ja/engines/capacity.md)を参照してください。 |

## リクエスト

```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" } }'
```

## レスポンス

レスポンスは検索結果エンベロープで、AIによる概要はnullableメンバーの1つ `aioverview` として入ります。

> [!WARNING]
>
> `aioverview: null` は、そのクエリで **Google がAIによる概要を表示しなかった**ことを意味します。エラーではありません。タスクは完了し、周囲の結果フィールドはそのまま設定されます。

| フィールド | 型 | 説明 |
| - | - | - |
| `aioverview` | object または `null` | AIによる概要。フィールドは下記のとおりです。 |
| `organicResults` | array | 自然検索結果。 |
| `peopleAlsoAsk` | array | 「他の人はこちらも質問」パネル。 |
| `relatedSearches` | array | 関連検索。 |
| `knowledgeGraph` | object | ナレッジパネル。 |
| `ads` | array | 上部と下部の広告。 |
| `map` | array | ローカルパック: `name`、`position`、`placeId`、`location`、`mapsUrl`、`reviews`、`category`、`price`、`snippet`、`image`。 |
| `serp` | object | その他のパネル: `topStories`、`videoResults`、`localMap`、`discussionsAndForums`。 |
| `rawContent` | string | レンダリングされた結果ページのHTML。`include.rawResponse` のときのみ。 |
| `text`、`sources` | | `aioverview.text` と `aioverview.sources` の非推奨のコピー。新しいコードでは `aioverview.*` を読んでください。 |

結果パネルはページにない場合、`null` や `[]` ではなく**省略**されます。すべて任意のフィールドとして扱ってください。

### `aioverview`

| フィールド | 型 | 説明 |
| - | - | - |
| `text` | string | 概要のテキスト。商品カードのタイトルも含まれます。 |
| `sources` | array | `position`、`url`、`label`、`description`。 |
| `markdown` | string | Markdownの概要。`include.markdown` または `include.aioverview.markdown` のときのみ。 |
| `shoppingCards` | array | 回答の横に表示される商品タイル: `title`、`position`、`price`、`oldPrice`、`store`、`rating`、`reviews`、`thumbnail`、`productLink`。 |
| `inlineProducts` | array | 回答内でリンクされた商品名: `title`、`position`、`productLink`。 |
| `citationPills` | array | 各引用チップの裏にある出典を、出典1件につき1項目で。 |
| `videos` | array | 概要に表示された動画: `title`、`link`、`platform`、`channel`、`duration`。 |
| `sponsored` | array | 概要内のスポンサー項目: `label`、`title`、`advertiser`。 |

商品、チップ、動画、スポンサーのフィールドは、概要にそれらが表示されたときだけ含まれます。`price.currency` は表示どおりの記号(`$`、`€`)、`reviews` は Google の省略表記(`2.3K`)のまま、`productLink` は Google の商品ページです。

`citationPills` では、同じチップの出典が回答順に振られた `citationPillId` を共有し、`position` は対応する `aioverview.sources` の項目を指します。チップだけが引用するページも、概要が示す出典の後ろに `aioverview.sources` の項目として入ります。Google がタイトルを表示しない場合、その `label` は空文字列です。各項目には `label`、`url`、`domain` と、Google が表示する場合は `site`、`description`、`thumbnail` が入ります。レスポンスに `markdown` がある場合、`markdownOffset` はその中でのチップの位置を示します。`sponsored` の項目にも同じように `labelOffset`、`markdownOffset`、`noteOffset` が付きます。

例:

```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" }]
}
```

## includeフラグ

| フラグ | 効果 |
| - | - |
| `markdown` | `aioverview.markdown` を追加します。`include.aioverview.markdown` も同じです。 |
| `rawResponse` | レンダリングされた結果ページ `rawContent` を追加します。 |
| `html` | 結果ページを共有できるファイルとして `html` に追加します。[HTMLページ](/ja/engines/html-pages.md)を参照してください。 |
| `analysis` | `analysis` を追加します。1クレジット。[回答の分析](/ja/engines/answer-analysis.md)を参照してください。 |
| `citationAnalysis` | 概要に対して[Citation Analysis](/ja/research/citation-analysis.md)を実行します。 |

`searchQueries`、`ads`、`shopping` は効果がありません。[Markdownと生のレスポンス](/ja/engines/response-options.md)を参照してください。概要なしの自然検索結果を、より速く1クレジットで取得するには[Google検索](/ja/engines/google-serp.md)を使ってください。

## 中国

Google は中国市場にAIによる概要を表示しません。そのため `CN` タスクは、中国本土の人々が Google にアクセスするのと同じように、北京にある端末から Google の米国市場(`gl=us`)に質問します。独自の `payload.location` を指定したタスクは、その位置情報を使います。

## 関連ページ

* [Google AIによる概要製品ページ](https://querying.ai/ja/engines/google-ai-overviews)
* [Google AIモード](/ja/engines/google-ai-mode.md)
* [エンジンの概要](/ja/engines/overview.md)


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