{ "opencollection": "1.0.0", "info": { "name": "YouTube Data API v3", "version": "v3" }, "request": { "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://accounts.google.com/o/oauth2/auth", "accessTokenUrl": "https://oauth2.googleapis.com/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "items": [ { "info": { "name": "Videos", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Videos", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/videos", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of YouTube video IDs for the resources being retrieved." }, { "name": "chart", "value": "mostPopular", "type": "query", "description": "Identifies the chart that the API returns chart data for. Acceptable values are mostPopular and videoCategoryId." }, { "name": "myRating", "value": "like", "type": "query", "description": "Set this parameter to like or dislike to instruct the API to return only videos liked or disliked by the authenticated user." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of videos that match the API request parameters. Requires the part parameter to specify the video resource properties to include in the response." }, { "info": { "name": "Youtube Upload or Insert a Video", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/videos", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Uploads a video to YouTube and optionally sets the video's metadata. This method supports media upload and requires the part parameter to specify the video resource properties to set." }, { "info": { "name": "Youtube Update Video Metadata", "type": "http" }, "http": { "method": "PUT", "url": "https://www.googleapis.com/youtube/v3/videos", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates a video's metadata. This method supports patch semantics and requires the part parameter to specify the video resource properties to update." }, { "info": { "name": "Youtube Delete a Video", "type": "http" }, "http": { "method": "DELETE", "url": "https://www.googleapis.com/youtube/v3/videos", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the video to delete." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Deletes a YouTube video. The authenticated user must own the video or be authorized to delete it." }, { "info": { "name": "Youtube Rate a Video", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/videos/rate", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the video to rate." }, { "name": "rating", "value": "like", "type": "query", "description": "The rating to record. Valid values are like, dislike, and none." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Adds a like or dislike rating to a video or removes a rating from a video. The authenticated user must be authorized to rate videos." } ] }, { "info": { "name": "Channels", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Channels", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/channels", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of YouTube channel IDs for the resources being retrieved." }, { "name": "mine", "value": "true", "type": "query", "description": "Set this parameter to true to instruct the API to return channels owned by the authenticated user." }, { "name": "forUsername", "value": "example_value", "type": "query", "description": "A YouTube username identifying a channel. The API returns the channel associated with that username." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a collection of zero or more channel resources that match the request criteria. Use the part parameter to specify the channel resource properties to include." }, { "info": { "name": "Youtube Update Channel Metadata", "type": "http" }, "http": { "method": "PUT", "url": "https://www.googleapis.com/youtube/v3/channels", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates a channel's metadata. The authenticated user must own the channel being updated. Use the part parameter to specify the channel properties to update." } ] }, { "info": { "name": "Playlists", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Playlists", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/playlists", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of YouTube playlist IDs for the resources being retrieved." }, { "name": "channelId", "value": "500123", "type": "query", "description": "Indicates that the API response should only contain resources created by the channel." }, { "name": "mine", "value": "true", "type": "query", "description": "Set this parameter to true to instruct the API to return playlists owned by the authenticated user." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a collection of playlists that match the API request parameters. You can retrieve playlists by ID, by channel, or for the authenticated user." }, { "info": { "name": "Youtube Create a Playlist", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/playlists", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a playlist on behalf of the authenticated user. The user must be authorized to create playlists." }, { "info": { "name": "Youtube Update a Playlist", "type": "http" }, "http": { "method": "PUT", "url": "https://www.googleapis.com/youtube/v3/playlists", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Modifies a playlist. The authenticated user must own the playlist being updated. Use the part parameter to specify the properties being updated." }, { "info": { "name": "Youtube Delete a Playlist", "type": "http" }, "http": { "method": "DELETE", "url": "https://www.googleapis.com/youtube/v3/playlists", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the playlist to delete." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Deletes a playlist. The authenticated user must own the playlist or be authorized to delete it." } ] }, { "info": { "name": "PlaylistItems", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Playlist Items", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/playlistItems", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "playlistId", "value": "500123", "type": "query", "description": "Identifies the playlist whose items are being listed. Required unless the id parameter specifies playlist item IDs." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of playlist item IDs for the resources being retrieved." }, { "name": "videoId", "value": "500123", "type": "query", "description": "Specifies that the request should return only items containing the given video." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a collection of playlist items that match the API request parameters. You can retrieve all items in a specified playlist or retrieve one or more playlist items by their unique IDs." }, { "info": { "name": "Youtube Add an Item to a Playlist", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/playlistItems", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Adds a resource to a playlist. The authenticated user must own the playlist or be authorized to add items to it." }, { "info": { "name": "Youtube Remove a Playlist Item", "type": "http" }, "http": { "method": "DELETE", "url": "https://www.googleapis.com/youtube/v3/playlistItems", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the playlist item to delete." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Deletes a playlist item. The authenticated user must own the playlist or be authorized to remove items from it." } ] }, { "info": { "name": "Search", "type": "folder" }, "items": [ { "info": { "name": "Youtube Search Youtube", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/search", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "q", "value": "youtube api tutorial", "type": "query", "description": "The query term to search for." }, { "name": "type", "value": "video", "type": "query", "description": "Restricts a search query to only retrieve a particular type of resource. Acceptable values are channel, playlist, and video." }, { "name": "channelId", "value": "500123", "type": "query", "description": "Indicates that the API response should only contain resources created by the channel." }, { "name": "order", "value": "date", "type": "query", "description": "Specifies the method that will be used to order resources in the API response. Acceptable values are date, rating, relevance, title, videoCount, and viewCount." }, { "name": "publishedAfter", "value": "2026-01-15T10:30:00Z", "type": "query", "description": "Restricts results to only include resources created at or after the specified time, in RFC 3339 format." }, { "name": "publishedBefore", "value": "2026-01-15T10:30:00Z", "type": "query", "description": "Restricts results to only include resources created before or at the specified time, in RFC 3339 format." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a collection of search results that match the query parameters specified in the API request. By default, a search result set identifies matching video, channel, and playlist resources, but you can also configure queries to only retrieve a specific type of resource." } ] }, { "info": { "name": "Subscriptions", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Subscriptions", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/subscriptions", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of YouTube subscription IDs for the resources being retrieved." }, { "name": "mine", "value": "true", "type": "query", "description": "Set this parameter to true to retrieve the subscriptions of the authenticated user." }, { "name": "channelId", "value": "500123", "type": "query", "description": "Retrieves subscriptions for the channel with the specified YouTube channel ID." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns subscription resources that match the API request criteria. Retrieve subscriptions for the authenticated user, a specific channel, or by subscription IDs." }, { "info": { "name": "Youtube Subscribe to a Channel", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/subscriptions", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Adds a subscription for the authenticated user. The authenticated user must be authorized to create subscriptions." }, { "info": { "name": "Youtube Unsubscribe From a Channel", "type": "http" }, "http": { "method": "DELETE", "url": "https://www.googleapis.com/youtube/v3/subscriptions", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the subscription to delete." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Deletes a subscription. The authenticated user must own the subscription being deleted." } ] }, { "info": { "name": "Comments", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Comments", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/comments", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of comment IDs for the resources being retrieved." }, { "name": "parentId", "value": "500123", "type": "query", "description": "Identifies the comment thread whose comments are being listed. Required unless the id parameter specifies comment IDs directly." }, { "name": "textFormat", "value": "html", "type": "query", "description": "Specifies whether the API should return comments formatted as HTML or plain text." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of comments that match the API request parameters. Use the part parameter to specify the comment resource properties to include in the response." }, { "info": { "name": "Youtube Create a Comment", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/comments", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a reply to an existing comment. To add a top-level comment to a video or channel discussion, use the commentThreads.insert method." }, { "info": { "name": "Youtube Update a Comment", "type": "http" }, "http": { "method": "PUT", "url": "https://www.googleapis.com/youtube/v3/comments", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Modifies a comment. The authenticated user must own the comment being updated." }, { "info": { "name": "Youtube Delete a Comment", "type": "http" }, "http": { "method": "DELETE", "url": "https://www.googleapis.com/youtube/v3/comments", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the comment to delete." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Deletes a comment. The authenticated user must own the comment or be authorized to delete it." }, { "info": { "name": "Youtube Set Comment Moderation Status", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/comments/setModerationStatus", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of comment IDs to set moderation status for." }, { "name": "moderationStatus", "value": "heldForReview", "type": "query", "description": "Identifies the new moderation status. Acceptable values are heldForReview, published, and rejected." }, { "name": "banAuthor", "value": "true", "type": "query", "description": "Set to true to ban the comment author from making future comments on the channel or video." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Sets the moderation status of one or more comments. The authenticated user must be authorized to moderate comments for the associated video or channel." } ] }, { "info": { "name": "CommentThreads", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Comment Threads", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/commentThreads", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of comment thread IDs for the resources being retrieved." }, { "name": "videoId", "value": "500123", "type": "query", "description": "Instructs the API to return comment threads for the video with the specified ID." }, { "name": "channelId", "value": "500123", "type": "query", "description": "Instructs the API to return comment threads for the channel with the specified ID." }, { "name": "moderationStatus", "value": "heldForReview", "type": "query", "description": "Set this parameter to limit the returned comment threads to only those with the specified moderation status." }, { "name": "maxResults", "value": "", "type": "query", "description": "The maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive." }, { "name": "pageToken", "value": "", "type": "query", "description": "Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages available." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of comment threads that match the API request parameters. The response includes top-level comments and optionally their replies." }, { "info": { "name": "Youtube Create a Comment Thread", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/commentThreads", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new top-level comment. To add a reply to an existing comment, use the comments.insert method." }, { "info": { "name": "Youtube Update a Comment Thread", "type": "http" }, "http": { "method": "PUT", "url": "https://www.googleapis.com/youtube/v3/commentThreads", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Modifies the top-level comment in a comment thread. The authenticated user must own the comment being updated." } ] }, { "info": { "name": "Captions", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Caption Tracks", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/captions", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "videoId", "value": "500123", "type": "query", "description": "The ID of the video for which the API should return caption tracks." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of caption track IDs to retrieve." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of caption tracks that are associated with a specified video. The API response does not contain the actual captions and the captions.download method can be used to retrieve a caption track." }, { "info": { "name": "Youtube Upload a Caption Track", "type": "http" }, "http": { "method": "POST", "url": "https://www.googleapis.com/youtube/v3/captions", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Uploads a caption track. The authenticated user must own the video associated with the caption track. This method supports media upload." }, { "info": { "name": "Youtube Update a Caption Track", "type": "http" }, "http": { "method": "PUT", "url": "https://www.googleapis.com/youtube/v3/captions", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates a caption track. When updating a caption track, you can change the track's draft status, upload a new caption file, or both." }, { "info": { "name": "Youtube Delete a Caption Track", "type": "http" }, "http": { "method": "DELETE", "url": "https://www.googleapis.com/youtube/v3/captions", "params": [ { "name": "id", "value": "abc123def456", "type": "query", "description": "The ID of the caption track to delete." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Deletes a specified caption track. The authenticated user must own the video that the caption track is associated with." } ] }, { "info": { "name": "VideoCategories", "type": "folder" }, "items": [ { "info": { "name": "Youtube List Video Categories", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/videoCategories", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "regionCode", "value": "US", "type": "query", "description": "Instructs the API to return the list of video categories available in the specified country." }, { "name": "id", "value": "abc123def456", "type": "query", "description": "Comma-separated list of video category IDs to retrieve." }, { "name": "hl", "value": "example_value", "type": "query", "description": "Specifies the language that will be used for text values in the API response." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of categories that can be associated with YouTube videos. Provide the hl parameter to specify the language for category names and regionCode to filter by region." } ] }, { "info": { "name": "I18n", "type": "folder" }, "items": [ { "info": { "name": "Youtube List I18n Languages", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/i18nLanguages", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "hl", "value": "example_value", "type": "query", "description": "Specifies the language that should be used for text values in the API response." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of application languages that the YouTube website supports. The list includes both the language code and the human-readable name of each supported language." }, { "info": { "name": "Youtube List I18n Regions", "type": "http" }, "http": { "method": "GET", "url": "https://www.googleapis.com/youtube/v3/i18nRegions", "params": [ { "name": "part", "value": "", "type": "query", "description": "Specifies a comma-separated list of one or more resource properties that the API response will include. The part parameter value must include the id property." }, { "name": "hl", "value": "example_value", "type": "query", "description": "Specifies the language that should be used for text values in the API response." }, { "name": "fields", "value": "", "type": "query", "description": "Selector specifying which fields to include in a partial response. Use this parameter to reduce bandwidth usage by selecting only the fields you need." }, { "name": "key", "value": "", "type": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." } ] }, "docs": "Returns a list of content regions that the YouTube website supports. The list includes region codes and human-readable names used for region-specific content filtering." } ] } ], "bundled": true }