feat(downloads): alt 'media' handling to allow dls

This also includes documentation to state which methods actually support
media download, and how to achieve that.

Added TODO to not forget we should tell the user how to achieve these
kinds of things.

Fixes #21

etc/api/groupsmigration/v1/groupsmigration-api.json

@@ -1,6 +1,6 @@
 {
  "kind": "discovery#restDescription",
- "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/uMvgRqCygYBIh2d3lXb4f8cUWOw\"",
+ "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/8sBrpk7dyPsmoiW1fArUb0ZoCGY\"",
  "discoveryVersion": "v1",
  "id": "groupsmigration:v1",
  "name": "groupsmigration",
@@ -67,6 +67,15 @@
    "location": "query"
   }
  },
+ "auth": {
+  "oauth2": {
+   "scopes": {
+    "https://www.googleapis.com/auth/apps.groups.migration": {
+     "description": "Manage messages in groups on your domain"
+    }
+   }
+  }
+ },
  "schemas": {
   "Groups": {
    "id": "Groups",
@@ -107,6 +116,9 @@
      "response": {
       "$ref": "Groups"
      },
+     "scopes": [
+      "https://www.googleapis.com/auth/apps.groups.migration"
+     ],
      "supportsMediaUpload": true,
      "mediaUpload": {
       "accept": [