zernio-sdk 0.0.527 → 0.0.528

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 993a8b5e915ce68f01e62c2a5164906d7b7b461066671612dace526f2c5f7322
-  data.tar.gz: db65e798dbc41cdfeb336abffc6883e4c464b3045e00f287e574f070aec82bf8
+  metadata.gz: c2512b46748f0d6cfcc7050fb70e9e94abe230e6bb68d9949d75808ac1fe393e
+  data.tar.gz: 24ae76e6fb6124854c7d0f98b0577d1c79439a58a3f920a554e7d2144b431a4e
 SHA512:
-  metadata.gz: 985689b6d5b2c191463e66e6692f3aba988e0f5e5f7e01255a1f785ce3aaf3c563dea81cf0c9b40b819f30ffc08b7e4fdbc8f0470e7cbae64c1cc79a99da208d
-  data.tar.gz: 17bfcbd5e6ffd3e677c6dc2c5a5cd0731ad7b5a7fa3518cc9d7c1f5e16f3285e9593ea934e23c57cff247d7a8765a1e386e4c30efc7c2521c0f3c266f09f5dcd
+  metadata.gz: 20214a9e6724ec1127a30da6268d7b2fbb0bf25e4f6e453cec50462fbba8c80ffd2d0373e6a3834737f36dddd909e721f1f33de66c829c9bab9f11aebcd5ef79
+  data.tar.gz: ac5951dbf679d2c3ebe3aa184ad460830a6c534e50905b0f9a7141e1ff48a577b465127def86097c6359cd249d555bd832f8e3db1a24a3b0d5cf168057cc3e4b

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/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/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/list_inbox_comments200_response_data_inner.rb

@@ -23,16 +23,20 @@ module Zernio
 
     attr_accessor :account_username
 
+    # 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.
     attr_accessor :content
 
+    # Post media thumbnail. On ad rows this is the ad creative thumbnail.
     attr_accessor :picture
 
+    # 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.
     attr_accessor :permalink
 
     attr_accessor :created_time
 
     attr_accessor :comment_count
 
+    # Not fetched for ad rows (always 0 there).
     attr_accessor :like_count
 
     # Bluesky content identifier

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

@@ -15,6 +15,7 @@ require 'time'
 
 module Zernio
   class ListInboxReviews200ResponseDataInner < ApiModelBase
+    # Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location.
     attr_accessor :id
 
     attr_accessor :platform
@@ -23,6 +24,12 @@ module Zernio
 
     attr_accessor :account_username
 
+    # Bare GBP location id the review belongs to. Google Business only; absent for other platforms.
+    attr_accessor :location_id
+
+    # Human-readable GBP location display name. Google Business only; absent for other platforms.
+    attr_accessor :location_name
+
     attr_accessor :reviewer
 
     attr_accessor :rating
@@ -53,6 +60,8 @@ module Zernio
         :'platform' => :'platform',
         :'account_id' => :'accountId',
         :'account_username' => :'accountUsername',
+        :'location_id' => :'locationId',
+        :'location_name' => :'locationName',
         :'reviewer' => :'reviewer',
         :'rating' => :'rating',
         :'text' => :'text',
@@ -83,6 +92,8 @@ module Zernio
         :'platform' => :'String',
         :'account_id' => :'String',
         :'account_username' => :'String',
+        :'location_id' => :'String',
+        :'location_name' => :'String',
         :'reviewer' => :'ListInboxReviews200ResponseDataInnerReviewer',
         :'rating' => :'Integer',
         :'text' => :'String',
@@ -99,6 +110,7 @@ module Zernio
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'location_name',
         :'review_url'
       ])
     end
@@ -135,6 +147,14 @@ module Zernio
         self.account_username = attributes[:'account_username']
       end
 
+      if attributes.key?(:'location_id')
+        self.location_id = attributes[:'location_id']
+      end
+
+      if attributes.key?(:'location_name')
+        self.location_name = attributes[:'location_name']
+      end
+
       if attributes.key?(:'reviewer')
         self.reviewer = attributes[:'reviewer']
       end
@@ -202,6 +222,8 @@ module Zernio
           platform == o.platform &&
           account_id == o.account_id &&
           account_username == o.account_username &&
+          location_id == o.location_id &&
+          location_name == o.location_name &&
           reviewer == o.reviewer &&
           rating == o.rating &&
           text == o.text &&
@@ -223,7 +245,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, platform, account_id, account_username, reviewer, rating, text, created, has_reply, has_photos, photo_count, photos, reply, review_url].hash
+      [id, platform, account_id, account_username, location_id, location_name, reviewer, rating, text, created, has_reply, has_photos, photo_count, photos, reply, review_url].hash
     end
 
     # Builds the object from hash

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

@@ -26,8 +26,10 @@ module Zernio
 
     attr_accessor :is_active
 
+    # Human-readable location display name, NOT a resource name. Do not use it to build API paths.
     attr_accessor :selected_location_name
 
+    # 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.
     attr_accessor :selected_location_id
 
     class EnumAttributeValidator

data/lib/zernio-sdk/version.rb

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

data/openapi.yaml

@@ -14244,8 +14244,8 @@ paths:
                       username: { type: string }
                       displayName: { type: string }
                       isActive: { type: boolean }
-                      selectedLocationName: { type: string }
-                      selectedLocationId: { type: string }
+                      selectedLocationName: { type: string, description: 'Human-readable location display name, NOT a resource name. Do not use it to build API paths.' }
+                      selectedLocationId: { type: string, description: '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.' }
               example:
                 message: "Google Business location connected successfully"
                 redirect_url: "https://yourdomain.com/integrations/callback?connected=googlebusiness&profileId=507f1f77bcf86cd799439011&username=My+Coffee+Shop"
@@ -16083,7 +16083,12 @@ paths:
       description: |
         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.
+        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.
       parameters:
@@ -16104,8 +16109,9 @@ paths:
                 locationNames:
                   type: array
                   minItems: 1
+                  maxItems: 50
                   items: { type: string, pattern: '^accounts/[^/]+/locations/[^/]+$' }
-                  description: "Array of full location resource names (e.g. ['accounts/123/locations/456'])"
+                  description: "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."
                 pageSize:
                   type: integer
                   minimum: 1
@@ -16116,6 +16122,11 @@ paths:
                   type: string
                   minLength: 1
                   description: Pagination token from previous response
+                orderBy:
+                  type: string
+                  enum: ['updateTime desc', 'rating', 'rating desc']
+                  default: 'updateTime desc'
+                  description: "Sort order requested from Google. Defaults to 'updateTime desc' (newest first), which allows early-stopping pagination once results cross your date window."
             example:
               locationNames: ["accounts/123/locations/456", "accounts/123/locations/789"]
               pageSize: 50
@@ -16134,8 +16145,8 @@ paths:
                     items:
                       type: object
                       properties:
-                        name: { type: string, description: Full review resource name (accounts/*/locations/*/reviews/*) }
-                        review: { type: object, description: "The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)" }
+                        name: { type: string, description: '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).' }
+                        review: { type: object, description: "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)" }
                   nextPageToken: { type: string }
         '400':
           description: Invalid request
@@ -18704,8 +18715,8 @@ paths:
                       username: { type: string }
                       displayName: { type: string }
                       isActive: { type: boolean }
-                      selectedLocationName: { type: string }
-                      selectedLocationId: { type: string }
+                      selectedLocationName: { type: string, description: 'Human-readable location display name (e.g. "Snap Fitness Dianella"), NOT a resource name. Do not use it to build API paths.' }
+                      selectedLocationId: { type: string, description: '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.' }
               example:
                 message: "Google Business location assigned to profile successfully"
                 account:
@@ -18715,7 +18726,7 @@ paths:
                   displayName: "Snap Fitness Dianella"
                   isActive: true
                   selectedLocationName: "Snap Fitness Dianella"
-                  selectedLocationId: "locations/12345678901234567890"
+                  selectedLocationId: "12345678901234567890"
         '400': { description: 'Invalid body, or selected location not found under the Google account' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403': { description: 'Payment required, or target profile exceeds plan limit' }
@@ -22788,12 +22799,12 @@ paths:
                         platform: { type: string }
                         accountId: { type: string }
                         accountUsername: { type: string }
-                        content: { type: string }
-                        picture: { type: [string, "null"] }
-                        permalink: { type: [string, "null"] }
+                        content: { type: string, description: "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." }
+                        picture: { type: [string, "null"], description: 'Post media thumbnail. On ad rows this is the ad creative thumbnail.' }
+                        permalink: { type: [string, "null"], description: '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.' }
                         createdTime: { type: string, format: date-time }
                         commentCount: { type: integer }
-                        likeCount: { type: integer }
+                        likeCount: { type: integer, description: 'Not fetched for ad rows (always 0 there).' }
                         cid: { type: [string, "null"], description: Bluesky content identifier }
                         subreddit: { type: [string, "null"], description: Reddit subreddit name }
                         isAd: { type: boolean, description: "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}." }
@@ -23948,10 +23959,12 @@ paths:
                     items:
                       type: object
                       properties:
-                        id: { type: string }
+                        id: { type: string, description: 'Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location.' }
                         platform: { type: string }
                         accountId: { type: string }
                         accountUsername: { type: string }
+                        locationId: { type: string, description: 'Bare GBP location id the review belongs to. Google Business only; absent for other platforms.' }
+                        locationName: { type: [string, "null"], description: 'Human-readable GBP location display name. Google Business only; absent for other platforms.' }
                         reviewer:
                           type: object
                           properties:

data/spec/api/gmb_reviews_api_spec.rb

@@ -34,7 +34,7 @@ describe 'GMBReviewsApi' do
 
   # unit tests for batch_get_google_business_reviews
   # 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 
   # @param batch_get_google_business_reviews_request 
   # @param [Hash] opts the optional parameters

data/spec/models/batch_get_google_business_reviews_request_spec.rb

@@ -45,4 +45,14 @@ describe Zernio::BatchGetGoogleBusinessReviewsRequest do
     end
   end
 
+  describe 'test attribute "order_by"' 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', ["updateTime desc", "rating", "rating desc"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.order_by = value }.not_to raise_error
+      # end
+    end
+  end
+
 end

data/spec/models/list_inbox_reviews200_response_data_inner_spec.rb

@@ -51,6 +51,18 @@ describe Zernio::ListInboxReviews200ResponseDataInner do
     end
   end
 
+  describe 'test attribute "location_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 "location_name"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "reviewer"' 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.527
+  version: 0.0.528
 platform: ruby
 authors:
 - OpenAPI-Generator