@pipedream/google_ads 0.6.0 → 0.8.0

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by ad group name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllAdGroupCriteria({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} ad group ${items.length === 1
+        ? "criterion"
+        : "criteria"}.`,
+    );
+    return items;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter ad groups by name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllAdGroups({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const adGroups = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${adGroups.length} ad group${adGroups.length === 1
+        ? ""
+        : "s"}.`,
+    );
+    return adGroups;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by bidding strategy name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllBiddingStrategies({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} bidding strateg${items.length === 1
+        ? "y"
+        : "ies"}.`,
+    );
+    return items;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by campaign budget name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllCampaignBudgets({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} campaign budget${items.length === 1
+        ? ""
+        : "s"}.`,
+    );
+    return items;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by campaign name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllCampaignCriteria({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} campaign ${items.length === 1
+        ? "criterion"
+        : "criteria"}.`,
+    );
+    return items;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by campaign name or shared set name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listCampaignSharedSets({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} campaign shared set${items.length === 1
+        ? ""
+        : "s"}.`,
+    );
+    return items;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter campaigns by name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllCampaigns({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const campaigns = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${campaigns.length} campaign${campaigns.length === 1
+        ? ""
+        : "s"}.`,
+    );
+    return campaigns;
+  },
+};

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

@@ -0,0 +1,43 @@
+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",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Partial match text for the customer client descriptive name (e.g. `Acme` matches names containing \"Acme\"). Omit to return clients up to level 3.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.googleAds.listCustomerClients({
+      $,
+      accountId: this.accountId,
+      query: this.query,
+    });
+    const clients = Array.isArray(response)
+      ? response
+      : [];
+    $.export("$summary", `Successfully retrieved ${clients.length} customer client${clients.length === 1
+      ? ""
+      : "s"}`);
+    return clients;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter keywords by text (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllKeywords({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const keywords = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${keywords.length} keyword${keywords.length === 1
+        ? ""
+        : "s"}.`,
+    );
+    return keywords;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by shared set name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllSharedCriteria({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} shared ${items.length === 1
+        ? "criterion"
+        : "criteria"}.`,
+    );
+    return items;
+  },
+};

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

@@ -0,0 +1,55 @@
+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",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    googleAds,
+    accountId: {
+      propDefinition: [
+        googleAds,
+        "accountId",
+      ],
+    },
+    customerClientId: {
+      propDefinition: [
+        googleAds,
+        "customerClientId",
+        ({ accountId }) => ({
+          accountId,
+        }),
+      ],
+      optional: true,
+    },
+    query: {
+      type: "string",
+      label: "Query",
+      description: "Filter by shared set name (partial match).",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { results } = await this.googleAds.listAllSharedSets({
+      $,
+      accountId: this.accountId,
+      customerClientId: this.customerClientId,
+      query: this.query,
+    });
+    const items = results ?? [];
+    $.export(
+      "$summary",
+      `Successfully retrieved ${items.length} shared set${items.length === 1
+        ? ""
+        : "s"}.`,
+    );
+    return items;
+  },
+};

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

@@ -8,7 +8,7 @@ export default {
   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.8",
+  version: "0.0.10",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,