# Menetapkan Tugas Langsung ‘Google Ads Search Volume’

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/keywords_data/google_ads/search_volume/live`

**Tags:** DataForSEO

Volum carian Google Ads untuk senarai `keywords`. Memulangkan `keyword`, `location_code`, `language_code`, `search_partners`, `competition`, `competition_index`, `search_volume`, `low_top_of_page_bid`, `high_top_of_page_bid`, `cpc` dan `monthly_searches`, serta `spell` apabila Google membetulkan istilah tersebut. Dibungkus dalam sampul DataForSEO: data dalam `tasks[0].result`, hasil dalam `tasks[0].status_code` - permintaan yang ditolak tetap memulangkan HTTP 200. Ini nombor volum carian klasik; untuk kekerapan orang bertanya kepada pembantu sebaliknya, gunakan `post_dataforseo_ai_keyword_volume_live`. Pasangan submit dan fetch endpoint ini melakukan kerja yang sama secara tak segerak, pada harga yang sama, untuk kelompok yang terlalu besar untuk ditunggu.

### Rujukan harga

- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.09.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

## Related links

- [Google Ads mungkin tidak memulangkan data untuk kumpulan kata kunci tertentu](<https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords>)
- [Google Ads memberikan nilai volum carian gabungan untuk kumpulan kata kunci yang serupa](<https://dataforseo.com/help-center/sv-broad-exact-phrase-match>)
- [artikel ini](<https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task>)
- [artikel Pusat Bantuan ini](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Google dan laman rakan kongsi](<https://support.google.com/google-ads/answer/1722047?hl=en>)
- [endpoint Status](<https://docs.dataforseo.com/v3/keywords_data/google_ads/status/>)
- [sekatan Google Ads](<https://support.google.com/adspolicy/answer/6008942?hl=en>)
- [ketahui lebih lanjut melalui pautan ini](<https://support.google.com/google-ads/answer/7476658>)
- [artikel Pusat Bantuan ini](<https://dataforseo.com/help-center/what-is-competition>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>kata kunci</em><br><strong>medan wajib</strong><br>Bilangan maksimum kata kunci yang boleh anda tentukan: 1000<br>Bilangan maksimum aksara bagi setiap kata kunci: 80<br>Bilangan maksimum perkataan bagi setiap frasa kata kunci: 10<br>kata kunci yang anda tentukan akan ditukar kepada format huruf kecil<br><strong>Nota #1:</strong> Google Ads mungkin tidak memulangkan data untuk kumpulan kata kunci tertentu;<br><strong>Nota #2:</strong> Google Ads memberikan nilai volum carian gabungan untuk kumpulan kata kunci yang serupa<br>untuk mendapatkan volum carian bagi kata kunci yang serupa, kami mengesyorkan menghantar kata kunci tersebut dalam permintaan berasingan;<br><strong>Nota #3:</strong> Google Ads tidak membenarkan penggunaan simbol dan aksara tertentu (contohnya: simbol UTF, emoji), jadi anda tidak boleh menggunakannya semasa menetapkan tugas;<br>untuk mengetahui lebih lanjut tentang simbol dan aksara yang boleh digunakan, sila rujuk artikel ini<p>ketahui lebih lanjut tentang peraturan dan had medan <code>keyword</code> dan <code>keywords</code> dalam API DataForSEO dalam artikel Pusat Bantuan ini"
          },
          "location_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nama penuh lokasi enjin carian</em><br>medan pilihan<br>jika anda tidak menentukan lokasi, anda akan menerima hasil seluruh dunia, iaitu untuk semua lokasi yang tersedia;<br><strong>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>location_code</code> atau <code>location_coordinate</code></strong><br>anda boleh menerima senarai lokasi enjin carian yang tersedia dengan <code>location_name</code>nya dengan membuat permintaan berasingan ke <code>https://api.dataforseo.com/v3/keywords_data/google_ads/locations</code><br>contoh:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>kod lokasi enjin carian</em><br>medan pilihan<br>jika anda tidak menentukan lokasi, anda akan menerima hasil seluruh dunia, iaitu untuk semua lokasi yang tersedia;<br><strong>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>location_name</code> atau <code>location_coordinate</code></strong>;<br>anda boleh menerima senarai lokasi enjin carian yang tersedia dengan <code>location_code</code>nya dengan membuat permintaan berasingan ke <code>https://api.dataforseo.com/v3/keywords_data/google_ads/locations</code><br>contoh:<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>koordinat GPS sesuatu lokasi</em><br>medan pilihan<br>jika anda tidak menentukan lokasi, anda akan menerima hasil seluruh dunia, iaitu untuk semua lokasi yang tersedia;<br><strong>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>location_name</code> atau <code>location_code</code></strong>;<br>parameter <code>location_coordinate</code> hendaklah ditentukan dalam format <em>\"latitude,longitude\"</em>;<br><strong>data akan diberikan untuk negara tempat koordinat yang ditentukan berada</strong>;<br>contoh:<br><code class=\"long-string\">52.6178549,-155.352142</code>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nama penuh bahasa enjin carian</em><br>medan pilihan<br>anda boleh menerima senarai bahasa enjin carian yang tersedia dengan <code>language_name</code>nya dengan membuat permintaan berasingan ke <code>https://api.dataforseo.com/v3/keywords_data/google_ads/languages</code><br>contoh:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>kod bahasa enjin carian</em><br>medan pilihan<br>anda boleh menerima senarai bahasa enjin carian yang tersedia dengan <code>language_code</code>nya dengan membuat permintaan berasingan ke <code>https://api.dataforseo.com/v3/keywords_data/google_ads/languages</code><br>contoh:<br><code class=\"long-string\">en</code>"
          },
          "search_partners": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>sertakan rakan kongsi carian Google</em><br>medan pilihan<br>jika anda menentukan <code class=\"prettyprint\">true</code>, hasil akan dihantar untuk rangkaian milik, dikendalikan dan sindikasi merentas Google dan laman rakan kongsi yang menghoskan carian Google;<br>nilai lalai: <code>false</code> - hasil dipulangkan untuk laman carian Google"
          },
          "date_from": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tarikh mula julat masa</em><br>medan pilihan<br>format tarikh: <code>\"yyyy-mm-dd\"</code><br>nilai minimum: 4 tahun daripada tarikh semasa<br>secara lalai, data dipulangkan untuk 12 bulan lepas;<br><strong>Nota</strong>: tarikh yang ditentukan tidak boleh lebih besar daripada tarikh dalam <code>date_to</code> dan/atau tarikh semalam;jika endpoint Status memulangkan <code>false</code> dalam medan <code>actual_data</code>, <code>date_from</code> boleh ditetapkan kepada bulan sebelum bulan lalu dan sebelumnya;<br>jika endpoint Status memulangkan <code>true</code> dalam medan <code>actual_data</code>, <code>date_from</code> boleh ditetapkan kepada bulan lalu dan sebelumnya"
          },
          "date_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tarikh tamat julat masa</em><br>medan pilihan<br><strong>Nota:</strong> tarikh yang ditentukan tidak boleh lebih besar daripada bulan lepas, Google Ads tidak memulangkan data bagi bulan semasa;<br>jika anda tidak menentukan medan ini, tarikh semalam akan digunakan secara lalai<br>format tarikh: <code>\"yyyy-mm-dd\"</code><br>contoh:<br><code>\"2022-11-30\"</code>"
          },
          "include_adult_keywords": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>sertakan kata kunci berkaitan kandungan dewasa<br></em>medan pilihan<br>jika ditetapkan kepada <code>true</code>, kata kunci dewasa akan disertakan dalam respons<br>nilai lalai: <code>false</code><br><strong>ambil perhatian</strong> bahawa API mungkin tidak memulangkan data untuk kata kunci tersebut kerana sekatan Google Ads"
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>parameter susunan hasil</em><br>medan pilihan<br>gunakan parameter ini untuk menyusun hasil mengikut <code>relevance</code>, <code>search_volume</code>, <code>competition_index</code>, <code>low_top_of_page_bid</code> atau <code>high_top_of_page_bid</code> dalam susunan menurun<br>nilai lalai: <code>relevance</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>pengecam tugas yang ditentukan pengguna</em><br>medan pilihan<br><em>had aksara ialah 255</em><br>anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil<br>anda akan menemui nilai <code>tag</code> yang ditentukan dalam array <code>data</code> respons"
          }
        },
        "example": [
          {
            "location_code": 2840,
            "keywords": [
              "buy laptop",
              "cheap laptops for sale",
              "purchase laptop"
            ],
            "date_from": "2021-08-01",
            "search_partners": true
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_code": 2840,
      "keywords": [
        "buy laptop",
        "cheap laptops for sale",
        "purchase laptop"
      ],
      "date_from": "2021-08-01",
      "search_partners": true
    }
  ]
}
```

## Responses

### 200 — Operasi berjaya

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo"
    }
  ]
}
```

### 400 — Permintaan tidak dapat diproses. Semak parameter permintaan.

### 401 — Kunci API Felo yang sah diperlukan.

### 402 — Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

### 403 — Akaun tidak dibenarkan melakukan operasi ini.

### 429 — Had permintaan atau had perbelanjaan telah dicapai.

### 502 — Perkhidmatan tidak dapat menyelesaikan permintaan.

### 503 — API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

### 504 — Perkhidmatan tamat masa semasa memproses permintaan.

### default — Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi semasa API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status umum; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "jumlah masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks yang dipulangkan dengan ralat",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Laluan URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo"
              }
            ]
          },
          "description": "<em>tatasusunan tugas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResultInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kata kunci<br></em><strong>kata kunci dipulangkan dengan %## yang dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)</strong>"
    },
    "spell": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>ejaan kata kunci yang betul</em><br><strong>Nota:</strong> jika kata kunci dalam array POST kelihatan salah eja, data akan dipulangkan untuk kata kunci yang dieja dengan betul;<br>kami menggunakan fungsi Google Ads API untuk menyemak dan mengesahkan ejaan kata kunci, ketahui lebih lanjut melalui pautan ini"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kod lokasi dalam array POST</em><br>jika tiada data, nilainya ialah_<code>null</code>n"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kod bahasa dalam array POST</em><br>jika tiada data, nilainya ialah_<code>null</code>n"
    },
    "search_partners": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>menunjukkan sama ada data daripada rangkaian rakan disertakan dalam respons</em>"
    },
    "competition": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>persaingan</em><br>mewakili jumlah persaingan relatif yang berkaitan dengan kata kunci tertentu dalam SERP berbayar sahaja;<br>nilai ini berdasarkan data Google Ads dan boleh mengambil nilai berikut: <code>HIGH</code>, <code>MEDIUM</code>, <code>LOW</code>;<br>jika tiada data nilainya ialah <code>null</code>;<br>pelajari lebih lanjut tentang metrik ini dalam artikel Pusat Bantuan ini"
    },
    "competition_index": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>persaingan</em><br>mewakili jumlah persaingan relatif yang berkaitan dengan kata kunci tertentu dalam SERP berbayar sahaja;<br>nilai ini berdasarkan data Google Ads dan boleh berada antara 0 dan 100 (termasuk kedua-dua hujung);<br>jika tiada data nilainya ialah <code>null</code>;<br>pelajari lebih lanjut tentang metrik ini dalam artikel Pusat Bantuan ini"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kadar purata volum carian bulanan;<br></em>mewakili sama ada anggaran bilangan carian bagi idea kata kunci tertentu di google.com atau google.com dan rakan, bergantung pada penyasaran pengguna;<br>jika tiada data maka nilainya ialah <code>null</code>",
      "format": "int64"
    },
    "low_top_of_page_bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>bidaan minimum untuk iklan dipaparkan di bahagian atas halaman pertama</em><br>menunjukkan nilai yang lebih besar daripada kira-kira 20% bidaan terendah yang menyebabkan iklan dipaparkan (berdasarkan statistik Google Ads untuk pengiklan);<br>nilai mungkin berbeza bergantung pada lokasi yang ditentukan dalam permintaan POST"
    },
    "high_top_of_page_bid": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>bidaan maksimum untuk iklan dipaparkan di bahagian atas halaman pertama</em><br>menunjukkan nilai yang lebih besar daripada kira-kira 80% bidaan terendah yang menyebabkan iklan dipaparkan (berdasarkan statistik Google Ads untuk pengiklan);<br>nilai mungkin berbeza bergantung pada lokasi yang ditentukan dalam permintaan POST"
    },
    "cpc": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>kos setiap klik</em><br>menunjukkan amaun yang dibayar (USD) untuk setiap klik pada iklan yang dipaparkan bagi kata kunci tertentu"
    },
    "monthly_searches": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo"
          }
        ]
      },
      "description": "<em>carian bulanan</em><br>mewakili anggaran bilangan carian bagi idea kata kunci ini (secara lalai untuk dua belas bulan lalu), disasarkan kepada lokasi geografi yang ditentukan;<br>jika tiada data maka nilainya ialah <code>null</code>"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResultInfo"
              }
            ]
          },
          "description": "<em>tatasusunan hasil</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_MonthlySearchesInfo

`#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo`

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tahun"
    },
    "month": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bulan"
    },
    "search_volume": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kadar purata volum carian bulanan"
    }
  }
}
```
