zernio-sdk 0.0.531 → 0.0.532

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eaa5f26849657a92627dca36e035af7aebc2f4a966c08b7d997ba4708c20ee89
-  data.tar.gz: d363d35b4b938148821659d8d51ea2860e0eae73f71c1acc078a7101c915305b
+  metadata.gz: f5c7aae8aa0d4f6849a28e26a4d71c5074264026717d7b7a666e9e636170781e
+  data.tar.gz: 053dd32b6648528c8e4b2cb94c628288dd06335acce9f4fe08e57586ccb143fc
 SHA512:
-  metadata.gz: becc912c9e3733c3d2b0db5f32416a246da50d584735c75ee4f18465e59fc46932c6140474cea5a8fe9b00927110bd94d988a211c5c9696775481038ba07a01c
-  data.tar.gz: 294b76a7f76b4f716efb3b8e3c095166a39a9b4a0a7b59c3e0b67d9fff4c89ff1f71d7258765fbb4f398f9c0287fcc33d6fe4dd9e56789fb82e4fc9aa45f597c
+  metadata.gz: 70e1a5658a768a16184940231db1e86b53c137367242e296332283d73566a018c71ecd34d36b02c0efdebb3416a72cc792a438bd2a6b3506347dfaacc7c6423a
+  data.tar.gz: dc2c702ccf60d3420b39d02ede8806e452de4e9330071598190e67a663b6053fdd83c9bd4d88b584ee8dea45dab97b9a92ae9ff2d56813c0742ec0542f2f8571

data/README.md

@@ -111,12 +111,14 @@ Class | Method | HTTP request | Description
 *Zernio::AdsApi* | [**adjust_conversions**](docs/AdsApi.md#adjust_conversions) | **POST** /v1/ads/conversions/adjustments | Adjust uploaded conversions
 *Zernio::AdsApi* | [**archive_lead_form**](docs/AdsApi.md#archive_lead_form) | **DELETE** /v1/ads/lead-forms/{formId} | Archive a lead form
 *Zernio::AdsApi* | [**boost_post**](docs/AdsApi.md#boost_post) | **POST** /v1/ads/boost | Boost post as ad
+*Zernio::AdsApi* | [**cancel_rf_reservation**](docs/AdsApi.md#cancel_rf_reservation) | **DELETE** /v1/ads/rf-predictions/{predictionId} | Cancel a Reach & Frequency reservation (Meta)
 *Zernio::AdsApi* | [**create_ad_insights_report**](docs/AdsApi.md#create_ad_insights_report) | **POST** /v1/ads/insights/reports | Submit an async insights report run (Meta)
 *Zernio::AdsApi* | [**create_call_ad**](docs/AdsApi.md#create_call_ad) | **POST** /v1/ads/call | Create Click-to-Call ad
 *Zernio::AdsApi* | [**create_conversion_destination**](docs/AdsApi.md#create_conversion_destination) | **POST** /v1/accounts/{accountId}/conversion-destinations | Create a conversion destination
 *Zernio::AdsApi* | [**create_ctwa_ad**](docs/AdsApi.md#create_ctwa_ad) | **POST** /v1/ads/ctwa | Create Click-to-WhatsApp ad (deprecated)
 *Zernio::AdsApi* | [**create_lead_form**](docs/AdsApi.md#create_lead_form) | **POST** /v1/ads/lead-forms | Create a lead form
 *Zernio::AdsApi* | [**create_messaging_ad**](docs/AdsApi.md#create_messaging_ad) | **POST** /v1/ads/messaging | Create click-to-message ad (WhatsApp / Messenger / Instagram Direct)
+*Zernio::AdsApi* | [**create_rf_prediction**](docs/AdsApi.md#create_rf_prediction) | **POST** /v1/ads/rf-predictions | Create a Reach & Frequency prediction (Meta)
 *Zernio::AdsApi* | [**create_standalone_ad**](docs/AdsApi.md#create_standalone_ad) | **POST** /v1/ads/create | Create standalone ad
 *Zernio::AdsApi* | [**create_test_lead**](docs/AdsApi.md#create_test_lead) | **POST** /v1/ads/lead-forms/{formId}/test-leads | Create a test lead
 *Zernio::AdsApi* | [**delete_ad**](docs/AdsApi.md#delete_ad) | **DELETE** /v1/ads/{adId} | Cancel an ad
@@ -140,6 +142,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdsApi* | [**get_lead_form**](docs/AdsApi.md#get_lead_form) | **GET** /v1/ads/lead-forms/{formId} | Get a lead form
 *Zernio::AdsApi* | [**get_linked_in_bid_pricing**](docs/AdsApi.md#get_linked_in_bid_pricing) | **POST** /v1/ads/targeting/bid-pricing | Suggested bid and budget bounds (LinkedIn)
 *Zernio::AdsApi* | [**get_linked_in_supply_forecast**](docs/AdsApi.md#get_linked_in_supply_forecast) | **POST** /v1/ads/targeting/supply-forecast | Impressions, clicks and spend forecast (LinkedIn)
+*Zernio::AdsApi* | [**get_rf_prediction**](docs/AdsApi.md#get_rf_prediction) | **GET** /v1/ads/rf-predictions/{predictionId} | Read a Reach & Frequency prediction (Meta)
 *Zernio::AdsApi* | [**list_ad_accounts**](docs/AdsApi.md#list_ad_accounts) | **GET** /v1/ads/accounts | List ad accounts
 *Zernio::AdsApi* | [**list_ad_catalog_product_sets**](docs/AdsApi.md#list_ad_catalog_product_sets) | **GET** /v1/ads/catalogs/{catalogId}/product-sets | List a catalog's product sets
 *Zernio::AdsApi* | [**list_ad_catalogs**](docs/AdsApi.md#list_ad_catalogs) | **GET** /v1/ads/catalogs | List Meta product catalogs
@@ -154,6 +157,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdsApi* | [**list_whats_app_conversions**](docs/AdsApi.md#list_whats_app_conversions) | **GET** /v1/whatsapp/conversions | List conversion events
 *Zernio::AdsApi* | [**query_ad_insights**](docs/AdsApi.md#query_ad_insights) | **GET** /v1/ads/insights | Flexible live insights query (Meta)
 *Zernio::AdsApi* | [**remove_conversion_associations**](docs/AdsApi.md#remove_conversion_associations) | **DELETE** /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations | Remove associated campaigns
+*Zernio::AdsApi* | [**reserve_rf_prediction**](docs/AdsApi.md#reserve_rf_prediction) | **POST** /v1/ads/rf-predictions/{predictionId}/reserve | Reserve a Reach & Frequency prediction (Meta)
 *Zernio::AdsApi* | [**search_ad_interests**](docs/AdsApi.md#search_ad_interests) | **GET** /v1/ads/interests | Search targeting interests
 *Zernio::AdsApi* | [**search_ad_targeting**](docs/AdsApi.md#search_ad_targeting) | **GET** /v1/ads/targeting/search | Search targeting options
 *Zernio::AdsApi* | [**send_conversions**](docs/AdsApi.md#send_conversions) | **POST** /v1/ads/conversions | Send conversion events
@@ -770,6 +774,8 @@ Class | Method | HTTP request | Description
  - [Zernio::CreateProfileRequest](docs/CreateProfileRequest.md)
  - [Zernio::CreateQueueSlot201Response](docs/CreateQueueSlot201Response.md)
  - [Zernio::CreateQueueSlotRequest](docs/CreateQueueSlotRequest.md)
+ - [Zernio::CreateRfPrediction201Response](docs/CreateRfPrediction201Response.md)
+ - [Zernio::CreateRfPredictionRequest](docs/CreateRfPredictionRequest.md)
  - [Zernio::CreateSequence200Response](docs/CreateSequence200Response.md)
  - [Zernio::CreateSequence200ResponseSequence](docs/CreateSequence200ResponseSequence.md)
  - [Zernio::CreateSequenceRequest](docs/CreateSequenceRequest.md)
@@ -1521,6 +1527,8 @@ Class | Method | HTTP request | Description
  - [Zernio::ReplyToMention200Response](docs/ReplyToMention200Response.md)
  - [Zernio::ReplyToMentionRequest](docs/ReplyToMentionRequest.md)
  - [Zernio::ResendSmsRegistrationOtp200Response](docs/ResendSmsRegistrationOtp200Response.md)
+ - [Zernio::ReserveRfPrediction201Response](docs/ReserveRfPrediction201Response.md)
+ - [Zernio::ReserveRfPredictionRequest](docs/ReserveRfPredictionRequest.md)
  - [Zernio::RestoreWorkflowVersion200Response](docs/RestoreWorkflowVersion200Response.md)
  - [Zernio::RestoreWorkflowVersion200ResponseWorkflow](docs/RestoreWorkflowVersion200ResponseWorkflow.md)
  - [Zernio::RetweetPost200Response](docs/RetweetPost200Response.md)
@@ -1532,6 +1540,7 @@ Class | Method | HTTP request | Description
  - [Zernio::ReviewWebhookReview](docs/ReviewWebhookReview.md)
  - [Zernio::ReviewWebhookReviewReply](docs/ReviewWebhookReviewReply.md)
  - [Zernio::ReviewWebhookReviewReviewer](docs/ReviewWebhookReviewReviewer.md)
+ - [Zernio::RfPrediction](docs/RfPrediction.md)
  - [Zernio::SavedTargetingAudience](docs/SavedTargetingAudience.md)
  - [Zernio::ScheduleBroadcast200Response](docs/ScheduleBroadcast200Response.md)
  - [Zernio::ScheduleBroadcast200ResponseBroadcast](docs/ScheduleBroadcast200ResponseBroadcast.md)

data/docs/AdsApi.md

@@ -8,12 +8,14 @@ All URIs are relative to *https://zernio.com/api*
 | [**adjust_conversions**](AdsApi.md#adjust_conversions) | **POST** /v1/ads/conversions/adjustments | Adjust uploaded conversions |
 | [**archive_lead_form**](AdsApi.md#archive_lead_form) | **DELETE** /v1/ads/lead-forms/{formId} | Archive a lead form |
 | [**boost_post**](AdsApi.md#boost_post) | **POST** /v1/ads/boost | Boost post as ad |
+| [**cancel_rf_reservation**](AdsApi.md#cancel_rf_reservation) | **DELETE** /v1/ads/rf-predictions/{predictionId} | Cancel a Reach & Frequency reservation (Meta) |
 | [**create_ad_insights_report**](AdsApi.md#create_ad_insights_report) | **POST** /v1/ads/insights/reports | Submit an async insights report run (Meta) |
 | [**create_call_ad**](AdsApi.md#create_call_ad) | **POST** /v1/ads/call | Create Click-to-Call ad |
 | [**create_conversion_destination**](AdsApi.md#create_conversion_destination) | **POST** /v1/accounts/{accountId}/conversion-destinations | Create a conversion destination |
 | [**create_ctwa_ad**](AdsApi.md#create_ctwa_ad) | **POST** /v1/ads/ctwa | Create Click-to-WhatsApp ad (deprecated) |
 | [**create_lead_form**](AdsApi.md#create_lead_form) | **POST** /v1/ads/lead-forms | Create a lead form |
 | [**create_messaging_ad**](AdsApi.md#create_messaging_ad) | **POST** /v1/ads/messaging | Create click-to-message ad (WhatsApp / Messenger / Instagram Direct) |
+| [**create_rf_prediction**](AdsApi.md#create_rf_prediction) | **POST** /v1/ads/rf-predictions | Create a Reach & Frequency prediction (Meta) |
 | [**create_standalone_ad**](AdsApi.md#create_standalone_ad) | **POST** /v1/ads/create | Create standalone ad |
 | [**create_test_lead**](AdsApi.md#create_test_lead) | **POST** /v1/ads/lead-forms/{formId}/test-leads | Create a test lead |
 | [**delete_ad**](AdsApi.md#delete_ad) | **DELETE** /v1/ads/{adId} | Cancel an ad |
@@ -37,6 +39,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**get_lead_form**](AdsApi.md#get_lead_form) | **GET** /v1/ads/lead-forms/{formId} | Get a lead form |
 | [**get_linked_in_bid_pricing**](AdsApi.md#get_linked_in_bid_pricing) | **POST** /v1/ads/targeting/bid-pricing | Suggested bid and budget bounds (LinkedIn) |
 | [**get_linked_in_supply_forecast**](AdsApi.md#get_linked_in_supply_forecast) | **POST** /v1/ads/targeting/supply-forecast | Impressions, clicks and spend forecast (LinkedIn) |
+| [**get_rf_prediction**](AdsApi.md#get_rf_prediction) | **GET** /v1/ads/rf-predictions/{predictionId} | Read a Reach & Frequency prediction (Meta) |
 | [**list_ad_accounts**](AdsApi.md#list_ad_accounts) | **GET** /v1/ads/accounts | List ad accounts |
 | [**list_ad_catalog_product_sets**](AdsApi.md#list_ad_catalog_product_sets) | **GET** /v1/ads/catalogs/{catalogId}/product-sets | List a catalog's product sets |
 | [**list_ad_catalogs**](AdsApi.md#list_ad_catalogs) | **GET** /v1/ads/catalogs | List Meta product catalogs |
@@ -51,6 +54,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**list_whats_app_conversions**](AdsApi.md#list_whats_app_conversions) | **GET** /v1/whatsapp/conversions | List conversion events |
 | [**query_ad_insights**](AdsApi.md#query_ad_insights) | **GET** /v1/ads/insights | Flexible live insights query (Meta) |
 | [**remove_conversion_associations**](AdsApi.md#remove_conversion_associations) | **DELETE** /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations | Remove associated campaigns |
+| [**reserve_rf_prediction**](AdsApi.md#reserve_rf_prediction) | **POST** /v1/ads/rf-predictions/{predictionId}/reserve | Reserve a Reach & Frequency prediction (Meta) |
 | [**search_ad_interests**](AdsApi.md#search_ad_interests) | **GET** /v1/ads/interests | Search targeting interests |
 | [**search_ad_targeting**](AdsApi.md#search_ad_targeting) | **GET** /v1/ads/targeting/search | Search targeting options |
 | [**send_conversions**](AdsApi.md#send_conversions) | **POST** /v1/ads/conversions | Send conversion events |
@@ -345,6 +349,78 @@ end
 - **Accept**: application/json
 
 
+## cancel_rf_reservation
+
+> cancel_rf_reservation(prediction_id, account_id, ad_account_id)
+
+Cancel a Reach & Frequency reservation (Meta)
+
+Releases a RESERVATION's locked price and inventory. Unreserved predictions expire on their own.
+
+### 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::AdsApi.new
+prediction_id = 'prediction_id_example' # String | 
+account_id = 'account_id_example' # String | 
+ad_account_id = 'ad_account_id_example' # String | 
+
+begin
+  # Cancel a Reach & Frequency reservation (Meta)
+  api_instance.cancel_rf_reservation(prediction_id, account_id, ad_account_id)
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->cancel_rf_reservation: #{e}"
+end
+```
+
+#### Using the cancel_rf_reservation_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> cancel_rf_reservation_with_http_info(prediction_id, account_id, ad_account_id)
+
+```ruby
+begin
+  # Cancel a Reach & Frequency reservation (Meta)
+  data, status_code, headers = api_instance.cancel_rf_reservation_with_http_info(prediction_id, account_id, ad_account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->cancel_rf_reservation_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  |  |
+| **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## create_ad_insights_report
 
 > <CreateAdInsightsReport202Response> create_ad_insights_report(create_ad_insights_report_request)
@@ -759,6 +835,75 @@ nil (empty response body)
 - **Accept**: application/json
 
 
+## create_rf_prediction
+
+> <CreateRfPrediction201Response> create_rf_prediction(create_rf_prediction_request)
+
+Create a Reach & Frequency prediction (Meta)
+
+Creates an R&F prediction — a QUOTE, nothing is bought and no ad entities are created. Provide a date range plus exactly one of `budgetAmount` (Meta predicts reach) or `reach` (Meta predicts the budget). The response carries the estimate and its allowed bounds (min/max budget and reach). Predictions expire on their own; to buy, reserve one via POST /v1/ads/rf-predictions/{predictionId}/reserve and pass the RESERVED id to POST /v1/ads/create with `buyingType: \"RESERVED\"`.  Reservation campaigns reject automatic placements, so omitted `placements` default to Facebook feed (+ Instagram stream when a linked IG professional account resolves); Instagram placements require that IG account. Meta only.
+
+### 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::AdsApi.new
+create_rf_prediction_request = Zernio::CreateRfPredictionRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example', start_date: Time.now, end_date: Time.now}) # CreateRfPredictionRequest | 
+
+begin
+  # Create a Reach & Frequency prediction (Meta)
+  result = api_instance.create_rf_prediction(create_rf_prediction_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->create_rf_prediction: #{e}"
+end
+```
+
+#### Using the create_rf_prediction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateRfPrediction201Response>, Integer, Hash)> create_rf_prediction_with_http_info(create_rf_prediction_request)
+
+```ruby
+begin
+  # Create a Reach & Frequency prediction (Meta)
+  data, status_code, headers = api_instance.create_rf_prediction_with_http_info(create_rf_prediction_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateRfPrediction201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->create_rf_prediction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_rf_prediction_request** | [**CreateRfPredictionRequest**](CreateRfPredictionRequest.md) |  |  |
+
+### Return type
+
+[**CreateRfPrediction201Response**](CreateRfPrediction201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## create_standalone_ad
 
 > <CreateStandaloneAd201Response> create_standalone_ad(create_standalone_ad_request, opts)
@@ -2433,6 +2578,77 @@ end
 - **Accept**: application/json
 
 
+## get_rf_prediction
+
+> <CreateRfPrediction201Response> get_rf_prediction(prediction_id, account_id, ad_account_id)
+
+Read a Reach & Frequency prediction (Meta)
+
+### 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::AdsApi.new
+prediction_id = 'prediction_id_example' # String | 
+account_id = 'account_id_example' # String | 
+ad_account_id = 'ad_account_id_example' # String | 
+
+begin
+  # Read a Reach & Frequency prediction (Meta)
+  result = api_instance.get_rf_prediction(prediction_id, account_id, ad_account_id)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->get_rf_prediction: #{e}"
+end
+```
+
+#### Using the get_rf_prediction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreateRfPrediction201Response>, Integer, Hash)> get_rf_prediction_with_http_info(prediction_id, account_id, ad_account_id)
+
+```ruby
+begin
+  # Read a Reach & Frequency prediction (Meta)
+  data, status_code, headers = api_instance.get_rf_prediction_with_http_info(prediction_id, account_id, ad_account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreateRfPrediction201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->get_rf_prediction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  |  |
+| **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  |  |
+
+### Return type
+
+[**CreateRfPrediction201Response**](CreateRfPrediction201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_ad_accounts
 
 > <ListAdAccounts200Response> list_ad_accounts(account_id, opts)
@@ -3519,6 +3735,77 @@ end
 - **Accept**: application/json
 
 
+## reserve_rf_prediction
+
+> <ReserveRfPrediction201Response> reserve_rf_prediction(prediction_id, reserve_rf_prediction_request)
+
+Reserve a Reach & Frequency prediction (Meta)
+
+Locks the quoted price + inventory until the returned `expiresAt` and mints a NEW prediction id — pass that RESERVED id (not the original) as `rfPredictionId` on POST /v1/ads/create. Release an unused reservation via DELETE. Meta only.
+
+### 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::AdsApi.new
+prediction_id = 'prediction_id_example' # String | 
+reserve_rf_prediction_request = Zernio::ReserveRfPredictionRequest.new({account_id: 'account_id_example', ad_account_id: 'ad_account_id_example'}) # ReserveRfPredictionRequest | 
+
+begin
+  # Reserve a Reach & Frequency prediction (Meta)
+  result = api_instance.reserve_rf_prediction(prediction_id, reserve_rf_prediction_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->reserve_rf_prediction: #{e}"
+end
+```
+
+#### Using the reserve_rf_prediction_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReserveRfPrediction201Response>, Integer, Hash)> reserve_rf_prediction_with_http_info(prediction_id, reserve_rf_prediction_request)
+
+```ruby
+begin
+  # Reserve a Reach & Frequency prediction (Meta)
+  data, status_code, headers = api_instance.reserve_rf_prediction_with_http_info(prediction_id, reserve_rf_prediction_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReserveRfPrediction201Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AdsApi->reserve_rf_prediction_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  |  |
+| **reserve_rf_prediction_request** | [**ReserveRfPredictionRequest**](ReserveRfPredictionRequest.md) |  |  |
+
+### Return type
+
+[**ReserveRfPrediction201Response**](ReserveRfPrediction201Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## search_ad_interests
 
 > <SearchAdInterests200Response> search_ad_interests(q, account_id)

data/docs/CreateRfPrediction201Response.md

@@ -0,0 +1,22 @@
+# Zernio::CreateRfPrediction201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_account_id** | **String** |  | [optional] |
+| **currency** | **String** |  | [optional] |
+| **prediction** | [**RfPrediction**](RfPrediction.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateRfPrediction201Response.new(
+  ad_account_id: null,
+  currency: null,
+  prediction: null
+)
+```
+

data/docs/CreateRfPredictionRequest.md

@@ -0,0 +1,34 @@
+# Zernio::CreateRfPredictionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Zernio SocialAccount id (posting or ads variant). |  |
+| **ad_account_id** | **String** | Meta ad account id (act_<n>). |  |
+| **budget_amount** | **Float** | Whole currency units. Exactly one of budgetAmount / reach. | [optional] |
+| **reach** | **Integer** | Target unique reach. Exactly one of budgetAmount / reach. | [optional] |
+| **start_date** | **Time** | Campaign window start (must be in the future). |  |
+| **end_date** | **Time** |  |  |
+| **frequency_cap** | **Integer** | Max impressions per person over the window. | [optional] |
+| **targeting** | **Object** | Canonical camelCase TargetingSpec (same shape as /v1/ads/create's `targeting`). Defaults to countries: [US]. | [optional] |
+| **placements** | **Object** | Meta placements object (same shape as /v1/ads/create's `placements`). | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateRfPredictionRequest.new(
+  account_id: null,
+  ad_account_id: null,
+  budget_amount: null,
+  reach: null,
+  start_date: null,
+  end_date: null,
+  frequency_cap: null,
+  targeting: null,
+  placements: null
+)
+```
+

data/docs/CreateStandaloneAdRequest.md

@@ -14,6 +14,8 @@
 | **goal** | **String** | Required on legacy and multi-creative shapes; the attach shape inherits it from the ad set. Available goals vary by platform.  **Meta** - `conversions`: OUTCOME_SALES. Requires `promotedObject.pixelId` and `promotedObject.customEventType` with a commerce event such as PURCHASE or START_TRIAL. - `lead_conversion`: OUTCOME_LEADS optimizing website pixel leads. Same pixel and event fields, but with a leads-class event such as LEAD, SUBMIT_APPLICATION, SCHEDULE or CONTACT. Meta gates conversion events by objective, so leads-class events are rejected under `conversions`. - `lead_generation`: OUTCOME_LEADS with instant forms. Requires `leadGenFormId`. `promotedObject.pageId` is optional and auto-filled from the connected Page. - `app_promotion`: requires `promotedObject.applicationId` and `promotedObject.objectStoreUrl`. - `catalog_sales`: Advantage+ catalog ads, for example vehicle inventory. Requires `promotedObject.productSetId`, `promotedObject.pixelId` and `promotedObject.customEventType`. Builds a catalog TEMPLATE creative from the copy fields, which may carry template tags like {{product.name}} or {{vehicle.make}}. No imageUrl or video is sent; Meta renders the visuals per catalog item. Discover catalogs via GET /v1/ads/catalogs and product sets via GET /v1/ads/catalogs/{catalogId}/product-sets. Single shape only, no creatives[], adSetId, dynamicCreative or placementAssets.  **TikTok** - `conversions`: website-conversion ad group. Requires `promotedObject.pixelId`, your TikTok Pixel ID. Accepts an optional `promotedObject.customEventType` with a TikTok optimization_event code your pixel tracks (newer pixels use e.g. SHOPPING for purchase events; legacy pixels use ON_WEB_ORDER, INITIATE_ORDER, ON_WEB_REGISTER or FORM). To inherit pixel and event from an existing ad group, pass `adSetId` instead.  **LinkedIn** - `engagement`, `traffic`, `awareness` and `video_views` create standalone Direct Sponsored Content ads. `traffic` requires `linkUrl`; `video_views` requires `video`. - `job_applicants` requires a `platformSpecificData.jobs` creative. - For `lead_generation` or `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.  | [optional] |
 | **optimization_goal** | **String** | Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations. | [optional] |
 | **billing_event** | **String** | Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal. | [optional] |
+| **buying_type** | **String** | Meta only. RESERVED = Reach & Frequency: requires `rfPredictionId` (a RESERVED prediction from /v1/ads/rf-predictions + /reserve). Budget, schedule and pricing come from the reservation, so budgetAmount/budgetType are not required and bid fields are ignored. Only the plain single-ad shape (no creatives[], adSetId, existingCampaignId or dynamicCreative). | [optional] |
+| **rf_prediction_id** | **String** | Meta only. The RESERVED prediction id the R&F ad set runs on (reserving mints a new id — pass that one). Requires buyingType RESERVED. | [optional] |
 | **budget_amount** | **Float** | Required on legacy + multi-creative shapes. Inherited on attach. | [optional] |
 | **budget_type** | **String** | Required on legacy + multi-creative shapes. Inherited on attach. | [optional] |
 | **status** | **String** | Meta and TikTok. Publish state of the created entities. Omitted or ACTIVE publishes live (default, back-compat); PAUSED creates them paused and skips activation, so you can review before they spend. On TikTok the whole campaign > ad group > ad hierarchy stays paused. | [optional] |
@@ -93,6 +95,8 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   goal: null,
   optimization_goal: null,
   billing_event: null,
+  buying_type: null,
+  rf_prediction_id: null,
   budget_amount: null,
   budget_type: null,
   status: null,

data/docs/ReserveRfPrediction201Response.md

@@ -0,0 +1,20 @@
+# Zernio::ReserveRfPrediction201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ad_account_id** | **String** |  | [optional] |
+| **prediction** | [**RfPrediction**](RfPrediction.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ReserveRfPrediction201Response.new(
+  ad_account_id: null,
+  prediction: null
+)
+```
+

data/docs/ReserveRfPredictionRequest.md

@@ -0,0 +1,20 @@
+# Zernio::ReserveRfPredictionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** |  |  |
+| **ad_account_id** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ReserveRfPredictionRequest.new(
+  account_id: null,
+  ad_account_id: null
+)
+```
+

data/docs/RfPrediction.md

@@ -0,0 +1,42 @@
+# Zernio::RfPrediction
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **prediction_id** | **String** |  | [optional] |
+| **status** | **String** | ready | pending | failed:<meta code> | [optional] |
+| **budget** | **Float** | Quoted (or provided) lifetime budget for the window. | [optional] |
+| **reach** | **Integer** | Predicted (or requested) unique reach. | [optional] |
+| **impressions** | **Integer** |  | [optional] |
+| **min_budget** | **Float** | Meta's allowed lower bound for this spec. | [optional] |
+| **max_budget** | **Float** |  | [optional] |
+| **min_reach** | **Integer** |  | [optional] |
+| **max_reach** | **Integer** |  | [optional] |
+| **frequency_cap** | **Integer** |  | [optional] |
+| **start_time** | **Integer** | Unix seconds; the reserved window the R&F ad set will run on. | [optional] |
+| **stop_time** | **Integer** |  | [optional] |
+| **expires_at** | **String** | When the reservation's locked price expires (set after reserving). | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::RfPrediction.new(
+  prediction_id: null,
+  status: null,
+  budget: null,
+  reach: null,
+  impressions: null,
+  min_budget: null,
+  max_budget: null,
+  min_reach: null,
+  max_reach: null,
+  frequency_cap: null,
+  start_time: null,
+  stop_time: null,
+  expires_at: null
+)
+```
+