late-sdk 0.0.956 → 0.0.957

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 878f4e2a33ff293dff439f1c716d14da313c8b8203915429b7649c4ed82f22ef
-  data.tar.gz: 40fccb2f5d21e8fa69f195b4332da3efe890a5f5657c01be9849646bee3adbf5
+  metadata.gz: 494a9a210a70196a61241eaf20b25a3ee2bab55283f282d82ea1fc1ac944f7cc
+  data.tar.gz: 9f58a6c39fa59b5981135b3e6125bbcf06513ca83533b13e6b0f8cd1e34fb32d
 SHA512:
-  metadata.gz: 8bffc95bdd5bb99c6e355a48edc57ecd25efbd8a504b41b1e518b2c5553af136543c9dfbdd74ddf6e7cbbb2e9ed5c8f26ab2135b717d941255da4cfdcb7ab08a
-  data.tar.gz: 5423ec15a7ea896cb17d30138c4bf9cbf4657243bc3bd84f69d110f6144eb9bf70750e422332a0290db2d32bea1d85ee585a856c5c7079911b3ca977b98cb76a
+  metadata.gz: 057d2ebfb19915ae484cdbb65b59c46f30eefa4e90f3815bdbec483291046d9847ac3a659f208552bbcc00f7f86b3ece8066299218f81c564e361f84dd1f4ece
+  data.tar.gz: fd730c249a2c6122f99b489165b308eb572c31488ed9c1c12e6c39d9240bf71167f7fcce097e34a7288c0e82d5cfcd8df10efe1d9f43af13f74492cdb5bd834e

data/README.md

@@ -1335,6 +1335,7 @@ Class | Method | HTTP request | Description
  - [Zernio::EnrollContacts200ResponseResultsInner](docs/EnrollContacts200ResponseResultsInner.md)
  - [Zernio::EnrollContactsRequest](docs/EnrollContactsRequest.md)
  - [Zernio::ErrorResponse](docs/ErrorResponse.md)
+ - [Zernio::ErrorResponseDetails](docs/ErrorResponseDetails.md)
  - [Zernio::EstimateAdReach200Response](docs/EstimateAdReach200Response.md)
  - [Zernio::EstimateAdReachRequest](docs/EstimateAdReachRequest.md)
  - [Zernio::Expired](docs/Expired.md)

data/docs/ErrorResponse.md

@@ -10,7 +10,7 @@
 | **param** | **String** | The request field that caused the error, when applicable. | [optional] |
 | **platform** | **String** | Upstream platform (e.g. meta, google, tiktok), present when type is platform_error. | [optional] |
 | **platform_error** | **Hash<String, Object>** | Raw error payload from the upstream platform, passed through verbatim so integrators can read provider-specific codes. For Meta this includes error_subcode, error_user_title, and error_user_msg.  | [optional] |
-| **details** | **Hash<String, Object>** | Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent. | [optional] |
+| **details** | [**ErrorResponseDetails**](ErrorResponseDetails.md) |  | [optional] |
 
 ## Example
 

data/docs/ErrorResponseDetails.md

@@ -0,0 +1,20 @@
+# Zernio::ErrorResponseDetails
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **quota_exhausted** | **Boolean** | Google Ads 429 only. True when the upstream Google Ads quota is spent rather than a Zernio limit. | [optional] |
+| **quota_scope** | **String** | Google Ads 429 only, when Google names the scope. DEVELOPER is the shared developer-token budget; ACCOUNT is your ad account. | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::ErrorResponseDetails.new(
+  quota_exhausted: null,
+  quota_scope: null
+)
+```
+

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

@@ -34,7 +34,6 @@ module Zernio
     # Raw error payload from the upstream platform, passed through verbatim so integrators can read provider-specific codes. For Meta this includes error_subcode, error_user_title, and error_user_msg. 
     attr_accessor :platform_error
 
-    # Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent.
     attr_accessor :details
 
     class EnumAttributeValidator
@@ -91,7 +90,7 @@ module Zernio
         :'param' => :'String',
         :'platform' => :'String',
         :'platform_error' => :'Hash<String, Object>',
-        :'details' => :'Hash<String, Object>'
+        :'details' => :'ErrorResponseDetails'
       }
     end
 
@@ -144,9 +143,7 @@ module Zernio
       end
 
       if attributes.key?(:'details')
-        if (value = attributes[:'details']).is_a?(Hash)
-          self.details = value
-        end
+        self.details = attributes[:'details']
       end
     end
 

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

@@ -0,0 +1,193 @@
+=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
+  # Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent.  On a Google Ads 429 it carries `quotaExhausted: true`, which marks the failure as Google's own ads quota rather than a Zernio rate limit, so you can keep calling other platforms instead of backing off everywhere. When Google names the scope it also carries `quotaScope`: `DEVELOPER` means the shared developer-token budget (every Google account is affected and there is nothing to change on your side), `ACCOUNT` means your own ad account. A Meta 429 carries neither field. 
+  class ErrorResponseDetails < ApiModelBase
+    # Google Ads 429 only. True when the upstream Google Ads quota is spent rather than a Zernio limit.
+    attr_accessor :quota_exhausted
+
+    # Google Ads 429 only, when Google names the scope. DEVELOPER is the shared developer-token budget; ACCOUNT is your ad account.
+    attr_accessor :quota_scope
+
+    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
+      {
+        :'quota_exhausted' => :'quotaExhausted',
+        :'quota_scope' => :'quotaScope'
+      }
+    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
+      {
+        :'quota_exhausted' => :'Boolean',
+        :'quota_scope' => :'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::ErrorResponseDetails` 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::ErrorResponseDetails`. 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?(:'quota_exhausted')
+        self.quota_exhausted = attributes[:'quota_exhausted']
+      end
+
+      if attributes.key?(:'quota_scope')
+        self.quota_scope = attributes[:'quota_scope']
+      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'
+      quota_scope_validator = EnumAttributeValidator.new('String', ["DEVELOPER", "ACCOUNT"])
+      return false unless quota_scope_validator.valid?(@quota_scope)
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] quota_scope Object to be assigned
+    def quota_scope=(quota_scope)
+      validator = EnumAttributeValidator.new('String', ["DEVELOPER", "ACCOUNT"])
+      unless validator.valid?(quota_scope)
+        fail ArgumentError, "invalid value for \"quota_scope\", must be one of #{validator.allowable_values}."
+      end
+      @quota_scope = quota_scope
+    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 &&
+          quota_exhausted == o.quota_exhausted &&
+          quota_scope == o.quota_scope
+    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
+      [quota_exhausted, quota_scope].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/version.rb

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

data/lib/zernio-sdk.rb

@@ -546,6 +546,7 @@ require 'zernio-sdk/models/enroll_contacts200_response'
 require 'zernio-sdk/models/enroll_contacts200_response_results_inner'
 require 'zernio-sdk/models/enroll_contacts_request'
 require 'zernio-sdk/models/error_response'
+require 'zernio-sdk/models/error_response_details'
 require 'zernio-sdk/models/estimate_ad_reach200_response'
 require 'zernio-sdk/models/estimate_ad_reach_request'
 require 'zernio-sdk/models/expired'

data/openapi.yaml

@@ -1833,10 +1833,25 @@ components:
         details:
           type: object
           additionalProperties: true
-          description: >-
+          description: |
             Additional structured context (e.g. field-level validation errors), for example
             `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's
             single reply is already spent.
+
+            On a Google Ads 429 it carries `quotaExhausted: true`, which marks the failure as
+            Google's own ads quota rather than a Zernio rate limit, so you can keep calling
+            other platforms instead of backing off everywhere. When Google names the scope it
+            also carries `quotaScope`: `DEVELOPER` means the shared developer-token budget
+            (every Google account is affected and there is nothing to change on your side),
+            `ACCOUNT` means your own ad account. A Meta 429 carries neither field.
+          properties:
+            quotaExhausted:
+              type: boolean
+              description: 'Google Ads 429 only. True when the upstream Google Ads quota is spent rather than a Zernio limit.'
+            quotaScope:
+              type: string
+              enum: [DEVELOPER, ACCOUNT]
+              description: 'Google Ads 429 only, when Google names the scope. DEVELOPER is the shared developer-token budget; ACCOUNT is your ad account.'
     CommentAutomationAudience:
       type: object
       description: |

data/spec/models/error_response_details_spec.rb

@@ -0,0 +1,46 @@
+=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::ErrorResponseDetails
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe Zernio::ErrorResponseDetails do
+  #let(:instance) { Zernio::ErrorResponseDetails.new }
+
+  describe 'test an instance of ErrorResponseDetails' do
+    it 'should create an instance of ErrorResponseDetails' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(Zernio::ErrorResponseDetails)
+    end
+  end
+
+  describe 'test attribute "quota_exhausted"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "quota_scope"' 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', ["DEVELOPER", "ACCOUNT"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.quota_scope = value }.not_to raise_error
+      # end
+    end
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.956
+  version: 0.0.957
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -620,6 +620,7 @@ files:
 - docs/EnrollContacts200ResponseResultsInner.md
 - docs/EnrollContactsRequest.md
 - docs/ErrorResponse.md
+- docs/ErrorResponseDetails.md
 - docs/EstimateAdReach200Response.md
 - docs/EstimateAdReachRequest.md
 - docs/Expired.md
@@ -2807,6 +2808,7 @@ files:
 - lib/zernio-sdk/models/enroll_contacts200_response_results_inner.rb
 - lib/zernio-sdk/models/enroll_contacts_request.rb
 - lib/zernio-sdk/models/error_response.rb
+- lib/zernio-sdk/models/error_response_details.rb
 - lib/zernio-sdk/models/estimate_ad_reach200_response.rb
 - lib/zernio-sdk/models/estimate_ad_reach_request.rb
 - lib/zernio-sdk/models/expired.rb
@@ -4942,6 +4944,7 @@ files:
 - spec/models/enroll_contacts200_response_results_inner_spec.rb
 - spec/models/enroll_contacts200_response_spec.rb
 - spec/models/enroll_contacts_request_spec.rb
+- spec/models/error_response_details_spec.rb
 - spec/models/error_response_spec.rb
 - spec/models/estimate_ad_reach200_response_spec.rb
 - spec/models/estimate_ad_reach_request_spec.rb
@@ -6481,7 +6484,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.956.gem
+- zernio-sdk-0.0.957.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses:
@@ -8148,6 +8151,7 @@ test_files:
 - spec/models/get_inbox_top_accounts200_response_spec.rb
 - spec/models/list_business_agent_websites200_response_spec.rb
 - spec/models/update_google_business_place_action_request_spec.rb
+- spec/models/error_response_details_spec.rb
 - spec/models/create_account_group_request_spec.rb
 - spec/models/social_account_spec.rb
 - spec/models/get_daily_metrics200_response_daily_data_inner_metrics_spec.rb