Quick Check
Open the link in a private or incognito browser window, without signing in. If the file plays or starts downloading, VideoDB can usually upload it. If you see a sign-in page, a “request access” page or a folder view, the upload will fail.What Works
What Doesn’t Work
Google Drive
1
Open the sharing settings
In Google Drive, right-click the file and choose Share.
2
Allow anyone with the link
Under General access, change Restricted to Anyone with the link. Viewer is enough.
3
Copy the file link
Click Copy link. It looks like
https://drive.google.com/file/d/<FILE_ID>/view?usp=sharing.4
Upload the link
Pass the link as
url. Links in the forms drive.google.com/file/d/<FILE_ID>/..., drive.google.com/open?id=<FILE_ID>, drive.google.com/uc?export=download&id=<FILE_ID> and drive.usercontent.google.com/download?id=<FILE_ID> all work. VideoDB imports the original file at its full resolution, whether it’s a video, audio or image.- Folder link (
/drive/folders/...): open the folder, then share and upload each file on its own. - Workspace account: your organization may block sharing outside the company. Ask your admin, or download the file and upload it directly.
- Shared drive: the shared drive’s settings can block link sharing even when the file allows it. Check with the drive’s manager.
- Popular file: Google limits how often a shared file can be downloaded. If the file has been downloaded many times recently, wait and retry, or upload it directly.
- Google Docs, Sheets or Slides: these are documents, not media files.
Upload Errors
When an upload fails, the SDK raises an error that carries the message below. Python raisesInvalidRequestError and Node.js throws VideodbError. If you pass a callback_url, the callback carries both the message and a stable error_code, which is the better choice for handling errors in code.
Problems with the link
Problems with the platform
These come from the platform hosting the video (YouTube, Instagram and others). The video’s owner or the platform controls them.Problems with your account
If you see
upload_failed, or a message not listed here, the problem is usually on our side. Retry the upload. If it keeps failing, contact support with the URL and the time of the attempt.Next Steps
Upload Video
Upload methods, media types and callbacks
Collection Patterns
Batching, retries, and production patterns