Platforms, unified entities, vendor APIs, endpoints and connectors.
ads.creativeUnifiedSoonThe media, text and call to action an ad shows, reusable across ads.
key platform + creative ID3 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.
/ v1/ ads/ creativesThe creatives in an account's libraryMetaDraft/ v1/ ads/ creativesCreate a creative from media, text and a call to actionMetaDraft/ v1/ ads/ creatives/ {creativeId}Delete a creativeMetaDraftA first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
formatstringReportedmediaMedia[]ReportedheadlinestringReportedtextstringReportedcall_to_actionstringReportedlink_urlstringReportedlistingListingReportedThe Listing the ad links to, if anyplatform_checksCheck[]ObservedPrecheck of text length, media and format before sendingVendor 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 Creative yet. It comes with the Unified layer.
Each link is a field you can ask for in the same call.