Media & Video

`watchVideo`

Watch Video

Start reading a video URL, Cloud file, recording, or page media block.

writeconsentexternal

Arguments

fileRefobjectoptionalA Cloud file or recording. Provide exactly one source.
pageMediaBlockIdstringoptionalA page media block id. Provide exactly one source.
urlstringoptionalA video URL. Provide exactly one source.
cadencenumberoptionalSeconds between overview frames. Use 10 to 15 for screen recordings and 30 for talking heads.
confirmbooleanoptionalRequired when the source is the member's own private content: their recording, their Cloud file, a video on their page, or a YouTube upload of theirs that is not public. Set it to true ONLY when the member asked for this video in words in…
machineIdstringoptionalOptional machine id. Omit to use the member's healthy online machine.
timestampsnumber[]optionalOptional exact timestamps in seconds to capture in addition to the cadence.

Returns

When an owned private YouTube upload has no Cloud copy, the existing authorized YouTube connection may return a completed transcript-only result from a verified manual English caption track;…

Declared limits

cadence: minimum 5
cadence: maximum 300
timestamps: maximum items 50

Ask for it

The Cloud routes these requests to this verb.

watch this video
review this recording
what did I point at
look closer at 4:32
read the transcript of my video

Pair it with

The verbs that finish the job.