{"openapi":"3.0.0","info":{"description":"YouTube Data API v3 allows you to incorporate YouTube functionality into your application","version":[{"name":"v3","value":"v3"}]},"servers":[{"description":"YouTube Data API v3 allows you to incorporate YouTube functionality into your application","url":"https://api.apirails.com/youtube"}],"paths":{"/v3/activities":{"get":{"tags":["Activities"],"parameters":[{"name":"channelId","in":"query","description":"The channelId parameter specifies a unique YouTube channel ID","schema":{"type":"string","example":""}},{"name":"home","in":"query","description":"Set this parameter's value to true to retrieve the activity feed that displays on the YouTube home page for the authenticated user","schema":{"type":"boolean","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mine","in":"query","description":"Set this parameter's value to true to retrieve a feed of the authenticated user's activities","schema":{"type":"boolean","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more activity resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"publishedAfter","in":"query","description":"The publishedAfter parameter specifies the earliest date and time that an activity could have occurred","schema":{"type":"string","example":""}},{"name":"publishedBefore","in":"query","description":"The publishedBefore parameter specifies the date and time before which an activity must have occurred","schema":{"type":"string","example":""}},{"name":"regionCode","in":"query","description":"The regionCode parameter instructs the API to return results for the specified country","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/activities/list","api_endpoint":"https://www.googleapis.com/youtube/v3/activities"},"summary":"List activities","description":"Returns a list of channel activity events that match the request criteria","security":[{"bearerAuth":[]}]}},"/v3/channels":{"get":{"tags":["Channels"],"parameters":[{"name":"categoryId","in":"query","description":"The categoryId parameter specifies a YouTube guide category, thereby restricting YouTube's search to that category","schema":{"type":"string","example":""}},{"name":"forHandle","in":"query","description":"The forHandle parameter specifies a YouTube handle, thereby requesting the channel associated with that handle","schema":{"type":"string","example":""}},{"name":"forUsername","in":"query","description":"The forUsername parameter specifies a YouTube username, thereby requesting the channel associated with that username","schema":{"type":"string","example":""}},{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube channel ID(s) for the resource(s) that are being retrieved","schema":{"type":"string","example":""}},{"name":"managedByMe","in":"query","description":"Set this parameter's value to true to instruct the API to only return channels managed by the content owner that the onBehalfOfContentOwner parameter specifies","schema":{"type":"boolean","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mine","in":"query","description":"Set this parameter's value to true to instruct the API to only return channels owned by the authenticated user","schema":{"type":"boolean","example":""}},{"name":"mySubscribers","in":"query","description":"Set this parameter's value to true to retrieve a list of channels that subscribed to the authenticated user's channel","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more channel resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channels/list","api_endpoint":"https://www.googleapis.com/youtube/v3/channels"},"summary":"List channels","description":"Returns a collection of zero or more channel resources that match the request criteria","security":[{"bearerAuth":[]}]},"put":{"tags":["Channels"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channels/update","api_endpoint":"https://www.googleapis.com/youtube/v3/channels"},"summary":"Update channel","description":"Updates a channel's metadata","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"auditDetails":{"type":"object","description":"The auditDetails object encapsulates channel data that is relevant for YouTube Partners during the audit process","properties":{"communityGuidelinesGoodStanding":{"type":"boolean","description":"Whether the channel has good community guidelines standing"},"contentIdClaimsGoodStanding":{"type":"boolean","description":"Whether the channel has good content ID claims standing"},"copyrightStrikesGoodStanding":{"type":"boolean","description":"Whether the channel has no copyright strikes"},"overallGoodStanding":{"type":"boolean","description":"Whether the channel is in overall good standing"}}},"brandingSettings":{"type":"object","description":"The brandingSettings object encapsulates information about the branding of the channel","properties":{"channel":{"type":"object","description":"Channel branding settings"},"watch":{"type":"object","description":"Watch page branding settings"}}},"contentDetails":{"type":"object","description":"The contentDetails object encapsulates information about the channel's content","properties":{"caption":{"type":"string","description":"Whether the video has captions","enum":["true","false"]},"contentRating":{"type":"object","description":"Content rating details"},"definition":{"type":"string","description":"The video's resolution","enum":["hd","sd"]},"dimension":{"type":"string","description":"The video's dimension","enum":["2d","3d"]},"duration":{"type":"string","description":"The length of the video in ISO 8601 format"},"licensedContent":{"type":"boolean","description":"Whether the video represents licensed content"},"projection":{"type":"string","description":"The projection format","enum":["rectangular","360"]},"regionRestriction":{"type":"object","description":"Region restriction details"}}},"contentOwnerDetails":{"type":"object","description":"The contentOwnerDetails object encapsulates channel data that is relevant for YouTube Partners linked with the channel","properties":{"contentOwner":{"type":"string","description":"The ID of the content owner linked to the channel"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the channel","required":true},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the channel's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the channel, such as its title, description, and thumbnail images","properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"statistics":{"type":"object","description":"The statistics object encapsulates statistics for the channel","properties":{"hiddenSubscriberCount":{"type":"boolean","description":"Whether the subscriber count is hidden"}}},"status":{"type":"object","description":"The status object encapsulates information about the privacy status of the channel","properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"auditDetails":{},"brandingSettings":{},"contentDetails":{},"contentOwnerDetails":{},"id":"","localizations":{},"snippet":{},"statistics":{},"status":{}}}}}}},"/v3/channelSections":{"get":{"tags":["Channel Sections"],"parameters":[{"name":"channelId","in":"query","description":"The channelId parameter specifies a YouTube channel ID","schema":{"type":"string","example":""}},{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube channelSection ID(s) for the resource(s) that are being retrieved","schema":{"type":"string","example":""}},{"name":"mine","in":"query","description":"Set this parameter's value to true to instruct the API to only return channelSections owned by the authenticated user","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more channelSection resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channelSections/list","api_endpoint":"https://www.googleapis.com/youtube/v3/channelSections"},"summary":"List channel sections","description":"Returns a collection of channelSection resources that match the request criteria","security":[{"bearerAuth":[]}]},"post":{"tags":["Channel Sections"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channelSections/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/channelSections"},"summary":"Insert channel section","description":"Adds a channelSection resource","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains details about the channel section's content, such as a list of playlists or channels featured in the section","properties":{"channels":{"type":"array","description":"A list of channel IDs in the section"},"playlists":{"type":"array","description":"A list of playlist IDs in the section"}}},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the channel section's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the channel section, such as its type and style","required":true,"properties":{"type":{"type":"string","description":"The type of the channel section","enum":["allPlaylists","popularUploads","recentUploads","likes","subscriptions"]},"position":{"type":"string","description":"The section's position"},"title":{"type":"string","description":"The section's title"}}}}},"example":{"contentDetails":{},"localizations":{},"snippet":{}}}}}},"put":{"tags":["Channel Sections"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channelSections/update","api_endpoint":"https://www.googleapis.com/youtube/v3/channelSections"},"summary":"Update channel section","description":"Updates a channel section","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains details about the channel section's content, such as a list of playlists or channels featured in the section","properties":{"channels":{"type":"array","description":"A list of channel IDs in the section"},"playlists":{"type":"array","description":"A list of playlist IDs in the section"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the channel section","required":true},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the channel section's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the channel section, such as its type and style","properties":{"type":{"type":"string","description":"The type of the channel section","enum":["allPlaylists","popularUploads","recentUploads","likes","subscriptions"]},"position":{"type":"string","description":"The section's position"},"title":{"type":"string","description":"The section's title"}}}}},"example":{"contentDetails":{},"id":"","localizations":{},"snippet":{}}}}}},"delete":{"tags":["Channel Sections"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube channelSection ID for the resource that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channelSections/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/channelSections"},"summary":"Delete channel section","description":"Deletes a channel section","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/comments":{"get":{"tags":["Comments"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of comment IDs for the resources that are being retrieved","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"parentId","in":"query","description":"The parentId parameter specifies the ID of the comment for which replies should be retrieved","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more comment resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"textFormat","in":"query","description":"Set this parameter's value to html or plainText to instruct the API to return the comments left by users in html formatted or in plain text","schema":{"type":"string","example":"","items":{"type":"string","enum":["html","plainText"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/comments/list","api_endpoint":"https://www.googleapis.com/youtube/v3/comments"},"summary":"List comments","description":"Returns a list of comment resources that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Comments"],"parameters":[{"name":"part","in":"query","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 1 unit","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/comments/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/comments"},"summary":"Insert comment","description":"Creates a new top-level comment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"snippet":{"type":"object","description":"The snippet object contains basic details about the comment, including its text","required":true,"properties":{"channelId":{"type":"string","description":"The ID of the channel that the comment belongs to"},"parentId":{"type":"string","description":"The ID of the parent comment for replies"},"textDisplay":{"type":"string","description":"The comment text formatted for display"},"textOriginal":{"type":"string","description":"The original, raw text of the comment","required":true},"videoId":{"type":"string","description":"The ID of the video that the comment is about"}}}}},"example":{"snippet":{}}}}}},"put":{"tags":["Comments"],"parameters":[{"name":"part","in":"query","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 uses to update a comment's text","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/comments/update","api_endpoint":"https://www.googleapis.com/youtube/v3/comments"},"summary":"Update comment","description":"Modifies a comment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the comment","required":true},"snippet":{"type":"object","description":"The snippet object contains basic details about the comment, including its text","required":true,"properties":{"channelId":{"type":"string","description":"The ID of the channel that the comment belongs to"},"parentId":{"type":"string","description":"The ID of the parent comment for replies"},"textDisplay":{"type":"string","description":"The comment text formatted for display"},"textOriginal":{"type":"string","description":"The original, raw text of the comment","required":true},"videoId":{"type":"string","description":"The ID of the video that the comment is about"}}}}},"example":{"id":"","snippet":{}}}}}},"delete":{"tags":["Comments"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube comment ID for the resource that is being deleted","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/comments/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/comments"},"summary":"Delete comment","description":"Deletes a comment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/comments/setModerationStatus":{"post":{"tags":["Comments"],"parameters":[{"name":"banAuthor","in":"query","description":"The banAuthor parameter lets you indicate that you want to automatically reject any additional comments written by the comment's author","schema":{"type":"boolean","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of comment IDs that are having their moderation status changed","required":true,"schema":{"type":"string","example":""}},{"name":"moderationStatus","in":"query","description":"Identifies the new moderation status of the specified comments","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["heldForReview","published","rejected"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/comments/setModerationStatus","api_endpoint":"https://www.googleapis.com/youtube/v3/comments/setModerationStatus"},"summary":"Set comment moderation status","description":"Sets the moderation status of one or more comments","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/commentThreads":{"get":{"tags":["Comment Threads"],"parameters":[{"name":"allThreadsRelatedToChannelId","in":"query","description":"The allThreadsRelatedToChannelId parameter instructs the API to return all comment threads associated with the specified channel","schema":{"type":"string","example":""}},{"name":"channelId","in":"query","description":"The channelId parameter instructs the API to return comment threads containing comments about the specified channel","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of comment thread IDs for the resources that should be retrieved","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"moderationStatus","in":"query","description":"Set this parameter to limit the returned comment threads to a particular moderation state","schema":{"type":"string","example":"","items":{"type":"string","enum":["heldForReview","likelySpam","published"]}}},{"name":"order","in":"query","description":"The order parameter specifies the order in which the API response should list comment threads","schema":{"type":"string","example":"","items":{"type":"string","enum":["time","relevance"]}}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more commentThread resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"searchTerms","in":"query","description":"The searchTerms parameter instructs the API to limit the API response to only contain comments that contain the specified search terms","schema":{"type":"string","example":""}},{"name":"textFormat","in":"query","description":"Set this parameter's value to html or plainText to instruct the API to return the comments left by users in html formatted or in plain text","schema":{"type":"string","example":"","items":{"type":"string","enum":["html","plainText"]}}},{"name":"videoId","in":"query","description":"The videoId parameter instructs the API to return comment threads associated with the specified video ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/commentThreads/list","api_endpoint":"https://www.googleapis.com/youtube/v3/commentThreads"},"summary":"List comment threads","description":"Returns a list of comment threads that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Comment Threads"],"parameters":[{"name":"part","in":"query","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 1 unit","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/commentThreads/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/commentThreads"},"summary":"Insert comment thread","description":"Creates a new top-level comment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"replies":{"type":"object","description":"The replies object is a container object for a list of replies to the comment","properties":{"comments":{"type":"array","description":"A list of replies to the top-level comment"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the comment thread, including its top-level comment","required":true,"properties":{"channelId":{"type":"string","description":"The ID of the channel that the comment thread belongs to","required":true},"topLevelComment":{"type":"object","description":"The top-level comment in the thread"},"videoId":{"type":"string","description":"The ID of the video that the comment thread is about"}}}}},"example":{"replies":{},"snippet":{}}}}}}},"/v3/i18nLanguages":{"get":{"tags":["I18n Languages"],"parameters":[{"name":"hl","in":"query","description":"The hl parameter specifies the language that should be used for text values in the API response","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies the i18nLanguage resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/i18nLanguages/list","api_endpoint":"https://www.googleapis.com/youtube/v3/i18nLanguages"},"summary":"List i18n languages","description":"Returns a list of application languages that the YouTube website supports","security":[{"bearerAuth":[]}]}},"/v3/i18nRegions":{"get":{"tags":["I18n Regions"],"parameters":[{"name":"hl","in":"query","description":"The hl parameter specifies the language that should be used for text values in the API response","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies the i18nRegion resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/i18nRegions/list","api_endpoint":"https://www.googleapis.com/youtube/v3/i18nRegions"},"summary":"List i18n regions","description":"Returns a list of content regions that the YouTube website supports","security":[{"bearerAuth":[]}]}},"/v3/members":{"get":{"tags":["Members"],"parameters":[{"name":"filterByMemberChannelId","in":"query","description":"Comma-separated list of channel IDs. Only data about members that are part of this list will be included in the response","schema":{"type":"string","example":""}},{"name":"hasAccessToLevel","in":"query","description":"Filter results to members that have access to a specific level","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mode","in":"query","description":"The mode parameter indicates which members to return","schema":{"type":"string","example":"","items":{"type":"string","enum":["all_current","updates"]}}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies the member resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/members/list","api_endpoint":"https://www.googleapis.com/youtube/v3/members"},"summary":"List members","description":"Retrieves a list of members that match the request criteria for a channel","security":[{"bearerAuth":[]}]}},"/v3/membershipsLevels":{"get":{"tags":["Memberships"],"parameters":[{"name":"part","in":"query","description":"The part parameter specifies the membershipsLevel resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/membershipsLevels/list","api_endpoint":"https://www.googleapis.com/youtube/v3/membershipsLevels"},"summary":"List membership levels","description":"Retrieves a list of all pricing levels offered by a creator to their fans","security":[{"bearerAuth":[]}]}},"/v3/playlistItems":{"get":{"tags":["Playlist Items"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of one or more unique playlist item IDs","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more playlistItem resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"playlistId","in":"query","description":"The playlistId parameter specifies the unique ID of the playlist for which you want to retrieve playlist items","schema":{"type":"string","example":""}},{"name":"videoId","in":"query","description":"The videoId parameter specifies that the request should return only the playlist items that contain the specified video","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistItems/list","api_endpoint":"https://www.googleapis.com/youtube/v3/playlistItems"},"summary":"List playlist items","description":"Returns a collection of playlist items that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Playlist Items"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistItems/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/playlistItems"},"summary":"Insert playlist item","description":"Adds a resource to a playlist","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object is included in the resource if the included item is a YouTube video","properties":{"endAt":{"type":"string","description":"The time in seconds from the start of the video to stop playing"},"note":{"type":"string","description":"A user-generated note for the playlist item"},"startAt":{"type":"string","description":"The time in seconds from the start of the video to start playing"},"videoId":{"type":"string","description":"The ID of the video in the playlist item"}}},"etag":{"type":"string","description":"Etag of this resource"},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the playlist item"},"kind":{"type":"string","description":"Identifies what kind of resource this is"},"snippet":{"type":"object","description":"The snippet object contains basic details about the playlist item, such as its title and position in the playlist","required":true,"properties":{"playlistId":{"type":"string","description":"The ID of the playlist the item belongs to","required":true},"position":{"type":"string","description":"The position of the item in the playlist"},"resourceId":{"type":"object","description":"The resource ID for the video in the playlist","required":true}}},"status":{"type":"object","description":"The status object contains information about the playlist item's privacy status","properties":{"privacyStatus":{"type":"string","description":"The playlist's privacy status","enum":["public","unlisted","private"]},"status":{"type":"string","description":"The playlist's status"}}}}},"example":{"contentDetails":{},"etag":"","id":"","kind":"","snippet":{},"status":{}}}}}},"put":{"tags":["Playlist Items"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistItems/update","api_endpoint":"https://www.googleapis.com/youtube/v3/playlistItems"},"summary":"Update playlist item","description":"Modifies a playlist item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object is included in the resource if the included item is a YouTube video","properties":{"endAt":{"type":"string","description":"The time in seconds from the start of the video to stop playing"},"note":{"type":"string","description":"A user-generated note for the playlist item"},"startAt":{"type":"string","description":"The time in seconds from the start of the video to start playing"},"videoId":{"type":"string","description":"The ID of the video in the playlist item"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the playlist item","required":true},"snippet":{"type":"object","description":"The snippet object contains basic details about the playlist item, such as its title and position in the playlist","properties":{"playlistId":{"type":"string","description":"The ID of the playlist the item belongs to","required":true},"position":{"type":"string","description":"The position of the item in the playlist"},"resourceId":{"type":"object","description":"The resource ID for the video in the playlist","required":true}}},"status":{"type":"object","description":"The status object contains information about the playlist item's privacy status","properties":{"privacyStatus":{"type":"string","description":"The playlist's privacy status","enum":["public","unlisted","private"]},"status":{"type":"string","description":"The playlist's status"}}}}},"example":{"contentDetails":{},"id":"","snippet":{},"status":{}}}}}},"delete":{"tags":["Playlist Items"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube playlist item ID for the playlist item that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistItems/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/playlistItems"},"summary":"Delete playlist item","description":"Deletes a playlist item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/playlists":{"get":{"tags":["Playlists"],"parameters":[{"name":"channelId","in":"query","description":"This value indicates that the API should only return the specified channel's playlists","schema":{"type":"string","example":""}},{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube playlist ID(s) for the resource(s) that are being retrieved","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mine","in":"query","description":"Set this parameter's value to true to instruct the API to only return playlists owned by the authenticated user","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more playlist resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlists/list","api_endpoint":"https://www.googleapis.com/youtube/v3/playlists"},"summary":"List playlists","description":"Returns a collection of playlists that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Playlists"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlists/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/playlists"},"summary":"Insert playlist","description":"Creates a playlist","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains information about the playlist content, including the item count","properties":{"itemCount":{"type":"string","description":"The number of videos in the playlist"}}},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the playlist's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the playlist, such as its title and description","required":true,"properties":{"defaultLanguage":{"type":"string","description":"Default language"},"description":{"type":"string","description":"The playlist's description"},"tags":{"type":"array","description":"List of keyword tags"},"title":{"type":"string","description":"The playlist's title","required":true}}},"status":{"type":"object","description":"The status object contains information about the playlist's privacy status","properties":{"privacyStatus":{"type":"string","description":"The playlist's privacy status","enum":["public","unlisted","private"]},"status":{"type":"string","description":"The playlist's status"}}}}},"example":{"contentDetails":{},"localizations":{},"snippet":{},"status":{}}}}}},"put":{"tags":["Playlists"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlists/update","api_endpoint":"https://www.googleapis.com/youtube/v3/playlists"},"summary":"Update playlist","description":"Modifies a playlist","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains information about the playlist content, including the item count","properties":{"itemCount":{"type":"string","description":"The number of videos in the playlist"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the playlist","required":true},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the playlist's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the playlist, such as its title and description","properties":{"defaultLanguage":{"type":"string","description":"Default language"},"description":{"type":"string","description":"The playlist's description"},"tags":{"type":"array","description":"List of keyword tags"},"title":{"type":"string","description":"The playlist's title","required":true}}},"status":{"type":"object","description":"The status object contains information about the playlist's privacy status","properties":{"privacyStatus":{"type":"string","description":"The playlist's privacy status","enum":["public","unlisted","private"]},"status":{"type":"string","description":"The playlist's status"}}}}},"example":{"contentDetails":{},"id":"","localizations":{},"snippet":{},"status":{}}}}}},"delete":{"tags":["Playlists"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube playlist ID for the playlist that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlists/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/playlists"},"summary":"Delete playlist","description":"Deletes a playlist","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/search":{"get":{"tags":["Search"],"parameters":[{"name":"type","in":"query","description":"The type parameter restricts a search query to only retrieve a particular type of resource","schema":{"type":"string","example":""}},{"name":"channelId","in":"query","description":"The channelId parameter indicates that the API response should only contain resources created by the channel","schema":{"type":"string","example":""}},{"name":"channelType","in":"query","description":"The channelType parameter lets you restrict a search to a particular type of channel","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","show"]}}},{"name":"eventType","in":"query","description":"The eventType parameter restricts a search to broadcast events","schema":{"type":"string","example":"","items":{"type":"string","enum":["completed","live","upcoming"]}}},{"name":"forContentOwner","in":"query","description":"The forContentOwner parameter restricts the search to only retrieve resources owned by the content owner specified by the onBehalfOfContentOwner parameter","schema":{"type":"boolean","example":""}},{"name":"forDeveloper","in":"query","description":"The forDeveloper parameter restricts the search to only retrieve videos uploaded via the developer's application or website","schema":{"type":"boolean","example":""}},{"name":"forMine","in":"query","description":"The forMine parameter restricts the search to only retrieve videos owned by the authenticated user","schema":{"type":"boolean","example":""}},{"name":"location","in":"query","description":"The location parameter, in conjunction with the locationRadius parameter, defines a circular geographic area","schema":{"type":"string","example":""}},{"name":"locationRadius","in":"query","description":"The locationRadius parameter, in conjunction with the location parameter, defines a circular geographic area","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"order","in":"query","description":"The order parameter specifies the method that will be used to order resources in the API response","schema":{"type":"string","example":"","items":{"type":"string","enum":["date","rating","relevance","title","videoCount","viewCount"]}}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more search resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}},{"name":"publishedAfter","in":"query","description":"The publishedAfter parameter indicates that the API response should only contain resources created at or after the specified time","schema":{"type":"string","example":""}},{"name":"publishedBefore","in":"query","description":"The publishedBefore parameter indicates that the API response should only contain resources created before or at the specified time","schema":{"type":"string","example":""}},{"name":"q","in":"query","description":"The q parameter specifies the query term to search for","schema":{"type":"string","example":""}},{"name":"regionCode","in":"query","description":"The regionCode parameter instructs the API to return search results for the specified country","schema":{"type":"string","example":""}},{"name":"relatedToVideoId","in":"query","description":"The relatedToVideoId parameter retrieves a list of videos that are related to the video that the parameter value identifies","schema":{"type":"string","example":""}},{"name":"relevanceLanguage","in":"query","description":"The relevanceLanguage parameter instructs the API to return search results that are most relevant to the specified language","schema":{"type":"string","example":""}},{"name":"safeSearch","in":"query","description":"The safeSearch parameter indicates whether the search results should include restricted content as well as standard content","schema":{"type":"string","example":"","items":{"type":"string","enum":["moderate","none","strict"]}}},{"name":"topicId","in":"query","description":"The topicId parameter indicates that the API response should only contain resources associated with the specified topic","schema":{"type":"string","example":""}},{"name":"videoCaption","in":"query","description":"The videoCaption parameter indicates whether the API should filter video search results based on whether they have captions","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","closedCaption","none"]}}},{"name":"videoCategoryId","in":"query","description":"The videoCategoryId parameter filters video search results based on their category","schema":{"type":"string","example":""}},{"name":"videoDefinition","in":"query","description":"The videoDefinition parameter lets you restrict a search to only include either high definition (HD) or standard definition (SD) videos","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","high","standard"]}}},{"name":"videoDimension","in":"query","description":"The videoDimension parameter lets you restrict a search to only retrieve 2D or 3D videos","schema":{"type":"string","example":"","items":{"type":"string","enum":["2d","3d","any"]}}},{"name":"videoDuration","in":"query","description":"The videoDuration parameter filters video search results based on their duration","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","long","medium","short"]}}},{"name":"videoEmbeddable","in":"query","description":"The videoEmbeddable parameter lets you to restrict a search to only videos that can be embedded into a webpage","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","true"]}}},{"name":"videoLicense","in":"query","description":"The videoLicense parameter filters search results to only include videos with a particular license","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","creativeCommon","youtube"]}}},{"name":"videoSyndicated","in":"query","description":"The videoSyndicated parameter lets you to restrict a search to only videos that can be played outside youtube.com","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","true"]}}},{"name":"videoType","in":"query","description":"The videoType parameter lets you restrict a search to a particular type of videos","schema":{"type":"string","example":"","items":{"type":"string","enum":["any","episode","movie"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/search/list","api_endpoint":"https://www.googleapis.com/youtube/v3/search"},"summary":"Search","description":"Returns a collection of search results that match the query parameters specified in the API request","security":[{"bearerAuth":[]}]}},"/v3/subscriptions":{"get":{"tags":["Subscriptions"],"parameters":[{"name":"channelId","in":"query","description":"The channelId parameter specifies a YouTube channel ID","schema":{"type":"string","example":""}},{"name":"forChannelId","in":"query","description":"The forChannelId parameter specifies a comma-separated list of channel IDs","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube subscription ID(s) for the resource(s) that are being retrieved","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mine","in":"query","description":"Set this parameter's value to true to retrieve a feed of the authenticated user's subscriptions","schema":{"type":"boolean","example":""}},{"name":"myRecentSubscribers","in":"query","description":"Set this parameter's value to true to retrieve a feed of the subscribers of the authenticated user in reverse chronological order (newest first)","schema":{"type":"boolean","example":""}},{"name":"mySubscribers","in":"query","description":"Set this parameter's value to true to retrieve a feed of the subscribers of the authenticated user","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"order","in":"query","description":"The order parameter specifies the method that will be used to sort resources in the API response","schema":{"type":"string","example":"","items":{"type":"string","enum":["alphabetical","relevance","unread"]}}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more subscription resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/subscriptions/list","api_endpoint":"https://www.googleapis.com/youtube/v3/subscriptions"},"summary":"List subscriptions","description":"Returns subscription resources that match the API request criteria","security":[{"bearerAuth":[]}]},"post":{"tags":["Subscriptions"],"parameters":[{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/subscriptions/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/subscriptions"},"summary":"Insert subscription","description":"Adds a subscription for the authenticated user's channel","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object is included in the subscription resource returned by the API","properties":{"caption":{"type":"string","description":"Whether the video has captions","enum":["true","false"]},"contentRating":{"type":"object","description":"Content rating details"},"definition":{"type":"string","description":"The video's resolution","enum":["hd","sd"]},"dimension":{"type":"string","description":"The video's dimension","enum":["2d","3d"]},"duration":{"type":"string","description":"The length of the video in ISO 8601 format"},"licensedContent":{"type":"boolean","description":"Whether the video represents licensed content"},"projection":{"type":"string","description":"The projection format","enum":["rectangular","360"]},"regionRestriction":{"type":"object","description":"Region restriction details"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the subscription, including its title and the channel that the user subscribed to","required":true,"properties":{"channelId":{"type":"string","description":"The ID of the channel to subscribe to","required":true}}},"subscriberSnippet":{"type":"object","description":"The subscriberSnippet object contains basic details about the subscriber","properties":{"channelId":{"type":"string","description":"The channel ID of the subscriber"},"description":{"type":"string","description":"Description of the subscriber"}}}}},"example":{"contentDetails":{},"snippet":{},"subscriberSnippet":{}}}}}},"delete":{"tags":["Subscriptions"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube subscription ID for the resource that is being deleted","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/subscriptions/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/subscriptions"},"summary":"Delete subscription","description":"Deletes a subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/thumbnails/set":{"post":{"tags":["Thumbnails"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"videoId","in":"query","description":"The videoId parameter specifies a YouTube video ID for which the custom video thumbnail is being provided","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/thumbnails/set","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/thumbnails/set?uploadType=media"},"summary":"Set thumbnail","description":"Uploads a custom video thumbnail to YouTube and sets it for a video","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The image file to upload as a custom video thumbnail","required":true}}},"example":{"file":"(binary)"}}}}}},"/v3/videos":{"get":{"tags":["Videos"],"parameters":[{"name":"chart","in":"query","description":"The chart parameter identifies the chart that you want to retrieve","schema":{"type":"string","example":"","items":{"type":"string","enum":["mostPopular"]}}},{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube video ID(s) for the resource(s) that are being retrieved","schema":{"type":"string","example":""}},{"name":"locale","in":"query","description":"The locale parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"maxHeight","in":"query","description":"The maxHeight parameter specifies the maximum height of the embedded player","schema":{"type":"number","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"maxWidth","in":"query","description":"The maxWidth parameter specifies the maximum width of the embedded player","schema":{"type":"number","example":""}},{"name":"myRating","in":"query","description":"Set this parameter's value to like or dislike to instruct the API to only return videos liked or disliked by the authenticated user","schema":{"type":"string","example":"","items":{"type":"string","enum":["dislike","like"]}}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more video resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"regionCode","in":"query","description":"The regionCode parameter instructs the API to return results for the specified country","schema":{"type":"string","example":""}},{"name":"videoCategoryId","in":"query","description":"The videoCategoryId parameter identifies the video category for which the chart should be retrieved","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/list","api_endpoint":"https://www.googleapis.com/youtube/v3/videos"},"summary":"List videos","description":"Returns a list of videos that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Videos"],"parameters":[{"name":"autoLevels","in":"query","description":"The autoLevels parameter indicates whether YouTube should automatically enhance the video's lighting and color","schema":{"type":"boolean","example":""}},{"name":"notifySubscribers","in":"query","description":"The notifySubscribers parameter indicates whether YouTube should send a notification about the new video to users who subscribe to the video's channel","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}},{"name":"stabilize","in":"query","description":"The stabilize parameter indicates whether YouTube should adjust the video to remove shaky camera motions","schema":{"type":"boolean","example":""}},{"name":"uploadType","in":"query","description":"The type of upload: resumable (videos, two-step) or multipart (single request, smaller files)","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/insert","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/videos?uploadType=multipart"},"summary":"Insert video","description":"Uploads a video to YouTube and optionally sets the video's metadata","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains information about the video content, including the length of the video and an indication of whether captions are available for the video","properties":{"caption":{"type":"string","description":"Whether the video has captions","enum":["true","false"]},"contentRating":{"type":"object","description":"Content rating details"},"definition":{"type":"string","description":"The video's resolution","enum":["hd","sd"]},"dimension":{"type":"string","description":"The video's dimension","enum":["2d","3d"]},"duration":{"type":"string","description":"The length of the video in ISO 8601 format"},"licensedContent":{"type":"boolean","description":"Whether the video represents licensed content"},"projection":{"type":"string","description":"The projection format","enum":["rectangular","360"]},"regionRestriction":{"type":"object","description":"Region restriction details"}}},"file":{"type":"string","format":"binary","description":"The video file to upload","required":true},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the video's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"recordingDetails":{"type":"object","description":"The recordingDetails object encapsulates information about the location, date and address where the video was recorded","properties":{"location":{"type":"object","description":"Geographical location where the video was recorded"},"locationDescription":{"type":"string","description":"Human-readable description of the location"},"recordingDate":{"type":"string","description":"The date and time when the video was recorded"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the video, including its title, description, and category","required":true,"properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"status":{"type":"object","description":"The status object contains information about the video's uploading, processing, and privacy statuses","properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"contentDetails":{},"file":"(binary)","localizations":{},"recordingDetails":{},"snippet":{},"status":{}}}}}},"put":{"tags":["Videos"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/update","api_endpoint":"https://www.googleapis.com/youtube/v3/videos"},"summary":"Update video","description":"Updates a video's metadata","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains information about the video content, including the length of the video and an indication of whether captions are available for the video","properties":{"caption":{"type":"string","description":"Whether the video has captions","enum":["true","false"]},"contentRating":{"type":"object","description":"Content rating details"},"definition":{"type":"string","description":"The video's resolution","enum":["hd","sd"]},"dimension":{"type":"string","description":"The video's dimension","enum":["2d","3d"]},"duration":{"type":"string","description":"The length of the video in ISO 8601 format"},"licensedContent":{"type":"boolean","description":"Whether the video represents licensed content"},"projection":{"type":"string","description":"The projection format","enum":["rectangular","360"]},"regionRestriction":{"type":"object","description":"Region restriction details"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the video","required":true},"localizations":{"type":"object","description":"The localizations object encapsulates translations of the video's metadata","properties":{"description":{"type":"string","description":"Localized description"},"title":{"type":"string","description":"Localized title"}}},"recordingDetails":{"type":"object","description":"The recordingDetails object encapsulates information about the location, date and address where the video was recorded","properties":{"location":{"type":"object","description":"Geographical location where the video was recorded"},"locationDescription":{"type":"string","description":"Human-readable description of the location"},"recordingDate":{"type":"string","description":"The date and time when the video was recorded"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the video, including its title, description, and category","properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"status":{"type":"object","description":"The status object contains information about the video's uploading, processing, and privacy statuses","properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"contentDetails":{},"id":"","localizations":{},"recordingDetails":{},"snippet":{},"status":{}}}}}},"delete":{"tags":["Videos"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube video ID for the resource that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/videos"},"summary":"Delete video","description":"Deletes a YouTube video","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/videos/rate":{"post":{"tags":["Videos"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube video ID for the resource that is being rated","required":true,"schema":{"type":"string","example":""}},{"name":"rating","in":"query","description":"Specifies the rating to record","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["dislike","like","none"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/rate","api_endpoint":"https://www.googleapis.com/youtube/v3/videos/rate"},"summary":"Rate video","description":"Adds a like or dislike rating to a video or removes a rating from a video","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/videos/getRating":{"get":{"tags":["Videos"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube video ID(s) for the resource(s) for which you are retrieving rating data","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/getRating","api_endpoint":"https://www.googleapis.com/youtube/v3/videos/getRating"},"summary":"Get video rating","description":"Retrieves the ratings that the authorized user gave to a list of specified videos","security":[{"bearerAuth":[]}]}},"/v3/videos/reportAbuse":{"post":{"tags":["Videos"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/reportAbuse","api_endpoint":"https://www.googleapis.com/youtube/v3/videos/reportAbuse"},"summary":"Report video abuse","description":"Reports a video for containing abusive content","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"comments":{"type":"string","description":"The comments parameter lets you provide additional information about the abuse report"},"language":{"type":"string","description":"The language parameter identifies the language of the abuse report"},"reasonId":{"type":"string","description":"The reasonId parameter identifies the reason that the video is being reported","required":true},"secondaryReasonId":{"type":"string","description":"The secondaryReasonId parameter lets you specify a secondary reason if the primary reason does not fully capture the violation"},"videoId":{"type":"string","description":"The videoId parameter identifies the video that is being reported","required":true}}},"example":{"comments":"","language":"","reasonId":"","secondaryReasonId":"","videoId":""}}}}}},"/v3/videoCategories":{"get":{"tags":["Video Categories"],"parameters":[{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of the YouTube video category ID(s) for the resource(s) that are being retrieved","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}},{"name":"regionCode","in":"query","description":"The regionCode parameter instructs the API to return results for the specified country","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videoCategories/list","api_endpoint":"https://www.googleapis.com/youtube/v3/videoCategories"},"summary":"List video categories","description":"Returns a list of video categories that can be associated with YouTube videos","security":[{"bearerAuth":[]}]}},"/v3/videoAbuseReportReasons":{"get":{"tags":["Video Abuse Report Reasons"],"parameters":[{"name":"hl","in":"query","description":"The hl parameter specifies the language for text values in the API response. The value must be a language code included in the list returned by the i18nLanguages.list method","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies the videoAbuseReportReason resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videoAbuseReportReasons/list","api_endpoint":"https://www.googleapis.com/youtube/v3/videoAbuseReportReasons"},"summary":"List video abuse report reasons","description":"Returns a list of reasons that can be used to report abusive videos","security":[{"bearerAuth":[]}]}},"/v3/captions":{"get":{"tags":["Captions"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of IDs that identify the caption resources that should be retrieved","schema":{"type":"string","example":""}},{"name":"onBehalfOf","in":"query","description":"ID of the Google+ Page or Channel on behalf of which the caption track is being uploaded","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more caption resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}},{"name":"videoId","in":"query","description":"The videoId parameter specifies the YouTube video ID of the video for which the API should return caption tracks","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/captions/list","api_endpoint":"https://www.googleapis.com/youtube/v3/captions"},"summary":"List captions","description":"Returns a list of caption tracks that are associated with a specified video","security":[{"bearerAuth":[]}]},"post":{"tags":["Captions"],"parameters":[{"name":"onBehalfOf","in":"query","description":"ID of the Google+ Page or Channel on behalf of which the caption track is being uploaded","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}},{"name":"sync","in":"query","description":"The sync parameter indicates whether YouTube should automatically synchronize the caption file with the audio track of the video","schema":{"type":"boolean","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/captions/insert","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/captions?uploadType=multipart"},"summary":"Insert caption","description":"Uploads a caption track","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The caption track file to upload","required":true},"snippet":{"type":"object","description":"The snippet object contains basic details about the caption track, such as its language and name","required":true,"properties":{"isDraft":{"type":"boolean","description":"Whether the caption track is a draft"},"language":{"type":"string","description":"The language of the caption track"},"name":{"type":"string","description":"The name of the caption track"},"videoId":{"type":"string","description":"The ID of the video the caption belongs to","required":true}}}}},"example":{"file":"(binary)","snippet":{}}}}}},"put":{"tags":["Captions"],"parameters":[{"name":"onBehalfOf","in":"query","description":"ID of the Google+ Page or Channel on behalf of which the caption track is being updated","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"part","in":"query","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. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}},{"name":"sync","in":"query","description":"The sync parameter indicates whether YouTube should automatically synchronize the caption file with the audio track of the video","schema":{"type":"boolean","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/captions/update","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/captions?uploadType=multipart"},"summary":"Update caption","description":"Updates a caption track","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The caption track file to upload"},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the caption track","required":true},"snippet":{"type":"object","description":"The snippet object contains basic details about the caption track, such as its language and name","properties":{"isDraft":{"type":"boolean","description":"Whether the caption track is a draft"},"language":{"type":"string","description":"The language of the caption track"},"name":{"type":"string","description":"The name of the caption track"},"videoId":{"type":"string","description":"The ID of the video the caption belongs to","required":true}}}}},"example":{"file":"(binary)","id":"","snippet":{}}}}}},"delete":{"tags":["Captions"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube caption track ID for the resource that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOf","in":"query","description":"ID of the Google+ Page or Channel on behalf of which the caption track is being deleted","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/captions/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/captions"},"summary":"Delete caption","description":"Deletes a caption track","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/captions/{id}":{"get":{"tags":["Captions"],"parameters":[{"name":"id","in":"path","description":"The ID that YouTube uses to uniquely identify the caption track","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOf","in":"query","description":"ID of the Google+ Page or Channel on behalf of which the caption track is being downloaded","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"tfmt","in":"query","description":"The tfmt parameter specifies the format that the caption track should be returned in","schema":{"type":"string","example":"","items":{"type":"string","enum":["sbv","scc","srt","ttml","vtt"]}}},{"name":"tlang","in":"query","description":"The tlang parameter specifies the language that the caption track should be translated to","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/captions/download","api_endpoint":"https://www.googleapis.com/youtube/v3/captions/{id}"},"summary":"Download caption","description":"Downloads a caption track","security":[{"bearerAuth":[]}]}},"/v3/watermarks/set":{"post":{"tags":["Watermarks"],"parameters":[{"name":"channelId","in":"query","description":"The channelId parameter specifies the YouTube channel ID for which the watermark is being provided","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/watermarks/set","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/watermarks/set?uploadType=multipart"},"summary":"Set watermark","description":"Uploads a watermark image to YouTube and sets it for a channel","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The image file to upload as a watermark","required":true},"position":{"type":"object","description":"The position object specifies where the watermark appears in the video frame","required":true,"properties":{"type":{"type":"string","description":"Position type of the watermark","enum":["corner","background"]},"cornerPosition":{"type":"string","description":"The corner where the watermark appears","enum":["topLeft","topRight","bottomLeft","bottomRight"]}}},"timing":{"type":"object","description":"The timing object specifies when the watermark appears and disappears during video playback","required":true,"properties":{"type":{"type":"string","description":"Timing type","enum":["offsetFromStart","offsetFromEnd"]},"durationMs":{"type":"string","description":"Duration in milliseconds for the watermark display"},"offsetMs":{"type":"string","description":"Offset in milliseconds from the timing reference point"}}}}},"example":{"file":"(binary)","position":{},"timing":{}}}}}}},"/v3/watermarks/unset":{"post":{"tags":["Watermarks"],"parameters":[{"name":"channelId","in":"query","description":"The channelId parameter specifies the YouTube channel ID for which the watermark is being unset","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/watermarks/unset","api_endpoint":"https://www.googleapis.com/youtube/v3/watermarks/unset"},"summary":"Unset watermark","description":"Removes a channel's watermark image","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveBroadcasts":{"get":{"tags":["Live Broadcasts"],"parameters":[{"name":"broadcastStatus","in":"query","description":"The broadcastStatus parameter filters the API response to only include broadcasts with the specified status","schema":{"type":"string","example":"","items":{"type":"string","enum":["active","all","completed","upcoming"]}}},{"name":"broadcastType","in":"query","description":"The broadcastType parameter filters the API response to only include broadcasts with the specified type","schema":{"type":"string","example":"","items":{"type":"string","enum":["all","event","persistent"]}}},{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of YouTube broadcast IDs that identify the broadcasts being retrieved","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mine","in":"query","description":"The mine parameter can be used to instruct the API to only return broadcasts owned by the authenticated user","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/list","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts"},"summary":"List live broadcasts","description":"Returns a list of YouTube broadcasts that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Live Broadcasts"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts"},"summary":"Insert live broadcast","description":"Creates a broadcast","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains information about the broadcast's content","properties":{"boundStreamId":{"type":"string","description":"The ID of the bound live stream"},"enableContentEncryption":{"type":"boolean","description":"Whether content encryption is enabled"},"enableDvr":{"type":"boolean","description":"Whether DVR is enabled"},"enableEmbed":{"type":"boolean","description":"Whether embedding is enabled"},"enableLowLatency":{"type":"boolean","description":"Whether low-latency streaming is enabled"},"latencyPreference":{"type":"string","description":"Latency preference","enum":["normal","low","ultraLow"]},"monitorStream":{"type":"object","description":"Monitor stream settings"},"recordFromStart":{"type":"boolean","description":"Whether to record from start"},"startWithSlate":{"type":"boolean","description":"Whether to start with a slate"}}},"etag":{"type":"string","description":"Etag of this resource"},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the broadcast"},"kind":{"type":"string","description":"Identifies what kind of resource this is"},"snippet":{"type":"object","description":"The snippet object contains basic details about the broadcast, including its title, description, and scheduled time","required":true,"properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"status":{"type":"object","description":"The status object contains information about the broadcast's status","required":true,"properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"contentDetails":{},"etag":"","id":"","kind":"","snippet":{},"status":{}}}}}},"put":{"tags":["Live Broadcasts"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/update","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts"},"summary":"Update live broadcast","description":"Updates a broadcast","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contentDetails":{"type":"object","description":"The contentDetails object contains information about the broadcast's content","properties":{"boundStreamId":{"type":"string","description":"The ID of the bound live stream"},"enableContentEncryption":{"type":"boolean","description":"Whether content encryption is enabled"},"enableDvr":{"type":"boolean","description":"Whether DVR is enabled"},"enableEmbed":{"type":"boolean","description":"Whether embedding is enabled"},"enableLowLatency":{"type":"boolean","description":"Whether low-latency streaming is enabled"},"latencyPreference":{"type":"string","description":"Latency preference","enum":["normal","low","ultraLow"]},"monitorStream":{"type":"object","description":"Monitor stream settings"},"recordFromStart":{"type":"boolean","description":"Whether to record from start"},"startWithSlate":{"type":"boolean","description":"Whether to start with a slate"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the broadcast","required":true},"snippet":{"type":"object","description":"The snippet object contains basic details about the broadcast, including its title, description, and scheduled time","properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"status":{"type":"object","description":"The status object contains information about the broadcast's status","properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"contentDetails":{},"id":"","snippet":{},"status":{}}}}}},"delete":{"tags":["Live Broadcasts"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube broadcast ID for the broadcast that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts"},"summary":"Delete live broadcast","description":"Deletes a broadcast","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveBroadcasts/bind":{"post":{"tags":["Live Broadcasts"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the unique ID of the broadcast that is being bound to a video stream","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"streamId","in":"query","description":"The streamId parameter specifies the unique ID of the video stream that is being bound to a broadcast","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/bind","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts/bind"},"summary":"Bind live broadcast","description":"Binds a YouTube broadcast to a stream or removes an existing binding between a broadcast and a stream","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveBroadcasts/transition":{"post":{"tags":["Live Broadcasts"],"parameters":[{"name":"broadcastStatus","in":"query","description":"The broadcastStatus parameter identifies the state to which the broadcast is changing","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["complete","testing"]}}},{"name":"id","in":"query","description":"The id parameter specifies the unique ID of the broadcast that is transitioning to another status","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/transition","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts/transition"},"summary":"Transition live broadcast","description":"Changes the status of a YouTube live broadcast","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveStreams":{"get":{"tags":["Live Streams"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies a comma-separated list of YouTube stream IDs that identify the streams being retrieved","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"mine","in":"query","description":"The mine parameter can be used to instruct the API to only return streams owned by the authenticated user","schema":{"type":"boolean","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more liveStream resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveStreams/list","api_endpoint":"https://www.googleapis.com/youtube/v3/liveStreams"},"summary":"List live streams","description":"Returns a list of video streams that match the API request parameters","security":[{"bearerAuth":[]}]},"post":{"tags":["Live Streams"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveStreams/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/liveStreams"},"summary":"Insert live stream","description":"Creates a video stream","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cdn":{"type":"object","description":"The cdn object defines the live stream's content delivery network (CDN) settings","required":true,"properties":{"format":{"type":"string","description":"The stream format","required":true,"enum":["720p","1080p","custom"]},"frameRate":{"type":"string","description":"The frame rate"},"ingestionInfo":{"type":"object","description":"Ingestion endpoint information"},"ingestionType":{"type":"string","description":"The ingestion type","enum":["rtmp","hls","dash"]},"resolution":{"type":"string","description":"The video resolution"}}},"contentDetails":{"type":"object","description":"The contentDetails object contains information about the stream, such as its format and ingestion type","properties":{"closedCaptionsIngestionUrl":{"type":"string","description":"The ingestion URL for closed captions"},"enableDvr":{"type":"boolean","description":"Whether the stream supports DVR"},"enableMonitorStream":{"type":"boolean","description":"Whether to enable the monitor stream"},"isReuseable":{"type":"boolean","description":"Whether the stream is reusable"},"monitorStream":{"type":"object","description":"Monitor stream settings"},"recordFromStart":{"type":"boolean","description":"Whether to record from start"},"startWithSlate":{"type":"boolean","description":"Whether to start with a slate screen"}}},"snippet":{"type":"object","description":"The snippet object contains basic details about the stream, including its title and description","required":true,"properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"status":{"type":"object","description":"The status object contains information about the stream's status","properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"cdn":{},"contentDetails":{},"snippet":{},"status":{}}}}}},"put":{"tags":["Live Streams"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}},{"name":"part","in":"query","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","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveStreams/update","api_endpoint":"https://www.googleapis.com/youtube/v3/liveStreams"},"summary":"Update live stream","description":"Updates a video stream","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cdn":{"type":"object","description":"The cdn object defines the live stream's content delivery network (CDN) settings","properties":{"format":{"type":"string","description":"The stream format","required":true,"enum":["720p","1080p","custom"]},"frameRate":{"type":"string","description":"The frame rate"},"ingestionInfo":{"type":"object","description":"Ingestion endpoint information"},"ingestionType":{"type":"string","description":"The ingestion type","enum":["rtmp","hls","dash"]},"resolution":{"type":"string","description":"The video resolution"}}},"contentDetails":{"type":"object","description":"The contentDetails object contains information about the stream, such as its format and ingestion type","properties":{"closedCaptionsIngestionUrl":{"type":"string","description":"The ingestion URL for closed captions"},"enableDvr":{"type":"boolean","description":"Whether the stream supports DVR"},"enableMonitorStream":{"type":"boolean","description":"Whether to enable the monitor stream"},"isReuseable":{"type":"boolean","description":"Whether the stream is reusable"},"monitorStream":{"type":"object","description":"Monitor stream settings"},"recordFromStart":{"type":"boolean","description":"Whether to record from start"},"startWithSlate":{"type":"boolean","description":"Whether to start with a slate screen"}}},"id":{"type":"string","description":"The ID that YouTube uses to uniquely identify the video stream","required":true},"snippet":{"type":"object","description":"The snippet object contains basic details about the stream, including its title and description","properties":{"categoryId":{"type":"string","description":"The YouTube video category associated with the resource"},"channelTitle":{"type":"string","description":"The title of the channel that the resource belongs to"},"defaultAudioLanguage":{"type":"string","description":"The default audio language for the resource"},"defaultLanguage":{"type":"string","description":"The default language of the resource's text metadata"},"description":{"type":"string","description":"The resource's description"},"publishedAt":{"type":"string","description":"The date and time when the resource was published"},"tags":{"type":"array","description":"List of keyword tags associated with the resource"},"thumbnails":{"type":"object","description":"A map of thumbnail images associated with the resource"},"title":{"type":"string","description":"The resource's title"}}},"status":{"type":"object","description":"The status object contains information about the stream's status","properties":{"embeddable":{"type":"boolean","description":"Whether the video can be embedded on another website"},"failureReason":{"type":"string","description":"The reason a video failed to upload","enum":["conversion","invalidFile","uploadAborted"]},"license":{"type":"string","description":"The video's license","enum":["youtube","creativeCommon"]},"privacyStatus":{"type":"string","description":"The privacy status of the resource","enum":["public","unlisted","private"]},"publicStatsViewable":{"type":"boolean","description":"Whether the video's view count is publicly visible"},"publishAt":{"type":"string","description":"The date and time when the video is scheduled to publish"},"rejectionReason":{"type":"string","description":"The reason a video was rejected","enum":["copyright","inappropriate","duplicate","termsOfUse","uploaderAccountSuspended","trademark"]},"selfDeclaredMadeForKids":{"type":"boolean","description":"Whether the video is declared as made for kids"},"uploadStatus":{"type":"string","description":"The video's upload status","enum":["uploaded","processed","failed","rejected","deleted"]}}}}},"example":{"cdn":{},"contentDetails":{},"id":"","snippet":{},"status":{}}}}}},"delete":{"tags":["Live Streams"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube stream ID for the stream that is being deleted","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveStreams/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/liveStreams"},"summary":"Delete live stream","description":"Deletes a video stream","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveChat/messages":{"get":{"tags":["Live Chat"],"parameters":[{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"liveChatId","in":"query","description":"The liveChatId parameter identifies the chat whose messages will be returned","required":true,"schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of messages that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"profileImageSize","in":"query","description":"The profileImageSize parameter specifies the size of the user profile pictures that should be returned in the result set","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/messages/list","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/messages"},"summary":"List live chat messages","description":"Retrieves a list of resources, possibly filtered","security":[{"bearerAuth":[]}]},"post":{"tags":["Live Chat"],"parameters":[{"name":"part","in":"query","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. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/messages/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/messages"},"summary":"Insert live chat message","description":"Inserts a new resource into this collection","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"snippet":{"type":"object","description":"The snippet object contains basic details about the chat message, including the message text, timing and author details","required":true,"properties":{"liveChatId":{"type":"string","description":"The ID of the live chat","required":true},"messageDeleted":{"type":"boolean","description":"Whether the message has been deleted"},"textMessageDetails":{"type":"object","description":"Details of the text message"}}}}},"example":{"snippet":{}}}}}},"delete":{"tags":["Live Chat"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube live chat message ID of the resource that is being deleted","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/messages/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/messages"},"summary":"Delete live chat message","description":"Deletes a chat message","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveChat/moderators":{"get":{"tags":["Live Chat"],"parameters":[{"name":"liveChatId","in":"query","description":"The liveChatId parameter identifies the chat whose moderators will be returned","required":true,"schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/moderators/list","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/moderators"},"summary":"List live chat moderators","description":"Retrieves a list of resources, possibly filtered","security":[{"bearerAuth":[]}]},"post":{"tags":["Live Chat"],"parameters":[{"name":"part","in":"query","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. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/moderators/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/moderators"},"summary":"Insert live chat moderator","description":"Inserts a new resource into this collection","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"snippet":{"type":"object","description":"The snippet object contains basic details about the moderator, including the moderator's identity","required":true,"properties":{"liveChatId":{"type":"string","description":"The ID of the live chat","required":true},"moderatorSnippets":{"type":"array","description":"Moderator snippets"}}}}},"example":{"snippet":{}}}}}},"delete":{"tags":["Live Chat"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the YouTube live chat moderator ID for the resource that is being deleted","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/moderators/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/moderators"},"summary":"Delete live chat moderator","description":"Deletes a chat moderator","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/superChatEvents":{"get":{"tags":["Super Chat Events"],"parameters":[{"name":"hl","in":"query","description":"The hl parameter instructs the API to retrieve localized resource metadata for a specific application language","schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maxResults parameter specifies the maximum number of items that should be returned in the result set","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The pageToken parameter identifies a specific page in the result set that should be returned","schema":{"type":"string","example":""}},{"name":"part","in":"query","description":"The part parameter specifies the superChatEvent resource properties that the API response will include. Set the parameter value to snippet","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/superChatEvents/list","api_endpoint":"https://www.googleapis.com/youtube/v3/superChatEvents"},"summary":"List super chat events","description":"Retrieves a list of resources, possibly filtered","security":[{"bearerAuth":[]}]}},"/v3/channelBanners/insert":{"post":{"tags":["Channel Banners"],"parameters":[{"name":"channelId","in":"query","description":"The channelId parameter identifies the YouTube channel to which the banner is uploaded","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"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","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/channelBanners/insert","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/channelBanners/insert?uploadType=media"},"summary":"Insert channel banner","description":"Uploads a channel banner image (min 2048x1152 px, max 6MB). Returns a URL that must be passed to channels.update (brandingSettings.image.bannerExternalUrl) to apply it.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The banner image file (JPEG or PNG, max 6MB, minimum 2048x1152 px — smaller images are rejected with a generic validation error)","required":true}}},"example":{"file":"(binary)"}}}}}},"/v3/abuseReports":{"post":{"tags":["Abuse Reports"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties that the write operation will set","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/abuseReports/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/abuseReports"},"summary":"Insert abuse report","description":"Inserts a new abuse report resource into this collection","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/comments/markAsSpam":{"post":{"tags":["Comments"],"parameters":[{"name":"id","in":"query","description":"The id parameter flags the comments with the given IDs as spam","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/comments/markAsSpam","api_endpoint":"https://www.googleapis.com/youtube/v3/comments/markAsSpam"},"summary":"Mark comments as spam","description":"Expresses the caller's opinion that one or more comments should be flagged as spam","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveBroadcasts/cuepoint":{"post":{"tags":["Live Broadcasts"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties that the write operation will set","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveBroadcasts/cuepoint","api_endpoint":"https://www.googleapis.com/youtube/v3/liveBroadcasts/cuepoint"},"summary":"Insert cuepoint","description":"Inserts a cuepoint into a live broadcast","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveChat/bans":{"post":{"tags":["Live Chat"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties that the write operation will set","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/bans/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/bans"},"summary":"Insert live chat ban","description":"Inserts a new ban into the live chat","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"delete":{"tags":["Live Chat"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the ban ID to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/bans/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/bans"},"summary":"Delete live chat ban","description":"Removes a ban from the live chat","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/liveChat/messages/transition":{"post":{"tags":["Live Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/liveChat/messages/transition","api_endpoint":"https://www.googleapis.com/youtube/v3/liveChat/messages/transition"},"summary":"Transition live chat message","description":"Transitions the status of a live chat message","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/playlistImages":{"get":{"tags":["Playlist Images"],"parameters":[{"name":"part","in":"query","description":"The part parameter specifies the playlistImage resource properties","required":true,"schema":{"type":"string","example":""}},{"name":"parent","in":"query","description":"The parent param specifies the playlist id whose images to list (required filter)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistImages/list","api_endpoint":"https://www.googleapis.com/youtube/v3/playlistImages"},"summary":"List playlist images","description":"Retrieves a list of playlist images","security":[{"bearerAuth":[]}]},"post":{"tags":["Playlist Images"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties to set","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistImages/insert","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/playlistImages?uploadType=multipart"},"summary":"Insert playlist image","description":"Inserts a new playlist image","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The media file to upload"}}},"example":{"file":"(binary)"}}}}},"put":{"tags":["Playlist Images"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistImages/update","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/playlistImages?uploadType=multipart"},"summary":"Update playlist image","description":"Updates a playlist image","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The media file to upload"}}},"example":{"file":"(binary)"}}}}},"delete":{"tags":["Playlist Images"],"parameters":[{"name":"id","in":"query","description":"The id parameter specifies the playlist image ID to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/playlistImages/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/playlistImages"},"summary":"Delete playlist image","description":"Deletes a playlist image","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/thirdPartyLinks":{"get":{"tags":["Third Party Links"],"parameters":[{"name":"part","in":"query","description":"The part parameter specifies the thirdPartyLink resource properties","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/thirdPartyLinks/list","api_endpoint":"https://www.googleapis.com/youtube/v3/thirdPartyLinks"},"summary":"List third party links","description":"Retrieves a list of third party links","security":[{"bearerAuth":[]}]},"post":{"tags":["Third Party Links"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties to set","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/thirdPartyLinks/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/thirdPartyLinks"},"summary":"Insert third party link","description":"Inserts a new third party link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"put":{"tags":["Third Party Links"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies the properties to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/thirdPartyLinks/update","api_endpoint":"https://www.googleapis.com/youtube/v3/thirdPartyLinks"},"summary":"Update third party link","description":"Updates a third party link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"delete":{"tags":["Third Party Links"],"parameters":[{"name":"linkingToken","in":"query","description":"The linkingToken parameter identifies the third party link to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/thirdPartyLinks/delete","api_endpoint":"https://www.googleapis.com/youtube/v3/thirdPartyLinks"},"summary":"Delete third party link","description":"Deletes a third party link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v3/videoTrainability":{"get":{"tags":["Videos"],"parameters":[{"name":"id","in":"query","description":"The ID of the video to retrieve.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/reference/rest/v3/videoTrainability/get","api_endpoint":"https://www.googleapis.com/youtube/v3/v3/videoTrainability"},"summary":"Get video trainability","description":"Returns the trainability status of a video.","security":[{"bearerAuth":[]}]}},"/v3/videos:batchGetStats":{"get":{"tags":["Videos"],"parameters":[{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more videoStats resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"query","description":"Return videos with the given ids (comma-separated). The number of IDs cannot exceed 50.","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"This parameter is intended exclusively for YouTube content partners","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/reference/rest/v3/videos/batchGetStats","api_endpoint":"https://www.googleapis.com/youtube/v3/v3/videos:batchGetStats"},"summary":"Batch get video stats","description":"Retrieves a batch of VideoStat resources, possibly filtered. BatchGetStats is intentionally not atomic to provide a better user experience.","security":[{"bearerAuth":[]}]}},"/v3/tests":{"post":{"tags":["Tests"],"parameters":[{"name":"part","in":"query","description":"The part parameter specifies a comma-separated list of one or more test resource properties that the API response will include","required":true,"schema":{"type":"string","example":""}},{"name":"externalChannelId","in":"query","description":"The externalChannelId parameter identifies the channel for which tests are being inserted","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwnerChannel","in":"query","description":"This parameter is intended exclusively for YouTube content partners","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/reference/rest/v3/tests/insert","api_endpoint":"https://www.googleapis.com/youtube/v3/v3/tests"},"summary":"Insert test","description":"Inserts a new A/B test for the specified channel (YouTube content partners).","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"snippet":{"type":""}}},"example":{"snippet":""}}}}}},"/v3/videos/resumable":{"post":{"tags":["Videos"],"parameters":[{"name":"part","in":"query","description":"The part parameter identifies properties for the request/response (e.g. snippet,status)","required":true,"schema":{"type":"string","example":""}},{"name":"notifySubscribers","in":"query","description":"Indicates whether YouTube should notify subscribers","schema":{"type":"boolean","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/insert","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable"},"summary":"Upload video (resumable) — step 1: create upload session","description":"Step 1 of the official two-step (resumable) video upload: send the video details as JSON; Google replies with the upload session URL in the Location response header (see response_headers). Then send the video bytes with PUT /v3/videos/resumable/session?upload_url=<that URL>.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"snippet":{"type":"","description":"string"},"status":{"type":""}}},"example":{"snippet":"","status":""}}}}}},"/v3/videos/resumable/session":{"put":{"tags":["Videos"],"parameters":[{"name":"upload_url","in":"query","description":"The session URL from step 1's Location response header","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/v3/docs/videos/insert","api_endpoint":"https://www.googleapis.com/upload/youtube/v3/videos"},"summary":"Upload video (resumable) — step 2: send bytes to session","description":"Step 2 of the official two-step (resumable) video upload: send the video file bytes (raw body or form file) to the session URL returned by step 1. The upload_url host must match Google's upload host.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The video file to upload (video/* or application/octet-stream, max 256 GB)","required":true}}},"example":{"file":"(binary)"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}