From 6812dd0a9475aebb5c1a86a23f96605b25eb7415 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Tue, 3 May 2022 20:54:45 +0300 Subject: [PATCH 01/19] bump version Signed-off-by: Sergey Chvalyuk --- airbyte-integrations/connectors/source-amazon-ads/Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/airbyte-integrations/connectors/source-amazon-ads/Dockerfile b/airbyte-integrations/connectors/source-amazon-ads/Dockerfile index c2b37d453265..fee641a73ec8 100644 --- a/airbyte-integrations/connectors/source-amazon-ads/Dockerfile +++ b/airbyte-integrations/connectors/source-amazon-ads/Dockerfile @@ -12,5 +12,5 @@ RUN pip install . ENV AIRBYTE_ENTRYPOINT "python /airbyte/integration_code/main.py" ENTRYPOINT ["python", "/airbyte/integration_code/main.py"] -LABEL io.airbyte.version=0.1.7 +LABEL io.airbyte.version=0.1.8 LABEL io.airbyte.name=airbyte/source-amazon-ads From 57af2de8cf77d99a9d4dc524928a439ea5b92f41 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 05:30:18 +0300 Subject: [PATCH 02/19] update amazon-ads.md Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 65af43664364..e9b42f0a01c5 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -1,5 +1,21 @@ # Amazon Ads +## Setup guide +### Step 1: Set up Amazon Ads +Create an [Amazon user](https://www.amazon.com) with access to [Amazon Ads account](https://advertising.amazon.com). + +### Airbyte Open Source additional setup steps +To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you must first complete the [onboarding process](https://advertising.amazon.com/API/docs/en-us/setting-up/overview). The onboarding process has several steps, and may take several days to complete. After completing all steps you will has to get Amazon client application `Client ID`, `Client Secret` and `Refresh Token`. + +### Step 2: Set up the Amazon Ads connector in Airbyte +**For Airbyte Cloud:** + +1. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account. +2. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. +3. On the source setup page, select **Amazon Ads** from the Source type dropdown and enter a name for this connector. +4. Click `Authenticate your account`. +5. Log in and Authorize to the Amazon account and click `Set up source`. + ## Sync overview This source can sync data for the [Amazon Advertising API](https://advertising.amazon.com/API/docs/en-us/what-is/amazon-advertising-api). From d8595dd4413aee778f7942c22626f03442595088 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 09:44:11 +0300 Subject: [PATCH 03/19] Supported sync modes - added Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index e9b42f0a01c5..a56a0ba01248 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -16,6 +16,11 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 4. Click `Authenticate your account`. 5. Log in and Authorize to the Amazon account and click `Set up source`. +## Supported sync modes +The Amazon Ads source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts/#connection-sync-mode): + - Full Refresh + - Incremental + ## Sync overview This source can sync data for the [Amazon Advertising API](https://advertising.amazon.com/API/docs/en-us/what-is/amazon-advertising-api). From 545456f0ae3e8bda04d5e6c9bd45d60854f33069 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 10:23:46 +0300 Subject: [PATCH 04/19] continue to improve Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index a56a0ba01248..009b238f056d 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -1,4 +1,5 @@ # Amazon Ads +This page contains the setup guide and reference information for the Amazon Ads source connector. ## Setup guide ### Step 1: Set up Amazon Ads @@ -21,12 +22,7 @@ The Amazon Ads source connector supports the following [sync modes](https://docs - Full Refresh - Incremental -## Sync overview - -This source can sync data for the [Amazon Advertising API](https://advertising.amazon.com/API/docs/en-us/what-is/amazon-advertising-api). - -### Output schema - +## Supported Streams This source is capable of syncing the following streams: * [Profiles](https://advertising.amazon.com/API/docs/en-us/reference/2/profiles#/Profiles) From ed0fe0ced9f1a52738859ee8dd9cca2a8583a2b3 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 11:51:05 +0300 Subject: [PATCH 05/19] Prerequisites added Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 009b238f056d..acf33c723f89 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -1,6 +1,17 @@ # Amazon Ads This page contains the setup guide and reference information for the Amazon Ads source connector. +## Prerequisites + +* Client ID +* Client Secret +* Refresh Token +* Region +* Report Wait Timeout +* Report Generation Maximum Retries +* Start Date (Optional) +* Profile IDs (Optional) + ## Setup guide ### Step 1: Set up Amazon Ads Create an [Amazon user](https://www.amazon.com) with access to [Amazon Ads account](https://advertising.amazon.com). @@ -71,17 +82,6 @@ Information about expected report generation waiting time you may find [here](ht ## Getting started -### Requirements - -* client\_id -* client\_secret -* refresh\_token -* region -* report\_wait\_timeout -* report\_generation\_max\_retries -* start\_date \(optional\) -* profiles \(optional\) - More how to get client\_id and client\_secret you can find on [AWS docs](https://advertising.amazon.com/API/docs/en-us/setting-up/step-1-create-lwa-app). Refresh token is generated according to standard [AWS Oauth 2.0 flow](https://developer.amazon.com/docs/login-with-amazon/conceptual-overview.html) From 1c225b5e3f0ccbadf88ba8d9eecd7561696db145 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 11:59:55 +0300 Subject: [PATCH 06/19] continue to improve Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index acf33c723f89..adf4bee4dd0a 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -55,8 +55,14 @@ This source is capable of syncing the following streams: * [Display Reports](https://advertising.amazon.com/API/docs/en-us/sponsored-display/3-0/openapi#/Reports) * [Products Reports](https://advertising.amazon.com/API/docs/en-us/sponsored-products/2-0/openapi#/Reports) +## Connector-specific features and highlights + All the reports are generated for day before relatively to target profile' timezone +## Performance considerations + +Information about expected report generation waiting time you may find [here](https://advertising.amazon.com/API/docs/en-us/get-started/developer-notes). + ### Data type mapping | Integration Type | Airbyte Type | Notes | @@ -68,18 +74,6 @@ All the reports are generated for day before relatively to target profile' timez | `array` | `array` | | | `object` | `object` | | -### Features - -| Feature | Supported?\(Yes/No\) | Notes | -| :--- | :--- | :--- | -| Full Refresh Sync | yes | | -| Incremental Sync | yes | | -| Namespaces | No | | - -### Performance considerations - -Information about expected report generation waiting time you may find [here](https://advertising.amazon.com/API/docs/en-us/get-started/developer-notes). - ## Getting started More how to get client\_id and client\_secret you can find on [AWS docs](https://advertising.amazon.com/API/docs/en-us/setting-up/step-1-create-lwa-app). From 0a33c9c0cb5ef5a1fbf4f9e33691579e8a16c9c8 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 12:45:23 +0300 Subject: [PATCH 07/19] simplify Data type mapping Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index adf4bee4dd0a..f2a73e6e968f 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -65,14 +65,14 @@ Information about expected report generation waiting time you may find [here](ht ### Data type mapping -| Integration Type | Airbyte Type | Notes | -| :--- | :--- | :--- | -| `string` | `string` | | -| `int`, `float`, `number` | `number` | | -| `date` | `date` | | -| `datetime` | `datetime` | | -| `array` | `array` | | -| `object` | `object` | | +| Integration Type | Airbyte Type | +| :--- | :--- | +| `string` | `string` | +| `int`, `float`, `number` | `number` | +| `date` | `date` | +| `datetime` | `datetime` | +| `array` | `array` | +| `object` | `object` | ## Getting started From 1b36199a6ba8aecc92f66131adb558d30e82f259 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 13:08:10 +0300 Subject: [PATCH 08/19] move start date to top Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 16 ++++------------ 1 file changed, 4 insertions(+), 12 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index f2a73e6e968f..742ba5f25796 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -26,7 +26,10 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 2. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. 3. On the source setup page, select **Amazon Ads** from the Source type dropdown and enter a name for this connector. 4. Click `Authenticate your account`. -5. Log in and Authorize to the Amazon account and click `Set up source`. +5. Log in and Authorize to the Amazon account. +6. **Start Date** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as reportDate parameter for request\). +7. Click `Set up source`. + ## Supported sync modes The Amazon Ads source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts/#connection-sync-mode): @@ -74,16 +77,6 @@ Information about expected report generation waiting time you may find [here](ht | `array` | `array` | | `object` | `object` | -## Getting started - -More how to get client\_id and client\_secret you can find on [AWS docs](https://advertising.amazon.com/API/docs/en-us/setting-up/step-1-create-lwa-app). - -Refresh token is generated according to standard [AWS Oauth 2.0 flow](https://developer.amazon.com/docs/login-with-amazon/conceptual-overview.html) - -Scope usually has "advertising::campaign\_management" value, but customers may need to set scope to "cpc\_advertising:campaign\_management", - -Start date used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if start\_date is 2021-10-11 it would use 20211010 as reportDate parameter for request\). - ## CHANGELOG | Version | Date | Pull Request | Subject | @@ -96,4 +89,3 @@ Start date used for generating reports starting from the specified start date. S | `0.1.2` | 2021-10-01 | [\#6367](https://github.com/airbytehq/airbyte/pull/6461) | `Add option to pull data for different regions. Add option to choose profiles we want to pull data. Add lookback` | | `0.1.1` | 2021-09-22 | [\#6367](https://github.com/airbytehq/airbyte/pull/6367) | `Add seller and vendor filters to profiles stream` | | `0.1.0` | 2021-08-13 | [\#5023](https://github.com/airbytehq/airbyte/pull/5023) | `Initial version` | - From a1ff873fd3c9b1c31326c8bfc8e239713aa1cf6a Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 13:50:11 +0300 Subject: [PATCH 09/19] Report Wait Timeout, Report Generation Maximum Retries - added Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 742ba5f25796..0d0e5cc5b8fa 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -28,7 +28,9 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 4. Click `Authenticate your account`. 5. Log in and Authorize to the Amazon account. 6. **Start Date** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as reportDate parameter for request\). -7. Click `Set up source`. +7. **Report Wait Timeout** maximum number of minutes connector waits for generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. +8. **Report Generation Maximum Retries** maximum number of attempts connector tries to generate a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. +9. Click `Set up source`. ## Supported sync modes From b0038cc59fff915df1cf85e0e8d9b1841d3c9352 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 18:53:10 +0300 Subject: [PATCH 10/19] all steps are done Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 0d0e5cc5b8fa..f254ff121ed1 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -27,10 +27,12 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 3. On the source setup page, select **Amazon Ads** from the Source type dropdown and enter a name for this connector. 4. Click `Authenticate your account`. 5. Log in and Authorize to the Amazon account. -6. **Start Date** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as reportDate parameter for request\). +6. Select **Region** to pull data from **North America (NA)**, **Europe (EU)**, **Far East (FE)** or **Sandbox Environment**. See [docs](https://advertising.amazon.com/API/docs/en-us/info/api-overview#api-endpoints) for more details. 7. **Report Wait Timeout** maximum number of minutes connector waits for generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. 8. **Report Generation Maximum Retries** maximum number of attempts connector tries to generate a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. -9. Click `Set up source`. +9. **Start Date (Optional)** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as reportDate parameter for request\). +10. **Profile IDs (Optional)** you want to fetch data for. See [docs](https://advertising.amazon.com/API/docs/en-us/concepts/authorization/profiles) for more details. +11. Click `Set up source`. ## Supported sync modes From 258b187ce9ed32a6ece9876f98255439e68b3389 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 20:02:49 +0300 Subject: [PATCH 11/19] For Airbyte OSS added Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index f254ff121ed1..5a07a9b6fdc9 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -34,6 +34,11 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 10. **Profile IDs (Optional)** you want to fetch data for. See [docs](https://advertising.amazon.com/API/docs/en-us/concepts/authorization/profiles) for more details. 11. Click `Set up source`. +**For Airbyte OSS:** + +1. **Client ID** of your Amazon Ads developer application. See [onboarding process](https://advertising.amazon.com/API/docs/en-us/setting-up/overview) for more details. +2. **Client Secret** of your Amazon Ads developer application. See [onboarding process](https://advertising.amazon.com/API/docs/en-us/setting-up/overview) for more details. +3. **Refresh Token**. See [onboarding process](https://advertising.amazon.com/API/docs/en-us/setting-up/overview) for more details. ## Supported sync modes The Amazon Ads source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts/#connection-sync-mode): From bd426e4eada2312a5dbbd17384485561e48b22c3 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 20:23:18 +0300 Subject: [PATCH 12/19] fix typos Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 5a07a9b6fdc9..5d84a791514a 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -17,7 +17,7 @@ This page contains the setup guide and reference information for the Amazon Ads Create an [Amazon user](https://www.amazon.com) with access to [Amazon Ads account](https://advertising.amazon.com). ### Airbyte Open Source additional setup steps -To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you must first complete the [onboarding process](https://advertising.amazon.com/API/docs/en-us/setting-up/overview). The onboarding process has several steps, and may take several days to complete. After completing all steps you will has to get Amazon client application `Client ID`, `Client Secret` and `Refresh Token`. +To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you must first complete the [onboarding process](https://advertising.amazon.com/API/docs/en-us/setting-up/overview). The onboarding process has several steps and may take several days to complete. After completing all steps you will have to get Amazon client application `Client ID`, `Client Secret` and `Refresh Token`. ### Step 2: Set up the Amazon Ads connector in Airbyte **For Airbyte Cloud:** From 5b568e3475e4ea526a277b7730d480e478e90c14 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 20:59:53 +0300 Subject: [PATCH 13/19] fix typos (2) Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 5d84a791514a..be5cadd0bc45 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -28,8 +28,8 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 4. Click `Authenticate your account`. 5. Log in and Authorize to the Amazon account. 6. Select **Region** to pull data from **North America (NA)**, **Europe (EU)**, **Far East (FE)** or **Sandbox Environment**. See [docs](https://advertising.amazon.com/API/docs/en-us/info/api-overview#api-endpoints) for more details. -7. **Report Wait Timeout** maximum number of minutes connector waits for generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. -8. **Report Generation Maximum Retries** maximum number of attempts connector tries to generate a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. +7. **Report Wait Timeout** is the maximum number of minutes the connector waits for the generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. +8. **Report Generation Maximum Retries** is the maximum number of attempts the connector tries to generate a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. 9. **Start Date (Optional)** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as reportDate parameter for request\). 10. **Profile IDs (Optional)** you want to fetch data for. See [docs](https://advertising.amazon.com/API/docs/en-us/concepts/authorization/profiles) for more details. 11. Click `Set up source`. From 98622552467ddf786217d9ee87e6025d9b1c6c4f Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 21:01:34 +0300 Subject: [PATCH 14/19] reportDate added Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index be5cadd0bc45..b746be074ad7 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -30,7 +30,7 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 6. Select **Region** to pull data from **North America (NA)**, **Europe (EU)**, **Far East (FE)** or **Sandbox Environment**. See [docs](https://advertising.amazon.com/API/docs/en-us/info/api-overview#api-endpoints) for more details. 7. **Report Wait Timeout** is the maximum number of minutes the connector waits for the generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. 8. **Report Generation Maximum Retries** is the maximum number of attempts the connector tries to generate a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. -9. **Start Date (Optional)** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as reportDate parameter for request\). +9. **Start Date (Optional)** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as `reportDate` parameter for request\). 10. **Profile IDs (Optional)** you want to fetch data for. See [docs](https://advertising.amazon.com/API/docs/en-us/concepts/authorization/profiles) for more details. 11. Click `Set up source`. From ed28489680505a1e226f0ab1a249c88db81b9001 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 21:45:04 +0300 Subject: [PATCH 15/19] changelog updated Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index b746be074ad7..1bfceede6ffc 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -90,6 +90,7 @@ Information about expected report generation waiting time you may find [here](ht | Version | Date | Pull Request | Subject | | :--- | :--- | :--- | :--- | +| `0.1.8` | 2022-05-04 | [\#12541](https://github.com/airbytehq/airbyte/pull/12541) | Improve documentation for Beta | | `0.1.7` | 2022-04-27 | [\#11730](https://github.com/airbytehq/airbyte/pull/11730) | Update fields in source-connectors specifications | | `0.1.6` | 2022-04-20 | [\#11659](https://github.com/airbytehq/airbyte/pull/11659) | Add adId to products report | | `0.1.5` | 2022-04-08 | [\#11430](https://github.com/airbytehq/airbyte/pull/11430) | `Added support OAuth2.0` | From cf7708968abb173dca3189aa03566fd6d1a3bea6 Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Wed, 4 May 2022 23:35:56 +0300 Subject: [PATCH 16/19] bugfix "Authenticate your account" -> "Authenticate your Amazon Ads account" Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 1bfceede6ffc..ad464ab4619e 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -25,7 +25,7 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 1. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account. 2. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. 3. On the source setup page, select **Amazon Ads** from the Source type dropdown and enter a name for this connector. -4. Click `Authenticate your account`. +4. Click `Authenticate your Amazon Ads account`. 5. Log in and Authorize to the Amazon account. 6. Select **Region** to pull data from **North America (NA)**, **Europe (EU)**, **Far East (FE)** or **Sandbox Environment**. See [docs](https://advertising.amazon.com/API/docs/en-us/info/api-overview#api-endpoints) for more details. 7. **Report Wait Timeout** is the maximum number of minutes the connector waits for the generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. From 034cae08f065feff03ebabe42d4e0766cd05afab Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Sun, 8 May 2022 08:51:11 +0300 Subject: [PATCH 17/19] improve docs Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index 0486eeb04611..a57ab4c1c9c9 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -30,7 +30,7 @@ To use the [Amazon Ads API](https://advertising.amazon.com/API/docs/en-us), you 6. Select **Region** to pull data from **North America (NA)**, **Europe (EU)**, **Far East (FE)** or **Sandbox Environment**. See [docs](https://advertising.amazon.com/API/docs/en-us/info/api-overview#api-endpoints) for more details. 7. **Report Wait Timeout** is the maximum number of minutes the connector waits for the generation of a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. 8. **Report Generation Maximum Retries** is the maximum number of attempts the connector tries to generate a report for streams `Brands Reports`, `Brand Video Reports`, `Display Reports`, `Products Reports`. -9. **Start Date (Optional)** used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today date is used. Date for specific profile is calculated according to its timezone, this parameter should be specified in UTC timezone. Since it have no sense of generate report for current day \(metrics could be changed\) it generates report for day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as `reportDate` parameter for request\). +9. **Start Date (Optional)** is used for generating reports starting from the specified start date. Should be in YYYY-MM-DD format and not more than 60 days in the past. If not specified today's date is used. The date for a specific profile is calculated according to its timezone, this parameter should be specified in the UTC timezone. Since it has no sense of generating report for the current day \(metrics could be changed\) it generates report for the day before \(e.g. if **Start Date** is 2021-10-11 it would use 20211010 as `reportDate` parameter for request\). 10. **Profile IDs (Optional)** you want to fetch data for. See [docs](https://advertising.amazon.com/API/docs/en-us/concepts/authorization/profiles) for more details. 11. Click `Set up source`. From 7847aa7481de8d3529ef737442c62b2eb4009c5d Mon Sep 17 00:00:00 2001 From: Sergey Chvalyuk Date: Sun, 8 May 2022 08:54:45 +0300 Subject: [PATCH 18/19] fix docs Signed-off-by: Sergey Chvalyuk --- docs/integrations/sources/amazon-ads.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/amazon-ads.md b/docs/integrations/sources/amazon-ads.md index a57ab4c1c9c9..8bfbb4fedf26 100644 --- a/docs/integrations/sources/amazon-ads.md +++ b/docs/integrations/sources/amazon-ads.md @@ -69,7 +69,7 @@ This source is capable of syncing the following streams: ## Connector-specific features and highlights -All the reports are generated for day before relatively to target profile' timezone +All the reports are generated for the day before relatively to the target profile' timezone ## Performance considerations From 5e9b87b7bc60c0a21827f64abe9958ffa9d09670 Mon Sep 17 00:00:00 2001 From: Octavia Squidington III Date: Sun, 8 May 2022 06:16:27 +0000 Subject: [PATCH 19/19] auto-bump connector version --- .../init/src/main/resources/seed/source_definitions.yaml | 2 +- airbyte-config/init/src/main/resources/seed/source_specs.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/airbyte-config/init/src/main/resources/seed/source_definitions.yaml b/airbyte-config/init/src/main/resources/seed/source_definitions.yaml index cc7c4bd9dadc..259b01f7f606 100644 --- a/airbyte-config/init/src/main/resources/seed/source_definitions.yaml +++ b/airbyte-config/init/src/main/resources/seed/source_definitions.yaml @@ -17,7 +17,7 @@ - name: Amazon Ads sourceDefinitionId: c6b0a29e-1da9-4512-9002-7bfd0cba2246 dockerRepository: airbyte/source-amazon-ads - dockerImageTag: 0.1.8 + dockerImageTag: 0.1.9 documentationUrl: https://docs.airbyte.io/integrations/sources/amazon-ads icon: amazonads.svg sourceType: api diff --git a/airbyte-config/init/src/main/resources/seed/source_specs.yaml b/airbyte-config/init/src/main/resources/seed/source_specs.yaml index 08f824a97d7f..6599385527d1 100644 --- a/airbyte-config/init/src/main/resources/seed/source_specs.yaml +++ b/airbyte-config/init/src/main/resources/seed/source_specs.yaml @@ -87,7 +87,7 @@ supportsNormalization: false supportsDBT: false supported_destination_sync_modes: [] -- dockerImage: "airbyte/source-amazon-ads:0.1.8" +- dockerImage: "airbyte/source-amazon-ads:0.1.9" spec: documentationUrl: "https://docs.airbyte.com/integrations/sources/amazon-ads" connectionSpecification: