late-sdk 0.0.861 → 0.0.863

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 146640c51fef87c69dd69f069dfefc4e727410b38b284b954e44ca6f74a3c528
-  data.tar.gz: 34f6fbd4a36b170972e28b46966a506c77a99a051e90ca7bdabf1f4fa086fdb5
+  metadata.gz: dcc2524124af3d41e5a5fa09514b3b5c19e1a4af0dcc05def42007646934bd4b
+  data.tar.gz: deb9414d41461ec14f7bd167f82fafdf871bdec7894559193bb7ec7e34b16e29
 SHA512:
-  metadata.gz: d641c72cfb84ec4316fade42b1d296ae4cb0dce1f1896b03708a12bc7912091537e81206db5550aa837d59bd7ff9d427efb3e919c5fa7c0870049d6198ca5b9b
-  data.tar.gz: a5a26110e0b1257224bbc256df74c880d1430ce1480a99f71264a5576e451a981c4d0446cec8d763dc00cd3644f725a855915fdd0feb1803c1ec516bb4b2d8cb
+  metadata.gz: 36e1371ff4a15bc4910171a44f2c8ce382e2026bac275d9fbbb914561026b416056374c13937052778badc8e0ecf39446be4027bb475f9be337da598961c8dd6
+  data.tar.gz: cfc6aef3f29f0bf10f552464b9b3d5ddb757ab397cf02862c1dceff6c3dd83fcc5685ce9a2be95ac038b4be3bdcc70c3079762af6452b143550fe6d286900ef4

data/docs/AdLibraryApi.md

@@ -9,11 +9,11 @@ All URIs are relative to *https://zernio.com/api*
 
 ## search_ad_library
 
-> <SearchAdLibrary200Response> search_ad_library(account_id, opts)
+> <SearchAdLibrary200Response> search_ad_library(opts)
 
 Search the public Ad Library
 
-Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
+Competitor and market research over the public ad archives. Meta's Ad Library (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId` also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. All customers share Zernio's Meta quota, so a `429` means back off for a minute.  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
 
 ### Examples
 
@@ -27,8 +27,9 @@ Zernio.configure do |config|
 end
 
 api_instance = Zernio::AdLibraryApi.new
-account_id = 'account_id_example' # String | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
 opts = {
+  platform: 'meta', # String | Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+  account_id: 'account_id_example', # String | Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
   q: 'q_example', # String | Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
   page_ids: 'page_ids_example', # String | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
   advertiser: 'advertiser_example', # String | LinkedIn only. Advertiser (Page) name to search.
@@ -48,7 +49,7 @@ opts = {
 
 begin
   # Search the public Ad Library
-  result = api_instance.search_ad_library(account_id, opts)
+  result = api_instance.search_ad_library(opts)
   p result
 rescue Zernio::ApiError => e
   puts "Error when calling AdLibraryApi->search_ad_library: #{e}"
@@ -59,12 +60,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SearchAdLibrary200Response>, Integer, Hash)> search_ad_library_with_http_info(account_id, opts)
+> <Array(<SearchAdLibrary200Response>, Integer, Hash)> search_ad_library_with_http_info(opts)
 
 ```ruby
 begin
   # Search the public Ad Library
-  data, status_code, headers = api_instance.search_ad_library_with_http_info(account_id, opts)
+  data, status_code, headers = api_instance.search_ad_library_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <SearchAdLibrary200Response>
@@ -77,7 +78,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches. |  |
+| **platform** | **String** | Which archive to search. &#x60;meta&#x60; needs no accountId. Required unless accountId is given. | [optional] |
+| **account_id** | **String** | Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform. | [optional] |
 | **q** | **String** | Keyword search. Meta does not translate it, so write it in the ads&#39; language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given. | [optional] |
 | **page_ids** | **String** | Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list. | [optional] |
 | **advertiser** | **String** | LinkedIn only. Advertiser (Page) name to search. | [optional] |

data/docs/CreateWhatsAppTemplate200ResponseTemplate.md

@@ -9,6 +9,7 @@
 | **status** | **String** | APPROVED for library templates, PENDING for custom | [optional] |
 | **category** | **String** |  | [optional] |
 | **language** | **String** |  | [optional] |
+| **message_send_ttl_seconds** | **Integer** | Echoed when supplied on the request. | [optional] |
 
 ## Example
 
@@ -20,7 +21,8 @@ instance = Zernio::CreateWhatsAppTemplate200ResponseTemplate.new(
   name: null,
   status: null,
   category: null,
-  language: null
+  language: null,
+  message_send_ttl_seconds: null
 )
 ```
 

data/docs/CreateWhatsAppTemplateRequest.md

@@ -13,6 +13,7 @@
 | **library_template_name** | **String** | Name of a pre-built template from Meta's template library (e.g., \"appointment_reminder\", \"auto_pay_reminder_1\", \"address_update\"). When provided, the template is pre-approved by Meta with no review wait. Omit components when using this field.  | [optional] |
 | **library_template_body_inputs** | **Object** | Optional body customizations for library templates. Available options depend on the template (e.g., add_contact_number, add_learn_more_link, add_security_recommendation, add_track_package_link, code_expiration_minutes).  | [optional] |
 | **library_template_button_inputs** | [**Array<CreateWhatsAppTemplateRequestLibraryTemplateButtonInputsInner>**](CreateWhatsAppTemplateRequestLibraryTemplateButtonInputsInner.md) | Optional button customizations for library templates. Each item specifies button type and configuration (e.g., URL, phone number, quick reply).  | [optional] |
+| **message_send_ttl_seconds** | **Integer** | Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check). | [optional] |
 
 ## Example
 
@@ -28,7 +29,8 @@ instance = Zernio::CreateWhatsAppTemplateRequest.new(
   components: null,
   library_template_name: null,
   library_template_body_inputs: null,
-  library_template_button_inputs: null
+  library_template_button_inputs: null,
+  message_send_ttl_seconds: null
 )
 ```
 

data/docs/GetWhatsAppTemplate200ResponseTemplate.md

@@ -10,6 +10,7 @@
 | **category** | **String** |  | [optional] |
 | **language** | **String** | The variant actually returned. | [optional] |
 | **components** | **Array<Object>** |  | [optional] |
+| **message_send_ttl_seconds** | **Integer** | Only when a custom TTL is set; absent while the category default applies. | [optional] |
 | **rejected_reason** | **String** | Only when status is REJECTED. | [optional] |
 | **quality_score** | **Object** | Post-approval quality (GREEN/YELLOW/RED), when Meta reports one. | [optional] |
 
@@ -25,6 +26,7 @@ instance = Zernio::GetWhatsAppTemplate200ResponseTemplate.new(
   category: null,
   language: null,
   components: null,
+  message_send_ttl_seconds: null,
   rejected_reason: null,
   quality_score: null
 )

data/docs/GetWhatsAppTemplates200ResponseTemplatesInner.md

@@ -9,6 +9,7 @@
 | **status** | **String** |  | [optional] |
 | **category** | **String** |  | [optional] |
 | **language** | **String** |  | [optional] |
+| **message_send_ttl_seconds** | **Integer** | Only when a custom TTL is set; absent while the category default applies. | [optional] |
 | **components** | **Array<Object>** |  | [optional] |
 
 ## Example
@@ -22,6 +23,7 @@ instance = Zernio::GetWhatsAppTemplates200ResponseTemplatesInner.new(
   status: null,
   category: null,
   language: null,
+  message_send_ttl_seconds: null,
   components: null
 )
 ```

data/docs/UpdateWhatsAppTemplateByIdRequest.md

@@ -5,7 +5,8 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | WhatsApp social account ID |  |
-| **components** | [**Array<WhatsAppTemplateComponent>**](WhatsAppTemplateComponent.md) | Updated template components |  |
+| **components** | [**Array<WhatsAppTemplateComponent>**](WhatsAppTemplateComponent.md) | Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required. | [optional] |
+| **message_send_ttl_seconds** | **Integer** | Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check). | [optional] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'zernio-sdk'
 
 instance = Zernio::UpdateWhatsAppTemplateByIdRequest.new(
   account_id: null,
-  components: null
+  components: null,
+  message_send_ttl_seconds: null
 )
 ```
 

data/docs/UpdateWhatsAppTemplateRequest.md

@@ -6,7 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **account_id** | **String** | WhatsApp social account ID |  |
 | **language** | **String** | Language code of the variant to edit (e.g. en_US, es, pt_BR). Required when the family has several languages. Body only: a language query parameter on PATCH is a 400. | [optional] |
-| **components** | [**Array<WhatsAppTemplateComponent>**](WhatsAppTemplateComponent.md) | Updated template components |  |
+| **components** | [**Array<WhatsAppTemplateComponent>**](WhatsAppTemplateComponent.md) | Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required. | [optional] |
+| **message_send_ttl_seconds** | **Integer** | Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check). | [optional] |
 
 ## Example
 
@@ -16,7 +17,8 @@ require 'zernio-sdk'
 instance = Zernio::UpdateWhatsAppTemplateRequest.new(
   account_id: null,
   language: null,
-  components: null
+  components: null,
+  message_send_ttl_seconds: null
 )
 ```
 

data/docs/WhatsAppApi.md

@@ -2615,7 +2615,7 @@ end
 
 Update template
 
-Update one variant's components. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+Update one variant's components and/or its message_send_ttl_seconds. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
 
 ### Examples
 
@@ -2630,7 +2630,7 @@ end
 
 api_instance = Zernio::WhatsAppApi.new
 template_name = 'template_name_example' # String | Template name (the family).
-update_whats_app_template_request = Zernio::UpdateWhatsAppTemplateRequest.new({account_id: 'account_id_example', components: [Zernio::WhatsAppBodyComponent.new({type: 'body', text: 'text_example'})]}) # UpdateWhatsAppTemplateRequest | 
+update_whats_app_template_request = Zernio::UpdateWhatsAppTemplateRequest.new({account_id: 'account_id_example'}) # UpdateWhatsAppTemplateRequest | 
 
 begin
   # Update template
@@ -2686,7 +2686,7 @@ end
 
 Update template by id
 
-Update one variant's components by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
 
 ### Examples
 
@@ -2701,7 +2701,7 @@ end
 
 api_instance = Zernio::WhatsAppApi.new
 template_id = 'template_id_example' # String | Meta template id (numeric).
-update_whats_app_template_by_id_request = Zernio::UpdateWhatsAppTemplateByIdRequest.new({account_id: 'account_id_example', components: [Zernio::WhatsAppBodyComponent.new({type: 'body', text: 'text_example'})]}) # UpdateWhatsAppTemplateByIdRequest | 
+update_whats_app_template_by_id_request = Zernio::UpdateWhatsAppTemplateByIdRequest.new({account_id: 'account_id_example'}) # UpdateWhatsAppTemplateByIdRequest | 
 
 begin
   # Update template by id

data/lib/zernio-sdk/api/ad_library_api.rb

@@ -20,9 +20,10 @@ module Zernio
       @api_client = api_client
     end
     # Search the public Ad Library
-    # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
-    # @param account_id [String] Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+    # Competitor and market research over the public ad archives. Meta's Ad Library (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId` also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. All customers share Zernio's Meta quota, so a `429` means back off for a minute.  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :platform Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+    # @option opts [String] :account_id Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
     # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
     # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
     # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
@@ -39,15 +40,16 @@ module Zernio
     # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25. (default to 25)
     # @option opts [String] :after paging.after of the previous page.
     # @return [SearchAdLibrary200Response]
-    def search_ad_library(account_id, opts = {})
-      data, _status_code, _headers = search_ad_library_with_http_info(account_id, opts)
+    def search_ad_library(opts = {})
+      data, _status_code, _headers = search_ad_library_with_http_info(opts)
       data
     end
 
     # Search the public Ad Library
-    # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
-    # @param account_id [String] Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+    # Competitor and market research over the public ad archives. Meta's Ad Library (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId` also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. All customers share Zernio's Meta quota, so a `429` means back off for a minute.  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :platform Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+    # @option opts [String] :account_id Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
     # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
     # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
     # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.
@@ -64,13 +66,13 @@ module Zernio
     # @option opts [Integer] :limit Rows per page. LinkedIn accepts at most 25. (default to 25)
     # @option opts [String] :after paging.after of the previous page.
     # @return [Array<(SearchAdLibrary200Response, Integer, Hash)>] SearchAdLibrary200Response data, response status code and response headers
-    def search_ad_library_with_http_info(account_id, opts = {})
+    def search_ad_library_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AdLibraryApi.search_ad_library ...'
       end
-      # verify the required parameter 'account_id' is set
-      if @api_client.config.client_side_validation && account_id.nil?
-        fail ArgumentError, "Missing the required parameter 'account_id' when calling AdLibraryApi.search_ad_library"
+      allowable_values = ["meta", "linkedin"]
+      if @api_client.config.client_side_validation && opts[:'platform'] && !allowable_values.include?(opts[:'platform'])
+        fail ArgumentError, "invalid value for \"platform\", must be one of #{allowable_values}"
       end
       if @api_client.config.client_side_validation && !opts[:'q'].nil? && opts[:'q'].to_s.length > 100
         fail ArgumentError, 'invalid value for "opts[:"q"]" when calling AdLibraryApi.search_ad_library, the character length must be smaller than or equal to 100.'
@@ -109,7 +111,8 @@ module Zernio
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'accountId'] = account_id
+      query_params[:'platform'] = opts[:'platform'] if !opts[:'platform'].nil?
+      query_params[:'accountId'] = opts[:'account_id'] if !opts[:'account_id'].nil?
       query_params[:'q'] = opts[:'q'] if !opts[:'q'].nil?
       query_params[:'pageIds'] = opts[:'page_ids'] if !opts[:'page_ids'].nil?
       query_params[:'advertiser'] = opts[:'advertiser'] if !opts[:'advertiser'].nil?

data/lib/zernio-sdk/api/whats_app_api.rb

@@ -2581,7 +2581,7 @@ module Zernio
     end
 
     # Update template
-    # Update one variant's components. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+    # Update one variant's components and/or its message_send_ttl_seconds. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
     # @param template_name [String] Template name (the family).
     # @param update_whats_app_template_request [UpdateWhatsAppTemplateRequest] 
     # @param [Hash] opts the optional parameters
@@ -2592,7 +2592,7 @@ module Zernio
     end
 
     # Update template
-    # Update one variant's components. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+    # Update one variant's components and/or its message_send_ttl_seconds. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
     # @param template_name [String] Template name (the family).
     # @param update_whats_app_template_request [UpdateWhatsAppTemplateRequest] 
     # @param [Hash] opts the optional parameters
@@ -2655,7 +2655,7 @@ module Zernio
     end
 
     # Update template by id
-    # Update one variant's components by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+    # Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
     # @param template_id [String] Meta template id (numeric).
     # @param update_whats_app_template_by_id_request [UpdateWhatsAppTemplateByIdRequest] 
     # @param [Hash] opts the optional parameters
@@ -2666,7 +2666,7 @@ module Zernio
     end
 
     # Update template by id
-    # Update one variant's components by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+    # Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
     # @param template_id [String] Meta template id (numeric).
     # @param update_whats_app_template_by_id_request [UpdateWhatsAppTemplateByIdRequest] 
     # @param [Hash] opts the optional parameters

data/lib/zernio-sdk/models/create_whats_app_template200_response_template.rb

@@ -26,6 +26,9 @@ module Zernio
 
     attr_accessor :language
 
+    # Echoed when supplied on the request.
+    attr_accessor :message_send_ttl_seconds
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -33,7 +36,8 @@ module Zernio
         :'name' => :'name',
         :'status' => :'status',
         :'category' => :'category',
-        :'language' => :'language'
+        :'language' => :'language',
+        :'message_send_ttl_seconds' => :'message_send_ttl_seconds'
       }
     end
 
@@ -54,7 +58,8 @@ module Zernio
         :'name' => :'String',
         :'status' => :'String',
         :'category' => :'String',
-        :'language' => :'String'
+        :'language' => :'String',
+        :'message_send_ttl_seconds' => :'Integer'
       }
     end
 
@@ -99,6 +104,10 @@ module Zernio
       if attributes.key?(:'language')
         self.language = attributes[:'language']
       end
+
+      if attributes.key?(:'message_send_ttl_seconds')
+        self.message_send_ttl_seconds = attributes[:'message_send_ttl_seconds']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -125,7 +134,8 @@ module Zernio
           name == o.name &&
           status == o.status &&
           category == o.category &&
-          language == o.language
+          language == o.language &&
+          message_send_ttl_seconds == o.message_send_ttl_seconds
     end
 
     # @see the `==` method
@@ -137,7 +147,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, status, category, language].hash
+      [id, name, status, category, language, message_send_ttl_seconds].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/create_whats_app_template_request.rb

@@ -42,6 +42,9 @@ module Zernio
     # Optional button customizations for library templates. Each item specifies button type and configuration (e.g., URL, phone number, quick reply). 
     attr_accessor :library_template_button_inputs
 
+    # Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
+    attr_accessor :message_send_ttl_seconds
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -75,7 +78,8 @@ module Zernio
         :'components' => :'components',
         :'library_template_name' => :'library_template_name',
         :'library_template_body_inputs' => :'library_template_body_inputs',
-        :'library_template_button_inputs' => :'library_template_button_inputs'
+        :'library_template_button_inputs' => :'library_template_button_inputs',
+        :'message_send_ttl_seconds' => :'message_send_ttl_seconds'
       }
     end
 
@@ -100,7 +104,8 @@ module Zernio
         :'components' => :'Array<WhatsAppTemplateComponent>',
         :'library_template_name' => :'String',
         :'library_template_body_inputs' => :'Object',
-        :'library_template_button_inputs' => :'Array<CreateWhatsAppTemplateRequestLibraryTemplateButtonInputsInner>'
+        :'library_template_button_inputs' => :'Array<CreateWhatsAppTemplateRequestLibraryTemplateButtonInputsInner>',
+        :'message_send_ttl_seconds' => :'Integer'
       }
     end
 
@@ -173,6 +178,10 @@ module Zernio
           self.library_template_button_inputs = value
         end
       end
+
+      if attributes.key?(:'message_send_ttl_seconds')
+        self.message_send_ttl_seconds = attributes[:'message_send_ttl_seconds']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -307,7 +316,8 @@ module Zernio
           components == o.components &&
           library_template_name == o.library_template_name &&
           library_template_body_inputs == o.library_template_body_inputs &&
-          library_template_button_inputs == o.library_template_button_inputs
+          library_template_button_inputs == o.library_template_button_inputs &&
+          message_send_ttl_seconds == o.message_send_ttl_seconds
     end
 
     # @see the `==` method
@@ -319,7 +329,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, name, category, language, parameter_format, components, library_template_name, library_template_body_inputs, library_template_button_inputs].hash
+      [account_id, name, category, language, parameter_format, components, library_template_name, library_template_body_inputs, library_template_button_inputs, message_send_ttl_seconds].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/get_whats_app_template200_response_template.rb

@@ -29,6 +29,9 @@ module Zernio
 
     attr_accessor :components
 
+    # Only when a custom TTL is set; absent while the category default applies.
+    attr_accessor :message_send_ttl_seconds
+
     # Only when status is REJECTED.
     attr_accessor :rejected_reason
 
@@ -44,6 +47,7 @@ module Zernio
         :'category' => :'category',
         :'language' => :'language',
         :'components' => :'components',
+        :'message_send_ttl_seconds' => :'message_send_ttl_seconds',
         :'rejected_reason' => :'rejected_reason',
         :'quality_score' => :'quality_score'
       }
@@ -68,6 +72,7 @@ module Zernio
         :'category' => :'String',
         :'language' => :'String',
         :'components' => :'Array<Object>',
+        :'message_send_ttl_seconds' => :'Integer',
         :'rejected_reason' => :'String',
         :'quality_score' => :'Object'
       }
@@ -121,6 +126,10 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'message_send_ttl_seconds')
+        self.message_send_ttl_seconds = attributes[:'message_send_ttl_seconds']
+      end
+
       if attributes.key?(:'rejected_reason')
         self.rejected_reason = attributes[:'rejected_reason']
       end
@@ -156,6 +165,7 @@ module Zernio
           category == o.category &&
           language == o.language &&
           components == o.components &&
+          message_send_ttl_seconds == o.message_send_ttl_seconds &&
           rejected_reason == o.rejected_reason &&
           quality_score == o.quality_score
     end
@@ -169,7 +179,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, status, category, language, components, rejected_reason, quality_score].hash
+      [id, name, status, category, language, components, message_send_ttl_seconds, rejected_reason, quality_score].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/get_whats_app_templates200_response_templates_inner.rb

@@ -26,6 +26,9 @@ module Zernio
 
     attr_accessor :language
 
+    # Only when a custom TTL is set; absent while the category default applies.
+    attr_accessor :message_send_ttl_seconds
+
     attr_accessor :components
 
     class EnumAttributeValidator
@@ -58,6 +61,7 @@ module Zernio
         :'status' => :'status',
         :'category' => :'category',
         :'language' => :'language',
+        :'message_send_ttl_seconds' => :'message_send_ttl_seconds',
         :'components' => :'components'
       }
     end
@@ -80,6 +84,7 @@ module Zernio
         :'status' => :'String',
         :'category' => :'String',
         :'language' => :'String',
+        :'message_send_ttl_seconds' => :'Integer',
         :'components' => :'Array<Object>'
       }
     end
@@ -126,6 +131,10 @@ module Zernio
         self.language = attributes[:'language']
       end
 
+      if attributes.key?(:'message_send_ttl_seconds')
+        self.message_send_ttl_seconds = attributes[:'message_send_ttl_seconds']
+      end
+
       if attributes.key?(:'components')
         if (value = attributes[:'components']).is_a?(Array)
           self.components = value
@@ -182,6 +191,7 @@ module Zernio
           status == o.status &&
           category == o.category &&
           language == o.language &&
+          message_send_ttl_seconds == o.message_send_ttl_seconds &&
           components == o.components
     end
 
@@ -194,7 +204,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, name, status, category, language, components].hash
+      [id, name, status, category, language, message_send_ttl_seconds, components].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/update_whats_app_template_by_id_request.rb

@@ -18,14 +18,18 @@ module Zernio
     # WhatsApp social account ID
     attr_accessor :account_id
 
-    # Updated template components
+    # Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
     attr_accessor :components
 
+    # Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
+    attr_accessor :message_send_ttl_seconds
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'account_id' => :'accountId',
-        :'components' => :'components'
+        :'components' => :'components',
+        :'message_send_ttl_seconds' => :'message_send_ttl_seconds'
       }
     end
 
@@ -43,7 +47,8 @@ module Zernio
     def self.openapi_types
       {
         :'account_id' => :'String',
-        :'components' => :'Array<WhatsAppTemplateComponent>'
+        :'components' => :'Array<WhatsAppTemplateComponent>',
+        :'message_send_ttl_seconds' => :'Integer'
       }
     end
 
@@ -79,8 +84,10 @@ module Zernio
         if (value = attributes[:'components']).is_a?(Array)
           self.components = value
         end
-      else
-        self.components = nil
+      end
+
+      if attributes.key?(:'message_send_ttl_seconds')
+        self.message_send_ttl_seconds = attributes[:'message_send_ttl_seconds']
       end
     end
 
@@ -93,11 +100,7 @@ module Zernio
         invalid_properties.push('invalid value for "account_id", account_id cannot be nil.')
       end
 
-      if @components.nil?
-        invalid_properties.push('invalid value for "components", components cannot be nil.')
-      end
-
-      if @components.length < 1
+      if !@components.nil? && @components.length < 1
         invalid_properties.push('invalid value for "components", number of items must be greater than or equal to 1.')
       end
 
@@ -109,8 +112,7 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @account_id.nil?
-      return false if @components.nil?
-      return false if @components.length < 1
+      return false if !@components.nil? && @components.length < 1
       true
     end
 
@@ -144,7 +146,8 @@ module Zernio
       return true if self.equal?(o)
       self.class == o.class &&
           account_id == o.account_id &&
-          components == o.components
+          components == o.components &&
+          message_send_ttl_seconds == o.message_send_ttl_seconds
     end
 
     # @see the `==` method
@@ -156,7 +159,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, components].hash
+      [account_id, components, message_send_ttl_seconds].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/update_whats_app_template_request.rb

@@ -21,15 +21,19 @@ module Zernio
     # Language code of the variant to edit (e.g. en_US, es, pt_BR). Required when the family has several languages. Body only: a language query parameter on PATCH is a 400.
     attr_accessor :language
 
-    # Updated template components
+    # Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.
     attr_accessor :components
 
+    # Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).
+    attr_accessor :message_send_ttl_seconds
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'account_id' => :'accountId',
         :'language' => :'language',
-        :'components' => :'components'
+        :'components' => :'components',
+        :'message_send_ttl_seconds' => :'message_send_ttl_seconds'
       }
     end
 
@@ -48,7 +52,8 @@ module Zernio
       {
         :'account_id' => :'String',
         :'language' => :'String',
-        :'components' => :'Array<WhatsAppTemplateComponent>'
+        :'components' => :'Array<WhatsAppTemplateComponent>',
+        :'message_send_ttl_seconds' => :'Integer'
       }
     end
 
@@ -88,8 +93,10 @@ module Zernio
         if (value = attributes[:'components']).is_a?(Array)
           self.components = value
         end
-      else
-        self.components = nil
+      end
+
+      if attributes.key?(:'message_send_ttl_seconds')
+        self.message_send_ttl_seconds = attributes[:'message_send_ttl_seconds']
       end
     end
 
@@ -102,11 +109,7 @@ module Zernio
         invalid_properties.push('invalid value for "account_id", account_id cannot be nil.')
       end
 
-      if @components.nil?
-        invalid_properties.push('invalid value for "components", components cannot be nil.')
-      end
-
-      if @components.length < 1
+      if !@components.nil? && @components.length < 1
         invalid_properties.push('invalid value for "components", number of items must be greater than or equal to 1.')
       end
 
@@ -118,8 +121,7 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @account_id.nil?
-      return false if @components.nil?
-      return false if @components.length < 1
+      return false if !@components.nil? && @components.length < 1
       true
     end
 
@@ -154,7 +156,8 @@ module Zernio
       self.class == o.class &&
           account_id == o.account_id &&
           language == o.language &&
-          components == o.components
+          components == o.components &&
+          message_send_ttl_seconds == o.message_send_ttl_seconds
     end
 
     # @see the `==` method
@@ -166,7 +169,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, language, components].hash
+      [account_id, language, components, message_send_ttl_seconds].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.861'
+  VERSION = '0.0.863'
 end

data/openapi.yaml

@@ -31230,6 +31230,7 @@ paths:
                         status: { type: string, enum: [APPROVED, PENDING, REJECTED] }
                         category: { type: string, enum: [AUTHENTICATION, MARKETING, UTILITY] }
                         language: { type: string }
+                        message_send_ttl_seconds: { type: integer, description: 'Only when a custom TTL is set; absent while the category default applies.' }
                         components:
                           type: array
                           items:
@@ -31319,6 +31320,9 @@ paths:
                           base_url: { type: string }
                       phone_number:
                         type: string
+                message_send_ttl_seconds:
+                  type: integer
+                  description: 'Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).'
             examples:
               custom:
                 summary: Custom template (requires review)
@@ -31371,6 +31375,7 @@ paths:
                       status: { type: string, description: "APPROVED for library templates, PENDING for custom" }
                       category: { type: string }
                       language: { type: string }
+                      message_send_ttl_seconds: { type: integer, description: 'Echoed when supplied on the request.' }
         '400': { description: "Validation error (invalid name format, missing fields, invalid category)" }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: WhatsApp account not found }
@@ -31432,6 +31437,7 @@ paths:
                         type: array
                         items:
                           type: object
+                      message_send_ttl_seconds: { type: integer, description: 'Only when a custom TTL is set; absent while the category default applies.' }
                       rejected_reason: { type: string, description: 'Only when status is REJECTED.' }
                       quality_score: { type: object, description: 'Post-approval quality (GREEN/YELLOW/RED), when Meta reports one.' }
         '400': { $ref: '#/components/responses/BadRequest' }
@@ -31459,7 +31465,7 @@ paths:
       tags: [WhatsApp]
       summary: Update template
       description: |
-        Update one variant's components. Name, language and category cannot change after creation.
+        Update one variant's components and/or its message_send_ttl_seconds. Name, language and category cannot change after creation.
 
         Meta stores one template per **name + language**, so a name identifies a family of variants,
         each with its own Meta id. Pass `language` to address one variant. Without it, a name with a
@@ -31491,7 +31497,6 @@ paths:
               type: object
               required:
                 - accountId
-                - components
               properties:
                 accountId:
                   type: string
@@ -31501,10 +31506,13 @@ paths:
                   description: 'Language code of the variant to edit (e.g. en_US, es, pt_BR). Required when the family has several languages. Body only: a language query parameter on PATCH is a 400.'
                 components:
                   type: array
-                  description: Updated template components
+                  description: 'Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.'
                   minItems: 1
                   items:
                     $ref: '#/components/schemas/WhatsAppTemplateComponent'
+                message_send_ttl_seconds:
+                  type: integer
+                  description: 'Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).'
             example:
               accountId: "507f1f77bcf86cd799439011"
               language: "es"
@@ -31664,6 +31672,7 @@ paths:
                         type: array
                         items:
                           type: object
+                      message_send_ttl_seconds: { type: integer, description: 'Only when a custom TTL is set; absent while the category default applies.' }
                       rejected_reason: { type: string, description: 'Only when status is REJECTED.' }
                       quality_score: { type: object, description: 'Post-approval quality (GREEN/YELLOW/RED), when Meta reports one.' }
         '400': { $ref: '#/components/responses/BadRequest' }
@@ -31676,7 +31685,7 @@ paths:
       tags: [WhatsApp]
       summary: Update template by id
       description: |
-        Update one variant's components by its Meta id. Name, language and category cannot change.
+        Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.
 
         Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved
         template can be edited once per 24 hours and up to 10 times per 30 days. A successful update
@@ -31701,17 +31710,19 @@ paths:
               type: object
               required:
                 - accountId
-                - components
               properties:
                 accountId:
                   type: string
                   description: WhatsApp social account ID
                 components:
                   type: array
-                  description: Updated template components
+                  description: 'Updated template components. Optional when only message_send_ttl_seconds changes; at least one of the two is required.'
                   minItems: 1
                   items:
                     $ref: '#/components/schemas/WhatsAppTemplateComponent'
+                message_send_ttl_seconds:
+                  type: integer
+                  description: 'Delivery validity window in seconds: a message not delivered within it is dropped. Range depends on category: AUTHENTICATION 30 to 900, UTILITY 30 to 43200 (12h), MARKETING 43200 to 2592000 (30 days); -1 restores the 30-day default on AUTHENTICATION and UTILITY. Meta defaults to 600 for AUTHENTICATION and 30 days otherwise. If Meta later recategorises the template, it clears the TTL (read it back to check).'
       responses:
         '200':
           description: Template updated successfully
@@ -47793,19 +47804,18 @@ paths:
       x-platforms: ["meta", "linkedin"]
       summary: Search the public Ad Library
       description: |-
-        Competitor and market research over the platform's public ad archive, searched with the
-        customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for
-        a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`)
-        for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under
-        `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).
+        Competitor and market research over the public ad archives. Meta's Ad Library
+        (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs
+        no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected
+        `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId`
+        also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after`
+        is an opaque cursor on both (`null` when exhausted).
 
         **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is
         in the archive only if it was delivered to the EU or UK within the last year, so a US-only
         commercial advertiser is invisible. Spend, impressions and demographics are political-only
-        fields and are left out of the default projection; request them via `fields`. Meta serves the
-        archive only to people who confirmed their identity and location at facebook.com/ID: until the
-        Facebook user behind the connection has done so, the call fails with
-        `meta_identity_confirmation_required` (403).
+        fields and are left out of the default projection; request them via `fields`. All customers
+        share Zernio's Meta quota, so a `429` means back off for a minute.
 
         **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their
         last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets.
@@ -47818,7 +47828,8 @@ paths:
       security:
         - bearerAuth: []
       parameters:
-        - { name: accountId, in: query, required: true, schema: { type: string }, description: "Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches." }
+        - { name: platform, in: query, schema: { type: string, enum: [meta, linkedin] }, description: "Which archive to search. `meta` needs no accountId. Required unless accountId is given." }
+        - { name: accountId, in: query, schema: { type: string }, description: "Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform." }
         - { name: q, in: query, schema: { type: string, maxLength: 100 }, description: "Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given." }
         - { name: pageIds, in: query, schema: { type: string }, description: "Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list." }
         - { name: advertiser, in: query, schema: { type: string, maxLength: 100 }, description: "LinkedIn only. Advertiser (Page) name to search." }
@@ -47892,9 +47903,10 @@ paths:
         '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
-          description: "Ads access required (legacy plans need the Ads add-on), or, on Meta, `meta_identity_confirmation_required`: the Facebook user behind the connection has not confirmed identity and location at facebook.com/ID."
+          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
         '404': { description: Account not found }
         '501': { description: Only supported on Meta and LinkedIn accounts }
+        '503': { description: "Meta's Ad Library is unavailable on Zernio's side (`PLATFORM_DISABLED`); LinkedIn searches are unaffected." }
 
   /v1/ads/targeting/reach-estimate:
     post:

data/spec/api/ad_library_api_spec.rb

@@ -34,9 +34,10 @@ describe 'AdLibraryApi' do
 
   # unit tests for search_ad_library
   # Search the public Ad Library
-  # Competitor and market research over the platform's public ad archive, searched with the customer's own connected token (no extra scope): Meta's Ad Library (`GET /ads_archive`) for a `facebook` / `instagram` / `metaads` account, LinkedIn's Ad Library (`GET /rest/adLibrary`) for a `linkedin` / `linkedinads` account. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. Meta serves the archive only to people who confirmed their identity and location at facebook.com/ID: until the Facebook user behind the connection has done so, the call fails with `meta_identity_confirmation_required` (403).  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
-  # @param account_id Zernio SocialAccount id (facebook / instagram / metaads for Meta, linkedin / linkedinads for LinkedIn). Its token is the one that searches.
+  # Competitor and market research over the public ad archives. Meta's Ad Library (`GET /ads_archive`) is searched with Zernio's own developer access, so `platform=meta` needs no connected account at all. LinkedIn's Ad Library (`GET /rest/adLibrary`) runs on a connected `linkedin` / `linkedinads` account, passed as `accountId`. Passing a Meta account as `accountId` also selects Meta. Rows are returned in the platform's raw shape under `data`; `paging.after` is an opaque cursor on both (`null` when exhausted).  **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible. Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. All customers share Zernio's Meta quota, so a `429` means back off for a minute.  **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets. Pages are capped at 25 ads (`limit` > 25 is a 400); `after` is the next offset.  Which params apply: `q`, `countries`, `since`, `until`, `limit`, `after` on both; `pageIds`, `adType`, `status`, `platforms`, `mediaType`, `languages`, `searchType`, `fields` are Meta-only; `advertiser` is LinkedIn-only. Passing a param the account's platform does not support is a 400 naming the param.
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :platform Which archive to search. `meta` needs no accountId. Required unless accountId is given.
+  # @option opts [String] :account_id Zernio SocialAccount id. Required for LinkedIn (linkedin / linkedinads: its token searches). Optional for Meta, where any facebook / instagram / metaads account just selects the platform.
   # @option opts [String] :q Keyword search. Meta does not translate it, so write it in the ads' language. Required unless pageIds (Meta) or advertiser (LinkedIn) is given.
   # @option opts [String] :page_ids Meta only. Comma-separated Facebook Page ids (max 10) whose ads to list.
   # @option opts [String] :advertiser LinkedIn only. Advertiser (Page) name to search.

data/spec/api/whats_app_api_spec.rb

@@ -498,7 +498,7 @@ describe 'WhatsAppApi' do
 
   # unit tests for update_whats_app_template
   # Update template
-  # Update one variant's components. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+  # Update one variant's components and/or its message_send_ttl_seconds. Name, language and category cannot change after creation.  Meta stores one template per **name + language**, so a name identifies a family of variants, each with its own Meta id. Pass `language` to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns `409 ambiguous_template` with `details.languages`. A bare language (`es`) matches a single regional variant (`es_ES`); if the family has several regional variants for it, that is also a 409. A full code (`es_ES`) must match exactly. Variants in `PENDING_DELETION` are not part of the family.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
   # @param template_name Template name (the family).
   # @param update_whats_app_template_request 
   # @param [Hash] opts the optional parameters
@@ -511,7 +511,7 @@ describe 'WhatsAppApi' do
 
   # unit tests for update_whats_app_template_by_id
   # Update template by id
-  # Update one variant's components by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
+  # Update one variant's components and/or its message_send_ttl_seconds by its Meta id. Name, language and category cannot change.  Meta only allows editing templates in `APPROVED`, `REJECTED` or `PAUSED` state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives on the `whatsapp.template.status_updated` webhook (which carries the variant's `templateId` and `language`). A variant already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
   # @param template_id Meta template id (numeric).
   # @param update_whats_app_template_by_id_request 
   # @param [Hash] opts the optional parameters

data/spec/models/create_whats_app_template200_response_template_spec.rb

@@ -57,4 +57,10 @@ describe Zernio::CreateWhatsAppTemplate200ResponseTemplate do
     end
   end
 
+  describe 'test attribute "message_send_ttl_seconds"' 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/create_whats_app_template_request_spec.rb

@@ -89,4 +89,10 @@ describe Zernio::CreateWhatsAppTemplateRequest do
     end
   end
 
+  describe 'test attribute "message_send_ttl_seconds"' 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/get_whats_app_template200_response_template_spec.rb

@@ -63,6 +63,12 @@ describe Zernio::GetWhatsAppTemplate200ResponseTemplate do
     end
   end
 
+  describe 'test attribute "message_send_ttl_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "rejected_reason"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/get_whats_app_templates200_response_templates_inner_spec.rb

@@ -65,6 +65,12 @@ describe Zernio::GetWhatsAppTemplates200ResponseTemplatesInner do
     end
   end
 
+  describe 'test attribute "message_send_ttl_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "components"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/update_whats_app_template_by_id_request_spec.rb

@@ -39,4 +39,10 @@ describe Zernio::UpdateWhatsAppTemplateByIdRequest do
     end
   end
 
+  describe 'test attribute "message_send_ttl_seconds"' 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/update_whats_app_template_request_spec.rb

@@ -45,4 +45,10 @@ describe Zernio::UpdateWhatsAppTemplateRequest do
     end
   end
 
+  describe 'test attribute "message_send_ttl_seconds"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.861
+  version: 0.0.863
 platform: ruby
 authors:
 - OpenAPI-Generator
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-07 00:00:00.000000000 Z
+date: 2026-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -5800,7 +5800,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.861.gem
+- zernio-sdk-0.0.863.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: