@zernio/node 0.2.755 → 0.2.757

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4553,6 +4553,60 @@ export type GooglePmaxAssetGroupInput = {
4553
4553
  youtubeVideoId?: string;
4554
4554
  };
4555
4555
 
4556
+ /**
4557
+ * Replacement assets for an existing Performance Max asset group, sent on PUT /v1/ads/{adId}.
4558
+ * Google assets are immutable (AssetService only creates), so each field you send becomes new
4559
+ * assets linked to the asset group, and the assets that role held are unlinked in the same
4560
+ * atomic request. Send one field or many; a field you omit is left untouched. Re-sending a
4561
+ * value the asset group already carries is a no-op for that asset, not a re-upload.
4562
+ * Unlinked assets stay in the account's asset library: Google has no asset delete.
4563
+ * At least one description must be 60 characters or fewer. Texts within each list must be distinct.
4564
+ *
4565
+ */
4566
+ export type GooglePmaxAssetGroupUpdate = {
4567
+ /**
4568
+ * Replaces the asset group's final URL.
4569
+ */
4570
+ finalUrl?: string;
4571
+ /**
4572
+ * Replaces every HEADLINE asset on the group.
4573
+ */
4574
+ headlines?: Array<(string)>;
4575
+ /**
4576
+ * Replaces the LONG_HEADLINE asset.
4577
+ */
4578
+ longHeadline?: string;
4579
+ /**
4580
+ * Replaces every DESCRIPTION asset. At least one must be 60 characters or fewer.
4581
+ */
4582
+ descriptions?: Array<(string)>;
4583
+ /**
4584
+ * Replaces the BUSINESS_NAME asset.
4585
+ */
4586
+ businessName?: string;
4587
+ /**
4588
+ * Public HTTP(S) image URLs. Each role you send replaces that role's images; roles you omit stay. GIF, JPEG or PNG, at most 5120 KB per image.
4589
+ */
4590
+ images?: {
4591
+ /**
4592
+ * Replaces MARKETING_IMAGE assets. Aspect ratio 1.91:1, minimum 600 x 314 pixels.
4593
+ */
4594
+ landscape?: Array<(string)>;
4595
+ /**
4596
+ * Replaces SQUARE_MARKETING_IMAGE assets. Aspect ratio 1:1, minimum 300 x 300 pixels.
4597
+ */
4598
+ square?: Array<(string)>;
4599
+ /**
4600
+ * Replaces LOGO assets. Aspect ratio 1:1, minimum 128 x 128 pixels.
4601
+ */
4602
+ logo?: Array<(string)>;
4603
+ };
4604
+ /**
4605
+ * Replaces YOUTUBE_VIDEO assets with existing YouTube video ids. Video uploads and arbitrary video URLs are not supported.
4606
+ */
4607
+ youtubeVideoIds?: Array<(string)>;
4608
+ };
4609
+
4556
4610
  export type GoogleRsaDescription = {
4557
4611
  text: string;
4558
4612
  /**
@@ -33736,17 +33790,21 @@ export type GetAdError = (ErrorResponse | {
33736
33790
  export type UpdateAdData = {
33737
33791
  body: {
33738
33792
  /**
33739
- * Google RSA only. Replaces the complete headline list. No padding or truncation on update.
33793
+ * Google Search and Display only. Replaces the complete headline list. Search takes 3-15, Display 1-5 and rejects pinnedField; the count is checked once the ad's channel is known. No padding or truncation on update.
33740
33794
  */
33741
33795
  headlines?: Array<GoogleRsaHeadline>;
33742
33796
  /**
33743
- * Google RSA only. Replaces the complete description list. No padding or truncation on update.
33797
+ * Google Search and Display only. Replaces the complete description list. Search takes 2-4, Display 1-5 and rejects pinnedField. No padding or truncation on update.
33744
33798
  */
33745
33799
  descriptions?: Array<GoogleRsaDescription>;
33746
33800
  /**
33747
- * Google RSA only. Replaces final URLs. Omitted lists stay unchanged.
33801
+ * Google Search and Display only. Replaces final URLs. Omitted lists stay unchanged. For Performance Max use assetGroup.finalUrl.
33748
33802
  */
33749
33803
  finalUrls?: Array<(string)>;
33804
+ /**
33805
+ * Google Performance Max only. Replaces whole asset roles on the ad's asset group. Returns 422 on any other platform or channel.
33806
+ */
33807
+ assetGroup?: (GooglePmaxAssetGroupUpdate);
33750
33808
  status?: 'active' | 'paused';
33751
33809
  budget?: {
33752
33810
  /**
@@ -33805,7 +33863,36 @@ export type UpdateAdData = {
33805
33863
  })>;
33806
33864
  ageMin?: number;
33807
33865
  ageMax?: number;
33866
+ /**
33867
+ * ISO 3166-1 alpha-2 codes. On Google this is the FULL new country set for the campaign (same contract as `locations`); on LinkedIn it replaces the campaign's geo criteria.
33868
+ */
33808
33869
  countries?: Array<(string)>;
33870
+ /**
33871
+ * Google and LinkedIn. The FULL new location set for the campaign. Bare country-code array, or an object with countries/regions/cities/zips/metros key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Equivalent to the top-level geo fields; sending both returns 400. Empty returns 400, `customLocations` returns 422.
33872
+ */
33873
+ locations?: (Array<(string)> | {
33874
+ countries?: Array<(string)>;
33875
+ regions?: Array<{
33876
+ key: string;
33877
+ name?: string;
33878
+ }>;
33879
+ cities?: Array<{
33880
+ key: string;
33881
+ name?: string;
33882
+ }>;
33883
+ zips?: Array<{
33884
+ key: string;
33885
+ name?: string;
33886
+ }>;
33887
+ metros?: Array<{
33888
+ key: string;
33889
+ name?: string;
33890
+ }>;
33891
+ });
33892
+ /**
33893
+ * Google only. The FULL new language set for the campaign, as Google language codes (ISO 639-1, plus variants such as `zh_CN`). An unknown code returns 400.
33894
+ */
33895
+ languages?: Array<(string)>;
33809
33896
  /**
33810
33897
  * Interest objects from /v1/ads/interests. Each must include id and name.
33811
33898
  */
@@ -33854,6 +33941,18 @@ export type UpdateAdData = {
33854
33941
  * Meta and LinkedIn (TikTok has no headline slot)
33855
33942
  */
33856
33943
  headline?: string;
33944
+ /**
33945
+ * Google Display only. Replaces the responsive display ad's long headline.
33946
+ */
33947
+ longHeadline?: string;
33948
+ /**
33949
+ * Google Display only. Replaces the responsive display ad's business name.
33950
+ */
33951
+ businessName?: string;
33952
+ /**
33953
+ * Google Display only. Uploaded as a new square (1:1) marketing image asset that replaces the current one.
33954
+ */
33955
+ squareImageUrl?: string;
33857
33956
  body?: string;
33858
33957
  /**
33859
33958
  * Link description slot (Meta `link_data.description` / `video_data.link_description`, LinkedIn creative description).