Platforms
YouTube
YouTube over the overads API: status, connection, limits, media rules and platformSettings keys.
Status: In review. Connect and test with a test account; delivery for customers switches on when the review clears.
Built, connectable, and waiting on Google's OAuth verification. Until then only listed test users can connect, their tokens expire after seven days, and it does not publish for customers.
Connecting
OAuth through Google, in the app.
Once connected the account appears in GET /connections with platform: "youtube". Use its id in connectionIds.
Limits
| Characters | 5,000 for the description. The title comes from the title setting or, when absent, the first line of the content. |
| API id | youtube |
- Exactly one video, required, up to 12 hours (the 500 MB upload cap applies first). A post with no video or with images is refused.
- Each upload spends 1,600 of the app's 10,000 daily YouTube API units, about six uploads a day across all customers until Google extends the quota.
Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. A video over the channel's size cap is MEDIA_TOO_LARGE; over its duration cap is MEDIA_TOO_LONG.
Settings
Pass these under platformSettings.youtube. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.
| Key | Value | Meaning |
|---|---|---|
privacy | public, unlisted or private | Video privacy |
title | string, up to 100 | Video title |
tags | string[], up to 50, each up to 30, 500 in total | Video tags |
categoryId | numeric string | A YouTube category id |
madeForKids | boolean | COPPA flag |
{ "youtube": { "privacy": "unlisted", "title": "Launch walkthrough", "tags": ["overads", "launch"] } }A post to a channel that is not live is accepted and stored, and its target row records the refusal at delivery time. Do not schedule customer-facing posts there until this page says live.