late-sdk 0.0.954 → 0.0.955

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d478030911a4eaf3e1d62d522cdc2cfea66f726769f2d3e3245fc933a26991be
-  data.tar.gz: e709dd1af44949a0675e26229695b10ebcf8a46083353d47b198438ea17e6811
+  metadata.gz: 7d5064a8f4a62d993abf6a398bc6e5b5d3a70c9bfefbb09845f169ba21ddbf51
+  data.tar.gz: 9da5aba2d5467ebdf3aa90608bedd81698a9f9cef369aa4c6a001bcf4f3990db
 SHA512:
-  metadata.gz: af88a66eb0464dae89b7c373318e4abddd62af32d6edf92b21698039e5db8a19e8163bcdd29eebada718dde99eb8615264462c538ad15938976930a4fa845259
-  data.tar.gz: bbb5647a2df9132c8bef5db8bb8aa75a544511fd33f1a9431d4a8c50ce2adaec5739db2cf6fd545f31eb99ca1541812cc4e39901971e58bca0e67739fac1ac2e
+  metadata.gz: 557e48ff95a01ac3d531067cd54a88abb9b3be47de2b31826de639089cd99defa8f3e807c132899d0797f241c744d1ade158ee11c9718aff7985c157167f9dd3
+  data.tar.gz: c3d527e7d1d3ab6c395236b557132f44e1945fced74eef936163e5fda8184c258a3911d1ff16023816af1a82fad95b0ebafd02e4ac5242bb0cd9a6407b3f50cc

data/README.md

@@ -104,6 +104,7 @@ Class | Method | HTTP request | Description
 *Zernio::AccountsApi* | [**list_accounts**](docs/AccountsApi.md#list_accounts) | **GET** /v1/accounts | List accounts
 *Zernio::AccountsApi* | [**list_tik_tok_commercial_music**](docs/AccountsApi.md#list_tik_tok_commercial_music) | **GET** /v1/accounts/{accountId}/tiktok/commercial-music | List trending commercial music
 *Zernio::AccountsApi* | [**move_account_to_profile**](docs/AccountsApi.md#move_account_to_profile) | **PATCH** /v1/accounts/{accountId} | Move account to another profile
+*Zernio::AccountsApi* | [**search_tik_tok_locations**](docs/AccountsApi.md#search_tik_tok_locations) | **GET** /v1/accounts/{accountId}/tiktok/locations | Search TikTok location tags
 *Zernio::AccountsApi* | [**update_account**](docs/AccountsApi.md#update_account) | **PUT** /v1/accounts/{accountId} | Update account
 *Zernio::AccountsApi* | [**update_bluesky_settings**](docs/AccountsApi.md#update_bluesky_settings) | **PATCH** /v1/accounts/{accountId}/bluesky-settings | Update Bluesky account settings
 *Zernio::AccountsApi* | [**update_slack_settings**](docs/AccountsApi.md#update_slack_settings) | **PATCH** /v1/accounts/{accountId}/slack-settings | Update Slack account settings
@@ -2251,6 +2252,8 @@ Class | Method | HTTP request | Description
  - [Zernio::SearchInboxConversations200ResponseMetaFailedAccountsInner](docs/SearchInboxConversations200ResponseMetaFailedAccountsInner.md)
  - [Zernio::SearchInstagramAudio200Response](docs/SearchInstagramAudio200Response.md)
  - [Zernio::SearchReddit200Response](docs/SearchReddit200Response.md)
+ - [Zernio::SearchTikTokLocations200Response](docs/SearchTikTokLocations200Response.md)
+ - [Zernio::SearchTikTokLocations200ResponseLocationsInner](docs/SearchTikTokLocations200ResponseLocationsInner.md)
  - [Zernio::SearchTweets200Response](docs/SearchTweets200Response.md)
  - [Zernio::SearchTweets200ResponseMeta](docs/SearchTweets200ResponseMeta.md)
  - [Zernio::SearchTweets200ResponsePagination](docs/SearchTweets200ResponsePagination.md)

data/docs/AccountsApi.md

@@ -16,6 +16,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**list_accounts**](AccountsApi.md#list_accounts) | **GET** /v1/accounts | List accounts |
 | [**list_tik_tok_commercial_music**](AccountsApi.md#list_tik_tok_commercial_music) | **GET** /v1/accounts/{accountId}/tiktok/commercial-music | List trending commercial music |
 | [**move_account_to_profile**](AccountsApi.md#move_account_to_profile) | **PATCH** /v1/accounts/{accountId} | Move account to another profile |
+| [**search_tik_tok_locations**](AccountsApi.md#search_tik_tok_locations) | **GET** /v1/accounts/{accountId}/tiktok/locations | Search TikTok location tags |
 | [**update_account**](AccountsApi.md#update_account) | **PUT** /v1/accounts/{accountId} | Update account |
 | [**update_bluesky_settings**](AccountsApi.md#update_bluesky_settings) | **PATCH** /v1/accounts/{accountId}/bluesky-settings | Update Bluesky account settings |
 | [**update_slack_settings**](AccountsApi.md#update_slack_settings) | **PATCH** /v1/accounts/{accountId}/slack-settings | Update Slack account settings |
@@ -893,6 +894,77 @@ end
 - **Accept**: application/json
 
 
+## search_tik_tok_locations
+
+> <SearchTikTokLocations200Response> search_tik_tok_locations(account_id, query)
+
+Search TikTok location tags
+
+Searches the location tags a TikTok account connected through the TikTok for Business app can attach to a video post. Send a result's id and name as tiktokSettings.locationId and locationName when creating a post. TikTok answers the 20 closest matches and fills the list with fuzzy matches when nothing matches, so an unrelated result does not mean the place is missing.
+
+### 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::AccountsApi.new
+account_id = 'account_id_example' # String | The TikTok account ID
+query = 'query_example' # String | Place name to search, for example a city, a venue or an address
+
+begin
+  # Search TikTok location tags
+  result = api_instance.search_tik_tok_locations(account_id, query)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling AccountsApi->search_tik_tok_locations: #{e}"
+end
+```
+
+#### Using the search_tik_tok_locations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SearchTikTokLocations200Response>, Integer, Hash)> search_tik_tok_locations_with_http_info(account_id, query)
+
+```ruby
+begin
+  # Search TikTok location tags
+  data, status_code, headers = api_instance.search_tik_tok_locations_with_http_info(account_id, query)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SearchTikTokLocations200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling AccountsApi->search_tik_tok_locations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | The TikTok account ID |  |
+| **query** | **String** | Place name to search, for example a city, a venue or an address |  |
+
+### Return type
+
+[**SearchTikTokLocations200Response**](SearchTikTokLocations200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## update_account
 
 > <UpdateAccount200Response> update_account(account_id, update_account_request)

data/docs/SearchTikTokLocations200Response.md

@@ -0,0 +1,18 @@
+# Zernio::SearchTikTokLocations200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **locations** | [**Array<SearchTikTokLocations200ResponseLocationsInner>**](SearchTikTokLocations200ResponseLocationsInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchTikTokLocations200Response.new(
+  locations: null
+)
+```
+

data/docs/SearchTikTokLocations200ResponseLocationsInner.md

@@ -0,0 +1,22 @@
+# Zernio::SearchTikTokLocations200ResponseLocationsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | The value to send as locationId | [optional] |
+| **name** | **String** | The value to send as locationName | [optional] |
+| **address** | **String** | Address or region TikTok shows for the place, for disambiguation | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::SearchTikTokLocations200ResponseLocationsInner.new(
+  id: null,
+  name: null,
+  address: null
+)
+```
+

data/docs/TikTokPlatformData.md

@@ -22,6 +22,9 @@
 | **music_sound_info** | [**TikTokPlatformDataMusicSoundInfo**](TikTokPlatformDataMusicSoundInfo.md) |  | [optional] |
 | **video_original_sound_volume** | **Integer** | Volume of the video's own sound when a commercial track is attached (0 to 100). Requires musicSoundInfo. Video posts only. | [optional] |
 | **video_made_with_ai** | **Boolean** | Set true to disclose AI-generated content. Accounts connected through the TikTok for Business app carry the disclosure on video posts only: the business photo endpoint has no AI disclosure field, so true on a direct photo post is rejected at creation rather than published undisclosed. Send draft true to publish such a photo post and set the disclosure in the TikTok app. | [optional] |
+| **location_id** | **String** | Location tag to attach, as the id of a result from GET /v1/accounts/{accountId}/tiktok/locations. Accounts connected through the TikTok for Business app and video posts only: a developer-app account rejects the post at publish time with a message that says so, and a direct photo post is rejected at creation since the business photo endpoint has no location field. Requires locationName. Ignored on drafts, where TikTok ignores every post_info field. | [optional] |
+| **location_name** | **String** | Display name of the location tag, as returned next to its id. Required with locationId; a locationId without it is rejected at creation. | [optional] |
+| **is_ads_only** | **Boolean** | Set true to publish the video as an \"Only show in ads\" post: it is kept off the profile and exists to be used as a Spark Ad. Accounts connected through the TikTok for Business app and video posts only, with the same rejections as locationId. Ignored on drafts. | [optional] |
 | **description** | **String** | Optional long-form caption for photo posts (max 4000 chars). Recommended when content exceeds 90 chars, as photo titles are auto-truncated. Falls back to the post content when omitted. | [optional] |
 
 ## Example
@@ -48,6 +51,9 @@ instance = Zernio::TikTokPlatformData.new(
   music_sound_info: null,
   video_original_sound_volume: null,
   video_made_with_ai: null,
+  location_id: null,
+  location_name: null,
+  is_ads_only: null,
   description: null
 )
 ```

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

@@ -865,6 +865,84 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Search TikTok location tags
+    # Searches the location tags a TikTok account connected through the TikTok for Business app can attach to a video post. Send a result's id and name as tiktokSettings.locationId and locationName when creating a post. TikTok answers the 20 closest matches and fills the list with fuzzy matches when nothing matches, so an unrelated result does not mean the place is missing.
+    # @param account_id [String] The TikTok account ID
+    # @param query [String] Place name to search, for example a city, a venue or an address
+    # @param [Hash] opts the optional parameters
+    # @return [SearchTikTokLocations200Response]
+    def search_tik_tok_locations(account_id, query, opts = {})
+      data, _status_code, _headers = search_tik_tok_locations_with_http_info(account_id, query, opts)
+      data
+    end
+
+    # Search TikTok location tags
+    # Searches the location tags a TikTok account connected through the TikTok for Business app can attach to a video post. Send a result's id and name as tiktokSettings.locationId and locationName when creating a post. TikTok answers the 20 closest matches and fills the list with fuzzy matches when nothing matches, so an unrelated result does not mean the place is missing.
+    # @param account_id [String] The TikTok account ID
+    # @param query [String] Place name to search, for example a city, a venue or an address
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SearchTikTokLocations200Response, Integer, Hash)>] SearchTikTokLocations200Response data, response status code and response headers
+    def search_tik_tok_locations_with_http_info(account_id, query, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AccountsApi.search_tik_tok_locations ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling AccountsApi.search_tik_tok_locations"
+      end
+      # verify the required parameter 'query' is set
+      if @api_client.config.client_side_validation && query.nil?
+        fail ArgumentError, "Missing the required parameter 'query' when calling AccountsApi.search_tik_tok_locations"
+      end
+      if @api_client.config.client_side_validation && query.to_s.length > 100
+        fail ArgumentError, 'invalid value for "query" when calling AccountsApi.search_tik_tok_locations, the character length must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && query.to_s.length < 1
+        fail ArgumentError, 'invalid value for "query" when calling AccountsApi.search_tik_tok_locations, the character length must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/tiktok/locations'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'query'] = query
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SearchTikTokLocations200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AccountsApi.search_tik_tok_locations",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AccountsApi#search_tik_tok_locations\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update account
     # Updates a connected account's display name or username override.  For X accounts on usage-based billing, also accepts an `xCapabilities` object to toggle background API operations that incur X API pass-through costs. Both fields are opt-in (default `false`). When off, no analytics syncs or DM polling are performed for that account, and no API call is metered for those operations. Publishing and deleting posts are always available regardless of these toggles. Setting `xCapabilities` on a non-X account returns 400. 
     # @param account_id [String] 

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

@@ -0,0 +1,149 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class SearchTikTokLocations200Response < ApiModelBase
+    attr_accessor :locations
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'locations' => :'locations'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'locations' => :'Array<SearchTikTokLocations200ResponseLocationsInner>'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SearchTikTokLocations200Response` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SearchTikTokLocations200Response`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'locations')
+        if (value = attributes[:'locations']).is_a?(Array)
+          self.locations = value
+        end
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          locations == o.locations
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [locations].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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

@@ -0,0 +1,168 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class SearchTikTokLocations200ResponseLocationsInner < ApiModelBase
+    # The value to send as locationId
+    attr_accessor :id
+
+    # The value to send as locationName
+    attr_accessor :name
+
+    # Address or region TikTok shows for the place, for disambiguation
+    attr_accessor :address
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'id' => :'id',
+        :'name' => :'name',
+        :'address' => :'address'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'id' => :'String',
+        :'name' => :'String',
+        :'address' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SearchTikTokLocations200ResponseLocationsInner` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SearchTikTokLocations200ResponseLocationsInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      end
+
+      if attributes.key?(:'address')
+        self.address = attributes[:'address']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          id == o.id &&
+          name == o.name &&
+          address == o.address
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [id, name, address].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

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

@@ -69,6 +69,15 @@ module Zernio
     # Set true to disclose AI-generated content. Accounts connected through the TikTok for Business app carry the disclosure on video posts only: the business photo endpoint has no AI disclosure field, so true on a direct photo post is rejected at creation rather than published undisclosed. Send draft true to publish such a photo post and set the disclosure in the TikTok app.
     attr_accessor :video_made_with_ai
 
+    # Location tag to attach, as the id of a result from GET /v1/accounts/{accountId}/tiktok/locations. Accounts connected through the TikTok for Business app and video posts only: a developer-app account rejects the post at publish time with a message that says so, and a direct photo post is rejected at creation since the business photo endpoint has no location field. Requires locationName. Ignored on drafts, where TikTok ignores every post_info field.
+    attr_accessor :location_id
+
+    # Display name of the location tag, as returned next to its id. Required with locationId; a locationId without it is rejected at creation.
+    attr_accessor :location_name
+
+    # Set true to publish the video as an \"Only show in ads\" post: it is kept off the profile and exists to be used as a Spark Ad. Accounts connected through the TikTok for Business app and video posts only, with the same rejections as locationId. Ignored on drafts.
+    attr_accessor :is_ads_only
+
     # Optional long-form caption for photo posts (max 4000 chars). Recommended when content exceeds 90 chars, as photo titles are auto-truncated. Falls back to the post content when omitted.
     attr_accessor :description
 
@@ -115,6 +124,9 @@ module Zernio
         :'music_sound_info' => :'musicSoundInfo',
         :'video_original_sound_volume' => :'videoOriginalSoundVolume',
         :'video_made_with_ai' => :'videoMadeWithAi',
+        :'location_id' => :'locationId',
+        :'location_name' => :'locationName',
+        :'is_ads_only' => :'isAdsOnly',
         :'description' => :'description'
       }
     end
@@ -150,6 +162,9 @@ module Zernio
         :'music_sound_info' => :'TikTokPlatformDataMusicSoundInfo',
         :'video_original_sound_volume' => :'Integer',
         :'video_made_with_ai' => :'Boolean',
+        :'location_id' => :'String',
+        :'location_name' => :'String',
+        :'is_ads_only' => :'Boolean',
         :'description' => :'String'
       }
     end
@@ -248,6 +263,18 @@ module Zernio
         self.video_made_with_ai = attributes[:'video_made_with_ai']
       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?(:'is_ads_only')
+        self.is_ads_only = attributes[:'is_ads_only']
+      end
+
       if attributes.key?(:'description')
         self.description = attributes[:'description']
       end
@@ -400,6 +427,9 @@ module Zernio
           music_sound_info == o.music_sound_info &&
           video_original_sound_volume == o.video_original_sound_volume &&
           video_made_with_ai == o.video_made_with_ai &&
+          location_id == o.location_id &&
+          location_name == o.location_name &&
+          is_ads_only == o.is_ads_only &&
           description == o.description
     end
 
@@ -412,7 +442,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [draft, privacy_level, allow_comment, allow_duet, allow_stitch, commercial_content_type, brand_partner_promote, is_brand_organic_post, content_preview_confirmed, express_consent_given, media_type, video_cover_timestamp_ms, video_cover_image_url, photo_cover_index, auto_add_music, music_sound_info, video_original_sound_volume, video_made_with_ai, description].hash
+      [draft, privacy_level, allow_comment, allow_duet, allow_stitch, commercial_content_type, brand_partner_promote, is_brand_organic_post, content_preview_confirmed, express_consent_given, media_type, video_cover_timestamp_ms, video_cover_image_url, photo_cover_index, auto_add_music, music_sound_info, video_original_sound_volume, video_made_with_ai, location_id, location_name, is_ads_only, description].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

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

data/lib/zernio-sdk.rb

@@ -1463,6 +1463,8 @@ require 'zernio-sdk/models/search_inbox_conversations200_response_meta'
 require 'zernio-sdk/models/search_inbox_conversations200_response_meta_failed_accounts_inner'
 require 'zernio-sdk/models/search_instagram_audio200_response'
 require 'zernio-sdk/models/search_reddit200_response'
+require 'zernio-sdk/models/search_tik_tok_locations200_response'
+require 'zernio-sdk/models/search_tik_tok_locations200_response_locations_inner'
 require 'zernio-sdk/models/search_tweets200_response'
 require 'zernio-sdk/models/search_tweets200_response_meta'
 require 'zernio-sdk/models/search_tweets200_response_pagination'

data/openapi.yaml

@@ -6993,6 +6993,15 @@ components:
         videoMadeWithAi:
           type: boolean
           description: 'Set true to disclose AI-generated content. Accounts connected through the TikTok for Business app carry the disclosure on video posts only: the business photo endpoint has no AI disclosure field, so true on a direct photo post is rejected at creation rather than published undisclosed. Send draft true to publish such a photo post and set the disclosure in the TikTok app.'
+        locationId:
+          type: string
+          description: 'Location tag to attach, as the id of a result from GET /v1/accounts/{accountId}/tiktok/locations. Accounts connected through the TikTok for Business app and video posts only: a developer-app account rejects the post at publish time with a message that says so, and a direct photo post is rejected at creation since the business photo endpoint has no location field. Requires locationName. Ignored on drafts, where TikTok ignores every post_info field.'
+        locationName:
+          type: string
+          description: 'Display name of the location tag, as returned next to its id. Required with locationId; a locationId without it is rejected at creation.'
+        isAdsOnly:
+          type: boolean
+          description: 'Set true to publish the video as an "Only show in ads" post: it is kept off the profile and exists to be used as a Spark Ad. Accounts connected through the TikTok for Business app and video posts only, with the same rejections as locationId. Ignored on drafts.'
         description:
           type: string
           maxLength: 4000
@@ -19230,6 +19239,45 @@ paths:
         '404':
           description: Account not found
 
+  /v1/accounts/{accountId}/tiktok/locations:
+    get:
+      x-resource-group: "accounts"
+      operationId: searchTikTokLocations
+      tags: [Accounts]
+      summary: Search TikTok location tags
+      description: 'Searches the location tags a TikTok account connected through the TikTok for Business app can attach to a video post. Send a result''s id and name as tiktokSettings.locationId and locationName when creating a post. TikTok answers the 20 closest matches and fills the list with fuzzy matches when nothing matches, so an unrelated result does not mean the place is missing.'
+      parameters:
+        - name: accountId
+          in: path
+          required: true
+          schema: { type: string }
+          description: The TikTok account ID
+        - name: query
+          in: query
+          required: true
+          schema: { type: string, minLength: 1, maxLength: 100 }
+          description: 'Place name to search, for example a city, a venue or an address'
+      responses:
+        '200':
+          description: The closest location tags, best match first
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  locations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id: { type: string, description: 'The value to send as locationId' }
+                        name: { type: string, description: 'The value to send as locationName' }
+                        address: { type: string, description: 'Address or region TikTok shows for the place, for disambiguation' }
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          description: Account not found
+
   /v1/accounts/{accountId}/tiktok/creator-info:
     get:
       x-resource-group: "accounts"

data/spec/api/accounts_api_spec.rb

@@ -192,6 +192,19 @@ describe 'AccountsApi' do
     end
   end
 
+  # unit tests for search_tik_tok_locations
+  # Search TikTok location tags
+  # Searches the location tags a TikTok account connected through the TikTok for Business app can attach to a video post. Send a result's id and name as tiktokSettings.locationId and locationName when creating a post. TikTok answers the 20 closest matches and fills the list with fuzzy matches when nothing matches, so an unrelated result does not mean the place is missing.
+  # @param account_id The TikTok account ID
+  # @param query Place name to search, for example a city, a venue or an address
+  # @param [Hash] opts the optional parameters
+  # @return [SearchTikTokLocations200Response]
+  describe 'search_tik_tok_locations test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for update_account
   # Update account
   # Updates a connected account's display name or username override.  For X accounts on usage-based billing, also accepts an `xCapabilities` object to toggle background API operations that incur X API pass-through costs. Both fields are opt-in (default `false`). When off, no analytics syncs or DM polling are performed for that account, and no API call is metered for those operations. Publishing and deleting posts are always available regardless of these toggles. Setting `xCapabilities` on a non-X account returns 400. 

data/spec/models/search_tik_tok_locations200_response_locations_inner_spec.rb

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

data/spec/models/search_tik_tok_locations200_response_spec.rb

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

data/spec/models/tik_tok_platform_data_spec.rb

@@ -143,6 +143,24 @@ describe Zernio::TikTokPlatformData 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 "is_ads_only"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "description"' 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: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.954
+  version: 0.0.955
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -1563,6 +1563,8 @@ files:
 - docs/SearchInboxConversations200ResponseMetaFailedAccountsInner.md
 - docs/SearchInstagramAudio200Response.md
 - docs/SearchReddit200Response.md
+- docs/SearchTikTokLocations200Response.md
+- docs/SearchTikTokLocations200ResponseLocationsInner.md
 - docs/SearchTweets200Response.md
 - docs/SearchTweets200ResponseMeta.md
 - docs/SearchTweets200ResponsePagination.md
@@ -3722,6 +3724,8 @@ files:
 - lib/zernio-sdk/models/search_inbox_conversations200_response_meta_failed_accounts_inner.rb
 - lib/zernio-sdk/models/search_instagram_audio200_response.rb
 - lib/zernio-sdk/models/search_reddit200_response.rb
+- lib/zernio-sdk/models/search_tik_tok_locations200_response.rb
+- lib/zernio-sdk/models/search_tik_tok_locations200_response_locations_inner.rb
 - lib/zernio-sdk/models/search_tweets200_response.rb
 - lib/zernio-sdk/models/search_tweets200_response_meta.rb
 - lib/zernio-sdk/models/search_tweets200_response_pagination.rb
@@ -5856,6 +5860,8 @@ files:
 - spec/models/search_inbox_conversations200_response_spec.rb
 - spec/models/search_instagram_audio200_response_spec.rb
 - spec/models/search_reddit200_response_spec.rb
+- spec/models/search_tik_tok_locations200_response_locations_inner_spec.rb
+- spec/models/search_tik_tok_locations200_response_spec.rb
 - spec/models/search_tweets200_response_meta_spec.rb
 - spec/models/search_tweets200_response_pagination_spec.rb
 - spec/models/search_tweets200_response_spec.rb
@@ -6475,7 +6481,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.954.gem
+- zernio-sdk-0.0.955.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses:
@@ -7462,6 +7468,7 @@ test_files:
 - spec/models/restore_workflow_version200_response_spec.rb
 - spec/models/list_phone_numbers200_response_sandbox_template_spec.rb
 - spec/models/get_conversions_quality200_response_rows_inner_match_keys_inner_spec.rb
+- spec/models/search_tik_tok_locations200_response_spec.rb
 - spec/models/ad_daily_metrics_spec.rb
 - spec/models/edit_inbox_comment200_response_spec.rb
 - spec/models/validate_subreddit200_response_spec.rb
@@ -7885,6 +7892,7 @@ test_files:
 - spec/models/send_conversions_request_spec.rb
 - spec/models/webhook_payload_account_ads_initial_sync_completed_spec.rb
 - spec/models/assign_google_business_location200_response_account_spec.rb
+- spec/models/search_tik_tok_locations200_response_locations_inner_spec.rb
 - spec/models/create_invite_token201_response_spec.rb
 - spec/models/list_value_rule_sets200_response_paging_spec.rb
 - spec/models/update_whats_app_template_request_spec.rb