late-sdk 0.0.908 → 0.0.910

data/spec/api/ad_accounts_api_spec.rb

@@ -93,7 +93,7 @@ describe 'AdAccountsApi' do
   end
 
   # unit tests for create_custom_conversion
-  # Create or reuse a custom conversion
+  # Create custom conversion
   # Provision the Meta custom conversion an ads flow optimises toward, and hand back the `customConversionId` for `promotedObject.customConversionId` on POST /v1/ads/create. Removes the manual \"create it in Ads Manager first\" step.  **Reuse is ours, not Meta's.** Meta's create is not idempotent, so a retried request would otherwise mint a duplicate carrying none of the original's optimisation history. A non-archived conversion with the same `name` on the same `pixelId` is returned instead of created, with `reused: true` and a 200 rather than a 201.  `rule` is forwarded verbatim in Meta's own grammar (e.g. `{\"url\": {\"i_contains\": \"thank-you\"}}`); Meta validates it and rejects a malformed one with \"A conversion rule is required at creation time\".
   # @param account_id Meta ads SocialAccount id.
   # @param create_custom_conversion_request 
@@ -131,7 +131,7 @@ describe 'AdAccountsApi' do
 
   # unit tests for delete_ad_comment
   # Delete an ad comment
-  # Delete your own TikTok ad comment or reply. TikTok must return can_delete=true for the comment. Other users' comments can be hidden instead.  Requires Ads access. The ad is resolved within the caller's accessible profiles. Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing. The default search window is the last 30 days. Use since/until for older comments, with at most 30 days between the dates. Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded. Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments. 
+  # Delete your own TikTok ad comment or reply. TikTok must return can_delete=true for the comment. Other users' comments can be hidden instead.  Unknown identity and video item fields are resolved only when needed for this action, then persisted for reuse. Comment-specific fields take precedence. If TikTok no longer returns the ad needed to resolve identity, 404 ad_not_found directs you to check deletion or archival in TikTok Ads Manager. Listing can still succeed. Unsupported or unavailable identity returns 403 feature_not_available. Denied access to ad details returns 403 insufficient_permissions with reconnect guidance and the upstream platformError.  Requires Ads access. The ad is resolved within the caller's accessible profiles. Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing. The default search window is the last 30 days. Use since/until for older comments, with at most 30 days between the dates. Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded. Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments. 
   # @param ad_id Internal Zernio ad ID or indexed platform ad ID.
   # @param comment_id TikTok comment ID from the ad comment listing.
   # @param [Hash] opts the optional parameters
@@ -187,7 +187,7 @@ describe 'AdAccountsApi' do
 
   # unit tests for get_ad_comments
   # List comments on an ad
-  # Returns comments on an ad's underlying creative post. Useful for moderating or analyzing engagement on dark posts (ad creatives that never went live organically), which the regular GET /v1/inbox/comments/{postId} endpoint cannot serve because dark posts are not in Zernio's post database.  An ad that runs on both Facebook feed and Instagram feed has two separate underlying posts with separate comment threads (the creative's effective_object_story_id and effective_instagram_media_id). Use the `placement` query param to pick one; with no param the Instagram side is returned when it exists, otherwise Facebook. The identifiers are read from the ad record (persisted during sync) with a Marketing-API fallback for ads that predate the field.  For Instagram-placed comments, the Instagram account that runs the ad must be connected to Zernio, because those comments are read through that account's token. If no connected Instagram account on the profile can read the ad's media, the call returns ads_connection_required (the Facebook side, if any, is still readable via ?placement=facebook).  TikTok uses the connected TikTok Ads advertiser token and supports both paid video ads and Spark Ads. `since` and `until` select a date window of at most 30 days; the default is the last 30 days. TikTok searches by ad group, so Zernio filters each page to this ad. A page can be empty while `pagination.hasMore` is true. Reuse `pagination.cursor` with the same `limit`; the cursor retains the date window. `placement` is Meta-only and returns a 400 for TikTok.  TikTok returns replies as separate comments with `parentId`; nested reply fetching is not supported. `canReply` requires a first-level comment and an identity with comment-management permission. `canDelete` reflects TikTok's own-comment deletion capability. `canHide` is supported and `canLike` is false. Use the ad comment reply, hide and delete operations below to moderate TikTok comments. Other platforms return feature_not_available.  Requires the Ads add-on. Response shape matches GET /v1/inbox/comments/{postId}.  The `{adId}` path segment accepts any identifier dialect Zernio indexes for the ad: Zernio internal `_id` (24-char hex), the numeric `platformAdId` (the value shipped in `comment.received` webhooks as `comment.ad.id`), or the creative's `effective_object_story_id` / `effective_instagram_media_id`. Caller doesn't need a translation step. 
+  # Returns comments on an ad's underlying creative post. Useful for moderating or analyzing engagement on dark posts (ad creatives that never went live organically), which the regular GET /v1/inbox/comments/{postId} endpoint cannot serve because dark posts are not in Zernio's post database.  An ad that runs on both Facebook feed and Instagram feed has two separate underlying posts with separate comment threads (the creative's effective_object_story_id and effective_instagram_media_id). Use the `placement` query param to pick one; with no param the Instagram side is returned when it exists, otherwise Facebook. The identifiers are read from the ad record (persisted during sync) with a Marketing-API fallback for ads that predate the field.  For Instagram-placed comments, the Instagram account that runs the ad must be connected to Zernio, because those comments are read through that account's token. If no connected Instagram account on the profile can read the ad's media, the call returns ads_connection_required (the Facebook side, if any, is still readable via ?placement=facebook).  TikTok uses the connected TikTok Ads advertiser token and supports both paid video ads and Spark Ads. `since` and `until` select a date window of at most 30 days; the default is the last 30 days. TikTok searches by ad group, so Zernio filters each page to this ad. A page can be empty while `pagination.hasMore` is true. Reuse `pagination.cursor` with the same `limit`; the cursor retains the date window. `placement` is Meta-only and returns a 400 for TikTok. Listing needs no identity or video item ID. When the ad group is stored, each page makes one comment-list call and no ad-detail lookup, including for external ads that TikTok no longer returns from ad details. `meta.tiktokItemId: null` does not prevent listing. If the ad group is missing, Zernio fetches ad details; unavailable details return 404 ad_not_found, and no ad group returns 400 ad_not_commentable.  TikTok returns replies as separate comments with `parentId`; nested reply fetching is not supported. `canReply` requires a first-level comment, comment-management permission, a video item ID and a supported TT_USER or CUSTOMIZED_USER identity. `canDelete` requires TikTok's own-comment deletion capability, a video item ID and a supported identity. Both flags are false when identity or item is unknown. Listing uses stored and comment-specific fields without fetching identity. A direct reply or delete request can lazily resolve missing fields and succeed even after a false flag. `canHide` is true because visibility changes need only advertiser and comment IDs. `canLike` is false. Use the ad comment reply, hide and delete operations below to moderate TikTok comments. Other platforms return feature_not_available.  Requires the Ads add-on. Response shape matches GET /v1/inbox/comments/{postId}.  The `{adId}` path segment accepts any identifier dialect Zernio indexes for the ad: Zernio internal `_id` (24-char hex), the numeric `platformAdId` (the value shipped in `comment.received` webhooks as `comment.ad.id`), or the creative's `effective_object_story_id` / `effective_instagram_media_id`. Caller doesn't need a translation step. 
   # @param ad_id Internal Zernio ad ID or indexed platform ad/post ID.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :placement Which side of the ad to return comments for. Omit to default to the Instagram side when present, else Facebook. Returns ad_not_commentable if the ad has no such placement.
@@ -249,7 +249,7 @@ describe 'AdAccountsApi' do
   end
 
   # unit tests for get_dsa_recommendations
-  # List DSA beneficiary/payor suggestions
+  # Get DSA recommendations
   # Returns Meta's suggested beneficiary/payor names for an ad account, derived by Meta from the account's recent activity. Useful for prefilling `dsaBeneficiary`/`dsaPayor` inputs, or the defaults sent to `PATCH /v1/ads/accounts`, in your own UI.  Meta returns a single flat list. Entries are not labeled as beneficiary or payor, and since these are legal disclosures Zernio never applies them automatically: let your user pick the right entity. The list may be empty for accounts with little activity. Meta accounts only. 
   # @param account_id Account ID (metaads, or a facebook/instagram posting account)
   # @param ad_account_id Meta ad account ID (act_...)
@@ -290,7 +290,7 @@ describe 'AdAccountsApi' do
 
   # unit tests for hide_ad_comment
   # Hide or unhide an ad comment
-  # Hide or restore a TikTok ad comment. Send hidden=true to hide it or hidden=false to make it public again.  Requires Ads access. The ad is resolved within the caller's accessible profiles. Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing. The default search window is the last 30 days. Use since/until for older comments, with at most 30 days between the dates. Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded. Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments. 
+  # Hide or restore a TikTok ad comment. Send hidden=true to hide it or hidden=false to make it public again. Identity and video item ID are not required; no identity lookup is performed.  Requires Ads access. The ad is resolved within the caller's accessible profiles. Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing. The default search window is the last 30 days. Use since/until for older comments, with at most 30 days between the dates. Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded. Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments. 
   # @param ad_id Internal Zernio ad ID or indexed platform ad ID.
   # @param comment_id TikTok comment ID from the ad comment listing.
   # @param hide_ad_comment_request 
@@ -454,7 +454,7 @@ describe 'AdAccountsApi' do
   end
 
   # unit tests for list_high_demand_periods
-  # High demand periods / budget schedules
+  # List high-demand periods
   # Scheduled budget increases (Meta's budget-scheduling API). The Graph edge lives on the campaign and ad-set nodes only, so exactly one of `campaignId` / `adSetId` (platform ids) is required. Rows returned verbatim (budget_value, budget_value_type, time window, recurrence).
   # @param account_id Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
   # @param [Hash] opts the optional parameters
@@ -483,6 +483,20 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # unit tests for list_tik_tok_ad_pixels
+  # List TikTok ad pixels
+  # Lists pixels and their supported optimization events for a connected TikTok Ads account. The advertiser defaults to the first advertiser on the connection. Reconnect if Pixel Management permission has not been granted.
+  # @param account_id Zernio SocialAccount ID.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :advertiser_id Advertiser belonging to this connection.
+  # @option opts [String] :code Filter by a Pixel Code.
+  # @return [ListTikTokAdPixels200Response]
+  describe 'list_tik_tok_ad_pixels test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for list_value_rule_sets
   # List value rule sets
   # Lists the ad account's value rule sets (Meta's `/act_X/value_rule_set`). A value rule set adjusts the auction bid up or down for audience segments you value differently; attach one to an ad set with `valueRuleSetId` on `POST /v1/ads/create` or `PUT /v1/ads/ad-sets/{adSetId}`.  Rows are returned in the same camelCase shape the `PUT` body takes, ids included, so a set round-trips 1:1: **the update is a full replace, not a patch**, so you GET, mutate and send the whole thing back.  Limits: 6 rule sets per ad account, 10 rules per set, 4 criteria per rule.  **Rule order is semantic.** Rules are evaluated in array order and only the FIRST matching rule adjusts the bid for an overlapping audience. The order you send is the order that is stored and returned.  Eligibility: value rule sets apply only to ad sets on the `LOWEST_COST_WITHOUT_CAP` (auto-bid) or `COST_CAP` bid strategies. Meta rejects the rest server-side.
@@ -549,7 +563,7 @@ describe 'AdAccountsApi' do
 
   # unit tests for reply_to_ad_comment
   # Reply to an ad comment
-  # Reply to a first-level TikTok ad comment. Requires a TT_USER or CUSTOMIZED_USER identity with comment-management permission. Replies to replies are rejected. The response commentId identifies the new reply. This operation is not idempotent; do not blindly retry an uncertain response.  Requires Ads access. The ad is resolved within the caller's accessible profiles. Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing. The default search window is the last 30 days. Use since/until for older comments, with at most 30 days between the dates. Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded. Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments. 
+  # Reply to a first-level TikTok ad comment. Requires a TT_USER or CUSTOMIZED_USER identity with comment-management permission. Replies to replies are rejected. The response commentId identifies the new reply. This operation is not idempotent; do not blindly retry an uncertain response.  Unknown identity and video item fields are resolved only when needed for this action, then persisted for reuse. Comment-specific fields take precedence. If TikTok no longer returns the ad needed to resolve identity, 404 ad_not_found directs you to check deletion or archival in TikTok Ads Manager. Listing can still succeed. Unsupported or unavailable identity returns 403 feature_not_available. Denied access to ad details returns 403 insufficient_permissions with reconnect guidance and the upstream platformError.  Requires Ads access. The ad is resolved within the caller's accessible profiles. Before moderation, Zernio verifies that the comment belongs to this ad using TikTok's ad-group comment listing. The default search window is the last 30 days. Use since/until for older comments, with at most 30 days between the dates. Lookups scan at most 2,000 ad-group comments; narrow the date window if exceeded. Meta returns 501 feature_not_available with guidance to use the existing inbox comment endpoints and the account/post IDs from GET /v1/ads/{adId}/comments. 
   # @param ad_id Internal Zernio ad ID or indexed platform ad ID.
   # @param comment_id TikTok comment ID from the ad comment listing.
   # @param reply_to_ad_comment_request 

data/spec/api/ad_campaigns_api_spec.rb

@@ -33,7 +33,7 @@ describe 'AdCampaignsApi' do
   end
 
   # unit tests for add_ad_keywords
-  # Add Search keywords to an ad group
+  # Add Search ad-group keywords
   # Adds one or more keyword criteria to an existing Google Search ad group, without touching the keywords already there (unlike the whole-set diff on `PUT /v1/ads/{adId}`, `keywords`/`negativeKeywords` in `platformSpecificData`, which replaces the set). Set `negative: true` to add ad-group-level negatives instead of positive keywords. 
   # @param add_ad_keywords_request 
   # @param [Hash] opts the optional parameters
@@ -122,7 +122,7 @@ describe 'AdCampaignsApi' do
   end
 
   # unit tests for create_bid_strategy
-  # Create a Google Ads portfolio bid strategy
+  # Create portfolio bid strategy
   # Creates a standalone bid strategy shared across campaigns. Attach it to a campaign with `portfolioBidStrategyId` on POST /v1/ads/create, PUT /v1/ads/campaigns/{campaignId}, or PUT /v1/ads/ad-sets/{adSetId}. Attaching a strategy aligned to a shared budget fails there with a 400 (Google's `BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ALIGNED`); this is not retryable.
   # @param create_bid_strategy_request 
   # @param [Hash] opts the optional parameters
@@ -239,7 +239,7 @@ describe 'AdCampaignsApi' do
   end
 
   # unit tests for get_ad_set_details
-  # Live ad-set details incl. learning phase
+  # Get live ad-set details
   # Reads the ad set live from Meta, returned verbatim. The default projection includes `learning_stage_info` (learning-phase status: LEARNING / SUCCESS / FAIL / WAIVING; Meta omits its `status` key on paused ad sets), delivery settings, budgets, schedule and targeting. `fields` is a raw-passthrough override; unknown fields return Meta's 400 verbatim.
   # @param ad_set_id Meta ad set id (platformAdSetId).
   # @param account_id Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
@@ -427,7 +427,7 @@ describe 'AdCampaignsApi' do
   end
 
   # unit tests for list_bid_strategies
-  # List Google Ads portfolio bid strategies
+  # List portfolio bid strategies
   # Bidding strategy report: type, status, campaign count, clicks, cost, cost per conversion, impressions, average CPC and conversions over the date range (default last 30 days). Reads Google's `bidding_strategy` resource, cached for the quota window. Draws on the shared Google Ads operations budget. The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read.
   # @param account_id Google ads SocialAccount id.
   # @param [Hash] opts the optional parameters
@@ -662,7 +662,7 @@ describe 'AdCampaignsApi' do
   end
 
   # unit tests for update_bid_strategy
-  # Update a Google Ads portfolio bid strategy
+  # Update portfolio bid strategy
   # Renames or retargets a portfolio bid strategy. The strategy's status is output only on Google's side, so it cannot be changed here; remove a strategy in Google Ads. `type` is only needed alongside `targetCpa`/`targetRoas` to disambiguate the field Google writes to (TARGET_CPA and MAXIMIZE_CONVERSIONS both take a target CPA; TARGET_ROAS and MAXIMIZE_CONVERSION_VALUE both take a target ROAS); the strategy's family is otherwise immutable once created.
   # @param strategy_id Numeric Google Ads bid strategy id.
   # @param update_bid_strategy_request 

data/spec/api/ad_creatives_api_spec.rb

@@ -196,6 +196,46 @@ describe 'AdCreativesApi' do
     end
   end
 
+  # unit tests for list_partnership_ad_content
+  # List partnership ad content
+  # Private beta. Lists creator Instagram posts available to the advertiser for Partnership Ads. Supply creatorUsername or postUrl. Requires instagram_branded_content_ads_brand permission and an advertiser Instagram Business Account.
+  # @param account_id Zernio SocialAccount ID.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :creator_username Creator username. Required unless postUrl is supplied.
+  # @option opts [String] :post_url Instagram post permalink. Required unless creatorUsername is supplied.
+  # @option opts [Boolean] :only_allowlisted Return only creators with account-level permission.
+  # @return [ListPartnershipAdContent200Response]
+  describe 'list_partnership_ad_content test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for list_partnership_ad_permissions
+  # List partnership permissions
+  # Private beta. Lists granted or pending creator permissions for the advertiser Instagram Business Account. Requires instagram_branded_content_ads_brand permission.
+  # @param account_id Zernio SocialAccount ID.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :creator_username Filter by creator username.
+  # @return [ListPartnershipAdPermissions200Response]
+  describe 'list_partnership_ad_permissions test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for set_partnership_ad_permission
+  # Set partnership permission
+  # Private beta. Requests permission from a creator or revokes it when revoke is true. Requests require the creator to approve in Instagram. Requires instagram_branded_content_ads_brand permission.
+  # @param set_partnership_ad_permission_request 
+  # @param [Hash] opts the optional parameters
+  # @return [SetPartnershipAdPermission200Response]
+  describe 'set_partnership_ad_permission test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for update_ad_creative
   # Rename a creative
   # Renames a creative. Creatives are immutable on Meta beyond `name`. For content changes create a new creative (POST /v1/ads/creatives) and swap it onto the ad (PUT /v1/ads/{adId} with `creative`).

data/spec/api/ad_insights_api_spec.rb

@@ -33,7 +33,7 @@ describe 'AdInsightsApi' do
   end
 
   # unit tests for create_ad_insights_report
-  # Submit an async insights report run
+  # Submit async insights report
   # Submits an asynchronous Meta insights report. Same query surface as GET /v1/ads/insights, but in the JSON body; Meta processes the report server-side, which is the right choice for long ranges or large accounts where the sync query is slow or rate-limited. Returns a `reportRunId` to poll via GET /v1/ads/insights/reports/{reportRunId}. 
   # @param create_ad_insights_report_request 
   # @param [Hash] opts the optional parameters
@@ -45,7 +45,7 @@ describe 'AdInsightsApi' do
   end
 
   # unit tests for generate_keyword_historical_metrics
-  # Historical keyword metrics (Google Keyword Planner)
+  # Get historical keyword metrics
   # Google Ads only. Runs Keyword Planner's generateKeywordHistoricalMetrics for up to 1,000 exact keywords: historical search volume, competition and top-of-page bid ranges, plus averageCpcMicros when includeAverageCpc is set. Rows come back verbatim; counters are int64s encoded as strings, bid/CPC values are micros of the account currency. 
   # @param generate_keyword_historical_metrics_request 
   # @param [Hash] opts the optional parameters
@@ -57,7 +57,7 @@ describe 'AdInsightsApi' do
   end
 
   # unit tests for generate_keyword_ideas
-  # Generate keyword ideas (Google Keyword Planner)
+  # Generate keyword ideas
   # Google Ads only. Runs Keyword Planner's generateKeywordIdeas from seed keywords, a seed URL, or both, returning idea rows verbatim (avgMonthlySearches, competition, competitionIndex, top-of-page bid micros, monthlySearchVolumes). Counters are int64s encoded as strings; bid values are micros of the account currency. Omitting `countries` targets worldwide. 
   # @param generate_keyword_ideas_request 
   # @param [Hash] opts the optional parameters
@@ -133,7 +133,7 @@ describe 'AdInsightsApi' do
   end
 
   # unit tests for list_local_services_lead_conversations
-  # Conversations of a Local Services lead
+  # List lead conversations
   # Conversation entries of one Local Services lead: phone calls (duration, recording URL) and messages (text, attachment URLs), oldest first. Read live from `local_services_lead_conversation`, always scoped to a single lead. Call-recording URLs require read access on the Google Ads account. Draws on the shared Google Ads operations budget.
   # @param lead_id Numeric lead id from /v1/ads/local-services/leads.
   # @param account_id Google ads SocialAccount id.

data/spec/api/ad_targeting_api_spec.rb

@@ -57,7 +57,7 @@ describe 'AdTargetingApi' do
   end
 
   # unit tests for get_linked_in_supply_forecast
-  # Impressions, clicks and spend forecast
+  # Forecast ad delivery
   # LinkedIn-only. Forecasted impressions, clicks, spend and ~20 other metrics for a targeting spec over a time range. Wraps LinkedIn's `adSupplyForecasts` finder.  Each returned series carries a `metricType` (IMPRESSION, CLICK, SPENDING, MAX_POTENTIAL_BUDGET, COST_PER_MILLION_IMPRESSIONS, ...) and a `granularity` (DAILY, SEVEN_DAY, THIRTY_DAY, CUSTOM). LinkedIn caps the daily spending forecast at 1.2x the daily budget and returns 0 once the total budget is exhausted.  Non-LinkedIn accounts return `available: false`. 
   # @param get_linked_in_supply_forecast_request 
   # @param [Hash] opts the optional parameters

data/spec/api/conversions_api_spec.rb

@@ -59,7 +59,7 @@ describe 'ConversionsApi' do
   end
 
   # unit tests for create_conversion_action
-  # Create a website conversion action
+  # Create website conversion action
   # Creates a `WEBPAGE` conversion action (category `DEFAULT`) and returns it with its tag snippets, read back after creation since Google never returns them on the create response itself. Invalidates the cached list `GET` on this resource would otherwise keep serving. Google-only; other platforms return `501`. Requires the Ads add-on. 
   # @param create_conversion_action_request 
   # @param [Hash] opts the optional parameters
@@ -142,7 +142,7 @@ describe 'ConversionsApi' do
   end
 
   # unit tests for list_conversion_actions
-  # List conversion actions and their tag snippets
+  # List conversion actions
   # Lists Google Ads conversion actions on the resolved customer, all types by default. Each action's `tagSnippets` (global site tag + event snippet) is included when Google has them for that action's type, e.g. `WEBPAGE`. Google-only; other platforms return `501`. Requires the Ads add-on.  `customerId` is optional: when omitted, it is resolved from the connection's accessible Google Ads customers, and the call fails with `400` when more than one is accessible (pass `customerId` to disambiguate).  The list itself is cached for the quota window (1 hour fresh, up to 7 days last-good; the cache key does not vary on `type`). The response carries `cachedAt` and `stale`, set when a quota-exhausted call falls back to the last-good copy instead of a live read. 
   # @param account_id SocialAccount _id (must be a googleads account).
   # @param [Hash] opts the optional parameters

data/spec/api/reach_and_frequency_api_spec.rb

@@ -33,7 +33,7 @@ describe 'ReachAndFrequencyApi' do
   end
 
   # unit tests for cancel_rf_reservation
-  # Cancel a Reach & Frequency reservation
+  # Cancel reach-frequency booking
   # Releases a RESERVATION's locked price and inventory. Unreserved predictions expire on their own.
   # @param prediction_id 
   # @param account_id 
@@ -47,7 +47,7 @@ describe 'ReachAndFrequencyApi' do
   end
 
   # unit tests for create_rf_prediction
-  # Create a Reach & Frequency prediction
+  # Create reach-frequency prediction
   # Creates an R&F prediction. This is a QUOTE, nothing is bought and no ad entities are created. Provide a date range plus exactly one of `budgetAmount` (Meta predicts reach) or `reach` (Meta predicts the budget). The response carries the estimate and its allowed bounds (min/max budget and reach). Predictions expire on their own; to buy, reserve one via POST /v1/ads/rf-predictions/{predictionId}/reserve and pass the RESERVED id to POST /v1/ads/create with `buyingType: \"RESERVED\"`.  Reservation campaigns reject automatic placements. Top-level `placements` wins; when it is omitted, `targeting.placements` is used; when neither is set, placements default to Facebook feed (+ Instagram stream when a linked IG professional account resolves). Instagram placements require that IG account.
   # @param create_rf_prediction_request 
   # @param [Hash] opts the optional parameters
@@ -59,7 +59,7 @@ describe 'ReachAndFrequencyApi' do
   end
 
   # unit tests for get_rf_prediction
-  # Read a Reach & Frequency prediction
+  # Get reach-frequency prediction
   # @param prediction_id 
   # @param account_id 
   # @param ad_account_id 
@@ -72,7 +72,7 @@ describe 'ReachAndFrequencyApi' do
   end
 
   # unit tests for reserve_rf_prediction
-  # Reserve a Reach & Frequency prediction
+  # Reserve reach-frequency inventory
   # Locks the quoted price + inventory until the returned `expiresAt` and mints a NEW prediction id. Pass that RESERVED id (not the original) as `rfPredictionId` on POST /v1/ads/create. Release an unused reservation via DELETE.
   # @param prediction_id 
   # @param reserve_rf_prediction_request 

data/spec/models/list_partnership_ad_content200_response_media_inner_spec.rb

@@ -0,0 +1,72 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListPartnershipAdContent200ResponseMediaInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListPartnershipAdContent200ResponseMediaInner do
+  #let(:instance) { Zernio::ListPartnershipAdContent200ResponseMediaInner.new }
+
+  describe 'test an instance of ListPartnershipAdContent200ResponseMediaInner' do
+    it 'should create an instance of ListPartnershipAdContent200ResponseMediaInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListPartnershipAdContent200ResponseMediaInner)
+    end
+  end
+
+  describe 'test attribute "id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "permalink"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "owner_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "has_permission_for_partnership_ad"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "is_creator_allowlisted"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "eligibility_errors"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "recommended_campaign_objectives"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/list_partnership_ad_content200_response_spec.rb

@@ -0,0 +1,36 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListPartnershipAdContent200Response
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListPartnershipAdContent200Response do
+  #let(:instance) { Zernio::ListPartnershipAdContent200Response.new }
+
+  describe 'test an instance of ListPartnershipAdContent200Response' do
+    it 'should create an instance of ListPartnershipAdContent200Response' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListPartnershipAdContent200Response)
+    end
+  end
+
+  describe 'test attribute "media"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/list_partnership_ad_permissions200_response_permissions_inner_spec.rb

@@ -0,0 +1,48 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListPartnershipAdPermissions200ResponsePermissionsInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListPartnershipAdPermissions200ResponsePermissionsInner do
+  #let(:instance) { Zernio::ListPartnershipAdPermissions200ResponsePermissionsInner.new }
+
+  describe 'test an instance of ListPartnershipAdPermissions200ResponsePermissionsInner' do
+    it 'should create an instance of ListPartnershipAdPermissions200ResponsePermissionsInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListPartnershipAdPermissions200ResponsePermissionsInner)
+    end
+  end
+
+  describe 'test attribute "id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "permission_type"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "status"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/list_partnership_ad_permissions200_response_spec.rb

@@ -0,0 +1,36 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListPartnershipAdPermissions200Response
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListPartnershipAdPermissions200Response do
+  #let(:instance) { Zernio::ListPartnershipAdPermissions200Response.new }
+
+  describe 'test an instance of ListPartnershipAdPermissions200Response' do
+    it 'should create an instance of ListPartnershipAdPermissions200Response' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListPartnershipAdPermissions200Response)
+    end
+  end
+
+  describe 'test attribute "permissions"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/list_tik_tok_ad_pixels200_response_pixels_inner_event_details_inner_spec.rb

@@ -0,0 +1,48 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListTikTokAdPixels200ResponsePixelsInnerEventDetailsInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListTikTokAdPixels200ResponsePixelsInnerEventDetailsInner do
+  #let(:instance) { Zernio::ListTikTokAdPixels200ResponsePixelsInnerEventDetailsInner.new }
+
+  describe 'test an instance of ListTikTokAdPixels200ResponsePixelsInnerEventDetailsInner' do
+    it 'should create an instance of ListTikTokAdPixels200ResponsePixelsInnerEventDetailsInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListTikTokAdPixels200ResponsePixelsInnerEventDetailsInner)
+    end
+  end
+
+  describe 'test attribute "name"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "optimization_event"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "custom"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/models/list_tik_tok_ad_pixels200_response_pixels_inner_spec.rb

@@ -0,0 +1,60 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Zernio::ListTikTokAdPixels200ResponsePixelsInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ListTikTokAdPixels200ResponsePixelsInner do
+  #let(:instance) { Zernio::ListTikTokAdPixels200ResponsePixelsInner.new }
+
+  describe 'test an instance of ListTikTokAdPixels200ResponsePixelsInner' do
+    it 'should create an instance of ListTikTokAdPixels200ResponsePixelsInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ListTikTokAdPixels200ResponsePixelsInner)
+    end
+  end
+
+  describe 'test attribute "pixel_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "pixel_code"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "name"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "events"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "event_details"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end