@pipedream/google_ads 0.8.0 → 1.0.0

package/actions/create-or-update-campaign/create-or-update-campaign.mjs

@@ -2,20 +2,25 @@ import { ConfigurationError } from "@pipedream/platform";
 import googleAds from "../../google_ads.app.mjs";
 import {
   ADVERTISING_CHANNEL_TYPES,
+  CAMPAIGN_BIDDING_STRATEGY_TYPES,
   CAMPAIGN_OPERATION_TYPES,
   CAMPAIGN_STATUSES,
+  EU_POLITICAL_ADVERTISING_STATUSES,
 } from "../../common/constants.mjs";
 import { parseObject } from "../../common/utils.mjs";
 import { getAdditionalFields } from "../common/props.mjs";
+import {
+  buildBiddingScheme, CAMPAIGN_BIDDING_SCHEMES, getSchemeProps,
+} from "../common/bidding.mjs";
 
 const docLink =
-  "https://developers.google.com/google-ads/api/reference/rpc/v21/CampaignService/MutateCampaigns?transport=rest";
+  "https://developers.google.com/google-ads/api/reference/rpc/v25/CampaignService/MutateCampaigns?transport=rest";
 
 export default {
   key: "google_ads-create-or-update-campaign",
   name: "Create or Update Campaign",
   description: `Creates or updates a campaign. [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "1.0.0",
   type: "action",
   annotations: {
     destructiveHint: true,
@@ -96,18 +101,18 @@ export default {
       options: CAMPAIGN_STATUSES,
       optional: true,
     },
-    startDate: {
+    startDateTime: {
       type: "string",
-      label: "Start Date",
+      label: "Start Date Time",
       description:
-        "The date when the campaign starts serving ads, formatted as `YYYY-MM-DD`.",
+        "When the campaign starts serving ads, in the account's time zone, formatted as `YYYY-MM-DD HH:MM:SS` (use `00:00:00` for daily granularity).",
       optional: true,
     },
-    endDate: {
+    endDateTime: {
       type: "string",
-      label: "End Date",
+      label: "End Date Time",
       description:
-        "The last day the campaign serves ads, formatted as `YYYY-MM-DD`. Leave blank for no end date.",
+        "The last day and time the campaign serves ads, in the account's time zone, formatted as `YYYY-MM-DD HH:MM:SS` (use `23:59:59` for daily granularity). Leave blank to run indefinitely.",
       optional: true,
     },
     trackingUrlTemplate: {
@@ -116,6 +121,36 @@ export default {
       description: "The URL template for constructing a tracking URL.",
       optional: true,
     },
+    containsEuPoliticalAdvertising: {
+      type: "string",
+      label: "Contains EU Political Advertising",
+      description: "Declares whether the campaign contains EU political advertising. Google requires this on **create**.",
+      options: EU_POLITICAL_ADVERTISING_STATUSES,
+      optional: true,
+    },
+    biddingStrategy: {
+      propDefinition: [
+        googleAds,
+        "biddingStrategyId",
+        ({
+          accountId, customerClientId,
+        }) => ({
+          accountId,
+          customerClientId,
+        }),
+      ],
+      label: "Portfolio Bidding Strategy",
+      description: "An existing portfolio bidding strategy to attach. Leave blank to use a standard (campaign-level) strategy instead.",
+      optional: true,
+    },
+    biddingStrategyType: {
+      type: "string",
+      label: "Standard Bidding Strategy",
+      description: "The campaign-level bidding strategy. Google requires either this or a **Portfolio Bidding Strategy** on **create**.",
+      options: CAMPAIGN_BIDDING_STRATEGY_TYPES,
+      optional: true,
+    },
+    ...getSchemeProps(CAMPAIGN_BIDDING_SCHEMES),
     additionalFields: getAdditionalFields(docLink),
   },
   async run({ $ }) {
@@ -130,9 +165,12 @@ export default {
       advertisingChannelType,
       campaignBudget,
       status,
-      startDate,
-      endDate,
+      startDateTime,
+      endDateTime,
       trackingUrlTemplate,
+      containsEuPoliticalAdvertising,
+      biddingStrategy,
+      biddingStrategyType,
       additionalFields,
     } = this;
 
@@ -148,7 +186,19 @@ export default {
       );
     }
 
+    // `campaign_bidding_strategy` is a union field.
+    if (biddingStrategy && biddingStrategyType) {
+      throw new ConfigurationError(
+        "Set either **Portfolio Bidding Strategy** or **Standard Bidding Strategy**, not both.",
+      );
+    }
+
     if (operationType === "create") {
+      if (!containsEuPoliticalAdvertising) {
+        throw new ConfigurationError(
+          "**Contains EU Political Advertising** is required for Create operations.",
+        );
+      }
       if (!name) {
         throw new ConfigurationError(
           "**Name** is required for Create operations.",
@@ -194,15 +244,22 @@ export default {
         ...(status && {
           status,
         }),
-        ...(startDate && {
-          startDate,
+        ...(startDateTime && {
+          startDateTime,
         }),
-        ...(endDate && {
-          endDate,
+        ...(endDateTime && {
+          endDateTime,
         }),
         ...(trackingUrlTemplate && {
           trackingUrlTemplate,
         }),
+        ...(containsEuPoliticalAdvertising && {
+          containsEuPoliticalAdvertising,
+        }),
+        ...(biddingStrategy && {
+          biddingStrategy: `customers/${customerId}/biddingStrategies/${biddingStrategy}`,
+        }),
+        ...buildBiddingScheme(CAMPAIGN_BIDDING_SCHEMES, biddingStrategyType, this),
         ...parseObject(additionalFields),
       };
 

package/actions/create-or-update-campaign-budget/create-or-update-campaign-budget.mjs

@@ -9,13 +9,13 @@ import { parseObject } from "../../common/utils.mjs";
 import { getAdditionalFields } from "../common/props.mjs";
 
 const docLink =
-  "https://developers.google.com/google-ads/api/reference/rpc/v21/CampaignBudgetService/MutateCampaignBudgets?transport=rest";
+  "https://developers.google.com/google-ads/api/reference/rpc/v25/CampaignBudgetService/MutateCampaignBudgets?transport=rest";
 
 export default {
   key: "google_ads-create-or-update-campaign-budget",
   name: "Create or Update Campaign Budget",
   description: `Creates, updates, or removes a campaign budget. [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: true,

package/actions/create-or-update-keywords/create-or-update-keywords.mjs

@@ -9,13 +9,13 @@ import { parseObject } from "../../common/utils.mjs";
 import { getAdditionalFields } from "../common/props.mjs";
 
 const docLink =
-  "https://developers.google.com/google-ads/api/reference/rpc/v21/AdGroupCriterionService/MutateAdGroupCriteria?transport=rest";
+  "https://developers.google.com/google-ads/api/reference/rpc/v25/AdGroupCriterionService/MutateAdGroupCriteria?transport=rest";
 
 export default {
   key: "google_ads-create-or-update-keywords",
   name: "Create, Update, or Remove Keywords",
   description: `Creates, updates, or removes keyword criteria for an ad group. [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: true,

package/actions/create-or-update-shared-sets/create-or-update-shared-sets.mjs

@@ -8,13 +8,13 @@ import { parseObject } from "../../common/utils.mjs";
 import { getAdditionalFields } from "../common/props.mjs";
 
 const docLink =
-  "https://developers.google.com/google-ads/api/reference/rpc/v21/SharedSetService/MutateSharedSets?transport=rest";
+  "https://developers.google.com/google-ads/api/reference/rpc/v25/SharedSetService/MutateSharedSets?transport=rest";
 
 export default {
   key: "google_ads-create-or-update-shared-sets",
   name: "Create or Update Shared Sets",
   description: `Creates or updates shared sets (reusable lists of negative keywords or placements). [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: true,

package/actions/create-report/create-report.mjs

@@ -19,8 +19,8 @@ export default {
   ...common,
   key: "google_ads-create-report",
   name: "Create Report",
-  description: "Generates a report from your Google Ads data. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.2.1",
+  description: "Generates a report from your Google Ads data. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.3.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -99,7 +99,7 @@ export default {
     segments: {
       type: "string[]",
       label: "Segments",
-      description: "Segment field names to include (e.g. `[\"date\"]` or `[\"segments.date\"]`). See the documentation [here](https://developers.google.com/google-ads/api/reference/rpc/v21/Segments).",
+      description: "Segment field names to include (e.g. `[\"date\"]` or `[\"segments.date\"]`). See the documentation [here](https://developers.google.com/google-ads/api/reference/rpc/v25/Segments).",
       options() {
         const resource = RESOURCES.find((r) => r.resourceOption.value === this.resource);
         if (!resource) throw new ConfigurationError("Select one of the available resources.");
@@ -113,7 +113,7 @@ export default {
     metrics: {
       type: "string[]",
       label: "Metrics",
-      description: "Metric field names to include (e.g. `[\"impressions\", \"clicks\"]` or `[\"metrics.impressions\", \"metrics.clicks\"]`). See the documentation [here](https://developers.google.com/google-ads/api/reference/rpc/v21/Metrics).",
+      description: "Metric field names to include (e.g. `[\"impressions\", \"clicks\"]` or `[\"metrics.impressions\", \"metrics.clicks\"]`). See the documentation [here](https://developers.google.com/google-ads/api/reference/rpc/v25/Metrics).",
       options() {
         const resource = RESOURCES.find((r) => r.resourceOption.value === this.resource);
         if (!resource) throw new ConfigurationError("Select one of the available resources.");
@@ -256,9 +256,7 @@ export default {
       $,
       accountId: this.accountId,
       customerClientId: this.customerClientId,
-      data: {
-        query,
-      },
+      query,
     })) ?? [];
 
     const { length } = results;

package/actions/create-responsive-search-ad/create-responsive-search-ad.mjs

@@ -29,7 +29,7 @@ export default {
   key: "google_ads-create-responsive-search-ad",
   name: "Create Responsive Search Ad",
   description: `Creates a Responsive Search Ad (RSA) in an ad group. RSA copy (headlines, descriptions) cannot be edited in-place after creation — to change ad copy, remove the existing ad and create a new one. URL fields (\`finalUrls\`, \`trackingUrlTemplate\`, etc.) can be updated in-place via the **Create or Update Ad Group Ad** action. [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/generate-keyword-ideas/generate-keyword-ideas.mjs

@@ -3,13 +3,13 @@ import { getAdditionalFields } from "../common/props.mjs";
 import {
   parseObject, parseStringObject,
 } from "../../common/utils.mjs";
-const docLink = "https://developers.google.com/google-ads/api/reference/rpc/v22/KeywordPlanIdeaService/GenerateKeywordIdeas?transport=rest";
+const docLink = "https://developers.google.com/google-ads/api/reference/rpc/v25/KeywordPlanIdeaService/GenerateKeywordIdeas?transport=rest";
 
 export default {
   key: "google_ads-generate-keyword-ideas",
   name: "Generate Keyword Ideas",
   description: `Generate keyword ideas using the Google Ads API. [See the documentation](${docLink})`,
-  version: "0.0.4",
+  version: "0.1.0",
   type: "action",
   annotations: {
     destructiveHint: false,
@@ -32,7 +32,7 @@ export default {
           accountId,
         }),
       ],
-      optional: false,
+      optional: true,
     },
     additionalFields: {
       ...getAdditionalFields(docLink),

package/actions/get-keyword-quality-scores/get-keyword-quality-scores.mjs

@@ -3,13 +3,13 @@ import googleAds from "../../google_ads.app.mjs";
 import { DATE_RANGE_OPTIONS } from "../../common/constants.mjs";
 
 const docLink =
-  "https://developers.google.com/google-ads/api/fields/v21/keyword_view";
+  "https://developers.google.com/google-ads/api/fields/v25/keyword_view";
 
 export default {
   key: "google_ads-get-keyword-quality-scores",
   name: "Get Keyword Quality Scores",
   description: `Retrieves current and historical quality score data (Quality Score, Ad Relevance, Landing Page Experience, Expected CTR) for keywords in a customer account. Current scores reflect the latest evaluation; historical scores are averaged over the selected date range. [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-account-id-options/list-account-id-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "google_ads-list-account-id-options",
   name: "List Account ID Options",
   description: "Retrieves available options for the Account ID field.",
-  version: "0.0.3",
+  version: "0.0.4",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-ad-group-ads/list-ad-group-ads.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-ad-group-ads",
   name: "List Ad Group Ads",
-  description: "List ads within ad groups for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List ads within ad groups for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-ad-group-criteria/list-ad-group-criteria.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-ad-group-criteria",
   name: "List Ad Group Criteria",
-  description: "List criteria (keywords, placements, audiences, etc.) for ad groups in a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List criteria (keywords, placements, audiences, etc.) for ad groups in a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-ad-groups/list-ad-groups.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-ad-groups",
   name: "List Ad Groups",
-  description: "List ad groups for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List ad groups for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-bidding-strategies/list-bidding-strategies.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-bidding-strategies",
   name: "List Bidding Strategies",
-  description: "List portfolio bidding strategies for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List portfolio bidding strategies for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-campaign-budgets/list-campaign-budgets.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-campaign-budgets",
   name: "List Campaign Budgets",
-  description: "List campaign budgets for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List campaign budgets for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-campaign-criteria/list-campaign-criteria.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-campaign-criteria",
   name: "List Campaign Criteria",
-  description: "List criteria (keywords, placements, etc.) for campaigns in a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List criteria (keywords, placements, etc.) for campaigns in a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-campaign-shared-sets/list-campaign-shared-sets.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-campaign-shared-sets",
   name: "List Campaign Shared Sets",
-  description: "List shared sets attached to campaigns for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List shared sets attached to campaigns for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-campaigns/list-campaigns.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-campaigns",
   name: "List Campaigns",
-  description: "List campaigns for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List campaigns for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "1.0.0",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-customer-clients/list-customer-clients.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-customer-clients",
   name: "List Customer Clients",
-  description: "List all customer clients for a given account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.2",
+  description: "List all customer clients for a given account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-keywords/list-keywords.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-keywords",
   name: "List Keywords",
-  description: "List keyword criteria for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List keyword criteria for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-shared-criteria/list-shared-criteria.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-shared-criteria",
   name: "List Shared Criteria",
-  description: "List criteria within shared sets for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List criteria within shared sets for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-shared-sets/list-shared-sets.mjs

@@ -3,8 +3,8 @@ import googleAds from "../../google_ads.app.mjs";
 export default {
   key: "google_ads-list-shared-sets",
   name: "List Shared Sets",
-  description: "List shared sets for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/GoogleAdsService/Search?transport=rest)",
-  version: "0.0.1",
+  description: "List shared sets for a customer account. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/GoogleAdsService/Search?transport=rest)",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/send-offline-conversion/send-offline-conversion.mjs

@@ -7,8 +7,8 @@ export default {
   ...common,
   key: "google_ads-send-offline-conversion",
   name: "Send Offline Conversion",
-  description: "Send an event to Google Ads to track offline conversions. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionAction)",
-  version: "0.0.10",
+  description: "Create a Google Ads conversion action. To record conversions against an upload-type action, use **Upload Click Conversion** or **Upload Call Conversion**. [See the documentation](https://developers.google.com/google-ads/api/reference/rpc/v25/ConversionAction)",
+  version: "0.0.11",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -25,10 +25,10 @@ export default {
     type: {
       type: "string",
       label: "Type",
-      description: "[The type](https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionActionTypeEnum.ConversionActionType) of the conversion action.",
+      description: "[The type](https://developers.google.com/google-ads/api/reference/rpc/v25/ConversionActionTypeEnum.ConversionActionType) of the conversion action.",
       options: CONVERSION_TYPE_OPTIONS,
     },
-    additionalFields: getAdditionalFields("https://developers.google.com/google-ads/api/reference/rpc/v21/ConversionAction"),
+    additionalFields: getAdditionalFields("https://developers.google.com/google-ads/api/reference/rpc/v25/ConversionAction"),
   },
   async run({ $ }) {
     const {

package/actions/update-campaign-ai-max-settings/update-campaign-ai-max-settings.mjs

@@ -11,7 +11,7 @@ export default {
   key: "google_ads-update-campaign-ai-max-settings",
   name: "Update Campaign AI Max Settings",
   description: `Enables or configures AI Max for Search settings on a campaign. Only supported on Search campaigns. Toggling AI Max while simultaneously editing brand or text customization settings on the same campaign may fail — update them separately. Ad group-level search term matching is controlled via the **Create or Update Ad Group** action. [See the documentation](${docLink})`,
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/upload-call-conversion/upload-call-conversion.mjs

@@ -0,0 +1,65 @@
+import {
+  buildBaseConversion, commonProps, DATE_TIME_HINT, DOC_LINK, uploadConversion,
+} from "../common/conversion-upload.mjs";
+
+const CALL_DOC_LINK = `${DOC_LINK}/UploadCallConversions?transport=rest`;
+
+export default {
+  key: "google_ads-upload-call-conversion",
+  name: "Upload Call Conversion",
+  description: `Uploads an offline conversion attributed to a phone call. [See the documentation](${CALL_DOC_LINK})`,
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  props: {
+    ...commonProps,
+    callerId: {
+      type: "string",
+      label: "Caller ID",
+      description: "The phone number the call was placed from, in E.164 format with a leading `+` (e.g. `+16502531234`).",
+    },
+    callStartDateTime: {
+      type: "string",
+      label: "Call Start Date Time",
+      description: `When the call occurred. Must be before the conversion. ${DATE_TIME_HINT}`,
+    },
+  },
+  async run({ $ }) {
+    const {
+      googleAds,
+      accountId,
+      customerClientId,
+      callerId,
+      callStartDateTime,
+      validateOnly,
+    } = this;
+
+    const conversion = {
+      ...buildBaseConversion(this),
+      callerId,
+      callStartDateTime,
+    };
+
+    const response = await uploadConversion({
+      $,
+      googleAds,
+      method: "uploadCallConversions",
+      accountId,
+      customerClientId,
+      conversion,
+      validateOnly,
+    });
+
+    $.export(
+      "$summary",
+      validateOnly
+        ? "Call conversion payload validated successfully (not recorded)."
+        : "Successfully uploaded call conversion.",
+    );
+    return response;
+  },
+};