zernio-sdk 0.0.527 → 0.0.529

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 993a8b5e915ce68f01e62c2a5164906d7b7b461066671612dace526f2c5f7322
-  data.tar.gz: db65e798dbc41cdfeb336abffc6883e4c464b3045e00f287e574f070aec82bf8
+  metadata.gz: 2e0db6a79e9e00f953f3027692b48bb968aca3afcf369eb2b39a1d3e7fe8c9c4
+  data.tar.gz: fadcc6fc532b75244e7488b02a5f115345f7aedd432c284d3ba2e5dd565dd0ef
 SHA512:
-  metadata.gz: 985689b6d5b2c191463e66e6692f3aba988e0f5e5f7e01255a1f785ce3aaf3c563dea81cf0c9b40b819f30ffc08b7e4fdbc8f0470e7cbae64c1cc79a99da208d
-  data.tar.gz: 17bfcbd5e6ffd3e677c6dc2c5a5cd0731ad7b5a7fa3518cc9d7c1f5e16f3285e9593ea934e23c57cff247d7a8765a1e386e4c30efc7c2521c0f3c266f09f5dcd
+  metadata.gz: b01573d5ee8adf9f841cf202c718f6b7c9080038e83bce3f3aee59fc7d3495428e208cb3f58891bccd1e2a94b58797cdce10982eeeb44b3e411529b821bb4966
+  data.tar.gz: c46db1bad44769174f88ce13a5ecc7f81fe4d353485c4ab69fb582f9825296417f38d58928c8a26891c0ebcd2abf10620d56a05bb6a8c6e9c79279ada1b6a22d

data/README.md

@@ -780,6 +780,7 @@ Class | Method | HTTP request | Description
  - [Zernio::CreateStandaloneAdRequestAttributionSpecInner](docs/CreateStandaloneAdRequestAttributionSpecInner.md)
  - [Zernio::CreateStandaloneAdRequestBehaviorsInner](docs/CreateStandaloneAdRequestBehaviorsInner.md)
  - [Zernio::CreateStandaloneAdRequestBrandIdentity](docs/CreateStandaloneAdRequestBrandIdentity.md)
+ - [Zernio::CreateStandaloneAdRequestCarouselCardsInner](docs/CreateStandaloneAdRequestCarouselCardsInner.md)
  - [Zernio::CreateStandaloneAdRequestCitiesInner](docs/CreateStandaloneAdRequestCitiesInner.md)
  - [Zernio::CreateStandaloneAdRequestCreativesInner](docs/CreateStandaloneAdRequestCreativesInner.md)
  - [Zernio::CreateStandaloneAdRequestCreativesInnerVideo](docs/CreateStandaloneAdRequestCreativesInnerVideo.md)

data/docs/AdsApi.md

@@ -2850,6 +2850,10 @@ opts = {
   level: 'ad', # String | Row granularity
   fields: 'fields_example', # String | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
   breakdowns: 'breakdowns_example', # String | Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+  action_breakdowns: 'action_breakdowns_example', # String | Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+  action_attribution_windows: 'action_attribution_windows_example', # String | Comma-separated Meta attribution windows. Action values are returned keyed per window.
+  action_report_time: 'action_report_time_example', # String | When actions are counted: impression, conversion or mixed.
+  use_unified_attribution_setting: true, # Boolean | Use the ad sets' own attribution settings for action counting.
   filtering: 'filtering_example', # String | JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta.
   date_preset: 'date_preset_example', # String | Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
   from_date: Date.parse('2013-10-20'), # Date | Start of range (YYYY-MM-DD); requires toDate.
@@ -2895,6 +2899,10 @@ end
 | **level** | **String** | Row granularity | [optional] |
 | **fields** | **String** | Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set. | [optional] |
 | **breakdowns** | **String** | Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). | [optional] |
+| **action_breakdowns** | **String** | Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row. | [optional] |
+| **action_attribution_windows** | **String** | Comma-separated Meta attribution windows. Action values are returned keyed per window. | [optional] |
+| **action_report_time** | **String** | When actions are counted: impression, conversion or mixed. | [optional] |
+| **use_unified_attribution_setting** | **Boolean** | Use the ad sets' own attribution settings for action counting. | [optional] |
 | **filtering** | **String** | JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta. | [optional] |
 | **date_preset** | **String** | Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate. | [optional] |
 | **from_date** | **Date** | Start of range (YYYY-MM-DD); requires toDate. | [optional] |

data/docs/AssignGoogleBusinessLocation200ResponseAccount.md

@@ -9,8 +9,8 @@
 | **username** | **String** |  | [optional] |
 | **display_name** | **String** |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
-| **selected_location_name** | **String** |  | [optional] |
-| **selected_location_id** | **String** |  | [optional] |
+| **selected_location_name** | **String** | Human-readable location display name (e.g. \"Snap Fitness Dianella\"), NOT a resource name. Do not use it to build API paths. | [optional] |
+| **selected_location_id** | **String** | Bare GBP location id (digits only). Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames. | [optional] |
 
 ## Example
 

data/docs/BatchGetGoogleBusinessReviews200ResponseLocationReviewsInner.md

@@ -4,8 +4,8 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **name** | **String** | Full review resource name (accounts/*/locations/*/reviews/*) | [optional] |
-| **review** | **Object** | The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply) | [optional] |
+| **name** | **String** | LOCATION resource name the review belongs to (accounts/{accountId}/locations/{locationId}) - NOT the review resource name. Use it to attribute the review to a location; the review identity is review.reviewId (full review resource name at review.name). | [optional] |
+| **review** | **Object** | The review object: reviewId (the review's identity), name (full review resource name, accounts/*/locations/*/reviews/*), starRating, comment, reviewer, createTime, updateTime, reviewReply, and reviewMediaItems (review photos/videos; photo items carry thumbnailUrl, video items carry videoUrl) | [optional] |
 
 ## Example
 

data/docs/BatchGetGoogleBusinessReviewsRequest.md

@@ -4,9 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **location_names** | **Array<String>** | Array of full location resource names (e.g. ['accounts/123/locations/456']) |  |
+| **location_names** | **Array<String>** | Array of full location resource names (e.g. ['accounts/123/locations/456']). Max 50 per request (Google's batchGetReviews cap); chunk larger sets into multiple requests. |  |
 | **page_size** | **Integer** | Number of reviews per page (max 50) | [optional][default to 50] |
 | **page_token** | **String** | Pagination token from previous response | [optional] |
+| **order_by** | **String** | Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window. | [optional][default to 'updateTime desc'] |
 
 ## Example
 
@@ -16,7 +17,8 @@ require 'zernio-sdk'
 instance = Zernio::BatchGetGoogleBusinessReviewsRequest.new(
   location_names: null,
   page_size: null,
-  page_token: null
+  page_token: null,
+  order_by: null
 )
 ```
 

data/docs/CreateAdInsightsReportRequest.md

@@ -9,6 +9,10 @@
 | **level** | **String** |  | [optional] |
 | **fields** | **String** | Comma-separated Graph insights fields. | [optional] |
 | **breakdowns** | **String** | Comma-separated Graph breakdowns. | [optional] |
+| **action_breakdowns** | **String** | Comma-separated Graph action breakdowns (e.g. action_type,action_destination). | [optional] |
+| **action_attribution_windows** | **Array<String>** | Meta attribution windows (e.g. [\"7d_click\", \"1d_view\"]). Action values are returned keyed per window. | [optional] |
+| **action_report_time** | **String** | When actions are counted: impression, conversion or mixed. | [optional] |
+| **use_unified_attribution_setting** | **Boolean** | Use the ad sets' own attribution settings for action counting. | [optional] |
 | **filtering** | [**Array<CreateAdInsightsReportRequestFilteringInner>**](CreateAdInsightsReportRequestFilteringInner.md) | Meta filter objects, applied server-side. | [optional] |
 | **date_preset** | **String** | Mutually exclusive with fromDate/toDate. | [optional] |
 | **from_date** | **Date** |  | [optional] |
@@ -26,6 +30,10 @@ instance = Zernio::CreateAdInsightsReportRequest.new(
   level: null,
   fields: null,
   breakdowns: null,
+  action_breakdowns: null,
+  action_attribution_windows: null,
+  action_report_time: null,
+  use_unified_attribution_setting: null,
   filtering: null,
   date_preset: null,
   from_date: null,

data/docs/CreateStandaloneAdRequest.md

@@ -57,6 +57,7 @@
 | **start_date** | **Time** | Meta only. Ad-set start time (ISO 8601, e.g. \"2026-06-10T09:00:00Z\"), mapped to the ad set's `start_time`. When omitted the ad starts delivering immediately. For lifetime budgets Meta also requires `endDate`. (Same `schedule.startDate` semantics already available on `POST /v1/ads/boost`.)  | [optional] |
 | **instagram_account_id** | **String** | Meta only. Override the Instagram account the ad is delivered as — pass an Instagram Business Account ID (e.g. 17841...), mapped to the creative's `instagram_user_id`. When omitted we auto-resolve the IG account linked to the connected Facebook Page (the existing default). Useful when a Page has more than one eligible IG account.  | [optional] |
 | **dynamic_creative** | [**CreateStandaloneAdRequestDynamicCreative**](CreateStandaloneAdRequestDynamicCreative.md) |  | [optional] |
+| **carousel_cards** | [**Array<CreateStandaloneAdRequestCarouselCardsInner>**](CreateStandaloneAdRequestCarouselCardsInner.md) | Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to the creative's `link_data.child_attachments`. Unlike `dynamicCreative`, you control the card order and per-card copy/link. Requires top-level `body`, `linkUrl` and `callToAction`. Mutually exclusive with `imageUrl`/`video`, `creatives[]`, `dynamicCreative`, `placementAssets`, `existingCreativeId`, `adSetId`, `leadGenFormId` and goal `catalog_sales`.  | [optional] |
 | **placement_assets** | [**CreateStandaloneAdRequestPlacementAssets**](CreateStandaloneAdRequestPlacementAssets.md) |  | [optional] |
 | **audience_id** | **String** | Custom audience ID for targeting | [optional] |
 | **campaign_type** | **String** | Google only | [optional][default to 'display'] |
@@ -135,6 +136,7 @@ instance = Zernio::CreateStandaloneAdRequest.new(
   start_date: null,
   instagram_account_id: null,
   dynamic_creative: null,
+  carousel_cards: null,
   placement_assets: null,
   audience_id: null,
   campaign_type: null,

data/docs/CreateStandaloneAdRequestCarouselCardsInner.md

@@ -0,0 +1,26 @@
+# Zernio::CreateStandaloneAdRequestCarouselCardsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **image_url** | **String** | Card image; uploaded to the ad account and referenced by hash. |  |
+| **link_url** | **String** | Card destination URL. Defaults to the top-level linkUrl. | [optional] |
+| **headline** | **String** | Card headline, shown below the card image. | [optional] |
+| **description** | **String** | Card description, shown under the headline. | [optional] |
+| **call_to_action** | **String** | Card CTA override. Defaults to the top-level callToAction; same enum. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::CreateStandaloneAdRequestCarouselCardsInner.new(
+  image_url: null,
+  link_url: null,
+  headline: null,
+  description: null,
+  call_to_action: null
+)
+```
+

data/docs/GMBReviewsApi.md

@@ -16,7 +16,7 @@ All URIs are relative to *https://zernio.com/api*
 
 Batch get reviews
 
-Fetches reviews across multiple locations in a single request. More efficient than calling GET /gmb-reviews per location for multi-location businesses. Returns a flat list of individual reviews, each tagged with its review resource name. Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount). For those, use the single-location GET /gmb-reviews endpoint. 
+Fetches reviews across multiple locations in a single request. More efficient than calling GET /gmb-reviews per location for multi-location businesses. Returns a flat locationReviews array (not grouped by location): each item carries the location resource name it belongs to (`name`) plus the review object (`review`), whose identity is `review.reviewId`. Reviews are requested from Google ordered by `orderBy` (default `updateTime desc`, newest first), so callers polling for recent reviews can stop paginating once they cross their date window. Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount). For those, use the single-location GET /gmb-reviews endpoint. 
 
 ### Examples
 

data/docs/ListInboxComments200ResponseDataInner.md

@@ -8,12 +8,12 @@
 | **platform** | **String** |  | [optional] |
 | **account_id** | **String** |  | [optional] |
 | **account_username** | **String** |  | [optional] |
-| **content** | **String** |  | [optional] |
-| **picture** | **String** |  | [optional] |
-| **permalink** | **String** |  | [optional] |
+| **content** | **String** | The post text/caption. On ad rows (isAd: true) this is the AD NAME, not the underlying post's caption — the creative text isn't exposed here. | [optional] |
+| **picture** | **String** | Post media thumbnail. On ad rows this is the ad creative thumbnail. | [optional] |
+| **permalink** | **String** | Public URL of the post. On ad rows: the Facebook dark-post URL (facebook placement) or the IG media permalink (instagram placement); may be null when unknown. | [optional] |
 | **created_time** | **Time** |  | [optional] |
 | **comment_count** | **Integer** |  | [optional] |
-| **like_count** | **Integer** |  | [optional] |
+| **like_count** | **Integer** | Not fetched for ad rows (always 0 there). | [optional] |
 | **cid** | **String** | Bluesky content identifier | [optional] |
 | **subreddit** | **String** | Reddit subreddit name | [optional] |
 | **is_ad** | **Boolean** | True when this row is an ad (boosted/dark post). `platform` is then the placement (facebook = the Page dark post / instagram = the IG media), `id` is `{adId}:{placement}`, and the thread is at GET /v1/ads/{adId}/comments?placement={placement}. | [optional] |

data/docs/ListInboxReviews200ResponseDataInner.md

@@ -4,10 +4,12 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **String** |  | [optional] |
+| **id** | **String** | Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location. | [optional] |
 | **platform** | **String** |  | [optional] |
 | **account_id** | **String** |  | [optional] |
 | **account_username** | **String** |  | [optional] |
+| **location_id** | **String** | Bare GBP location id the review belongs to. Google Business only; absent for other platforms. | [optional] |
+| **location_name** | **String** | Human-readable GBP location display name. Google Business only; absent for other platforms. | [optional] |
 | **reviewer** | [**ListInboxReviews200ResponseDataInnerReviewer**](ListInboxReviews200ResponseDataInnerReviewer.md) |  | [optional] |
 | **rating** | **Integer** |  | [optional] |
 | **text** | **String** |  | [optional] |
@@ -29,6 +31,8 @@ instance = Zernio::ListInboxReviews200ResponseDataInner.new(
   platform: null,
   account_id: null,
   account_username: null,
+  location_id: null,
+  location_name: null,
   reviewer: null,
   rating: null,
   text: null,

data/docs/SelectGoogleBusinessLocation200ResponseAccount.md

@@ -9,8 +9,8 @@
 | **username** | **String** |  | [optional] |
 | **display_name** | **String** |  | [optional] |
 | **is_active** | **Boolean** |  | [optional] |
-| **selected_location_name** | **String** |  | [optional] |
-| **selected_location_id** | **String** |  | [optional] |
+| **selected_location_name** | **String** | Human-readable location display name, NOT a resource name. Do not use it to build API paths. | [optional] |
+| **selected_location_id** | **String** | Bare GBP location id. Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames. | [optional] |
 
 ## Example
 

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

@@ -2841,6 +2841,10 @@ module Zernio
     # @option opts [String] :level Row granularity
     # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
     # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+    # @option opts [String] :action_breakdowns Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+    # @option opts [String] :action_attribution_windows Comma-separated Meta attribution windows. Action values are returned keyed per window.
+    # @option opts [String] :action_report_time When actions are counted: impression, conversion or mixed.
+    # @option opts [Boolean] :use_unified_attribution_setting Use the ad sets' own attribution settings for action counting.
     # @option opts [String] :filtering JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta.
     # @option opts [String] :date_preset Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
     # @option opts [Date] :from_date Start of range (YYYY-MM-DD); requires toDate.
@@ -2862,6 +2866,10 @@ module Zernio
     # @option opts [String] :level Row granularity
     # @option opts [String] :fields Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
     # @option opts [String] :breakdowns Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+    # @option opts [String] :action_breakdowns Comma-separated Graph action breakdowns. Segments the actions[] arrays in each row.
+    # @option opts [String] :action_attribution_windows Comma-separated Meta attribution windows. Action values are returned keyed per window.
+    # @option opts [String] :action_report_time When actions are counted: impression, conversion or mixed.
+    # @option opts [Boolean] :use_unified_attribution_setting Use the ad sets' own attribution settings for action counting.
     # @option opts [String] :filtering JSON array of Meta filter objects: [{\"field\", \"operator\", \"value\"}]. Applied server-side by Meta.
     # @option opts [String] :date_preset Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
     # @option opts [Date] :from_date Start of range (YYYY-MM-DD); requires toDate.
@@ -2904,6 +2912,10 @@ module Zernio
       query_params[:'level'] = opts[:'level'] if !opts[:'level'].nil?
       query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
       query_params[:'breakdowns'] = opts[:'breakdowns'] if !opts[:'breakdowns'].nil?
+      query_params[:'actionBreakdowns'] = opts[:'action_breakdowns'] if !opts[:'action_breakdowns'].nil?
+      query_params[:'actionAttributionWindows'] = opts[:'action_attribution_windows'] if !opts[:'action_attribution_windows'].nil?
+      query_params[:'actionReportTime'] = opts[:'action_report_time'] if !opts[:'action_report_time'].nil?
+      query_params[:'useUnifiedAttributionSetting'] = opts[:'use_unified_attribution_setting'] if !opts[:'use_unified_attribution_setting'].nil?
       query_params[:'filtering'] = opts[:'filtering'] if !opts[:'filtering'].nil?
       query_params[:'datePreset'] = opts[:'date_preset'] if !opts[:'date_preset'].nil?
       query_params[:'fromDate'] = opts[:'from_date'] if !opts[:'from_date'].nil?

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

@@ -20,7 +20,7 @@ module Zernio
       @api_client = api_client
     end
     # Batch get reviews
-    # Fetches reviews across multiple locations in a single request. More efficient than calling GET /gmb-reviews per location for multi-location businesses. Returns a flat list of individual reviews, each tagged with its review resource name. Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount). For those, use the single-location GET /gmb-reviews endpoint. 
+    # Fetches reviews across multiple locations in a single request. More efficient than calling GET /gmb-reviews per location for multi-location businesses. Returns a flat locationReviews array (not grouped by location): each item carries the location resource name it belongs to (`name`) plus the review object (`review`), whose identity is `review.reviewId`. Reviews are requested from Google ordered by `orderBy` (default `updateTime desc`, newest first), so callers polling for recent reviews can stop paginating once they cross their date window. Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount). For those, use the single-location GET /gmb-reviews endpoint. 
     # @param account_id [String] 
     # @param batch_get_google_business_reviews_request [BatchGetGoogleBusinessReviewsRequest] 
     # @param [Hash] opts the optional parameters
@@ -31,7 +31,7 @@ module Zernio
     end
 
     # Batch get reviews
-    # Fetches reviews across multiple locations in a single request. More efficient than calling GET /gmb-reviews per location for multi-location businesses. Returns a flat list of individual reviews, each tagged with its review resource name. Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount). For those, use the single-location GET /gmb-reviews endpoint. 
+    # Fetches reviews across multiple locations in a single request. More efficient than calling GET /gmb-reviews per location for multi-location businesses. Returns a flat locationReviews array (not grouped by location): each item carries the location resource name it belongs to (`name`) plus the review object (`review`), whose identity is `review.reviewId`. Reviews are requested from Google ordered by `orderBy` (default `updateTime desc`, newest first), so callers polling for recent reviews can stop paginating once they cross their date window. Note: this endpoint does not return aggregate metrics (averageRating / totalReviewCount). For those, use the single-location GET /gmb-reviews endpoint. 
     # @param account_id [String] 
     # @param batch_get_google_business_reviews_request [BatchGetGoogleBusinessReviewsRequest] 
     # @param [Hash] opts the optional parameters

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

@@ -25,8 +25,10 @@ module Zernio
 
     attr_accessor :is_active
 
+    # Human-readable location display name (e.g. \"Snap Fitness Dianella\"), NOT a resource name. Do not use it to build API paths.
     attr_accessor :selected_location_name
 
+    # Bare GBP location id (digits only). Combine with the GBP account id as accounts/{gbpAccountId}/locations/{selectedLocationId} to form the location resource names that gmb-reviews/batch expects in locationNames.
     attr_accessor :selected_location_id
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -15,10 +15,10 @@ require 'time'
 
 module Zernio
   class BatchGetGoogleBusinessReviews200ResponseLocationReviewsInner < ApiModelBase
-    # Full review resource name (accounts/*/locations/*/reviews/*)
+    # LOCATION resource name the review belongs to (accounts/{accountId}/locations/{locationId}) - NOT the review resource name. Use it to attribute the review to a location; the review identity is review.reviewId (full review resource name at review.name).
     attr_accessor :name
 
-    # The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
+    # The review object: reviewId (the review's identity), name (full review resource name, accounts/*/locations/*/reviews/*), starRating, comment, reviewer, createTime, updateTime, reviewReply, and reviewMediaItems (review photos/videos; photo items carry thumbnailUrl, video items carry videoUrl)
     attr_accessor :review
 
     # Attribute mapping from ruby-style variable name to JSON key.

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

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class BatchGetGoogleBusinessReviewsRequest < ApiModelBase
-    # Array of full location resource names (e.g. ['accounts/123/locations/456'])
+    # Array of full location resource names (e.g. ['accounts/123/locations/456']). Max 50 per request (Google's batchGetReviews cap); chunk larger sets into multiple requests.
     attr_accessor :location_names
 
     # Number of reviews per page (max 50)
@@ -24,12 +24,38 @@ module Zernio
     # Pagination token from previous response
     attr_accessor :page_token
 
+    # Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window.
+    attr_accessor :order_by
+
+    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
       {
         :'location_names' => :'locationNames',
         :'page_size' => :'pageSize',
-        :'page_token' => :'pageToken'
+        :'page_token' => :'pageToken',
+        :'order_by' => :'orderBy'
       }
     end
 
@@ -48,7 +74,8 @@ module Zernio
       {
         :'location_names' => :'Array<String>',
         :'page_size' => :'Integer',
-        :'page_token' => :'String'
+        :'page_token' => :'String',
+        :'order_by' => :'String'
       }
     end
 
@@ -91,6 +118,12 @@ module Zernio
       if attributes.key?(:'page_token')
         self.page_token = attributes[:'page_token']
       end
+
+      if attributes.key?(:'order_by')
+        self.order_by = attributes[:'order_by']
+      else
+        self.order_by = 'updateTime desc'
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -102,6 +135,10 @@ module Zernio
         invalid_properties.push('invalid value for "location_names", location_names cannot be nil.')
       end
 
+      if @location_names.length > 50
+        invalid_properties.push('invalid value for "location_names", number of items must be less than or equal to 50.')
+      end
+
       if @location_names.length < 1
         invalid_properties.push('invalid value for "location_names", number of items must be greater than or equal to 1.')
       end
@@ -126,10 +163,13 @@ module Zernio
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @location_names.nil?
+      return false if @location_names.length > 50
       return false if @location_names.length < 1
       return false if !@page_size.nil? && @page_size > 50
       return false if !@page_size.nil? && @page_size < 1
       return false if !@page_token.nil? && @page_token.to_s.length < 1
+      order_by_validator = EnumAttributeValidator.new('String', ["updateTime desc", "rating", "rating desc"])
+      return false unless order_by_validator.valid?(@order_by)
       true
     end
 
@@ -140,6 +180,10 @@ module Zernio
         fail ArgumentError, 'location_names cannot be nil'
       end
 
+      if location_names.length > 50
+        fail ArgumentError, 'invalid value for "location_names", number of items must be less than or equal to 50.'
+      end
+
       if location_names.length < 1
         fail ArgumentError, 'invalid value for "location_names", number of items must be greater than or equal to 1.'
       end
@@ -179,6 +223,16 @@ module Zernio
       @page_token = page_token
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] order_by Object to be assigned
+    def order_by=(order_by)
+      validator = EnumAttributeValidator.new('String', ["updateTime desc", "rating", "rating desc"])
+      unless validator.valid?(order_by)
+        fail ArgumentError, "invalid value for \"order_by\", must be one of #{validator.allowable_values}."
+      end
+      @order_by = order_by
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -186,7 +240,8 @@ module Zernio
       self.class == o.class &&
           location_names == o.location_names &&
           page_size == o.page_size &&
-          page_token == o.page_token
+          page_token == o.page_token &&
+          order_by == o.order_by
     end
 
     # @see the `==` method
@@ -198,7 +253,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [location_names, page_size, page_token].hash
+      [location_names, page_size, page_token, order_by].hash
     end
 
     # Builds the object from hash

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

@@ -29,6 +29,18 @@ module Zernio
     # Comma-separated Graph breakdowns.
     attr_accessor :breakdowns
 
+    # Comma-separated Graph action breakdowns (e.g. action_type,action_destination).
+    attr_accessor :action_breakdowns
+
+    # Meta attribution windows (e.g. [\"7d_click\", \"1d_view\"]). Action values are returned keyed per window.
+    attr_accessor :action_attribution_windows
+
+    # When actions are counted: impression, conversion or mixed.
+    attr_accessor :action_report_time
+
+    # Use the ad sets' own attribution settings for action counting.
+    attr_accessor :use_unified_attribution_setting
+
     # Meta filter objects, applied server-side.
     attr_accessor :filtering
 
@@ -71,6 +83,10 @@ module Zernio
         :'level' => :'level',
         :'fields' => :'fields',
         :'breakdowns' => :'breakdowns',
+        :'action_breakdowns' => :'actionBreakdowns',
+        :'action_attribution_windows' => :'actionAttributionWindows',
+        :'action_report_time' => :'actionReportTime',
+        :'use_unified_attribution_setting' => :'useUnifiedAttributionSetting',
         :'filtering' => :'filtering',
         :'date_preset' => :'datePreset',
         :'from_date' => :'fromDate',
@@ -97,6 +113,10 @@ module Zernio
         :'level' => :'String',
         :'fields' => :'String',
         :'breakdowns' => :'String',
+        :'action_breakdowns' => :'String',
+        :'action_attribution_windows' => :'Array<String>',
+        :'action_report_time' => :'String',
+        :'use_unified_attribution_setting' => :'Boolean',
         :'filtering' => :'Array<CreateAdInsightsReportRequestFilteringInner>',
         :'date_preset' => :'String',
         :'from_date' => :'Date',
@@ -151,6 +171,24 @@ module Zernio
         self.breakdowns = attributes[:'breakdowns']
       end
 
+      if attributes.key?(:'action_breakdowns')
+        self.action_breakdowns = attributes[:'action_breakdowns']
+      end
+
+      if attributes.key?(:'action_attribution_windows')
+        if (value = attributes[:'action_attribution_windows']).is_a?(Array)
+          self.action_attribution_windows = value
+        end
+      end
+
+      if attributes.key?(:'action_report_time')
+        self.action_report_time = attributes[:'action_report_time']
+      end
+
+      if attributes.key?(:'use_unified_attribution_setting')
+        self.use_unified_attribution_setting = attributes[:'use_unified_attribution_setting']
+      end
+
       if attributes.key?(:'filtering')
         if (value = attributes[:'filtering']).is_a?(Array)
           self.filtering = value
@@ -241,6 +279,10 @@ module Zernio
           level == o.level &&
           fields == o.fields &&
           breakdowns == o.breakdowns &&
+          action_breakdowns == o.action_breakdowns &&
+          action_attribution_windows == o.action_attribution_windows &&
+          action_report_time == o.action_report_time &&
+          use_unified_attribution_setting == o.use_unified_attribution_setting &&
           filtering == o.filtering &&
           date_preset == o.date_preset &&
           from_date == o.from_date &&
@@ -257,7 +299,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, object_id, level, fields, breakdowns, filtering, date_preset, from_date, to_date, time_increment].hash
+      [account_id, object_id, level, fields, breakdowns, action_breakdowns, action_attribution_windows, action_report_time, use_unified_attribution_setting, filtering, date_preset, from_date, to_date, time_increment].hash
     end
 
     # Builds the object from hash