Предложение изменения в Google Ads — это POST по /google-ads/v1/accounts/{customer_id}/changes в 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/changes" \
-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-дневный пробный период охватывает одно место.