Google Drive Upload

Connect Google Drive and upload images and videos to your Meta ad account without downloading them to your computer first. Adsap streams each file from Drive to Meta and stores nothing on its servers.

Plans: Google Drive imports are an Early Access feature. The Free plan uploads creatives manually. See Pricing.

Connecting Google Drive

Connect your Google Drive account before you browse or upload files.

1. Log in to app.adsap.ai .
2. Go to Settings.
3. Find the Google Drive section and click Connect Google Drive.
4. Sign in with your Google account when prompted.
5. Review the permissions and click Allow.

Adsap uses the drive.file scope. It can read only the files you pick in the Google picker (and files it creates itself). It cannot browse your whole Drive.

Note: The Google Drive connection is separate from your Meta account connection. Each uses its own OAuth token. If one expires, the other keeps working.

Supported File Types and Limits

In the ADSAP web app (/creatives/upload) the limit is 500 MB per file. The 4 GB video limit applies when you upload through the AI Copilot (Claude, ChatGPT or Perplexity), where the file goes straight from your cloud storage to Meta.

Adsap rejects files over these limits, or in other formats, during upload.

Browsing Your Drive

In the Web Dashboard

Open the creative upload section and click Import from Google Drive. A file picker opens. Browse your Drive folders and select the files to upload.

Via the AI Copilot

Ask the copilot to list the files in a folder or search for files:

Show me the files in my "Campaign Assets" folder on Google Drive.

List all video files in my Drive.

The copilot uses the adsap_list_drive_files tool to browse your connected Drive. Move through folders, search by name, and filter by file type.

Uploading Creatives

How Image Uploads Work

Image uploads are synchronous: Adsap streams the file from Google Drive straight to Meta and confirms as soon as the upload completes. It takes a few seconds.

The image then appears in your Creative Library with its metadata (dimensions, aspect ratio, content hash) filled in.

How Video Uploads Work

Video uploads are asynchronous, because Meta needs time to encode the video after receiving it. Two stages:

1. Upload stage: Adsap streams the video file from Google Drive to Meta. This takes from seconds to minutes, depending on file size.
2. Encoding stage: Meta processes the video (transcoding, generating thumbnails). This happens on Meta’s side and also takes from seconds to minutes.

Meanwhile, the video’s status in your creative library moves through encoding, then processing, then ready (or error if something went wrong).

Via the AI Copilot

Upload a specific file:

Upload "hero-banner.jpg" from my Google Drive to my ad account.

Upload a video and track its progress:

Upload "product-demo.mp4" from my Drive to my ad account. Let me know when it is ready.

The copilot starts the upload and, for videos, can poll the status until encoding completes:

What is the upload status of my video?

Polling Video Upload Status

Because video encoding is asynchronous, check the status before you use a video in an ad. Two ways:

In the Web Dashboard

The creative library shows a status badge on each video thumbnail:

• A spinner means the video is still processing.
• A green checkmark means the video is ready to use.
• A red indicator means encoding failed.

Via the AI Copilot

The copilot uses the adsap_get_upload_status tool:

Check the status of my recent video uploads.

Is the product-demo.mp4 video ready to use?

Important: Do not reference a video in an ad sheet row or ad creation request until its status is ready. A video that is still encoding causes a launch error.

How Streaming Works

When you upload a file through Adsap, it streams straight from Google Drive to Meta. That means:

• Adsap never stores the original file on its servers. It passes through as a stream; Adsap keeps only a thumbnail for the library.
• Adsap uses your Google Drive token only for the length of the download.
• Adsap detects the file type (image or video) and routes it to the right Meta upload endpoint.

Troubleshooting

“DRIVE_AUTH_EXPIRED” error Your Google Drive token has expired. Go to Adsap Settings and click Connect Google Drive again.

Upload fails with size limit error Check the file against the limits: 30 MB for images, 4 GB for videos through the AI Copilot, 500 MB per file in the web app. For an image over the limit, compress it or convert it to WebP before uploading.

Video stuck in “encoding” or “processing” Meta’s encoding sometimes takes longer than expected. Wait a few minutes and check again. If the status has not changed after 15-20 minutes, upload the video again.

“File not found” error Check that the file still exists in your Google Drive at the path you gave. If you moved or renamed it, browse your Drive again to get the new path.

Unsupported format Through the AI Copilot, Adsap accepts JPG, PNG, WebP for images and MP4, MOV, MKV, AVI for videos. The web app accepts JPG, PNG, GIF, MP4, MOV, AVI. GIF works in the web app only; TIFF, WMV and FLV work nowhere. Convert the file to a supported format before uploading.

Labels and Metadata

On upload, Adsap records metadata (filename, dimensions, file size, aspect ratio) in your creative library. Add tags to organize creatives after upload. See Creative Library for tagging and grouping.

Labels and tags are metadata inside Adsap only. Adsap does not send them to Meta, and they do not appear in Meta Ads Manager.