Налаштувати робоче підключення до 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 — описати це.
   
   

Якщо для старту потрібні ще якісь дані (конкретний стек, куди виводити звіти, доступ до хостингу тощо) — окремо перерахуй, будь ласка, що саме потрібно.