Запуск довгого звіту Google Ads — це POST на /google-ads/v1/accounts/{customer_id}/report у Top-Rated Team Google Ads API: це акаунти Google Ads, які надано вашій організації. Кожен запит несе ваш власний ключ у заголовку X-API-KEY — той самий, що й у LinkedIn API — і дістає лише до акаунтів, призначених вашій організації. Акаунт, який їй ніхто не призначав, відповідає так, ніби його не існує.
Тут ніщо не змінює акаунт саме по собі. Зміну пропонують, Google її перевіряє, і її записують, а виконується вона, коли її застосовує людина — і спершу записується, що знадобиться, щоб її скасувати, аби все можна було повернути.
Запит
curl -X POST "https://top-rated.team/google-ads/v1/accounts/$CUSTOMER_ID/report" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Що йде у шлях
- customer_id — id, який повернув попередній виклик із цієї родини.
Що приходить, коли не працює
- 401 — ключа немає, він хибний або відкликаний.
- 402 — тариф не оплачено. Тариф Top-Rated Team API відповідає так, коли пробний період скінчився.
- 404 — або цього немає, або це не вашої організації. Обидва випадки навмисне дають однакову відповідь, щоб id не можна було перебрати.
- 429 — забагато запитів або платформа просить нас пригальмувати. Зачекайте трохи, перш ніж пробувати знову.
- 502 або 503 — платформа щойно не відповіла. Спробуйте ще раз за хвилину.
Кожна помилка — це JSON однієї форми: {"type":"errors/<code>","status":<n>,"detail":"..."} — тож один обробник покриває всі, а detail написано так, щоб його можна було показати людині.
Попросити асистента
Ця операція — ще й інструмент MCP. Вставте https://top-rated.team/google-ads/mcp/<your API key> у Claude, ChatGPT або будь-якого асистента, що говорить MCP, і попросіть звичайними словами — асистент сам обере виклик, підставить id і прочитає вам відповідь. В універсального агента за адресою https://top-rated.team/mcp/<your API key> він теж є — поруч із LinkedIn API та всіма іншими каналами.
У проєктній кімнаті
У проєктній кімнаті позначте агента цього API в полі «Може використовувати» у свого ШІ-агента — і він викликатиме «Запуск довгого звіту Google Ads» як інструмент щоразу, коли це потрібно розмові. Усі в кімнаті бачать, про що він спитав і що повернулося. Просіть звичайними словами; тут агент зветься @scout:
- @scout знайди, на чому ми найбільше втратили грошей у пошукових запитах минулого тижня, і оформи мінус-слова як пропозицію, яку хтось прочитає до виконання.
Часті запитання
Чи може ШІ-агент викликати «Запуск довгого звіту Google Ads» за мене?
Так. Може будь-який асистент, що говорить MCP, — за адресою вище, — і ваш власний ШІ-агент у проєктній кімнаті із позначеним агентом цього API. Вбудовані агенти кімнати не можуть: вони радять, а вашого ключа в них немає.
Чи працює це поза кімнатою, з мого власного коду?
Так. Запит вище — це та сама операція, яку викликає інструмент ШІ-агента, з тією самою відповіддю й тими самими помилками, а ваш ключ дістає до тих самих каналів, яким би шляхом ви не прийшли.
Чи працює це в кімнаті під моїм власним брендом?
Так. На адресі white-label API, його довідник і його ШІ-агент мають назву вашого продукту й дістають до тих самих каналів за тими самими правилами.
Чи може людина схвалити, перш ніж ШІ-агент це зробить?
Впишіть це в інструкції ШІ-агента: хай скаже, що збирається надіслати, і дочекається, поки людина в кімнаті скаже «давай». Кімната показує кожну відповідь усім, хто в ній, тож слова видно раніше, ніж вони дійдуть до будь-кого ззовні.
У якому тарифі
Входить у тариф Top-Rated Team API, з тим самим ключем, що й LinkedIn API: 9 $ за місце на місяць, 7 $ від ста місць. Місць потрібно стільки, скільки у вас того, чого найбільше, — акаунтів LinkedIn, номерів WhatsApp, акаунтів X або акаунтів скриньки, — а 30-денний пробний період покриває одне місце.