Add 'type' and 'id' fields to subscription objects

Author: SamantazFox

README.md

@@ -19,7 +19,7 @@ Potential suffixes: `-draft`, TBD
 
 #### `"subscriptions"`
 
-An array of Subscription objects. See below for details.
+An array of [subscription objects](spec/subscription_object).
 
 #### `"playlists"`
 
@@ -40,36 +40,11 @@ Indicates whether the special playlist `watch_history` was included in the expor
 {
 	"version": "X.Y.Z[-draft/-rc]",
 	"watch_history_present": Boolean,
-	"subscriptions": Subscriptions[],
+	"subscriptions": SubscriptionObject[],
 	"playlists": String[],
 }
 ```
 
-## Subscription object
-
-#### > `"name"`
-
-The name of the subscribed channel.
-
-#### > `"url"`
-
-The URL used to access the user subscribed channel.
-
-#### > `"thumbnail"`
-
-The URL to the user/channel's thumbnail.
-
-### Example
-
-```javascript
-{
-  "name": "Linus Tech Tips",
-  "url": "https://www.youtube.com/channel/UCXuqSBlHAE6Xw-yeJA0Tunw",
-  "thumbnail": "https://yt3.ggpht.com/ytc/abcdef..."
-}
-```
-
-
 ## Playlist file (`playlist_xxx.json`)
 
 A playlist file MUST contain the data of a single playlist created by the user.

examples/main.json

@@ -2,6 +2,8 @@
 	"version": "0.0.2-draft",
 	"subscriptions": [
 		{
+			"type": "youtube",
+			"id": "UCXuqSBlHAE6Xw-yeJA0Tunw",
 			"name": "Linus Tech Tips",
 			"url": "https://www.youtube.com/channel/UCXuqSBlHAE6Xw-yeJA0Tunw",
 			"thumbnail": "https://yt3.ggpht.com/ytc/[snip]"

spec/subscription_object.md

@@ -0,0 +1,43 @@
+# Subscription object
+
+#### > `"type"`
+
+The type of the service this entry refers to.
+
+This field is a short and meaningful identifier that prevents the parser from
+trying to guess the name of the service from the `url` present in this object.
+
+#### > `"id"`
+
+The ID of the subscribed channel.
+
+The format if this ID is service-dependant.
+
+The only requirement being the uniqueness of the ID in the service.
+E.g: All youtube channel IDs (starting with `UC`) are unique to eachother.
+
+#### > `"name"`
+
+The name of the subscribed channel.
+
+#### > `"url"`
+
+The URL used to access the user subscribed channel.
+
+This URL SHOULD NOT contain query parameters.
+
+#### > `"thumbnail"`
+
+The URL to the user/channel's thumbnail.
+
+### Overview
+
+```javascript
+{
+  "type": String,
+  "id": String,
+  "name": String,
+  "url": String,
+  "thumbnail": String
+}
+```