@getlatedev/node 0.2.1107 → 0.2.1108

package/dist/index.d.mts

@@ -9265,6 +9265,9 @@ type graduationStrategy = 'MANUAL' | 'SS_PERFORMANCE';
  */
 type KeywordEntry = string | {
     text: string;
+    /**
+     * Defaults to broad. Accepted in any case (EXACT, Exact) and stored lowercase.
+     */
     matchType?: 'exact' | 'phrase' | 'broad';
 };
 /**
@@ -39634,6 +39637,9 @@ type ListAdKeywordsData = {
          */
         campaignId?: string;
         limit?: number;
+        /**
+         * Accepted in any case.
+         */
         matchType?: 'exact' | 'phrase' | 'broad' | 'unknown';
         /**
          * true = negative keywords only, false = positive only. Omit for both.
@@ -40277,8 +40283,14 @@ type BulkUpdateAdCampaignStatusData = {
     body: {
         status: 'active' | 'paused';
         campaigns: Array<{
+            /**
+             * The campaign id on the ad platform (e.g. the numeric Google campaign id), not a Zernio id.
+             */
             platformCampaignId: string;
-            platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+            /**
+             * The ad platform, e.g. `google` for Google Ads. The ads connection slug (`googleads`, `tiktokads`, ...) is accepted as an alias. `metaads` is not: send `facebook` or `instagram`.
+             */
+            platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'googleads' | 'tiktokads' | 'linkedinads' | 'pinterestads' | 'xads' | 'openaiads';
         }>;
     };
 };
@@ -41626,7 +41638,13 @@ type UpdateCampaignAssetsResponse = ({
 });
 type UpdateCampaignAssetsError = (ErrorResponse | unknown);
 type RemoveCampaignAssetsData = {
-    body: {
+    path: {
+        /**
+         * Numeric Google platform id.
+         */
+        campaignId: string;
+    };
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -41636,18 +41654,18 @@ type RemoveCampaignAssetsData = {
          */
         adAccountId?: string;
         /**
-         * Alias of adAccountId, kept for existing callers
-         * @deprecated
+         * Asset resource names, retained for compatibility. Repeat the parameter or pass a comma-separated list.
          */
-        customerId?: string;
         assetResourceNames: Array<(string)>;
+        /**
+         * campaign_asset resource names to remove, e.g. customers/1234567890/campaignAssets/456~123~CALLOUT. Repeat the parameter or pass a comma-separated list.
+         */
         campaignAssetResourceNames: Array<(string)>;
-    };
-    path: {
         /**
-         * Numeric Google platform id.
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
          */
-        campaignId: string;
+        customerId?: string;
     };
 };
 type RemoveCampaignAssetsResponse = ({
@@ -41763,7 +41781,13 @@ type UpdateAdGroupAssetsResponse = ({
 });
 type UpdateAdGroupAssetsError = (ErrorResponse | unknown);
 type RemoveAdGroupAssetsData = {
-    body: {
+    path: {
+        /**
+         * Numeric Google platform id.
+         */
+        adSetId: string;
+    };
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -41773,18 +41797,18 @@ type RemoveAdGroupAssetsData = {
          */
         adAccountId?: string;
         /**
-         * Alias of adAccountId, kept for existing callers
-         * @deprecated
+         * ad_group_asset resource names to remove, e.g. customers/1234567890/adGroupAssets/456~123~CALLOUT. Repeat the parameter or pass a comma-separated list.
          */
-        customerId?: string;
-        assetResourceNames: Array<(string)>;
         adGroupAssetResourceNames: Array<(string)>;
-    };
-    path: {
         /**
-         * Numeric Google platform id.
+         * Asset resource names, retained for compatibility. Repeat the parameter or pass a comma-separated list.
          */
-        adSetId: string;
+        assetResourceNames: Array<(string)>;
+        /**
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
+         */
+        customerId?: string;
     };
 };
 type RemoveAdGroupAssetsResponse = ({
@@ -43453,13 +43477,43 @@ type AttachAdLabelResponse = ({
 });
 type AttachAdLabelError = (ErrorResponse | unknown);
 type DetachAdLabelData = {
-    body: GoogleAdLabelAssignments;
     path: {
         /**
          * Google label id
          */
         labelId: string;
     };
+    query: {
+        /**
+         * Zernio Google Ads connection id.
+         */
+        accountId: string;
+        /**
+         * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
+         */
+        adAccountId?: string;
+        /**
+         * Google ad group ad ids, {adGroupId}~{adId}. Repeat the parameter or pass a comma-separated list.
+         */
+        adIds?: Array<(string)>;
+        /**
+         * Google ad group ids. Repeat the parameter or pass a comma-separated list.
+         */
+        adSetIds?: Array<(string)>;
+        /**
+         * Google campaign ids. Repeat the parameter or pass a comma-separated list.
+         */
+        campaignIds?: Array<(string)>;
+        /**
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
+         */
+        customerId?: string;
+        /**
+         * Google keyword criterion ids, {adGroupId}~{criterionId}. Repeat the parameter or pass a comma-separated list.
+         */
+        keywordIds?: Array<(string)>;
+    };
 };
 type DetachAdLabelResponse = ({
     customerId?: string;
@@ -44198,7 +44252,7 @@ type UpdateAccountCalloutsResponse = ({
 });
 type UpdateAccountCalloutsError = (ErrorResponse | unknown);
 type RemoveAccountCalloutData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44207,12 +44261,15 @@ type RemoveAccountCalloutData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 type RemoveAccountCalloutResponse = ({
@@ -44320,7 +44377,7 @@ type UpdateAccountSitelinksResponse = ({
 });
 type UpdateAccountSitelinksError = (ErrorResponse | unknown);
 type RemoveAccountSitelinkData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44329,12 +44386,15 @@ type RemoveAccountSitelinkData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 type RemoveAccountSitelinkResponse = ({
@@ -44429,7 +44489,7 @@ type UpdateAccountStructuredSnippetsResponse = ({
 });
 type UpdateAccountStructuredSnippetsError = (ErrorResponse | unknown);
 type RemoveAccountStructuredSnippetData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44438,12 +44498,15 @@ type RemoveAccountStructuredSnippetData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 type RemoveAccountStructuredSnippetResponse = ({
@@ -46220,15 +46283,18 @@ type CreateStandaloneAdData = {
          * budget and schedule are inherited (passing those fields
          * returns 400).
          *
-         * On Google Ads the `adSetId` is the AD GROUP id. `goal` is
-         * still REQUIRED even though budget and targeting are
-         * inherited from the ad group. Send `campaignType: "search"`
-         * to attach into a Search ad group, including one created by
-         * `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it
-         * the request is treated as Display and requires
-         * `images.landscape` + `images.square` + `businessName`, and
-         * the resulting display creative does not match a Search ad
-         * group.
+         * On Google Ads the `adSetId` is the AD GROUP id (numeric). `goal`
+         * is not required: the ad group keeps its campaign's bidding,
+         * budget and targeting. `campaignType` is read from the ad group's
+         * campaign (Search, Display or Demand Gen), so it can be omitted;
+         * a `campaignType` that contradicts the ad group returns 400, an
+         * ad group Google does not know in that customer returns 404, and
+         * any other campaign type returns 422. A Search ad needs
+         * `headline` + `body` + `linkUrl`; a Display ad also needs
+         * `images.landscape` + `images.square` + `businessName`. Google
+         * allows 3 responsive search ads per ad group: a fourth returns
+         * 422 naming the limit (`RESPONSIVE_SEARCH_ADS_PER_AD_GROUP`) and
+         * the ad group.
          * `budgetAmount`/`budgetType` and bidding fields
          * (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
          * return 400 on this shape; the ad group already owns them.
@@ -46750,7 +46816,7 @@ type CreateStandaloneAdData = {
          */
         audienceId?: string;
         /**
-         * Google only. Performance Max requires assetGroup and Demand Gen requires demandGen; both are always created PAUSED.
+         * Google only. Performance Max requires assetGroup and Demand Gen requires demandGen; both are always created PAUSED. With `adSetId` it defaults to the ad group's own campaign type instead of display.
          */
         campaignType?: 'display' | 'search' | 'pmax' | 'demand_gen';
         /**
@@ -46772,11 +46838,11 @@ type CreateStandaloneAdData = {
          */
         campaignNegativeKeywords?: Array<KeywordEntry>;
         /**
-         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400.
+         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. Each headline is at most 30 characters (Google's limit): a longer one returns 400 naming the field and index (e.g. `additionalHeadlines[2]`), it is never truncated. On Search the same limit applies to `headline` and `longHeadline` (30) and to `body` (90).
          */
         additionalHeadlines?: Array<(string | GoogleRsaHeadline)>;
         /**
-         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400.
+         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. Each description is at most 90 characters (Google's limit): a longer one returns 400 naming the field and index (e.g. `additionalDescriptions[2]`), it is never truncated. On Search the same limit applies to `headline` and `longHeadline` (30) and to `body` (90).
          */
         additionalDescriptions?: Array<(string | GoogleRsaDescription)>;
         /**

package/dist/index.d.ts

@@ -9265,6 +9265,9 @@ type graduationStrategy = 'MANUAL' | 'SS_PERFORMANCE';
  */
 type KeywordEntry = string | {
     text: string;
+    /**
+     * Defaults to broad. Accepted in any case (EXACT, Exact) and stored lowercase.
+     */
     matchType?: 'exact' | 'phrase' | 'broad';
 };
 /**
@@ -39634,6 +39637,9 @@ type ListAdKeywordsData = {
          */
         campaignId?: string;
         limit?: number;
+        /**
+         * Accepted in any case.
+         */
         matchType?: 'exact' | 'phrase' | 'broad' | 'unknown';
         /**
          * true = negative keywords only, false = positive only. Omit for both.
@@ -40277,8 +40283,14 @@ type BulkUpdateAdCampaignStatusData = {
     body: {
         status: 'active' | 'paused';
         campaigns: Array<{
+            /**
+             * The campaign id on the ad platform (e.g. the numeric Google campaign id), not a Zernio id.
+             */
             platformCampaignId: string;
-            platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+            /**
+             * The ad platform, e.g. `google` for Google Ads. The ads connection slug (`googleads`, `tiktokads`, ...) is accepted as an alias. `metaads` is not: send `facebook` or `instagram`.
+             */
+            platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'googleads' | 'tiktokads' | 'linkedinads' | 'pinterestads' | 'xads' | 'openaiads';
         }>;
     };
 };
@@ -41626,7 +41638,13 @@ type UpdateCampaignAssetsResponse = ({
 });
 type UpdateCampaignAssetsError = (ErrorResponse | unknown);
 type RemoveCampaignAssetsData = {
-    body: {
+    path: {
+        /**
+         * Numeric Google platform id.
+         */
+        campaignId: string;
+    };
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -41636,18 +41654,18 @@ type RemoveCampaignAssetsData = {
          */
         adAccountId?: string;
         /**
-         * Alias of adAccountId, kept for existing callers
-         * @deprecated
+         * Asset resource names, retained for compatibility. Repeat the parameter or pass a comma-separated list.
          */
-        customerId?: string;
         assetResourceNames: Array<(string)>;
+        /**
+         * campaign_asset resource names to remove, e.g. customers/1234567890/campaignAssets/456~123~CALLOUT. Repeat the parameter or pass a comma-separated list.
+         */
         campaignAssetResourceNames: Array<(string)>;
-    };
-    path: {
         /**
-         * Numeric Google platform id.
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
          */
-        campaignId: string;
+        customerId?: string;
     };
 };
 type RemoveCampaignAssetsResponse = ({
@@ -41763,7 +41781,13 @@ type UpdateAdGroupAssetsResponse = ({
 });
 type UpdateAdGroupAssetsError = (ErrorResponse | unknown);
 type RemoveAdGroupAssetsData = {
-    body: {
+    path: {
+        /**
+         * Numeric Google platform id.
+         */
+        adSetId: string;
+    };
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -41773,18 +41797,18 @@ type RemoveAdGroupAssetsData = {
          */
         adAccountId?: string;
         /**
-         * Alias of adAccountId, kept for existing callers
-         * @deprecated
+         * ad_group_asset resource names to remove, e.g. customers/1234567890/adGroupAssets/456~123~CALLOUT. Repeat the parameter or pass a comma-separated list.
          */
-        customerId?: string;
-        assetResourceNames: Array<(string)>;
         adGroupAssetResourceNames: Array<(string)>;
-    };
-    path: {
         /**
-         * Numeric Google platform id.
+         * Asset resource names, retained for compatibility. Repeat the parameter or pass a comma-separated list.
          */
-        adSetId: string;
+        assetResourceNames: Array<(string)>;
+        /**
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
+         */
+        customerId?: string;
     };
 };
 type RemoveAdGroupAssetsResponse = ({
@@ -43453,13 +43477,43 @@ type AttachAdLabelResponse = ({
 });
 type AttachAdLabelError = (ErrorResponse | unknown);
 type DetachAdLabelData = {
-    body: GoogleAdLabelAssignments;
     path: {
         /**
          * Google label id
          */
         labelId: string;
     };
+    query: {
+        /**
+         * Zernio Google Ads connection id.
+         */
+        accountId: string;
+        /**
+         * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
+         */
+        adAccountId?: string;
+        /**
+         * Google ad group ad ids, {adGroupId}~{adId}. Repeat the parameter or pass a comma-separated list.
+         */
+        adIds?: Array<(string)>;
+        /**
+         * Google ad group ids. Repeat the parameter or pass a comma-separated list.
+         */
+        adSetIds?: Array<(string)>;
+        /**
+         * Google campaign ids. Repeat the parameter or pass a comma-separated list.
+         */
+        campaignIds?: Array<(string)>;
+        /**
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
+         */
+        customerId?: string;
+        /**
+         * Google keyword criterion ids, {adGroupId}~{criterionId}. Repeat the parameter or pass a comma-separated list.
+         */
+        keywordIds?: Array<(string)>;
+    };
 };
 type DetachAdLabelResponse = ({
     customerId?: string;
@@ -44198,7 +44252,7 @@ type UpdateAccountCalloutsResponse = ({
 });
 type UpdateAccountCalloutsError = (ErrorResponse | unknown);
 type RemoveAccountCalloutData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44207,12 +44261,15 @@ type RemoveAccountCalloutData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 type RemoveAccountCalloutResponse = ({
@@ -44320,7 +44377,7 @@ type UpdateAccountSitelinksResponse = ({
 });
 type UpdateAccountSitelinksError = (ErrorResponse | unknown);
 type RemoveAccountSitelinkData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44329,12 +44386,15 @@ type RemoveAccountSitelinkData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 type RemoveAccountSitelinkResponse = ({
@@ -44429,7 +44489,7 @@ type UpdateAccountStructuredSnippetsResponse = ({
 });
 type UpdateAccountStructuredSnippetsError = (ErrorResponse | unknown);
 type RemoveAccountStructuredSnippetData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44438,12 +44498,15 @@ type RemoveAccountStructuredSnippetData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 type RemoveAccountStructuredSnippetResponse = ({
@@ -46220,15 +46283,18 @@ type CreateStandaloneAdData = {
          * budget and schedule are inherited (passing those fields
          * returns 400).
          *
-         * On Google Ads the `adSetId` is the AD GROUP id. `goal` is
-         * still REQUIRED even though budget and targeting are
-         * inherited from the ad group. Send `campaignType: "search"`
-         * to attach into a Search ad group, including one created by
-         * `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it
-         * the request is treated as Display and requires
-         * `images.landscape` + `images.square` + `businessName`, and
-         * the resulting display creative does not match a Search ad
-         * group.
+         * On Google Ads the `adSetId` is the AD GROUP id (numeric). `goal`
+         * is not required: the ad group keeps its campaign's bidding,
+         * budget and targeting. `campaignType` is read from the ad group's
+         * campaign (Search, Display or Demand Gen), so it can be omitted;
+         * a `campaignType` that contradicts the ad group returns 400, an
+         * ad group Google does not know in that customer returns 404, and
+         * any other campaign type returns 422. A Search ad needs
+         * `headline` + `body` + `linkUrl`; a Display ad also needs
+         * `images.landscape` + `images.square` + `businessName`. Google
+         * allows 3 responsive search ads per ad group: a fourth returns
+         * 422 naming the limit (`RESPONSIVE_SEARCH_ADS_PER_AD_GROUP`) and
+         * the ad group.
          * `budgetAmount`/`budgetType` and bidding fields
          * (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
          * return 400 on this shape; the ad group already owns them.
@@ -46750,7 +46816,7 @@ type CreateStandaloneAdData = {
          */
         audienceId?: string;
         /**
-         * Google only. Performance Max requires assetGroup and Demand Gen requires demandGen; both are always created PAUSED.
+         * Google only. Performance Max requires assetGroup and Demand Gen requires demandGen; both are always created PAUSED. With `adSetId` it defaults to the ad group's own campaign type instead of display.
          */
         campaignType?: 'display' | 'search' | 'pmax' | 'demand_gen';
         /**
@@ -46772,11 +46838,11 @@ type CreateStandaloneAdData = {
          */
         campaignNegativeKeywords?: Array<KeywordEntry>;
         /**
-         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400.
+         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. Each headline is at most 30 characters (Google's limit): a longer one returns 400 naming the field and index (e.g. `additionalHeadlines[2]`), it is never truncated. On Search the same limit applies to `headline` and `longHeadline` (30) and to `body` (90).
          */
         additionalHeadlines?: Array<(string | GoogleRsaHeadline)>;
         /**
-         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400.
+         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. Each description is at most 90 characters (Google's limit): a longer one returns 400 naming the field and index (e.g. `additionalDescriptions[2]`), it is never truncated. On Search the same limit applies to `headline` and `longHeadline` (30) and to `body` (90).
          */
         additionalDescriptions?: Array<(string | GoogleRsaDescription)>;
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1107",
+  version: "0.2.1108",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1107",
+  version: "0.2.1108",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.1107",
+  "version": "0.2.1108",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -10524,7 +10524,7 @@ export const updateCampaignAssets = <ThrowOnError extends boolean = false>(optio
 
 /**
  * Remove campaign assets
- * Removes the specified attachments only. Google assets cannot be deleted. Other attachments remain. assetResourceNames is retained for compatibility.
+ * Removes the specified attachments only. Google assets cannot be deleted. Other attachments remain. assetResourceNames is retained for compatibility. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.
  */
 export const removeCampaignAssets = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveCampaignAssetsData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveCampaignAssetsResponse, RemoveCampaignAssetsError, ThrowOnError>({
@@ -10568,7 +10568,7 @@ export const updateAdGroupAssets = <ThrowOnError extends boolean = false>(option
 
 /**
  * Remove ad-group assets
- * Removes the specified attachments only. Google assets cannot be deleted. Other attachments remain. assetResourceNames is retained for compatibility.
+ * Removes the specified attachments only. Google assets cannot be deleted. Other attachments remain. assetResourceNames is retained for compatibility. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.
  */
 export const removeAdGroupAssets = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveAdGroupAssetsData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveAdGroupAssetsResponse, RemoveAdGroupAssetsError, ThrowOnError>({
@@ -10822,6 +10822,8 @@ export const getAdTrackingTags = <ThrowOnError extends boolean = false>(options:
  * / dark / asset_feed creatives whose object_story_spec Meta strips (those return 422 asking for
  * `creative`).
  * - Google: `trackingUrlTemplate` and/or `finalUrlSuffix` (full template strings; account quota applies).
+ * Written at the CAMPAIGN level (the campaign's `tracking_url_template` / `final_url_suffix`), so
+ * the change applies to every ad in the ad's campaign.
  * - LinkedIn: `dynamicValueParameters` and/or `customValueParameters` (campaign-level Dynamic UTM).
  *
  */
@@ -11267,7 +11269,7 @@ export const attachAdLabel = <ThrowOnError extends boolean = false>(options: Opt
 
 /**
  * Detach a Google Ads label
- * Removes the label from the given targets. Idempotent; a target without the label is counted in `unchanged`.
+ * Removes the label from the given targets. Idempotent; a target without the label is counted in `unchanged`. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.
  */
 export const detachAdLabel = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DetachAdLabelData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DetachAdLabelResponse, DetachAdLabelError, ThrowOnError>({
@@ -11624,7 +11626,7 @@ export const updateAccountCallouts = <ThrowOnError extends boolean = false>(opti
 
 /**
  * Remove account callout
- * Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain.
+ * Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.
  */
 export const removeAccountCallout = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveAccountCalloutData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveAccountCalloutResponse, RemoveAccountCalloutError, ThrowOnError>({
@@ -11668,7 +11670,7 @@ export const updateAccountSitelinks = <ThrowOnError extends boolean = false>(opt
 
 /**
  * Remove account sitelink
- * Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain.
+ * Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.
  */
 export const removeAccountSitelink = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveAccountSitelinkData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveAccountSitelinkResponse, RemoveAccountSitelinkError, ThrowOnError>({
@@ -11712,7 +11714,7 @@ export const updateAccountStructuredSnippets = <ThrowOnError extends boolean = f
 
 /**
  * Remove account snippet
- * Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain.
+ * Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.
  */
 export const removeAccountStructuredSnippet = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveAccountStructuredSnippetData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveAccountStructuredSnippetResponse, RemoveAccountStructuredSnippetError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -7593,6 +7593,9 @@ export type graduationStrategy = 'MANUAL' | 'SS_PERFORMANCE';
  */
 export type KeywordEntry = string | {
     text: string;
+    /**
+     * Defaults to broad. Accepted in any case (EXACT, Exact) and stored lowercase.
+     */
     matchType?: 'exact' | 'phrase' | 'broad';
 };
 
@@ -40027,6 +40030,9 @@ export type ListAdKeywordsData = {
          */
         campaignId?: string;
         limit?: number;
+        /**
+         * Accepted in any case.
+         */
         matchType?: 'exact' | 'phrase' | 'broad' | 'unknown';
         /**
          * true = negative keywords only, false = positive only. Omit for both.
@@ -40715,8 +40721,14 @@ export type BulkUpdateAdCampaignStatusData = {
     body: {
         status: 'active' | 'paused';
         campaigns: Array<{
+            /**
+             * The campaign id on the ad platform (e.g. the numeric Google campaign id), not a Zernio id.
+             */
             platformCampaignId: string;
-            platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai';
+            /**
+             * The ad platform, e.g. `google` for Google Ads. The ads connection slug (`googleads`, `tiktokads`, ...) is accepted as an alias. `metaads` is not: send `facebook` or `instagram`.
+             */
+            platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'googleads' | 'tiktokads' | 'linkedinads' | 'pinterestads' | 'xads' | 'openaiads';
         }>;
     };
 };
@@ -42127,7 +42139,13 @@ export type UpdateCampaignAssetsResponse = ({
 export type UpdateCampaignAssetsError = (ErrorResponse | unknown);
 
 export type RemoveCampaignAssetsData = {
-    body: {
+    path: {
+        /**
+         * Numeric Google platform id.
+         */
+        campaignId: string;
+    };
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -42137,18 +42155,18 @@ export type RemoveCampaignAssetsData = {
          */
         adAccountId?: string;
         /**
-         * Alias of adAccountId, kept for existing callers
-         * @deprecated
+         * Asset resource names, retained for compatibility. Repeat the parameter or pass a comma-separated list.
          */
-        customerId?: string;
         assetResourceNames: Array<(string)>;
+        /**
+         * campaign_asset resource names to remove, e.g. customers/1234567890/campaignAssets/456~123~CALLOUT. Repeat the parameter or pass a comma-separated list.
+         */
         campaignAssetResourceNames: Array<(string)>;
-    };
-    path: {
         /**
-         * Numeric Google platform id.
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
          */
-        campaignId: string;
+        customerId?: string;
     };
 };
 
@@ -42276,7 +42294,13 @@ export type UpdateAdGroupAssetsResponse = ({
 export type UpdateAdGroupAssetsError = (ErrorResponse | unknown);
 
 export type RemoveAdGroupAssetsData = {
-    body: {
+    path: {
+        /**
+         * Numeric Google platform id.
+         */
+        adSetId: string;
+    };
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -42286,18 +42310,18 @@ export type RemoveAdGroupAssetsData = {
          */
         adAccountId?: string;
         /**
-         * Alias of adAccountId, kept for existing callers
-         * @deprecated
+         * ad_group_asset resource names to remove, e.g. customers/1234567890/adGroupAssets/456~123~CALLOUT. Repeat the parameter or pass a comma-separated list.
          */
-        customerId?: string;
-        assetResourceNames: Array<(string)>;
         adGroupAssetResourceNames: Array<(string)>;
-    };
-    path: {
         /**
-         * Numeric Google platform id.
+         * Asset resource names, retained for compatibility. Repeat the parameter or pass a comma-separated list.
          */
-        adSetId: string;
+        assetResourceNames: Array<(string)>;
+        /**
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
+         */
+        customerId?: string;
     };
 };
 
@@ -44089,13 +44113,43 @@ export type AttachAdLabelResponse = ({
 export type AttachAdLabelError = (ErrorResponse | unknown);
 
 export type DetachAdLabelData = {
-    body: GoogleAdLabelAssignments;
     path: {
         /**
          * Google label id
          */
         labelId: string;
     };
+    query: {
+        /**
+         * Zernio Google Ads connection id.
+         */
+        accountId: string;
+        /**
+         * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
+         */
+        adAccountId?: string;
+        /**
+         * Google ad group ad ids, {adGroupId}~{adId}. Repeat the parameter or pass a comma-separated list.
+         */
+        adIds?: Array<(string)>;
+        /**
+         * Google ad group ids. Repeat the parameter or pass a comma-separated list.
+         */
+        adSetIds?: Array<(string)>;
+        /**
+         * Google campaign ids. Repeat the parameter or pass a comma-separated list.
+         */
+        campaignIds?: Array<(string)>;
+        /**
+         * Alias of adAccountId, kept for existing callers
+         * @deprecated
+         */
+        customerId?: string;
+        /**
+         * Google keyword criterion ids, {adGroupId}~{criterionId}. Repeat the parameter or pass a comma-separated list.
+         */
+        keywordIds?: Array<(string)>;
+    };
 };
 
 export type DetachAdLabelResponse = ({
@@ -44906,7 +44960,7 @@ export type UpdateAccountCalloutsResponse = ({
 export type UpdateAccountCalloutsError = (ErrorResponse | unknown);
 
 export type RemoveAccountCalloutData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -44915,12 +44969,15 @@ export type RemoveAccountCalloutData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 
@@ -45040,7 +45097,7 @@ export type UpdateAccountSitelinksResponse = ({
 export type UpdateAccountSitelinksError = (ErrorResponse | unknown);
 
 export type RemoveAccountSitelinkData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -45049,12 +45106,15 @@ export type RemoveAccountSitelinkData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 
@@ -45161,7 +45221,7 @@ export type UpdateAccountStructuredSnippetsResponse = ({
 export type UpdateAccountStructuredSnippetsError = (ErrorResponse | unknown);
 
 export type RemoveAccountStructuredSnippetData = {
-    body: {
+    query: {
         /**
          * Zernio Google Ads connection id.
          */
@@ -45170,12 +45230,15 @@ export type RemoveAccountStructuredSnippetData = {
          * Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.
          */
         adAccountId?: string;
+        /**
+         * Numeric Google Ads asset id.
+         */
+        assetId: string;
         /**
          * Alias of adAccountId, kept for existing callers
          * @deprecated
          */
         customerId?: string;
-        assetId: string;
     };
 };
 
@@ -47018,15 +47081,18 @@ export type CreateStandaloneAdData = {
          * budget and schedule are inherited (passing those fields
          * returns 400).
          *
-         * On Google Ads the `adSetId` is the AD GROUP id. `goal` is
-         * still REQUIRED even though budget and targeting are
-         * inherited from the ad group. Send `campaignType: "search"`
-         * to attach into a Search ad group, including one created by
-         * `POST /v1/ads/ad-sets` (always SEARCH_STANDARD): without it
-         * the request is treated as Display and requires
-         * `images.landscape` + `images.square` + `businessName`, and
-         * the resulting display creative does not match a Search ad
-         * group.
+         * On Google Ads the `adSetId` is the AD GROUP id (numeric). `goal`
+         * is not required: the ad group keeps its campaign's bidding,
+         * budget and targeting. `campaignType` is read from the ad group's
+         * campaign (Search, Display or Demand Gen), so it can be omitted;
+         * a `campaignType` that contradicts the ad group returns 400, an
+         * ad group Google does not know in that customer returns 404, and
+         * any other campaign type returns 422. A Search ad needs
+         * `headline` + `body` + `linkUrl`; a Display ad also needs
+         * `images.landscape` + `images.square` + `businessName`. Google
+         * allows 3 responsive search ads per ad group: a fourth returns
+         * 422 naming the limit (`RESPONSIVE_SEARCH_ADS_PER_AD_GROUP`) and
+         * the ad group.
          * `budgetAmount`/`budgetType` and bidding fields
          * (`bidStrategy`, `bidAmount`, `portfolioBidStrategyId`)
          * return 400 on this shape; the ad group already owns them.
@@ -47548,7 +47614,7 @@ export type CreateStandaloneAdData = {
          */
         audienceId?: string;
         /**
-         * Google only. Performance Max requires assetGroup and Demand Gen requires demandGen; both are always created PAUSED.
+         * Google only. Performance Max requires assetGroup and Demand Gen requires demandGen; both are always created PAUSED. With `adSetId` it defaults to the ad group's own campaign type instead of display.
          */
         campaignType?: 'display' | 'search' | 'pmax' | 'demand_gen';
         /**
@@ -47570,11 +47636,11 @@ export type CreateStandaloneAdData = {
          */
         campaignNegativeKeywords?: Array<KeywordEntry>;
         /**
-         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400.
+         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. Each headline is at most 30 characters (Google's limit): a longer one returns 400 naming the field and index (e.g. `additionalHeadlines[2]`), it is never truncated. On Search the same limit applies to `headline` and `longHeadline` (30) and to `body` (90).
          */
         additionalHeadlines?: Array<(string | GoogleRsaHeadline)>;
         /**
-         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400.
+         * Google Search RSA only. Extra text assets as strings or objects with text and optional pinnedField. Existing string input remains supported. The effective create lists, including primary text and deduplication, must contain 3-15 headlines and 2-4 descriptions; excess entries return 400. Each description is at most 90 characters (Google's limit): a longer one returns 400 naming the field and index (e.g. `additionalDescriptions[2]`), it is never truncated. On Search the same limit applies to `headline` and `longHeadline` (30) and to `body` (90).
          */
         additionalDescriptions?: Array<(string | GoogleRsaDescription)>;
         /**