snapchat_api 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f835d1d5764f58f10ea61e25aa7bec86ba1ff18670ec3e62461968385d3e0c08
-  data.tar.gz: edc4635f63d1811a567a8e382c395b54fb5bc19d9a3e05344c4ed2a15bcad10b
+  metadata.gz: 3d2fddf9efbe9f9729c3684370ed34e34c3eb2e7bcb852c31fd20f8704bce3e4
+  data.tar.gz: 5239d2a84ec3bf82425ec3ec6c3dc1a90a0885c65200a72e020cec2e9217a64d
 SHA512:
-  metadata.gz: a50dcef0a90a743017da6405e26fbc4f46b551d50e7012aed4ecd7c40efe5eefcd77ee0c31193ade4d8aaab1921d753051589a68891def9a6bbc7c6a986a042d
-  data.tar.gz: b7d88ee3f394e8d0e869b7a28691fe94a2fe92414147fde541e2a1a100a02bdc6475b2f0d13804c77a34562337542d3b2c80cd337e118a910204c0c79670e82e
+  metadata.gz: 358a31a8b86397994b76f6c0fafd80a874a48a589f5482ece61bcd185c3547887cfa039dc9e5ce536b22b2f34813823ded87b0eddd35e4250417b1ab57dfdccc
+  data.tar.gz: 42afb3def8554e05bbf827096756db9a86146a2762d56c6e2a9535a81d1871f8d0c24947b812e463dd610bb4ed4b14b1e8ad5bea6006322f1ceda1d694f89532

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.1.7](https://github.com/k0va1/snapchat_api/compare/v0.1.6...v0.1.7) (2026-01-13)
+
+
+### Features
+
+* add new endpoint for filtering ad squads by campaign ([#11](https://github.com/k0va1/snapchat_api/issues/11)) ([06a1aa3](https://github.com/k0va1/snapchat_api/commit/06a1aa389f69e7757760c26bb17d8a80cf588328))
+
+## [0.1.6](https://github.com/k0va1/snapchat_api/compare/v0.1.5...v0.1.6) (2025-12-30)
+
+
+### Features
+
+* add error handling for API responses with request_status ERROR ([554d4c5](https://github.com/k0va1/snapchat_api/commit/554d4c5f8ec3545f632110875cd436de84faaac2))
+* add error handling for API responses with request_status ERROR ([6ebe619](https://github.com/k0va1/snapchat_api/commit/6ebe6190b4283678dbec9104dee051ccc25bd80f))
+
 ## [0.1.5](https://github.com/k0va1/snapchat_api/compare/v0.1.4...v0.1.5) (2025-08-25)
 
 

data/lib/snapchat_api/client.rb

@@ -135,10 +135,17 @@ module SnapchatApi
     private
 
     def handle_response(response)
+      body = response.body
+      status = response.status
+
+      # Check for request-level errors (API returns 200 but request_status is ERROR)
+      if response.success? && body.is_a?(Hash)
+        check_request_status_error(body, status)
+        return response
+      end
+
       return response if response.success?
 
-      status = response.status
-      body = response.body
       error_message = body.is_a?(Hash) ? body&.dig("message") : body
 
       klass = case status
@@ -158,5 +165,47 @@ module SnapchatApi
 
       raise klass.new(error_message || "HTTP #{status}", status, body)
     end
+
+    def check_request_status_error(body, status)
+      return unless body["request_status"] == "ERROR"
+
+      request_id = body["request_id"]
+      sub_errors = extract_sub_errors(body)
+      error_message = build_error_message(body, sub_errors)
+
+      raise SnapchatApi::RequestError.new(error_message, status, body, request_id, sub_errors)
+    end
+
+    def extract_sub_errors(body)
+      sub_errors = []
+
+      # Look for sub-request errors in various response keys
+      # The API may return errors under different keys depending on the endpoint
+      possible_keys = %w[creatives ads campaigns ad_squads media adaccounts]
+
+      possible_keys.each do |key|
+        next unless body[key].is_a?(Array)
+
+        body[key].each do |item|
+          if item.is_a?(Hash) && item["sub_request_status"] == "ERROR"
+            sub_errors << {
+              reason: item["sub_request_error_reason"],
+              status: item["sub_request_status"]
+            }
+          end
+        end
+      end
+
+      sub_errors
+    end
+
+    def build_error_message(body, sub_errors)
+      if sub_errors.any?
+        messages = sub_errors.map { |e| e[:reason] }.compact
+        messages.join("; ")
+      else
+        body["debug_message"] || body["display_message"] || "Request failed with status ERROR"
+      end
+    end
   end
 end

data/lib/snapchat_api/error.rb

@@ -2,10 +2,12 @@ module SnapchatApi
   class Error < StandardError
     attr_reader :status_code
     attr_reader :body
+    attr_reader :request_id
 
-    def initialize(message = nil, status_code = nil, body = nil)
+    def initialize(message = nil, status_code = nil, body = nil, request_id = nil)
       @status_code = status_code
       @body = body
+      @request_id = request_id
       super(message)
     end
   end
@@ -19,4 +21,14 @@ module SnapchatApi
   class ApiError < Error; end
 
   class RateLimitError < Error; end
+
+  # Raised when API returns HTTP 200 but request_status is ERROR
+  class RequestError < Error
+    attr_reader :sub_errors
+
+    def initialize(message = nil, status_code = nil, body = nil, request_id = nil, sub_errors = [])
+      @sub_errors = sub_errors
+      super(message, status_code, body, request_id)
+    end
+  end
 end

data/lib/snapchat_api/resources/ad_squad.rb

@@ -1,20 +1,14 @@
+require "uri"
+
 module SnapchatApi
   module Resources
     class AdSquad < Base
       def list_all(ad_account_id:, params: {})
-        params[:limit] ||= 50
-
-        ad_squads = []
-        next_link = "adaccounts/#{ad_account_id}/adsquads?limit=#{params[:limit]}"
-
-        loop do
-          response = client.request(:get, next_link)
-          next_link = response.body["paging"]["next_link"]
-          ad_squads.concat(response.body["adsquads"].map { |el| el["adsquad"] })
-          break if next_link.nil?
-        end
+        fetch_all_adsquads("adaccounts/#{ad_account_id}/adsquads", params)
+      end
 
-        ad_squads
+      def list_all_by_campaign(campaign_id:, params: {})
+        fetch_all_adsquads("campaigns/#{campaign_id}/adsquads", params)
       end
 
       def get(ad_squad_id:)
@@ -49,6 +43,23 @@ module SnapchatApi
         response = client.request(:get, "adsquads/#{ad_squad_id}/stats", params)
         response.body
       end
+
+      private
+
+      def fetch_all_adsquads(base_path, params)
+        params[:limit] ||= 50
+        ad_squads = []
+        next_link = "#{base_path}?#{URI.encode_www_form(params)}"
+
+        loop do
+          response = client.request(:get, next_link)
+          next_link = response.body["paging"]["next_link"]
+          ad_squads.concat(response.body["adsquads"].map { |el| el["adsquad"] })
+          break if next_link.nil?
+        end
+
+        ad_squads
+      end
     end
   end
 end

data/lib/snapchat_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SnapchatApi
-  VERSION = "0.1.5"
+  VERSION = "0.1.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: snapchat_api
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - Alex Koval