Fix various api documentation issues (#616)

* Fix various documentation issues

* improve documentation for videos api endpoint

* Add badges to video common_type and add sort_by for channel shorts and streams

docs/api.md

@@ -117,11 +117,20 @@ All endpoints that return a JSON body support `&hl=LANGUAGE` for translating fie
       "type": String,
       "clen": String,
       "lmt": String,
-      "projectionType": Int32,
+      "projectionType": String,
       "container": String,
       "encoding": String,
       "qualityLabel": String?,
-      "resolution": String?
+      "resolution": String?,
+      "fps": Int32,
+      "size": String?,
+      "targetDurationsec": Int64?,
+      "maxDvrDurationSec": Int64?,
+      "audioQuality": String?,
+      "audioSampleRate": String?,
+      "audioChannels": String?,
+      "colorInfo": String?,
+      "captionTrack": String?
     }
   ],
   "formatStreams": [
@@ -130,6 +139,7 @@ All endpoints that return a JSON body support `&hl=LANGUAGE` for translating fie
       "itag": String,
       "type": String,
       "quality": String,
+      "bitrate": String?,
       "container": String,
       "encoding": String,
       "qualityLabel": String,
@@ -140,10 +150,18 @@ All endpoints that return a JSON body support `&hl=LANGUAGE` for translating fie
   "captions": [
     {
       "label": String,
-      "languageCode": String,
+      "language_code": String,
       "url": String
     }
   ],
+  "musicTracks": [
+    {
+      "song": String,
+      "artist": String,
+      "album": String,
+      "license": String
+    }
+  ],
   "recommendedVideos": [
     {
       "videoId": String,
@@ -157,7 +175,18 @@ All endpoints that return a JSON body support `&hl=LANGUAGE` for translating fie
         }
       ],
       "author": String,
+      "authorUrl": String,
+      "authorId": String?,
+      "authorVerified": Boolean,
+      "authorThumbnails": [
+        {
+          "url": string,
+          "width": Int32,
+          "height": Int32
+        }
+      ],
       "lengthSeconds": Int32,
+      "viewCount": 
       "viewCountText": String
     }
   ]
@@ -203,6 +232,8 @@ Returns annotation XML from YouTube's `/annotations_invideo` endpoint. Alternati
 
       "isEdited": Boolean,
       "isPinned": Boolean,
+      "isSponsor": Boolean?,
+      "sponsorIconUrl": String?,
 
       "content": String,
       "contentHtml": String,
@@ -430,6 +461,13 @@ q: String
     videoCount: Int32,
     description: String,
     descriptionHtml: String
+  },
+  {
+    type: "hashtag"
+    title: String,
+    url: String,
+    channelCount: Int32,
+    videoCount: Int32
   }
 ];
 ```
@@ -470,6 +508,7 @@ region: ISO 3166 country code (default: "US")
 
     "videoCount": Int32,
     "viewCount": Int64,
+    "viewCountText": String,
     "updated": Int64,
 
     "videos": [

docs/api/channels_endpoint.md

@@ -124,6 +124,7 @@ This is the same as requesting `/api/v1/channels/:id/videos` without URL paramet
 > URL parameters:
 
 * `continuation`: A continuation token to get the next chunk of items. The token is provided each time this API is requested.
+* `sort_by`: Sort order filter. Accepted values: `newest`, `popular` or `oldest`
 
 > Response:
 
@@ -135,6 +136,7 @@ See: GET `/api/v1/channels/:id/videos`
 > URL parameters:
 
 * `continuation`: A continuation token to get the next chunk of items. The token is provided each time this API is requested.
+* `sort_by`: Sort order filter. Accepted values: `newest`, `popular` or `oldest`
 
 > Response:
 

docs/api/common_types.md

@@ -57,7 +57,15 @@
 
 	"liveNow": Boolean,
 	"premium": Boolean,
-	"isUpcoming": Boolean
+	"isUpcoming": Boolean,
+
+	"isNew" Boolean,
+	"is4k": Boolean,
+	"is8k": Boolean,
+	"isVr180": Boolean,
+	"isVr360": Boolean,
+	"is3d": Boolean,
+	"hasCaptions": Boolean
 }
 ```