Настроить рабочее подключение к Amazon Ads API и выгрузку отчётов по рекламе, в том числ Bulk-File

Цель: нужно, чтобы данные по рекламе Amazon Ads (кампании, расходы, показы, клики, продажи и т.п.) стабильно тянулись по API в наш внешний инструмент (Google Sheets / БД / отчёт - уточним отдельно).

1. Контекст и текущая ситуация

• Есть действующий Amazon Seller / Ads аккаунт и созданное приложение в Developer Console.
• Сейчас подключение к Amazon Ads API не работает:
  * при запросе профилей (profiles) приходит пустой массив [] — профиль рекламного кабинета не подтягивается;
  * при подключении через существующее приложение была ошибка requested scopes not found;
  * есть подозрение, что рекламный аккаунт некорректно привязан к приложению / не даны нужные права.
• Refresh token получается через ссылку вида:
  https://www.amazon.com/ap/oa?client_id=...&scope=advertising::campaign_management&response_type=code&redirect_uri=http://localhost
  но дальше цепочка авторизации до рабочего Profile ID не доведена.
• Все доступы (Client ID, Client Secret, Refresh Token, Developer ID, ссылка на Developer Console, доступ к тикет-системе поддержки) передадим отдельно.
  
  

2. Что нужно сделать

1. Проверить и правильно настроить приложение в Amazon Developer Console
   * Убедиться, что указаны корректные scopes для Amazon Ads (advertising::campaign_management и др., если нужны).
   * Проверить, что рекламный кабинет действительно привязан к приложению (через Amazon Advertising Console / Developer Console).
   * При необходимости пере-создать приложение «с нуля» по best practices.
2. Наладить корректный OAuth-флоу
   * Настроить получение authorization code → access_token / refresh_token.
   * Проверить, что refresh token рабочий и не устаревает каждые полчаса из-за ошибок в настройке.
   * Документировать, какую именно ссылку и параметры мы должны использовать для обновления токенов.
3. Получить рабочий Profile ID
   * Добиться, чтобы запрос к /v2/profiles (или актуальному endpoint’у) возвращал список профилей, а не [].
   * Выяснить и устранить причину, почему сейчас профиль не подтягивается (права, регион, неправильный аккаунт и т.п.).
   * Зафиксировать нужный Profile ID и описать, как его повторно получить.
4. Проверить доступ к Amazon Apps & Services
   * При необходимости — сформулировать, какие права и роли нужно выдать на аккаунте, чтобы раздел Apps & Services → Develop Apps был доступен и всё корректно работало.
   * Коротко описать, какие именно галочки/разрешения нужны от владельца аккаунта.
5. Настроить базовую выгрузку отчётов Amazon Ads
   * Реализовать пример запроса к Amazon Ads API (например, Sponsored Products / Sponsored Brands) с использованием полученного Profile ID.
   * Получить и сохранить первый тестовый отчёт (хотя бы в JSON или CSV) по кампаниям за выбранный период.
   * Описать, какие endpoints и параметры можно использовать дальше (чтобы мы могли развивать отчётность сами или с вашей помощью).
   
   

3. Что важно на выходе

На выходе нам нужен:

1. Рабочий API-доступ к Amazon Ads, который:
   * корректно авторизуется;
   * видит профиль(и) рекламного кабинета;
   * позволяет запрашивать данные по рекламе.
2. Мини-документация (коротко, по пунктам):
   * где в Seller Central / Advertising Console что настроено;
   * какие Client ID / Developer ID / scopes используются;
   * как обновлять токены (шаги и пример запроса);
   * пример запроса к Ads API (с curl или Postman);
   * какие права нужны от владельца аккаунта.
3. Понимание ограничений:
   * если есть какие-то лимиты / ограничения по региону, типу аккаунта или политике Amazon — описать это.
   
   

Если для старта нужны ещё какие-то данные (конкретный стек, куда выводить отчёты, доступ к хостингу и т.п.) — отдельно перечисли, пожалуйста, что именно требуется.