late-sdk 0.0.899 → 0.0.901

data/spec/api/ad_accounts_api_spec.rb

@@ -33,8 +33,8 @@ describe 'AdAccountsApi' do
   end
 
   # unit tests for add_account_callouts
-  # Add account-level callout extensions
-  # Creates one asset plus one `customerAsset` link (field type CALLOUT) per callout text, in a single mutate. Google only; every other platform returns 501.
+  # Add account callouts
+  # Creates assets and customer_asset links for this Google customer. Links apply at account level.
   # @param add_account_callouts_request 
   # @param [Hash] opts the optional parameters
   # @return [AddAccountCallouts201Response]
@@ -44,6 +44,30 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # unit tests for add_account_sitelinks
+  # Add account sitelinks
+  # Creates assets and customer_asset links for this Google customer. Links apply at account level.
+  # @param add_account_sitelinks_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AddAccountSitelinks201Response]
+  describe 'add_account_sitelinks 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 add_account_structured_snippets
+  # Add account snippets
+  # Creates assets and customer_asset links for this Google customer. Links apply at account level.
+  # @param add_account_structured_snippets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AddAccountStructuredSnippets201Response]
+  describe 'add_account_structured_snippets 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 create_ad_negative_keyword_list
   # Create a negative keyword list
   # Creates one Google Ads shared negative keyword list with optional initial keywords in a single atomic mutation. Daily quota is reserved for every mutate item, so large batches may return 429 before any change. This operation is not idempotent. The list is not attached to any campaign.
@@ -93,6 +117,21 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # 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. 
+  # @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
+  # @option opts [Date] :since Start date of the comment lookup window. Defaults to 30 days before until.
+  # @option opts [Date] :_until End date of the comment lookup window. Defaults to today in UTC.
+  # @return [ReplyToAdComment200Response]
+  describe 'delete_ad_comment 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 delete_ad_negative_keyword_list
   # Delete a negative keyword list
   # Removes the Google shared negative keyword list. Detach it from all campaigns first; an in-use list is rejected. Only NEGATIVE_KEYWORDS shared sets are supported.
@@ -136,11 +175,13 @@ 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).  Meta-only for now. Other ad platforms (TikTok, LinkedIn, Pinterest, Google, X) are not wired to this endpoint and 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), Meta's 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 (ObjectId).
+  # 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. 
+  # @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.
   # @option opts [Integer] :limit 
+  # @option opts [Date] :since TikTok-only start date. Defaults to 30 days before until. Maximum window is 30 days.
+  # @option opts [Date] :_until TikTok-only end date. Defaults to today in UTC.
   # @option opts [String] :cursor Pagination cursor from a previous response.
   # @return [GetAdComments200Response]
   describe 'get_ad_comments test' do
@@ -208,6 +249,20 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # unit tests for get_ios_fourteen_campaign_limits
+  # Get iOS 14 campaign limits
+  # Reads Meta iOS 14 campaign limits for an application on an ad account. applicationId is sent as Meta app_id. This read does not establish that the application is configured for iOS promotion.
+  # @param account_id Zernio Meta Ads or Facebook SocialAccount ID.
+  # @param ad_account_id Meta ad account ID including the act_ prefix.
+  # @param application_id Meta application ID from advertisable-applications.
+  # @param [Hash] opts the optional parameters
+  # @return [GetIosFourteenCampaignLimits200Response]
+  describe 'get_ios_fourteen_campaign_limits 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 get_value_rule_set
   # Read a value rule set
   # Reads one value rule set including every nested rule id and criterion id. This is step one of any edit: `PUT` is a full replace, so you need the ids before you can keep the objects you are not changing.  Meta's own read returns `GENDER` values lowercase (`\"male\"`) while writes require `\"MALE\"`. Values are passed through untouched, so never case-compare a stored rule against a fetched one.
@@ -221,12 +276,28 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # 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. 
+  # @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 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Date] :since Start date of the comment lookup window. Defaults to 30 days before until.
+  # @option opts [Date] :_until End date of the comment lookup window. Defaults to today in UTC.
+  # @return [HideAdComment200Response]
+  describe 'hide_ad_comment 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_account_callouts
-  # List account-level callout extensions
-  # Google Ads compliance row C.75: callout assets linked at the CUSTOMER level via `customer_asset` (not a campaign or ad group), so they serve fleet-wide across the account. Google only; every other platform returns 501. Cached for the quota window (10 minutes fresh, up to 7 days last-good), and gated by the shared Google Ads operations budget on a cache miss. 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.
+  # List account callouts
+  # Lists directly attached Google assets. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included. Preserves Google RMF C.75 account-level callouts.
+  # @param account_id 
   # @param [Hash] opts the optional parameters
-  # @option opts [String] :customer_id Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.
+  # @option opts [String] :customer_id 
   # @return [ListAccountCallouts200Response]
   describe 'list_account_callouts test' do
     it 'should work' do
@@ -234,6 +305,32 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # unit tests for list_account_sitelinks
+  # List account sitelinks
+  # Lists directly attached Google assets. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included.
+  # @param account_id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :customer_id 
+  # @return [ListAccountSitelinks200Response]
+  describe 'list_account_sitelinks 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_account_structured_snippets
+  # List account snippets
+  # Lists directly attached Google assets. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included.
+  # @param account_id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :customer_id 
+  # @return [ListAccountStructuredSnippets200Response]
+  describe 'list_account_structured_snippets 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_ad_accounts
   # List ad accounts
   # Returns the platform ad accounts available for the given account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs).  For TikTok agencies: enumerates every advertiser under every Business Center the token can read (paginated server-side), then chunks the lookup against TikTok's `/advertiser/info/` endpoint (which has a per-call cap of ≤100 IDs). Solo advertisers without a BC fall back to the OAuth-time `advertiser_ids` list. Cached for 1h on the SocialAccount; lazy-refreshed on first call after expiry.  For Google Ads: responds `429` when Google's API quota is temporarily exhausted (instead of an empty list). Retry after a delay. 
@@ -305,6 +402,32 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # unit tests for list_ads_instagram_accounts
+  # List Instagram ad identities
+  # Discovers identities through connected_instagram_accounts, Page linkage and Page-backed identities, with a best-effort business fallback. Business permission errors do not fail discovery. The resolved object uses the same profile-scoped resolver as ad creation; null means no identity was resolved. Format-specific observed-actor fallbacks at creative creation are not predicted.
+  # @param account_id Zernio Meta Ads or Facebook SocialAccount ID.
+  # @param ad_account_id Meta ad account ID including the act_ prefix.
+  # @param [Hash] opts the optional parameters
+  # @return [ListAdsInstagramAccounts200Response]
+  describe 'list_ads_instagram_accounts 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_advertisable_applications
+  # List advertisable apps
+  # Lists applications available to a Meta ad account, their supported platforms and unmodified object store URLs. A listed app still needs a configured mobile platform and store URL to run install promotion.
+  # @param account_id Zernio Meta Ads or Facebook SocialAccount ID.
+  # @param ad_account_id Meta ad account ID including the act_ prefix.
+  # @param [Hash] opts the optional parameters
+  # @return [ListAdvertisableApplications200Response]
+  describe 'list_advertisable_applications 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_custom_conversions
   # List custom conversions
   # The ad account's Meta custom conversions, including archived ones (`isArchived`).
@@ -364,8 +487,8 @@ describe 'AdAccountsApi' do
   end
 
   # unit tests for remove_account_callout
-  # Remove an account-level callout extension
-  # Removes the `customerAsset` link (`customers/{cid}/customerAssets/{assetId}~CALLOUT`). Google only; every other platform returns 501.
+  # Remove account callout
+  # Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain.
   # @param remove_account_callout_request 
   # @param [Hash] opts the optional parameters
   # @return [RemoveAccountCallout200Response]
@@ -375,6 +498,30 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # unit tests for remove_account_sitelink
+  # Remove account sitelink
+  # Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain.
+  # @param remove_account_callout_request 
+  # @param [Hash] opts the optional parameters
+  # @return [RemoveAccountCallout200Response]
+  describe 'remove_account_sitelink 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 remove_account_structured_snippet
+  # Remove account snippet
+  # Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain.
+  # @param remove_account_callout_request 
+  # @param [Hash] opts the optional parameters
+  # @return [RemoveAccountCallout200Response]
+  describe 'remove_account_structured_snippet 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 replace_ad_negative_keyword_list_keywords
   # Replace negative list keywords
   # Replaces the full desired keyword set. Existing keywords are diffed by normalized text and match type; creates and removals are applied atomically in one mutation. Unchanged criteria retain their ids. Send an empty keywords array to clear the list. Changes affect every campaign using this list. Each create or removal consumes one daily operation; the entire batch must fit the remaining quota.
@@ -388,6 +535,58 @@ describe 'AdAccountsApi' do
     end
   end
 
+  # 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. 
+  # @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 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Date] :since Start date of the comment lookup window. Defaults to 30 days before until.
+  # @option opts [Date] :_until End date of the comment lookup window. Defaults to today in UTC.
+  # @return [ReplyToAdComment200Response]
+  describe 'reply_to_ad_comment 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_account_callouts
+  # Update account callouts
+  # Edits existing Google assets in place. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.
+  # @param update_account_callouts_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdateAccountCallouts200Response]
+  describe 'update_account_callouts 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_account_sitelinks
+  # Update account sitelinks
+  # Edits existing Google assets in place. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.
+  # @param update_account_sitelinks_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdateAccountCallouts200Response]
+  describe 'update_account_sitelinks 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_account_structured_snippets
+  # Update account snippets
+  # Edits existing Google assets in place. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.
+  # @param update_account_structured_snippets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdateAccountCallouts200Response]
+  describe 'update_account_structured_snippets 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_account
   # Update ad account settings
   # Sets the default DSA beneficiary and payor on a Meta ad account (EU DSA, Article 26). Set them once and every EU-targeted call to `/v1/ads/create`, `/v1/ads/boost` and `/v1/ads/ctwa` on that ad account can omit `dsaBeneficiary`/`dsaPayor`: Meta applies the defaults automatically.  The values are written to the ad account on Meta, the same setting Ads Manager edits. Nothing is stored in Zernio, and defaults already set in Ads Manager work identically. Zernio never guesses these values for you. Beneficiary and payor are legal disclosures shown to EU users, so you must provide the entity names explicitly. Use `GET /v1/ads/dsa-recommendations` to offer suggestions in your UI.  If `defaultDsaPayor` is omitted, the beneficiary is also set as the payor, which covers the common case where the same entity benefits from and pays for the ads. Read the current values back with `GET /v1/ads/dsa-defaults`.  Currently supported for Meta accounts only; other platforms return 400. 

data/spec/api/ad_campaigns_api_spec.rb

@@ -44,10 +44,23 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for attach_ad_group_assets
+  # Attach ad-group assets
+  # Creates and attaches sitelinks, callouts and structured snippets in one Google mutation.
+  # @param ad_set_id Numeric Google platform id.
+  # @param attach_campaign_assets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AttachAdGroupAssets201Response]
+  describe 'attach_ad_group_assets 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 attach_campaign_assets
-  # Attach extension assets to a Google Search campaign
-  # Attach sitelinks, callouts and/or structured snippets to an already-existing Google Search campaign. These are the same builders POST /v1/ads/create uses, but without rebuilding the hierarchy. At least one of sitelinks, callouts or structuredSnippets is required.  Google-only. Other platforms have no equivalent extension surface and return 501.  Approval status is Google-async; poll `asset.policy_summary` after review. Assets stay in the account library even if the campaign is later deleted.
-  # @param campaign_id Numeric Google platform campaign id.
+  # Attach campaign assets
+  # Creates and attaches sitelinks, callouts and structured snippets in one Google mutation.
+  # @param campaign_id Numeric Google platform id.
   # @param attach_campaign_assets_request 
   # @param [Hash] opts the optional parameters
   # @return [AttachCampaignAssets201Response]
@@ -88,7 +101,7 @@ describe 'AdCampaignsApi' do
   # @param create_ad_campaign_request 
   # @param [Hash] opts the optional parameters
   # @option opts [String] :idempotency_key Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
-  # @return [CreateAdCampaign201Response]
+  # @return [CreateAdCampaign200Response]
   describe 'create_ad_campaign test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -214,7 +227,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for get_ad
   # Get ad details
-  # Returns an ad with its creative, targeting, status, and performance metrics.  The `{adId}` path segment accepts any identifier dialect Zernio indexes for the ad: - the Zernio internal `_id` (24-char hex) - Meta's numeric `platformAdId` (the value shipped in `comment.received` webhooks as `comment.ad.id`) - the creative's `effective_object_story_id` (`{pageId}_{postId}` shape, Facebook side) - the creative's `effective_instagram_media_id` (Instagram side)  Any of the four resolve to the same ad. Caller doesn't need a translation step. By default, creative.promotion and creative.creativeFeatures contain stored requested settings, which do not confirm platform application. With `refreshPromotion=true`, Meta promotion metadata is read live and exposed as `ad.creative.promotion` with `promotionStatus`. Only `applied` confirms an offer; `not_returned` means the creative read succeeded without promotion metadata, and `unavailable` means it failed. 
+  # Returns an ad with its creative, targeting, status, and performance metrics. Google Search ads include current creative.headlines, creative.descriptions and creative.finalUrls, preserving pinnedField. Top-level cachedAt and stale report cache freshness. Google mutations invalidate this read. RSA enrichment requires a stored advertisingChannelType of SEARCH. Ads with an unknown or other channel return their stored details without a Google read. If RSA enrichment fails, the stored ad is returned with HTTP 200 and without cache metadata.  The `{adId}` path segment accepts any identifier dialect Zernio indexes for the ad: - the Zernio internal `_id` (24-char hex) - Meta's numeric `platformAdId` (the value shipped in `comment.received` webhooks as `comment.ad.id`) - the creative's `effective_object_story_id` (`{pageId}_{postId}` shape, Facebook side) - the creative's `effective_instagram_media_id` (Instagram side)  Any of the four resolve to the same ad. Caller doesn't need a translation step. By default, creative.promotion and creative.creativeFeatures contain stored requested settings, which do not confirm platform application. With `refreshPromotion=true`, Meta promotion metadata is read live and exposed as `ad.creative.promotion` with `promotionStatus`. Only `applied` confirms an offer; `not_returned` means the creative read succeeded without promotion metadata, and `unavailable` means it failed. 
   # @param ad_id Zernio `_id` (hex), Meta `platformAdId` (numeric), or one of the creative's effective story/media IDs. See description for details. 
   # @param [Hash] opts the optional parameters
   # @option opts [Boolean] :refresh_promotion Meta only. Read current promotion metadata from Meta and include promotionStatus. Omit for stored creative settings with no promotion-specific Graph call.
@@ -336,6 +349,20 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for list_ad_group_assets
+  # List ad-group assets
+  # Lists directly attached Google assets. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included.
+  # @param ad_set_id Numeric Google platform id.
+  # @param account_id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :customer_id 
+  # @return [ListAdGroupAssets200Response]
+  describe 'list_ad_group_assets 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_ad_keywords
   # List Search keywords
   # Returns the Google Search keyword criteria (positive and negative) synced from connected Google Ads accounts, one row per ad-group keyword. Refreshed about once a week per Google Ads customer (the keyword sweep rides the ads discovery pass on a slower slot, to stay inside Google's shared daily API quota), so keywords added on Google can take several days to appear. A customer synced for the first time is populated on the next discovery pass rather than waiting for its weekly slot, and connecting an account or triggering a manual sync refreshes it immediately. Campaign-level negative keywords are not included; only ad-group-level criteria are. 
@@ -414,6 +441,20 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for list_campaign_assets
+  # List campaign assets
+  # Lists directly attached Google assets. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included.
+  # @param campaign_id Numeric Google platform id.
+  # @param account_id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :customer_id 
+  # @return [ListCampaignAssets200Response]
+  describe 'list_campaign_assets 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_campaign_negative_keyword_lists
   # List campaign negative lists
   # Returns shared negative keyword lists attached to the campaign, separate from campaign-level negative keywords. Google Ads shared negative keyword lists (shared_set type NEGATIVE_KEYWORDS). Reads are cached for 10 minutes; quota exhaustion may return the last successful result for up to 7 days with stale=true. Customer selection is limited to this connection and its account scope.
@@ -440,6 +481,19 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for remove_ad_group_assets
+  # Remove ad-group assets
+  # Removes the specified attachments only. Google assets cannot be deleted. Other attachments remain. assetResourceNames is retained for compatibility.
+  # @param ad_set_id Numeric Google platform id.
+  # @param remove_ad_group_assets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [RemoveCampaignAssets200Response]
+  describe 'remove_ad_group_assets 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 remove_ad_keyword
   # Remove a Search keyword
   # Removes one keyword criterion (positive or negative) from its ad group (M.140).
@@ -452,6 +506,19 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for remove_campaign_assets
+  # Remove campaign assets
+  # Removes the specified attachments only. Google assets cannot be deleted. Other attachments remain. assetResourceNames is retained for compatibility.
+  # @param campaign_id Numeric Google platform id.
+  # @param remove_campaign_assets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [RemoveCampaignAssets200Response]
+  describe 'remove_campaign_assets 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 replace_campaign_negative_keyword_lists
   # Replace campaign negative lists
   # Sets the full desired set of shared negative keyword list associations on this campaign. Send listIds=[] to detach all negative keyword lists. Only campaign_shared_set links are changed; the lists and their keywords are preserved. Every list must belong to the campaign customer and have type NEGATIVE_KEYWORDS.
@@ -480,7 +547,7 @@ describe 'AdCampaignsApi' do
 
   # unit tests for update_ad
   # Update ad
-  # Patch one or more fields on an ad. Status, budget, targeting, and creative changes are propagated to the platform.  Per-platform support: - **Meta** (Facebook + Instagram): all fields supported. - **TikTok**: status, budget, targeting (via `/v2/adgroup/update/`), and creative   (via `/v2/ad/update/` patch-style: `headline` is ignored, `body` becomes `ad_text`). - **Google**: status, budget, KEYWORD edits via `targeting.keywords` /   `targeting.negativeKeywords`, and DEVICE bid adjustments via `targeting.devices`.   Each list you send becomes the FULL new set of its kind (criteria not in the   list are removed); a kind left out is untouched. Any other `targeting` field   returns 400: Google cannot mutate broad targeting post-create without recreating   the campaign. `creative` returns 501. - **LinkedIn**: status, budget, targeting (countries or regions, excludedLocations (countries),   the B2B facets, and audience segments; applied to the LinkedIn Campaign via   PARTIAL_UPDATE, and REPLACES the campaign's entire targetingCriteria, not a merge),   and creative (uploads new media, creates a replacement inline creative on the same   campaign, pauses the old one). - **Pinterest / X / OpenAI Ads**: status + budget only. Sending   `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.   OpenAI Ads budget is lifetime-only (see `budget.type` below).  **Google keyword replacement:** These edits affect the ad's entire ad group, including sibling ads. Positive (`targeting.keywords`) and negative (`targeting.negativeKeywords`) sets are independent: omit a field to leave that set unchanged, or send `[]` to remove every keyword of that kind.  Zernio compares each supplied set with Google's live criteria by case-insensitive keyword text and match type. A matching criterion is left untouched, retaining its criterion ID, enabled/paused status, keyword-level bid overrides, labels, and criterion-associated history/statistics. Zernio does not reset its quality score; Google continues to calculate scores and statistics normally. Text comparison does not trim whitespace.  A bare string or an object without `matchType` means `broad`, not the existing criterion's match type. For example, resending an existing `{ \"text\": \"plumber\", \"matchType\": \"exact\" }` preserves it; sending `\"plumber\"` instead removes that EXACT criterion and requests a BROAD one. Changing text or match type removes criteria no longer requested and creates any missing criteria. New criteria get new IDs and do not inherit removed criteria's bid overrides, labels, or history. Historical reporting for a removed criterion is not transferred to its replacement.  To add keywords without replacing a set, use [POST /v1/ads/keywords](https://docs.zernio.com/ad-campaigns/add-ad-keywords). Use `PATCH /v1/ads/keywords/{keywordId}` to pause/enable one keyword, or `DELETE /v1/ads/keywords/{keywordId}` to remove it. 
+  # Patch one or more fields on an ad. Status, budget, targeting, and creative changes are propagated to the platform.  Per-platform support: - **Meta** (Facebook + Instagram): all fields supported. - **TikTok**: status, budget, targeting (via `/v2/adgroup/update/`), and creative   (via `/v2/ad/update/` patch-style: `headline` is ignored, `body` becomes `ad_text`). - **Google**: status, budget, KEYWORD edits via `targeting.keywords` /   `targeting.negativeKeywords`, and DEVICE bid adjustments via `targeting.devices`.   Each list you send becomes the FULL new set of its kind (criteria not in the   list are removed); a kind left out is untouched. Any other `targeting` field   returns 400: Google cannot mutate broad targeting post-create without recreating   the campaign. RSA text updates use top-level `headlines`, `descriptions` and `finalUrls`.   Each supplied array replaces the full list; omit a field to preserve it. Use 3-15 headlines   (1-30 characters) and 2-4 descriptions (1-90 characters). Omit an asset to remove it;   omit pinnedField on an included asset to unpin it. Updates do not pad or truncate text.   The legacy creative fields remain unsupported for Google. - **LinkedIn**: status, budget, targeting (countries or regions, excludedLocations (countries),   the B2B facets, and audience segments; applied to the LinkedIn Campaign via   PARTIAL_UPDATE, and REPLACES the campaign's entire targetingCriteria, not a merge),   and creative (uploads new media, creates a replacement inline creative on the same   campaign, pauses the old one). - **Pinterest / X / OpenAI Ads**: status + budget only. Sending   `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.   OpenAI Ads budget is lifetime-only (see `budget.type` below).  **Google keyword replacement:** These edits affect the ad's entire ad group, including sibling ads. Positive (`targeting.keywords`) and negative (`targeting.negativeKeywords`) sets are independent: omit a field to leave that set unchanged, or send `[]` to remove every keyword of that kind.  Zernio compares each supplied set with Google's live criteria by case-insensitive keyword text and match type. A matching criterion is left untouched, retaining its criterion ID, enabled/paused status, keyword-level bid overrides, labels, and criterion-associated history/statistics. Zernio does not reset its quality score; Google continues to calculate scores and statistics normally. Text comparison does not trim whitespace.  A bare string or an object without `matchType` means `broad`, not the existing criterion's match type. For example, resending an existing `{ \"text\": \"plumber\", \"matchType\": \"exact\" }` preserves it; sending `\"plumber\"` instead removes that EXACT criterion and requests a BROAD one. Changing text or match type removes criteria no longer requested and creates any missing criteria. New criteria get new IDs and do not inherit removed criteria's bid overrides, labels, or history. Historical reporting for a removed criterion is not transferred to its replacement.  To add keywords without replacing a set, use [POST /v1/ads/keywords](https://docs.zernio.com/ad-campaigns/add-ad-keywords). Use `PATCH /v1/ads/keywords/{keywordId}` to pause/enable one keyword, or `DELETE /v1/ads/keywords/{keywordId}` to remove it. 
   # @param ad_id 
   # @param update_ad_request 
   # @param [Hash] opts the optional parameters
@@ -517,6 +584,19 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for update_ad_group_assets
+  # Update ad-group assets
+  # Edits existing Google assets in place. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.
+  # @param ad_set_id Numeric Google platform id.
+  # @param update_campaign_assets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdateCampaignAssets200Response]
+  describe 'update_ad_group_assets 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_keyword
   # Pause or enable a Search keyword
   # Changes `ad_group_criterion.status` for one keyword criterion (M.140). Negative keywords have no status on Google and cannot be paused or enabled. 
@@ -582,6 +662,19 @@ describe 'AdCampaignsApi' do
     end
   end
 
+  # unit tests for update_campaign_assets
+  # Update campaign assets
+  # Edits existing Google assets in place. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.
+  # @param campaign_id Numeric Google platform id.
+  # @param update_campaign_assets_request 
+  # @param [Hash] opts the optional parameters
+  # @return [UpdateCampaignAssets200Response]
+  describe 'update_campaign_assets 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_campaign_targeting
   # Edit a Google campaign's device, location, or language targeting
   # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving. 

data/spec/models/ad_creative_spec.rb

@@ -27,6 +27,24 @@ describe Zernio::AdCreative do
     end
   end
 
+  describe 'test attribute "headlines"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "descriptions"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "final_urls"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "thumbnail_url"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/{create_standalone_ad_request_tracking_spec.rb → ad_tracking_spec.rb}

@@ -14,16 +14,16 @@ require 'spec_helper'
 require 'json'
 require 'date'
 
-# Unit tests for Zernio::CreateStandaloneAdRequestTracking
+# Unit tests for Zernio::AdTracking
 # Automatically generated by openapi-generator (https://openapi-generator.tech)
 # Please update as you see appropriate
-describe Zernio::CreateStandaloneAdRequestTracking do
-  #let(:instance) { Zernio::CreateStandaloneAdRequestTracking.new }
+describe Zernio::AdTracking do
+  #let(:instance) { Zernio::AdTracking.new }
 
-  describe 'test an instance of CreateStandaloneAdRequestTracking' do
-    it 'should create an instance of CreateStandaloneAdRequestTracking' do
+  describe 'test an instance of AdTracking' do
+    it 'should create an instance of AdTracking' do
       # uncomment below to test the instance creation
-      #expect(instance).to be_instance_of(Zernio::CreateStandaloneAdRequestTracking)
+      #expect(instance).to be_instance_of(Zernio::AdTracking)
     end
   end
 

data/spec/models/add_account_sitelinks201_response_sitelinks_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::AddAccountSitelinks201ResponseSitelinksInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::AddAccountSitelinks201ResponseSitelinksInner do
+  #let(:instance) { Zernio::AddAccountSitelinks201ResponseSitelinksInner.new }
+
+  describe 'test an instance of AddAccountSitelinks201ResponseSitelinksInner' do
+    it 'should create an instance of AddAccountSitelinks201ResponseSitelinksInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::AddAccountSitelinks201ResponseSitelinksInner)
+    end
+  end
+
+  describe 'test attribute "asset_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 "text"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "link_url"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "description1"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "description2"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end