on develop help sign in
Updating drive service definition
commitce8834e1ae5cb47f0a64e338c4509f78c9b80d46 authorBrendan Hay <brendan.g.hay@gmail.com> dateSat 11 Feb 2017, 11:26 (10 years ago) parenta20d1f6
2 files changed+64−34
gen/model/drive/v2/drive-api.json+35−20 gen/model/drive/v3/drive-api.json+29−14
gen/model/drive/v2/drive-api.json+35−20
@@ -1,11 +1,11 @@
11{
22 "kind": "discovery#restDescription",
3− "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/Bxo7TXXOxzhoC81JSCcKcp551FA\"",
3+ "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/aTsDjhJX4jyEgcQh1bdOjEtV2EI\"",
44 "discoveryVersion": "v1",
55 "id": "drive:v2",
66 "name": "drive",
77 "version": "v2",
8− "revision": "20161018",
8+ "revision": "20170113",
99 "title": "Drive API",
1010 "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.",
1111 "ownerDomain": "google.com",
@@ -468,7 +468,7 @@
468468 },
469469 "items": {
470470 "type": "array",
471− "description": "The actual list of apps.",
471+ "description": "The list of apps.",
472472 "items": {
473473 "$ref": "App"
474474 }
@@ -533,7 +533,7 @@
533533 },
534534 "items": {
535535 "type": "array",
536− "description": "The actual list of changes.",
536+ "description": "The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
537537 "items": {
538538 "$ref": "Change"
539539 }
@@ -554,7 +554,7 @@
554554 },
555555 "nextPageToken": {
556556 "type": "string",
557− "description": "The page token for the next page of changes."
557+ "description": "The page token for the next page of changes. This will be absent if the end of the changes list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
558558 },
559559 "selfLink": {
560560 "type": "string",
@@ -626,7 +626,7 @@
626626 },
627627 "items": {
628628 "type": "array",
629− "description": "The actual list of children.",
629+ "description": "The list of children. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
630630 "items": {
631631 "$ref": "ChildReference"
632632 }
@@ -642,7 +642,7 @@
642642 },
643643 "nextPageToken": {
644644 "type": "string",
645− "description": "The page token for the next page of children."
645+ "description": "The page token for the next page of children. This will be absent if the end of the children list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
646646 },
647647 "selfLink": {
648648 "type": "string",
@@ -775,7 +775,7 @@
775775 "properties": {
776776 "items": {
777777 "type": "array",
778− "description": "List of comments.",
778+ "description": "The list of comments. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
779779 "items": {
780780 "$ref": "Comment"
781781 }
@@ -791,7 +791,7 @@
791791 },
792792 "nextPageToken": {
793793 "type": "string",
794− "description": "The token to use to request the next page of results."
794+ "description": "The page token for the next page of comments. This will be absent if the end of the comments list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
795795 },
796796 "selfLink": {
797797 "type": "string",
@@ -857,7 +857,7 @@
857857 "properties": {
858858 "items": {
859859 "type": "array",
860− "description": "List of reply.",
860+ "description": "The list of replies. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
861861 "items": {
862862 "$ref": "CommentReply"
863863 }
@@ -873,7 +873,7 @@
873873 },
874874 "nextPageToken": {
875875 "type": "string",
876− "description": "The token to use to request the next page of results."
876+ "description": "The page token for the next page of replies. This will be absent if the end of the replies list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
877877 },
878878 "selfLink": {
879879 "type": "string",
@@ -963,6 +963,10 @@
963963 "type": "string",
964964 "description": "The full file extension; extracted from the title. May contain multiple concatenated extensions, such as \"tar.gz\". Removing an extension from the title does not clear this field; however, changing the extension on the title does update this field. This field is only populated for files with content stored in Drive; it is not populated for Google Docs or shortcut files."
965965 },
966+ "hasThumbnail": {
967+ "type": "boolean",
968+ "description": "Whether this file has a thumbnail."
969+ },
966970 "headRevisionId": {
967971 "type": "string",
968972 "description": "The ID of the file's head revision. This field is only populated for files with content stored in Drive; it is not populated for Google Docs or shortcut files."
@@ -1119,6 +1123,10 @@
11191123 "type": "boolean",
11201124 "description": "Deprecated."
11211125 },
1126+ "modified": {
1127+ "type": "boolean",
1128+ "description": "Whether the file has been modified by this user."
1129+ },
11221130 "restricted": {
11231131 "type": "boolean",
11241132 "description": "Whether viewers and commenters are prevented from downloading, printing, and copying this file."
@@ -1258,7 +1266,7 @@
12581266 },
12591267 "thumbnail": {
12601268 "type": "object",
1261− "description": "Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.",
1269+ "description": "A thumbnail for the file. This will only be used if Drive cannot generate a standard thumbnail.",
12621270 "properties": {
12631271 "image": {
12641272 "type": "string",
@@ -1273,7 +1281,12 @@
12731281 },
12741282 "thumbnailLink": {
12751283 "type": "string",
1276− "description": "A short-lived link to the file's thumbnail. Typically lasts on the order of hours."
1284+ "description": "A short-lived link to the file's thumbnail. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content."
1285+ },
1286+ "thumbnailVersion": {
1287+ "type": "string",
1288+ "description": "The thumbnail version for use in thumbnail cache invalidation.",
1289+ "format": "int64"
12771290 },
12781291 "title": {
12791292 "type": "string",
@@ -1334,7 +1347,7 @@
13341347 },
13351348 "items": {
13361349 "type": "array",
1337− "description": "The actual list of files.",
1350+ "description": "The list of files. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
13381351 "items": {
13391352 "$ref": "File"
13401353 }
@@ -1350,7 +1363,7 @@
13501363 },
13511364 "nextPageToken": {
13521365 "type": "string",
1353− "description": "The page token for the next page of files."
1366+ "description": "The page token for the next page of files. This will be absent if the end of the files list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
13541367 },
13551368 "selfLink": {
13561369 "type": "string",
@@ -1392,7 +1405,7 @@
13921405 },
13931406 "items": {
13941407 "type": "array",
1395− "description": "The actual list of parents.",
1408+ "description": "The list of parents.",
13961409 "items": {
13971410 "$ref": "ParentReference"
13981411 }
@@ -1476,7 +1489,7 @@
14761489 },
14771490 "id": {
14781491 "type": "string",
1479− "description": "The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored."
1492+ "description": "The ID of the user this permission refers to, and identical to the permissionId in the About and Files resources. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored."
14801493 },
14811494 "kind": {
14821495 "type": "string",
@@ -1515,7 +1528,7 @@
15151528 },
15161529 "value": {
15171530 "type": "string",
1518− "description": "The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type anyone, in which case both id and value are ignored."
1531+ "description": "The email address or domain name for the entity. This is used during inserts and is not populated in responses. When making a drive.permissions.insert request, exactly one of the id or value fields must be specified unless the permission type is anyone, in which case both id and value are ignored."
15191532 },
15201533 "withLink": {
15211534 "type": "boolean",
@@ -1550,7 +1563,7 @@
15501563 },
15511564 "items": {
15521565 "type": "array",
1553− "description": "The actual list of permissions.",
1566+ "description": "The list of permissions.",
15541567 "items": {
15551568 "$ref": "Permission"
15561569 }
@@ -1722,7 +1735,7 @@
17221735 },
17231736 "items": {
17241737 "type": "array",
1725− "description": "The actual list of revisions.",
1738+ "description": "The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
17261739 "items": {
17271740 "$ref": "Revision"
17281741 }
@@ -4246,8 +4259,10 @@
42464259 "maxResults": {
42474260 "type": "integer",
42484261 "description": "Maximum number of revisions to return.",
4262+ "default": "200",
42494263 "format": "int32",
42504264 "minimum": "1",
4265+ "maximum": "1000",
42514266 "location": "query"
42524267 },
42534268 "pageToken": {
gen/model/drive/v3/drive-api.json+29−14
@@ -1,11 +1,11 @@
11{
22 "kind": "discovery#restDescription",
3− "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/l3OBP3BL9medgXcel5lvXKXZMZI\"",
3+ "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/J10Dqd-j3ykqCHF6dJXogNmQ37U\"",
44 "discoveryVersion": "v1",
55 "id": "drive:v3",
66 "name": "drive",
77 "version": "v3",
8− "revision": "20161018",
8+ "revision": "20170113",
99 "title": "Drive API",
1010 "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.",
1111 "ownerDomain": "google.com",
@@ -219,7 +219,7 @@
219219 "properties": {
220220 "changes": {
221221 "type": "array",
222− "description": "The page of changes.",
222+ "description": "The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
223223 "items": {
224224 "$ref": "Change"
225225 }
@@ -235,7 +235,7 @@
235235 },
236236 "nextPageToken": {
237237 "type": "string",
238− "description": "The page token for the next page of changes. This will be absent if the end of the current changes list has been reached."
238+ "description": "The page token for the next page of changes. This will be absent if the end of the changes list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
239239 }
240240 }
241241 },
@@ -376,7 +376,7 @@
376376 "properties": {
377377 "comments": {
378378 "type": "array",
379− "description": "The page of comments.",
379+ "description": "The list of comments. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
380380 "items": {
381381 "$ref": "Comment"
382382 }
@@ -388,7 +388,7 @@
388388 },
389389 "nextPageToken": {
390390 "type": "string",
391− "description": "The page token for the next page of comments. This will be absent if the end of the comments list has been reached."
391+ "description": "The page token for the next page of comments. This will be absent if the end of the comments list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
392392 }
393393 }
394394 },
@@ -480,6 +480,10 @@
480480 "type": "string",
481481 "description": "The full file extension extracted from the name field. May contain multiple concatenated extensions, such as \"tar.gz\". This is only available for files with binary content in Drive.\nThis is automatically updated when the name field changes, however it is not cleared if the new name does not contain a valid extension."
482482 },
483+ "hasThumbnail": {
484+ "type": "boolean",
485+ "description": "Whether this file has a thumbnail."
486+ },
483487 "headRevisionId": {
484488 "type": "string",
485489 "description": "The ID of the file's head revision. This is currently only available for files with binary content in Drive."
@@ -630,6 +634,10 @@
630634 "type": "string",
631635 "description": "The MIME type of the file.\nDrive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.\nIf a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource."
632636 },
637+ "modifiedByMe": {
638+ "type": "boolean",
639+ "description": "Whether the file has been modified by this user."
640+ },
633641 "modifiedByMeTime": {
634642 "type": "string",
635643 "description": "The last time the file was modified by the user (RFC 3339 date-time).",
@@ -716,7 +724,12 @@
716724 },
717725 "thumbnailLink": {
718726 "type": "string",
719− "description": "A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours."
727+ "description": "A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content."
728+ },
729+ "thumbnailVersion": {
730+ "type": "string",
731+ "description": "The thumbnail version for use in thumbnail cache invalidation.",
732+ "format": "int64"
720733 },
721734 "trashed": {
722735 "type": "boolean",
@@ -782,7 +795,7 @@
782795 "properties": {
783796 "files": {
784797 "type": "array",
785− "description": "The page of files.",
798+ "description": "The list of files. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
786799 "items": {
787800 "$ref": "File"
788801 }
@@ -794,7 +807,7 @@
794807 },
795808 "nextPageToken": {
796809 "type": "string",
797− "description": "The page token for the next page of files. This will be absent if the end of the files list has been reached."
810+ "description": "The page token for the next page of files. This will be absent if the end of the files list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
798811 }
799812 }
800813 },
@@ -892,7 +905,7 @@
892905 },
893906 "permissions": {
894907 "type": "array",
895− "description": "The full list of permissions.",
908+ "description": "The list of permissions.",
896909 "items": {
897910 "$ref": "Permission"
898911 }
@@ -962,11 +975,11 @@
962975 },
963976 "nextPageToken": {
964977 "type": "string",
965− "description": "The page token for the next page of replies. This will be absent if the end of the replies list has been reached."
978+ "description": "The page token for the next page of replies. This will be absent if the end of the replies list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
966979 },
967980 "replies": {
968981 "type": "array",
969− "description": "The page of replies.",
982+ "description": "The list of replies. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
970983 "items": {
971984 "$ref": "Reply"
972985 }
@@ -1043,11 +1056,11 @@
10431056 },
10441057 "nextPageToken": {
10451058 "type": "string",
1046− "description": "The page token for the next page of revisions. This will be absent if the end of the revisions list has been reached."
1059+ "description": "The page token for the next page of revisions. This will be absent if the end of the revisions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results."
10471060 },
10481061 "revisions": {
10491062 "type": "array",
1050− "description": "The full list of revisions.",
1063+ "description": "The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
10511064 "items": {
10521065 "$ref": "Revision"
10531066 }
@@ -2374,8 +2387,10 @@
23742387 "pageSize": {
23752388 "type": "integer",
23762389 "description": "The maximum number of revisions to return per page.",
2390+ "default": "200",
23772391 "format": "int32",
23782392 "minimum": "1",
2393+ "maximum": "1000",
23792394 "location": "query"
23802395 },
23812396 "pageToken": {