SnapchatApi

gem 'snapchat_api'

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
)

# 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!

# List all ad accounts for an organization
accounts = client.accounts.list_all(organization_id: "org-id", params: {limit: 50})

# 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"})

# 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"})

# 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"})

# 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"}
)

# 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"
)

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

client = SnapchatApi::Client.new(
  client_id: "your-client-id",
  client_secret: "your-client-secret",
  debug: true
)