Changelog, readme & setup.py changes.

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 3.0.0
+  * Bump to API version `202309`
+  * Removed `FIELDS_UNACCEPTED_BY_API` beta fields & updated integration tests.
+  * Updated schema, replication key & primary key for "video_ads" stream
+  * Updated path for streams "campaign_groups", "campaigns", "creatives" & "video_ads"
+  * Unit & integration tests updated for version bump
+  * [#64](https://github.com/singer-io/tap-linkedin-ads/pull/64)
+  * [#65](https://github.com/singer-io/tap-linkedin-ads/pull/65)
+
 ## 2.1.0
   * Bump to API version `202302`
   * Move and update `FIELDS_UNACCEPTED_BY_API`

README.md

@@ -6,7 +6,7 @@ spec](https://github.com/singer-io/getting-started/blob/master/SPEC.md).
 
 This tap:
 
-- Pulls raw data from the [LinkedIn Marketing Ads July 2022](https://docs.microsoft.com/en-us/linkedin/marketing/)
+- Pulls raw data from the [LinkedIn Marketing Ads October 2023](https://docs.microsoft.com/en-us/linkedin/marketing/)
 - Extracts the following resources:
   - [Ad Accounts](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-accounts#search-for-accounts)
     - [Video Ads](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/advertising-targeting/create-and-manage-video#finders)
@@ -31,14 +31,14 @@ This tap:
 - Transformations: Fields camelCase to snake_case. URNs to ids. Unix epoch millisecond integers to date-times. Audit date-times created_at and last_modified_at de-nested. String to decimal for total_budget field.
 - Children: video_ads
 
-[**video_ads**](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/advertising-targeting/create-and-manage-video#finders)
-- Endpoint: https://api.linkedin.com/rest/adDirectSponsoredContents
-- Primary key field: content_reference
+[**video_ads**](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/community-management/shares/posts-api?view=li-lms-2023-10&tabs=http#find-posts-by-account-1)
+- Endpoint: https://api.linkedin.com/rest/posts
+- Primary key field: id
 - Foreign keys: account_id (accounts), owner_organization_id (organizations)
 - Replication strategy: Incremental (query all, filter results)
   - Filter: account (from parent account) and owner (from parent account) (see NOTE below)
-  - Bookmark: last_modified_time (date-time)
-- Transformations: Fields camelCase to snake_case. URNs to ids. Unix epoch millisecond integers to date-times. Audit date-times created_at and last_modified_at de-nested.
+  - Bookmark: last_modified_at (date-time)
+- Transformations: Fields camelCase to snake_case. URNs to ids. Unix epoch millisecond integers to date-times. Ad context fields dsc_status, dsc_name, dsc_ad_type & dsc_ad_account de-nested.
 - Parent: account
 **NOTE**: The parent Account **MUST** reference and **Organization** (not a Person)
 - [Campaign Manager User Roles for Video Ads](https://www.linkedin.com/help/lms/answer/90733/campaign-manager-user-roles-for-video-ads?lang=en)
@@ -53,7 +53,7 @@ This tap:
 - Transformations: Fields camelCase to snake_case. URNs to ids. Unix epoch millisecond integers to date-times. Audit date-times created_at and last_modified_at de-nested.
 
 [**campaign_groups**](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-campaign-groups#search-for-campaign-groups)
-- Endpoint: https://api.linkedin.com/rest/adCampaignGroups
+- Endpoint: https://api.linkedin.com/rest/adAccounts/{account-id}/adCampaignGroups
 - Primary key field: id
 - Foreign keys: account_id (accounts)
 - Replication strategy: Incremental (query all, filter results)
@@ -63,7 +63,7 @@ This tap:
 - Transformations: Fields camelCase to snake_case. URNs to ids. Unix epoch millisecond integers to date-times. Audit date-times created_at and last_modified_at de-nested.
 
 [**campaigns**](https://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-campaigns#search-for-campaigns)
-- Endpoint: https://api.linkedin.com/rest/adCampaigns
+- Endpoint: https://api.linkedin.com/rest/adAccounts/{account-id}/adCampaigns
 - Primary key field: id
 - Foreign keys: account_id (accounts)
 - Replication strategy: Incremental (query all, filter results)
@@ -74,7 +74,7 @@ This tap:
 - Children: creatives, ad_analytics_by_campaign, ad_analytics_by_creative
 
 [**creatives**](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads/account-structure/create-and-manage-creatives?view=li-lms-2023-01&tabs=http#search-for-creatives)
-- Endpoint: https://api.linkedin.com/rest/creatives
+- Endpoint: https://api.linkedin.com/rest/adAccounts/{account-id}/creatives
 - Primary key field: id
 - Foreign keys: campaign_id (campaigns)
 - Replication strategy: Incremental (query all, filter results)

setup.py

@@ -3,7 +3,7 @@
 from setuptools import setup, find_packages
 
 setup(name='tap-linkedin-ads',
-      version='2.1.0',
+      version='3.0.0',
       description='Singer.io tap for extracting data from the LinkedIn Marketing Ads API API 2.0',
       author='[email protected]',
       classifiers=['Programming Language :: Python :: 3 :: Only'],