Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Google Ads - update to api v18 #15591

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Google Ads - update to api v18 #15591

wants to merge 2 commits into from

Conversation

michelle0927
Copy link
Collaborator

@michelle0927 michelle0927 commented Feb 12, 2025

Resolves #15559

Summary by CodeRabbit

  • Documentation
    • Updated all Google Ads API documentation links to reference the latest v18 endpoints.
  • Chores
    • Incremented version numbers for multiple components.
    • Aligned API endpoint configurations with the updated Google Ads API version.

Copy link

vercel bot commented Feb 12, 2025

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

3 Skipped Deployments
Name Status Preview Comments Updated (UTC)
docs-v2 ⬜️ Ignored (Inspect) Feb 12, 2025 7:25pm
pipedream-docs ⬜️ Ignored (Inspect) Feb 12, 2025 7:25pm
pipedream-docs-redirect-do-not-edit ⬜️ Ignored (Inspect) Feb 12, 2025 7:25pm

Copy link
Contributor

coderabbitai bot commented Feb 12, 2025

Walkthrough

This pull request updates several components of the Google Ads integration. The changes include version bumps, documentation URL updates from v16 to v18, changes to API endpoint paths, and a new conditional check in the customer list creation action. Additionally, dependency versions in the package configuration and minor adjustments to property requirements in event sources have been modified.

Changes

Files Change Summary
components/google_ads/actions/.../add-contact-to-list-by-email.mjs Updated version from "0.1.1" to "0.1.2".
components/google_ads/actions/common/props.mjs, components/google_ads/actions/create-customer-list/common-constants.mjs Updated documentation URLs in constants from v16 to v18.
components/google_ads/actions/create-customer-list/create-customer-list.mjs Bumped version from "0.0.2" to "0.0.3", updated description and listType documentation, and added a conditional check in additionalProps.
components/google_ads/actions/create-report/create-report.mjs Incremented version from "0.1.0" to "0.1.1" and updated documentation URLs in description, docsAlert, segments, and metrics.
components/google_ads/actions/send-offline-conversion/send-offline-conversion.mjs Bumped version from "0.0.2" to "0.0.3" and updated documentation links in description, type field, and additionalFields.
components/google_ads/.../google_ads.app.mjs Updated API endpoint paths and documentation references from v16 to v18 for multiple methods and properties.
components/google_ads/package.json Updated package version from "0.3.0" to "0.3.1" and dependency @pipedream/platform from "^1.6.5" to "^3.0.3".
components/google_ads/sources/new-campaign-created/*.mjs, components/google_ads/sources/new-lead-form-entry/*.mjs Bumped version from "0.0.2" to "0.0.3", updated documentation links from v16 to v18, and modified the customerClientId property requirement in new-campaign-created.

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant CreateCustomerListAction
  Client->>CreateCustomerListAction: Invoke additionalProps(payload)
  alt listType provided
    CreateCustomerListAction->>CreateCustomerListAction: Process additional properties
    CreateCustomerListAction-->>Client: Return processed properties
  else listType missing
    CreateCustomerListAction-->>Client: Return empty object
  end
Loading

Suggested labels

action

Suggested reviewers

  • GTFalcao

Poem

I'm a rabbit in the code field, hopping light and free,
Skipping through versions and docs with glee.
I found a check that guards the flow,
New links and updates help our code grow.
With a twitch of my nose, I celebrate these changes—hip, hip, hooray!
🐰✨

✨ Finishing Touches
  • 📝 Generate Docstrings (Beta)

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🔭 Outside diff range comments (1)
components/google_ads/google_ads.app.mjs (1)

96-98: ⚠️ Potential issue

Review the base URL configuration

The base URL appears to be pointing to a test endpoint (eolid4dq1k0t9hi.m.pipedream.net). This should be updated to the official Google Ads API endpoint for production use.

-    _baseUrl() {
-      return "https://eolid4dq1k0t9hi.m.pipedream.net";
-    },
+    _baseUrl() {
+      return "https://googleads.googleapis.com";
+    },
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9485ca2 and d8c6b91.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (10)
  • components/google_ads/actions/add-contact-to-list-by-email/add-contact-to-list-by-email.mjs (1 hunks)
  • components/google_ads/actions/common/props.mjs (1 hunks)
  • components/google_ads/actions/create-customer-list/common-constants.mjs (5 hunks)
  • components/google_ads/actions/create-customer-list/create-customer-list.mjs (3 hunks)
  • components/google_ads/actions/create-report/create-report.mjs (4 hunks)
  • components/google_ads/actions/send-offline-conversion/send-offline-conversion.mjs (2 hunks)
  • components/google_ads/google_ads.app.mjs (9 hunks)
  • components/google_ads/package.json (2 hunks)
  • components/google_ads/sources/new-campaign-created/new-campaign-created.mjs (1 hunks)
  • components/google_ads/sources/new-lead-form-entry/new-lead-form-entry.mjs (2 hunks)
✅ Files skipped from review due to trivial changes (3)
  • components/google_ads/actions/create-customer-list/common-constants.mjs
  • components/google_ads/actions/common/props.mjs
  • components/google_ads/actions/add-contact-to-list-by-email/add-contact-to-list-by-email.mjs
🧰 Additional context used
🪛 GitHub Check: Lint Code Base
components/google_ads/sources/new-campaign-created/new-campaign-created.mjs

[warning] 16-16:
Component prop customerClientId must have a label. See https://pipedream.com/docs/components/guidelines/#props


[warning] 16-16:
Component prop customerClientId must have a description. See https://pipedream.com/docs/components/guidelines/#props

⏰ Context from checks skipped due to timeout of 90000ms (3)
  • GitHub Check: pnpm publish
  • GitHub Check: Verify TypeScript components
  • GitHub Check: Publish TypeScript components
🔇 Additional comments (13)
components/google_ads/sources/new-campaign-created/new-campaign-created.mjs (2)

9-10: LGTM! Version bump and documentation update.

The version increment and documentation URL update align with the Google Ads API v18 migration.


22-22: LGTM! Documentation URL update.

The fields description correctly references the v18 API documentation.

components/google_ads/sources/new-lead-form-entry/new-lead-form-entry.mjs (2)

10-11: LGTM! Version bump and documentation update.

The version increment and documentation URL update align with the Google Ads API v18 migration.


32-32: LGTM! Documentation URLs update in docsAlert.

The docsAlert content correctly references the v18 API documentation for both submission fields and custom submission fields.

components/google_ads/actions/send-offline-conversion/send-offline-conversion.mjs (2)

10-11: LGTM! Version bump and documentation update.

The version increment and documentation URL update align with the Google Ads API v18 migration.


23-24: LGTM! Documentation URLs update.

The type description and additional fields correctly reference the v18 API documentation.

Also applies to: 26-26

components/google_ads/actions/create-customer-list/create-customer-list.mjs (3)

17-18: LGTM! Version bump and documentation update.

The version increment and documentation URL update align with the Google Ads API v18 migration.


36-37: LGTM! Documentation URL update.

The list type description correctly references the v18 API documentation.


96-98: LGTM! Improved error handling.

Good defensive programming practice to handle the case when listType is not provided.

components/google_ads/google_ads.app.mjs (1)

124-125: API paths correctly updated to v18

All API endpoint paths have been consistently updated to use the v18 version of the Google Ads API.

Also applies to: 135-136, 154-155, 219-220, 230-231, 237-238, 246-247

components/google_ads/actions/create-report/create-report.mjs (1)

21-22: Documentation links correctly updated to v18

All documentation references have been consistently updated to point to the v18 version of the Google Ads API documentation. Version bump is appropriate for the documentation updates.

Also applies to: 46-47, 109-110, 120-121

components/google_ads/package.json (2)

1-267: Verify all API endpoints after v18 upgrade

While the code changes look correct, it's important to verify that all API endpoints work as expected after the upgrade to v18.

❌ Verification inconclusive

🏁 Script executed:

#!/bin/bash
# Find all Google Ads API endpoint calls to ensure none were missed in the upgrade
rg -l "googleads.*v1[0-9]" .

Length of output: 30


Manual verification required for API endpoint version updates

The initial automated search using the pattern "googleads.*v1[0-9]" produced no results, which means we couldn’t conclusively verify the endpoint changes through this regex alone. Please manually verify that the endpoints—particularly those implemented in files like components/google_ads/google_ads.app.mjs—have been updated to v18 and work as expected after the upgrade.

  • Check that any API call URLs (e.g., those referencing googleads.googleapis.com or similar patterns) reflect the v18 endpoint.
  • Ensure integration tests or manual API tests cover these endpoints.

3-3: Verify compatibility with @pipedream/platform v3

The update includes a major version bump of the @pipedream/platform dependency from v1 to v3. This could potentially introduce breaking changes.

Please verify:

  1. That the codebase is compatible with the new platform version
  2. Review the changelog for any breaking changes

Also applies to: 16-17

❌ Verification inconclusive

🌐 Web query:

What are the breaking changes in @pipedream/platform v3.0.0?

💡 Result:

The provided search results do not explicitly mention breaking changes in @pipedream/platform v3.0.0. However, based on related updates and known issues from other versions and dependencies:

Key Potential Breaking Changes

  1. Axios Dependency Updates
    While not directly tied to v3.x.x of @pipedream/platform, earlier updates (e.g., Axios v1.x.x) introduced breaking changes affecting HTTP request handling[7]:

    • Query parameters appended via ? in URLs may fail unless explicitly defined using params.
    • Changes in error handling for non-2xx status codes (previously treated as resolved promises).
  2. Managed Authentication Changes
    The transition to OAuth-based authentication for services like GitHub might require adjustments in app prop configurations[1][2]:

    props: {
      github: {
        type: "app",
        app: "github", // Requires updated OAuth setup
      },
    },

Recommendations

  • Review dependency requirements (e.g., axios usage) and ensure compatibility with newer versions.
  • Verify authentication flows when using managed auth components[1][9].
  • Check for deprecated methods or configuration patterns in SDK calls[2][4].

For precise details on v3.x.x breaking changes, consult official Pipedream release notes or SDK documentation directly[10].

Citations:


Verify compatibility with @pipedream/platform v3

Based on the web query, there isn’t an explicit listing of breaking changes in v3. However, note that:

  • Axios Handling: Updates in dependencies (e.g., axios) may alter HTTP request behavior and error handling.
  • OAuth/Authentication Flows: Changes in managed authentication (e.g., transitioning to OAuth-based setups) might require adjustments in configuration.

Action Items:

  • Confirm that all integration points using the platform’s APIs properly handle any changes—especially around Axios request/response behavior and OAuth configurations.
  • Review the official Pipedream changelog/documentation (see https://changelog.pipedream.com/en) for any details that might impact your implementations.
  • Run integration tests to ensure the codebase continues to function as expected with the updated dependency.

Copy link
Collaborator

@luancazarine luancazarine left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @michelle0927, LGTM! Ready for QA!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Look into updating Google Ads API version
2 participants