openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 382 kB
JSON
{"openapi":"3.0.0","servers":[{"url":"https://youtube.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"The YouTube Data API v3 is an API that provides access to YouTube data, such as videos, playlists, and channels.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"YouTube Data API v3","version":"v3","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"x-origin":[{"format":"google","url":"https://youtube.googleapis.com/$discovery/rest?version=v3","version":"v1"}],"x-providerName":"googleapis.com","x-serviceName":"youtube"},"externalDocs":{"url":"https://developers.google.com/youtube/"},"tags":[{"name":"abuseReports"},{"name":"activities"},{"name":"captions"},{"name":"channelBanners"},{"name":"channels"},{"name":"channelSections"},{"name":"comments"},{"name":"commentThreads"},{"name":"i18nLanguages"},{"name":"i18nRegions"},{"name":"liveBroadcasts"},{"name":"liveChatBans"},{"name":"liveChatMessages"},{"name":"liveChatModerators"},{"name":"liveStreams"},{"name":"members"},{"name":"membershipsLevels"},{"name":"playlistImages"},{"name":"playlistItems"},{"name":"playlists"},{"name":"search"},{"name":"subscriptions"},{"name":"superChatEvents"},{"name":"tests"},{"name":"thirdPartyLinks"},{"name":"thumbnails"},{"name":"videoAbuseReportReasons"},{"name":"videoCategories"},{"name":"videos"},{"name":"watermarks"},{"name":"youtube"}],"paths":{"/youtube/v3/abuseReports":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Inserts a new resource into this collection.","operationId":"youtube.abuseReports.insert","parameters":[{"description":"The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbuseReport"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbuseReport"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["abuseReports"]}},"/youtube/v3/activities":{"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.activities.list","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more activity 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 an activity resource, the snippet property contains other properties that identify the type of activity, a display title for the activity, and so forth. If you set *part=snippet*, the API response will also contain all of those nested properties.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"in":"query","name":"channelId","schema":{"type":"string"}},{"in":"query","name":"home","schema":{"type":"boolean"}},{"description":"The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.","in":"query","name":"maxResults","schema":{"maximum":50,"minimum":0,"type":"integer"}},{"in":"query","name":"mine","schema":{"type":"boolean"}},{"description":"The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.","in":"query","name":"pageToken","schema":{"type":"string"}},{"in":"query","name":"publishedAfter","schema":{"type":"string"}},{"in":"query","name":"publishedBefore","schema":{"type":"string"}},{"in":"query","name":"regionCode","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityListResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.readonly"],"Oauth2c":["https://www.googleapis.com/auth/youtube.readonly"]}],"tags":["activities"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/youtube/v3/captions":{"delete":{"description":"Deletes a resource.","operationId":"youtube.captions.delete","parameters":[{"in":"query","name":"id","required":true,"schema":{"type":"string"}},{"description":"ID of the Google+ Page for the channel that the request is be on behalf of","in":"query","name":"onBehalfOf","schema":{"type":"string"}},{"description":"*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 actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["captions"]},"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.captions.list","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Returns the captions for the specified video.","in":"query","name":"videoId","required":true,"schema":{"type":"string"}},{"description":"Returns the captions with the given IDs for Stubby or Apiary.","explode":true,"in":"query","name":"id","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"ID of the Google+ Page for the channel that the request is on behalf of.","in":"query","name":"onBehalfOf","schema":{"type":"string"}},{"description":"*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 actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptionListResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["captions"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Inserts a new resource into this collection.","operationId":"youtube.captions.insert","parameters":[{"description":"The *part* parameter specifies the caption resource parts that the API response will include. Set the parameter value to snippet.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"ID of the Google+ Page for the channel that the request is be on behalf of","in":"query","name":"onBehalfOf","schema":{"type":"string"}},{"description":"*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 actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}},{"description":"Extra parameter to allow automatically syncing the uploaded caption/transcript with the audio.","in":"query","name":"sync","schema":{"type":"boolean"}}],"requestBody":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/Caption"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Caption"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Caption"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["captions"]},"put":{"description":"Updates an existing resource.","operationId":"youtube.captions.update","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"ID of the Google+ Page for the channel that the request is on behalf of.","in":"query","name":"onBehalfOf","schema":{"type":"string"}},{"description":"*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 actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}},{"description":"Extra parameter to allow automatically syncing the uploaded caption/transcript with the audio.","in":"query","name":"sync","schema":{"type":"boolean"}}],"requestBody":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/Caption"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Caption"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Caption"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["captions"]}},"/youtube/v3/captions/{id}":{"get":{"description":"Downloads a caption track.","operationId":"youtube.captions.download","parameters":[{"description":"The ID of the caption track to download, required for One Platform.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"ID of the Google+ Page for the channel that the request is be on behalf of","in":"query","name":"onBehalfOf","schema":{"type":"string"}},{"description":"*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 actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}},{"description":"Convert the captions into this format. Supported options are sbv, srt, and vtt.","in":"query","name":"tfmt","schema":{"type":"string"}},{"description":"tlang is the language code; machine translate the captions into this language.","in":"query","name":"tlang","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["captions"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/youtube/v3/channelBanners/insert":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Inserts a new resource into this collection.","operationId":"youtube.channelBanners.insert","parameters":[{"description":"Unused, channel_id is currently derived from the security context of the requestor.","in":"query","name":"channelId","schema":{"type":"string"}},{"description":"*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 actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}},{"description":"This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.","in":"query","name":"onBehalfOfContentOwnerChannel","schema":{"type":"string"}}],"requestBody":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/ChannelBannerResource"}},"image/jpeg":{"schema":{"$ref":"#/components/schemas/ChannelBannerResource"}},"image/png":{"schema":{"$ref":"#/components/schemas/ChannelBannerResource"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelBannerResource"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.upload"],"Oauth2c":["https://www.googleapis.com/auth/youtube.upload"]}],"tags":["channelBanners"]}},"/youtube/v3/channelSections":{"delete":{"description":"Deletes a resource.","operationId":"youtube.channelSections.delete","parameters":[{"in":"query","name":"id","required":true,"schema":{"type":"string"}},{"description":"*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.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["channelSections"]},"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.channelSections.list","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more channelSection resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, and contentDetails. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a channelSection resource, the snippet property contains other properties, such as a display title for the channelSection. If you set *part=snippet*, the API response will also contain all of those nested properties.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Return the ChannelSections owned by the specified channel ID.","in":"query","name":"channelId","schema":{"type":"string"}},{"description":"Return content in specified language","in":"query","name":"hl","schema":{"type":"string"}},{"description":"Return the ChannelSections with the given IDs for Stubby or Apiary.","explode":true,"in":"query","name":"id","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Return the ChannelSections owned by the authenticated user.","in":"query","name":"mine","schema":{"type":"boolean"}},{"description":"*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.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelSectionListResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.readonly"],"Oauth2c":["https://www.googleapis.com/auth/youtube.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["channelSections"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Inserts a new resource into this collection.","operationId":"youtube.channelSections.insert","parameters":[{"description":"The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part names that you can include in the parameter value are snippet and contentDetails.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"*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.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}},{"description":"This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.","in":"query","name":"onBehalfOfContentOwnerChannel","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelSection"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelSection"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["channelSections"]},"put":{"description":"Updates an existing resource.","operationId":"youtube.channelSections.update","parameters":[{"description":"The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part names that you can include in the parameter value are snippet and contentDetails.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"*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.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelSection"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelSection"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["channelSections"]}},"/youtube/v3/channels":{"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.channels.list","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more channel 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 channel resource, the contentDetails property contains other properties, such as the uploads properties. As such, if you set *part=contentDetails*, the API response will also contain all of those nested properties.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Return the channels within the specified guide category ID.","in":"query","name":"categoryId","schema":{"type":"string"}},{"description":"Return the channel associated with a YouTube handle.","in":"query","name":"forHandle","schema":{"type":"string"}},{"description":"Return the channel associated with a YouTube username.","in":"query","name":"forUsername","schema":{"type":"string"}},{"description":"Stands for \"host language\". Specifies the localization language of the metadata to be filled into snippet.localized. The field is filled with the default metadata if there is no localization in the specified language. The parameter value must be a language code included in the list returned by the i18nLanguages.list method (e.g. en_US, es_MX).","in":"query","name":"hl","schema":{"type":"string"}},{"description":"Return the channels with the specified IDs.","explode":true,"in":"query","name":"id","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Return the channels managed by the authenticated user.","in":"query","name":"managedByMe","schema":{"type":"boolean"}},{"description":"The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.","in":"query","name":"maxResults","schema":{"maximum":50,"minimum":0,"type":"integer"}},{"description":"Return the ids of channels owned by the authenticated user.","in":"query","name":"mine","schema":{"type":"boolean"}},{"description":"Return the channels subscribed to the authenticated user","in":"query","name":"mySubscribers","schema":{"type":"boolean"}},{"description":"*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.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}},{"description":"The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelListResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.readonly"],"Oauth2c":["https://www.googleapis.com/auth/youtube.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner-channel-audit"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner-channel-audit"]}],"tags":["channels"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Updates an existing resource.","operationId":"youtube.channels.update","parameters":[{"description":"The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The API currently only allows the parameter value to be set to either brandingSettings or invideoPromotion. (You cannot update both of those parts with a single request.) Note that this method overrides the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The *onBehalfOfContentOwner* parameter indicates that the authenticated user 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 actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner.","in":"query","name":"onBehalfOfContentOwner","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Channel"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Channel"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube"],"Oauth2c":["https://www.googleapis.com/auth/youtube"]},{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]},{"Oauth2":["https://www.googleapis.com/auth/youtubepartner"],"Oauth2c":["https://www.googleapis.com/auth/youtubepartner"]}],"tags":["channels"]}},"/youtube/v3/commentThreads":{"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.commentThreads.list","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more commentThread resource properties that the API response will include.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Returns the comment threads of all videos of the channel and the channel comments as well.","in":"query","name":"allThreadsRelatedToChannelId","schema":{"type":"string"}},{"description":"Returns the comment threads for all the channel comments (ie does not include comments left on videos).","in":"query","name":"channelId","schema":{"type":"string"}},{"description":"Returns the comment threads with the given IDs for Stubby or Apiary.","explode":true,"in":"query","name":"id","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.","in":"query","name":"maxResults","schema":{"maximum":100,"minimum":1,"type":"integer"}},{"description":"Limits the returned comment threads to those with the specified moderation status. Not compatible with the 'id' filter. Valid values: published, heldForReview, likelySpam.","in":"query","name":"moderationStatus","schema":{"enum":["published","heldForReview","likelySpam","rejected"],"type":"string"}},{"in":"query","name":"order","schema":{"enum":["orderUnspecified","time","relevance"],"type":"string"}},{"description":"The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Limits the returned comment threads to those matching the specified key words. Not compatible with the 'id' filter.","in":"query","name":"searchTerms","schema":{"type":"string"}},{"description":"The requested text format for the returned comments.","in":"query","name":"textFormat","schema":{"enum":["textFormatUnspecified","html","plainText"],"type":"string"}},{"description":"Returns the comment threads of the specified video.","in":"query","name":"videoId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentThreadListResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["commentThreads"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Inserts a new resource into this collection.","operationId":"youtube.commentThreads.insert","parameters":[{"description":"The *part* parameter identifies the properties that the API response will include. Set the parameter value to snippet. The snippet part has a quota cost of 2 units.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentThread"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentThread"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["commentThreads"]},"put":{"description":"Updates an existing resource.","operationId":"youtube.youtube.v3.updateCommentThreads","parameters":[{"description":"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.","explode":true,"in":"query","name":"part","schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentThread"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentThread"}}},"description":"Successful response"}},"tags":["youtube"]}},"/youtube/v3/comments":{"delete":{"description":"Deletes a resource.","operationId":"youtube.comments.delete","parameters":[{"in":"query","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["comments"]},"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.comments.list","parameters":[{"description":"The *part* parameter specifies a comma-separated list of one or more comment resource properties that the API response will include.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Returns the comments with the given IDs for One Platform.","explode":true,"in":"query","name":"id","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.","in":"query","name":"maxResults","schema":{"maximum":100,"minimum":1,"type":"integer"}},{"description":"The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Returns replies to the specified comment. Note, currently YouTube features only one level of replies (ie replies to top level comments). However replies to replies may be supported in the future.","in":"query","name":"parentId","schema":{"type":"string"}},{"description":"The requested text format for the returned comments.","in":"query","name":"textFormat","schema":{"enum":["textFormatUnspecified","html","plainText"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentListResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["comments"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Inserts a new resource into this collection.","operationId":"youtube.comments.insert","parameters":[{"description":"The *part* parameter identifies the properties that the API response will include. Set the parameter value to snippet. The snippet part has a quota cost of 2 units.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["comments"]},"put":{"description":"Updates an existing resource.","operationId":"youtube.comments.update","parameters":[{"description":"The *part* parameter identifies the 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.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["comments"]}},"/youtube/v3/comments/markAsSpam":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Expresses the caller's opinion that one or more comments should be flagged as spam.","operationId":"youtube.comments.markAsSpam","parameters":[{"description":"Flags the comments with the given IDs as spam in the caller's opinion.","explode":true,"in":"query","name":"id","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["comments"]}},"/youtube/v3/comments/setModerationStatus":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Sets the moderation status of one or more comments.","operationId":"youtube.comments.setModerationStatus","parameters":[{"description":"Modifies the moderation status of the comments with the given IDs","explode":true,"in":"query","name":"id","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Specifies the requested moderation status. Note, comments can be in statuses, which are not available through this call. For example, this call does not allow to mark a comment as 'likely spam'. Valid values: 'heldForReview', 'published' or 'rejected'.","in":"query","name":"moderationStatus","required":true,"schema":{"enum":["published","heldForReview","likelySpam","rejected"],"type":"string"}},{"description":"If set to true the author of the comment gets added to the ban list. This means all future comments of the author will autmomatically be rejected. Only valid in combination with STATUS_REJECTED.","in":"query","name":"banAuthor","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/youtube.force-ssl"],"Oauth2c":["https://www.googleapis.com/auth/youtube.force-ssl"]}],"tags":["comments"]}},"/youtube/v3/i18nLanguages":{"get":{"description":"Retrieves a list of resources, possibly filtered.","operationId":"youtube.i18nLanguages.list","parameters":[{"description":"The *part* parameter specifies the i18nLanguage resource properties that the API response will include. Set the parameter value to snippet.","explode":true,"in":"query","name":"part","required":true,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"in":"query","name":"hl","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/I18nLanguageListResponse"}}},"descriptio