@googleapis/youtube 33.0.0 → 34.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/v3.d.ts CHANGED
@@ -124,11 +124,11 @@ export declare namespace youtube_v3 {
124
124
  exception?: string[] | null;
125
125
  }
126
126
  /**
127
- * An *activity* resource contains information about an action that a particular channel, or user, has taken on YouTube.The actions reported in activity feeds include rating a video, sharing a video, marking a video as a favorite, commenting on a video, uploading a video, and so forth. Each activity resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.
127
+ * An `activity` resource contains information about an action that a particular channel, or user, has taken on YouTube. The actions reported in activity feeds include sharing a video, uploading a video, and so forth. Each `activity` resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.
128
128
  */
129
129
  export interface Schema$Activity {
130
130
  /**
131
- * The contentDetails object contains information about the content associated with the activity. For example, if the snippet.type value is videoRated, then the contentDetails object's content identifies the rated video.
131
+ * The `contentDetails` object contains information about the content associated with the activity. For example, if the `snippet.type` value is `videoRated`, then the `contentDetails` object's content identifies the rated video.
132
132
  */
133
133
  contentDetails?: Schema$ActivityContentDetails;
134
134
  /**
@@ -140,11 +140,11 @@ export declare namespace youtube_v3 {
140
140
  */
141
141
  id?: string | null;
142
142
  /**
143
- * Identifies what kind of resource this is. Value: the fixed string "youtube#activity".
143
+ * Identifies what kind of resource this is. Value: The fixed string `"youtube#activity"`.
144
144
  */
145
145
  kind?: string | null;
146
146
  /**
147
- * The snippet object contains basic details about the activity, including the activity's type and group ID.
147
+ * The `snippet` object contains basic details about the activity, including the activity's type and group ID.
148
148
  */
149
149
  snippet?: Schema$ActivitySnippet;
150
150
  }
@@ -153,47 +153,47 @@ export declare namespace youtube_v3 {
153
153
  */
154
154
  export interface Schema$ActivityContentDetails {
155
155
  /**
156
- * The bulletin object contains details about a channel bulletin post. This object is only present if the snippet.type is bulletin.
156
+ * The `bulletin` object contains details about a channel bulletin post. This object is only present if the `snippet.type` is `bulletin`.
157
157
  */
158
158
  bulletin?: Schema$ActivityContentDetailsBulletin;
159
159
  /**
160
- * The channelItem object contains details about a resource which was added to a channel. This property is only present if the snippet.type is channelItem.
160
+ * The `channelItem` object contains details about a resource which was added to a channel. This property is only present if the `snippet.type` is `channelItem`.
161
161
  */
162
162
  channelItem?: Schema$ActivityContentDetailsChannelItem;
163
163
  /**
164
- * The comment object contains information about a resource that received a comment. This property is only present if the snippet.type is comment.
164
+ * The `comment` object contains information about a resource that received a comment. This property is only present if the `snippet.type` is `comment`.
165
165
  */
166
166
  comment?: Schema$ActivityContentDetailsComment;
167
167
  /**
168
- * The favorite object contains information about a video that was marked as a favorite video. This property is only present if the snippet.type is favorite.
168
+ * The `favorite` object contains information about a video that was marked as a favorite video. This property is only present if the `snippet.type` is `favorite`. Deprecated: This property is no longer returned.
169
169
  */
170
170
  favorite?: Schema$ActivityContentDetailsFavorite;
171
171
  /**
172
- * The like object contains information about a resource that received a positive (like) rating. This property is only present if the snippet.type is like.
172
+ * The `like` object contains information about a resource that received a positive (like) rating. This property is only present if the `snippet.type` is `like`. Deprecated: This property is no longer returned.
173
173
  */
174
174
  like?: Schema$ActivityContentDetailsLike;
175
175
  /**
176
- * The playlistItem object contains information about a new playlist item. This property is only present if the snippet.type is playlistItem.
176
+ * The `playlistItem` object contains information about a new playlist item. This property is only present if the `snippet.type` is `playlistItem`.
177
177
  */
178
178
  playlistItem?: Schema$ActivityContentDetailsPlaylistItem;
179
179
  /**
180
- * The promotedItem object contains details about a resource which is being promoted. This property is only present if the snippet.type is promotedItem.
180
+ * The `promotedItem` object contains details about a resource which is being promoted. This property is only present if the `snippet.type` is `promotedItem`.
181
181
  */
182
182
  promotedItem?: Schema$ActivityContentDetailsPromotedItem;
183
183
  /**
184
- * The recommendation object contains information about a recommended resource. This property is only present if the snippet.type is recommendation.
184
+ * The `recommendation` object contains information about a recommended resource. This property is only present if the `snippet.type` is `recommendation`.
185
185
  */
186
186
  recommendation?: Schema$ActivityContentDetailsRecommendation;
187
187
  /**
188
- * The social object contains details about a social network post. This property is only present if the snippet.type is social.
188
+ * The `social` object contains details about a social network post. This property is only present if the `snippet.type` is `social`.
189
189
  */
190
190
  social?: Schema$ActivityContentDetailsSocial;
191
191
  /**
192
- * The subscription object contains information about a channel that a user subscribed to. This property is only present if the snippet.type is subscription.
192
+ * The `subscription` object contains information about a channel that a user subscribed to. This property is only present if the `snippet.type` is `subscription`. Deprecated: This property is no longer returned.
193
193
  */
194
194
  subscription?: Schema$ActivityContentDetailsSubscription;
195
195
  /**
196
- * The upload object contains information about the uploaded video. This property is only present if the snippet.type is upload.
196
+ * The `upload` object contains information about the uploaded video. This property is only present if the `snippet.type` is `upload`.
197
197
  */
198
198
  upload?: Schema$ActivityContentDetailsUpload;
199
199
  }
@@ -202,7 +202,7 @@ export declare namespace youtube_v3 {
202
202
  */
203
203
  export interface Schema$ActivityContentDetailsBulletin {
204
204
  /**
205
- * The resourceId object contains information that identifies the resource associated with a bulletin post. @mutable youtube.activities.insert
205
+ * The `resourceId` object contains information that identifies the resource associated with a bulletin post. @mutable youtube.activities.insert
206
206
  */
207
207
  resourceId?: Schema$ResourceId;
208
208
  }
@@ -211,7 +211,7 @@ export declare namespace youtube_v3 {
211
211
  */
212
212
  export interface Schema$ActivityContentDetailsChannelItem {
213
213
  /**
214
- * The resourceId object contains information that identifies the resource that was added to the channel.
214
+ * The `resourceId` object contains information that identifies the resource that was added to the channel.
215
215
  */
216
216
  resourceId?: Schema$ResourceId;
217
217
  }
@@ -220,25 +220,25 @@ export declare namespace youtube_v3 {
220
220
  */
221
221
  export interface Schema$ActivityContentDetailsComment {
222
222
  /**
223
- * The resourceId object contains information that identifies the resource associated with the comment.
223
+ * The `resourceId` object contains information that identifies the resource associated with the comment.
224
224
  */
225
225
  resourceId?: Schema$ResourceId;
226
226
  }
227
227
  /**
228
- * Information about a video that was marked as a favorite video.
228
+ * Information about a video that was marked as a favorite video. Deprecated: This resource is no longer returned.
229
229
  */
230
230
  export interface Schema$ActivityContentDetailsFavorite {
231
231
  /**
232
- * The resourceId object contains information that identifies the resource that was marked as a favorite.
232
+ * The `resourceId` object contains information that identifies the resource that was marked as a favorite.
233
233
  */
234
234
  resourceId?: Schema$ResourceId;
235
235
  }
236
236
  /**
237
- * Information about a resource that received a positive (like) rating.
237
+ * Information about a resource that received a positive (like) rating. Deprecated: This resource is no longer returned.
238
238
  */
239
239
  export interface Schema$ActivityContentDetailsLike {
240
240
  /**
241
- * The resourceId object contains information that identifies the rated resource.
241
+ * The `resourceId` object contains information that identifies the rated resource.
242
242
  */
243
243
  resourceId?: Schema$ResourceId;
244
244
  }
@@ -255,7 +255,7 @@ export declare namespace youtube_v3 {
255
255
  */
256
256
  playlistItemId?: string | null;
257
257
  /**
258
- * The resourceId object contains information about the resource that was added to the playlist.
258
+ * The `resourceId` object contains information about the resource that was added to the playlist.
259
259
  */
260
260
  resourceId?: Schema$ResourceId;
261
261
  }
@@ -313,11 +313,11 @@ export declare namespace youtube_v3 {
313
313
  */
314
314
  reason?: string | null;
315
315
  /**
316
- * The resourceId object contains information that identifies the recommended resource.
316
+ * The `resourceId` object contains information that identifies the recommended resource.
317
317
  */
318
318
  resourceId?: Schema$ResourceId;
319
319
  /**
320
- * The seedResourceId object contains information about the resource that caused the recommendation.
320
+ * The `seedResourceId` object contains information about the resource that caused the recommendation.
321
321
  */
322
322
  seedResourceId?: Schema$ResourceId;
323
323
  }
@@ -338,7 +338,7 @@ export declare namespace youtube_v3 {
338
338
  */
339
339
  referenceUrl?: string | null;
340
340
  /**
341
- * The resourceId object encapsulates information that identifies the resource associated with a social network post.
341
+ * The `resourceId` object encapsulates information that identifies the resource associated with a social network post.
342
342
  */
343
343
  resourceId?: Schema$ResourceId;
344
344
  /**
@@ -347,11 +347,11 @@ export declare namespace youtube_v3 {
347
347
  type?: string | null;
348
348
  }
349
349
  /**
350
- * Information about a channel that a user subscribed to.
350
+ * Information about a channel that a user subscribed to. Deprecated: This resource is no longer returned.
351
351
  */
352
352
  export interface Schema$ActivityContentDetailsSubscription {
353
353
  /**
354
- * The resourceId object contains information that identifies the resource that the user subscribed to.
354
+ * The `resourceId` object contains information that identifies the resource that the user subscribed to.
355
355
  */
356
356
  resourceId?: Schema$ResourceId;
357
357
  }
@@ -413,7 +413,7 @@ export declare namespace youtube_v3 {
413
413
  */
414
414
  description?: string | null;
415
415
  /**
416
- * The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user rates a video and marks the same video as a favorite, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same groupId value.
416
+ * The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user uploads a video and watches the same video, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same `groupId` value.
417
417
  */
418
418
  groupId?: string | null;
419
419
  /**
@@ -433,6 +433,84 @@ export declare namespace youtube_v3 {
433
433
  */
434
434
  type?: string | null;
435
435
  }
436
+ /**
437
+ * Common proto for Live and VOD geo-restrictions
438
+ */
439
+ export interface Schema$AvailabilityConfig {
440
+ /**
441
+ * Video is available in all regions except the ones specified in the config.
442
+ */
443
+ globalConfig?: Schema$AvailabilityConfigGlobalConfig;
444
+ /**
445
+ * Video is available in the specified regions only.
446
+ */
447
+ regionsConfig?: Schema$AvailabilityConfigRegionsConfig;
448
+ }
449
+ /**
450
+ * Video is available in all regions except the ones specified in the excluded_region_codes list.
451
+ */
452
+ export interface Schema$AvailabilityConfigGlobalConfig {
453
+ /**
454
+ * Optional. Regions where video is blocked
455
+ */
456
+ excludedRegionCodes?: string[] | null;
457
+ /**
458
+ * Default time window where video is available for all non-blocked regions Not supported for upcoming / active live broadcasts. If start time is unspecified, video is already available If end time is unspecified, video is available forever Specified start and end times cannot be more than five years in the future.
459
+ */
460
+ interval?: Schema$Interval;
461
+ }
462
+ /**
463
+ * Video is available in the specified regions only.
464
+ */
465
+ export interface Schema$AvailabilityConfigRegionsConfig {
466
+ /**
467
+ * Required. List of regions and time windows where video is available. If a region is specified multiple times, the union of all intervals is used.
468
+ */
469
+ regionIntervals?: Schema$AvailabilityConfigRegionsConfigRegionInterval[];
470
+ }
471
+ /**
472
+ * Region and time window where video is available for the region.
473
+ */
474
+ export interface Schema$AvailabilityConfigRegionsConfigRegionInterval {
475
+ /**
476
+ * Time window where video is available for the region. Not supported for upcoming / active live broadcasts. If start time is unspecified, video is already available If end time is unspecified, video is available forever Specified start and end times cannot be more than five years in the future.
477
+ */
478
+ interval?: Schema$Interval;
479
+ /**
480
+ * Required. Region where video is available
481
+ */
482
+ regionCode?: string | null;
483
+ }
484
+ /**
485
+ * 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. BatchGetStats is intentionally not atomic to provide a better user experience. BatchGetStatsResponse returns a summary to help users understand the outcome of the operation.
486
+ */
487
+ export interface Schema$BatchGetStatsResponse {
488
+ /**
489
+ * Etag of this resource.
490
+ */
491
+ etag?: string | null;
492
+ /**
493
+ * The videos' stats information.
494
+ */
495
+ items?: Schema$VideoStat[];
496
+ /**
497
+ * Identifies what kind of resource this is. Value: the fixed string "youtube#batchGetStatsResponse".
498
+ */
499
+ kind?: string | null;
500
+ }
501
+ /**
502
+ * Details about the brand partner linked to the video for Creator Initiated Linking (CIL). Next ID: 6
503
+ */
504
+ export interface Schema$BrandPartner {
505
+ /**
506
+ * Required. Channel handle, must begin with "@"
507
+ */
508
+ channelHandle?: string | null;
509
+ /**
510
+ * Required. External Channel ID, must begin with "UC"
511
+ */
512
+ channelId?: string | null;
513
+ }
436
514
  /**
437
515
  * A *caption* resource represents a YouTube caption track. A caption track is associated with exactly one YouTube video.
438
516
  */
@@ -1048,6 +1126,27 @@ export declare namespace youtube_v3 {
1048
1126
  privacyStatus?: string | null;
1049
1127
  selfDeclaredMadeForKids?: boolean | null;
1050
1128
  }
1129
+ /**
1130
+ * Information specific to a creator in an affiliate program linked to a YouTube channel.
1131
+ */
1132
+ export interface Schema$ChannelToAffiliateProgramLinkDetails {
1133
+ /**
1134
+ * Required. Google Merchant Center ID of the partner.
1135
+ */
1136
+ merchantId?: string | null;
1137
+ /**
1138
+ * Required. Affiliate program status.
1139
+ */
1140
+ programStatus?: string | null;
1141
+ /**
1142
+ * Optional. Reason for the last update of the affiliate program status.
1143
+ */
1144
+ statusUpdateReason?: string | null;
1145
+ /**
1146
+ * Optional. Timestamp when the affiliate program status was last updated.
1147
+ */
1148
+ statusUpdateTime?: string | null;
1149
+ }
1051
1150
  /**
1052
1151
  * Freebase topic information related to the channel.
1053
1152
  */
@@ -1911,6 +2010,19 @@ export declare namespace youtube_v3 {
1911
2010
  */
1912
2011
  streamName?: string | null;
1913
2012
  }
2013
+ /**
2014
+ * Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.
2015
+ */
2016
+ export interface Schema$Interval {
2017
+ /**
2018
+ * Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
2019
+ */
2020
+ endTime?: string | null;
2021
+ /**
2022
+ * Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
2023
+ */
2024
+ startTime?: string | null;
2025
+ }
1914
2026
  /**
1915
2027
  * Describes an invideo branding.
1916
2028
  */
@@ -2016,6 +2128,10 @@ export declare namespace youtube_v3 {
2016
2128
  * Detailed settings of a broadcast.
2017
2129
  */
2018
2130
  export interface Schema$LiveBroadcastContentDetails {
2131
+ /**
2132
+ * Optional. The broadcast's availability config. Used to set specific region availability or block specific regions It is optional - if not set, it is not enforced.
2133
+ */
2134
+ availabilityConfig?: Schema$AvailabilityConfig;
2019
2135
  /**
2020
2136
  * This value uniquely identifies the live stream bound to the broadcast.
2021
2137
  */
@@ -2446,7 +2562,7 @@ export declare namespace youtube_v3 {
2446
2562
  */
2447
2563
  export interface Schema$LiveChatMessageSnippet {
2448
2564
  /**
2449
- * The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
2565
+ * The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
2450
2566
  */
2451
2567
  authorChannelId?: string | null;
2452
2568
  /**
@@ -3762,6 +3878,10 @@ export declare namespace youtube_v3 {
3762
3878
  * Basic information about a third party account link, including its type and type-specific information.
3763
3879
  */
3764
3880
  export interface Schema$ThirdPartyLinkSnippet {
3881
+ /**
3882
+ * Information specific to a link between a channel and an affiliate program of a partner.
3883
+ */
3884
+ channelToAffiliateProgramLink?: Schema$ChannelToAffiliateProgramLinkDetails;
3765
3885
  /**
3766
3886
  * Information specific to a link between a channel and a store on a merchandising platform.
3767
3887
  */
@@ -3854,6 +3974,7 @@ export declare namespace youtube_v3 {
3854
3974
  * Age restriction details related to a video. This data can only be retrieved by the video owner.
3855
3975
  */
3856
3976
  ageGating?: Schema$VideoAgeGating;
3977
+ brandPartner?: Schema$BrandPartner;
3857
3978
  /**
3858
3979
  * The contentDetails object contains information about the video content, including the length of the video and its aspect ratio.
3859
3980
  */
@@ -4525,6 +4646,35 @@ export declare namespace youtube_v3 {
4525
4646
  */
4526
4647
  title?: string | null;
4527
4648
  }
4649
+ /**
4650
+ * A *VideoStat* resource represents a YouTube video's stats.
4651
+ */
4652
+ export interface Schema$VideoStat {
4653
+ /**
4654
+ * Output only. The VideoStatsContentDetails object contains information about the video content, including the length of the video.
4655
+ */
4656
+ contentDetails?: Schema$VideoStatsContentDetails;
4657
+ /**
4658
+ * Output only. Etag of this resource.
4659
+ */
4660
+ etag?: string | null;
4661
+ /**
4662
+ * Output only. The ID that YouTube uses to uniquely identify the video.
4663
+ */
4664
+ id?: string | null;
4665
+ /**
4666
+ * Output only. Identifies what kind of resource this is. Value: the fixed string "youtube#videoStats".
4667
+ */
4668
+ kind?: string | null;
4669
+ /**
4670
+ * Output only. The VideoStatsSnippet object contains basic details about the video, such publish time.
4671
+ */
4672
+ snippet?: Schema$VideoStatsSnippet;
4673
+ /**
4674
+ * Output only. The VideoStatsStatistics object contains statistics about the video.
4675
+ */
4676
+ statistics?: Schema$VideoStatsStatistics;
4677
+ }
4528
4678
  /**
4529
4679
  * Statistics about the video, such as the number of times the video was viewed or liked.
4530
4680
  */
@@ -4550,6 +4700,41 @@ export declare namespace youtube_v3 {
4550
4700
  */
4551
4701
  viewCount?: string | null;
4552
4702
  }
4703
+ /**
4704
+ * Details about the content of a YouTube Video. This is a subset of the information in VideoContentDetails specifically for the Videos.stats API.
4705
+ */
4706
+ export interface Schema$VideoStatsContentDetails {
4707
+ /**
4708
+ * 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.
4709
+ */
4710
+ duration?: string | null;
4711
+ }
4712
+ /**
4713
+ * Basic details about a video. This is a subset of the information in VideoSnippet specifically for the Videos.stats API.
4714
+ */
4715
+ export interface Schema$VideoStatsSnippet {
4716
+ /**
4717
+ * 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.
4718
+ */
4719
+ publishTime?: string | null;
4720
+ }
4721
+ /**
4722
+ * Statistics about the video, such as the number of times the video was viewed or liked.
4723
+ */
4724
+ export interface Schema$VideoStatsStatistics {
4725
+ /**
4726
+ * Output only. The number of comments for the video.
4727
+ */
4728
+ commentCount?: string | null;
4729
+ /**
4730
+ * Output only. The number of users who have indicated that they liked the video by giving it a positive rating.
4731
+ */
4732
+ likeCount?: string | null;
4733
+ /**
4734
+ * Output only. The number of times the video has been viewed.
4735
+ */
4736
+ viewCount?: string | null;
4737
+ }
4553
4738
  /**
4554
4739
  * Basic details about a video category, such as its localized title. Next Id: 19
4555
4740
  */
@@ -11730,6 +11915,77 @@ export declare namespace youtube_v3 {
11730
11915
  export class Resource$Videos {
11731
11916
  context: APIRequestContext;
11732
11917
  constructor(context: APIRequestContext);
11918
+ /**
11919
+ * Retrieves a batch of VideoStat resources, possibly filtered. BatchGetStats is intentionally not atomic to provide a better user experience.
11920
+ * @example
11921
+ * ```js
11922
+ * // Before running the sample:
11923
+ * // - Enable the API at:
11924
+ * // https://console.developers.google.com/apis/api/youtube.googleapis.com
11925
+ * // - Login into gcloud by running:
11926
+ * // ```sh
11927
+ * // $ gcloud auth application-default login
11928
+ * // ```
11929
+ * // - Install the npm module by running:
11930
+ * // ```sh
11931
+ * // $ npm install googleapis
11932
+ * // ```
11933
+ *
11934
+ * const {google} = require('googleapis');
11935
+ * const youtube = google.youtube('v3');
11936
+ *
11937
+ * async function main() {
11938
+ * const auth = new google.auth.GoogleAuth({
11939
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11940
+ * scopes: [
11941
+ * 'https://www.googleapis.com/auth/youtube',
11942
+ * 'https://www.googleapis.com/auth/youtube.force-ssl',
11943
+ * 'https://www.googleapis.com/auth/youtube.readonly',
11944
+ * 'https://www.googleapis.com/auth/youtubepartner',
11945
+ * ],
11946
+ * });
11947
+ *
11948
+ * // Acquire an auth client, and bind it to all future calls
11949
+ * const authClient = await auth.getClient();
11950
+ * google.options({auth: authClient});
11951
+ *
11952
+ * // Do the magic
11953
+ * const res = await youtube.videos.batchGetStats({
11954
+ * // Required. Return videos with the given ids. The number of IDs specified cannot exceed 50.
11955
+ * id: 'placeholder-value',
11956
+ * // 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.
11957
+ * onBehalfOfContentOwner: 'placeholder-value',
11958
+ * // 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.
11959
+ * part: 'placeholder-value',
11960
+ * });
11961
+ * console.log(res.data);
11962
+ *
11963
+ * // Example response
11964
+ * // {
11965
+ * // "etag": "my_etag",
11966
+ * // "items": [],
11967
+ * // "kind": "my_kind"
11968
+ * // }
11969
+ * }
11970
+ *
11971
+ * main().catch(e => {
11972
+ * console.error(e);
11973
+ * throw e;
11974
+ * });
11975
+ *
11976
+ * ```
11977
+ *
11978
+ * @param params - Parameters for request
11979
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
11980
+ * @param callback - Optional callback that handles the response.
11981
+ * @returns A promise if used with async/await, or void if used with a callback.
11982
+ */
11983
+ batchGetStats(params: Params$Resource$Videos$Batchgetstats, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
11984
+ batchGetStats(params?: Params$Resource$Videos$Batchgetstats, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$BatchGetStatsResponse>>;
11985
+ batchGetStats(params: Params$Resource$Videos$Batchgetstats, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
11986
+ batchGetStats(params: Params$Resource$Videos$Batchgetstats, options: MethodOptions | BodyResponseCallback<Schema$BatchGetStatsResponse>, callback: BodyResponseCallback<Schema$BatchGetStatsResponse>): void;
11987
+ batchGetStats(params: Params$Resource$Videos$Batchgetstats, callback: BodyResponseCallback<Schema$BatchGetStatsResponse>): void;
11988
+ batchGetStats(callback: BodyResponseCallback<Schema$BatchGetStatsResponse>): void;
11733
11989
  /**
11734
11990
  * Deletes a resource.
11735
11991
  * @example
@@ -11913,6 +12169,7 @@ export declare namespace youtube_v3 {
11913
12169
  * // request body parameters
11914
12170
  * // {
11915
12171
  * // "ageGating": {},
12172
+ * // "brandPartner": {},
11916
12173
  * // "contentDetails": {},
11917
12174
  * // "etag": "my_etag",
11918
12175
  * // "fileDetails": {},
@@ -11943,6 +12200,7 @@ export declare namespace youtube_v3 {
11943
12200
  * // Example response
11944
12201
  * // {
11945
12202
  * // "ageGating": {},
12203
+ * // "brandPartner": {},
11946
12204
  * // "contentDetails": {},
11947
12205
  * // "etag": "my_etag",
11948
12206
  * // "fileDetails": {},
@@ -12255,6 +12513,7 @@ export declare namespace youtube_v3 {
12255
12513
  * // request body parameters
12256
12514
  * // {
12257
12515
  * // "ageGating": {},
12516
+ * // "brandPartner": {},
12258
12517
  * // "contentDetails": {},
12259
12518
  * // "etag": "my_etag",
12260
12519
  * // "fileDetails": {},
@@ -12281,6 +12540,7 @@ export declare namespace youtube_v3 {
12281
12540
  * // Example response
12282
12541
  * // {
12283
12542
  * // "ageGating": {},
12543
+ * // "brandPartner": {},
12284
12544
  * // "contentDetails": {},
12285
12545
  * // "etag": "my_etag",
12286
12546
  * // "fileDetails": {},
@@ -12321,6 +12581,20 @@ export declare namespace youtube_v3 {
12321
12581
  update(params: Params$Resource$Videos$Update, callback: BodyResponseCallback<Schema$Video>): void;
12322
12582
  update(callback: BodyResponseCallback<Schema$Video>): void;
12323
12583
  }
12584
+ export interface Params$Resource$Videos$Batchgetstats extends StandardParameters {
12585
+ /**
12586
+ * Required. Return videos with the given ids. The number of IDs specified cannot exceed 50.
12587
+ */
12588
+ id?: string[];
12589
+ /**
12590
+ * 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.
12591
+ */
12592
+ onBehalfOfContentOwner?: string;
12593
+ /**
12594
+ * 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.
12595
+ */
12596
+ part?: string[];
12597
+ }
12324
12598
  export interface Params$Resource$Videos$Delete extends StandardParameters {
12325
12599
  /**
12326
12600
  *
@@ -12737,92 +13011,6 @@ export declare namespace youtube_v3 {
12737
13011
  context: APIRequestContext;
12738
13012
  liveChat: Resource$Youtube$V3$Livechat;
12739
13013
  constructor(context: APIRequestContext);
12740
- /**
12741
- * Updates an existing resource.
12742
- * @example
12743
- * ```js
12744
- * // Before running the sample:
12745
- * // - Enable the API at:
12746
- * // https://console.developers.google.com/apis/api/youtube.googleapis.com
12747
- * // - Login into gcloud by running:
12748
- * // ```sh
12749
- * // $ gcloud auth application-default login
12750
- * // ```
12751
- * // - Install the npm module by running:
12752
- * // ```sh
12753
- * // $ npm install googleapis
12754
- * // ```
12755
- *
12756
- * const {google} = require('googleapis');
12757
- * const youtube = google.youtube('v3');
12758
- *
12759
- * async function main() {
12760
- * const auth = new google.auth.GoogleAuth({
12761
- * // Scopes can be specified either as an array or as a single, space-delimited string.
12762
- * scopes: [],
12763
- * });
12764
- *
12765
- * // Acquire an auth client, and bind it to all future calls
12766
- * const authClient = await auth.getClient();
12767
- * google.options({auth: authClient});
12768
- *
12769
- * // Do the magic
12770
- * const res = await youtube.youtube.v3.updateCommentThreads({
12771
- * // The *part* parameter specifies a comma-separated list of commentThread resource properties that the API response will include. You must at least include the snippet part in the parameter value since that part contains all of the properties that the API request can update.
12772
- * part: 'placeholder-value',
12773
- *
12774
- * // Request body metadata
12775
- * requestBody: {
12776
- * // request body parameters
12777
- * // {
12778
- * // "etag": "my_etag",
12779
- * // "id": "my_id",
12780
- * // "kind": "my_kind",
12781
- * // "replies": {},
12782
- * // "snippet": {}
12783
- * // }
12784
- * },
12785
- * });
12786
- * console.log(res.data);
12787
- *
12788
- * // Example response
12789
- * // {
12790
- * // "etag": "my_etag",
12791
- * // "id": "my_id",
12792
- * // "kind": "my_kind",
12793
- * // "replies": {},
12794
- * // "snippet": {}
12795
- * // }
12796
- * }
12797
- *
12798
- * main().catch(e => {
12799
- * console.error(e);
12800
- * throw e;
12801
- * });
12802
- *
12803
- * ```
12804
- *
12805
- * @param params - Parameters for request
12806
- * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
12807
- * @param callback - Optional callback that handles the response.
12808
- * @returns A promise if used with async/await, or void if used with a callback.
12809
- */
12810
- updateCommentThreads(params: Params$Resource$Youtube$V3$Updatecommentthreads, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
12811
- updateCommentThreads(params?: Params$Resource$Youtube$V3$Updatecommentthreads, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$CommentThread>>;
12812
- updateCommentThreads(params: Params$Resource$Youtube$V3$Updatecommentthreads, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
12813
- updateCommentThreads(params: Params$Resource$Youtube$V3$Updatecommentthreads, options: MethodOptions | BodyResponseCallback<Schema$CommentThread>, callback: BodyResponseCallback<Schema$CommentThread>): void;
12814
- updateCommentThreads(params: Params$Resource$Youtube$V3$Updatecommentthreads, callback: BodyResponseCallback<Schema$CommentThread>): void;
12815
- updateCommentThreads(callback: BodyResponseCallback<Schema$CommentThread>): void;
12816
- }
12817
- export interface Params$Resource$Youtube$V3$Updatecommentthreads extends StandardParameters {
12818
- /**
12819
- * The *part* parameter specifies a comma-separated list of commentThread resource properties that the API response will include. You must at least include the snippet part in the parameter value since that part contains all of the properties that the API request can update.
12820
- */
12821
- part?: string[];
12822
- /**
12823
- * Request body metadata
12824
- */
12825
- requestBody?: Schema$CommentThread;
12826
13014
  }
12827
13015
  export class Resource$Youtube$V3$Livechat {
12828
13016
  context: APIRequestContext;