airbyte-agent-amazon-ads 0.1.3__tar.gz → 0.1.5__tar.gz

airbyte_agent_amazon_ads-0.1.5/AUTH.md

@@ -0,0 +1,103 @@
+# Amazon-Ads authentication and configuration
+
+This page documents the authentication and configuration options for the Amazon-Ads agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `client_id` | `str` | Yes | The client ID of your Amazon Ads API application |
+| `client_secret` | `str` | Yes | The client secret of your Amazon Ads API application |
+| `refresh_token` | `str` | Yes | The refresh token obtained from the OAuth authorization flow |
+
+```python
+from airbyte_agent_amazon-ads import AmazonAdsConnector
+from airbyte_agent_amazon-ads.models import AmazonAdsAuthConfig
+
+connector = AmazonAdsConnector(
+    auth_config=AmazonAdsAuthConfig(
+        client_id="<The client ID of your Amazon Ads API application>",
+        client_secret="<The client secret of your Amazon Ads API application>",
+        refresh_token="<The refresh token obtained from the OAuth authorization flow>"
+    )
+)
+```
+
+#### Token
+This authentication method isn't available for this connector.
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+
+Create a connector with OAuth credentials:
+
+```bash
+curl -X POST 'https://api.airbyte.ai/v1/integrations/connectors' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Amazon-Ads",
+    "name": "My Amazon-Ads Connector",
+    "credentials": {
+      "client_id": "<The client ID of your Amazon Ads API application>",
+      "client_secret": "<The client secret of your Amazon Ads API application>",
+      "refresh_token": "<The refresh token obtained from the OAuth authorization flow>"
+    }
+  }'
+```
+
+#### Token
+This authentication method isn't available for this connector.
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_amazon-ads import AmazonAdsConnector
+
+connector = AmazonAdsConnector(
+    external_user_id="<your-scoped-token>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@AmazonAdsConnector.describe
+async def amazon-ads_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+
+## Configuration
+
+The Amazon-Ads connector requires the following configuration variables. These variables are used to construct the base API URL. Pass them via the `config` parameter when initializing the connector.
+
+| Variable | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `region_url` | `string` | Yes | https://advertising-api.amazon.com | The Amazon Ads API endpoint URL based on region:
+- NA (North America): https://advertising-api.amazon.com
+- EU (Europe): https://advertising-api-eu.amazon.com
+- FE (Far East): https://advertising-api-fe.amazon.com
+ |

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Amazon Ads changelog
 
+## [0.1.5] - 2026-01-23
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: f17cdd8c
+- SDK version: 0.1.0
+
+## [0.1.4] - 2026-01-22
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: 49e6dfe9
+- SDK version: 0.1.0
+
 ## [0.1.3] - 2026-01-22
 - Updated connector definition (YAML version 1.0.1)
 - Source commit: b27328e2

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-amazon-ads
-Version: 0.1.3
+Version: 0.1.5
 Summary: Airbyte Amazon-Ads Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -131,6 +131,6 @@ For the service's official API docs, see the [Amazon-Ads API reference](https://
 
 ## Version information
 
-- **Package version:** 0.1.3
+- **Package version:** 0.1.5
 - **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** b27328e2162813ea6315b9f890a6784b0fb9caba
+- **Generated with Connector SDK commit SHA:** f17cdd8c92950751a75daff9c6bf74df05774ede

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/README.md

@@ -98,6 +98,6 @@ For the service's official API docs, see the [Amazon-Ads API reference](https://
 
 ## Version information
 
-- **Package version:** 0.1.3
+- **Package version:** 0.1.5
 - **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** b27328e2162813ea6315b9f890a6784b0fb9caba
+- **Generated with Connector SDK commit SHA:** f17cdd8c92950751a75daff9c6bf74df05774ede

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/REFERENCE.md

@@ -12,9 +12,9 @@ The Amazon-Ads connector supports the following entities and actions.
 | Portfolios | [List](#portfolios-list), [Get](#portfolios-get) |
 | Sponsored Product Campaigns | [List](#sponsored-product-campaigns-list), [Get](#sponsored-product-campaigns-get) |
 
-### Profiles
+## Profiles
 
-#### Profiles List
+### Profiles List
 
 Returns a list of advertising profiles associated with the authenticated user.
 Profiles represent an advertiser's account in a specific marketplace. Advertisers
@@ -22,13 +22,13 @@ may have a single profile if they advertise in only one marketplace, or a separa
 profile for each marketplace if they advertise regionally or globally.
 
 
-**Python SDK**
+#### Python SDK
 
 ```python
 await amazon_ads.profiles.list()
 ```
 
-**API**
+#### API
 
 ```bash
 curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
@@ -41,7 +41,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 ```
 
 
-**Parameters**
+#### Parameters
 
 | Parameter Name | Type | Required | Description |
 |----------------|------|----------|-------------|
@@ -53,7 +53,7 @@ Valid values: seller, vendor, agency
 <details>
 <summary><b>Response Schema</b></summary>
 
-**Records**
+#### Records
 
 | Field Name | Type | Description |
 |------------|------|-------------|
@@ -67,13 +67,13 @@ Valid values: seller, vendor, agency
 
 </details>
 
-#### Profiles Get
+### Profiles Get
 
 Retrieves a single advertising profile by its ID. The profile contains
 information about the advertiser's account in a specific marketplace.
 
 
-**Python SDK**
+#### Python SDK
 
 ```python
 await amazon_ads.profiles.get(
@@ -81,7 +81,7 @@ await amazon_ads.profiles.get(
 )
 ```
 
-**API**
+#### API
 
 ```bash
 curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
@@ -97,7 +97,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 ```
 
 
-**Parameters**
+#### Parameters
 
 | Parameter Name | Type | Required | Description |
 |----------------|------|----------|-------------|
@@ -107,7 +107,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 <details>
 <summary><b>Response Schema</b></summary>
 
-**Records**
+#### Records
 
 | Field Name | Type | Description |
 |------------|------|-------------|
@@ -121,21 +121,21 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 
 </details>
 
-### Portfolios
+## Portfolios
 
-#### Portfolios List
+### Portfolios List
 
 Returns a list of portfolios for the specified profile. Portfolios are used to
 group campaigns together for organizational and budget management purposes.
 
 
-**Python SDK**
+#### Python SDK
 
 ```python
 await amazon_ads.portfolios.list()
 ```
 
-**API**
+#### API
 
 ```bash
 curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
@@ -148,19 +148,19 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 ```
 
 
-**Parameters**
+#### Parameters
 
 | Parameter Name | Type | Required | Description |
 |----------------|------|----------|-------------|
 | `includeExtendedDataFields` | `string` | No | Whether to include extended data fields in the response |
 
 
-#### Portfolios Get
+### Portfolios Get
 
 Retrieves a single portfolio by its ID using the v2 API.
 
 
-**Python SDK**
+#### Python SDK
 
 ```python
 await amazon_ads.portfolios.get(
@@ -168,7 +168,7 @@ await amazon_ads.portfolios.get(
 )
 ```
 
-**API**
+#### API
 
 ```bash
 curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
@@ -184,7 +184,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 ```
 
 
-**Parameters**
+#### Parameters
 
 | Parameter Name | Type | Required | Description |
 |----------------|------|----------|-------------|
@@ -194,7 +194,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 <details>
 <summary><b>Response Schema</b></summary>
 
-**Records**
+#### Records
 
 | Field Name | Type | Description |
 |------------|------|-------------|
@@ -210,21 +210,21 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 
 </details>
 
-### Sponsored Product Campaigns
+## Sponsored Product Campaigns
 
-#### Sponsored Product Campaigns List
+### Sponsored Product Campaigns List
 
 Returns a list of sponsored product campaigns for the specified profile.
 Sponsored Products campaigns promote individual product listings on Amazon.
 
 
-**Python SDK**
+#### Python SDK
 
 ```python
 await amazon_ads.sponsored_product_campaigns.list()
 ```
 
-**API**
+#### API
 
 ```bash
 curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
@@ -237,7 +237,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 ```
 
 
-**Parameters**
+#### Parameters
 
 | Parameter Name | Type | Required | Description |
 |----------------|------|----------|-------------|
@@ -247,12 +247,12 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 | `nextToken` | `string` | No | Token for pagination |
 
 
-#### Sponsored Product Campaigns Get
+### Sponsored Product Campaigns Get
 
 Retrieves a single sponsored product campaign by its ID using the v2 API.
 
 
-**Python SDK**
+#### Python SDK
 
 ```python
 await amazon_ads.sponsored_product_campaigns.get(
@@ -260,7 +260,7 @@ await amazon_ads.sponsored_product_campaigns.get(
 )
 ```
 
-**API**
+#### API
 
 ```bash
 curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
@@ -276,7 +276,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 ```
 
 
-**Parameters**
+#### Parameters
 
 | Parameter Name | Type | Required | Description |
 |----------------|------|----------|-------------|
@@ -286,7 +286,7 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 <details>
 <summary><b>Response Schema</b></summary>
 
-**Records**
+#### Records
 
 | Field Name | Type | Description |
 |------------|------|-------------|

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/airbyte_agent_amazon_ads/_vendored/connector_sdk/auth_strategies.py

@@ -634,9 +634,7 @@ class OAuth2AuthStrategy(AuthStrategy):
             Headers dict with additional headers added
         """
         # Build template context with extracted secret values
-        template_context = {
-            key: extract_secret_value(value) for key, value in secrets.items()
-        }
+        template_context = {key: extract_secret_value(value) for key, value in secrets.items()}
 
         for header_name, value_template in additional_headers.items():
             # Use Jinja2 templating for variable substitution

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/airbyte_agent_amazon_ads/_vendored/connector_sdk/executor/local_executor.py

@@ -694,9 +694,7 @@ class LocalExecutor:
         """
         return {key: value for key, value in params.items() if key in allowed_fields and value is not None}
 
-    def _extract_header_params(
-        self, endpoint: EndpointDefinition, params: dict[str, Any], body: dict[str, Any] | None = None
-    ) -> dict[str, str]:
+    def _extract_header_params(self, endpoint: EndpointDefinition, params: dict[str, Any], body: dict[str, Any] | None = None) -> dict[str, str]:
         """Extract header parameters from params and schema defaults.
 
         Also adds Content-Type header when there's a request body (unless already specified

{airbyte_agent_amazon_ads-0.1.3 → airbyte_agent_amazon_ads-0.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "airbyte-agent-amazon-ads"
-version = "0.1.3"
+version = "0.1.5"
 description = "Airbyte Amazon-Ads Connector for AI platforms"
 readme = "README.md"
 requires-python = ">=3.13"