@getlatedev/node 0.2.944 → 0.2.946

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.
package/dist/index.d.mts CHANGED
@@ -6649,7 +6649,7 @@ type GoogleCustomerConversionGoal = {
6649
6649
  }>;
6650
6650
  };
6651
6651
  /**
6652
- * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, or a video responsive ad when youtubeVideoIds is sent.
6652
+ * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, a video responsive ad when youtubeVideoIds is sent, or a carousel ad when carouselCards is sent.
6653
6653
  */
6654
6654
  type GoogleDemandGenInput = {
6655
6655
  /**
@@ -6659,20 +6659,23 @@ type GoogleDemandGenInput = {
6659
6659
  finalUrl: string;
6660
6660
  businessName: string;
6661
6661
  /**
6662
- * Distinct texts.
6662
+ * Distinct texts. A carousel ad takes exactly one.
6663
6663
  */
6664
6664
  headlines: Array<(string)>;
6665
6665
  /**
6666
6666
  * Video ads only, and required there.
6667
6667
  */
6668
6668
  longHeadlines?: Array<(string)>;
6669
+ /**
6670
+ * A carousel ad takes exactly one.
6671
+ */
6669
6672
  descriptions: Array<(string)>;
6670
6673
  /**
6671
- * Image ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
6674
+ * Image and carousel ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
6672
6675
  */
6673
6676
  callToAction?: string;
6674
6677
  /**
6675
- * Public image URLs. An image ad needs landscape or square; a video ad takes only one logo.
6678
+ * Public image URLs. An image ad needs landscape or square; video and carousel ads take only one logo (carousel images go on each card).
6676
6679
  */
6677
6680
  images: {
6678
6681
  /**
@@ -6696,6 +6699,31 @@ type GoogleDemandGenInput = {
6696
6699
  * Makes the ad a video responsive ad.
6697
6700
  */
6698
6701
  youtubeVideoIds?: Array<(string)>;
6702
+ /**
6703
+ * Makes the ad a carousel ad. Each card needs its own image (no two cards may share one); use the same image shape on every card. Card images are uploaded to the account's asset library before the campaign is created, validateOnly included (Google checks cards against existing images; identical images are reused, not duplicated).
6704
+ */
6705
+ carouselCards?: Array<{
6706
+ headline: string;
6707
+ /**
6708
+ * Defaults to demandGen.finalUrl.
6709
+ */
6710
+ finalUrl?: string;
6711
+ callToAction?: string;
6712
+ images: {
6713
+ /**
6714
+ * 1.91:1.
6715
+ */
6716
+ landscape?: string;
6717
+ /**
6718
+ * 1:1.
6719
+ */
6720
+ square?: string;
6721
+ /**
6722
+ * 4:5.
6723
+ */
6724
+ portrait?: string;
6725
+ };
6726
+ }>;
6699
6727
  /**
6700
6728
  * Channel controls on the ad group. Only the listed channels serve; omit to serve on all of them.
6701
6729
  */
@@ -40229,6 +40257,17 @@ type GetAdAccountHierarchyResponse = ({
40229
40257
  */
40230
40258
  clients?: Array<GoogleAdsHierarchyClient>;
40231
40259
  }>;
40260
+ directCustomers?: Array<{
40261
+ customerId?: string;
40262
+ manager?: boolean;
40263
+ /**
40264
+ * Manager invitations this account has not answered yet.
40265
+ */
40266
+ pendingInvitations?: Array<{
40267
+ managerCustomerId?: string;
40268
+ managerLinkId?: string;
40269
+ }>;
40270
+ }>;
40232
40271
  unavailable?: Array<{
40233
40272
  customerId?: string;
40234
40273
  /**
package/dist/index.d.ts CHANGED
@@ -6649,7 +6649,7 @@ type GoogleCustomerConversionGoal = {
6649
6649
  }>;
6650
6650
  };
6651
6651
  /**
6652
- * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, or a video responsive ad when youtubeVideoIds is sent.
6652
+ * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, a video responsive ad when youtubeVideoIds is sent, or a carousel ad when carouselCards is sent.
6653
6653
  */
6654
6654
  type GoogleDemandGenInput = {
6655
6655
  /**
@@ -6659,20 +6659,23 @@ type GoogleDemandGenInput = {
6659
6659
  finalUrl: string;
6660
6660
  businessName: string;
6661
6661
  /**
6662
- * Distinct texts.
6662
+ * Distinct texts. A carousel ad takes exactly one.
6663
6663
  */
6664
6664
  headlines: Array<(string)>;
6665
6665
  /**
6666
6666
  * Video ads only, and required there.
6667
6667
  */
6668
6668
  longHeadlines?: Array<(string)>;
6669
+ /**
6670
+ * A carousel ad takes exactly one.
6671
+ */
6669
6672
  descriptions: Array<(string)>;
6670
6673
  /**
6671
- * Image ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
6674
+ * Image and carousel ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
6672
6675
  */
6673
6676
  callToAction?: string;
6674
6677
  /**
6675
- * Public image URLs. An image ad needs landscape or square; a video ad takes only one logo.
6678
+ * Public image URLs. An image ad needs landscape or square; video and carousel ads take only one logo (carousel images go on each card).
6676
6679
  */
6677
6680
  images: {
6678
6681
  /**
@@ -6696,6 +6699,31 @@ type GoogleDemandGenInput = {
6696
6699
  * Makes the ad a video responsive ad.
6697
6700
  */
6698
6701
  youtubeVideoIds?: Array<(string)>;
6702
+ /**
6703
+ * Makes the ad a carousel ad. Each card needs its own image (no two cards may share one); use the same image shape on every card. Card images are uploaded to the account's asset library before the campaign is created, validateOnly included (Google checks cards against existing images; identical images are reused, not duplicated).
6704
+ */
6705
+ carouselCards?: Array<{
6706
+ headline: string;
6707
+ /**
6708
+ * Defaults to demandGen.finalUrl.
6709
+ */
6710
+ finalUrl?: string;
6711
+ callToAction?: string;
6712
+ images: {
6713
+ /**
6714
+ * 1.91:1.
6715
+ */
6716
+ landscape?: string;
6717
+ /**
6718
+ * 1:1.
6719
+ */
6720
+ square?: string;
6721
+ /**
6722
+ * 4:5.
6723
+ */
6724
+ portrait?: string;
6725
+ };
6726
+ }>;
6699
6727
  /**
6700
6728
  * Channel controls on the ad group. Only the listed channels serve; omit to serve on all of them.
6701
6729
  */
@@ -40229,6 +40257,17 @@ type GetAdAccountHierarchyResponse = ({
40229
40257
  */
40230
40258
  clients?: Array<GoogleAdsHierarchyClient>;
40231
40259
  }>;
40260
+ directCustomers?: Array<{
40261
+ customerId?: string;
40262
+ manager?: boolean;
40263
+ /**
40264
+ * Manager invitations this account has not answered yet.
40265
+ */
40266
+ pendingInvitations?: Array<{
40267
+ managerCustomerId?: string;
40268
+ managerLinkId?: string;
40269
+ }>;
40270
+ }>;
40232
40271
  unavailable?: Array<{
40233
40272
  customerId?: string;
40234
40273
  /**
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@getlatedev/node",
39
- version: "0.2.944",
39
+ version: "0.2.946",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@getlatedev/node",
8
- version: "0.2.944",
8
+ version: "0.2.946",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getlatedev/node",
3
- "version": "0.2.944",
3
+ "version": "0.2.946",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -10641,7 +10641,7 @@ export const removeAccountStructuredSnippet = <ThrowOnError extends boolean = fa
10641
10641
 
10642
10642
  /**
10643
10643
  * Get manager account hierarchy
10644
- * Live manager (MCC) and client tree for a Google Ads connection. Starts from every customer the Google user behind the connection can access directly and walks each tree to any depth with `customer_client`, then reads each manager's own client links so every client carries its direct parent, the `managerLinkId` and the link status. Invitations a manager sent that the client has not accepted yet appear as clients with `linkStatus: PENDING` (Google returns no name or currency for them). Refused, canceled and ended links are history and are omitted. `managerLinks` on a root lists the managers linked to that account, including invitations it can still accept with PATCH /v1/ads/accounts/manager-links. A directly accessible account that is also nested in another tree appears only once, inside that tree. Customers Google refuses to read (for example a cancelled account) are listed in `unavailable` with Google's reason instead of failing the call. Up to 50 roots and 50 managers per root are read; `truncated` is true when more exist. Cached for 10 minutes per connection; the response carries `cachedAt` and `stale`. When the connection is scoped to specific ad accounts, client accounts outside that scope are hidden (managers stay visible).
10644
+ * Live manager (MCC) and client tree for a Google Ads connection. Starts from every customer the Google user behind the connection can access directly and walks each tree to any depth with `customer_client`, then reads each manager's own client links so every client carries its direct parent, the `managerLinkId` and the link status. Invitations a manager sent that the client has not accepted yet appear as clients with `linkStatus: PENDING` (Google returns no name or currency for them). Refused, canceled and ended links are history and are omitted. `managerLinks` on a root lists the managers linked to that account, including invitations it can still accept with PATCH /v1/ads/accounts/manager-links. A directly accessible account that is also nested in another tree appears only once, inside that tree. `directCustomers` lists every account the Google user accesses directly (the ones this connection can accept or decline invitations for) with their pending invitations, including accounts that are also nested in a tree. Customers Google refuses to read (for example a cancelled account) are listed in `unavailable` with Google's reason instead of failing the call. Up to 50 roots and 50 managers per root are read; `truncated` is true when more exist. Cached for 10 minutes per connection; the response carries `cachedAt` and `stale`. When the connection is scoped to specific ad accounts, client accounts outside that scope are hidden (managers stay visible).
10645
10645
  */
10646
10646
  export const getAdAccountHierarchy = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdAccountHierarchyData, ThrowOnError>) => {
10647
10647
  return (options?.client ?? client).get<GetAdAccountHierarchyResponse, GetAdAccountHierarchyError, ThrowOnError>({
@@ -10958,7 +10958,8 @@ export const replaceGoogleListingGroupFilters = <ThrowOnError extends boolean =
10958
10958
  *
10959
10959
  * Google Demand Gen: set `campaignType: "demand_gen"` and supply `demandGen`. Creates a
10960
10960
  * daily budget, PAUSED campaign, one ad group and one ad in a single atomic request: a
10961
- * multi-asset image ad, or a video responsive ad when `demandGen.youtubeVideoIds` is sent.
10961
+ * multi-asset image ad, a video responsive ad when `demandGen.youtubeVideoIds` is sent, or
10962
+ * a carousel ad (2 to 10 cards) when `demandGen.carouselCards` is sent.
10962
10963
  * Geo (countries, regions, cities, zips, metros) and languages go on the ad group, as
10963
10964
  * Demand Gen requires. `demandGen.channels` sets the ad group's channel controls and
10964
10965
  * `demandGen.audience` builds a Google Audience (user lists, interests, custom audiences,
@@ -5080,7 +5080,7 @@ export type GoogleCustomerConversionGoal = {
5080
5080
  };
5081
5081
 
5082
5082
  /**
5083
- * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, or a video responsive ad when youtubeVideoIds is sent.
5083
+ * Creative, channel and audience settings for a Google Demand Gen campaign (campaignType demand_gen). Creates one ad group with one ad: a multi-asset image ad, a video responsive ad when youtubeVideoIds is sent, or a carousel ad when carouselCards is sent.
5084
5084
  */
5085
5085
  export type GoogleDemandGenInput = {
5086
5086
  /**
@@ -5090,20 +5090,23 @@ export type GoogleDemandGenInput = {
5090
5090
  finalUrl: string;
5091
5091
  businessName: string;
5092
5092
  /**
5093
- * Distinct texts.
5093
+ * Distinct texts. A carousel ad takes exactly one.
5094
5094
  */
5095
5095
  headlines: Array<(string)>;
5096
5096
  /**
5097
5097
  * Video ads only, and required there.
5098
5098
  */
5099
5099
  longHeadlines?: Array<(string)>;
5100
+ /**
5101
+ * A carousel ad takes exactly one.
5102
+ */
5100
5103
  descriptions: Array<(string)>;
5101
5104
  /**
5102
- * Image ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
5105
+ * Image and carousel ads only. Call to action text such as 'Learn more'; Google picks one when omitted.
5103
5106
  */
5104
5107
  callToAction?: string;
5105
5108
  /**
5106
- * Public image URLs. An image ad needs landscape or square; a video ad takes only one logo.
5109
+ * Public image URLs. An image ad needs landscape or square; video and carousel ads take only one logo (carousel images go on each card).
5107
5110
  */
5108
5111
  images: {
5109
5112
  /**
@@ -5127,6 +5130,31 @@ export type GoogleDemandGenInput = {
5127
5130
  * Makes the ad a video responsive ad.
5128
5131
  */
5129
5132
  youtubeVideoIds?: Array<(string)>;
5133
+ /**
5134
+ * Makes the ad a carousel ad. Each card needs its own image (no two cards may share one); use the same image shape on every card. Card images are uploaded to the account's asset library before the campaign is created, validateOnly included (Google checks cards against existing images; identical images are reused, not duplicated).
5135
+ */
5136
+ carouselCards?: Array<{
5137
+ headline: string;
5138
+ /**
5139
+ * Defaults to demandGen.finalUrl.
5140
+ */
5141
+ finalUrl?: string;
5142
+ callToAction?: string;
5143
+ images: {
5144
+ /**
5145
+ * 1.91:1.
5146
+ */
5147
+ landscape?: string;
5148
+ /**
5149
+ * 1:1.
5150
+ */
5151
+ square?: string;
5152
+ /**
5153
+ * 4:5.
5154
+ */
5155
+ portrait?: string;
5156
+ };
5157
+ }>;
5130
5158
  /**
5131
5159
  * Channel controls on the ad group. Only the listed channels serve; omit to serve on all of them.
5132
5160
  */
@@ -40835,6 +40863,17 @@ export type GetAdAccountHierarchyResponse = ({
40835
40863
  */
40836
40864
  clients?: Array<GoogleAdsHierarchyClient>;
40837
40865
  }>;
40866
+ directCustomers?: Array<{
40867
+ customerId?: string;
40868
+ manager?: boolean;
40869
+ /**
40870
+ * Manager invitations this account has not answered yet.
40871
+ */
40872
+ pendingInvitations?: Array<{
40873
+ managerCustomerId?: string;
40874
+ managerLinkId?: string;
40875
+ }>;
40876
+ }>;
40838
40877
  unavailable?: Array<{
40839
40878
  customerId?: string;
40840
40879
  /**