diff --git a/components/google_ads/README.md b/components/google_ads/README.md index 6f057ee6b7215..6618a428ffcf7 100644 --- a/components/google_ads/README.md +++ b/components/google_ads/README.md @@ -18,3 +18,44 @@ and campaigns programmatically. With the API, you can automate common tasks, such as creating and managing campaigns, adding and removing keywords, and adjusting bids. You can also use the API to get information about your campaigns, such as campaign stats, keyword stats, and ad performance. + +## Customizing API requests with the Pipedream proxy + +The Pipedream components interact with Google Ads API through Pipedream's proxy service, which handles authentication and developer token requirements. + +The component accepts a standard Google Ads API request object with the following structure: + +```javascript +const googleAdsReq = { + method: "get|post|put|delete", // HTTP method + url: "/v16/...", // Google Ads API endpoint path + headers: { + "Authorization": `Bearer ${this.googleAds.$auth.oauth_access_token}` + }, + data: {} // Optional request body for POST/PUT requests +} +``` + +To make different API calls while using the proxy: + +1. Modify the `url` path to match your desired Google Ads API endpoint +2. Update the `method` to match the required HTTP method +3. Add any necessary request body data in the `data` field +4. Include any required headers (Authorization is automatically included) + +Example for a custom query: + +```javascript +const googleAdsReq = { + method: "post", + url: "/v16/customers/1234567890/googleAds:search", + headers: { + "Authorization": `Bearer ${this.googleAds.$auth.oauth_access_token}` + }, + data: { + query: "SELECT campaign.id, campaign.name FROM campaign" + } +} +``` + +The proxy endpoint will remain the same: `https://eolid4dq1k0t9hi.m.pipedream.net` \ No newline at end of file diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 16f96130ec058..c6615afc1a974 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -7620,8 +7620,7 @@ importers: specifier: ^1.5.1 version: 1.6.6 - components/pingone: - specifiers: {} + components/pingone: {} components/pingrabbit: {} @@ -24492,22 +24491,22 @@ packages: superagent@3.8.1: resolution: {integrity: sha512-VMBFLYgFuRdfeNQSMLbxGSLfmXL/xc+OO+BZp41Za/NRDBet/BNbkRJrYzCUu0u4GU0i/ml2dtT8b9qgkw9z6Q==} engines: {node: '>= 4.0'} - deprecated: Please upgrade to v9.0.0+ as we have fixed a public vulnerability with formidable dependency. Note that v9.0.0+ requires Node.js v14.18.0+. See https://github.com/ladjs/superagent/pull/1800 for insight. This project is supported and maintained by the team at Forward Email @ https://forwardemail.net + deprecated: Please upgrade to v7.0.2+ of superagent. We have fixed numerous issues with streams, form-data, attach(), filesystem errors not bubbling up (ENOENT on attach()), and all tests are now passing. See the releases tab for more information at . superagent@4.1.0: resolution: {integrity: sha512-FT3QLMasz0YyCd4uIi5HNe+3t/onxMyEho7C3PSqmti3Twgy2rXT4fmkTz6wRL6bTF4uzPcfkUCa8u4JWHw8Ag==} engines: {node: '>= 6.0'} - deprecated: Please upgrade to v9.0.0+ as we have fixed a public vulnerability with formidable dependency. Note that v9.0.0+ requires Node.js v14.18.0+. See https://github.com/ladjs/superagent/pull/1800 for insight. This project is supported and maintained by the team at Forward Email @ https://forwardemail.net + deprecated: Please upgrade to v7.0.2+ of superagent. We have fixed numerous issues with streams, form-data, attach(), filesystem errors not bubbling up (ENOENT on attach()), and all tests are now passing. See the releases tab for more information at . superagent@5.3.1: resolution: {integrity: sha512-wjJ/MoTid2/RuGCOFtlacyGNxN9QLMgcpYLDQlWFIhhdJ93kNscFonGvrpAHSCVjRVj++DGCglocF7Aej1KHvQ==} engines: {node: '>= 7.0.0'} - deprecated: Please upgrade to v9.0.0+ as we have fixed a public vulnerability with formidable dependency. Note that v9.0.0+ requires Node.js v14.18.0+. See https://github.com/ladjs/superagent/pull/1800 for insight. This project is supported and maintained by the team at Forward Email @ https://forwardemail.net + deprecated: Please upgrade to v7.0.2+ of superagent. We have fixed numerous issues with streams, form-data, attach(), filesystem errors not bubbling up (ENOENT on attach()), and all tests are now passing. See the releases tab for more information at . superagent@7.1.6: resolution: {integrity: sha512-gZkVCQR1gy/oUXr+kxJMLDjla434KmSOKbx5iGD30Ql+AkJQ/YlPKECJy2nhqOsHLjGHzoDTXNSjhnvWhzKk7g==} engines: {node: '>=6.4.0 <13 || >=14'} - deprecated: Please upgrade to v9.0.0+ as we have fixed a public vulnerability with formidable dependency. Note that v9.0.0+ requires Node.js v14.18.0+. See https://github.com/ladjs/superagent/pull/1800 for insight. This project is supported and maintained by the team at Forward Email @ https://forwardemail.net + deprecated: Please downgrade to v7.1.5 if you need IE/ActiveXObject support OR upgrade to v8.0.0 as we no longer support IE and published an incorrect patch version (see https://github.com/visionmedia/superagent/issues/1731) supports-color@2.0.0: resolution: {integrity: sha512-KKNVtd6pCYgPIKU4cp2733HWYCpplQhddZLBUryaAHou723x+FRzQ5Df824Fj+IyyuiQTRoub4SnIFfIcrp70g==}