Skip to main content

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

If a link can’t be made public, download the file yourself and upload it with file_path (Python) or uploadFile (Node.js). Local uploads don’t depend on how the file is shared.

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.
If it still fails:
  • 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 raises InvalidRequestError 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.
Failed callback payload:

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