zernio-sdk 0.0.738 → 0.0.739

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 204511ccaf29178934cde6c2b0d9a2cd5775d1eedb91671b414dd113f7e89b72
-  data.tar.gz: 40a2c5e15f46c2ddbf2f93d73cbe5bf7364a88d9003a33190e4fb550c7c81c5b
+  metadata.gz: 928968c857cd46ee2a5081192f7d3c15857756a79f63b72eacaa0e39425f529f
+  data.tar.gz: 1ab4392b72e8e6d77b98aa4181403d3153f1512dc4bf9394b5ee72a18e2e9e05
 SHA512:
-  metadata.gz: c40ef81851d6593fe3e71a79dc8b8c520ba5b0280c7efb2bbacc88a59aecec86276c5f3db099468cccd1764d36cf2a76638c4d5777a32eaa70cecbeb1f7909c9
-  data.tar.gz: d46cb077d13222edaeaf4978d9b216c9eacb5e97f364e5f5f55c56ebe63c803f4b96ebfb0c0b926a499694da6084fc8c06633c8106ef3297a08a8aa9999bd7c2
+  metadata.gz: b9cf340de0a9052e88c0e5c04aa8da5227ff898fb0f94246f188e444396c1cbbccc3dcd06b9a68eda3b8281808622e07b50f382474f098676758f34d9ae4fafb
+  data.tar.gz: e0b1bc4d9913f1a2c59cd04901f257fb7d27fa18d98aa8eaffc31508a7b41d851865b94be11d02ee7ebd2aa0f2a26cd4adb64158a4d798b5c334e34bcb1b3ce6

data/docs/AdTreeAdSet.md

@@ -7,6 +7,7 @@
 | **platform_ad_set_id** | **String** |  | [optional] |
 | **ad_set_name** | **String** |  | [optional] |
 | **status** | [**AdStatus**](AdStatus.md) | Derived from child ad statuses | [optional] |
+| **created_time** | **Time** | Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across this ad set's ads. Not the ad set's own creation time on the platform — a proxy usable for sorting. | [optional] |
 | **ad_count** | **Integer** |  | [optional] |
 | **budget** | [**AdTreeAdSetBudget**](AdTreeAdSetBudget.md) |  | [optional] |
 | **ad_set_budget** | [**AdTreeAdSetAdSetBudget**](AdTreeAdSetAdSetBudget.md) |  | [optional] |
@@ -30,6 +31,7 @@ instance = Zernio::AdTreeAdSet.new(
   platform_ad_set_id: null,
   ad_set_name: null,
   status: null,
+  created_time: null,
   ad_count: null,
   budget: null,
   ad_set_budget: null,

data/docs/AdTreeCampaign.md

@@ -7,6 +7,7 @@
 | **platform_campaign_id** | **String** |  | [optional] |
 | **platform** | **String** |  | [optional] |
 | **campaign_name** | **String** |  | [optional] |
+| **created_time** | **Time** | Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across every ad in the campaign. Not the platform campaign's own creation time (Meta's `Campaign.created_time` etc. is not synced) — a campaign created empty and populated later will show its first ad's time, not the campaign's. Usable for sorting \"most recently created\" without the numeric-campaign-id heuristic. Same source as `AdTreeAdSet.createdTime` and `Ad.platformCreatedAt`; mirrors `AdCampaign.earliestAd`. | [optional] |
 | **status** | [**AdStatus**](AdStatus.md) | Delivery status derived from child ad statuses. Distinct from `reviewStatus`, which reflects the platform-side review state. | [optional] |
 | **review_status** | [**AdReviewStatus**](AdReviewStatus.md) |  | [optional] |
 | **platform_campaign_status** | **String** | Raw platform-level campaign status (Meta `effective_status`: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES). Distinct from per-ad `platformStatus`. | [optional] |
@@ -42,6 +43,7 @@ instance = Zernio::AdTreeCampaign.new(
   platform_campaign_id: null,
   platform: null,
   campaign_name: null,
+  created_time: null,
   status: null,
   review_status: null,
   platform_campaign_status: null,

data/docs/CreateCallAdRequest.md

@@ -11,7 +11,7 @@
 | **body** | **String** | Primary text shown above the image / video. Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
-| **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
+| **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`): setting both is a 400, unlike `POST /v1/ads/create` where the top-level fields are silently ignored in multi-creative mode. Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
 | **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
 | **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it.  | [optional] |
 | **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |

data/docs/CreateMessagingAdRequest.md

@@ -11,7 +11,7 @@
 | **body** | **String** | Primary text shown above the image / video. Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
-| **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
+| **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`): setting both is a 400, unlike `POST /v1/ads/create` where the top-level fields are silently ignored in multi-creative mode. Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
 | **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
 | **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it.  | [optional] |
 | **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |

data/docs/CtwaAdRequestBody.md

@@ -11,7 +11,7 @@
 | **body** | **String** | Primary text shown above the image / video. Single-creative shape only. Mutually exclusive with `creatives[]`.  | [optional] |
 | **image_url** | **String** | Image asset for single-creative shape. Mutually exclusive with `video` and with `creatives[]`. Required on the single-creative shape if `video` is not supplied.  | [optional] |
 | **video** | [**CtwaAdRequestBodyVideo**](CtwaAdRequestBodyVideo.md) |  | [optional] |
-| **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
+| **creatives** | [**Array<CtwaAdRequestBodyCreativesInner>**](CtwaAdRequestBodyCreativesInner.md) | Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`): setting both is a 400, unlike `POST /v1/ads/create` where the top-level fields are silently ignored in multi-creative mode. Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`.  | [optional] |
 | **ad_set_id** | **String** | Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination.  | [optional] |
 | **budget_amount** | **Float** | Budget amount in the ad account's currency major units (e.g. dollars for USD, not cents). Must be > 0. Required unless `adSetId` is set, where the ad set owns it.  | [optional] |
 | **budget_type** | **String** | Required unless `adSetId` is set. | [optional] |

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

@@ -23,6 +23,9 @@ module Zernio
     # Derived from child ad statuses
     attr_accessor :status
 
+    # Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across this ad set's ads. Not the ad set's own creation time on the platform — a proxy usable for sorting.
+    attr_accessor :created_time
+
     attr_accessor :ad_count
 
     attr_accessor :budget
@@ -84,6 +87,7 @@ module Zernio
         :'platform_ad_set_id' => :'platformAdSetId',
         :'ad_set_name' => :'adSetName',
         :'status' => :'status',
+        :'created_time' => :'createdTime',
         :'ad_count' => :'adCount',
         :'budget' => :'budget',
         :'ad_set_budget' => :'adSetBudget',
@@ -116,6 +120,7 @@ module Zernio
         :'platform_ad_set_id' => :'String',
         :'ad_set_name' => :'String',
         :'status' => :'AdStatus',
+        :'created_time' => :'Time',
         :'ad_count' => :'Integer',
         :'budget' => :'AdTreeAdSetBudget',
         :'ad_set_budget' => :'AdTreeAdSetAdSetBudget',
@@ -135,6 +140,7 @@ module Zernio
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'created_time',
         :'optimization_goal',
         :'bid_strategy',
         :'bid_amount',
@@ -171,6 +177,10 @@ module Zernio
         self.status = attributes[:'status']
       end
 
+      if attributes.key?(:'created_time')
+        self.created_time = attributes[:'created_time']
+      end
+
       if attributes.key?(:'ad_count')
         self.ad_count = attributes[:'ad_count']
       end
@@ -253,6 +263,7 @@ module Zernio
           platform_ad_set_id == o.platform_ad_set_id &&
           ad_set_name == o.ad_set_name &&
           status == o.status &&
+          created_time == o.created_time &&
           ad_count == o.ad_count &&
           budget == o.budget &&
           ad_set_budget == o.ad_set_budget &&
@@ -277,7 +288,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [platform_ad_set_id, ad_set_name, status, ad_count, budget, ad_set_budget, metrics, optimization_goal, bid_strategy, bid_amount, roas_average_floor, cost_type, serving_statuses, promoted_object, ads, daily].hash
+      [platform_ad_set_id, ad_set_name, status, created_time, ad_count, budget, ad_set_budget, metrics, optimization_goal, bid_strategy, bid_amount, roas_average_floor, cost_type, serving_statuses, promoted_object, ads, daily].hash
     end
 
     # Builds the object from hash

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

@@ -22,6 +22,9 @@ module Zernio
 
     attr_accessor :campaign_name
 
+    # Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across every ad in the campaign. Not the platform campaign's own creation time (Meta's `Campaign.created_time` etc. is not synced) — a campaign created empty and populated later will show its first ad's time, not the campaign's. Usable for sorting \"most recently created\" without the numeric-campaign-id heuristic. Same source as `AdTreeAdSet.createdTime` and `Ad.platformCreatedAt`; mirrors `AdCampaign.earliestAd`.
+    attr_accessor :created_time
+
     # Delivery status derived from child ad statuses. Distinct from `reviewStatus`, which reflects the platform-side review state.
     attr_accessor :status
 
@@ -113,6 +116,7 @@ module Zernio
         :'platform_campaign_id' => :'platformCampaignId',
         :'platform' => :'platform',
         :'campaign_name' => :'campaignName',
+        :'created_time' => :'createdTime',
         :'status' => :'status',
         :'review_status' => :'reviewStatus',
         :'platform_campaign_status' => :'platformCampaignStatus',
@@ -157,6 +161,7 @@ module Zernio
         :'platform_campaign_id' => :'String',
         :'platform' => :'String',
         :'campaign_name' => :'String',
+        :'created_time' => :'Time',
         :'status' => :'AdStatus',
         :'review_status' => :'AdReviewStatus',
         :'platform_campaign_status' => :'String',
@@ -188,6 +193,7 @@ module Zernio
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'created_time',
         :'review_status',
         :'platform_campaign_status',
         :'campaign_issues_info',
@@ -230,6 +236,10 @@ module Zernio
         self.campaign_name = attributes[:'campaign_name']
       end
 
+      if attributes.key?(:'created_time')
+        self.created_time = attributes[:'created_time']
+      end
+
       if attributes.key?(:'status')
         self.status = attributes[:'status']
       end
@@ -386,6 +396,7 @@ module Zernio
           platform_campaign_id == o.platform_campaign_id &&
           platform == o.platform &&
           campaign_name == o.campaign_name &&
+          created_time == o.created_time &&
           status == o.status &&
           review_status == o.review_status &&
           platform_campaign_status == o.platform_campaign_status &&
@@ -422,7 +433,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [platform_campaign_id, platform, campaign_name, status, review_status, platform_campaign_status, campaign_issues_info, ad_count, ad_set_count, budget, campaign_budget, budget_level, is_budget_schedule_enabled, currency, metrics, platform_ad_account_id, platform_ad_account_name, account_id, profile_id, advertising_channel_type, platform_objective, optimization_goal, bid_strategy, bid_amount, roas_average_floor, promoted_object, ad_sets, daily].hash
+      [platform_campaign_id, platform, campaign_name, created_time, status, review_status, platform_campaign_status, campaign_issues_info, ad_count, ad_set_count, budget, campaign_budget, budget_level, is_budget_schedule_enabled, currency, metrics, platform_ad_account_id, platform_ad_account_name, account_id, profile_id, advertising_channel_type, platform_objective, optimization_goal, bid_strategy, bid_amount, roas_average_floor, promoted_object, ad_sets, daily].hash
     end
 
     # Builds the object from hash

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

@@ -35,7 +35,7 @@ module Zernio
 
     attr_accessor :video
 
-    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
+    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`): setting both is a 400, unlike `POST /v1/ads/create` where the top-level fields are silently ignored in multi-creative mode. Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
     # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 

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

@@ -35,7 +35,7 @@ module Zernio
 
     attr_accessor :video
 
-    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
+    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`): setting both is a 400, unlike `POST /v1/ads/create` where the top-level fields are silently ignored in multi-creative mode. Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
     # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 

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

@@ -36,7 +36,7 @@ module Zernio
 
     attr_accessor :video
 
-    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`). Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
+    # Multi-creative shape: N CTWA ads under one campaign + one ad set, sharing budget and targeting. Mutually exclusive with the top-level single-creative fields (`headline` / `body` / `imageUrl` / `video`): setting both is a 400, unlike `POST /v1/ads/create` where the top-level fields are silently ignored in multi-creative mode. Each entry must supply its own headline, body, and exactly one of `imageUrl` / `video`. 
     attr_accessor :creatives
 
     # Attach the creatives to this EXISTING messaging ad set instead of building a campaign, so the ad set keeps its learning phase. It then owns budget, targeting and schedule, so `budgetAmount`, `budgetType`, `endDate`, `objective`, `countries`, `interests`, `audienceId` and `campaignStatus` are rejected with a 400 alongside it. Its `destination_type` must match the ad's destination. 

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -848,9 +848,11 @@ components:
             Multi-creative shape: N CTWA ads under one campaign + one
             ad set, sharing budget and targeting. Mutually exclusive
             with the top-level single-creative fields (`headline` /
-            `body` / `imageUrl` / `video`). Each entry must supply its
-            own headline, body, and exactly one of `imageUrl` /
-            `video`.
+            `body` / `imageUrl` / `video`): setting both is a 400,
+            unlike `POST /v1/ads/create` where the top-level fields
+            are silently ignored in multi-creative mode. Each entry
+            must supply its own headline, body, and exactly one of
+            `imageUrl` / `video`.
           items:
             type: object
             required: [headline, body]
@@ -8292,6 +8294,10 @@ components:
         platformAdSetId: { type: string }
         adSetName: { type: string }
         status: { allOf: [{ $ref: '#/components/schemas/AdStatus' }], description: Derived from child ad statuses }
+        createdTime:
+          type: [string, "null"]
+          format: date-time
+          description: "Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across this ad set's ads. Not the ad set's own creation time on the platform — a proxy usable for sorting."
         adCount: { type: integer }
         budget:
           type: [object, "null"]
@@ -8342,6 +8348,10 @@ components:
         platformCampaignId: { type: string }
         platform: { type: string, enum: [facebook, instagram, tiktok, linkedin, pinterest, google, twitter, openai] }
         campaignName: { type: string }
+        createdTime:
+          type: [string, "null"]
+          format: date-time
+          description: "Earliest `platformCreatedAt` (platform ad creation time; falls back to `createdAt`, Zernio's sync time, for ads synced before that field existed) across every ad in the campaign. Not the platform campaign's own creation time (Meta's `Campaign.created_time` etc. is not synced) — a campaign created empty and populated later will show its first ad's time, not the campaign's. Usable for sorting \"most recently created\" without the numeric-campaign-id heuristic. Same source as `AdTreeAdSet.createdTime` and `Ad.platformCreatedAt`; mirrors `AdCampaign.earliestAd`."
         status: { allOf: [{ $ref: '#/components/schemas/AdStatus' }], description: "Delivery status derived from child ad statuses. Distinct from `reviewStatus`, which reflects the platform-side review state." }
         reviewStatus:
           anyOf:

data/spec/models/ad_tree_ad_set_spec.rb

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

data/spec/models/ad_tree_campaign_spec.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zernio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.738
+  version: 0.0.739
 platform: ruby
 authors:
 - OpenAPI-Generator