✨ Source Pinterest: Add Account ID parameter and stream filter

[karolur]

What

This PR introduces an Account Id filter for the Pinterest source connector.

• Users can now specify an Account Id to fetch data only for that particular account.
• Some organizations have access restrictions that limit data retrieval to a single ad account, making it necessary to filter at the source.
• Previously, the connector always fetched data for all accessible accounts, which was not always desirable for teams with stricter data permissions.

🔗 Related Discussion: Airbyte Discussion #52036

How

1. Modified the connector's stream logic to accept and process an account_id if provided.
2. Introduced AdAccountValidationStream to validate the provided account_id before proceeding with data retrieval.
3. Implemented AdAccountRecordExtractor to handle both scenarios—fetching data for a single account or all accounts—ensuring correct processing based on user input.

Review guide

1. source_pinterest/source.py → Updated SourcePinterest to validate account_id in _validate_and_transform.
2. source_pinterest/streams.py → Added AdAccountValidationStream to verify the existence of the specified account_id.
3. source_pinterest/components/components.py → Added AdAccountRecordExtractor to handle data extraction for single vs. multiple accounts.
4. source_pinterest/manifest.yaml → Updated connector specification to include account_id as an optional configuration parameter.
5. source_pinterest/components/error_mapping.py → Extended error handling to return meaningful errors for invalid account_id values.

User Impact

New Feature: Users can now filter Pinterest ad data by a specific account_id, ensuring more precise data retrieval.
Compliance-Friendly: Helps organizations align with data access policies by restricting API calls to only authorized accounts.
No Breaking Changes: Users who do not specify an Account Id will continue fetching all available data as before.

Can this PR be safely reverted and rolled back?

• YES 💚
• NO ❌

[vercel]

@karolur is attempting to deploy a commit to the Airbyte Growth Team on Vercel.

A member of the Team first needs to authorize it.

[CLAassistant]

All committers have signed the CLA.

[marcosmarxm]

/format-fix

Format-fix job started... Check job output.

✅ Changes applied successfully. (56a39da)

[marcosmarxm]

Hello 👋, I apologize if your contribution hasn't been reviewed or updated yet. I'm working to address the community contribution backlog. I created this GitHub project to help you understand when to expect a review. This week, my goal is to complete all contributions related to Marketplace and Manifest-only connectors. Next week, I will focus on API Certified Connectors, followed by DB Java Connector contributions. If you have any questions about your contribution, please feel free to send me a direct message in the Airbyte Community Slack (and include the link to your pull request).

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
airbyte-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 18, 2025 11:55pm

[marcosmarxm]

The change looks good to me. I'm running integration tests and need to wait until their done and all green. After need final approval from connector team to introduce this feature to Pinterest connector.