you_tube_video_upload

Represents a video upload to YouTube using the Google Ads API.

Attributed resources
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

you_tube_video_upload.channel_id
Field description	Immutable. The destination YouTube channel ID for the video upload. Only mutable on YouTube video upload creation. If omitted, the video will be uploaded to the Google-managed YouTube channel associated with the Ads account.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

you_tube_video_upload.resource_name
Field description	Immutable. Resource name of the YouTube video upload.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

you_tube_video_upload.state
Field description	Output only. The current state of the YouTube video upload.
Category	`ATTRIBUTE`
Data Type	`ENUM FAILED PENDING PROCESSED REJECTED UNAVAILABLE UNKNOWN UNSPECIFIED UPLOADED`
Type URL	`google.ads.googleads.v23.enums.YouTubeVideoUploadStateEnum.YouTubeVideoUploadState`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

you_tube_video_upload.video_id
Field description	Output only. The YouTube video ID of the uploaded video.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

you_tube_video_upload.video_privacy
Field description	The privacy state of the video. Only mutable for videos uploaded to the advertiser owned (brand) YouTube channel. For videos uploaded to the Google-managed channels only UNLISTED privacy is allowed. Defaults to UNLISTED privacy if not specified.
Category	`ATTRIBUTE`
Data Type	`ENUM PUBLIC UNKNOWN UNLISTED UNSPECIFIED`
Type URL	`google.ads.googleads.v23.enums.YouTubeVideoPrivacyEnum.YouTubeVideoPrivacy`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

you_tube_video_upload.video_upload_id
Field description	Output only. The unique ID of the YouTube video upload.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-04-24 UTC.

Blog
Visit our blog for important announcements.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.
Discord
Join the Google Ads Discord server.