meta

type Ad struct {
	ID       string     `json:"id"`
	Name     string     `json:"name"`
	AdSetID  string     `json:"adset_id"`
	Creative AdCreative `json:"creative"`
	Status   string     `json:"status"`
}

type AdAccount struct {
	ID            string `json:"id"`
	AccountID     string `json:"account_id"`
	Name          string `json:"name"`
	AccountStatus int    `json:"account_status"`
	Currency      string `json:"currency"`
	TimezoneName  string `json:"timezone_name"`
	AmountSpent   string `json:"amount_spent"`
	Balance       string `json:"balance"`
}

type AdCreative struct {
	ID string `json:"id"`
}

type AdSet struct {
	ID             string `json:"id"`
	Name           string `json:"name"`
	CampaignID     string `json:"campaign_id"`
	Status         string `json:"status"`
	DailyBudget    string `json:"daily_budget,omitempty"`
	LifetimeBudget string `json:"lifetime_budget,omitempty"`
}

type AggregateSourceError struct {
	Warnings []SourceWarning
}

type AuthApp struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type AuthStatusResult struct {
	Valid       bool     `json:"valid"`
	User        AuthUser `json:"user"`
	App         AuthApp  `json:"app"`
	Permissions []string `json:"permissions"`
	ExpiresAt   string   `json:"expires_at"`
	Scopes      []string `json:"scopes"`
}

type AuthUser struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type Campaign struct {
	ID             string `json:"id"`
	Name           string `json:"name"`
	Objective      string `json:"objective"`
	Status         string `json:"status"`
	DailyBudget    string `json:"daily_budget,omitempty"`
	LifetimeBudget string `json:"lifetime_budget,omitempty"`
}

type Client interface {
	Get(ctx context.Context, path string, params url.Values) (*Response, error)
	Post(ctx context.Context, path string, params map[string]string) (*Response, error)
	Upload(ctx context.Context, path string, file io.Reader, filename string, size int64, params map[string]string) (*Response, error)
	Paginate(ctx context.Context, path string, params url.Values) *PageIterator
	SetDryRun(v bool)
	SetVerbose(v bool)
}

type CreateAdParams struct {
	AccountID  string
	Name       string
	AdSetID    string
	CreativeID string
	Status     string // default: PAUSED
}

type CreateAdSetParams struct {
	AccountID           string
	Name                string
	CampaignID          string
	DailyBudgetCents    int64
	LifetimeBudgetCents int64
	OptimizationGoal    string
	BillingEvent        string // default: IMPRESSIONS
	BidAmountCents      int64
	Countries           []string // required, non-empty
	AgeMin              int      // default: 18
	AgeMax              int      // default: 65
	Genders             []int    // default: [1,2]
	Interests           []string // interest IDs
	Behaviors           []string
	CustomAudiences     []string
	ExcludedCountries   []string
	PublisherPlatforms  []string
	PixelID             string
	CustomEventType     string
	StartTime           string
	EndTime             string
	AdvantageAudience   bool   // default: false (explicit targeting)
	Status              string // default: PAUSED
}

type CreateCampaignParams struct {
	AccountID           string
	Name                string
	Objective           string // OUTCOME_SALES, OUTCOME_TRAFFIC, etc.
	DailyBudgetCents    int64  // mutually exclusive with LifetimeBudgetCents
	LifetimeBudgetCents int64
	BidStrategy         string // default: LOWEST_COST_WITHOUT_CAP
	Status              string // default: PAUSED
	SpecialAdCategory   string // default: NONE
}

type CreateCreativeParams struct {
	AccountID          string
	Name               string
	PageID             string // required
	VideoID            string // one of VideoID/ImageHash/ImageURL required
	ImageHash          string
	ImageURL           string
	Message            string // required
	Headline           string
	Description        string
	CTA                string // default: SHOP_NOW
	Link               string // required
	InstagramAccountID string
}

type Creative struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

type GraphError struct {
	Message     string `json:"message"`
	Type        string `json:"type"`
	Code        int    `json:"code"`
	Subcode     int    `json:"error_subcode"`
	TraceID     string `json:"fbtrace_id"`
	UserTitle   string `json:"error_user_title,omitempty"`
	UserMessage string `json:"error_user_msg,omitempty"`
	IsRetryable bool   `json:"-"`
}

type Image struct {
	Hash   string `json:"hash"`
	Name   string `json:"name,omitempty"`
	URL    string `json:"url,omitempty"`
	URL128 string `json:"url_128,omitempty"`
	Width  int    `json:"width,omitempty"`
	Height int    `json:"height,omitempty"`
}

type ListAccountsParams struct {
	Limit int
}

type ListAccountsResult struct {
	Data    []AdAccount `json:"data"`
	HasNext bool        `json:"has_next"`
	Cursor  string      `json:"cursor"`
}

type ListPagesParams struct {
	// Limit is the per-API-call page size passed to every underlying Graph
	// request (default 25).
	Limit int
	// All triggers exhaustive pagination of every source. Without it, each
	// source fetches only its first page and the results are aggregated.
	All bool
}

type ListPagesResult struct {
	Data     []Page          `json:"data"`
	Warnings []SourceWarning `json:"warnings,omitempty"`
	// HasNext is true when at least one source reported a next page. In
	// aggregated mode the caller cannot resume from a single cursor, so this
	// is purely informational.
	HasNext bool `json:"has_next"`
	// Cursor is retained for backward compatibility with the pre-aggregation
	// API shape and is always empty in the aggregated implementation.
	Cursor string `json:"cursor,omitempty"`
}

type Page struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	// Category is empty for pages returned from /owned_pages and
	// /client_pages unless Meta includes it in the response.
	Category string `json:"category,omitempty"`
	// AccessToken is only present when the Page was reached via
	// /me/accounts. Business-Manager-sourced Pages do not expose a Page
	// access token on this endpoint.
	AccessToken string `json:"access_token,omitempty"`
	// Sources lists every route through which the user can reach this Page,
	// sorted alphabetically for deterministic output.
	Sources []PageSource `json:"sources"`
	// BusinessIDs lists every Business Manager through which the Page is
	// accessible, sorted lexicographically for deterministic output.
	BusinessIDs []string `json:"business_ids,omitempty"`
	// Tasks lists the permitted tasks on the Page, when Meta returns them.
	// The set varies by source; when a Page is reachable through multiple
	// sources the first non-empty set is retained.
	Tasks []string `json:"tasks,omitempty"`
}

type PageIterator struct {
	// contains filtered or unexported fields
}

type PageSource string

type Response struct {
	Body       []byte
	StatusCode int
	Headers    http.Header
}

type SearchTargetingParams struct {
	AccountID string
	Type      string
	Query     string
	Limit     int
}

type SearchTargetingResult struct {
	Data []TargetingSuggestion `json:"data"`
}

type SourceWarning struct {
	// Source is a stable, machine-parseable identifier like "me/accounts" or
	// "business/581184769220955/owned_pages". No leading slash, no version.
	Source string `json:"source"`
	// Code is the Meta error code if the failure came from a Graph error.
	Code int `json:"code,omitempty"`
	// Message is a human-readable description of the failure.
	Message string `json:"message"`
}

type TargetingSuggestion struct {
	ID                     string   `json:"id"`
	Name                   string   `json:"name"`
	Type                   string   `json:"type"`
	AudienceSizeLowerBound int64    `json:"audience_size_lower_bound"`
	AudienceSizeUpperBound int64    `json:"audience_size_upper_bound"`
	Path                   []string `json:"path"`
}

type UploadImageParams struct {
	AccountID string
	File      io.Reader
	Filename  string
	FileSize  int64
}

type UploadVideoParams struct {
	AccountID string
	File      io.Reader
	Filename  string
	FileSize  int64
	Title     string
}

type Video struct {
	ID      string      `json:"id"`
	Title   string      `json:"title"`
	Status  VideoStatus `json:"status"`
	Length  float64     `json:"length"`
	Picture string      `json:"picture,omitempty"`
}

type VideoStatus struct {
	VideoStatus        string `json:"video_status"`
	ProcessingProgress int    `json:"processing_progress"`
}

type VideoStatusParams struct {
	VideoID string
}