Api-roll 45: 2017-02-13

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": "\"tbys6C40o18GZwyMen5GMkdK-3s/4auVy5GLotTS3CICB9zLFhVaxUM\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/f81k8b4sv9uLeywfoj2KpL2xcPg\"",
     "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 2882 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/youtube",
                         "https://www.googleapis.com/auth/youtube.force-ssl",
                         "https://www.googleapis.com/auth/youtube.readonly",
                         "https://www.googleapis.com/auth/youtubepartner"
                     ]
                 }
             }
         },
+        "superChatEvents": {
+            "methods": {
+                "list": {
+                    "description": "Lists Super Chat events for a channel.",
+                    "httpMethod": "GET",
+                    "id": "youtube.superChatEvents.list",
+                    "parameterOrder": [
+                        "part"
+                    ],
+                    "parameters": {
+                        "hl": {
+                            "description": "The hl parameter instructs the API to retrieve localized resource metadata for a specific application language that the YouTube website supports. The parameter value must be a language code included in the list returned by the i18nLanguages.list method.\n\nIf localized resource details are available in that language, the resource's snippet.localized object will contain the localized values. However, if localized details are not available, the snippet.localized object will contain resource details in the resource's default language.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "maxResults": {
+                            "default": "5",
+                            "description": "The maxResults parameter specifies the maximum number of items that should be returned in the result set.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "50",
+                            "minimum": "0",
+                            "type": "integer"
+                        },
+                        "pageToken": {
+                            "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.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "part": {
+                            "description": "The part parameter specifies the superChatEvent resource parts that the API response will include. Supported values are id and snippet.",
+                            "location": "query",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "superChatEvents",
+                    "response": {
+                        "$ref": "SuperChatEventListResponse"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/youtube",
+                        "https://www.googleapis.com/auth/youtube.force-ssl",
+                        "https://www.googleapis.com/auth/youtube.readonly"
+                    ]
+                }
+            }
+        },
         "thumbnails": {
             "methods": {
                 "set": {
                     "description": "Uploads a custom video thumbnail to YouTube and sets it for a video.",
                     "httpMethod": "POST",
                     "id": "youtube.thumbnails.set",
                     "mediaUpload": {
                         "accept": [
                             "application/octet-stream",
                             "image/jpeg",
@@ skipping 535 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": "20161202",
+    "revision": "20170130",
     "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 1369 matching lines @@
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ChannelTopicDetails": {
             "description": "Freebase topic information related to the channel.",
             "id": "ChannelTopicDetails",
             "properties": {
+                "topicCategories": {
+                    "description": "A list of Wikipedia URLs that describe the channel's content.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
                 "topicIds": {
                     "description": "A list of Freebase topic IDs associated with the channel. You can retrieve information about each topic using the Freebase Topic API.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
@@ skipping 2953 matching lines @@
                 "retractedMessageId": {
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "LiveChatMessageSnippet": {
             "id": "LiveChatMessageSnippet",
             "properties": {
                 "authorChannelId": {
-                    "description": "The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action",
+                    "description": "The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase",
                     "type": "string"
                 },
                 "displayMessage": {
                     "description": "Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.",
                     "type": "string"
                 },
                 "fanFundingEventDetails": {
                     "$ref": "LiveChatFanFundingEventDetails",
                     "description": "Details about the funding event, this is only set if the type is 'fanFundingEvent'."
                 },
@@ skipping 20 matching lines @@
                     "$ref": "LiveChatPollOpenedDetails"
                 },
                 "pollVotedDetails": {
                     "$ref": "LiveChatPollVotedDetails"
                 },
                 "publishedAt": {
                     "description": "The date and time when the message was orignally published. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.",
                     "format": "date-time",
                     "type": "string"
                 },
+                "superChatDetails": {
+                    "$ref": "LiveChatSuperChatDetails",
+                    "description": "Details about the Super Chat event, this is only set if the type is 'superChatEvent'."
+                },
                 "textMessageDetails": {
                     "$ref": "LiveChatTextMessageDetails",
                     "description": "Details about the text message, this is only set if the type is 'textMessageEvent'."
                 },
                 "type": {
                     "description": "The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.",
                     "enum": [
                         "chatEndedEvent",
                         "fanFundingEvent",
                         "messageDeletedEvent",
                         "messageRetractedEvent",
                         "newSponsorEvent",
                         "pollClosedEvent",
                         "pollEditedEvent",
                         "pollOpenedEvent",
                         "pollVotedEvent",
                         "sponsorOnlyModeEndedEvent",
                         "sponsorOnlyModeStartedEvent",
+                        "superChatEvent",
                         "textMessageEvent",
                         "tombstone",
                         "userBannedEvent"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
+                        "",
                         ""
                     ],
                     "type": "string"
                 },
                 "userBannedDetails": {
                     "$ref": "LiveChatUserBannedMessageDetails"
                 }
             },
             "type": "object"
         },
@@ skipping 145 matching lines @@
                     "description": "The poll item the user chose.",
                     "type": "string"
                 },
                 "pollId": {
                     "description": "The poll the user voted on.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "LiveChatSuperChatDetails": {
+            "id": "LiveChatSuperChatDetails",
+            "properties": {
+                "amountDisplayString": {
+                    "description": "A rendered string that displays the fund amount and currency to the user.",
+                    "type": "string"
+                },
+                "amountMicros": {
+                    "description": "The amount purchased by the user, in micros (1,750,000 micros = 1.75).",
+                    "format": "uint64",
+                    "type": "string"
+                },
+                "currency": {
+                    "description": "The currency in which the purchase was made.",
+                    "type": "string"
+                },
+                "tier": {
+                    "description": "The tier in which the amount belongs to. Lower amounts belong to lower tiers. Starts at 1.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "userComment": {
+                    "description": "The comment added by the user to this Super Chat event.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "LiveChatTextMessageDetails": {
             "id": "LiveChatTextMessageDetails",
             "properties": {
                 "messageText": {
                     "description": "The user's message.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
@@ skipping 1234 matching lines @@
                     "$ref": "ThumbnailDetails",
                     "description": "Thumbnails for this subscriber."
                 },
                 "title": {
                     "description": "The title of the subscriber.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "SuperChatEvent": {
+            "description": "A superChatEvent resource represents a Super Chat purchase on a YouTube channel.",
+            "id": "SuperChatEvent",
+            "properties": {
+                "etag": {
+                    "description": "Etag of this resource.",
+                    "type": "string"
+                },
+                "id": {
+                    "description": "The ID that YouTube assigns to uniquely identify the Super Chat event.",
+                    "type": "string"
+                },
+                "kind": {
+                    "default": "youtube#superChatEvent",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#superChatEvent\".",
+                    "type": "string"
+                },
+                "snippet": {
+                    "$ref": "SuperChatEventSnippet",
+                    "description": "The snippet object contains basic details about the Super Chat event."
+                }
+            },
+            "type": "object"
+        },
+        "SuperChatEventListResponse": {
+            "id": "SuperChatEventListResponse",
+            "properties": {
+                "etag": {
+                    "description": "Etag of this resource.",
+                    "type": "string"
+                },
+                "eventId": {
+                    "description": "Serialized EventId of the request which produced this response.",
+                    "type": "string"
+                },
+                "items": {
+                    "description": "A list of Super Chat purchases that match the request criteria.",
+                    "items": {
+                        "$ref": "SuperChatEvent"
+                    },
+                    "type": "array"
+                },
+                "kind": {
+                    "default": "youtube#superChatEventListResponse",
+                    "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#superChatEventListResponse\".",
+                    "type": "string"
+                },
+                "nextPageToken": {
+                    "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.",
+                    "type": "string"
+                },
+                "pageInfo": {
+                    "$ref": "PageInfo"
+                },
+                "tokenPagination": {
+                    "$ref": "TokenPagination"
+                },
+                "visitorId": {
+                    "description": "The visitorId identifies the visitor.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "SuperChatEventSnippet": {
+            "id": "SuperChatEventSnippet",
+            "properties": {
+                "amountMicros": {
+                    "description": "The purchase amount, in micros of the purchase currency. e.g., 1 is represented as 1000000.",
+                    "format": "uint64",
+                    "type": "string"
+                },
+                "channelId": {
+                    "description": "Channel id where the event occurred.",
+                    "type": "string"
+                },
+                "commentText": {
+                    "description": "The text contents of the comment left by the user.",
+                    "type": "string"
+                },
+                "createdAt": {
+                    "description": "The date and time when the event occurred. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.",
+                    "format": "date-time",
+                    "type": "string"
+                },
+                "currency": {
+                    "description": "The currency in which the purchase was made. ISO 4217.",
+                    "type": "string"
+                },
+                "displayString": {
+                    "description": "A rendered string that displays the purchase amount and currency (e.g., \"$1.00\"). The string is rendered for the given language.",
+                    "type": "string"
+                },
+                "messageType": {
+                    "description": "The tier for the paid message, which is based on the amount of money spent to purchase the message.",
+                    "format": "uint32",
+                    "type": "integer"
+                },
+                "supporterDetails": {
+                    "$ref": "ChannelProfileDetails",
+                    "description": "Details about the supporter."
+                }
+            },
+            "type": "object"
+        },
         "Thumbnail": {
             "description": "A thumbnail is an image representing a YouTube resource.",
             "id": "Thumbnail",
             "properties": {
                 "height": {
                     "description": "(Optional) Height of the thumbnail image.",
                     "format": "uint32",
                     "type": "integer"
                 },
                 "url": {
@@ skipping 1170 matching lines @@
                 },
                 "processingErrors": {
                     "description": "A list of errors that will prevent YouTube from successfully processing the uploaded video video. These errors indicate that, regardless of the video's current processing status, eventually, that status will almost certainly be failed.",
                     "items": {
                         "enum": [
                             "archiveFile",
                             "audioFile",
                             "docFile",
                             "imageFile",
                             "notAVideoFile",
-                            "projectFile"
+                            "projectFile",
+                            "unsupportedSpatialAudioLayout"
                         ],
                         "enumDescriptions": [
                             "",
                             "",
                             "",
                             "",
                             "",
+                            "",
                             ""
                         ],
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "processingHints": {
                     "description": "A list of suggestions that may improve YouTube's ability to process the video.",
                     "items": {
                         "enum": [
                             "nonStreamableMov",
-                            "procsesingHintSpatialAudio",
-                            "procsesingHintSphericalVideo",
-                            "sendBestQualityVideo"
+                            "sendBestQualityVideo",
+                            "spatialAudio",
+                            "sphericalVideo",
+                            "vrVideo"
                         ],
                         "enumDescriptions": [
                             "",
                             "",
                             "",
+                            "",
                             ""
                         ],
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "processingWarnings": {
                     "description": "A list of reasons why YouTube may have difficulty transcoding the uploaded video or that might result in an erroneous transcoding. These warnings are generated before YouTube actually processes the uploaded video file. In addition, they identify issues that are unlikely to cause the video processing to fail but that might cause problems such as sync issues, video artifacts, or a missing audio track.",
                     "items": {
                         "enum": [
                             "hasEditlist",
                             "inconsistentResolution",
                             "problematicAudioCodec",
                             "problematicVideoCodec",
                             "unknownAudioCodec",
                             "unknownContainer",
-                            "unknownVideoCodec"
+                            "unknownVideoCodec",
+                            "unsupportedSphericalProjectionType",
+                            "unsupportedVrStereoMode"
                         ],
                         "enumDescriptions": [
                             "",
                             "",
                             "",
                             "",
                             "",
                             "",
+                            "",
+                            "",
                             ""
                         ],
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "tagSuggestions": {
                     "description": "A list of keyword tags that could be added to the video's metadata to increase the likelihood that users will locate your video when searching or browsing on YouTube.",
                     "items": {
                         "$ref": "VideoSuggestionsTagSuggestion"
@@ skipping 25 matching lines @@
             "description": "Freebase topic information related to the video.",
             "id": "VideoTopicDetails",
             "properties": {
                 "relevantTopicIds": {
                     "description": "Similar to topic_id, except that these topics are merely relevant to the video. These are topics that may be mentioned in, or appear in the video. You can retrieve information about each topic using Freebase Topic API.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
+                "topicCategories": {
+                    "description": "A list of Wikipedia URLs that provide a high-level description of the video's content.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
                 "topicIds": {
                     "description": "A list of Freebase topic IDs that are centrally associated with the video. These are topics that are centrally featured in the video, and it can be said that the video is mainly about each of these. You can retrieve information about each topic using the Freebase Topic API.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
@@ skipping 14 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "youtube/v3/",
     "title": "YouTube Data API",
     "version": "v3"
 }