zernio-sdk 0.0.742 → 0.0.744

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d94730c10a6d40e92cb3a7a9e77d341c177a132e226e4f16b4c95dd88edd9aa
-  data.tar.gz: 9043886a7138023c7c26ac7585010f9d4496ca79c51379047406eae7ac5c00fa
+  metadata.gz: ddb21a6e5fea75b66dbf1826e7827fc60615bed899cc9e969ad29e6cb1fff626
+  data.tar.gz: f896eb87c19e97117f159f9337e5b2c4ee4ba79539fba2baf025f2c629354b2e
 SHA512:
-  metadata.gz: c35894c0219b677086c009adc63a403ada33497c816906bd05c73a09c80520676a1dbc64853c1e91c6b8d4f284e5c17dec00dda2c4c9e6d8374e9b0db177ecc4
-  data.tar.gz: f791fe76ffa586d3b4331dc97e9a37d57c6a214e58f397a1bc605f4da26e31a6396c00180fe2908150e36475748a1eee6a4e8b92e19087832e4fe21765a7d314
+  metadata.gz: 9a71aa3e78d47b0051b5e86e9e7d411fd376093beb1aa937010d9f6e0a262e3ed48d501ce697bac4fae5197156a2a5a18d43e49dbb5f781a401c026435370c7b
+  data.tar.gz: 90c8d2833dab6faf82a051d01547e2ed226b9095cab447334b809279024d51f6939b4eca27731d119cee47f1c7188d3bfbb17f8bd725b5187d1334bf8173544b

data/README.md

@@ -159,6 +159,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdCreativesApi* | [**delete_ad_video**](docs/AdCreativesApi.md#delete_ad_video) | **DELETE** /v1/ads/videos/{videoId} | Delete an ad video
 *Zernio::AdCreativesApi* | [**generate_ad_previews**](docs/AdCreativesApi.md#generate_ad_previews) | **POST** /v1/ads/preview | Render pre-create ad previews
 *Zernio::AdCreativesApi* | [**get_ad_creative**](docs/AdCreativesApi.md#get_ad_creative) | **GET** /v1/ads/creatives/{creativeId} | Creative details
+*Zernio::AdCreativesApi* | [**get_ad_media**](docs/AdCreativesApi.md#get_ad_media) | **GET** /v1/ads/{adId}/media | Direct video and image URLs for an ad
 *Zernio::AdCreativesApi* | [**get_ad_previews**](docs/AdCreativesApi.md#get_ad_previews) | **GET** /v1/ads/{adId}/preview | Render previews of an existing ad
 *Zernio::AdCreativesApi* | [**list_ad_catalog_product_sets**](docs/AdCreativesApi.md#list_ad_catalog_product_sets) | **GET** /v1/ads/catalogs/{catalogId}/product-sets | List a catalog's product sets
 *Zernio::AdCreativesApi* | [**list_ad_catalogs**](docs/AdCreativesApi.md#list_ad_catalogs) | **GET** /v1/ads/catalogs | List Meta product catalogs
@@ -1137,6 +1138,8 @@ Class | Method | HTTP request | Description
  - [Zernio::GetAdCreative200Response](docs/GetAdCreative200Response.md)
  - [Zernio::GetAdInsightsReport200Response](docs/GetAdInsightsReport200Response.md)
  - [Zernio::GetAdInsightsReport200ResponsePaging](docs/GetAdInsightsReport200ResponsePaging.md)
+ - [Zernio::GetAdMedia200Response](docs/GetAdMedia200Response.md)
+ - [Zernio::GetAdMedia200ResponseMediaInner](docs/GetAdMedia200ResponseMediaInner.md)
  - [Zernio::GetAdPreviews200Response](docs/GetAdPreviews200Response.md)
  - [Zernio::GetAdSetDetails200Response](docs/GetAdSetDetails200Response.md)
  - [Zernio::GetAdTrackingTags200Response](docs/GetAdTrackingTags200Response.md)

data/docs/AdCreativesApi.md

@@ -9,6 +9,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**delete_ad_video**](AdCreativesApi.md#delete_ad_video) | **DELETE** /v1/ads/videos/{videoId} | Delete an ad video |
 | [**generate_ad_previews**](AdCreativesApi.md#generate_ad_previews) | **POST** /v1/ads/preview | Render pre-create ad previews |
 | [**get_ad_creative**](AdCreativesApi.md#get_ad_creative) | **GET** /v1/ads/creatives/{creativeId} | Creative details |
+| [**get_ad_media**](AdCreativesApi.md#get_ad_media) | **GET** /v1/ads/{adId}/media | Direct video and image URLs for an ad |
 | [**get_ad_previews**](AdCreativesApi.md#get_ad_previews) | **GET** /v1/ads/{adId}/preview | Render previews of an existing ad |
 | [**list_ad_catalog_product_sets**](AdCreativesApi.md#list_ad_catalog_product_sets) | **GET** /v1/ads/catalogs/{catalogId}/product-sets | List a catalog's product sets |
 | [**list_ad_catalogs**](AdCreativesApi.md#list_ad_catalogs) | **GET** /v1/ads/catalogs | List Meta product catalogs |
@@ -377,6 +378,75 @@ end
 - **Accept**: application/json
 
 
+## get_ad_media
+
+> <GetAdMedia200Response> get_ad_media(ad_id)
+
+Direct video and image URLs for an ad
+
+Returns the direct signed URLs for every video and image asset used by an ad's live creative, normalised across shapes: single image/video, carousel, Reels/Story (`object_story_spec.video_data`) and dynamic creative (`asset_feed_spec`). Video items include Meta's poster thumbnail and the video's Meta id when available.  Reads Meta live rather than the stored creative blob because Meta's signed fbcdn URLs carry an `oe=<hex>` expiration (image_url ~24 h, video source ~12 d). Treat URLs as short-lived — re-fetch this endpoint before serving or downloading assets instead of caching URLs beyond that window.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::AdCreativesApi.new
+ad_id = 'ad_id_example' # String | Zernio ad id (24-char hex) or platform ad id.
+
+begin
+  # Direct video and image URLs for an ad
+  result = api_instance.get_ad_media(ad_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdCreativesApi->get_ad_media: #{e}"
+end
+```
+
+#### Using the get_ad_media_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetAdMedia200Response>, Integer, Hash)> get_ad_media_with_http_info(ad_id)
+
+```ruby
+begin
+  # Direct video and image URLs for an ad
+  data, status_code, headers = api_instance.get_ad_media_with_http_info(ad_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetAdMedia200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdCreativesApi->get_ad_media_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_id** | **String** | Zernio ad id (24-char hex) or platform ad id. |  |
+
+### Return type
+
+[**GetAdMedia200Response**](GetAdMedia200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_ad_previews
 
 > <GetAdPreviews200Response> get_ad_previews(ad_id, opts)

data/docs/GetAdMedia200Response.md

@@ -0,0 +1,22 @@
+# Zernio::GetAdMedia200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_id** | **String** |  | [optional] |
+| **platform** | **String** | 'facebook' or 'instagram' — only Meta is supported for now. | [optional] |
+| **media** | [**Array<GetAdMedia200ResponseMediaInner>**](GetAdMedia200ResponseMediaInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdMedia200Response.new(
+  ad_id: null,
+  platform: null,
+  media: null
+)
+```
+

data/docs/GetAdMedia200ResponseMediaInner.md

@@ -0,0 +1,28 @@
+# Zernio::GetAdMedia200ResponseMediaInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** |  | [optional] |
+| **url** | **String** | Direct file URL (signed; short-lived — see description). | [optional] |
+| **thumbnail_url** | **String** | Video poster URL (videos only). | [optional] |
+| **video_id** | **String** | Meta video id (videos only), reusable as video.id on the create endpoints. | [optional] |
+| **length** | **Float** | Video length in seconds (videos only). | [optional] |
+| **index** | **Integer** | 0-based position for carousel children or asset_feed_spec entries. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAdMedia200ResponseMediaInner.new(
+  type: null,
+  url: null,
+  thumbnail_url: null,
+  video_id: null,
+  length: null,
+  index: null
+)
+```
+

data/docs/UpdateWhatsAppTemplate200ResponseTemplate.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** |  | [optional] |
 | **name** | **String** |  | [optional] |
-| **status** | **String** |  | [optional] |
+| **status** | **String** | Approval state read back from Meta after the update, normally PENDING. If the state cannot be read back, the last known status is returned instead. | [optional] |
 
 ## Example
 
@@ -16,7 +16,7 @@ require 'zernio-sdk'
 instance = Zernio::UpdateWhatsAppTemplate200ResponseTemplate.new(
   id: null,
   name: null,
-  status: null
+  status: PENDING
 )
 ```
 

data/docs/WhatsAppApi.md

@@ -2454,7 +2454,7 @@ end
 
 Update template
 
-Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated. 
+Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated.  A successful update sends the template back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives later on the `whatsapp.template.status_updated` webhook. A template already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
 
 ### Examples
 

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

@@ -375,6 +375,69 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Direct video and image URLs for an ad
+    # Returns the direct signed URLs for every video and image asset used by an ad's live creative, normalised across shapes: single image/video, carousel, Reels/Story (`object_story_spec.video_data`) and dynamic creative (`asset_feed_spec`). Video items include Meta's poster thumbnail and the video's Meta id when available.  Reads Meta live rather than the stored creative blob because Meta's signed fbcdn URLs carry an `oe=<hex>` expiration (image_url ~24 h, video source ~12 d). Treat URLs as short-lived — re-fetch this endpoint before serving or downloading assets instead of caching URLs beyond that window.
+    # @param ad_id [String] Zernio ad id (24-char hex) or platform ad id.
+    # @param [Hash] opts the optional parameters
+    # @return [GetAdMedia200Response]
+    def get_ad_media(ad_id, opts = {})
+      data, _status_code, _headers = get_ad_media_with_http_info(ad_id, opts)
+      data
+    end
+
+    # Direct video and image URLs for an ad
+    # Returns the direct signed URLs for every video and image asset used by an ad&#39;s live creative, normalised across shapes: single image/video, carousel, Reels/Story (&#x60;object_story_spec.video_data&#x60;) and dynamic creative (&#x60;asset_feed_spec&#x60;). Video items include Meta&#39;s poster thumbnail and the video&#39;s Meta id when available.  Reads Meta live rather than the stored creative blob because Meta&#39;s signed fbcdn URLs carry an &#x60;oe&#x3D;&lt;hex&gt;&#x60; expiration (image_url ~24 h, video source ~12 d). Treat URLs as short-lived — re-fetch this endpoint before serving or downloading assets instead of caching URLs beyond that window.
+    # @param ad_id [String] Zernio ad id (24-char hex) or platform ad id.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetAdMedia200Response, Integer, Hash)>] GetAdMedia200Response data, response status code and response headers
+    def get_ad_media_with_http_info(ad_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AdCreativesApi.get_ad_media ...'
+      end
+      # verify the required parameter 'ad_id' is set
+      if @api_client.config.client_side_validation && ad_id.nil?
+        fail ArgumentError, "Missing the required parameter 'ad_id' when calling AdCreativesApi.get_ad_media"
+      end
+      # resource path
+      local_var_path = '/v1/ads/{adId}/media'.sub('{' + 'adId' + '}', CGI.escape(ad_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetAdMedia200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AdCreativesApi.get_ad_media",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AdCreativesApi#get_ad_media\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Render previews of an existing ad
     # Renders an EXISTING ad per placement via Meta's `/{ad_id}/previews`. Each preview is an HTML `<iframe>` snippet embeddable directly. Unknown `formats` values return Meta's 400 verbatim. 
     # @param ad_id [String] Zernio ad id (24-char hex).

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

@@ -2422,7 +2422,7 @@ module Zernio
     end
 
     # Update template
-    # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated. 
+    # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated.  A successful update sends the template back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives later on the `whatsapp.template.status_updated` webhook. A template already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
     # @param template_name [String] Template name
     # @param update_whats_app_template_request [UpdateWhatsAppTemplateRequest] 
     # @param [Hash] opts the optional parameters
@@ -2433,7 +2433,7 @@ module Zernio
     end
 
     # Update template
-    # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated. 
+    # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated.  A successful update sends the template back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives later on the `whatsapp.template.status_updated` webhook. A template already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
     # @param template_name [String] Template name
     # @param update_whats_app_template_request [UpdateWhatsAppTemplateRequest] 
     # @param [Hash] opts the optional parameters

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

@@ -0,0 +1,168 @@
+=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 'date'
+require 'time'
+
+module Zernio
+  class GetAdMedia200Response < ApiModelBase
+    attr_accessor :ad_id
+
+    # 'facebook' or 'instagram' — only Meta is supported for now.
+    attr_accessor :platform
+
+    attr_accessor :media
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'ad_id' => :'adId',
+        :'platform' => :'platform',
+        :'media' => :'media'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'ad_id' => :'String',
+        :'platform' => :'String',
+        :'media' => :'Array<GetAdMedia200ResponseMediaInner>'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::GetAdMedia200Response` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::GetAdMedia200Response`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'ad_id')
+        self.ad_id = attributes[:'ad_id']
+      end
+
+      if attributes.key?(:'platform')
+        self.platform = attributes[:'platform']
+      end
+
+      if attributes.key?(:'media')
+        if (value = attributes[:'media']).is_a?(Array)
+          self.media = value
+        end
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          ad_id == o.ad_id &&
+          platform == o.platform &&
+          media == o.media
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [ad_id, platform, media].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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

@@ -0,0 +1,231 @@
+=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 'date'
+require 'time'
+
+module Zernio
+  class GetAdMedia200ResponseMediaInner < ApiModelBase
+    attr_accessor :type
+
+    # Direct file URL (signed; short-lived — see description).
+    attr_accessor :url
+
+    # Video poster URL (videos only).
+    attr_accessor :thumbnail_url
+
+    # Meta video id (videos only), reusable as video.id on the create endpoints.
+    attr_accessor :video_id
+
+    # Video length in seconds (videos only).
+    attr_accessor :length
+
+    # 0-based position for carousel children or asset_feed_spec entries.
+    attr_accessor :index
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'type' => :'type',
+        :'url' => :'url',
+        :'thumbnail_url' => :'thumbnailUrl',
+        :'video_id' => :'videoId',
+        :'length' => :'length',
+        :'index' => :'index'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'type' => :'String',
+        :'url' => :'String',
+        :'thumbnail_url' => :'String',
+        :'video_id' => :'String',
+        :'length' => :'Float',
+        :'index' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::GetAdMedia200ResponseMediaInner` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::GetAdMedia200ResponseMediaInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'type')
+        self.type = attributes[:'type']
+      end
+
+      if attributes.key?(:'url')
+        self.url = attributes[:'url']
+      end
+
+      if attributes.key?(:'thumbnail_url')
+        self.thumbnail_url = attributes[:'thumbnail_url']
+      end
+
+      if attributes.key?(:'video_id')
+        self.video_id = attributes[:'video_id']
+      end
+
+      if attributes.key?(:'length')
+        self.length = attributes[:'length']
+      end
+
+      if attributes.key?(:'index')
+        self.index = attributes[:'index']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      type_validator = EnumAttributeValidator.new('String', ["image", "video"])
+      return false unless type_validator.valid?(@type)
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] type Object to be assigned
+    def type=(type)
+      validator = EnumAttributeValidator.new('String', ["image", "video"])
+      unless validator.valid?(type)
+        fail ArgumentError, "invalid value for \"type\", must be one of #{validator.allowable_values}."
+      end
+      @type = type
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          type == o.type &&
+          url == o.url &&
+          thumbnail_url == o.thumbnail_url &&
+          video_id == o.video_id &&
+          length == o.length &&
+          index == o.index
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [type, url, thumbnail_url, video_id, length, index].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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

@@ -19,6 +19,7 @@ module Zernio
 
     attr_accessor :name
 
+    # Approval state read back from Meta after the update, normally PENDING. If the state cannot be read back, the last known status is returned instead.
     attr_accessor :status
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/zernio-sdk/version.rb

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

data/lib/zernio-sdk.rb

@@ -494,6 +494,8 @@ require 'zernio-sdk/models/get_ad_comments200_response_pagination'
 require 'zernio-sdk/models/get_ad_creative200_response'
 require 'zernio-sdk/models/get_ad_insights_report200_response'
 require 'zernio-sdk/models/get_ad_insights_report200_response_paging'
+require 'zernio-sdk/models/get_ad_media200_response'
+require 'zernio-sdk/models/get_ad_media200_response_media_inner'
 require 'zernio-sdk/models/get_ad_previews200_response'
 require 'zernio-sdk/models/get_ad_set_details200_response'
 require 'zernio-sdk/models/get_ad_tracking_tags200_response'

data/openapi.yaml

@@ -29239,6 +29239,11 @@ paths:
       description: |
         Update a message template's components. Only certain fields can be updated depending on
         the template's current approval state. Approved templates can only have components updated.
+
+        A successful update sends the template back to Meta for review, so the `status` returned
+        here is normally `PENDING`. The final outcome arrives later on the
+        `whatsapp.template.status_updated` webhook. A template already in `PENDING` cannot be
+        edited again until Meta finishes reviewing it.
       security:
         - bearerAuth: []
       parameters:
@@ -29292,7 +29297,10 @@ paths:
                     properties:
                       id: { type: string }
                       name: { type: string }
-                      status: { type: string }
+                      status:
+                        type: string
+                        description: 'Approval state read back from Meta after the update, normally PENDING. If the state cannot be read back, the last known status is returned instead.'
+                        example: PENDING
         '400': { description: Validation error (missing fields) }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { $ref: '#/components/responses/NotFound' }
@@ -40277,6 +40285,55 @@ paths:
         '429': { description: Meta rate limit reached }
         '501': { description: Only supported on Meta (facebook/instagram) }
 
+  /v1/ads/{adId}/media:
+    get:
+      x-resource-group: "ads"
+      operationId: getAdMedia
+      tags: ["Ad Creatives"]
+      x-platforms: ["meta"]
+      summary: Direct video and image URLs for an ad
+      description: |-
+        Returns the direct signed URLs for every video and image asset used by an ad's live
+        creative, normalised across shapes: single image/video, carousel,
+        Reels/Story (`object_story_spec.video_data`) and dynamic
+        creative (`asset_feed_spec`). Video items include Meta's poster thumbnail and the
+        video's Meta id when available.
+
+        Reads Meta live rather than the stored creative blob because Meta's signed fbcdn
+        URLs carry an `oe=<hex>` expiration (image_url ~24 h, video source ~12 d). Treat
+        URLs as short-lived — re-fetch this endpoint before serving or downloading assets
+        instead of caching URLs beyond that window.
+      security:
+        - bearerAuth: []
+      parameters:
+        - { name: adId, in: path, required: true, schema: { type: string }, description: "Zernio ad id (24-char hex) or platform ad id." }
+      responses:
+        '200':
+          description: Media assets
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  adId: { type: string }
+                  platform: { type: string, description: "'facebook' or 'instagram' — only Meta is supported for now." }
+                  media:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        type: { type: string, enum: [image, video] }
+                        url: { type: string, description: "Direct file URL (signed; short-lived — see description)." }
+                        thumbnailUrl: { type: string, description: "Video poster URL (videos only)." }
+                        videoId: { type: string, description: "Meta video id (videos only), reusable as video.id on the create endpoints." }
+                        length: { type: number, description: "Video length in seconds (videos only)." }
+                        index: { type: integer, description: "0-based position for carousel children or asset_feed_spec entries." }
+        '400': { description: "Invalid input" }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Ad not found }
+        '422': { description: No active Meta connection for this ad. Reconnect the account. }
+        '501': { description: Only supported on Meta (facebook/instagram) }
+
   /v1/ads/keywords/ideas:
     post:
       x-resource-group: "ads"

data/spec/api/ad_creatives_api_spec.rb

@@ -97,6 +97,18 @@ describe 'AdCreativesApi' do
     end
   end
 
+  # unit tests for get_ad_media
+  # Direct video and image URLs for an ad
+  # Returns the direct signed URLs for every video and image asset used by an ad's live creative, normalised across shapes: single image/video, carousel, Reels/Story (`object_story_spec.video_data`) and dynamic creative (`asset_feed_spec`). Video items include Meta's poster thumbnail and the video's Meta id when available.  Reads Meta live rather than the stored creative blob because Meta's signed fbcdn URLs carry an `oe=<hex>` expiration (image_url ~24 h, video source ~12 d). Treat URLs as short-lived — re-fetch this endpoint before serving or downloading assets instead of caching URLs beyond that window.
+  # @param ad_id Zernio ad id (24-char hex) or platform ad id.
+  # @param [Hash] opts the optional parameters
+  # @return [GetAdMedia200Response]
+  describe 'get_ad_media 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_ad_previews
   # Render previews of an existing ad
   # Renders an EXISTING ad per placement via Meta's `/{ad_id}/previews`. Each preview is an HTML `<iframe>` snippet embeddable directly. Unknown `formats` values return Meta's 400 verbatim. 

data/spec/api/whats_app_api_spec.rb

@@ -467,7 +467,7 @@ describe 'WhatsAppApi' do
 
   # unit tests for update_whats_app_template
   # Update template
-  # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated. 
+  # Update a message template's components. Only certain fields can be updated depending on the template's current approval state. Approved templates can only have components updated.  A successful update sends the template back to Meta for review, so the `status` returned here is normally `PENDING`. The final outcome arrives later on the `whatsapp.template.status_updated` webhook. A template already in `PENDING` cannot be edited again until Meta finishes reviewing it. 
   # @param template_name Template name
   # @param update_whats_app_template_request 
   # @param [Hash] opts the optional parameters

data/spec/models/get_ad_media200_response_media_inner_spec.rb

@@ -0,0 +1,70 @@
+=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::GetAdMedia200ResponseMediaInner
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::GetAdMedia200ResponseMediaInner do
+  #let(:instance) { Zernio::GetAdMedia200ResponseMediaInner.new }
+
+  describe 'test an instance of GetAdMedia200ResponseMediaInner' do
+    it 'should create an instance of GetAdMedia200ResponseMediaInner' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::GetAdMedia200ResponseMediaInner)
+    end
+  end
+
+  describe 'test attribute "type"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["image", "video"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.type = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "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 "thumbnail_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 "video_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 "length"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "index"' 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_ad_media200_response_spec.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.742
+  version: 0.0.744
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -574,6 +574,8 @@ files:
 - docs/GetAdCreative200Response.md
 - docs/GetAdInsightsReport200Response.md
 - docs/GetAdInsightsReport200ResponsePaging.md
+- docs/GetAdMedia200Response.md
+- docs/GetAdMedia200ResponseMediaInner.md
 - docs/GetAdPreviews200Response.md
 - docs/GetAdSetDetails200Response.md
 - docs/GetAdTrackingTags200Response.md
@@ -2392,6 +2394,8 @@ files:
 - lib/zernio-sdk/models/get_ad_creative200_response.rb
 - lib/zernio-sdk/models/get_ad_insights_report200_response.rb
 - lib/zernio-sdk/models/get_ad_insights_report200_response_paging.rb
+- lib/zernio-sdk/models/get_ad_media200_response.rb
+- lib/zernio-sdk/models/get_ad_media200_response_media_inner.rb
 - lib/zernio-sdk/models/get_ad_previews200_response.rb
 - lib/zernio-sdk/models/get_ad_set_details200_response.rb
 - lib/zernio-sdk/models/get_ad_tracking_tags200_response.rb
@@ -4169,6 +4173,8 @@ files:
 - spec/models/get_ad_creative200_response_spec.rb
 - spec/models/get_ad_insights_report200_response_paging_spec.rb
 - spec/models/get_ad_insights_report200_response_spec.rb
+- spec/models/get_ad_media200_response_media_inner_spec.rb
+- spec/models/get_ad_media200_response_spec.rb
 - spec/models/get_ad_previews200_response_spec.rb
 - spec/models/get_ad_set_details200_response_spec.rb
 - spec/models/get_ad_tracking_tags200_response_spec.rb
@@ -5569,6 +5575,7 @@ test_files:
 - spec/models/get_posting_frequency200_response_spec.rb
 - spec/models/set_telegram_commands_request_commands_inner_spec.rb
 - spec/models/update_contact200_response_contact_spec.rb
+- spec/models/get_ad_media200_response_spec.rb
 - spec/models/webhook_payload_message_metadata_referral_spec.rb
 - spec/models/analytics_overview_spec.rb
 - spec/models/facebook_post_earnings_response_metrics_value_spec.rb
@@ -6201,6 +6208,7 @@ test_files:
 - spec/models/select_facebook_page_request_user_profile_spec.rb
 - spec/models/get_youtube_playlists200_response_playlists_inner_spec.rb
 - spec/models/sync_external_posts200_response_spec.rb
+- spec/models/get_ad_media200_response_media_inner_spec.rb
 - spec/models/update_discord_settings200_response_spec.rb
 - spec/models/linked_in_ads_platform_data_follower_spec.rb
 - spec/models/create_whats_app_group_chat201_response_group_spec.rb