📹YouTube: Upload Video

Upload video to YouTube channel

The module requires Google OAuth 2.0 connection to get access token and pass it with other parameters to upload a video using YouTube Data V3 API.

Note: Video will be uploaded to the root channel of Google account, which you used to create OAuth 2.0 connection with.

Once uploading started, unique temporary video uploading ID is created, which is sent in response with status field (generally equals "in process").

You can check video uploading status using the YouTube: Get Video status module.

Important note: The uploading status, whish is accessible by the YouTube: Get Video status module, does not actually correspond to the YouTube video status, it only determines is the module processed a video thus transferred it correctly to YouTube or not.

If webhook URL is provided, server sends GET request (in 5 seconds delay from initial request started processing) to webhook URL with youtubeLink attached to the params of the URL once video processing finished.

Note: video uploading ID will be deleted after 10 mins if the video was successfully transferred to YouTube.

Parameters

Video file URL

Is a URL of video file, which will be uploaded to YouTube. Pay attention URL must lead to the file itself, not an html page, which contains the video.

{
    Name: "videoUrl"
    Type: "text"
    Required: true
}

Webhook URL

Used as a callback URL. Server will send GET request to that URL after video processing finished.

{
    Name: "webhookUrl"
    Type: "text"
    Required: false
}

Title

Video title

{
    Name: "title"
    Type: "text"
    Required: true
}

Description

Vide description

{
    Name: "description"
    Type: "text"
    Required: false
}

Tags

Tags must be a string containing tags separated with comma. Example: "tag1,tag2,tag3"

{
    Name: "tags"
    Type: "text"
    Required: false
}

Playlist ID

To get playlist ID go to YouTube Studio and take the ID from URL: https://studio.youtube.com/playlist/<PLAYLIST_ID>/videos

{
    Name: "playlistId"
    Type: "text"
    Required: false
}

Interface / Response body

Video uploading ID

Unique temporary ID, which you can use to get uploading video status using YouTube: Get Video status module.

{
    Name: "uploadingID"
    Type: "text"
}

Status

Video uploading status. Could contain one of these values: "in process" / "error" / "processed".

Important note: The uploading status, whish is accessible by the YouTube: Get Video status module, does not actually correspond to the YouTube video status, it only determines is the module processed a video thus transferred it correctly to YouTube or not.

{
    Name: "status"
    Type: "text"
}

Errors

Status Code	Reasons
400	Validation error (title). User exceeded max videos per day. YouTube channel restrictions. For example, if user not verified he can not upload video longer 15 min: https://support.google.com/youtube/answer/71673?hl=en
403	Google OAuth 2.0 client exceeded daily quota limit for uploading videos.
500	Internal Server error.