snapchat_api 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 43c8269298615c2858d5ddcdc32484970aa6ba2a6fe1df256d8cb309e04ba16e
+  data.tar.gz: f0131210e97ae51caaddf6c042b3575eb88d5c08e9c075e0b770b0cef0c6c144
+SHA512:
+  metadata.gz: 3db8ca2e98368796ea19ca8554e538aaa47d3b827d78b66bad841b74d1bbafdba30c1574d3bd51a3b317936a790f37685fd270f6d40af378795d412438e286f9
+  data.tar.gz: 976a5ffd1d911639c0859db349dc4aadcc239dc230921fd0145bfaa2e545f0e4652d739f519f6d2e2ad332dbf73a633d273fecddc744f304cdb66c5a824a3247

data/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## [0.1.4](https://github.com/k0va1/snapchat_api/compare/v0.1.3...v0.1.4) (2025-07-29)
+
+
+### Bug Fixes
+
+* rename license file ([5b1ab3e](https://github.com/k0va1/snapchat_api/commit/5b1ab3eef2d934c67a1c3895070c13303a9ef802))
+
+## [0.1.3](https://github.com/k0va1/snapchat_api/compare/v0.1.2...v0.1.3) (2025-07-29)
+
+
+### Bug Fixes
+
+* add MIT licence ([5f054ea](https://github.com/k0va1/snapchat_api/commit/5f054eadb61351fa960f4b2d7568b59c2ef5706a))
+
+## [0.1.2](https://github.com/k0va1/snapchat_api/compare/v0.1.1...v0.1.2) (2025-07-29)
+
+
+### Bug Fixes
+
+* changelog styling ([361d93c](https://github.com/k0va1/snapchat_api/commit/361d93c8886ed017f8910aa7773264a9cd91383a))
+
+## [0.1.1](https://github.com/k0va1/snapchat_api/compare/v0.1.0...v0.1.1) (2025-07-29)
+
+
+### Features
+
+* add Ad Squads ([717ba38](https://github.com/k0va1/snapchat_api/commit/717ba38c91e7dcd21677e0269891677e80a23e02))
+* add media support ([3433e6f](https://github.com/k0va1/snapchat_api/commit/3433e6f248a7c5a535fb99ba083d14b0f98bb75e))
+* campaigns & specs ([cb6aab5](https://github.com/k0va1/snapchat_api/commit/cb6aab52d01aaab4e2f8390749d0356288c1384f))

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Alex Koval
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,289 @@
+# SnapchatApi
+
+A Ruby gem that provides a comprehensive wrapper for the Snapchat Ads API, supporting OAuth2 authentication and full CRUD operations for campaigns, ad squads, ads, creatives, and media.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'snapchat_api'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install snapchat_api
+
+## Usage
+
+### Creating a Client
+
+```ruby
+require 'snapchat_api'
+
+client = SnapchatApi::Client.new(
+  client_id: "your-client-id",
+  client_secret: "your-client-secret",
+  redirect_uri: "your-redirect-uri",
+  access_token: "your-access-token",
+  refresh_token: "your-refresh-token",
+  debug: false # Optional: enable debug logging
+)
+```
+
+### OAuth2 Authentication
+
+```ruby
+# Get authorization URL
+auth_url = client.get_authorization_url(scope: "snapchat-marketing-api")
+# => "https://accounts.snapchat.com/accounts/oauth2/auth?client_id=your-client-id&redirect_uri=your-redirect-uri&response_type=code&scope=snapchat-marketing-api"
+
+# Exchange authorization code for tokens
+tokens = client.get_tokens(code: "your-authorization-code")
+# => {"access_token" => "...", "refresh_token" => "...", "expires_in" => 3600}
+
+# Refresh access tokens
+client.refresh_tokens!
+```
+
+## API Resources
+
+### Accounts (`SnapchatApi::Resources::Account`)
+
+Manage ad accounts within organizations.
+
+```ruby
+# List all ad accounts for an organization
+accounts = client.accounts.list_all(organization_id: "org-id", params: {limit: 50})
+```
+
+### Campaigns (`SnapchatApi::Resources::Campaign`)
+
+Full CRUD operations for campaigns.
+
+```ruby
+# List all campaigns for an ad account
+campaigns = client.campaigns.list_all(ad_account_id: "account-id", params: {limit: 50})
+
+# Get a specific campaign
+campaign = client.campaigns.get(ad_account_id: "account-id", campaign_id: "campaign-id")
+
+# Create a new campaign
+new_campaign = client.campaigns.create(
+  ad_account_id: "account-id",
+  params: {
+    name: "My Campaign",
+    status: "ACTIVE",
+    objective: "AWARENESS"
+  }
+)
+
+# Update a campaign
+updated_campaign = client.campaigns.update(
+  ad_account_id: "account-id",
+  campaign_id: "campaign-id",
+  params: {name: "Updated Campaign Name"}
+)
+
+# Delete a campaign
+client.campaigns.delete(campaign_id: "campaign-id")
+
+# Get campaign statistics
+stats = client.campaigns.get_stats(campaign_id: "campaign-id", params: {granularity: "DAY"})
+```
+
+### Ad Squads (`SnapchatApi::Resources::AdSquad`)
+
+Manage ad squads within campaigns.
+
+```ruby
+# List all ad squads for an ad account
+ad_squads = client.ad_squads.list_all(ad_account_id: "account-id", params: {limit: 50})
+
+# Get a specific ad squad
+ad_squad = client.ad_squads.get(ad_squad_id: "squad-id")
+
+# Create a new ad squad
+new_ad_squad = client.ad_squads.create(
+  campaign_id: "campaign-id",
+  params: {
+    name: "My Ad Squad",
+    status: "ACTIVE",
+    type: "SNAP_ADS"
+  }
+)
+
+# Update an ad squad
+updated_ad_squad = client.ad_squads.update(
+  campaign_id: "campaign-id",
+  ad_squad_id: "squad-id",
+  params: {name: "Updated Ad Squad"}
+)
+
+# Delete an ad squad
+client.ad_squads.delete(ad_squad_id: "squad-id")
+
+# Get ad squad statistics
+stats = client.ad_squads.get_stats(ad_squad_id: "squad-id", params: {granularity: "DAY"})
+```
+
+### Ads (`SnapchatApi::Resources::Ad`)
+
+Create and manage individual ads.
+
+```ruby
+# Create a new ad
+new_ad = client.ads.create(
+  ad_squad_id: "squad-id",
+  params: {
+    name: "My Ad",
+    creative_id: "creative-id",
+    status: "ACTIVE"
+  }
+)
+
+# List ads by different entities
+ads_by_squad = client.ads.list_all_by(entity_id: "squad-id", entity: :ad_squad)
+ads_by_account = client.ads.list_all_by(entity_id: "account-id", entity: :ad_account)
+ads_by_campaign = client.ads.list_all_by(entity_id: "campaign-id", entity: :campaign)
+
+# Get a specific ad
+ad = client.ads.get(ad_id: "ad-id")
+
+# Update an ad
+updated_ad = client.ads.update(
+  ad_squad_id: "squad-id",
+  params: {id: "ad-id", name: "Updated Ad Name"}
+)
+
+# Delete an ad
+client.ads.delete(ad_id: "ad-id")
+
+# Get ad statistics
+stats = client.ads.get_stats(ad_id: "ad-id", params: {granularity: "DAY"})
+```
+
+### Creatives (`SnapchatApi::Resources::Creative`)
+
+Manage creative assets for ads.
+
+```ruby
+# List all creatives for an ad account
+creatives = client.creatives.list_all(ad_account_id: "account-id", params: {limit: 50})
+
+# Get a specific creative
+creative = client.creatives.get(creative_id: "creative-id")
+
+# Create a new creative
+new_creative = client.creatives.create(
+  ad_account_id: "account-id",
+  params: {
+    name: "My Creative",
+    type: "IMAGE",
+    top_snap_media_id: "media-id"
+  }
+)
+
+# Update a creative
+updated_creative = client.creatives.update(
+  ad_account_id: "account-id",
+  creative_id: "creative-id",
+  params: {name: "Updated Creative Name"}
+)
+```
+
+### Media (`SnapchatApi::Resources::Media`)
+
+Upload and manage media files.
+
+```ruby
+# List all media for an ad account
+media_items = client.media.list_all(ad_account_id: "account-id", params: {limit: 50})
+
+# Get a specific media item
+media = client.media.get(media_id: "media-id")
+
+# Create a new media placeholder
+new_media = client.media.create(
+  ad_account_id: "account-id",
+  params: {
+    name: "My Media",
+    type: "IMAGE"
+  }
+)
+
+# Upload a file to the media placeholder
+result = client.media.upload(
+  media_id: "media-id",
+  file_path: "/path/to/image.jpg"
+)
+```
+
+## Error Handling
+
+The gem provides specific error classes for different API error scenarios:
+
+- `SnapchatApi::AuthenticationError` (401) - Invalid or expired access token
+- `SnapchatApi::AuthorizationError` (403) - Insufficient permissions
+- `SnapchatApi::InvalidRequestError` (400-499) - Bad request or client error
+- `SnapchatApi::RateLimitError` (429) - Rate limit exceeded
+- `SnapchatApi::ApiError` (500-599) - Server error
+- `SnapchatApi::Error` - Base error class
+
+```ruby
+begin
+  campaigns = client.campaigns.list_all(ad_account_id: "invalid-id")
+rescue SnapchatApi::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+  client.refresh_tokens! # Try refreshing tokens
+rescue SnapchatApi::RateLimitError => e
+  puts "Rate limit exceeded, waiting..."
+  sleep(60)
+  retry
+rescue SnapchatApi::Error => e
+  puts "API error: #{e.message} (Status: #{e.status_code})"
+end
+```
+
+## Configuration
+
+### Debug Mode
+
+Enable debug mode to see detailed HTTP request/response logs:
+
+```ruby
+client = SnapchatApi::Client.new(
+  client_id: "your-client-id",
+  client_secret: "your-client-secret",
+  debug: true
+)
+```
+
+### Connection Settings
+
+The client uses Faraday with the following default settings:
+- Request timeout: 60 seconds
+- Open timeout: 30 seconds
+- Maximum retries: 3
+- Multipart support for file uploads
+- Automatic redirect following
+
+## Development
+
+```bash
+make install
+make test
+```
+
+To run linting and fix issues automatically:
+```bash
+make lint-fix
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub. This project is intended to be a safe, welcoming space for collaboration.

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "snapchat_api"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/snapchat_api/client.rb

@@ -0,0 +1,162 @@
+require "faraday"
+require "faraday/multipart"
+require "faraday/follow_redirects"
+require "faraday/retry"
+require "snapchat_api/error"
+
+module SnapchatApi
+  class Client
+    attr_accessor :client_id, :client_secret, :access_token, :refresh_token, :debug, :redirect_uri
+
+    ADS_HOST = "https://adsapi.snapchat.com"
+    ACCOUNTS_HOST = "https://accounts.snapchat.com"
+
+    ADS_CURRENT_API_PATH = "v1"
+    ADS_URL = "#{ADS_HOST}/#{ADS_CURRENT_API_PATH}"
+
+    def initialize(client_id:, client_secret:, redirect_uri: nil, access_token: nil, refresh_token: nil, debug: false)
+      @client_id = client_id
+      @client_secret = client_secret
+      @redirect_uri = redirect_uri
+      @access_token = access_token
+      @refresh_token = refresh_token
+      @debug = debug
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: ADS_URL) do |conn|
+        conn.headers["Authorization"] = "Bearer #{@access_token}"
+        conn.headers["Content-Type"] = "application/json"
+
+        conn.options.timeout = 60
+        conn.options.open_timeout = 30
+
+        conn.request :multipart
+        conn.use Faraday::FollowRedirects::Middleware
+        conn.use Faraday::Retry::Middleware, max: 3
+
+        conn.response :json
+
+        conn.response :logger if @debug
+
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    def request(method, path, params = {}, headers = {})
+      response = connection.run_request(method, path, nil, headers) do |req|
+        case method
+        when :get, :delete
+          req.params = params
+        when :post, :put
+          if headers["Content-Type"] == "multipart/form-data"
+            req.options.timeout = 120
+            req.body = {}
+            params.each do |key, value|
+              req.body[key.to_sym] = value
+            end
+          else
+            req.body = JSON.generate(params) unless params.empty?
+          end
+        end
+      end
+
+      handle_response(response)
+    end
+
+    def refresh_tokens!
+      response = Faraday.post("#{ACCOUNTS_HOST}/login/oauth2/access_token") do |req|
+        req.headers["Content-Type"] = "application/x-www-form-urlencoded"
+        req.body = URI.encode_www_form(
+          client_id: @client_id,
+          client_secret: @client_secret,
+          refresh_token: @refresh_token,
+          grant_type: "refresh_token"
+        )
+      end
+      handle_response(response)
+      body = JSON.parse(response.body)
+
+      @access_token = body["access_token"]
+      @refresh_token = body["refresh_token"]
+    end
+
+    def get_authorization_url(scope: "snapchat-marketing-api")
+      params = {
+        client_id: @client_id,
+        redirect_uri: redirect_uri,
+        response_type: "code",
+        scope: scope,
+        state: state
+      }
+
+      "https://accounts.snapchat.com/accounts/oauth2/auth?#{URI.encode_www_form(params)}"
+    end
+
+    def get_tokens(code:)
+      response = Faraday.post("#{ACCOUNTS_HOST}/login/oauth2/access_token") do |req|
+        req.headers["Content-Type"] = "application/x-www-form-urlencoded"
+        req.body = URI.encode_www_form({
+          client_id: @client_id,
+          client_secret: @client_secret,
+          code: code,
+          grant_type: "authorization_code",
+          redirect_uri: redirect_uri
+        })
+      end
+      handle_response(response)
+      JSON.parse(response.body)
+    end
+
+    def accounts
+      @accounts ||= SnapchatApi::Resources::Account.new(self)
+    end
+
+    def campaigns
+      @campaigns ||= SnapchatApi::Resources::Campaign.new(self)
+    end
+
+    def ad_squads
+      @ad_squads ||= SnapchatApi::Resources::AdSquad.new(self)
+    end
+
+    def media
+      @media ||= SnapchatApi::Resources::Media.new(self)
+    end
+
+    def creatives
+      @creatives ||= SnapchatApi::Resources::Creative.new(self)
+    end
+
+    def ads
+      @ads ||= SnapchatApi::Resources::Ad.new(self)
+    end
+
+    private
+
+    def handle_response(response)
+      return response if response.success?
+
+      status = response.status
+      body = response.body
+      error_message = body.is_a?(Hash) ? body&.dig("message") : body
+
+      klass = case status
+      when 401
+        SnapchatApi::AuthenticationError
+      when 403
+        SnapchatApi::AuthorizationError
+      when 429
+        SnapchatApi::RateLimitError
+      when 400..499
+        SnapchatApi::InvalidRequestError
+      when 500..599
+        SnapchatApi::ApiError
+      else
+        SnapchatApi::Error
+      end
+
+      raise klass.new(error_message || "HTTP #{status}", status, body)
+    end
+  end
+end

data/lib/snapchat_api/error.rb

@@ -0,0 +1,22 @@
+module SnapchatApi
+  class Error < StandardError
+    attr_reader :status_code
+    attr_reader :body
+
+    def initialize(message = nil, status_code = nil, body = nil)
+      @status_code = status_code
+      @body = body
+      super(message)
+    end
+  end
+
+  class AuthenticationError < Error; end
+
+  class AuthorizationError < Error; end
+
+  class InvalidRequestError < Error; end
+
+  class ApiError < Error; end
+
+  class RateLimitError < Error; end
+end

data/lib/snapchat_api/resources/account.rb

@@ -0,0 +1,21 @@
+module SnapchatApi
+  module Resources
+    class Account < Base
+      def list_all(organization_id:, params: {})
+        params[:limit] ||= 50
+
+        accounts = []
+        next_link = "organizations/#{organization_id}/adaccounts?limit=#{params[:limit]}"
+
+        loop do
+          response = client.request(:get, next_link)
+          next_link = response.body["paging"]["next_link"]
+          accounts.concat(response.body["adaccounts"].map { |el| el["adaccount"] })
+          break if next_link.nil?
+        end
+
+        accounts
+      end
+    end
+  end
+end

data/lib/snapchat_api/resources/ad.rb

@@ -0,0 +1,62 @@
+module SnapchatApi
+  module Resources
+    class Ad < Base
+      def create(ad_squad_id:, params:)
+        ads_data = {ads: [**params]}
+        response = client.request(:post, "adsquads/#{ad_squad_id}/ads", ads_data)
+
+        response.body["ads"].first["ad"]
+      end
+
+      def list_all_by(entity_id:, entity: :ad_squad, params: {})
+        params[:limit] ||= 50
+
+        ads = []
+
+        next_link = case entity
+        when :ad_squad
+          "adsquads/#{entity_id}/ads?limit=#{params[:limit]}"
+        when :ad_account
+          "adaccounts/#{entity_id}/ads?limit=#{params[:limit]}"
+        when :campaign
+          "campaigns/#{entity_id}/ads?limit=#{params[:limit]}"
+        else
+          raise ArgumentError, "Invalid entity type: #{entity}. Must be :ad_squad, :ad_account, or :campaign."
+        end
+
+        loop do
+          response = client.request(:get, next_link)
+          next_link = response.body["paging"]["next_link"]
+          ads.concat(response.body["ads"].map { |el| el["ad"] })
+          break if next_link.nil?
+        end
+
+        ads
+      end
+
+      def get(ad_id:)
+        response = client.request(:get, "ads/#{ad_id}")
+        response.body["ads"].first["ad"]
+      end
+
+      def delete(ad_id:)
+        response = client.request(:delete, "ads/#{ad_id}")
+        response.success?
+      end
+
+      def update(ad_squad_id:, params:)
+        ad_data = {
+          ads: [**params.merge(ad_squad_id: ad_squad_id)]
+        }
+
+        response = client.request(:put, "adsquads/#{ad_squad_id}/ads", ad_data)
+        response.body["ads"].first["ad"]
+      end
+
+      def get_stats(ad_id:, params: {})
+        response = client.request(:get, "ads/#{ad_id}/stats", params)
+        response.body
+      end
+    end
+  end
+end

data/lib/snapchat_api/resources/ad_squad.rb

@@ -0,0 +1,54 @@
+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
+
+        ad_squads
+      end
+
+      def get(ad_squad_id:)
+        response = client.request(:get, "adsquads/#{ad_squad_id}")
+        response.body["adsquads"].first["adsquad"]
+      end
+
+      def create(campaign_id:, params: {})
+        ad_squads_data = {
+          adsquads: [**params.merge(campaign_id: campaign_id)]
+        }
+
+        response = client.request(:post, "campaigns/#{campaign_id}/adsquads", ad_squads_data)
+        response.body["adsquads"].first["adsquad"]
+      end
+
+      def update(campaign_id:, ad_squad_id:, params: {})
+        ad_squads_data = {
+          adsquads: [**params.merge(id: ad_squad_id, campaign_id:)]
+        }
+
+        response = client.request(:put, "campaigns/#{campaign_id}/adsquads", ad_squads_data)
+        response.body["adsquads"].first["adsquad"]
+      end
+
+      def delete(ad_squad_id:)
+        response = client.request(:delete, "adsquads/#{ad_squad_id}")
+        response.success?
+      end
+
+      def get_stats(ad_squad_id:, params: {})
+        response = client.request(:get, "adsquads/#{ad_squad_id}/stats", params)
+        response.body
+      end
+    end
+  end
+end

data/lib/snapchat_api/resources/base.rb

@@ -0,0 +1,11 @@
+module SnapchatApi
+  module Resources
+    class Base
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+    end
+  end
+end

data/lib/snapchat_api/resources/campaign.rb

@@ -0,0 +1,54 @@
+module SnapchatApi
+  module Resources
+    class Campaign < Base
+      def list_all(ad_account_id:, params: {})
+        params[:limit] ||= 50
+
+        campaigns = []
+        next_link = "adaccounts/#{ad_account_id}/campaigns?limit=#{params[:limit]}"
+
+        loop do
+          response = client.request(:get, next_link)
+          next_link = response.body["paging"]["next_link"]
+          campaigns.concat(response.body["campaigns"].map { |el| el["campaign"] })
+          break if next_link.nil?
+        end
+
+        campaigns
+      end
+
+      def get(ad_account_id:, campaign_id:)
+        response = client.request(:get, "campaigns/#{campaign_id}")
+        response.body["campaigns"].first["campaign"]
+      end
+
+      def create(ad_account_id:, params: {})
+        campaigns_data = {
+          campaigns: [**params]
+        }
+
+        response = client.request(:post, "adaccounts/#{ad_account_id}/campaigns", campaigns_data)
+        response.body["campaigns"].first["campaign"]
+      end
+
+      def update(ad_account_id:, campaign_id:, params: {})
+        campaigns_data = {
+          campaigns: [**params.merge(id: campaign_id, ad_account_id:)]
+        }
+
+        response = client.request(:put, "adaccounts/#{ad_account_id}/campaigns", campaigns_data)
+        response.body["campaigns"].first["campaign"]
+      end
+
+      def delete(campaign_id:)
+        response = client.request(:delete, "campaigns/#{campaign_id}")
+        response.success?
+      end
+
+      def get_stats(campaign_id:, params: {})
+        response = client.request(:get, "campaigns/#{campaign_id}/stats", params)
+        response.body
+      end
+    end
+  end
+end

data/lib/snapchat_api/resources/creative.rb

@@ -0,0 +1,44 @@
+module SnapchatApi
+  module Resources
+    class Creative < Base
+      def list_all(ad_account_id:, params: {})
+        params[:limit] ||= 50
+
+        creatives = []
+        next_link = "adaccounts/#{ad_account_id}/creatives?limit=#{params[:limit]}"
+
+        loop do
+          response = client.request(:get, next_link)
+          next_link = response.body["paging"]["next_link"]
+          creatives.concat(response.body["creatives"].map { |el| el["creative"] })
+          break if next_link.nil?
+        end
+
+        creatives
+      end
+
+      def get(creative_id:)
+        response = client.request(:get, "creatives/#{creative_id}")
+        response.body["creatives"].first["creative"]
+      end
+
+      def create(ad_account_id:, params: {})
+        creatives_data = {
+          creatives: [**params]
+        }
+
+        response = client.request(:post, "adaccounts/#{ad_account_id}/creatives", creatives_data)
+        response.body["creatives"].first["creative"]
+      end
+
+      def update(ad_account_id:, creative_id:, params: {})
+        creatives_data = {
+          creatives: [**params.merge(id: creative_id, ad_account_id:)]
+        }
+
+        response = client.request(:put, "adaccounts/#{ad_account_id}/creatives", creatives_data)
+        response.body["creatives"].first["creative"]
+      end
+    end
+  end
+end

data/lib/snapchat_api/resources/media.rb

@@ -0,0 +1,49 @@
+require "stringio"
+require "mime/types"
+
+module SnapchatApi
+  module Resources
+    class Media < Base
+      def list_all(ad_account_id:, params: {})
+        params[:limit] ||= 50
+
+        media_items = []
+        next_link = "adaccounts/#{ad_account_id}/media?limit=#{params[:limit]}"
+
+        loop do
+          response = client.request(:get, next_link)
+          next_link = response.body["paging"]["next_link"]
+          media_items.concat(response.body["media"].map { |el| el["media"] })
+          break if next_link.nil?
+        end
+
+        media_items
+      end
+
+      def get(media_id:)
+        response = client.request(:get, "media/#{media_id}")
+        response.body["media"].first["media"]
+      end
+
+      def create(ad_account_id:, params: {})
+        media_data = {
+          media: [params]
+        }
+
+        response = client.request(:post, "adaccounts/#{ad_account_id}/media", media_data)
+        response.body["media"].first["media"]
+      end
+
+      def upload(media_id:, file_path:, params: {})
+        mime_type = MIME::Types.type_for(file_path).first.content_type
+
+        upload_params = {
+          file: Faraday::UploadIO.new(file_path, mime_type, File.basename(file_path))
+        }
+
+        response = client.request(:post, "media/#{media_id}/upload", upload_params, {"Content-Type" => "multipart/form-data"})
+        response.body["result"]
+      end
+    end
+  end
+end

data/lib/snapchat_api/version.rb

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

data/lib/snapchat_api.rb

@@ -0,0 +1,8 @@
+require_relative "snapchat_api/version"
+
+require "zeitwerk"
+loader = Zeitwerk::Loader.for_gem
+loader.setup
+
+module SnapchatApi
+end

metadata

@@ -0,0 +1,240 @@
+--- !ruby/object:Gem::Specification
+name: snapchat_api
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- Alex Koval
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-follow_redirects
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.49.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.49.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: A comprehensive Ruby library for interacting with the Snapchat API
+email:
+- al3xander.koval@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- bin/console
+- bin/setup
+- lib/snapchat_api.rb
+- lib/snapchat_api/client.rb
+- lib/snapchat_api/error.rb
+- lib/snapchat_api/resources/account.rb
+- lib/snapchat_api/resources/ad.rb
+- lib/snapchat_api/resources/ad_squad.rb
+- lib/snapchat_api/resources/base.rb
+- lib/snapchat_api/resources/campaign.rb
+- lib/snapchat_api/resources/creative.rb
+- lib/snapchat_api/resources/media.rb
+- lib/snapchat_api/version.rb
+homepage: https://github.com/k0va1/snapchat_api
+licenses: []
+metadata:
+  homepage_uri: https://github.com/k0va1/snapchat_api
+  source_code_uri: https://github.com/k0va1/snapchat_api
+  changelog_uri: https://github.com/k0va1/snapchat_api/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby wrapper for the Snapchat API
+test_files: []