Poll a Google Ads video upload

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Checks whether YouTube has assigned an ID to a video you uploaded with Upload a Google Ads video.

Send the upload_rn that upload returned. Each call reads the upload's state from Google once and returns straight away, with video_id empty while YouTube is still processing. Poll every few seconds until it is filled in. Nothing is uploaded again, and polling does not count against the upload limit.

A video YouTube rejected, or one that failed to upload, returns a 400, so upload a different file then. An upload_rn that is not shaped like one, or that belongs to a different Google Ads account, is also rejected with a 400. One that is correctly shaped but names no upload keeps returning an empty video_id, so stop polling after a few minutes.

This is limited to 30 requests a minute per app. Some workspaces have a different limit. It is refused with a 409 while the workspace is on a Google Ads billing hold.

<Note>This endpoint accepts a personal API key from anyone who can edit the app. A read-only key is refused with a 403, and so are workspace API keys.</Note>

post/api/apps/{app_id}/google-ads/assets/upload-video/poll

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/google-ads/assets/upload-video/poll
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app whose Google Ads creative you want to generate or read.

Request body

upload_rnstring required

The upload_rn that Upload a Google Ads video returned for this app.

Example request

{
  "upload_rn": "customers/1234567890/youTubeVideoUploads/AbC123xYz"
}

Response

The upload, with video_id filled in once YouTube has assigned it.

video_idstring required

The YouTube video ID. Pass it as a video on a campaign, exactly as you would the ID from a YouTube link. Empty while YouTube is still processing the upload, in which case poll with upload_rn.

upload_rnstring required

Google's reference for the upload. Keep it until video_id is filled in, and pass it to Poll a Google Ads video upload.

Example response

{
  "video_id": "dQw4w9WgXcQ",
  "upload_rn": "customers/1234567890/youTubeVideoUploads/AbC123xYz"
}

Changes