airbyte-agent-amazon-ads 0.1.1__tar.gz → 0.1.2__tar.gz

{airbyte_agent_amazon_ads-0.1.1 → airbyte_agent_amazon_ads-0.1.2}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Amazon Ads changelog
 
+## [0.1.2] - 2026-01-22
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: 1da193dd
+- SDK version: 0.1.0
+
 ## [0.1.1] - 2026-01-22
 - Updated connector definition (YAML version 1.0.1)
 - Source commit: c713ec48

{airbyte_agent_amazon_ads-0.1.1 → airbyte_agent_amazon_ads-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-amazon-ads
-Version: 0.1.1
+Version: 0.1.2
 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/
@@ -67,19 +67,50 @@ uv pip install airbyte-agent-amazon-ads
 
 ## Usage
 
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
 ```python
-from airbyte_agent_amazon_ads import AmazonAdsConnector, AmazonAdsAuthConfig
+from airbyte_agent_amazon-ads import AmazonAdsConnector
+from airbyte_agent_amazon_ads.models import AmazonAdsAuthConfig
 
 connector = AmazonAdsConnector(
-  auth_config=AmazonAdsAuthConfig(
-    client_id="...",
-    client_secret="...",
-    refresh_token="..."
-  )
+    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>"
+    )
 )
-result = await connector.profiles.list()
+
+@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 {})
 ```
 
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/hosted-execution).
+
+```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 {})
+```
 
 ## Full documentation
 
@@ -92,12 +123,14 @@ This connector supports the following entities and actions.
 | Sponsored Product Campaigns | [List](./REFERENCE.md#sponsored-product-campaigns-list), [Get](./REFERENCE.md#sponsored-product-campaigns-get) |
 
 
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
 For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
 
 For the service's official API docs, see the [Amazon-Ads API reference](https://advertising.amazon.com/API/docs/en-us).
 
 ## Version information
 
-- **Package version:** 0.1.1
+- **Package version:** 0.1.2
 - **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** c713ec4833c2b52dc89926ec68caa343423884cd
+- **Generated with Connector SDK commit SHA:** 1da193dd2b3d4b2e2147ba74bd9a4062a62c4186

airbyte_agent_amazon_ads-0.1.2/README.md

@@ -0,0 +1,103 @@
+# Amazon-Ads agent connector
+
+Amazon Ads is Amazon's advertising platform that enables sellers and vendors to promote their
+products across Amazon's marketplace. This connector provides access to advertising profiles
+for managing and analyzing advertising campaigns across different marketplaces.
+
+
+## Example questions
+
+The Amazon-Ads connector is optimized to handle prompts like these.
+
+- List all my advertising profiles across marketplaces
+- Show me the profiles for my seller accounts
+- What marketplaces do I have advertising profiles in?
+- List all portfolios for a specific profile
+- Show me all sponsored product campaigns
+- What campaigns are currently enabled?
+- Find campaigns with a specific targeting type
+
+## Unsupported questions
+
+The Amazon-Ads connector isn't currently able to handle prompts like these.
+
+- Create a new advertising campaign
+- Update my campaign budget
+- Delete an ad group
+- Generate a performance report
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-amazon-ads
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```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>"
+    )
+)
+
+@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 {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/hosted-execution).
+
+```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 {})
+```
+
+## Full documentation
+
+This connector supports the following entities and actions.
+
+| Entity | Actions |
+|--------|---------|
+| Profiles | [List](./REFERENCE.md#profiles-list), [Get](./REFERENCE.md#profiles-get) |
+| Portfolios | [List](./REFERENCE.md#portfolios-list), [Get](./REFERENCE.md#portfolios-get) |
+| Sponsored Product Campaigns | [List](./REFERENCE.md#sponsored-product-campaigns-list), [Get](./REFERENCE.md#sponsored-product-campaigns-get) |
+
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
+
+For the service's official API docs, see the [Amazon-Ads API reference](https://advertising.amazon.com/API/docs/en-us).
+
+## Version information
+
+- **Package version:** 0.1.2
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** 1da193dd2b3d4b2e2147ba74bd9a4062a62c4186

{airbyte_agent_amazon_ads-0.1.1 → airbyte_agent_amazon_ads-0.1.2}/REFERENCE.md

@@ -311,63 +311,3 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 
 </details>
 
-
-
-## 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
- |
-
-
-## Authentication
-
-The Amazon-Ads connector supports the following authentication methods.
-
-
-### OAuth2 Authentication
-
-| 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 |
-
-#### Example
-
-**Python SDK**
-
-```python
-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>"
-  )
-)
-```
-
-**API**
-
-```bash
-curl --location 'https://api.airbyte.ai/api/v1/integrations/sources' \
---header 'Content-Type: application/json' \
---header 'Authorization: Bearer {your_auth_token}' \
---data '{
-  "workspace_id": "{your_workspace_id}",
-  "source_template_id": "{source_template_id}",
-  "auth_config": {
-    "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>"
-  },
-  "name": "My Amazon-Ads Connector"
-}'
-```
-

{airbyte_agent_amazon_ads-0.1.1 → airbyte_agent_amazon_ads-0.1.2}/pyproject.toml

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

airbyte_agent_amazon_ads-0.1.1/README.md

@@ -1,70 +0,0 @@
-# Amazon-Ads agent connector
-
-Amazon Ads is Amazon's advertising platform that enables sellers and vendors to promote their
-products across Amazon's marketplace. This connector provides access to advertising profiles
-for managing and analyzing advertising campaigns across different marketplaces.
-
-
-## Example questions
-
-The Amazon-Ads connector is optimized to handle prompts like these.
-
-- List all my advertising profiles across marketplaces
-- Show me the profiles for my seller accounts
-- What marketplaces do I have advertising profiles in?
-- List all portfolios for a specific profile
-- Show me all sponsored product campaigns
-- What campaigns are currently enabled?
-- Find campaigns with a specific targeting type
-
-## Unsupported questions
-
-The Amazon-Ads connector isn't currently able to handle prompts like these.
-
-- Create a new advertising campaign
-- Update my campaign budget
-- Delete an ad group
-- Generate a performance report
-
-## Installation
-
-```bash
-uv pip install airbyte-agent-amazon-ads
-```
-
-## Usage
-
-```python
-from airbyte_agent_amazon_ads import AmazonAdsConnector, AmazonAdsAuthConfig
-
-connector = AmazonAdsConnector(
-  auth_config=AmazonAdsAuthConfig(
-    client_id="...",
-    client_secret="...",
-    refresh_token="..."
-  )
-)
-result = await connector.profiles.list()
-```
-
-
-## Full documentation
-
-This connector supports the following entities and actions.
-
-| Entity | Actions |
-|--------|---------|
-| Profiles | [List](./REFERENCE.md#profiles-list), [Get](./REFERENCE.md#profiles-get) |
-| Portfolios | [List](./REFERENCE.md#portfolios-list), [Get](./REFERENCE.md#portfolios-get) |
-| Sponsored Product Campaigns | [List](./REFERENCE.md#sponsored-product-campaigns-list), [Get](./REFERENCE.md#sponsored-product-campaigns-get) |
-
-
-For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
-
-For the service's official API docs, see the [Amazon-Ads API reference](https://advertising.amazon.com/API/docs/en-us).
-
-## Version information
-
-- **Package version:** 0.1.1
-- **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** c713ec4833c2b52dc89926ec68caa343423884cd