Skip to content

CHANGELOG.md

Latest commit

 

History

History
107 lines (86 loc) · 4.11 KB

CHANGELOG.md

File metadata and controls

107 lines (86 loc) · 4.11 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

  • Initial release of Amazon Ads API Python SDK
  • Support for 59 official Amazon Ads API endpoints
  • 100% coverage verification against official OpenAPI specs
  • Async/await support with httpx
  • Automatic OAuth2 token refresh
  • Rate limiting and retry mechanisms
  • Comprehensive error handling
  • Unit tests (62 tests, 100% pass rate)
  • Integration tests (6 tests, 100% pass rate)
  • End-to-end tests (5 tests, 100% pass rate)

Core APIs (L1 - OpenAPI Verified)

  • Sponsored Products (SP): Campaigns, Ad Groups, Keywords, Product Ads, Negative Keywords, Campaign Negative Keywords, Targets, Negative Targets, Budget Rules, Budget Recommendations
  • Sponsored Brands (SB): Campaigns, Ad Groups, Keywords, Product Targeting, Brand Video, Creatives, Moderation, Landing Pages
  • Sponsored Display (SD): Campaigns, Ad Groups, Product Ads, Targets, Creative Assets, Budget Rules, Forecast
  • DSP: Advertisers, Audiences, Campaigns, Conversions, Measurement, Target KPI
  • Accounts: Profiles, Portfolios, Budgets, Billing, Advertising Accounts, Test Accounts
  • Audiences: Audience Discovery, Product Selector
  • Exports: Data Exports, Report Exports
  • Eligibility: Campaign Eligibility, Keyword Eligibility
  • Locations: Location Targeting

Reference APIs (L2 - Official Documentation)

  • Amazon Marketing Cloud (AMC): Administration, Reporting, Audiences
  • Attribution: Attribution Tags, Publishers, Reports
  • Data Provider: Data Sets, Uploads
  • Unified API: Amazon Ads API v1 (campaigns, keywords, recommendations, forecasts, etc.)
  • Posts: Sponsored Posts API
  • Retail Ad Service: Orders, Line Items, Creatives
  • Marketing Stream: Real-time data streaming

Service APIs (L3 - Product Level)

  • Reporting: Reports v2, Reports v3, MMM (Marketing Mix Modeling), Offline Reports
  • Recommendations: Campaign Recommendations, Keyword Recommendations, Budget Recommendations
  • Insights: Brand Insights, Product Insights, Audience Insights
  • Common Services: Change History, Creative Asset Library, Stores
  • Media Planning: Reach Forecasting, Media Planning Tools
  • Brand Associations: Brand Safety, Brand Suitability
  • Ads Data Manager: Data Sources, Audiences

Experimental APIs (L4 - Beta)

  • Ad Library: Ad Repository Management
  • Brand Home: Store Pages, Brand Stores
  • Localization: Currency, Keyword, Product, Targeting Expression Localization
  • Moderation: Pre-moderation, Creative Moderation
  • Partner Opportunities: Partner Network
  • Persona Builder: Audience Persona
  • Sponsored TV: TV Campaigns, Formats

Infrastructure

  • Automated coverage verification scripts
  • Deep verification for duplicate detection
  • Comprehensive test suite (unit/integration/e2e)
  • OpenAPI spec synchronization (59 specs)
  • Documentation generation

[0.1.0] - 2025-01-15

Added

  • Initial alpha release
  • Basic API client structure
  • OAuth2 authentication
  • Core SP/SB/SD APIs

Fixed

  • Multiple path errors in AMC APIs
  • Incorrect endpoint implementations in Ad Library, Brand Home, Localization
  • HTTP method mismatches in Unified API
  • Missing endpoints in Advertising Accounts API

Changed

  • Migrated from requests to httpx for async support
  • Restructured project to 4-tier architecture (L1/L2/L3/L4)
  • Improved error handling and retry logic
  • Enhanced token management with automatic refresh

[0.0.1] - 2025-01-01

Added

  • Project initialization
  • Basic project structure
  • Initial README and LICENSE

Version Strategy

  • MAJOR: Breaking API changes
  • MINOR: New features, new API endpoints
  • PATCH: Bug fixes, documentation updates

Links