Api-roll 42: 2016-11-08

discovery/googleapis/youtube__v3.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/youtube": {
                     "description": "Manage your YouTube account"
                 },
                 "https://www.googleapis.com/auth/youtube.force-ssl": {
                     "description": "Manage your YouTube account"
                 },
@@ skipping 12 matching lines @@
             }
         }
     },
     "basePath": "/youtube/v3/",
     "baseUrl": "https://www.googleapis.com/youtube/v3/",
     "batchPath": "batch",
     "canonicalName": "YouTube",
     "description": "Supports core YouTube features, such as uploading videos, creating and managing playlists, searching for content, and much more.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/youtube/v3",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/pZJ6FrWelp1JEEvc4KJivkB6dHw\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/A3ttvUq-FH-9G6uAbfXxwyLfegU\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/youtube-16.png",
         "x32": "https://www.google.com/images/icons/product/youtube-32.png"
     },
     "id": "youtube:v3",
     "kind": "discovery#restDescription",
     "name": "youtube",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 2050 matching lines @@
                     "id": "youtube.playlistItems.delete",
                     "parameterOrder": [
                         "id"
                     ],
                     "parameters": {
                         "id": {
                             "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.",
                             "location": "query",
                             "required": true,
                             "type": "string"
+                        },
+                        "onBehalfOfContentOwner": {
+                            "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.",
+                            "location": "query",
+                            "type": "string"
                         }
                     },
                     "path": "playlistItems",
                     "scopes": [
                         "https://www.googleapis.com/auth/youtube",
                         "https://www.googleapis.com/auth/youtube.force-ssl",
                         "https://www.googleapis.com/auth/youtubepartner"
                     ]
                 },
                 "insert": {
@@ skipping 91 matching lines @@
                     "supportsSubscription": true
                 },
                 "update": {
                     "description": "Modifies a playlist item. For example, you could update the item's position in the playlist.",
                     "httpMethod": "PUT",
                     "id": "youtube.playlistItems.update",
                     "parameterOrder": [
                         "part"
                     ],
                     "parameters": {
+                        "onBehalfOfContentOwner": {
+                            "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.",
+                            "location": "query",
+                            "type": "string"
+                        },
                         "part": {
                             "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.",
                             "location": "query",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "playlistItems",
                     "request": {
                         "$ref": "PlaylistItem"
@@ skipping 992 matching lines @@
                         "id": {
                             "description": "The id parameter specifies a comma-separated list of the YouTube video ID(s) for the resource(s) that are being retrieved. In a video resource, the id property specifies the video's ID.",
                             "location": "query",
                             "type": "string"
                         },
                         "locale": {
                             "description": "DEPRECATED",
                             "location": "query",
                             "type": "string"
                         },
+                        "maxHeight": {
+                            "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.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "8192",
+                            "minimum": "72",
+                            "type": "integer"
+                        },
                         "maxResults": {
                             "default": "5",
                             "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.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "50",
                             "minimum": "1",
                             "type": "integer"
                         },
+                        "maxWidth": {
+                            "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.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "8192",
+                            "minimum": "72",
+                            "type": "integer"
+                        },
                         "myRating": {
                             "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.",
                             "enum": [
                                 "dislike",
                                 "like"
                             ],
                             "enumDescriptions": [
                                 "Returns only videos disliked by the authenticated user.",
                                 "Returns only video liked by the authenticated user."
                             ],
@@ skipping 209 matching lines @@
                     "path": "watermarks/unset",
                     "scopes": [
                         "https://www.googleapis.com/auth/youtube",
                         "https://www.googleapis.com/auth/youtube.force-ssl",
                         "https://www.googleapis.com/auth/youtubepartner"
                     ]
                 }
             }
         }
     },
-    "revision": "20160805",
+    "revision": "20161017",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AccessPolicy": {
             "description": "Rights management policy for YouTube resources.",
             "id": "AccessPolicy",
             "properties": {
                 "allowed": {
                     "description": "The value of allowed indicates whether the access to the policy is allowed or denied by default.",
                     "type": "boolean"
                 },
@@ skipping 809 matching lines @@
                     "$ref": "WatchSettings",
                     "description": "Branding properties for the watch page."
                 }
             },
             "type": "object"
         },
         "ChannelContentDetails": {
             "description": "Details about the content of a channel.",
             "id": "ChannelContentDetails",
             "properties": {
-                "googlePlusUserId": {
-                    "description": "The googlePlusUserId object identifies the Google+ profile ID associated with this channel.",
-                    "type": "string"
-                },
                 "relatedPlaylists": {
                     "properties": {
                         "favorites": {
                             "description": "The ID of the playlist that contains the channel\"s favorite videos. Use the  playlistItems.insert and  playlistItems.delete to add or remove items from that list.",
                             "type": "string"
                         },
                         "likes": {
                             "description": "The ID of the playlist that contains the channel\"s liked videos. Use the   playlistItems.insert and  playlistItems.delete to add or remove items from that list.",
                             "type": "string"
                         },
@@ skipping 628 matching lines @@
                     "type": "any"
                 },
                 "authorChannelUrl": {
                     "description": "Link to the author's YouTube channel, if any.",
                     "type": "string"
                 },
                 "authorDisplayName": {
                     "description": "The name of the user who posted the comment.",
                     "type": "string"
                 },
-                "authorGoogleplusProfileUrl": {
-                    "description": "Link to the author's Google+ profile, if any.",
-                    "type": "string"
-                },
                 "authorProfileImageUrl": {
                     "description": "The URL for the avatar of the user who posted the comment.",
                     "type": "string"
                 },
                 "canRate": {
                     "description": "Whether the current viewer can rate this comment.",
                     "type": "boolean"
                 },
                 "channelId": {
                     "description": "The id of the corresponding YouTube channel. In case of a channel comment this is the channel the comment refers to. In case of a video comment it's the video's channel.",
@@ skipping 4775 matching lines @@
                     "type": "string"
                 },
                 "dimension": {
                     "description": "The value of dimension indicates whether the video is available in 3D or in 2D.",
                     "type": "string"
                 },
                 "duration": {
                     "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.",
                     "type": "string"
                 },
+                "hasCustomThumbnail": {
+                    "description": "Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video uploader.",
+                    "type": "boolean"
+                },
                 "licensedContent": {
                     "description": "The value of is_license_content indicates whether the video is licensed content.",
                     "type": "boolean"
                 },
                 "projection": {
                     "description": "Specifies the projection format of the video.",
                     "enum": [
                         "360",
                         "rectangular"
                     ],
@@ skipping 84 matching lines @@
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 },
-                "recordingLocation": {
-                    "$ref": "GeoPoint",
-                    "description": "Geographic coordinates that identify the place where the uploaded video was recorded. Coordinates are defined using WGS 84."
-                },
                 "videoStreams": {
                     "description": "A list of video streams contained in the uploaded video file. Each item in the list contains detailed metadata about a video stream.",
                     "items": {
                         "$ref": "VideoFileDetailsVideoStream"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
@@ skipping 213 matching lines @@
                     "$ref": "AccessPolicy",
                     "description": "The value of access indicates whether the video can be monetized or not."
                 }
             },
             "type": "object"
         },
         "VideoPlayer": {
             "description": "Player to be used for a video playback.",
             "id": "VideoPlayer",
             "properties": {
+                "embedHeight": {
+                    "format": "int64",
+                    "type": "string"
+                },
                 "embedHtml": {
                     "description": "An <iframe> tag that embeds a player that will play the video.",
                     "type": "string"
+                },
+                "embedWidth": {
+                    "description": "The embed width",
+                    "format": "int64",
+                    "type": "string"
                 }
             },
             "type": "object"
         },
         "VideoProcessingDetails": {
             "description": "Describes processing status and progress and availability of some other Video resource parts.",
             "id": "VideoProcessingDetails",
             "properties": {
                 "editorSuggestionsAvailability": {
                     "description": "This value indicates whether video editing suggestions, which might improve video quality or the playback experience, are available for the video. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.",
@@ skipping 499 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "youtube/v3/",
     "title": "YouTube Data API",
     "version": "v3"
 }