@getlatedev/node 0.2.1230 → 0.2.1232

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
@@ -2341,6 +2341,29 @@ type Ad = {
2341
2341
  * Google Display only. Resource name of the landscape marketing image asset (`creative.imageUrl`), for example customers/1234567890/assets/123. Set at creation and updated when PUT /v1/ads/{adId} replaces `creative.imageUrl`; replacing only `creative.squareImageUrl` leaves it unchanged.
2342
2342
  */
2343
2343
  assetResourceName?: string;
2344
+ /**
2345
+ * Google Display only. Native Google asset resource name of each image on the responsive display ad, keyed by Google's image role. Set at creation for ads created through Zernio. PUT /v1/ads/{adId} overwrites only the role it replaces: `creative.imageUrl` updates `marketingImages`, `creative.squareImageUrl` updates `squareMarketingImages`. Absent on ads synced from Google.
2346
+ */
2347
+ assets?: {
2348
+ /**
2349
+ * Landscape (1.91:1) marketing images. The first item matches `assetResourceName`.
2350
+ */
2351
+ marketingImages?: Array<{
2352
+ /**
2353
+ * Google asset resource name, for example customers/1234567890/assets/123.
2354
+ */
2355
+ resourceName?: string;
2356
+ }>;
2357
+ /**
2358
+ * Square (1:1) marketing images.
2359
+ */
2360
+ squareMarketingImages?: Array<{
2361
+ /**
2362
+ * Google asset resource name, for example customers/1234567890/assets/124.
2363
+ */
2364
+ resourceName?: string;
2365
+ }>;
2366
+ };
2344
2367
  /**
2345
2368
  * Meta video ID for VIDEO-type ads. Null for non-video ads. Callers that need an embeddable MP4 can call GET /{videoId}?fields=source with the page access token.
2346
2369
  */
@@ -18992,9 +19015,9 @@ type GetInstagramAccountInsightsData = {
18992
19015
  /**
18993
19016
  * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
18994
19017
  * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
18995
- * replies, reposts, follows_and_unfollows, profile_links_taps.
19018
+ * replies, reposts, follows_and_unfollows, profile_links_taps, profile_views, website_clicks.
18996
19019
  * Note: only "reach" supports metricType=time_series. All other metrics (including
18997
- * follows_and_unfollows) are total_value only. This is an Instagram Graph API limitation,
19020
+ * follows_and_unfollows, profile_views and website_clicks) are total_value only. This is an Instagram Graph API limitation,
18998
19021
  * not a Zernio limitation - the IG API does not return time-series data for these metrics.
18999
19022
  * For a daily running follower count, use /v1/analytics/instagram/follower-history instead.
19000
19023
  *
package/dist/index.d.ts CHANGED
@@ -2341,6 +2341,29 @@ type Ad = {
2341
2341
  * Google Display only. Resource name of the landscape marketing image asset (`creative.imageUrl`), for example customers/1234567890/assets/123. Set at creation and updated when PUT /v1/ads/{adId} replaces `creative.imageUrl`; replacing only `creative.squareImageUrl` leaves it unchanged.
2342
2342
  */
2343
2343
  assetResourceName?: string;
2344
+ /**
2345
+ * Google Display only. Native Google asset resource name of each image on the responsive display ad, keyed by Google's image role. Set at creation for ads created through Zernio. PUT /v1/ads/{adId} overwrites only the role it replaces: `creative.imageUrl` updates `marketingImages`, `creative.squareImageUrl` updates `squareMarketingImages`. Absent on ads synced from Google.
2346
+ */
2347
+ assets?: {
2348
+ /**
2349
+ * Landscape (1.91:1) marketing images. The first item matches `assetResourceName`.
2350
+ */
2351
+ marketingImages?: Array<{
2352
+ /**
2353
+ * Google asset resource name, for example customers/1234567890/assets/123.
2354
+ */
2355
+ resourceName?: string;
2356
+ }>;
2357
+ /**
2358
+ * Square (1:1) marketing images.
2359
+ */
2360
+ squareMarketingImages?: Array<{
2361
+ /**
2362
+ * Google asset resource name, for example customers/1234567890/assets/124.
2363
+ */
2364
+ resourceName?: string;
2365
+ }>;
2366
+ };
2344
2367
  /**
2345
2368
  * Meta video ID for VIDEO-type ads. Null for non-video ads. Callers that need an embeddable MP4 can call GET /{videoId}?fields=source with the page access token.
2346
2369
  */
@@ -18992,9 +19015,9 @@ type GetInstagramAccountInsightsData = {
18992
19015
  /**
18993
19016
  * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
18994
19017
  * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
18995
- * replies, reposts, follows_and_unfollows, profile_links_taps.
19018
+ * replies, reposts, follows_and_unfollows, profile_links_taps, profile_views, website_clicks.
18996
19019
  * Note: only "reach" supports metricType=time_series. All other metrics (including
18997
- * follows_and_unfollows) are total_value only. This is an Instagram Graph API limitation,
19020
+ * follows_and_unfollows, profile_views and website_clicks) are total_value only. This is an Instagram Graph API limitation,
18998
19021
  * not a Zernio limitation - the IG API does not return time-series data for these metrics.
18999
19022
  * For a daily running follower count, use /v1/analytics/instagram/follower-history instead.
19000
19023
  *
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.1230",
39
+ version: "0.2.1232",
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.1230",
8
+ version: "0.2.1232",
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.1230",
3
+ "version": "0.2.1232",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -3064,8 +3064,10 @@ export const getInstagramBusinessDiscovery = <ThrowOnError extends boolean = fal
3064
3064
  * - `live`: fetched from Meta in real time (story is still active)
3065
3065
  * - `cached`: fetched from a persisted `story_insights` webhook payload
3066
3066
  * (story has expired but we received its final-state metrics from Meta)
3067
- * - `unavailable`: story has expired and we never received its webhook
3068
- * payload (for example, the account connected after the story expired)
3067
+ * - `unavailable`: story has expired and Meta sent no `story_insights` webhook for it.
3068
+ * Meta sends it most reliably for accounts connected with Facebook Login or with their
3069
+ * linked Facebook Page connected, so read insights while the story is live if you need
3070
+ * final numbers.
3069
3071
  *
3070
3072
  * Meta can report an expired story as an empty successful result rather
3071
3073
  * than an error, so an expired story resolves to `cached` or `unavailable`
@@ -10822,7 +10824,7 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
10822
10824
  * `creative.squareImageUrl`. Each image URL is uploaded as a new Google asset and the ad
10823
10825
  * is pointed at it; Google assets are immutable, so the previous asset stays in the
10824
10826
  * account's asset library. A new landscape image also updates `creative.assetResourceName`
10825
- * to the new asset.
10827
+ * to the new asset, and each replaced image updates its own role in `creative.assets`.
10826
10828
  * - **Performance Max**: top-level `assetGroup`, which swaps asset roles on the ad's asset
10827
10829
  * group. The other creative fields return 422 for this channel, and `assetGroup` returns
10828
10830
  * 422 on any other channel.
@@ -332,6 +332,29 @@ export type Ad = {
332
332
  * Google Display only. Resource name of the landscape marketing image asset (`creative.imageUrl`), for example customers/1234567890/assets/123. Set at creation and updated when PUT /v1/ads/{adId} replaces `creative.imageUrl`; replacing only `creative.squareImageUrl` leaves it unchanged.
333
333
  */
334
334
  assetResourceName?: string;
335
+ /**
336
+ * Google Display only. Native Google asset resource name of each image on the responsive display ad, keyed by Google's image role. Set at creation for ads created through Zernio. PUT /v1/ads/{adId} overwrites only the role it replaces: `creative.imageUrl` updates `marketingImages`, `creative.squareImageUrl` updates `squareMarketingImages`. Absent on ads synced from Google.
337
+ */
338
+ assets?: {
339
+ /**
340
+ * Landscape (1.91:1) marketing images. The first item matches `assetResourceName`.
341
+ */
342
+ marketingImages?: Array<{
343
+ /**
344
+ * Google asset resource name, for example customers/1234567890/assets/123.
345
+ */
346
+ resourceName?: string;
347
+ }>;
348
+ /**
349
+ * Square (1:1) marketing images.
350
+ */
351
+ squareMarketingImages?: Array<{
352
+ /**
353
+ * Google asset resource name, for example customers/1234567890/assets/124.
354
+ */
355
+ resourceName?: string;
356
+ }>;
357
+ };
335
358
  /**
336
359
  * Meta video ID for VIDEO-type ads. Null for non-video ads. Callers that need an embeddable MP4 can call GET /{videoId}?fields=source with the page access token.
337
360
  */
@@ -17727,9 +17750,9 @@ export type GetInstagramAccountInsightsData = {
17727
17750
  /**
17728
17751
  * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
17729
17752
  * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
17730
- * replies, reposts, follows_and_unfollows, profile_links_taps.
17753
+ * replies, reposts, follows_and_unfollows, profile_links_taps, profile_views, website_clicks.
17731
17754
  * Note: only "reach" supports metricType=time_series. All other metrics (including
17732
- * follows_and_unfollows) are total_value only. This is an Instagram Graph API limitation,
17755
+ * follows_and_unfollows, profile_views and website_clicks) are total_value only. This is an Instagram Graph API limitation,
17733
17756
  * not a Zernio limitation - the IG API does not return time-series data for these metrics.
17734
17757
  * For a daily running follower count, use /v1/analytics/instagram/follower-history instead.
17735
17758
  *