appleads

type APIError struct {
	StatusCode  int
	Field       string
	Message     string
	MessageCode string
	Detail      string
	Version     APIVersion
	Code        string
	Details     []APIErrorDetail
	RateLimit   RateLimit
}

type APIErrorDetail struct {
	Code    string         `json:"code,omitempty"`
	Message string         `json:"message,omitempty"`
	Info    map[string]any `json:"info,omitempty"`
}

type APIVersion string

type BodyKind string

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

type ClientOption func(*Client)

type ContextKind uint8

type Credentials struct {
	ClientID       string
	TeamID         string
	KeyID          string
	PrivateKeyPath string
	PrivateKeyPEM  string
	AccessToken    string
	OrgID          string
	AdAccountID    string
	Profile        string
}

type EndpointSpec struct {
	Name         string
	Method       string
	Path         string
	Version      APIVersion
	Context      ContextKind
	CommandPath  []string
	BodyKind     BodyKind
	BodyOptional bool
	// CLIRequiresBody records a client-side requirement that is stricter than
	// the SDK/OpenAPI request contract. Apple accepts an empty selector body on
	// some query endpoints, but the Platform API requires a selector filter for
	// the keyword queries exposed by asc.
	CLIRequiresBody bool
	BodyType        string
	BodyHint        string
	BodyFileExample string
	// BodyExample is a minimal valid request payload rendered in command help
	// so callers can start from a working body instead of external schema docs.
	BodyExample      string
	ResponseType     string
	RequiresOrg      bool
	RequiresConfirm  bool
	ConfirmBodyField string
	// RiskConfirm separates potential spend, billing, delivery, targeting, or
	// access impact acknowledgement from destructive confirmation. A body
	// field/value pair can exempt a documented safe payload from the
	// acknowledgement. When RiskConfirmAllowedBodyFields is set, every field
	// in the safe payload object must be listed before acknowledgement can be
	// skipped.
	RiskConfirm                  bool
	RiskConfirmBodyField         string
	RiskConfirmBodyValue         string
	RiskConfirmAllowedBodyFields []string
	RetrySafe                    bool
	PathParams                   []ParamSpec
	QueryParams                  []ParamSpec
	SupportsPaginate             bool
	DefaultListAlias             bool
}

type PageDetail struct {
	ItemsPerPage int `json:"itemsPerPage"`
	StartIndex   int `json:"startIndex"`
	TotalResults int `json:"totalResults"`
}

type ParamSpec struct {
	Name         string
	Flag         string
	Aliases      []string
	Type         ParamType
	Required     bool
	Repeated     bool
	ContextValue bool
	Max          int
	Allowed      []string
	Description  string
	Default      int
}

type ParamType string

type RateLimit struct {
	Limit     string `json:"limit,omitempty"`
	Remaining string `json:"remaining,omitempty"`
	Reset     string `json:"reset,omitempty"`
}

type RawResponse json.RawMessage

type StoredCredential struct {
	Credentials
	Name       string
	IsDefault  bool
	Source     string
	SourcePath string
}