Skip to content

Commit 6db4527

Browse files
feat(youtube): update the API
#### youtube:v3 The following keys were added: - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.description - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.flatPath - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.httpMethod - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.id - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameterOrder - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.onBehalfOfContentOwner.description - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.onBehalfOfContentOwner.location - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.onBehalfOfContentOwner.type - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.part.description - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.part.location - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.part.repeated - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.part.type - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.videoIds.description - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.videoIds.location - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.videoIds.repeated - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.parameters.videoIds.type - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.path - resources.youtube.resources.v3.resources.videos.methods.batchGetStats.response.$ref - schemas.BatchGetStatsResponse.description - schemas.BatchGetStatsResponse.id - schemas.BatchGetStatsResponse.properties.etag.description - schemas.BatchGetStatsResponse.properties.etag.readOnly - schemas.BatchGetStatsResponse.properties.etag.type - schemas.BatchGetStatsResponse.properties.items.description - schemas.BatchGetStatsResponse.properties.items.items.$ref - schemas.BatchGetStatsResponse.properties.items.readOnly - schemas.BatchGetStatsResponse.properties.items.type - schemas.BatchGetStatsResponse.properties.kind.default - schemas.BatchGetStatsResponse.properties.kind.description - schemas.BatchGetStatsResponse.properties.kind.readOnly - schemas.BatchGetStatsResponse.properties.kind.type - schemas.BatchGetStatsResponse.type - schemas.VideoStat.description - schemas.VideoStat.id - schemas.VideoStat.properties.contentDetails.$ref - schemas.VideoStat.properties.contentDetails.description - schemas.VideoStat.properties.contentDetails.readOnly - schemas.VideoStat.properties.etag.description - schemas.VideoStat.properties.etag.readOnly - schemas.VideoStat.properties.etag.type - schemas.VideoStat.properties.kind.description - schemas.VideoStat.properties.kind.readOnly - schemas.VideoStat.properties.kind.type - schemas.VideoStat.properties.name.description - schemas.VideoStat.properties.name.readOnly - schemas.VideoStat.properties.name.type - schemas.VideoStat.properties.snippet.$ref - schemas.VideoStat.properties.snippet.description - schemas.VideoStat.properties.snippet.readOnly - schemas.VideoStat.properties.statistics.$ref - schemas.VideoStat.properties.statistics.description - schemas.VideoStat.properties.statistics.readOnly - schemas.VideoStat.properties.videoId.description - schemas.VideoStat.properties.videoId.readOnly - schemas.VideoStat.properties.videoId.type - schemas.VideoStat.type - schemas.VideoStatsContentDetails.description - schemas.VideoStatsContentDetails.id - schemas.VideoStatsContentDetails.properties.duration.description - schemas.VideoStatsContentDetails.properties.duration.format - schemas.VideoStatsContentDetails.properties.duration.readOnly - schemas.VideoStatsContentDetails.properties.duration.type - schemas.VideoStatsContentDetails.type - schemas.VideoStatsSnippet.description - schemas.VideoStatsSnippet.id - schemas.VideoStatsSnippet.properties.publishTime.description - schemas.VideoStatsSnippet.properties.publishTime.format - schemas.VideoStatsSnippet.properties.publishTime.readOnly - schemas.VideoStatsSnippet.properties.publishTime.type - schemas.VideoStatsSnippet.type - schemas.VideoStatsStatistics.description - schemas.VideoStatsStatistics.id - schemas.VideoStatsStatistics.properties.commentCount.description - schemas.VideoStatsStatistics.properties.commentCount.format - schemas.VideoStatsStatistics.properties.commentCount.readOnly - schemas.VideoStatsStatistics.properties.commentCount.type - schemas.VideoStatsStatistics.properties.likeCount.description - schemas.VideoStatsStatistics.properties.likeCount.format - schemas.VideoStatsStatistics.properties.likeCount.readOnly - schemas.VideoStatsStatistics.properties.likeCount.type - schemas.VideoStatsStatistics.properties.viewCount.description - schemas.VideoStatsStatistics.properties.viewCount.format - schemas.VideoStatsStatistics.properties.viewCount.readOnly - schemas.VideoStatsStatistics.properties.viewCount.type - schemas.VideoStatsStatistics.type
1 parent 0e2691e commit 6db4527

File tree

2 files changed

+464
-109
lines changed

2 files changed

+464
-109
lines changed

discovery/youtube-v3.json

Lines changed: 154 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4166,13 +4166,47 @@
41664166
}
41674167
}
41684168
}
4169+
},
4170+
"videos": {
4171+
"methods": {
4172+
"batchGetStats": {
4173+
"description": "Retrieves a batch of VideoStat resources, possibly filtered.",
4174+
"flatPath": "youtube/v3/videos:batchGetStats",
4175+
"httpMethod": "GET",
4176+
"id": "youtube.youtube.v3.videos.batchGetStats",
4177+
"parameterOrder": [],
4178+
"parameters": {
4179+
"onBehalfOfContentOwner": {
4180+
"description": "Optional. **Note:** This parameter is intended exclusively for YouTube content partners. The `onBehalfOfContentOwner` parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.",
4181+
"location": "query",
4182+
"type": "string"
4183+
},
4184+
"part": {
4185+
"description": "Required. The `**part**` parameter specifies a comma-separated list of one or more `videoStat` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a `videoStat` resource, the `statistics` property contains `view_count` and `like_count`. As such, if you set `**part=snippet**`, the API response will contain all of those properties.",
4186+
"location": "query",
4187+
"repeated": true,
4188+
"type": "string"
4189+
},
4190+
"videoIds": {
4191+
"description": "Required. Return videos with the given ids.",
4192+
"location": "query",
4193+
"repeated": true,
4194+
"type": "string"
4195+
}
4196+
},
4197+
"path": "youtube/v3/videos:batchGetStats",
4198+
"response": {
4199+
"$ref": "BatchGetStatsResponse"
4200+
}
4201+
}
4202+
}
41694203
}
41704204
}
41714205
}
41724206
}
41734207
}
41744208
},
4175-
"revision": "20250714",
4209+
"revision": "20251125",
41764210
"rootUrl": "https://youtube.googleapis.com/",
41774211
"schemas": {
41784212
"AbuseReport": {
@@ -4647,6 +4681,32 @@
46474681
},
46484682
"type": "object"
46494683
},
4684+
"BatchGetStatsResponse": {
4685+
"description": "Response for the Videos.stats API. Returns VideoStat information about a batch of videos. VideoStat contains a subset of the information in Video that is relevant to statistics and content details.",
4686+
"id": "BatchGetStatsResponse",
4687+
"properties": {
4688+
"etag": {
4689+
"description": "Output only. Etag of this resource.",
4690+
"readOnly": true,
4691+
"type": "string"
4692+
},
4693+
"items": {
4694+
"description": "Output only. The videos' stats information.",
4695+
"items": {
4696+
"$ref": "VideoStat"
4697+
},
4698+
"readOnly": true,
4699+
"type": "array"
4700+
},
4701+
"kind": {
4702+
"default": "youtube#batchGetStatsResponse",
4703+
"description": "Output only. Identifies what kind of resource this is. Value: the fixed string \"youtube#batchGetStatsResponse\".",
4704+
"readOnly": true,
4705+
"type": "string"
4706+
}
4707+
},
4708+
"type": "object"
4709+
},
46504710
"Caption": {
46514711
"description": "A *caption* resource represents a YouTube caption track. A caption track is associated with exactly one YouTube video.",
46524712
"id": "Caption",
@@ -12068,6 +12128,48 @@
1206812128
},
1206912129
"type": "object"
1207012130
},
12131+
"VideoStat": {
12132+
"description": "A *VideoStat* resource represents a YouTube video's stats.",
12133+
"id": "VideoStat",
12134+
"properties": {
12135+
"contentDetails": {
12136+
"$ref": "VideoStatsContentDetails",
12137+
"description": "Output only. The VideoStatsContentDetails object contains information about the video content, including the length of the video.",
12138+
"readOnly": true
12139+
},
12140+
"etag": {
12141+
"description": "Output only. Etag of this resource.",
12142+
"readOnly": true,
12143+
"type": "string"
12144+
},
12145+
"kind": {
12146+
"description": "Output only. Identifies what kind of resource this is. Value: the fixed string \"youtube#videoStats\".",
12147+
"readOnly": true,
12148+
"type": "string"
12149+
},
12150+
"name": {
12151+
"description": "Output only. Identifier. The resource name for the `VideoStats` resource, in the format `videoStats/{video_stat}`.",
12152+
"readOnly": true,
12153+
"type": "string"
12154+
},
12155+
"snippet": {
12156+
"$ref": "VideoStatsSnippet",
12157+
"description": "Output only. The VideoStatsSnippet object contains basic details about the video, such publish time.",
12158+
"readOnly": true
12159+
},
12160+
"statistics": {
12161+
"$ref": "VideoStatsStatistics",
12162+
"description": "Output only. The VideoStatsStatistics object contains statistics about the video.",
12163+
"readOnly": true
12164+
},
12165+
"videoId": {
12166+
"description": "Output only. The ID that YouTube uses to uniquely identify the video.",
12167+
"readOnly": true,
12168+
"type": "string"
12169+
}
12170+
},
12171+
"type": "object"
12172+
},
1207112173
"VideoStatistics": {
1207212174
"description": "Statistics about the video, such as the number of times the video was viewed or liked.",
1207312175
"id": "VideoStatistics",
@@ -12101,6 +12203,57 @@
1210112203
},
1210212204
"type": "object"
1210312205
},
12206+
"VideoStatsContentDetails": {
12207+
"description": "Details about the content of a YouTube Video. This is a subset of the information in VideoContentDetails specifically for the Videos.stats API.",
12208+
"id": "VideoStatsContentDetails",
12209+
"properties": {
12210+
"duration": {
12211+
"description": "Output only. The length of the video. The property value is a [`google.protobuf.Duration`](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration) object.",
12212+
"format": "google-duration",
12213+
"readOnly": true,
12214+
"type": "string"
12215+
}
12216+
},
12217+
"type": "object"
12218+
},
12219+
"VideoStatsSnippet": {
12220+
"description": "Basic details about a video. This is a subset of the information in VideoSnippet specifically for the Videos.stats API.",
12221+
"id": "VideoStatsSnippet",
12222+
"properties": {
12223+
"publishTime": {
12224+
"description": "Output only. The date and time that the video was uploaded. The property value is a [`google.protobuf.Timestamp`](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp) object.",
12225+
"format": "google-datetime",
12226+
"readOnly": true,
12227+
"type": "string"
12228+
}
12229+
},
12230+
"type": "object"
12231+
},
12232+
"VideoStatsStatistics": {
12233+
"description": "Statistics about the video, such as the number of times the video was viewed or liked.",
12234+
"id": "VideoStatsStatistics",
12235+
"properties": {
12236+
"commentCount": {
12237+
"description": "Output only. The number of comments for the video.",
12238+
"format": "int64",
12239+
"readOnly": true,
12240+
"type": "string"
12241+
},
12242+
"likeCount": {
12243+
"description": "Output only. The number of users who have indicated that they liked the video by giving it a positive rating.",
12244+
"format": "int64",
12245+
"readOnly": true,
12246+
"type": "string"
12247+
},
12248+
"viewCount": {
12249+
"description": "Output only. The number of times the video has been viewed.",
12250+
"format": "int64",
12251+
"readOnly": true,
12252+
"type": "string"
12253+
}
12254+
},
12255+
"type": "object"
12256+
},
1210412257
"VideoStatus": {
1210512258
"description": "Basic details about a video category, such as its localized title. Next Id: 19",
1210612259
"id": "VideoStatus",

0 commit comments

Comments
 (0)