Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.ad_accountUnifiedSoonAn ad account on one ad platform, with its currency, time zone, spend and spending limit.
key platform + ad account ID5 planned callsNo Direct endpoint yet
Our own first draft of the paths, not reviewed yet. Each call acts on the platforms it lists through the Connection you grant, and none is deployed yet.
/Ad accounts reachable through your ConnectionsAll 8 ad platformsDraft/Spend, impressions, clicks and conversions by dayAll 8 ad platformsDraft/Changes made in the account, and who made themMeta · GoogleDraft/Create an ad account; billing is then set up on the platformMeta · GoogleDraft/Change account settings, such as the name or spending limitMeta · GoogleDraftA first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
platformstringReportednamestringReportedcurrencystringReportedtimezonestringReportedstatusStatusReportedspend_capMoneyReportedThe account's spending limit, where one is setamount_spentMoneyReportedconnectionConnectionReportedThe same Connection that posts on socialVendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
No Direct endpoint returns AdAccount yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.
platform + campaign IDA campaign with its objective, budget and status, and the ad sets under it.
workspace + accountYour permission to act for an account: scopes, status, expiry.
AIsa workspace_idThe accounts of one brand, or of one client for an agency.