Пошук по таблицях

This page is also available in English.

Огляд

Усі ендпоінти таблиць даних Google Ads тепер підтримують опціональний query параметр search. Коли він вказаний, API фільтрує результати на сервері, використовуючи регістронезалежний пошук по підрядку по визначених текстових полях кожної таблиці. Це розроблено для рядка пошуку в кожній таблиці даних на фронтенді.

Як використовувати

Додайте ?search=<term> до будь-якого GET ендпоінта таблиці даних:

GET /api/v1/google-ads/{customer_id}/campaigns?search=brand
GET /api/v1/google-ads/{customer_id}/ad-groups?search=shoes
GET /api/v1/google-ads/{customer_id}/keywords?search=buy+shoes

Той самий параметр працює для CSV ендпоінтів:

GET /api/v1/google-ads/{customer_id}/campaigns/csv?search=brand

Правила параметра

Властивість	Значення
Назва	`search`
Тип	`string` (опціональний)
Мін. довжина	1
Макс. довжина	200
За замовчуванням	`None` (без фільтрації)

Якщо search не вказано (або передано порожнє значення), повертається повний набір даних — повна зворотна сумісність.

Поведінка пошуку

Регістронезалежний: "brand" знайде "Brand Campaign", "BRAND" тощо
Пошук по підрядку: "shoe" знайде "buy shoes online"
OR логіка між полями: рядок збігається, якщо будь-яке з його полів для пошуку містить пошуковий термін
Фільтрація після отримання даних: пошук застосовується після отримання даних з Google Ads, тому працює по всіх полях, включаючи розгорнуті назви та заголовки RSA

Поля для пошуку по таблицях

Ендпоінт	Поля для пошуку
`/campaigns`	`name`
`/ad-groups`	`name`, `campaign_name`
`/ads`	тексти заголовків, тексти описів, `final_url`, `campaign_name`, `ad_group_name`
`/keywords`	`text`, назва кампанії, назва групи оголошень
`/search-terms`	`search_term`, `matched_keyword`, `campaign_name`, `ad_group_name`
`/ad-schedule`	`campaign_name`, `day_of_week`
`/locations`	`campaign_name`, `location_name`
`/user-locations`	`campaign_name`, `most_specific_location`, `city`, `region`
`/geographic-performance`	`location_name`, `campaign_name`

Приклади

Фільтрувати кампанії за назвою

curl "https://api.cattix.com/api/v1/google-ads/1234567890/campaigns?search=brand" \
  -H "Authorization: Bearer $TOKEN"

import httpx

resp = httpx.get(
    "https://api.cattix.com/api/v1/google-ads/1234567890/campaigns",
    params={"search": "brand", "start_date": "2025-01-01", "end_date": "2025-01-31"},
    headers={"Authorization": f"Bearer {token}"},
)

Пошук оголошень за текстом заголовка

GET /api/v1/google-ads/1234567890/ads?search=free+shipping

Повертає лише оголошення, де будь-який заголовок або опис містить “free shipping”.

Пошук ключових слів по кампанії та групі оголошень

GET /api/v1/google-ads/1234567890/keywords?search=shoes

Повертає ключові слова, де текст ключового слова, назва кампанії або назва групи оголошень містить “shoes”.

Getting started

Customization

Writing content

AI tools

Google Ads

Companies

Campaigns

Пошук по таблицях

Огляд

Як використовувати

Правила параметра

Поведінка пошуку

Поля для пошуку по таблицях

Приклади

Фільтрувати кампанії за назвою

Пошук оголошень за текстом заголовка

Пошук ключових слів по кампанії та групі оголошень

​Огляд

​Як використовувати

​Правила параметра

​Поведінка пошуку

​Поля для пошуку по таблицях

​Приклади

​Фільтрувати кампанії за назвою

​Пошук оголошень за текстом заголовка

​Пошук ключових слів по кампанії та групі оголошень

Огляд

Як використовувати

Правила параметра

Поведінка пошуку

Поля для пошуку по таблицях

Приклади

Фільтрувати кампанії за назвою

Пошук оголошень за текстом заголовка

Пошук ключових слів по кампанії та групі оголошень