@@ -1,12 +1,12 @@
11{
22 "kind": "discovery#restDescription",
3− "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/zZWbZ8DfqCMiADEVSmogUNbI6m4\"",
3+ "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/4auVy5GLotTS3CICB9zLFhVaxUM\"",
44 "discoveryVersion": "v1",
55 "id": "youtube:v3",
66 "name": "youtube",
77 "canonicalName": "YouTube",
88 "version": "v3",
9− "revision": "20160728",
9+ "revision": "20161202",
1010 "title": "YouTube Data API",
1111 "description": "Supports core YouTube features, such as uploading videos, creating and managing playlists, searching for content, and much more.",
1212 "ownerDomain": "google.com",
@@ -762,6 +762,7 @@
762762 "enum": [
763763 "1080p",
764764 "1440p",
765+ "2160p",
765766 "240p",
766767 "360p",
767768 "480p",
@@ -773,6 +774,7 @@
773774 "",
774775 "",
775776 "",
777+ "",
776778 ""
777779 ]
778780 }
@@ -920,10 +922,6 @@
920922 "type": "object",
921923 "description": "Details about the content of a channel.",
922924 "properties": {
923− "googlePlusUserId": {
924− "type": "string",
925− "description": "The googlePlusUserId object identifies the Google+ profile ID associated with this channel."
926− },
927925 "relatedPlaylists": {
928926 "type": "object",
929927 "properties": {
@@ -1572,10 +1570,6 @@
15721570 "type": "string",
15731571 "description": "The name of the user who posted the comment."
15741572 },
1575− "authorGoogleplusProfileUrl": {
1576− "type": "string",
1577− "description": "Link to the author's Google+ profile, if any."
1578− },
15791573 "authorProfileImageUrl": {
15801574 "type": "string",
15811575 "description": "The URL for the avatar of the user who posted the comment."
@@ -1770,7 +1764,7 @@
17701764 "ContentRating": {
17711765 "id": "ContentRating",
17721766 "type": "object",
1773− "description": "Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 68",
1767+ "description": "Ratings schemes. The country-specific ratings are mostly for movies and shows. NEXT_ID: 69",
17741768 "properties": {
17751769 "acbRating": {
17761770 "type": "string",
@@ -2714,6 +2708,30 @@
27142708 ""
27152709 ]
27162710 },
2711+ "mcstRating": {
2712+ "type": "string",
2713+ "description": "The video's rating system for Vietnam - MCST",
2714+ "enum": [
2715+ "mcst0",
2716+ "mcst16plus",
2717+ "mcstC13",
2718+ "mcstC16",
2719+ "mcstC18",
2720+ "mcstGPg",
2721+ "mcstP",
2722+ "mcstUnrated"
2723+ ],
2724+ "enumDescriptions": [
2725+ "",
2726+ "",
2727+ "",
2728+ "",
2729+ "",
2730+ "",
2731+ "",
2732+ ""
2733+ ]
2734+ },
27172735 "mdaRating": {
27182736 "type": "string",
27192737 "description": "The video's rating from Singapore's Media Development Authority (MDA) and, specifically, it's Board of Film Censors (BFC).",
@@ -5195,6 +5213,11 @@
51955213 "videoId": {
51965214 "type": "string",
51975215 "description": "The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request."
5216+ },
5217+ "videoPublishedAt": {
5218+ "type": "string",
5219+ "description": "The date and time that the video was published to YouTube. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.",
5220+ "format": "date-time"
51985221 }
51995222 }
52005223 },
@@ -6371,6 +6394,10 @@
63716394 "type": "string",
63726395 "description": "The length of the video. The tag value is an ISO 8601 duration in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. The # characters preceding the M and S letters are both integers that specify the number of minutes (or seconds) of the video. For example, a value of PT15M51S indicates that the video is 15 minutes and 51 seconds long."
63736396 },
6397+ "hasCustomThumbnail": {
6398+ "type": "boolean",
6399+ "description": "Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader."
6400+ },
63746401 "licensedContent": {
63756402 "type": "boolean",
63766403 "description": "The value of is_license_content indicates whether the video is licensed content."
@@ -6475,10 +6502,6 @@
64756502 ""
64766503 ]
64776504 },
6478− "recordingLocation": {
6479− "$ref": "GeoPoint",
6480− "description": "Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84."
6481− },
64826505 "videoStreams": {
64836506 "type": "array",
64846507 "description": "A list of video streams contained in the uploaded video file. Each item in the list contains detailed metadata about a video stream.",
@@ -6712,9 +6735,18 @@
67126735 "type": "object",
67136736 "description": "Player to be used for a video playback.",
67146737 "properties": {
6738+ "embedHeight": {
6739+ "type": "string",
6740+ "format": "int64"
6741+ },
67156742 "embedHtml": {
67166743 "type": "string",
67176744 "description": "An \u003ciframe\u003e tag that embeds a player that will play the video."
6745+ },
6746+ "embedWidth": {
6747+ "type": "string",
6748+ "description": "The embed width",
6749+ "format": "int64"
67186750 }
67196751 }
67206752 },
@@ -7128,9 +7160,13 @@
71287160 "type": "string",
71297161 "enum": [
71307162 "nonStreamableMov",
7163+ "procsesingHintSpatialAudio",
7164+ "procsesingHintSphericalVideo",
71317165 "sendBestQualityVideo"
71327166 ],
71337167 "enumDescriptions": [
7168+ "",
7169+ "",
71347170 "",
71357171 ""
71367172 ]
@@ -9242,6 +9278,11 @@
92429278 "description": "The id parameter specifies the YouTube playlist item ID for the playlist item that is being deleted. In a playlistItem resource, the id property specifies the playlist item's ID.",
92439279 "required": true,
92449280 "location": "query"
9281+ },
9282+ "onBehalfOfContentOwner": {
9283+ "type": "string",
9284+ "description": "Note: This parameter is intended exclusively for YouTube content partners.\n\nThe onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.",
9285+ "location": "query"
92459286 }
92469287 },
92479288 "parameterOrder": [
@@ -9353,6 +9394,11 @@
93539394 "httpMethod": "PUT",
93549395 "description": "Modifies a playlist item. For example, you could update the item's position in the playlist.",
93559396 "parameters": {
9397+ "onBehalfOfContentOwner": {
9398+ "type": "string",
9399+ "description": "Note: This parameter is intended exclusively for YouTube content partners.\n\nThe onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.",
9400+ "location": "query"
9401+ },
93569402 "part": {
93579403 "type": "string",
93589404 "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.\n\nNote that this method will override the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies. For example, a playlist item can specify a start time and end time, which identify the times portion of the video that should play when users watch the video in the playlist. If your request is updating a playlist item that sets these values, and the request's part parameter value includes the contentDetails part, the playlist item's start and end times will be updated to whatever value the request body specifies. If the request body does not specify values, the existing start and end times will be removed and replaced with the default settings.",
@@ -10365,15 +10411,31 @@
1036510411 "description": "DEPRECATED",
1036610412 "location": "query"
1036710413 },
10414+ "maxHeight": {
10415+ "type": "integer",
10416+ "description": "The maxHeight parameter specifies a maximum height of the embedded player. If maxWidth is provided, maxHeight may not be reached in order to not violate the width request.",
10417+ "format": "uint32",
10418+ "minimum": "72",
10419+ "maximum": "8192",
10420+ "location": "query"
10421+ },
1036810422 "maxResults": {
1036910423 "type": "integer",
10370− "description": "The maxResults parameter specifies the maximum number of items that should be returned in the result set.\n\nNote: This parameter is supported for use in conjunction with the myRating parameter, but it is not supported for use in conjunction with the id parameter.",
10424+ "description": "The maxResults parameter specifies the maximum number of items that should be returned in the result set.\n\nNote: This parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use in conjunction with the id parameter.",
1037110425 "default": "5",
1037210426 "format": "uint32",
1037310427 "minimum": "1",
1037410428 "maximum": "50",
1037510429 "location": "query"
1037610430 },
10431+ "maxWidth": {
10432+ "type": "integer",
10433+ "description": "The maxWidth parameter specifies a maximum width of the embedded player. If maxHeight is provided, maxWidth may not be reached in order to not violate the height request.",
10434+ "format": "uint32",
10435+ "minimum": "72",
10436+ "maximum": "8192",
10437+ "location": "query"
10438+ },
1037710439 "myRating": {
1037810440 "type": "string",
1037910441 "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.",
@@ -10394,7 +10456,7 @@
1039410456 },
1039510457 "pageToken": {
1039610458 "type": "string",
10397− "description": "The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.\n\nNote: This parameter is supported for use in conjunction with the myRating parameter, but it is not supported for use in conjunction with the id parameter.",
10459+ "description": "The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.\n\nNote: This parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use in conjunction with the id parameter.",
1039810460 "location": "query"
1039910461 },
1040010462 "part": {