> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown. # Poll a Google Ads video upload > This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Checks whether YouTube has assigned an ID to a video you uploaded with [Upload a Google Ads video](/api-reference/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. 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. ## OpenAPI ````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/google-ads/assets/upload-video/poll openapi: 3.1.0 info: title: Base44 App Management API version: 1.0.0 servers: - url: https://app.base44.com security: - PersonalAccessTokenAuth: [] paths: /api/apps/{app_id}/google-ads/assets/upload-video/poll: post: summary: Poll a Google Ads video upload description: >- This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Checks whether YouTube has assigned an ID to a video you uploaded with [Upload a Google Ads video](/api-reference/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. 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. operationId: >- poll_video_upload_api_apps__app_id__google_ads_assets_upload_video_poll_post parameters: - name: app_id in: path required: true schema: type: string description: >- ID of the app whose Google Ads creative you want to generate or read. title: App Id description: >- ID of the app whose Google Ads creative you want to generate or read. example: 6820f3a4e7b91d003c45a1f2 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GoogleAdsVideoUploadPollRequest' responses: '200': description: The upload, with `video_id` filled in once YouTube has assigned it. content: application/json: schema: $ref: '#/components/schemas/GoogleAdsVideoUpload' '400': description: >- `upload_rn` is not a valid upload reference for this app's Google Ads account, or YouTube rejected the video or failed to process it. '401': description: Missing or invalid credentials. '403': description: >- You can't edit this app, the app does not exist, or you used a read-only or workspace API key. A missing app and an app you cannot reach are deliberately the same answer. '404': description: The app has no connected Google Ads account. '409': description: The workspace is on a Google Ads billing hold. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: >- The app has used up its 30 polls for the current minute, or Google Ads is rate limiting the account. Retry later. components: schemas: GoogleAdsVideoUploadPollRequest: properties: upload_rn: type: string title: Upload Rn description: >- The `upload_rn` that [Upload a Google Ads video](/api-reference/upload-a-google-ads-video) returned for this app. example: customers/1234567890/youTubeVideoUploads/AbC123xYz type: object required: - upload_rn title: GoogleAdsVideoUploadPollRequest description: The reference returned by an upload that was still processing. GoogleAdsVideoUpload: properties: video_id: type: string title: Video Id description: >- 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`. example: dQw4w9WgXcQ upload_rn: type: string title: Upload Rn description: >- Google's reference for the upload. Keep it until `video_id` is filled in, and pass it to [Poll a Google Ads video upload](/api-reference/poll-a-google-ads-video-upload). example: customers/1234567890/youTubeVideoUploads/AbC123xYz type: object required: - video_id - upload_rn title: GoogleAdsVideoUpload description: A video uploaded to YouTube for Google Ads. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: PersonalAccessTokenAuth: type: http scheme: bearer description: 'Personal access token, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.