Skip to main content
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

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

ЕндпоінтПоля для пошуку
/campaignsname
/ad-groupsname, campaign_name
/adsтексти заголовків, тексти описів, final_url, campaign_name, ad_group_name
/keywordstext, назва кампанії, назва групи оголошень
/search-termssearch_term, matched_keyword, campaign_name, ad_group_name
/ad-schedulecampaign_name, day_of_week
/locationscampaign_name, location_name
/user-locationscampaign_name, most_specific_location, city, region
/geographic-performancelocation_name, campaign_name

​
Приклади

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

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

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

GET /api/v1/google-ads/1234567890/ads?search=free+shipping
Повертає лише оголошення, де будь-який заголовок або опис містить “free shipping”.

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

GET /api/v1/google-ads/1234567890/keywords?search=shoes
Повертає ключові слова, де текст ключового слова, назва кампанії або назва групи оголошень містить “shoes”.