@getlatedev/node 0.2.1249 → 0.2.1251

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.
@@ -918,7 +918,11 @@ export type AdFunnelCounts = {
918
918
  */
919
919
  paymentInfoAdds?: number;
920
920
  /**
921
- * Purchases (Meta `Purchase` pixel event). Pair with `purchaseValue` for revenue.
921
+ * Purchases. Meta reports one purchase under several action types at once, so this takes the FIRST one present, in this order, never a sum: `offsite_conversion.fb_pixel_purchase`, `omni_purchase`, `app_custom_event.fb_mobile_purchase`, `onsite_conversion.purchase`, `purchase`.
922
+ * It always counts purchases, whatever the ad set optimizes for. `conversions` instead follows the ad set's optimization event (PURCHASE when the ad set names none), so the two can differ on any other goal.
923
+ * TikTok: app purchases (`purchase`), else website complete payments (`complete_payment`), else Place an Order (`place_order`).
924
+ * Pair with `purchaseValue` for revenue.
925
+ *
922
926
  */
923
927
  purchases?: number;
924
928
  /**
@@ -6799,6 +6803,26 @@ export type GoogleAdsUserAccessInvitationResult = {
6799
6803
  */
6800
6804
  export type status20 = 'PENDING' | 'PENDING_APPROVAL';
6801
6805
 
6806
+ export type GoogleAdsUserInvitationApproval = {
6807
+ /**
6808
+ * Pass to DELETE /v1/ads/accounts/user-invitations/pending-approvals to withdraw the request.
6809
+ */
6810
+ multiPartyAuthReviewId?: string;
6811
+ /**
6812
+ * Invited email address.
6813
+ */
6814
+ emailAddress?: (string) | null;
6815
+ accessRole?: 'ADMIN' | 'STANDARD' | 'READ_ONLY' | 'EMAIL_ONLY' | 'UNKNOWN';
6816
+ /**
6817
+ * Google user who sent the invitation. Only this user can withdraw it.
6818
+ */
6819
+ requestUserEmail?: (string) | null;
6820
+ /**
6821
+ * Google's creation time, yyyy-MM-dd HH:mm:ss.ssssss in the account's time zone.
6822
+ */
6823
+ createdAt?: (string) | null;
6824
+ };
6825
+
6802
6826
  /**
6803
6827
  * Link one asset to the asset group. Send exactly one of asset (an existing asset), text, imageUrl or youtubeVideoId (new content, created in the same request).
6804
6828
  */
@@ -8268,6 +8292,29 @@ export type metric = 'follower_demographics' | 'engaged_audience_demographics';
8268
8292
  */
8269
8293
  export type timeframe = 'this_week' | 'this_month';
8270
8294
 
8295
+ export type InstagramLiveMedia = {
8296
+ /**
8297
+ * Instagram media ID of the live broadcast.
8298
+ */
8299
+ id: string;
8300
+ /**
8301
+ * BROADCAST for a live video.
8302
+ */
8303
+ mediaType: (string) | null;
8304
+ /**
8305
+ * LIVE for a live video.
8306
+ */
8307
+ mediaProductType: (string) | null;
8308
+ /**
8309
+ * Instagram handle of the broadcasting account.
8310
+ */
8311
+ username: (string) | null;
8312
+ /**
8313
+ * Creation time of the broadcast media as Meta returns it (ISO 8601).
8314
+ */
8315
+ timestamp: (string) | null;
8316
+ };
8317
+
8271
8318
  export type InstagramMediaCollaborator = {
8272
8319
  /**
8273
8320
  * App-scoped ID of the collaborator's Instagram account.
@@ -26257,6 +26304,21 @@ export type ListInstagramMediaCollaboratorsResponse = ({
26257
26304
 
26258
26305
  export type ListInstagramMediaCollaboratorsError = (ErrorResponse);
26259
26306
 
26307
+ export type ListInstagramLiveMediaData = {
26308
+ path: {
26309
+ /**
26310
+ * The ID of a connected Instagram account (Facebook Login).
26311
+ */
26312
+ accountId: string;
26313
+ };
26314
+ };
26315
+
26316
+ export type ListInstagramLiveMediaResponse = ({
26317
+ data: Array<InstagramLiveMedia>;
26318
+ });
26319
+
26320
+ export type ListInstagramLiveMediaError = (ErrorResponse);
26321
+
26260
26322
  export type GetInstagramStoryInsightsData = {
26261
26323
  path: {
26262
26324
  /**
@@ -47835,7 +47897,7 @@ export type ListAdAccountUserInvitationsResponse = ({
47835
47897
  customerId?: string;
47836
47898
  invitations?: Array<GoogleAdsUserAccessInvitation>;
47837
47899
  /**
47838
- * When this data was fetched from Google. Null on a live read.
47900
+ * When this data was fetched from Google. Null when the cache is unavailable.
47839
47901
  */
47840
47902
  cachedAt?: (string) | null;
47841
47903
  /**
@@ -47894,6 +47956,59 @@ export type RevokeAdAccountUserInvitationResponse = ({
47894
47956
 
47895
47957
  export type RevokeAdAccountUserInvitationError = (ErrorResponse | unknown);
47896
47958
 
47959
+ export type ListAdAccountUserInvitationApprovalsData = {
47960
+ query: {
47961
+ /**
47962
+ * Google ads SocialAccount id.
47963
+ */
47964
+ accountId: string;
47965
+ /**
47966
+ * Google Ads customer id, digits only. Defaults to the connection's selected customer.
47967
+ */
47968
+ adAccountId?: string;
47969
+ };
47970
+ };
47971
+
47972
+ export type ListAdAccountUserInvitationApprovalsResponse = ({
47973
+ customerId?: string;
47974
+ approvals?: Array<GoogleAdsUserInvitationApproval>;
47975
+ /**
47976
+ * When this data was fetched from Google. Null when the cache is unavailable.
47977
+ */
47978
+ cachedAt?: (string) | null;
47979
+ /**
47980
+ * True when Google's quota was exhausted and this is the last successful fetch.
47981
+ */
47982
+ stale?: boolean;
47983
+ });
47984
+
47985
+ export type ListAdAccountUserInvitationApprovalsError = (ErrorResponse | unknown);
47986
+
47987
+ export type WithdrawAdAccountUserInvitationApprovalData = {
47988
+ query: {
47989
+ /**
47990
+ * Google ads SocialAccount id.
47991
+ */
47992
+ accountId: string;
47993
+ /**
47994
+ * Google Ads customer id, digits only.
47995
+ */
47996
+ adAccountId: string;
47997
+ /**
47998
+ * Numeric review id from POST /v1/ads/accounts/user-invitations or GET /v1/ads/accounts/user-invitations/pending-approvals.
47999
+ */
48000
+ multiPartyAuthReviewId: string;
48001
+ };
48002
+ };
48003
+
48004
+ export type WithdrawAdAccountUserInvitationApprovalResponse = ({
48005
+ customerId?: string;
48006
+ multiPartyAuthReviewId?: string;
48007
+ status?: 'REVOKED';
48008
+ });
48009
+
48010
+ export type WithdrawAdAccountUserInvitationApprovalError = (ErrorResponse | unknown);
48011
+
47897
48012
  export type ListAdAccountUsersData = {
47898
48013
  query: {
47899
48014
  /**
@@ -49365,7 +49480,7 @@ export type CreateStandaloneAdData = {
49365
49480
  */
49366
49481
  aiDisclosure?: 'OPT_IN' | 'OPT_OUT';
49367
49482
  /**
49368
- * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image, all-image placementAssets with per-rule copy, existing video.id or existingCreativeId; other media pools, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. ChatGPT (OpenAI) has no platform dry-run: Zernio runs every check it knows (creative lengths, budget, bid strategy, targeting) plus live lookups of the conversion event and target countries, and uploads or creates nothing. OpenAI's own write-time checks (image fetch, currency-specific minimums, ad review) still run only on a real create. Any other platform, or a Google campaignType other than pmax or demand_gen, returns 501 `feature_not_available`.
49483
+ * Google Performance Max validates the complete atomic campaign and asset group with no resource creation or local persistence. Google validation still downloads image URLs and consumes quota. On Meta, validates the complete inline campaign, ad set, creative and ad with execution_options validate_only. Nothing is uploaded or created, and validation bypasses Idempotency-Key storage. Supports a single image or existing video.id (each also with bodies[] / headlines[] Multiple Text Options), all-image placementAssets with per-rule copy and text pools, or existingCreativeId; dynamicCreative, translations, carouselCards, placement videos, new video uploads, creatives[], adSetId and RESERVED buying return 400. Placement validation uses existing Instagram identities only. Existing campaign or creative nodes are marked skipped. Success returns 200 with per-node results; Meta rejection returns an error. ChatGPT (OpenAI) has no platform dry-run: Zernio runs every check it knows (creative lengths, budget, bid strategy, targeting) plus live lookups of the conversion event and target countries, and uploads or creates nothing. OpenAI's own write-time checks (image fetch, currency-specific minimums, ad review) still run only on a real create. Any other platform, or a Google campaignType other than pmax or demand_gen, returns 501 `feature_not_available`.
49369
49484
  */
49370
49485
  validateOnly?: boolean;
49371
49486
  /**