airbyte-agent-amazon-ads 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

{airbyte_agent_amazon_ads-0.1.1.dist-info → airbyte_agent_amazon_ads-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-amazon-ads
-Version: 0.1.1
+Version: 0.1.3
 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/quickstarts/tutorial-hosted).
+
+```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.3
 - **Connector version:** 1.0.1
-- **Generated with Connector SDK commit SHA:** c713ec4833c2b52dc89926ec68caa343423884cd
+- **Generated with Connector SDK commit SHA:** b27328e2162813ea6315b9f890a6784b0fb9caba

{airbyte_agent_amazon_ads-0.1.1.dist-info → airbyte_agent_amazon_ads-0.1.3.dist-info}/RECORD

@@ -52,6 +52,6 @@ airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/__init__.py,sha256=Ra
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/config.py,sha256=tLmQwAFD0kP1WyBGWBS3ysaudN9H3e-3EopKZi6cGKg,885
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/events.py,sha256=8Y1NbXiwISX-V_wRofY7PqcwEXD0dLMnntKkY6XFU2s,1328
 airbyte_agent_amazon_ads/_vendored/connector_sdk/telemetry/tracker.py,sha256=Ftrk0_ddfM7dZG8hF9xBuPwhbc9D6JZ7Q9qs5o3LEyA,5579
-airbyte_agent_amazon_ads-0.1.1.dist-info/METADATA,sha256=SPpbByLuPB_FNeSM-Teps1O786Bn-IYE8AjdKYxqAv0,3623
-airbyte_agent_amazon_ads-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-airbyte_agent_amazon_ads-0.1.1.dist-info/RECORD,,
+airbyte_agent_amazon_ads-0.1.3.dist-info/METADATA,sha256=EE39_Fy1TGiAokOCBmCcsNxyl9v6nwCsiLL_8kSm6XU,5152
+airbyte_agent_amazon_ads-0.1.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+airbyte_agent_amazon_ads-0.1.3.dist-info/RECORD,,