<p>Цель: нужно, чтобы данные по рекламе Amazon Ads (кампании, расходы, показы, клики, продажи и т.п.) стабильно тянулись по API в наш внешний инструмент (Google Sheets / БД / отчёт - уточним отдельно).<br /></p><p><b>1. Контекст и текущая ситуация</b></p><ul><li><p>Есть действующий Amazon Seller / Ads аккаунт и созданное приложение в Developer Console.</p></li><li><p>Сейчас подключение к Amazon Ads API не работает:<br />* при запросе профилей (profiles) приходит пустой массив — профиль рекламного кабинета не подтягивается;<br />* при подключении через существующее приложение была ошибка requested scopes not found;<br />* есть подозрение, что рекламный аккаунт некорректно привязан к приложению / не даны нужные права.</p></li><li><p>Refresh token получается через ссылку вида:<br /><a href="https://www.amazon.com/ap/oa?client_id=...&scope=advertising::campaign_management&response_type=code&redirect_uri=http://localhost">https://www.amazon.com/ap/oa?client_id=...&scope=advertising::campaign_management&response_type=code&redirect_uri=http://localhost</a><br />но дальше цепочка авторизации до рабочего Profile ID не доведена.</p></li><li><p>Все доступы (Client ID, Client Secret, Refresh Token, Developer ID, ссылка на Developer Console, доступ к тикет-системе поддержки) передадим отдельно.<br /></p></li></ul><p><b>2. Что нужно сделать</b></p><ol><li><p>Проверить и правильно настроить приложение в Amazon Developer Console<br />* Убедиться, что указаны корректные scopes для Amazon Ads (advertising::campaign_management и др., если нужны).<br />* Проверить, что рекламный кабинет действительно привязан к приложению (через Amazon Advertising Console / Developer Console).<br />* При необходимости пере-создать приложение «с нуля» по best practices.</p></li><li><p>Наладить корректный OAuth-флоу<br />* Настроить получение authorization code ? access_token / refresh_token.<br />* Проверить, что refresh token рабочий и не устаревает каждые полчаса из-за ошибок в настройке.<br />* Документировать, какую именно ссылку и параметры мы должны использовать для обновления токенов.</p></li><li><p>Получить рабочий Profile ID<br />* Добиться, чтобы запрос к /v2/profiles (или актуальному endpoint’у) возвращал список профилей, а не .<br />* Выяснить и устранить причину, почему сейчас профиль не подтягивается (права, регион, неправильный аккаунт и т.п.).<br />* Зафиксировать нужный Profile ID и описать, как его повторно получить.</p></li><li><p>Проверить доступ к Amazon Apps & Services<br />* При необходимости — сформулировать, какие права и роли нужно выдать на аккаунте, чтобы раздел Apps & Services ? Develop Apps был доступен и всё корректно работало.<br />* Коротко описать, какие именно галочки/разрешения нужны от владельца аккаунта.</p></li><li><p>Настроить базовую выгрузку отчётов Amazon Ads<br />* Реализовать пример запроса к Amazon Ads API (например, Sponsored Products / Sponsored Brands) с использованием полученного Profile ID.<br />* Получить и сохранить первый тестовый отчёт (хотя бы в JSON или CSV) по кампаниям за выбранный период.<br />* Описать, какие endpoints и параметры можно использовать дальше (чтобы мы могли развивать отчётность сами или с вашей помощью).<br /></p></li></ol><p><b>3. Что важно на выходе</b></p><p>На выходе нам нужен:</p><ol><li><p>Рабочий API-доступ к Amazon Ads, который:<br />* корректно авторизуется;<br />* видит профиль(и) рекламного кабинета;<br />* позволяет запрашивать данные по рекламе.</p></li><li><p>Мини-документация (коротко, по пунктам):<br />* где в Seller Central / Advertising Console что настроено;<br />* какие Client ID / Developer ID / scopes используются;<br />* как обновлять токены (шаги и пример запроса);<br />* пример запроса к Ads API (с curl или Postman);<br />* какие права нужны от владельца аккаунта.</p></li><li><p>Понимание ограничений:<br />* если есть какие-то лимиты / ограничения по региону, типу аккаунта или политике Amazon — описать это.</p></li></ol><p>Если для старта нужны ещё какие-то данные (конкретный стек, куда выводить отчёты, доступ к хостингу и т.п.) — отдельно перечисли, пожалуйста, что именно требуется.</p>
