google-drive-mock 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,4748 @@
1
+ openapi: 3.0.0
2
+ servers:
3
+ - url: https://www.googleapis.com/drive/v3
4
+ info:
5
+ contact:
6
+ name: Google
7
+ url: https://google.com
8
+ x-twitter: youtube
9
+ description: The Google Drive API allows clients to access resources from Google Drive.
10
+ license:
11
+ name: Creative Commons Attribution 3.0
12
+ url: http://creativecommons.org/licenses/by/3.0/
13
+ termsOfService: https://developers.google.com/terms/
14
+ title: Google Drive API
15
+ version: v3
16
+ x-apiClientRegistration:
17
+ url: https://console.developers.google.com
18
+ x-apisguru-categories:
19
+ - analytics
20
+ - media
21
+ x-logo:
22
+ url: https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png
23
+ x-origin:
24
+ - converter:
25
+ url: https://github.com/mermade/oas-kit
26
+ version: 7.0.4
27
+ format: google
28
+ url: https://www.googleapis.com/discovery/v1/apis/drive/v3/rest
29
+ version: v1
30
+ x-preferred: true
31
+ x-providerName: googleapis.com
32
+ x-serviceName: drive
33
+ externalDocs:
34
+ url: https://developers.google.com/drive/
35
+ tags:
36
+ - name: about
37
+ - name: apps
38
+ - name: changes
39
+ - name: channels
40
+ - name: comments
41
+ - name: drives
42
+ - name: files
43
+ - name: permissions
44
+ - name: replies
45
+ - name: revisions
46
+ - name: teamdrives
47
+ paths:
48
+ /about:
49
+ get:
50
+ description: Gets information about the user, the user's Drive, and system capabilities.
51
+ operationId: drive.about.get
52
+ responses:
53
+ "200":
54
+ content:
55
+ application/json:
56
+ schema:
57
+ $ref: "#/components/schemas/About"
58
+ description: Successful response
59
+ security:
60
+ - Oauth2:
61
+ - https://www.googleapis.com/auth/drive
62
+ Oauth2c:
63
+ - https://www.googleapis.com/auth/drive
64
+ - Oauth2:
65
+ - https://www.googleapis.com/auth/drive.appdata
66
+ Oauth2c:
67
+ - https://www.googleapis.com/auth/drive.appdata
68
+ - Oauth2:
69
+ - https://www.googleapis.com/auth/drive.file
70
+ Oauth2c:
71
+ - https://www.googleapis.com/auth/drive.file
72
+ - Oauth2:
73
+ - https://www.googleapis.com/auth/drive.metadata
74
+ Oauth2c:
75
+ - https://www.googleapis.com/auth/drive.metadata
76
+ - Oauth2:
77
+ - https://www.googleapis.com/auth/drive.metadata.readonly
78
+ Oauth2c:
79
+ - https://www.googleapis.com/auth/drive.metadata.readonly
80
+ - Oauth2:
81
+ - https://www.googleapis.com/auth/drive.photos.readonly
82
+ Oauth2c:
83
+ - https://www.googleapis.com/auth/drive.photos.readonly
84
+ - Oauth2:
85
+ - https://www.googleapis.com/auth/drive.readonly
86
+ Oauth2c:
87
+ - https://www.googleapis.com/auth/drive.readonly
88
+ tags:
89
+ - about
90
+ parameters:
91
+ - $ref: "#/components/parameters/_.xgafv"
92
+ - $ref: "#/components/parameters/access_token"
93
+ - $ref: "#/components/parameters/alt"
94
+ - $ref: "#/components/parameters/callback"
95
+ - $ref: "#/components/parameters/fields"
96
+ - $ref: "#/components/parameters/key"
97
+ - $ref: "#/components/parameters/oauth_token"
98
+ - $ref: "#/components/parameters/prettyPrint"
99
+ - $ref: "#/components/parameters/quotaUser"
100
+ - $ref: "#/components/parameters/upload_protocol"
101
+ - $ref: "#/components/parameters/uploadType"
102
+ /apps:
103
+ get:
104
+ description: Lists a user's installed apps.
105
+ operationId: drive.apps.list
106
+ parameters:
107
+ - description: A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given file extensions are included in the response. If `appFilterMimeTypes` are provided as well, the result is a union of the two resulting app lists.
108
+ in: query
109
+ name: appFilterExtensions
110
+ schema:
111
+ type: string
112
+ - description: A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given MIME types will be included in the response. If `appFilterExtensions` are provided as well, the result is a union of the two resulting app lists.
113
+ in: query
114
+ name: appFilterMimeTypes
115
+ schema:
116
+ type: string
117
+ - description: A language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (http://www.unicode.org/reports/tr35/).
118
+ in: query
119
+ name: languageCode
120
+ schema:
121
+ type: string
122
+ responses:
123
+ "200":
124
+ content:
125
+ application/json:
126
+ schema:
127
+ $ref: "#/components/schemas/AppList"
128
+ description: Successful response
129
+ security:
130
+ - Oauth2:
131
+ - https://www.googleapis.com/auth/drive.apps.readonly
132
+ Oauth2c:
133
+ - https://www.googleapis.com/auth/drive.apps.readonly
134
+ tags:
135
+ - apps
136
+ parameters:
137
+ - $ref: "#/components/parameters/_.xgafv"
138
+ - $ref: "#/components/parameters/access_token"
139
+ - $ref: "#/components/parameters/alt"
140
+ - $ref: "#/components/parameters/callback"
141
+ - $ref: "#/components/parameters/fields"
142
+ - $ref: "#/components/parameters/key"
143
+ - $ref: "#/components/parameters/oauth_token"
144
+ - $ref: "#/components/parameters/prettyPrint"
145
+ - $ref: "#/components/parameters/quotaUser"
146
+ - $ref: "#/components/parameters/upload_protocol"
147
+ - $ref: "#/components/parameters/uploadType"
148
+ /apps/{appId}:
149
+ get:
150
+ description: Gets a specific app.
151
+ operationId: drive.apps.get
152
+ parameters:
153
+ - description: The ID of the app.
154
+ in: path
155
+ name: appId
156
+ required: true
157
+ schema:
158
+ type: string
159
+ responses:
160
+ "200":
161
+ content:
162
+ application/json:
163
+ schema:
164
+ $ref: "#/components/schemas/App"
165
+ description: Successful response
166
+ security:
167
+ - Oauth2:
168
+ - https://www.googleapis.com/auth/drive
169
+ Oauth2c:
170
+ - https://www.googleapis.com/auth/drive
171
+ - Oauth2:
172
+ - https://www.googleapis.com/auth/drive.appdata
173
+ Oauth2c:
174
+ - https://www.googleapis.com/auth/drive.appdata
175
+ - Oauth2:
176
+ - https://www.googleapis.com/auth/drive.apps.readonly
177
+ Oauth2c:
178
+ - https://www.googleapis.com/auth/drive.apps.readonly
179
+ - Oauth2:
180
+ - https://www.googleapis.com/auth/drive.file
181
+ Oauth2c:
182
+ - https://www.googleapis.com/auth/drive.file
183
+ - Oauth2:
184
+ - https://www.googleapis.com/auth/drive.metadata
185
+ Oauth2c:
186
+ - https://www.googleapis.com/auth/drive.metadata
187
+ - Oauth2:
188
+ - https://www.googleapis.com/auth/drive.metadata.readonly
189
+ Oauth2c:
190
+ - https://www.googleapis.com/auth/drive.metadata.readonly
191
+ - Oauth2:
192
+ - https://www.googleapis.com/auth/drive.readonly
193
+ Oauth2c:
194
+ - https://www.googleapis.com/auth/drive.readonly
195
+ tags:
196
+ - apps
197
+ parameters:
198
+ - $ref: "#/components/parameters/_.xgafv"
199
+ - $ref: "#/components/parameters/access_token"
200
+ - $ref: "#/components/parameters/alt"
201
+ - $ref: "#/components/parameters/callback"
202
+ - $ref: "#/components/parameters/fields"
203
+ - $ref: "#/components/parameters/key"
204
+ - $ref: "#/components/parameters/oauth_token"
205
+ - $ref: "#/components/parameters/prettyPrint"
206
+ - $ref: "#/components/parameters/quotaUser"
207
+ - $ref: "#/components/parameters/upload_protocol"
208
+ - $ref: "#/components/parameters/uploadType"
209
+ /changes:
210
+ get:
211
+ description: Lists the changes for a user or shared drive.
212
+ operationId: drive.changes.list
213
+ parameters:
214
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.
215
+ in: query
216
+ name: pageToken
217
+ required: true
218
+ schema:
219
+ type: string
220
+ - description: The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier.
221
+ in: query
222
+ name: driveId
223
+ schema:
224
+ type: string
225
+ - description: Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file.
226
+ in: query
227
+ name: includeCorpusRemovals
228
+ schema:
229
+ type: boolean
230
+ - description: Whether both My Drive and shared drive items should be included in results.
231
+ in: query
232
+ name: includeItemsFromAllDrives
233
+ schema:
234
+ type: boolean
235
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
236
+ in: query
237
+ name: includeLabels
238
+ schema:
239
+ type: string
240
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
241
+ in: query
242
+ name: includePermissionsForView
243
+ schema:
244
+ type: string
245
+ - description: Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.
246
+ in: query
247
+ name: includeRemoved
248
+ schema:
249
+ type: boolean
250
+ - description: "Deprecated: Use `includeItemsFromAllDrives` instead."
251
+ in: query
252
+ name: includeTeamDriveItems
253
+ schema:
254
+ type: boolean
255
+ - description: The maximum number of changes to return per page.
256
+ in: query
257
+ name: pageSize
258
+ schema:
259
+ maximum: 1000
260
+ minimum: 1
261
+ type: integer
262
+ - description: Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.
263
+ in: query
264
+ name: restrictToMyDrive
265
+ schema:
266
+ type: boolean
267
+ - description: A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
268
+ in: query
269
+ name: spaces
270
+ schema:
271
+ type: string
272
+ - description: Whether the requesting application supports both My Drives and shared drives.
273
+ in: query
274
+ name: supportsAllDrives
275
+ schema:
276
+ type: boolean
277
+ - description: "Deprecated: Use `supportsAllDrives` instead."
278
+ in: query
279
+ name: supportsTeamDrives
280
+ schema:
281
+ type: boolean
282
+ - description: "Deprecated: Use `driveId` instead."
283
+ in: query
284
+ name: teamDriveId
285
+ schema:
286
+ type: string
287
+ responses:
288
+ "200":
289
+ content:
290
+ application/json:
291
+ schema:
292
+ $ref: "#/components/schemas/ChangeList"
293
+ description: Successful response
294
+ security:
295
+ - Oauth2:
296
+ - https://www.googleapis.com/auth/drive
297
+ Oauth2c:
298
+ - https://www.googleapis.com/auth/drive
299
+ - Oauth2:
300
+ - https://www.googleapis.com/auth/drive.appdata
301
+ Oauth2c:
302
+ - https://www.googleapis.com/auth/drive.appdata
303
+ - Oauth2:
304
+ - https://www.googleapis.com/auth/drive.file
305
+ Oauth2c:
306
+ - https://www.googleapis.com/auth/drive.file
307
+ - Oauth2:
308
+ - https://www.googleapis.com/auth/drive.metadata
309
+ Oauth2c:
310
+ - https://www.googleapis.com/auth/drive.metadata
311
+ - Oauth2:
312
+ - https://www.googleapis.com/auth/drive.metadata.readonly
313
+ Oauth2c:
314
+ - https://www.googleapis.com/auth/drive.metadata.readonly
315
+ - Oauth2:
316
+ - https://www.googleapis.com/auth/drive.photos.readonly
317
+ Oauth2c:
318
+ - https://www.googleapis.com/auth/drive.photos.readonly
319
+ - Oauth2:
320
+ - https://www.googleapis.com/auth/drive.readonly
321
+ Oauth2c:
322
+ - https://www.googleapis.com/auth/drive.readonly
323
+ tags:
324
+ - changes
325
+ parameters:
326
+ - $ref: "#/components/parameters/_.xgafv"
327
+ - $ref: "#/components/parameters/access_token"
328
+ - $ref: "#/components/parameters/alt"
329
+ - $ref: "#/components/parameters/callback"
330
+ - $ref: "#/components/parameters/fields"
331
+ - $ref: "#/components/parameters/key"
332
+ - $ref: "#/components/parameters/oauth_token"
333
+ - $ref: "#/components/parameters/prettyPrint"
334
+ - $ref: "#/components/parameters/quotaUser"
335
+ - $ref: "#/components/parameters/upload_protocol"
336
+ - $ref: "#/components/parameters/uploadType"
337
+ /changes/startPageToken:
338
+ get:
339
+ description: Gets the starting pageToken for listing future changes.
340
+ operationId: drive.changes.getStartPageToken
341
+ parameters:
342
+ - description: The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned.
343
+ in: query
344
+ name: driveId
345
+ schema:
346
+ type: string
347
+ - description: Whether the requesting application supports both My Drives and shared drives.
348
+ in: query
349
+ name: supportsAllDrives
350
+ schema:
351
+ type: boolean
352
+ - description: "Deprecated: Use `supportsAllDrives` instead."
353
+ in: query
354
+ name: supportsTeamDrives
355
+ schema:
356
+ type: boolean
357
+ - description: "Deprecated: Use `driveId` instead."
358
+ in: query
359
+ name: teamDriveId
360
+ schema:
361
+ type: string
362
+ responses:
363
+ "200":
364
+ content:
365
+ application/json:
366
+ schema:
367
+ $ref: "#/components/schemas/StartPageToken"
368
+ description: Successful response
369
+ security:
370
+ - Oauth2:
371
+ - https://www.googleapis.com/auth/drive
372
+ Oauth2c:
373
+ - https://www.googleapis.com/auth/drive
374
+ - Oauth2:
375
+ - https://www.googleapis.com/auth/drive.appdata
376
+ Oauth2c:
377
+ - https://www.googleapis.com/auth/drive.appdata
378
+ - Oauth2:
379
+ - https://www.googleapis.com/auth/drive.file
380
+ Oauth2c:
381
+ - https://www.googleapis.com/auth/drive.file
382
+ - Oauth2:
383
+ - https://www.googleapis.com/auth/drive.metadata
384
+ Oauth2c:
385
+ - https://www.googleapis.com/auth/drive.metadata
386
+ - Oauth2:
387
+ - https://www.googleapis.com/auth/drive.metadata.readonly
388
+ Oauth2c:
389
+ - https://www.googleapis.com/auth/drive.metadata.readonly
390
+ - Oauth2:
391
+ - https://www.googleapis.com/auth/drive.photos.readonly
392
+ Oauth2c:
393
+ - https://www.googleapis.com/auth/drive.photos.readonly
394
+ - Oauth2:
395
+ - https://www.googleapis.com/auth/drive.readonly
396
+ Oauth2c:
397
+ - https://www.googleapis.com/auth/drive.readonly
398
+ tags:
399
+ - changes
400
+ parameters:
401
+ - $ref: "#/components/parameters/_.xgafv"
402
+ - $ref: "#/components/parameters/access_token"
403
+ - $ref: "#/components/parameters/alt"
404
+ - $ref: "#/components/parameters/callback"
405
+ - $ref: "#/components/parameters/fields"
406
+ - $ref: "#/components/parameters/key"
407
+ - $ref: "#/components/parameters/oauth_token"
408
+ - $ref: "#/components/parameters/prettyPrint"
409
+ - $ref: "#/components/parameters/quotaUser"
410
+ - $ref: "#/components/parameters/upload_protocol"
411
+ - $ref: "#/components/parameters/uploadType"
412
+ /changes/watch:
413
+ parameters:
414
+ - $ref: "#/components/parameters/_.xgafv"
415
+ - $ref: "#/components/parameters/access_token"
416
+ - $ref: "#/components/parameters/alt"
417
+ - $ref: "#/components/parameters/callback"
418
+ - $ref: "#/components/parameters/fields"
419
+ - $ref: "#/components/parameters/key"
420
+ - $ref: "#/components/parameters/oauth_token"
421
+ - $ref: "#/components/parameters/prettyPrint"
422
+ - $ref: "#/components/parameters/quotaUser"
423
+ - $ref: "#/components/parameters/upload_protocol"
424
+ - $ref: "#/components/parameters/uploadType"
425
+ post:
426
+ description: Subscribes to changes for a user.
427
+ operationId: drive.changes.watch
428
+ parameters:
429
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.
430
+ in: query
431
+ name: pageToken
432
+ required: true
433
+ schema:
434
+ type: string
435
+ - description: The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier.
436
+ in: query
437
+ name: driveId
438
+ schema:
439
+ type: string
440
+ - description: Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file.
441
+ in: query
442
+ name: includeCorpusRemovals
443
+ schema:
444
+ type: boolean
445
+ - description: Whether both My Drive and shared drive items should be included in results.
446
+ in: query
447
+ name: includeItemsFromAllDrives
448
+ schema:
449
+ type: boolean
450
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
451
+ in: query
452
+ name: includeLabels
453
+ schema:
454
+ type: string
455
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
456
+ in: query
457
+ name: includePermissionsForView
458
+ schema:
459
+ type: string
460
+ - description: Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.
461
+ in: query
462
+ name: includeRemoved
463
+ schema:
464
+ type: boolean
465
+ - description: "Deprecated: Use `includeItemsFromAllDrives` instead."
466
+ in: query
467
+ name: includeTeamDriveItems
468
+ schema:
469
+ type: boolean
470
+ - description: The maximum number of changes to return per page.
471
+ in: query
472
+ name: pageSize
473
+ schema:
474
+ maximum: 1000
475
+ minimum: 1
476
+ type: integer
477
+ - description: Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.
478
+ in: query
479
+ name: restrictToMyDrive
480
+ schema:
481
+ type: boolean
482
+ - description: A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
483
+ in: query
484
+ name: spaces
485
+ schema:
486
+ type: string
487
+ - description: Whether the requesting application supports both My Drives and shared drives.
488
+ in: query
489
+ name: supportsAllDrives
490
+ schema:
491
+ type: boolean
492
+ - description: "Deprecated: Use `supportsAllDrives` instead."
493
+ in: query
494
+ name: supportsTeamDrives
495
+ schema:
496
+ type: boolean
497
+ - description: "Deprecated: Use `driveId` instead."
498
+ in: query
499
+ name: teamDriveId
500
+ schema:
501
+ type: string
502
+ requestBody:
503
+ content:
504
+ application/json:
505
+ schema:
506
+ $ref: "#/components/schemas/Channel"
507
+ responses:
508
+ "200":
509
+ content:
510
+ application/json:
511
+ schema:
512
+ $ref: "#/components/schemas/Channel"
513
+ description: Successful response
514
+ security:
515
+ - Oauth2:
516
+ - https://www.googleapis.com/auth/drive
517
+ Oauth2c:
518
+ - https://www.googleapis.com/auth/drive
519
+ - Oauth2:
520
+ - https://www.googleapis.com/auth/drive.appdata
521
+ Oauth2c:
522
+ - https://www.googleapis.com/auth/drive.appdata
523
+ - Oauth2:
524
+ - https://www.googleapis.com/auth/drive.file
525
+ Oauth2c:
526
+ - https://www.googleapis.com/auth/drive.file
527
+ - Oauth2:
528
+ - https://www.googleapis.com/auth/drive.metadata
529
+ Oauth2c:
530
+ - https://www.googleapis.com/auth/drive.metadata
531
+ - Oauth2:
532
+ - https://www.googleapis.com/auth/drive.metadata.readonly
533
+ Oauth2c:
534
+ - https://www.googleapis.com/auth/drive.metadata.readonly
535
+ - Oauth2:
536
+ - https://www.googleapis.com/auth/drive.photos.readonly
537
+ Oauth2c:
538
+ - https://www.googleapis.com/auth/drive.photos.readonly
539
+ - Oauth2:
540
+ - https://www.googleapis.com/auth/drive.readonly
541
+ Oauth2c:
542
+ - https://www.googleapis.com/auth/drive.readonly
543
+ tags:
544
+ - changes
545
+ /channels/stop:
546
+ parameters:
547
+ - $ref: "#/components/parameters/_.xgafv"
548
+ - $ref: "#/components/parameters/access_token"
549
+ - $ref: "#/components/parameters/alt"
550
+ - $ref: "#/components/parameters/callback"
551
+ - $ref: "#/components/parameters/fields"
552
+ - $ref: "#/components/parameters/key"
553
+ - $ref: "#/components/parameters/oauth_token"
554
+ - $ref: "#/components/parameters/prettyPrint"
555
+ - $ref: "#/components/parameters/quotaUser"
556
+ - $ref: "#/components/parameters/upload_protocol"
557
+ - $ref: "#/components/parameters/uploadType"
558
+ post:
559
+ description: Stops watching resources through this channel.
560
+ operationId: drive.channels.stop
561
+ requestBody:
562
+ content:
563
+ application/json:
564
+ schema:
565
+ $ref: "#/components/schemas/Channel"
566
+ responses:
567
+ "200":
568
+ description: Successful response
569
+ security:
570
+ - Oauth2:
571
+ - https://www.googleapis.com/auth/drive
572
+ Oauth2c:
573
+ - https://www.googleapis.com/auth/drive
574
+ - Oauth2:
575
+ - https://www.googleapis.com/auth/drive.appdata
576
+ Oauth2c:
577
+ - https://www.googleapis.com/auth/drive.appdata
578
+ - Oauth2:
579
+ - https://www.googleapis.com/auth/drive.file
580
+ Oauth2c:
581
+ - https://www.googleapis.com/auth/drive.file
582
+ - Oauth2:
583
+ - https://www.googleapis.com/auth/drive.metadata
584
+ Oauth2c:
585
+ - https://www.googleapis.com/auth/drive.metadata
586
+ - Oauth2:
587
+ - https://www.googleapis.com/auth/drive.metadata.readonly
588
+ Oauth2c:
589
+ - https://www.googleapis.com/auth/drive.metadata.readonly
590
+ - Oauth2:
591
+ - https://www.googleapis.com/auth/drive.photos.readonly
592
+ Oauth2c:
593
+ - https://www.googleapis.com/auth/drive.photos.readonly
594
+ - Oauth2:
595
+ - https://www.googleapis.com/auth/drive.readonly
596
+ Oauth2c:
597
+ - https://www.googleapis.com/auth/drive.readonly
598
+ tags:
599
+ - channels
600
+ /drives:
601
+ get:
602
+ description: " Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](/drive/api/guides/search-shareddrives) guide."
603
+ operationId: drive.drives.list
604
+ parameters:
605
+ - description: Maximum number of shared drives to return per page.
606
+ in: query
607
+ name: pageSize
608
+ schema:
609
+ maximum: 100
610
+ minimum: 1
611
+ type: integer
612
+ - description: Page token for shared drives.
613
+ in: query
614
+ name: pageToken
615
+ schema:
616
+ type: string
617
+ - description: Query string for searching shared drives.
618
+ in: query
619
+ name: q
620
+ schema:
621
+ type: string
622
+ - description: Issue the request as a domain administrator; if set to true, then all shared drives of the domain in which the requester is an administrator are returned.
623
+ in: query
624
+ name: useDomainAdminAccess
625
+ schema:
626
+ type: boolean
627
+ responses:
628
+ "200":
629
+ content:
630
+ application/json:
631
+ schema:
632
+ $ref: "#/components/schemas/DriveList"
633
+ description: Successful response
634
+ security:
635
+ - Oauth2:
636
+ - https://www.googleapis.com/auth/drive
637
+ Oauth2c:
638
+ - https://www.googleapis.com/auth/drive
639
+ - Oauth2:
640
+ - https://www.googleapis.com/auth/drive.readonly
641
+ Oauth2c:
642
+ - https://www.googleapis.com/auth/drive.readonly
643
+ tags:
644
+ - drives
645
+ parameters:
646
+ - $ref: "#/components/parameters/_.xgafv"
647
+ - $ref: "#/components/parameters/access_token"
648
+ - $ref: "#/components/parameters/alt"
649
+ - $ref: "#/components/parameters/callback"
650
+ - $ref: "#/components/parameters/fields"
651
+ - $ref: "#/components/parameters/key"
652
+ - $ref: "#/components/parameters/oauth_token"
653
+ - $ref: "#/components/parameters/prettyPrint"
654
+ - $ref: "#/components/parameters/quotaUser"
655
+ - $ref: "#/components/parameters/upload_protocol"
656
+ - $ref: "#/components/parameters/uploadType"
657
+ post:
658
+ description: Creates a shared drive.
659
+ operationId: drive.drives.create
660
+ parameters:
661
+ - description: Required. An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a shared drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same shared drive. If the shared drive already exists a 409 error will be returned.
662
+ in: query
663
+ name: requestId
664
+ required: true
665
+ schema:
666
+ type: string
667
+ requestBody:
668
+ content:
669
+ application/json:
670
+ schema:
671
+ $ref: "#/components/schemas/Drive"
672
+ responses:
673
+ "200":
674
+ content:
675
+ application/json:
676
+ schema:
677
+ $ref: "#/components/schemas/Drive"
678
+ description: Successful response
679
+ security:
680
+ - Oauth2:
681
+ - https://www.googleapis.com/auth/drive
682
+ Oauth2c:
683
+ - https://www.googleapis.com/auth/drive
684
+ tags:
685
+ - drives
686
+ /drives/{driveId}:
687
+ delete:
688
+ description: Permanently deletes a shared drive for which the user is an `organizer`. The shared drive cannot contain any untrashed items.
689
+ operationId: drive.drives.delete
690
+ parameters:
691
+ - description: The ID of the shared drive.
692
+ in: path
693
+ name: driveId
694
+ required: true
695
+ schema:
696
+ type: string
697
+ - description: Whether any items inside the shared drive should also be deleted. This option is only supported when `useDomainAdminAccess` is also set to `true`.
698
+ in: query
699
+ name: allowItemDeletion
700
+ schema:
701
+ type: boolean
702
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
703
+ in: query
704
+ name: useDomainAdminAccess
705
+ schema:
706
+ type: boolean
707
+ responses:
708
+ "200":
709
+ description: Successful response
710
+ security:
711
+ - Oauth2:
712
+ - https://www.googleapis.com/auth/drive
713
+ Oauth2c:
714
+ - https://www.googleapis.com/auth/drive
715
+ tags:
716
+ - drives
717
+ get:
718
+ description: Gets a shared drive's metadata by ID.
719
+ operationId: drive.drives.get
720
+ parameters:
721
+ - description: The ID of the shared drive.
722
+ in: path
723
+ name: driveId
724
+ required: true
725
+ schema:
726
+ type: string
727
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
728
+ in: query
729
+ name: useDomainAdminAccess
730
+ schema:
731
+ type: boolean
732
+ responses:
733
+ "200":
734
+ content:
735
+ application/json:
736
+ schema:
737
+ $ref: "#/components/schemas/Drive"
738
+ description: Successful response
739
+ security:
740
+ - Oauth2:
741
+ - https://www.googleapis.com/auth/drive
742
+ Oauth2c:
743
+ - https://www.googleapis.com/auth/drive
744
+ - Oauth2:
745
+ - https://www.googleapis.com/auth/drive.readonly
746
+ Oauth2c:
747
+ - https://www.googleapis.com/auth/drive.readonly
748
+ tags:
749
+ - drives
750
+ parameters:
751
+ - $ref: "#/components/parameters/_.xgafv"
752
+ - $ref: "#/components/parameters/access_token"
753
+ - $ref: "#/components/parameters/alt"
754
+ - $ref: "#/components/parameters/callback"
755
+ - $ref: "#/components/parameters/fields"
756
+ - $ref: "#/components/parameters/key"
757
+ - $ref: "#/components/parameters/oauth_token"
758
+ - $ref: "#/components/parameters/prettyPrint"
759
+ - $ref: "#/components/parameters/quotaUser"
760
+ - $ref: "#/components/parameters/upload_protocol"
761
+ - $ref: "#/components/parameters/uploadType"
762
+ patch:
763
+ description: Updates the metadate for a shared drive.
764
+ operationId: drive.drives.update
765
+ parameters:
766
+ - description: The ID of the shared drive.
767
+ in: path
768
+ name: driveId
769
+ required: true
770
+ schema:
771
+ type: string
772
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
773
+ in: query
774
+ name: useDomainAdminAccess
775
+ schema:
776
+ type: boolean
777
+ requestBody:
778
+ content:
779
+ application/json:
780
+ schema:
781
+ $ref: "#/components/schemas/Drive"
782
+ responses:
783
+ "200":
784
+ content:
785
+ application/json:
786
+ schema:
787
+ $ref: "#/components/schemas/Drive"
788
+ description: Successful response
789
+ security:
790
+ - Oauth2:
791
+ - https://www.googleapis.com/auth/drive
792
+ Oauth2c:
793
+ - https://www.googleapis.com/auth/drive
794
+ tags:
795
+ - drives
796
+ /drives/{driveId}/hide:
797
+ parameters:
798
+ - $ref: "#/components/parameters/_.xgafv"
799
+ - $ref: "#/components/parameters/access_token"
800
+ - $ref: "#/components/parameters/alt"
801
+ - $ref: "#/components/parameters/callback"
802
+ - $ref: "#/components/parameters/fields"
803
+ - $ref: "#/components/parameters/key"
804
+ - $ref: "#/components/parameters/oauth_token"
805
+ - $ref: "#/components/parameters/prettyPrint"
806
+ - $ref: "#/components/parameters/quotaUser"
807
+ - $ref: "#/components/parameters/upload_protocol"
808
+ - $ref: "#/components/parameters/uploadType"
809
+ post:
810
+ description: Hides a shared drive from the default view.
811
+ operationId: drive.drives.hide
812
+ parameters:
813
+ - description: The ID of the shared drive.
814
+ in: path
815
+ name: driveId
816
+ required: true
817
+ schema:
818
+ type: string
819
+ responses:
820
+ "200":
821
+ content:
822
+ application/json:
823
+ schema:
824
+ $ref: "#/components/schemas/Drive"
825
+ description: Successful response
826
+ security:
827
+ - Oauth2:
828
+ - https://www.googleapis.com/auth/drive
829
+ Oauth2c:
830
+ - https://www.googleapis.com/auth/drive
831
+ tags:
832
+ - drives
833
+ /drives/{driveId}/unhide:
834
+ parameters:
835
+ - $ref: "#/components/parameters/_.xgafv"
836
+ - $ref: "#/components/parameters/access_token"
837
+ - $ref: "#/components/parameters/alt"
838
+ - $ref: "#/components/parameters/callback"
839
+ - $ref: "#/components/parameters/fields"
840
+ - $ref: "#/components/parameters/key"
841
+ - $ref: "#/components/parameters/oauth_token"
842
+ - $ref: "#/components/parameters/prettyPrint"
843
+ - $ref: "#/components/parameters/quotaUser"
844
+ - $ref: "#/components/parameters/upload_protocol"
845
+ - $ref: "#/components/parameters/uploadType"
846
+ post:
847
+ description: Restores a shared drive to the default view.
848
+ operationId: drive.drives.unhide
849
+ parameters:
850
+ - description: The ID of the shared drive.
851
+ in: path
852
+ name: driveId
853
+ required: true
854
+ schema:
855
+ type: string
856
+ responses:
857
+ "200":
858
+ content:
859
+ application/json:
860
+ schema:
861
+ $ref: "#/components/schemas/Drive"
862
+ description: Successful response
863
+ security:
864
+ - Oauth2:
865
+ - https://www.googleapis.com/auth/drive
866
+ Oauth2c:
867
+ - https://www.googleapis.com/auth/drive
868
+ tags:
869
+ - drives
870
+ /files:
871
+ get:
872
+ description: " Lists the user's files. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for files & folders](/drive/api/guides/search-files) guide. *Note:* This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results."
873
+ operationId: drive.files.list
874
+ parameters:
875
+ - description: Bodies of items (files/documents) to which the query applies. Supported bodies are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to 'allDrives' for efficiency. By default, corpora is set to 'user'. However, this can change depending on the filter set through the 'q' parameter.
876
+ in: query
877
+ name: corpora
878
+ schema:
879
+ type: string
880
+ - description: "Deprecated: The source of files to list. Use 'corpora' instead."
881
+ in: query
882
+ name: corpus
883
+ schema:
884
+ enum:
885
+ - domain
886
+ - user
887
+ type: string
888
+ - description: ID of the shared drive to search.
889
+ in: query
890
+ name: driveId
891
+ schema:
892
+ type: string
893
+ - description: Whether both My Drive and shared drive items should be included in results.
894
+ in: query
895
+ name: includeItemsFromAllDrives
896
+ schema:
897
+ type: boolean
898
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
899
+ in: query
900
+ name: includeLabels
901
+ schema:
902
+ type: string
903
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
904
+ in: query
905
+ name: includePermissionsForView
906
+ schema:
907
+ type: string
908
+ - description: "Deprecated: Use `includeItemsFromAllDrives` instead."
909
+ in: query
910
+ name: includeTeamDriveItems
911
+ schema:
912
+ type: boolean
913
+ - description: "A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts ascending by default, but can be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedTime desc,name."
914
+ in: query
915
+ name: orderBy
916
+ schema:
917
+ type: string
918
+ - description: The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached.
919
+ in: query
920
+ name: pageSize
921
+ schema:
922
+ maximum: 1000
923
+ minimum: 1
924
+ type: integer
925
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
926
+ in: query
927
+ name: pageToken
928
+ schema:
929
+ type: string
930
+ - description: A query for filtering the file results. See the "Search for files & folders" guide for supported syntax.
931
+ in: query
932
+ name: q
933
+ schema:
934
+ type: string
935
+ - description: A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
936
+ in: query
937
+ name: spaces
938
+ schema:
939
+ type: string
940
+ - description: Whether the requesting application supports both My Drives and shared drives.
941
+ in: query
942
+ name: supportsAllDrives
943
+ schema:
944
+ type: boolean
945
+ - description: "Deprecated: Use `supportsAllDrives` instead."
946
+ in: query
947
+ name: supportsTeamDrives
948
+ schema:
949
+ type: boolean
950
+ - description: "Deprecated: Use `driveId` instead."
951
+ in: query
952
+ name: teamDriveId
953
+ schema:
954
+ type: string
955
+ responses:
956
+ "200":
957
+ content:
958
+ application/json:
959
+ schema:
960
+ $ref: "#/components/schemas/FileList"
961
+ description: Successful response
962
+ security:
963
+ - Oauth2:
964
+ - https://www.googleapis.com/auth/drive
965
+ Oauth2c:
966
+ - https://www.googleapis.com/auth/drive
967
+ - Oauth2:
968
+ - https://www.googleapis.com/auth/drive.appdata
969
+ Oauth2c:
970
+ - https://www.googleapis.com/auth/drive.appdata
971
+ - Oauth2:
972
+ - https://www.googleapis.com/auth/drive.file
973
+ Oauth2c:
974
+ - https://www.googleapis.com/auth/drive.file
975
+ - Oauth2:
976
+ - https://www.googleapis.com/auth/drive.metadata
977
+ Oauth2c:
978
+ - https://www.googleapis.com/auth/drive.metadata
979
+ - Oauth2:
980
+ - https://www.googleapis.com/auth/drive.metadata.readonly
981
+ Oauth2c:
982
+ - https://www.googleapis.com/auth/drive.metadata.readonly
983
+ - Oauth2:
984
+ - https://www.googleapis.com/auth/drive.photos.readonly
985
+ Oauth2c:
986
+ - https://www.googleapis.com/auth/drive.photos.readonly
987
+ - Oauth2:
988
+ - https://www.googleapis.com/auth/drive.readonly
989
+ Oauth2c:
990
+ - https://www.googleapis.com/auth/drive.readonly
991
+ tags:
992
+ - files
993
+ parameters:
994
+ - $ref: "#/components/parameters/_.xgafv"
995
+ - $ref: "#/components/parameters/access_token"
996
+ - $ref: "#/components/parameters/alt"
997
+ - $ref: "#/components/parameters/callback"
998
+ - $ref: "#/components/parameters/fields"
999
+ - $ref: "#/components/parameters/key"
1000
+ - $ref: "#/components/parameters/oauth_token"
1001
+ - $ref: "#/components/parameters/prettyPrint"
1002
+ - $ref: "#/components/parameters/quotaUser"
1003
+ - $ref: "#/components/parameters/upload_protocol"
1004
+ - $ref: "#/components/parameters/uploadType"
1005
+ post:
1006
+ description: " Creates a new file. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.create` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `\"name\": \"cat.jpg\"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `title` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the title. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type."
1007
+ operationId: drive.files.create
1008
+ parameters:
1009
+ - description: Deprecated. Creating files in multiple folders is no longer supported.
1010
+ in: query
1011
+ name: enforceSingleParent
1012
+ schema:
1013
+ type: boolean
1014
+ - description: Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
1015
+ in: query
1016
+ name: ignoreDefaultVisibility
1017
+ schema:
1018
+ type: boolean
1019
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
1020
+ in: query
1021
+ name: includeLabels
1022
+ schema:
1023
+ type: string
1024
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
1025
+ in: query
1026
+ name: includePermissionsForView
1027
+ schema:
1028
+ type: string
1029
+ - description: Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
1030
+ in: query
1031
+ name: keepRevisionForever
1032
+ schema:
1033
+ type: boolean
1034
+ - description: A language hint for OCR processing during image import (ISO 639-1 code).
1035
+ in: query
1036
+ name: ocrLanguage
1037
+ schema:
1038
+ type: string
1039
+ - description: Whether the requesting application supports both My Drives and shared drives.
1040
+ in: query
1041
+ name: supportsAllDrives
1042
+ schema:
1043
+ type: boolean
1044
+ - description: "Deprecated: Use `supportsAllDrives` instead."
1045
+ in: query
1046
+ name: supportsTeamDrives
1047
+ schema:
1048
+ type: boolean
1049
+ - description: Whether to use the uploaded content as indexable text.
1050
+ in: query
1051
+ name: useContentAsIndexableText
1052
+ schema:
1053
+ type: boolean
1054
+ requestBody:
1055
+ content:
1056
+ application/octet-stream:
1057
+ schema:
1058
+ $ref: "#/components/schemas/File"
1059
+ responses:
1060
+ "200":
1061
+ content:
1062
+ application/json:
1063
+ schema:
1064
+ $ref: "#/components/schemas/File"
1065
+ description: Successful response
1066
+ security:
1067
+ - Oauth2:
1068
+ - https://www.googleapis.com/auth/drive
1069
+ Oauth2c:
1070
+ - https://www.googleapis.com/auth/drive
1071
+ - Oauth2:
1072
+ - https://www.googleapis.com/auth/drive.appdata
1073
+ Oauth2c:
1074
+ - https://www.googleapis.com/auth/drive.appdata
1075
+ - Oauth2:
1076
+ - https://www.googleapis.com/auth/drive.file
1077
+ Oauth2c:
1078
+ - https://www.googleapis.com/auth/drive.file
1079
+ tags:
1080
+ - files
1081
+ /files/generateIds:
1082
+ get:
1083
+ description: Generates a set of file IDs which can be provided in create or copy requests.
1084
+ operationId: drive.files.generateIds
1085
+ parameters:
1086
+ - description: The number of IDs to return.
1087
+ in: query
1088
+ name: count
1089
+ schema:
1090
+ maximum: 1000
1091
+ minimum: 1
1092
+ type: integer
1093
+ - description: "The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive')"
1094
+ in: query
1095
+ name: space
1096
+ schema:
1097
+ type: string
1098
+ - description: "The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the `drive` 'space'. (Default: 'files')"
1099
+ in: query
1100
+ name: type
1101
+ schema:
1102
+ type: string
1103
+ responses:
1104
+ "200":
1105
+ content:
1106
+ application/json:
1107
+ schema:
1108
+ $ref: "#/components/schemas/GeneratedIds"
1109
+ description: Successful response
1110
+ security:
1111
+ - Oauth2:
1112
+ - https://www.googleapis.com/auth/drive
1113
+ Oauth2c:
1114
+ - https://www.googleapis.com/auth/drive
1115
+ - Oauth2:
1116
+ - https://www.googleapis.com/auth/drive.appdata
1117
+ Oauth2c:
1118
+ - https://www.googleapis.com/auth/drive.appdata
1119
+ - Oauth2:
1120
+ - https://www.googleapis.com/auth/drive.file
1121
+ Oauth2c:
1122
+ - https://www.googleapis.com/auth/drive.file
1123
+ tags:
1124
+ - files
1125
+ parameters:
1126
+ - $ref: "#/components/parameters/_.xgafv"
1127
+ - $ref: "#/components/parameters/access_token"
1128
+ - $ref: "#/components/parameters/alt"
1129
+ - $ref: "#/components/parameters/callback"
1130
+ - $ref: "#/components/parameters/fields"
1131
+ - $ref: "#/components/parameters/key"
1132
+ - $ref: "#/components/parameters/oauth_token"
1133
+ - $ref: "#/components/parameters/prettyPrint"
1134
+ - $ref: "#/components/parameters/quotaUser"
1135
+ - $ref: "#/components/parameters/upload_protocol"
1136
+ - $ref: "#/components/parameters/uploadType"
1137
+ /files/trash:
1138
+ delete:
1139
+ description: Permanently deletes all of the user's trashed files.
1140
+ operationId: drive.files.emptyTrash
1141
+ parameters:
1142
+ - description: If set, empties the trash of the provided shared drive.
1143
+ in: query
1144
+ name: driveId
1145
+ schema:
1146
+ type: string
1147
+ - description: "Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root."
1148
+ in: query
1149
+ name: enforceSingleParent
1150
+ schema:
1151
+ type: boolean
1152
+ responses:
1153
+ "200":
1154
+ description: Successful response
1155
+ security:
1156
+ - Oauth2:
1157
+ - https://www.googleapis.com/auth/drive
1158
+ Oauth2c:
1159
+ - https://www.googleapis.com/auth/drive
1160
+ tags:
1161
+ - files
1162
+ parameters:
1163
+ - $ref: "#/components/parameters/_.xgafv"
1164
+ - $ref: "#/components/parameters/access_token"
1165
+ - $ref: "#/components/parameters/alt"
1166
+ - $ref: "#/components/parameters/callback"
1167
+ - $ref: "#/components/parameters/fields"
1168
+ - $ref: "#/components/parameters/key"
1169
+ - $ref: "#/components/parameters/oauth_token"
1170
+ - $ref: "#/components/parameters/prettyPrint"
1171
+ - $ref: "#/components/parameters/quotaUser"
1172
+ - $ref: "#/components/parameters/upload_protocol"
1173
+ - $ref: "#/components/parameters/uploadType"
1174
+ /files/{fileId}:
1175
+ delete:
1176
+ description: Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a shared drive, the user must be an `organizer` on the parent folder. If the target is a folder, all descendants owned by the user are also deleted.
1177
+ operationId: drive.files.delete
1178
+ parameters:
1179
+ - description: The ID of the file.
1180
+ in: path
1181
+ name: fileId
1182
+ required: true
1183
+ schema:
1184
+ type: string
1185
+ - description: "Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root."
1186
+ in: query
1187
+ name: enforceSingleParent
1188
+ schema:
1189
+ type: boolean
1190
+ - description: Whether the requesting application supports both My Drives and shared drives.
1191
+ in: query
1192
+ name: supportsAllDrives
1193
+ schema:
1194
+ type: boolean
1195
+ - description: "Deprecated: Use `supportsAllDrives` instead."
1196
+ in: query
1197
+ name: supportsTeamDrives
1198
+ schema:
1199
+ type: boolean
1200
+ responses:
1201
+ "200":
1202
+ description: Successful response
1203
+ security:
1204
+ - Oauth2:
1205
+ - https://www.googleapis.com/auth/drive
1206
+ Oauth2c:
1207
+ - https://www.googleapis.com/auth/drive
1208
+ - Oauth2:
1209
+ - https://www.googleapis.com/auth/drive.appdata
1210
+ Oauth2c:
1211
+ - https://www.googleapis.com/auth/drive.appdata
1212
+ - Oauth2:
1213
+ - https://www.googleapis.com/auth/drive.file
1214
+ Oauth2c:
1215
+ - https://www.googleapis.com/auth/drive.file
1216
+ tags:
1217
+ - files
1218
+ get:
1219
+ description: " Gets a file's metadata or content by ID. If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/reference/rest/v3/files/export) instead. For more information, see [Download & export files](/drive/api/guides/manage-downloads)."
1220
+ operationId: drive.files.get
1221
+ parameters:
1222
+ - description: The ID of the file.
1223
+ in: path
1224
+ name: fileId
1225
+ required: true
1226
+ schema:
1227
+ type: string
1228
+ - description: Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.
1229
+ in: query
1230
+ name: acknowledgeAbuse
1231
+ schema:
1232
+ type: boolean
1233
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
1234
+ in: query
1235
+ name: includeLabels
1236
+ schema:
1237
+ type: string
1238
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
1239
+ in: query
1240
+ name: includePermissionsForView
1241
+ schema:
1242
+ type: string
1243
+ - description: Whether the requesting application supports both My Drives and shared drives.
1244
+ in: query
1245
+ name: supportsAllDrives
1246
+ schema:
1247
+ type: boolean
1248
+ - description: "Deprecated: Use `supportsAllDrives` instead."
1249
+ in: query
1250
+ name: supportsTeamDrives
1251
+ schema:
1252
+ type: boolean
1253
+ responses:
1254
+ "200":
1255
+ content:
1256
+ application/json:
1257
+ schema:
1258
+ $ref: "#/components/schemas/File"
1259
+ description: Successful response
1260
+ security:
1261
+ - Oauth2:
1262
+ - https://www.googleapis.com/auth/drive
1263
+ Oauth2c:
1264
+ - https://www.googleapis.com/auth/drive
1265
+ - Oauth2:
1266
+ - https://www.googleapis.com/auth/drive.appdata
1267
+ Oauth2c:
1268
+ - https://www.googleapis.com/auth/drive.appdata
1269
+ - Oauth2:
1270
+ - https://www.googleapis.com/auth/drive.file
1271
+ Oauth2c:
1272
+ - https://www.googleapis.com/auth/drive.file
1273
+ - Oauth2:
1274
+ - https://www.googleapis.com/auth/drive.metadata
1275
+ Oauth2c:
1276
+ - https://www.googleapis.com/auth/drive.metadata
1277
+ - Oauth2:
1278
+ - https://www.googleapis.com/auth/drive.metadata.readonly
1279
+ Oauth2c:
1280
+ - https://www.googleapis.com/auth/drive.metadata.readonly
1281
+ - Oauth2:
1282
+ - https://www.googleapis.com/auth/drive.photos.readonly
1283
+ Oauth2c:
1284
+ - https://www.googleapis.com/auth/drive.photos.readonly
1285
+ - Oauth2:
1286
+ - https://www.googleapis.com/auth/drive.readonly
1287
+ Oauth2c:
1288
+ - https://www.googleapis.com/auth/drive.readonly
1289
+ tags:
1290
+ - files
1291
+ parameters:
1292
+ - $ref: "#/components/parameters/_.xgafv"
1293
+ - $ref: "#/components/parameters/access_token"
1294
+ - $ref: "#/components/parameters/alt"
1295
+ - $ref: "#/components/parameters/callback"
1296
+ - $ref: "#/components/parameters/fields"
1297
+ - $ref: "#/components/parameters/key"
1298
+ - $ref: "#/components/parameters/oauth_token"
1299
+ - $ref: "#/components/parameters/prettyPrint"
1300
+ - $ref: "#/components/parameters/quotaUser"
1301
+ - $ref: "#/components/parameters/upload_protocol"
1302
+ - $ref: "#/components/parameters/uploadType"
1303
+ patch:
1304
+ description: " Updates a file's metadata and/or content. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/drive/api/guides/manage-uploads)."
1305
+ operationId: drive.files.update
1306
+ parameters:
1307
+ - description: The ID of the file.
1308
+ in: path
1309
+ name: fileId
1310
+ required: true
1311
+ schema:
1312
+ type: string
1313
+ - description: A comma-separated list of parent IDs to add.
1314
+ in: query
1315
+ name: addParents
1316
+ schema:
1317
+ type: string
1318
+ - description: "Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead."
1319
+ in: query
1320
+ name: enforceSingleParent
1321
+ schema:
1322
+ type: boolean
1323
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
1324
+ in: query
1325
+ name: includeLabels
1326
+ schema:
1327
+ type: string
1328
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
1329
+ in: query
1330
+ name: includePermissionsForView
1331
+ schema:
1332
+ type: string
1333
+ - description: Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
1334
+ in: query
1335
+ name: keepRevisionForever
1336
+ schema:
1337
+ type: boolean
1338
+ - description: A language hint for OCR processing during image import (ISO 639-1 code).
1339
+ in: query
1340
+ name: ocrLanguage
1341
+ schema:
1342
+ type: string
1343
+ - description: A comma-separated list of parent IDs to remove.
1344
+ in: query
1345
+ name: removeParents
1346
+ schema:
1347
+ type: string
1348
+ - description: Whether the requesting application supports both My Drives and shared drives.
1349
+ in: query
1350
+ name: supportsAllDrives
1351
+ schema:
1352
+ type: boolean
1353
+ - description: "Deprecated: Use `supportsAllDrives` instead."
1354
+ in: query
1355
+ name: supportsTeamDrives
1356
+ schema:
1357
+ type: boolean
1358
+ - description: Whether to use the uploaded content as indexable text.
1359
+ in: query
1360
+ name: useContentAsIndexableText
1361
+ schema:
1362
+ type: boolean
1363
+ requestBody:
1364
+ content:
1365
+ application/octet-stream:
1366
+ schema:
1367
+ $ref: "#/components/schemas/File"
1368
+ responses:
1369
+ "200":
1370
+ content:
1371
+ application/json:
1372
+ schema:
1373
+ $ref: "#/components/schemas/File"
1374
+ description: Successful response
1375
+ security:
1376
+ - Oauth2:
1377
+ - https://www.googleapis.com/auth/drive
1378
+ Oauth2c:
1379
+ - https://www.googleapis.com/auth/drive
1380
+ - Oauth2:
1381
+ - https://www.googleapis.com/auth/drive.appdata
1382
+ Oauth2c:
1383
+ - https://www.googleapis.com/auth/drive.appdata
1384
+ - Oauth2:
1385
+ - https://www.googleapis.com/auth/drive.file
1386
+ Oauth2c:
1387
+ - https://www.googleapis.com/auth/drive.file
1388
+ - Oauth2:
1389
+ - https://www.googleapis.com/auth/drive.metadata
1390
+ Oauth2c:
1391
+ - https://www.googleapis.com/auth/drive.metadata
1392
+ - Oauth2:
1393
+ - https://www.googleapis.com/auth/drive.scripts
1394
+ Oauth2c:
1395
+ - https://www.googleapis.com/auth/drive.scripts
1396
+ tags:
1397
+ - files
1398
+ /files/{fileId}/comments:
1399
+ get:
1400
+ description: Lists a file's comments.
1401
+ operationId: drive.comments.list
1402
+ parameters:
1403
+ - description: The ID of the file.
1404
+ in: path
1405
+ name: fileId
1406
+ required: true
1407
+ schema:
1408
+ type: string
1409
+ - description: Whether to include deleted comments. Deleted comments will not include their original content.
1410
+ in: query
1411
+ name: includeDeleted
1412
+ schema:
1413
+ type: boolean
1414
+ - description: The maximum number of comments to return per page.
1415
+ in: query
1416
+ name: pageSize
1417
+ schema:
1418
+ maximum: 100
1419
+ minimum: 1
1420
+ type: integer
1421
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
1422
+ in: query
1423
+ name: pageToken
1424
+ schema:
1425
+ type: string
1426
+ - description: The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).
1427
+ in: query
1428
+ name: startModifiedTime
1429
+ schema:
1430
+ type: string
1431
+ responses:
1432
+ "200":
1433
+ content:
1434
+ application/json:
1435
+ schema:
1436
+ $ref: "#/components/schemas/CommentList"
1437
+ description: Successful response
1438
+ security:
1439
+ - Oauth2:
1440
+ - https://www.googleapis.com/auth/drive
1441
+ Oauth2c:
1442
+ - https://www.googleapis.com/auth/drive
1443
+ - Oauth2:
1444
+ - https://www.googleapis.com/auth/drive.file
1445
+ Oauth2c:
1446
+ - https://www.googleapis.com/auth/drive.file
1447
+ - Oauth2:
1448
+ - https://www.googleapis.com/auth/drive.readonly
1449
+ Oauth2c:
1450
+ - https://www.googleapis.com/auth/drive.readonly
1451
+ tags:
1452
+ - comments
1453
+ parameters:
1454
+ - $ref: "#/components/parameters/_.xgafv"
1455
+ - $ref: "#/components/parameters/access_token"
1456
+ - $ref: "#/components/parameters/alt"
1457
+ - $ref: "#/components/parameters/callback"
1458
+ - $ref: "#/components/parameters/fields"
1459
+ - $ref: "#/components/parameters/key"
1460
+ - $ref: "#/components/parameters/oauth_token"
1461
+ - $ref: "#/components/parameters/prettyPrint"
1462
+ - $ref: "#/components/parameters/quotaUser"
1463
+ - $ref: "#/components/parameters/upload_protocol"
1464
+ - $ref: "#/components/parameters/uploadType"
1465
+ post:
1466
+ description: Creates a comment on a file.
1467
+ operationId: drive.comments.create
1468
+ parameters:
1469
+ - description: The ID of the file.
1470
+ in: path
1471
+ name: fileId
1472
+ required: true
1473
+ schema:
1474
+ type: string
1475
+ requestBody:
1476
+ content:
1477
+ application/json:
1478
+ schema:
1479
+ $ref: "#/components/schemas/Comment"
1480
+ responses:
1481
+ "200":
1482
+ content:
1483
+ application/json:
1484
+ schema:
1485
+ $ref: "#/components/schemas/Comment"
1486
+ description: Successful response
1487
+ security:
1488
+ - Oauth2:
1489
+ - https://www.googleapis.com/auth/drive
1490
+ Oauth2c:
1491
+ - https://www.googleapis.com/auth/drive
1492
+ - Oauth2:
1493
+ - https://www.googleapis.com/auth/drive.file
1494
+ Oauth2c:
1495
+ - https://www.googleapis.com/auth/drive.file
1496
+ tags:
1497
+ - comments
1498
+ /files/{fileId}/comments/{commentId}:
1499
+ delete:
1500
+ description: Deletes a comment.
1501
+ operationId: drive.comments.delete
1502
+ parameters:
1503
+ - description: The ID of the file.
1504
+ in: path
1505
+ name: fileId
1506
+ required: true
1507
+ schema:
1508
+ type: string
1509
+ - description: The ID of the comment.
1510
+ in: path
1511
+ name: commentId
1512
+ required: true
1513
+ schema:
1514
+ type: string
1515
+ responses:
1516
+ "200":
1517
+ description: Successful response
1518
+ security:
1519
+ - Oauth2:
1520
+ - https://www.googleapis.com/auth/drive
1521
+ Oauth2c:
1522
+ - https://www.googleapis.com/auth/drive
1523
+ - Oauth2:
1524
+ - https://www.googleapis.com/auth/drive.file
1525
+ Oauth2c:
1526
+ - https://www.googleapis.com/auth/drive.file
1527
+ tags:
1528
+ - comments
1529
+ get:
1530
+ description: Gets a comment by ID.
1531
+ operationId: drive.comments.get
1532
+ parameters:
1533
+ - description: The ID of the file.
1534
+ in: path
1535
+ name: fileId
1536
+ required: true
1537
+ schema:
1538
+ type: string
1539
+ - description: The ID of the comment.
1540
+ in: path
1541
+ name: commentId
1542
+ required: true
1543
+ schema:
1544
+ type: string
1545
+ - description: Whether to return deleted comments. Deleted comments will not include their original content.
1546
+ in: query
1547
+ name: includeDeleted
1548
+ schema:
1549
+ type: boolean
1550
+ responses:
1551
+ "200":
1552
+ content:
1553
+ application/json:
1554
+ schema:
1555
+ $ref: "#/components/schemas/Comment"
1556
+ description: Successful response
1557
+ security:
1558
+ - Oauth2:
1559
+ - https://www.googleapis.com/auth/drive
1560
+ Oauth2c:
1561
+ - https://www.googleapis.com/auth/drive
1562
+ - Oauth2:
1563
+ - https://www.googleapis.com/auth/drive.file
1564
+ Oauth2c:
1565
+ - https://www.googleapis.com/auth/drive.file
1566
+ - Oauth2:
1567
+ - https://www.googleapis.com/auth/drive.readonly
1568
+ Oauth2c:
1569
+ - https://www.googleapis.com/auth/drive.readonly
1570
+ tags:
1571
+ - comments
1572
+ parameters:
1573
+ - $ref: "#/components/parameters/_.xgafv"
1574
+ - $ref: "#/components/parameters/access_token"
1575
+ - $ref: "#/components/parameters/alt"
1576
+ - $ref: "#/components/parameters/callback"
1577
+ - $ref: "#/components/parameters/fields"
1578
+ - $ref: "#/components/parameters/key"
1579
+ - $ref: "#/components/parameters/oauth_token"
1580
+ - $ref: "#/components/parameters/prettyPrint"
1581
+ - $ref: "#/components/parameters/quotaUser"
1582
+ - $ref: "#/components/parameters/upload_protocol"
1583
+ - $ref: "#/components/parameters/uploadType"
1584
+ patch:
1585
+ description: Updates a comment with patch semantics.
1586
+ operationId: drive.comments.update
1587
+ parameters:
1588
+ - description: The ID of the file.
1589
+ in: path
1590
+ name: fileId
1591
+ required: true
1592
+ schema:
1593
+ type: string
1594
+ - description: The ID of the comment.
1595
+ in: path
1596
+ name: commentId
1597
+ required: true
1598
+ schema:
1599
+ type: string
1600
+ requestBody:
1601
+ content:
1602
+ application/json:
1603
+ schema:
1604
+ $ref: "#/components/schemas/Comment"
1605
+ responses:
1606
+ "200":
1607
+ content:
1608
+ application/json:
1609
+ schema:
1610
+ $ref: "#/components/schemas/Comment"
1611
+ description: Successful response
1612
+ security:
1613
+ - Oauth2:
1614
+ - https://www.googleapis.com/auth/drive
1615
+ Oauth2c:
1616
+ - https://www.googleapis.com/auth/drive
1617
+ - Oauth2:
1618
+ - https://www.googleapis.com/auth/drive.file
1619
+ Oauth2c:
1620
+ - https://www.googleapis.com/auth/drive.file
1621
+ tags:
1622
+ - comments
1623
+ /files/{fileId}/comments/{commentId}/replies:
1624
+ get:
1625
+ description: Lists a comment's replies.
1626
+ operationId: drive.replies.list
1627
+ parameters:
1628
+ - description: The ID of the file.
1629
+ in: path
1630
+ name: fileId
1631
+ required: true
1632
+ schema:
1633
+ type: string
1634
+ - description: The ID of the comment.
1635
+ in: path
1636
+ name: commentId
1637
+ required: true
1638
+ schema:
1639
+ type: string
1640
+ - description: Whether to include deleted replies. Deleted replies will not include their original content.
1641
+ in: query
1642
+ name: includeDeleted
1643
+ schema:
1644
+ type: boolean
1645
+ - description: The maximum number of replies to return per page.
1646
+ in: query
1647
+ name: pageSize
1648
+ schema:
1649
+ maximum: 100
1650
+ minimum: 1
1651
+ type: integer
1652
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
1653
+ in: query
1654
+ name: pageToken
1655
+ schema:
1656
+ type: string
1657
+ responses:
1658
+ "200":
1659
+ content:
1660
+ application/json:
1661
+ schema:
1662
+ $ref: "#/components/schemas/ReplyList"
1663
+ description: Successful response
1664
+ security:
1665
+ - Oauth2:
1666
+ - https://www.googleapis.com/auth/drive
1667
+ Oauth2c:
1668
+ - https://www.googleapis.com/auth/drive
1669
+ - Oauth2:
1670
+ - https://www.googleapis.com/auth/drive.file
1671
+ Oauth2c:
1672
+ - https://www.googleapis.com/auth/drive.file
1673
+ - Oauth2:
1674
+ - https://www.googleapis.com/auth/drive.readonly
1675
+ Oauth2c:
1676
+ - https://www.googleapis.com/auth/drive.readonly
1677
+ tags:
1678
+ - replies
1679
+ parameters:
1680
+ - $ref: "#/components/parameters/_.xgafv"
1681
+ - $ref: "#/components/parameters/access_token"
1682
+ - $ref: "#/components/parameters/alt"
1683
+ - $ref: "#/components/parameters/callback"
1684
+ - $ref: "#/components/parameters/fields"
1685
+ - $ref: "#/components/parameters/key"
1686
+ - $ref: "#/components/parameters/oauth_token"
1687
+ - $ref: "#/components/parameters/prettyPrint"
1688
+ - $ref: "#/components/parameters/quotaUser"
1689
+ - $ref: "#/components/parameters/upload_protocol"
1690
+ - $ref: "#/components/parameters/uploadType"
1691
+ post:
1692
+ description: Creates a reply to a comment.
1693
+ operationId: drive.replies.create
1694
+ parameters:
1695
+ - description: The ID of the file.
1696
+ in: path
1697
+ name: fileId
1698
+ required: true
1699
+ schema:
1700
+ type: string
1701
+ - description: The ID of the comment.
1702
+ in: path
1703
+ name: commentId
1704
+ required: true
1705
+ schema:
1706
+ type: string
1707
+ requestBody:
1708
+ content:
1709
+ application/json:
1710
+ schema:
1711
+ $ref: "#/components/schemas/Reply"
1712
+ responses:
1713
+ "200":
1714
+ content:
1715
+ application/json:
1716
+ schema:
1717
+ $ref: "#/components/schemas/Reply"
1718
+ description: Successful response
1719
+ security:
1720
+ - Oauth2:
1721
+ - https://www.googleapis.com/auth/drive
1722
+ Oauth2c:
1723
+ - https://www.googleapis.com/auth/drive
1724
+ - Oauth2:
1725
+ - https://www.googleapis.com/auth/drive.file
1726
+ Oauth2c:
1727
+ - https://www.googleapis.com/auth/drive.file
1728
+ tags:
1729
+ - replies
1730
+ /files/{fileId}/comments/{commentId}/replies/{replyId}:
1731
+ delete:
1732
+ description: Deletes a reply.
1733
+ operationId: drive.replies.delete
1734
+ parameters:
1735
+ - description: The ID of the file.
1736
+ in: path
1737
+ name: fileId
1738
+ required: true
1739
+ schema:
1740
+ type: string
1741
+ - description: The ID of the comment.
1742
+ in: path
1743
+ name: commentId
1744
+ required: true
1745
+ schema:
1746
+ type: string
1747
+ - description: The ID of the reply.
1748
+ in: path
1749
+ name: replyId
1750
+ required: true
1751
+ schema:
1752
+ type: string
1753
+ responses:
1754
+ "200":
1755
+ description: Successful response
1756
+ security:
1757
+ - Oauth2:
1758
+ - https://www.googleapis.com/auth/drive
1759
+ Oauth2c:
1760
+ - https://www.googleapis.com/auth/drive
1761
+ - Oauth2:
1762
+ - https://www.googleapis.com/auth/drive.file
1763
+ Oauth2c:
1764
+ - https://www.googleapis.com/auth/drive.file
1765
+ tags:
1766
+ - replies
1767
+ get:
1768
+ description: Gets a reply by ID.
1769
+ operationId: drive.replies.get
1770
+ parameters:
1771
+ - description: The ID of the file.
1772
+ in: path
1773
+ name: fileId
1774
+ required: true
1775
+ schema:
1776
+ type: string
1777
+ - description: The ID of the comment.
1778
+ in: path
1779
+ name: commentId
1780
+ required: true
1781
+ schema:
1782
+ type: string
1783
+ - description: The ID of the reply.
1784
+ in: path
1785
+ name: replyId
1786
+ required: true
1787
+ schema:
1788
+ type: string
1789
+ - description: Whether to return deleted replies. Deleted replies will not include their original content.
1790
+ in: query
1791
+ name: includeDeleted
1792
+ schema:
1793
+ type: boolean
1794
+ responses:
1795
+ "200":
1796
+ content:
1797
+ application/json:
1798
+ schema:
1799
+ $ref: "#/components/schemas/Reply"
1800
+ description: Successful response
1801
+ security:
1802
+ - Oauth2:
1803
+ - https://www.googleapis.com/auth/drive
1804
+ Oauth2c:
1805
+ - https://www.googleapis.com/auth/drive
1806
+ - Oauth2:
1807
+ - https://www.googleapis.com/auth/drive.file
1808
+ Oauth2c:
1809
+ - https://www.googleapis.com/auth/drive.file
1810
+ - Oauth2:
1811
+ - https://www.googleapis.com/auth/drive.readonly
1812
+ Oauth2c:
1813
+ - https://www.googleapis.com/auth/drive.readonly
1814
+ tags:
1815
+ - replies
1816
+ parameters:
1817
+ - $ref: "#/components/parameters/_.xgafv"
1818
+ - $ref: "#/components/parameters/access_token"
1819
+ - $ref: "#/components/parameters/alt"
1820
+ - $ref: "#/components/parameters/callback"
1821
+ - $ref: "#/components/parameters/fields"
1822
+ - $ref: "#/components/parameters/key"
1823
+ - $ref: "#/components/parameters/oauth_token"
1824
+ - $ref: "#/components/parameters/prettyPrint"
1825
+ - $ref: "#/components/parameters/quotaUser"
1826
+ - $ref: "#/components/parameters/upload_protocol"
1827
+ - $ref: "#/components/parameters/uploadType"
1828
+ patch:
1829
+ description: Updates a reply with patch semantics.
1830
+ operationId: drive.replies.update
1831
+ parameters:
1832
+ - description: The ID of the file.
1833
+ in: path
1834
+ name: fileId
1835
+ required: true
1836
+ schema:
1837
+ type: string
1838
+ - description: The ID of the comment.
1839
+ in: path
1840
+ name: commentId
1841
+ required: true
1842
+ schema:
1843
+ type: string
1844
+ - description: The ID of the reply.
1845
+ in: path
1846
+ name: replyId
1847
+ required: true
1848
+ schema:
1849
+ type: string
1850
+ requestBody:
1851
+ content:
1852
+ application/json:
1853
+ schema:
1854
+ $ref: "#/components/schemas/Reply"
1855
+ responses:
1856
+ "200":
1857
+ content:
1858
+ application/json:
1859
+ schema:
1860
+ $ref: "#/components/schemas/Reply"
1861
+ description: Successful response
1862
+ security:
1863
+ - Oauth2:
1864
+ - https://www.googleapis.com/auth/drive
1865
+ Oauth2c:
1866
+ - https://www.googleapis.com/auth/drive
1867
+ - Oauth2:
1868
+ - https://www.googleapis.com/auth/drive.file
1869
+ Oauth2c:
1870
+ - https://www.googleapis.com/auth/drive.file
1871
+ tags:
1872
+ - replies
1873
+ /files/{fileId}/copy:
1874
+ parameters:
1875
+ - $ref: "#/components/parameters/_.xgafv"
1876
+ - $ref: "#/components/parameters/access_token"
1877
+ - $ref: "#/components/parameters/alt"
1878
+ - $ref: "#/components/parameters/callback"
1879
+ - $ref: "#/components/parameters/fields"
1880
+ - $ref: "#/components/parameters/key"
1881
+ - $ref: "#/components/parameters/oauth_token"
1882
+ - $ref: "#/components/parameters/prettyPrint"
1883
+ - $ref: "#/components/parameters/quotaUser"
1884
+ - $ref: "#/components/parameters/upload_protocol"
1885
+ - $ref: "#/components/parameters/uploadType"
1886
+ post:
1887
+ description: Creates a copy of a file and applies any requested updates with patch semantics.
1888
+ operationId: drive.files.copy
1889
+ parameters:
1890
+ - description: The ID of the file.
1891
+ in: path
1892
+ name: fileId
1893
+ required: true
1894
+ schema:
1895
+ type: string
1896
+ - description: Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead.
1897
+ in: query
1898
+ name: enforceSingleParent
1899
+ schema:
1900
+ type: boolean
1901
+ - description: Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
1902
+ in: query
1903
+ name: ignoreDefaultVisibility
1904
+ schema:
1905
+ type: boolean
1906
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
1907
+ in: query
1908
+ name: includeLabels
1909
+ schema:
1910
+ type: string
1911
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
1912
+ in: query
1913
+ name: includePermissionsForView
1914
+ schema:
1915
+ type: string
1916
+ - description: Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
1917
+ in: query
1918
+ name: keepRevisionForever
1919
+ schema:
1920
+ type: boolean
1921
+ - description: A language hint for OCR processing during image import (ISO 639-1 code).
1922
+ in: query
1923
+ name: ocrLanguage
1924
+ schema:
1925
+ type: string
1926
+ - description: Whether the requesting application supports both My Drives and shared drives.
1927
+ in: query
1928
+ name: supportsAllDrives
1929
+ schema:
1930
+ type: boolean
1931
+ - description: "Deprecated: Use `supportsAllDrives` instead."
1932
+ in: query
1933
+ name: supportsTeamDrives
1934
+ schema:
1935
+ type: boolean
1936
+ requestBody:
1937
+ content:
1938
+ application/json:
1939
+ schema:
1940
+ $ref: "#/components/schemas/File"
1941
+ responses:
1942
+ "200":
1943
+ content:
1944
+ application/json:
1945
+ schema:
1946
+ $ref: "#/components/schemas/File"
1947
+ description: Successful response
1948
+ security:
1949
+ - Oauth2:
1950
+ - https://www.googleapis.com/auth/drive
1951
+ Oauth2c:
1952
+ - https://www.googleapis.com/auth/drive
1953
+ - Oauth2:
1954
+ - https://www.googleapis.com/auth/drive.appdata
1955
+ Oauth2c:
1956
+ - https://www.googleapis.com/auth/drive.appdata
1957
+ - Oauth2:
1958
+ - https://www.googleapis.com/auth/drive.file
1959
+ Oauth2c:
1960
+ - https://www.googleapis.com/auth/drive.file
1961
+ - Oauth2:
1962
+ - https://www.googleapis.com/auth/drive.photos.readonly
1963
+ Oauth2c:
1964
+ - https://www.googleapis.com/auth/drive.photos.readonly
1965
+ tags:
1966
+ - files
1967
+ /files/{fileId}/export:
1968
+ get:
1969
+ description: Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB.
1970
+ operationId: drive.files.export
1971
+ parameters:
1972
+ - description: The ID of the file.
1973
+ in: path
1974
+ name: fileId
1975
+ required: true
1976
+ schema:
1977
+ type: string
1978
+ - description: Required. The MIME type of the format requested for this export.
1979
+ in: query
1980
+ name: mimeType
1981
+ required: true
1982
+ schema:
1983
+ type: string
1984
+ responses:
1985
+ "200":
1986
+ description: Successful response
1987
+ security:
1988
+ - Oauth2:
1989
+ - https://www.googleapis.com/auth/drive
1990
+ Oauth2c:
1991
+ - https://www.googleapis.com/auth/drive
1992
+ - Oauth2:
1993
+ - https://www.googleapis.com/auth/drive.file
1994
+ Oauth2c:
1995
+ - https://www.googleapis.com/auth/drive.file
1996
+ - Oauth2:
1997
+ - https://www.googleapis.com/auth/drive.readonly
1998
+ Oauth2c:
1999
+ - https://www.googleapis.com/auth/drive.readonly
2000
+ tags:
2001
+ - files
2002
+ parameters:
2003
+ - $ref: "#/components/parameters/_.xgafv"
2004
+ - $ref: "#/components/parameters/access_token"
2005
+ - $ref: "#/components/parameters/alt"
2006
+ - $ref: "#/components/parameters/callback"
2007
+ - $ref: "#/components/parameters/fields"
2008
+ - $ref: "#/components/parameters/key"
2009
+ - $ref: "#/components/parameters/oauth_token"
2010
+ - $ref: "#/components/parameters/prettyPrint"
2011
+ - $ref: "#/components/parameters/quotaUser"
2012
+ - $ref: "#/components/parameters/upload_protocol"
2013
+ - $ref: "#/components/parameters/uploadType"
2014
+ /files/{fileId}/listLabels:
2015
+ get:
2016
+ description: Lists the labels on a file.
2017
+ operationId: drive.files.listLabels
2018
+ parameters:
2019
+ - description: The ID for the file.
2020
+ in: path
2021
+ name: fileId
2022
+ required: true
2023
+ schema:
2024
+ type: string
2025
+ - description: The maximum number of labels to return per page. When not set, defaults to 100.
2026
+ in: query
2027
+ name: maxResults
2028
+ schema:
2029
+ maximum: 100
2030
+ minimum: 1
2031
+ type: integer
2032
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
2033
+ in: query
2034
+ name: pageToken
2035
+ schema:
2036
+ type: string
2037
+ responses:
2038
+ "200":
2039
+ content:
2040
+ application/json:
2041
+ schema:
2042
+ $ref: "#/components/schemas/LabelList"
2043
+ description: Successful response
2044
+ security:
2045
+ - Oauth2:
2046
+ - https://www.googleapis.com/auth/drive
2047
+ Oauth2c:
2048
+ - https://www.googleapis.com/auth/drive
2049
+ - Oauth2:
2050
+ - https://www.googleapis.com/auth/drive.file
2051
+ Oauth2c:
2052
+ - https://www.googleapis.com/auth/drive.file
2053
+ - Oauth2:
2054
+ - https://www.googleapis.com/auth/drive.metadata
2055
+ Oauth2c:
2056
+ - https://www.googleapis.com/auth/drive.metadata
2057
+ - Oauth2:
2058
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2059
+ Oauth2c:
2060
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2061
+ - Oauth2:
2062
+ - https://www.googleapis.com/auth/drive.readonly
2063
+ Oauth2c:
2064
+ - https://www.googleapis.com/auth/drive.readonly
2065
+ tags:
2066
+ - files
2067
+ parameters:
2068
+ - $ref: "#/components/parameters/_.xgafv"
2069
+ - $ref: "#/components/parameters/access_token"
2070
+ - $ref: "#/components/parameters/alt"
2071
+ - $ref: "#/components/parameters/callback"
2072
+ - $ref: "#/components/parameters/fields"
2073
+ - $ref: "#/components/parameters/key"
2074
+ - $ref: "#/components/parameters/oauth_token"
2075
+ - $ref: "#/components/parameters/prettyPrint"
2076
+ - $ref: "#/components/parameters/quotaUser"
2077
+ - $ref: "#/components/parameters/upload_protocol"
2078
+ - $ref: "#/components/parameters/uploadType"
2079
+ /files/{fileId}/modifyLabels:
2080
+ parameters:
2081
+ - $ref: "#/components/parameters/_.xgafv"
2082
+ - $ref: "#/components/parameters/access_token"
2083
+ - $ref: "#/components/parameters/alt"
2084
+ - $ref: "#/components/parameters/callback"
2085
+ - $ref: "#/components/parameters/fields"
2086
+ - $ref: "#/components/parameters/key"
2087
+ - $ref: "#/components/parameters/oauth_token"
2088
+ - $ref: "#/components/parameters/prettyPrint"
2089
+ - $ref: "#/components/parameters/quotaUser"
2090
+ - $ref: "#/components/parameters/upload_protocol"
2091
+ - $ref: "#/components/parameters/uploadType"
2092
+ post:
2093
+ description: Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified.
2094
+ operationId: drive.files.modifyLabels
2095
+ parameters:
2096
+ - description: The ID of the file to which the labels belong.
2097
+ in: path
2098
+ name: fileId
2099
+ required: true
2100
+ schema:
2101
+ type: string
2102
+ requestBody:
2103
+ content:
2104
+ application/json:
2105
+ schema:
2106
+ $ref: "#/components/schemas/ModifyLabelsRequest"
2107
+ responses:
2108
+ "200":
2109
+ content:
2110
+ application/json:
2111
+ schema:
2112
+ $ref: "#/components/schemas/ModifyLabelsResponse"
2113
+ description: Successful response
2114
+ security:
2115
+ - Oauth2:
2116
+ - https://www.googleapis.com/auth/drive
2117
+ Oauth2c:
2118
+ - https://www.googleapis.com/auth/drive
2119
+ - Oauth2:
2120
+ - https://www.googleapis.com/auth/drive.file
2121
+ Oauth2c:
2122
+ - https://www.googleapis.com/auth/drive.file
2123
+ - Oauth2:
2124
+ - https://www.googleapis.com/auth/drive.metadata
2125
+ Oauth2c:
2126
+ - https://www.googleapis.com/auth/drive.metadata
2127
+ tags:
2128
+ - files
2129
+ /files/{fileId}/permissions:
2130
+ get:
2131
+ description: Lists a file's or shared drive's permissions.
2132
+ operationId: drive.permissions.list
2133
+ parameters:
2134
+ - description: The ID of the file or shared drive.
2135
+ in: path
2136
+ name: fileId
2137
+ required: true
2138
+ schema:
2139
+ type: string
2140
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
2141
+ in: query
2142
+ name: includePermissionsForView
2143
+ schema:
2144
+ type: string
2145
+ - description: The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.
2146
+ in: query
2147
+ name: pageSize
2148
+ schema:
2149
+ maximum: 100
2150
+ minimum: 1
2151
+ type: integer
2152
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
2153
+ in: query
2154
+ name: pageToken
2155
+ schema:
2156
+ type: string
2157
+ - description: Whether the requesting application supports both My Drives and shared drives.
2158
+ in: query
2159
+ name: supportsAllDrives
2160
+ schema:
2161
+ type: boolean
2162
+ - description: "Deprecated: Use `supportsAllDrives` instead."
2163
+ in: query
2164
+ name: supportsTeamDrives
2165
+ schema:
2166
+ type: boolean
2167
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
2168
+ in: query
2169
+ name: useDomainAdminAccess
2170
+ schema:
2171
+ type: boolean
2172
+ responses:
2173
+ "200":
2174
+ content:
2175
+ application/json:
2176
+ schema:
2177
+ $ref: "#/components/schemas/PermissionList"
2178
+ description: Successful response
2179
+ security:
2180
+ - Oauth2:
2181
+ - https://www.googleapis.com/auth/drive
2182
+ Oauth2c:
2183
+ - https://www.googleapis.com/auth/drive
2184
+ - Oauth2:
2185
+ - https://www.googleapis.com/auth/drive.file
2186
+ Oauth2c:
2187
+ - https://www.googleapis.com/auth/drive.file
2188
+ - Oauth2:
2189
+ - https://www.googleapis.com/auth/drive.metadata
2190
+ Oauth2c:
2191
+ - https://www.googleapis.com/auth/drive.metadata
2192
+ - Oauth2:
2193
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2194
+ Oauth2c:
2195
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2196
+ - Oauth2:
2197
+ - https://www.googleapis.com/auth/drive.photos.readonly
2198
+ Oauth2c:
2199
+ - https://www.googleapis.com/auth/drive.photos.readonly
2200
+ - Oauth2:
2201
+ - https://www.googleapis.com/auth/drive.readonly
2202
+ Oauth2c:
2203
+ - https://www.googleapis.com/auth/drive.readonly
2204
+ tags:
2205
+ - permissions
2206
+ parameters:
2207
+ - $ref: "#/components/parameters/_.xgafv"
2208
+ - $ref: "#/components/parameters/access_token"
2209
+ - $ref: "#/components/parameters/alt"
2210
+ - $ref: "#/components/parameters/callback"
2211
+ - $ref: "#/components/parameters/fields"
2212
+ - $ref: "#/components/parameters/key"
2213
+ - $ref: "#/components/parameters/oauth_token"
2214
+ - $ref: "#/components/parameters/prettyPrint"
2215
+ - $ref: "#/components/parameters/quotaUser"
2216
+ - $ref: "#/components/parameters/upload_protocol"
2217
+ - $ref: "#/components/parameters/uploadType"
2218
+ post:
2219
+ description: Creates a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
2220
+ operationId: drive.permissions.create
2221
+ parameters:
2222
+ - description: The ID of the file or shared drive.
2223
+ in: path
2224
+ name: fileId
2225
+ required: true
2226
+ schema:
2227
+ type: string
2228
+ - description: A plain text custom message to include in the notification email.
2229
+ in: query
2230
+ name: emailMessage
2231
+ schema:
2232
+ type: string
2233
+ - description: "Deprecated: See `moveToNewOwnersRoot` for details."
2234
+ in: query
2235
+ name: enforceSingleParent
2236
+ schema:
2237
+ type: boolean
2238
+ - description: This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed.
2239
+ in: query
2240
+ name: moveToNewOwnersRoot
2241
+ schema:
2242
+ type: boolean
2243
+ - description: Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.
2244
+ in: query
2245
+ name: sendNotificationEmail
2246
+ schema:
2247
+ type: boolean
2248
+ - description: Whether the requesting application supports both My Drives and shared drives.
2249
+ in: query
2250
+ name: supportsAllDrives
2251
+ schema:
2252
+ type: boolean
2253
+ - description: "Deprecated: Use `supportsAllDrives` instead."
2254
+ in: query
2255
+ name: supportsTeamDrives
2256
+ schema:
2257
+ type: boolean
2258
+ - description: Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.
2259
+ in: query
2260
+ name: transferOwnership
2261
+ schema:
2262
+ type: boolean
2263
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
2264
+ in: query
2265
+ name: useDomainAdminAccess
2266
+ schema:
2267
+ type: boolean
2268
+ requestBody:
2269
+ content:
2270
+ application/json:
2271
+ schema:
2272
+ $ref: "#/components/schemas/Permission"
2273
+ responses:
2274
+ "200":
2275
+ content:
2276
+ application/json:
2277
+ schema:
2278
+ $ref: "#/components/schemas/Permission"
2279
+ description: Successful response
2280
+ security:
2281
+ - Oauth2:
2282
+ - https://www.googleapis.com/auth/drive
2283
+ Oauth2c:
2284
+ - https://www.googleapis.com/auth/drive
2285
+ - Oauth2:
2286
+ - https://www.googleapis.com/auth/drive.file
2287
+ Oauth2c:
2288
+ - https://www.googleapis.com/auth/drive.file
2289
+ tags:
2290
+ - permissions
2291
+ /files/{fileId}/permissions/{permissionId}:
2292
+ delete:
2293
+ description: Deletes a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
2294
+ operationId: drive.permissions.delete
2295
+ parameters:
2296
+ - description: The ID of the file or shared drive.
2297
+ in: path
2298
+ name: fileId
2299
+ required: true
2300
+ schema:
2301
+ type: string
2302
+ - description: The ID of the permission.
2303
+ in: path
2304
+ name: permissionId
2305
+ required: true
2306
+ schema:
2307
+ type: string
2308
+ - description: Whether the requesting application supports both My Drives and shared drives.
2309
+ in: query
2310
+ name: supportsAllDrives
2311
+ schema:
2312
+ type: boolean
2313
+ - description: "Deprecated: Use `supportsAllDrives` instead."
2314
+ in: query
2315
+ name: supportsTeamDrives
2316
+ schema:
2317
+ type: boolean
2318
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
2319
+ in: query
2320
+ name: useDomainAdminAccess
2321
+ schema:
2322
+ type: boolean
2323
+ responses:
2324
+ "200":
2325
+ description: Successful response
2326
+ security:
2327
+ - Oauth2:
2328
+ - https://www.googleapis.com/auth/drive
2329
+ Oauth2c:
2330
+ - https://www.googleapis.com/auth/drive
2331
+ - Oauth2:
2332
+ - https://www.googleapis.com/auth/drive.file
2333
+ Oauth2c:
2334
+ - https://www.googleapis.com/auth/drive.file
2335
+ tags:
2336
+ - permissions
2337
+ get:
2338
+ description: Gets a permission by ID.
2339
+ operationId: drive.permissions.get
2340
+ parameters:
2341
+ - description: The ID of the file.
2342
+ in: path
2343
+ name: fileId
2344
+ required: true
2345
+ schema:
2346
+ type: string
2347
+ - description: The ID of the permission.
2348
+ in: path
2349
+ name: permissionId
2350
+ required: true
2351
+ schema:
2352
+ type: string
2353
+ - description: Whether the requesting application supports both My Drives and shared drives.
2354
+ in: query
2355
+ name: supportsAllDrives
2356
+ schema:
2357
+ type: boolean
2358
+ - description: "Deprecated: Use `supportsAllDrives` instead."
2359
+ in: query
2360
+ name: supportsTeamDrives
2361
+ schema:
2362
+ type: boolean
2363
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
2364
+ in: query
2365
+ name: useDomainAdminAccess
2366
+ schema:
2367
+ type: boolean
2368
+ responses:
2369
+ "200":
2370
+ content:
2371
+ application/json:
2372
+ schema:
2373
+ $ref: "#/components/schemas/Permission"
2374
+ description: Successful response
2375
+ security:
2376
+ - Oauth2:
2377
+ - https://www.googleapis.com/auth/drive
2378
+ Oauth2c:
2379
+ - https://www.googleapis.com/auth/drive
2380
+ - Oauth2:
2381
+ - https://www.googleapis.com/auth/drive.file
2382
+ Oauth2c:
2383
+ - https://www.googleapis.com/auth/drive.file
2384
+ - Oauth2:
2385
+ - https://www.googleapis.com/auth/drive.metadata
2386
+ Oauth2c:
2387
+ - https://www.googleapis.com/auth/drive.metadata
2388
+ - Oauth2:
2389
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2390
+ Oauth2c:
2391
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2392
+ - Oauth2:
2393
+ - https://www.googleapis.com/auth/drive.photos.readonly
2394
+ Oauth2c:
2395
+ - https://www.googleapis.com/auth/drive.photos.readonly
2396
+ - Oauth2:
2397
+ - https://www.googleapis.com/auth/drive.readonly
2398
+ Oauth2c:
2399
+ - https://www.googleapis.com/auth/drive.readonly
2400
+ tags:
2401
+ - permissions
2402
+ parameters:
2403
+ - $ref: "#/components/parameters/_.xgafv"
2404
+ - $ref: "#/components/parameters/access_token"
2405
+ - $ref: "#/components/parameters/alt"
2406
+ - $ref: "#/components/parameters/callback"
2407
+ - $ref: "#/components/parameters/fields"
2408
+ - $ref: "#/components/parameters/key"
2409
+ - $ref: "#/components/parameters/oauth_token"
2410
+ - $ref: "#/components/parameters/prettyPrint"
2411
+ - $ref: "#/components/parameters/quotaUser"
2412
+ - $ref: "#/components/parameters/upload_protocol"
2413
+ - $ref: "#/components/parameters/uploadType"
2414
+ patch:
2415
+ description: Updates a permission with patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
2416
+ operationId: drive.permissions.update
2417
+ parameters:
2418
+ - description: The ID of the file or shared drive.
2419
+ in: path
2420
+ name: fileId
2421
+ required: true
2422
+ schema:
2423
+ type: string
2424
+ - description: The ID of the permission.
2425
+ in: path
2426
+ name: permissionId
2427
+ required: true
2428
+ schema:
2429
+ type: string
2430
+ - description: Whether to remove the expiration date.
2431
+ in: query
2432
+ name: removeExpiration
2433
+ schema:
2434
+ type: boolean
2435
+ - description: Whether the requesting application supports both My Drives and shared drives.
2436
+ in: query
2437
+ name: supportsAllDrives
2438
+ schema:
2439
+ type: boolean
2440
+ - description: "Deprecated: Use `supportsAllDrives` instead."
2441
+ in: query
2442
+ name: supportsTeamDrives
2443
+ schema:
2444
+ type: boolean
2445
+ - description: Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.
2446
+ in: query
2447
+ name: transferOwnership
2448
+ schema:
2449
+ type: boolean
2450
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
2451
+ in: query
2452
+ name: useDomainAdminAccess
2453
+ schema:
2454
+ type: boolean
2455
+ requestBody:
2456
+ content:
2457
+ application/json:
2458
+ schema:
2459
+ $ref: "#/components/schemas/Permission"
2460
+ responses:
2461
+ "200":
2462
+ content:
2463
+ application/json:
2464
+ schema:
2465
+ $ref: "#/components/schemas/Permission"
2466
+ description: Successful response
2467
+ security:
2468
+ - Oauth2:
2469
+ - https://www.googleapis.com/auth/drive
2470
+ Oauth2c:
2471
+ - https://www.googleapis.com/auth/drive
2472
+ - Oauth2:
2473
+ - https://www.googleapis.com/auth/drive.file
2474
+ Oauth2c:
2475
+ - https://www.googleapis.com/auth/drive.file
2476
+ tags:
2477
+ - permissions
2478
+ /files/{fileId}/revisions:
2479
+ get:
2480
+ description: Lists a file's revisions.
2481
+ operationId: drive.revisions.list
2482
+ parameters:
2483
+ - description: The ID of the file.
2484
+ in: path
2485
+ name: fileId
2486
+ required: true
2487
+ schema:
2488
+ type: string
2489
+ - description: The maximum number of revisions to return per page.
2490
+ in: query
2491
+ name: pageSize
2492
+ schema:
2493
+ maximum: 1000
2494
+ minimum: 1
2495
+ type: integer
2496
+ - description: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
2497
+ in: query
2498
+ name: pageToken
2499
+ schema:
2500
+ type: string
2501
+ responses:
2502
+ "200":
2503
+ content:
2504
+ application/json:
2505
+ schema:
2506
+ $ref: "#/components/schemas/RevisionList"
2507
+ description: Successful response
2508
+ security:
2509
+ - Oauth2:
2510
+ - https://www.googleapis.com/auth/drive
2511
+ Oauth2c:
2512
+ - https://www.googleapis.com/auth/drive
2513
+ - Oauth2:
2514
+ - https://www.googleapis.com/auth/drive.appdata
2515
+ Oauth2c:
2516
+ - https://www.googleapis.com/auth/drive.appdata
2517
+ - Oauth2:
2518
+ - https://www.googleapis.com/auth/drive.file
2519
+ Oauth2c:
2520
+ - https://www.googleapis.com/auth/drive.file
2521
+ - Oauth2:
2522
+ - https://www.googleapis.com/auth/drive.metadata
2523
+ Oauth2c:
2524
+ - https://www.googleapis.com/auth/drive.metadata
2525
+ - Oauth2:
2526
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2527
+ Oauth2c:
2528
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2529
+ - Oauth2:
2530
+ - https://www.googleapis.com/auth/drive.photos.readonly
2531
+ Oauth2c:
2532
+ - https://www.googleapis.com/auth/drive.photos.readonly
2533
+ - Oauth2:
2534
+ - https://www.googleapis.com/auth/drive.readonly
2535
+ Oauth2c:
2536
+ - https://www.googleapis.com/auth/drive.readonly
2537
+ tags:
2538
+ - revisions
2539
+ parameters:
2540
+ - $ref: "#/components/parameters/_.xgafv"
2541
+ - $ref: "#/components/parameters/access_token"
2542
+ - $ref: "#/components/parameters/alt"
2543
+ - $ref: "#/components/parameters/callback"
2544
+ - $ref: "#/components/parameters/fields"
2545
+ - $ref: "#/components/parameters/key"
2546
+ - $ref: "#/components/parameters/oauth_token"
2547
+ - $ref: "#/components/parameters/prettyPrint"
2548
+ - $ref: "#/components/parameters/quotaUser"
2549
+ - $ref: "#/components/parameters/upload_protocol"
2550
+ - $ref: "#/components/parameters/uploadType"
2551
+ /files/{fileId}/revisions/{revisionId}:
2552
+ delete:
2553
+ description: Permanently deletes a file version. You can only delete revisions for files with binary content in Google Drive, like images or videos. Revisions for other files, like Google Docs or Sheets, and the last remaining file version can't be deleted.
2554
+ operationId: drive.revisions.delete
2555
+ parameters:
2556
+ - description: The ID of the file.
2557
+ in: path
2558
+ name: fileId
2559
+ required: true
2560
+ schema:
2561
+ type: string
2562
+ - description: The ID of the revision.
2563
+ in: path
2564
+ name: revisionId
2565
+ required: true
2566
+ schema:
2567
+ type: string
2568
+ responses:
2569
+ "200":
2570
+ description: Successful response
2571
+ security:
2572
+ - Oauth2:
2573
+ - https://www.googleapis.com/auth/drive
2574
+ Oauth2c:
2575
+ - https://www.googleapis.com/auth/drive
2576
+ - Oauth2:
2577
+ - https://www.googleapis.com/auth/drive.appdata
2578
+ Oauth2c:
2579
+ - https://www.googleapis.com/auth/drive.appdata
2580
+ - Oauth2:
2581
+ - https://www.googleapis.com/auth/drive.file
2582
+ Oauth2c:
2583
+ - https://www.googleapis.com/auth/drive.file
2584
+ tags:
2585
+ - revisions
2586
+ get:
2587
+ description: Gets a revision's metadata or content by ID.
2588
+ operationId: drive.revisions.get
2589
+ parameters:
2590
+ - description: The ID of the file.
2591
+ in: path
2592
+ name: fileId
2593
+ required: true
2594
+ schema:
2595
+ type: string
2596
+ - description: The ID of the revision.
2597
+ in: path
2598
+ name: revisionId
2599
+ required: true
2600
+ schema:
2601
+ type: string
2602
+ - description: Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.
2603
+ in: query
2604
+ name: acknowledgeAbuse
2605
+ schema:
2606
+ type: boolean
2607
+ responses:
2608
+ "200":
2609
+ content:
2610
+ application/json:
2611
+ schema:
2612
+ $ref: "#/components/schemas/Revision"
2613
+ description: Successful response
2614
+ security:
2615
+ - Oauth2:
2616
+ - https://www.googleapis.com/auth/drive
2617
+ Oauth2c:
2618
+ - https://www.googleapis.com/auth/drive
2619
+ - Oauth2:
2620
+ - https://www.googleapis.com/auth/drive.appdata
2621
+ Oauth2c:
2622
+ - https://www.googleapis.com/auth/drive.appdata
2623
+ - Oauth2:
2624
+ - https://www.googleapis.com/auth/drive.file
2625
+ Oauth2c:
2626
+ - https://www.googleapis.com/auth/drive.file
2627
+ - Oauth2:
2628
+ - https://www.googleapis.com/auth/drive.metadata
2629
+ Oauth2c:
2630
+ - https://www.googleapis.com/auth/drive.metadata
2631
+ - Oauth2:
2632
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2633
+ Oauth2c:
2634
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2635
+ - Oauth2:
2636
+ - https://www.googleapis.com/auth/drive.photos.readonly
2637
+ Oauth2c:
2638
+ - https://www.googleapis.com/auth/drive.photos.readonly
2639
+ - Oauth2:
2640
+ - https://www.googleapis.com/auth/drive.readonly
2641
+ Oauth2c:
2642
+ - https://www.googleapis.com/auth/drive.readonly
2643
+ tags:
2644
+ - revisions
2645
+ parameters:
2646
+ - $ref: "#/components/parameters/_.xgafv"
2647
+ - $ref: "#/components/parameters/access_token"
2648
+ - $ref: "#/components/parameters/alt"
2649
+ - $ref: "#/components/parameters/callback"
2650
+ - $ref: "#/components/parameters/fields"
2651
+ - $ref: "#/components/parameters/key"
2652
+ - $ref: "#/components/parameters/oauth_token"
2653
+ - $ref: "#/components/parameters/prettyPrint"
2654
+ - $ref: "#/components/parameters/quotaUser"
2655
+ - $ref: "#/components/parameters/upload_protocol"
2656
+ - $ref: "#/components/parameters/uploadType"
2657
+ patch:
2658
+ description: Updates a revision with patch semantics.
2659
+ operationId: drive.revisions.update
2660
+ parameters:
2661
+ - description: The ID of the file.
2662
+ in: path
2663
+ name: fileId
2664
+ required: true
2665
+ schema:
2666
+ type: string
2667
+ - description: The ID of the revision.
2668
+ in: path
2669
+ name: revisionId
2670
+ required: true
2671
+ schema:
2672
+ type: string
2673
+ requestBody:
2674
+ content:
2675
+ application/json:
2676
+ schema:
2677
+ $ref: "#/components/schemas/Revision"
2678
+ responses:
2679
+ "200":
2680
+ content:
2681
+ application/json:
2682
+ schema:
2683
+ $ref: "#/components/schemas/Revision"
2684
+ description: Successful response
2685
+ security:
2686
+ - Oauth2:
2687
+ - https://www.googleapis.com/auth/drive
2688
+ Oauth2c:
2689
+ - https://www.googleapis.com/auth/drive
2690
+ - Oauth2:
2691
+ - https://www.googleapis.com/auth/drive.appdata
2692
+ Oauth2c:
2693
+ - https://www.googleapis.com/auth/drive.appdata
2694
+ - Oauth2:
2695
+ - https://www.googleapis.com/auth/drive.file
2696
+ Oauth2c:
2697
+ - https://www.googleapis.com/auth/drive.file
2698
+ tags:
2699
+ - revisions
2700
+ /files/{fileId}/watch:
2701
+ parameters:
2702
+ - $ref: "#/components/parameters/_.xgafv"
2703
+ - $ref: "#/components/parameters/access_token"
2704
+ - $ref: "#/components/parameters/alt"
2705
+ - $ref: "#/components/parameters/callback"
2706
+ - $ref: "#/components/parameters/fields"
2707
+ - $ref: "#/components/parameters/key"
2708
+ - $ref: "#/components/parameters/oauth_token"
2709
+ - $ref: "#/components/parameters/prettyPrint"
2710
+ - $ref: "#/components/parameters/quotaUser"
2711
+ - $ref: "#/components/parameters/upload_protocol"
2712
+ - $ref: "#/components/parameters/uploadType"
2713
+ post:
2714
+ description: Subscribes to changes to a file.
2715
+ operationId: drive.files.watch
2716
+ parameters:
2717
+ - description: The ID of the file.
2718
+ in: path
2719
+ name: fileId
2720
+ required: true
2721
+ schema:
2722
+ type: string
2723
+ - description: Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.
2724
+ in: query
2725
+ name: acknowledgeAbuse
2726
+ schema:
2727
+ type: boolean
2728
+ - description: A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
2729
+ in: query
2730
+ name: includeLabels
2731
+ schema:
2732
+ type: string
2733
+ - description: Specifies which additional view's permissions to include in the response. Only 'published' is supported.
2734
+ in: query
2735
+ name: includePermissionsForView
2736
+ schema:
2737
+ type: string
2738
+ - description: Whether the requesting application supports both My Drives and shared drives.
2739
+ in: query
2740
+ name: supportsAllDrives
2741
+ schema:
2742
+ type: boolean
2743
+ - description: "Deprecated: Use `supportsAllDrives` instead."
2744
+ in: query
2745
+ name: supportsTeamDrives
2746
+ schema:
2747
+ type: boolean
2748
+ requestBody:
2749
+ content:
2750
+ application/json:
2751
+ schema:
2752
+ $ref: "#/components/schemas/Channel"
2753
+ responses:
2754
+ "200":
2755
+ content:
2756
+ application/json:
2757
+ schema:
2758
+ $ref: "#/components/schemas/Channel"
2759
+ description: Successful response
2760
+ security:
2761
+ - Oauth2:
2762
+ - https://www.googleapis.com/auth/drive
2763
+ Oauth2c:
2764
+ - https://www.googleapis.com/auth/drive
2765
+ - Oauth2:
2766
+ - https://www.googleapis.com/auth/drive.appdata
2767
+ Oauth2c:
2768
+ - https://www.googleapis.com/auth/drive.appdata
2769
+ - Oauth2:
2770
+ - https://www.googleapis.com/auth/drive.file
2771
+ Oauth2c:
2772
+ - https://www.googleapis.com/auth/drive.file
2773
+ - Oauth2:
2774
+ - https://www.googleapis.com/auth/drive.metadata
2775
+ Oauth2c:
2776
+ - https://www.googleapis.com/auth/drive.metadata
2777
+ - Oauth2:
2778
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2779
+ Oauth2c:
2780
+ - https://www.googleapis.com/auth/drive.metadata.readonly
2781
+ - Oauth2:
2782
+ - https://www.googleapis.com/auth/drive.photos.readonly
2783
+ Oauth2c:
2784
+ - https://www.googleapis.com/auth/drive.photos.readonly
2785
+ - Oauth2:
2786
+ - https://www.googleapis.com/auth/drive.readonly
2787
+ Oauth2c:
2788
+ - https://www.googleapis.com/auth/drive.readonly
2789
+ tags:
2790
+ - files
2791
+ /teamdrives:
2792
+ get:
2793
+ description: "Deprecated: Use `drives.list` instead."
2794
+ operationId: drive.teamdrives.list
2795
+ parameters:
2796
+ - description: Maximum number of Team Drives to return.
2797
+ in: query
2798
+ name: pageSize
2799
+ schema:
2800
+ maximum: 100
2801
+ minimum: 1
2802
+ type: integer
2803
+ - description: Page token for Team Drives.
2804
+ in: query
2805
+ name: pageToken
2806
+ schema:
2807
+ type: string
2808
+ - description: Query string for searching Team Drives.
2809
+ in: query
2810
+ name: q
2811
+ schema:
2812
+ type: string
2813
+ - description: Issue the request as a domain administrator; if set to true, then all Team Drives of the domain in which the requester is an administrator are returned.
2814
+ in: query
2815
+ name: useDomainAdminAccess
2816
+ schema:
2817
+ type: boolean
2818
+ responses:
2819
+ "200":
2820
+ content:
2821
+ application/json:
2822
+ schema:
2823
+ $ref: "#/components/schemas/TeamDriveList"
2824
+ description: Successful response
2825
+ security:
2826
+ - Oauth2:
2827
+ - https://www.googleapis.com/auth/drive
2828
+ Oauth2c:
2829
+ - https://www.googleapis.com/auth/drive
2830
+ - Oauth2:
2831
+ - https://www.googleapis.com/auth/drive.readonly
2832
+ Oauth2c:
2833
+ - https://www.googleapis.com/auth/drive.readonly
2834
+ tags:
2835
+ - teamdrives
2836
+ parameters:
2837
+ - $ref: "#/components/parameters/_.xgafv"
2838
+ - $ref: "#/components/parameters/access_token"
2839
+ - $ref: "#/components/parameters/alt"
2840
+ - $ref: "#/components/parameters/callback"
2841
+ - $ref: "#/components/parameters/fields"
2842
+ - $ref: "#/components/parameters/key"
2843
+ - $ref: "#/components/parameters/oauth_token"
2844
+ - $ref: "#/components/parameters/prettyPrint"
2845
+ - $ref: "#/components/parameters/quotaUser"
2846
+ - $ref: "#/components/parameters/upload_protocol"
2847
+ - $ref: "#/components/parameters/uploadType"
2848
+ post:
2849
+ description: "Deprecated: Use `drives.create` instead."
2850
+ operationId: drive.teamdrives.create
2851
+ parameters:
2852
+ - description: Required. An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a Team Drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same Team Drive. If the Team Drive already exists a 409 error will be returned.
2853
+ in: query
2854
+ name: requestId
2855
+ required: true
2856
+ schema:
2857
+ type: string
2858
+ requestBody:
2859
+ content:
2860
+ application/json:
2861
+ schema:
2862
+ $ref: "#/components/schemas/TeamDrive"
2863
+ responses:
2864
+ "200":
2865
+ content:
2866
+ application/json:
2867
+ schema:
2868
+ $ref: "#/components/schemas/TeamDrive"
2869
+ description: Successful response
2870
+ security:
2871
+ - Oauth2:
2872
+ - https://www.googleapis.com/auth/drive
2873
+ Oauth2c:
2874
+ - https://www.googleapis.com/auth/drive
2875
+ tags:
2876
+ - teamdrives
2877
+ /teamdrives/{teamDriveId}:
2878
+ delete:
2879
+ description: "Deprecated: Use `drives.delete` instead."
2880
+ operationId: drive.teamdrives.delete
2881
+ parameters:
2882
+ - description: The ID of the Team Drive
2883
+ in: path
2884
+ name: teamDriveId
2885
+ required: true
2886
+ schema:
2887
+ type: string
2888
+ responses:
2889
+ "200":
2890
+ description: Successful response
2891
+ security:
2892
+ - Oauth2:
2893
+ - https://www.googleapis.com/auth/drive
2894
+ Oauth2c:
2895
+ - https://www.googleapis.com/auth/drive
2896
+ tags:
2897
+ - teamdrives
2898
+ get:
2899
+ description: "Deprecated: Use `drives.get` instead."
2900
+ operationId: drive.teamdrives.get
2901
+ parameters:
2902
+ - description: The ID of the Team Drive
2903
+ in: path
2904
+ name: teamDriveId
2905
+ required: true
2906
+ schema:
2907
+ type: string
2908
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.
2909
+ in: query
2910
+ name: useDomainAdminAccess
2911
+ schema:
2912
+ type: boolean
2913
+ responses:
2914
+ "200":
2915
+ content:
2916
+ application/json:
2917
+ schema:
2918
+ $ref: "#/components/schemas/TeamDrive"
2919
+ description: Successful response
2920
+ security:
2921
+ - Oauth2:
2922
+ - https://www.googleapis.com/auth/drive
2923
+ Oauth2c:
2924
+ - https://www.googleapis.com/auth/drive
2925
+ - Oauth2:
2926
+ - https://www.googleapis.com/auth/drive.readonly
2927
+ Oauth2c:
2928
+ - https://www.googleapis.com/auth/drive.readonly
2929
+ tags:
2930
+ - teamdrives
2931
+ parameters:
2932
+ - $ref: "#/components/parameters/_.xgafv"
2933
+ - $ref: "#/components/parameters/access_token"
2934
+ - $ref: "#/components/parameters/alt"
2935
+ - $ref: "#/components/parameters/callback"
2936
+ - $ref: "#/components/parameters/fields"
2937
+ - $ref: "#/components/parameters/key"
2938
+ - $ref: "#/components/parameters/oauth_token"
2939
+ - $ref: "#/components/parameters/prettyPrint"
2940
+ - $ref: "#/components/parameters/quotaUser"
2941
+ - $ref: "#/components/parameters/upload_protocol"
2942
+ - $ref: "#/components/parameters/uploadType"
2943
+ patch:
2944
+ description: "Deprecated: Use `drives.update` instead."
2945
+ operationId: drive.teamdrives.update
2946
+ parameters:
2947
+ - description: The ID of the Team Drive
2948
+ in: path
2949
+ name: teamDriveId
2950
+ required: true
2951
+ schema:
2952
+ type: string
2953
+ - description: Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.
2954
+ in: query
2955
+ name: useDomainAdminAccess
2956
+ schema:
2957
+ type: boolean
2958
+ requestBody:
2959
+ content:
2960
+ application/json:
2961
+ schema:
2962
+ $ref: "#/components/schemas/TeamDrive"
2963
+ responses:
2964
+ "200":
2965
+ content:
2966
+ application/json:
2967
+ schema:
2968
+ $ref: "#/components/schemas/TeamDrive"
2969
+ description: Successful response
2970
+ security:
2971
+ - Oauth2:
2972
+ - https://www.googleapis.com/auth/drive
2973
+ Oauth2c:
2974
+ - https://www.googleapis.com/auth/drive
2975
+ tags:
2976
+ - teamdrives
2977
+ components:
2978
+ parameters:
2979
+ _.xgafv:
2980
+ description: V1 error format.
2981
+ in: query
2982
+ name: $.xgafv
2983
+ schema:
2984
+ enum:
2985
+ - "1"
2986
+ - "2"
2987
+ type: string
2988
+ access_token:
2989
+ description: OAuth access token.
2990
+ in: query
2991
+ name: access_token
2992
+ schema:
2993
+ type: string
2994
+ alt:
2995
+ description: Data format for response.
2996
+ in: query
2997
+ name: alt
2998
+ schema:
2999
+ enum:
3000
+ - json
3001
+ - media
3002
+ - proto
3003
+ type: string
3004
+ callback:
3005
+ description: JSONP
3006
+ in: query
3007
+ name: callback
3008
+ schema:
3009
+ type: string
3010
+ fields:
3011
+ description: Selector specifying which fields to include in a partial response.
3012
+ in: query
3013
+ name: fields
3014
+ schema:
3015
+ type: string
3016
+ key:
3017
+ description: API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
3018
+ in: query
3019
+ name: key
3020
+ schema:
3021
+ type: string
3022
+ oauth_token:
3023
+ description: OAuth 2.0 token for the current user.
3024
+ in: query
3025
+ name: oauth_token
3026
+ schema:
3027
+ type: string
3028
+ prettyPrint:
3029
+ description: Returns response with indentations and line breaks.
3030
+ in: query
3031
+ name: prettyPrint
3032
+ schema:
3033
+ type: boolean
3034
+ quotaUser:
3035
+ description: Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
3036
+ in: query
3037
+ name: quotaUser
3038
+ schema:
3039
+ type: string
3040
+ uploadType:
3041
+ description: Legacy upload protocol for media (e.g. "media", "multipart").
3042
+ in: query
3043
+ name: uploadType
3044
+ schema:
3045
+ type: string
3046
+ upload_protocol:
3047
+ description: Upload protocol for media (e.g. "raw", "multipart").
3048
+ in: query
3049
+ name: upload_protocol
3050
+ schema:
3051
+ type: string
3052
+ schemas:
3053
+ About:
3054
+ description: Information about the user, the user's Drive, and system capabilities.
3055
+ properties:
3056
+ appInstalled:
3057
+ description: Whether the user has installed the requesting app.
3058
+ type: boolean
3059
+ canCreateDrives:
3060
+ description: Whether the user can create shared drives.
3061
+ type: boolean
3062
+ canCreateTeamDrives:
3063
+ deprecated: true
3064
+ description: "Deprecated: Use `canCreateDrives` instead."
3065
+ type: boolean
3066
+ driveThemes:
3067
+ description: A list of themes that are supported for shared drives.
3068
+ items:
3069
+ properties:
3070
+ backgroundImageLink:
3071
+ description: A link to this theme's background image.
3072
+ type: string
3073
+ colorRgb:
3074
+ description: The color of this theme as an RGB hex string.
3075
+ type: string
3076
+ id:
3077
+ description: The ID of the theme.
3078
+ type: string
3079
+ type: object
3080
+ type: array
3081
+ exportFormats:
3082
+ additionalProperties:
3083
+ items:
3084
+ type: string
3085
+ type: array
3086
+ description: A map of source MIME type to possible targets for all supported exports.
3087
+ type: object
3088
+ folderColorPalette:
3089
+ description: The currently supported folder colors as RGB hex strings.
3090
+ items:
3091
+ type: string
3092
+ type: array
3093
+ importFormats:
3094
+ additionalProperties:
3095
+ items:
3096
+ type: string
3097
+ type: array
3098
+ description: A map of source MIME type to possible targets for all supported imports.
3099
+ type: object
3100
+ kind:
3101
+ default: drive#about
3102
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#about"`.'
3103
+ type: string
3104
+ maxImportSizes:
3105
+ additionalProperties:
3106
+ format: int64
3107
+ type: string
3108
+ description: A map of maximum import sizes by MIME type, in bytes.
3109
+ type: object
3110
+ maxUploadSize:
3111
+ description: The maximum upload size in bytes.
3112
+ format: int64
3113
+ type: string
3114
+ storageQuota:
3115
+ description: The user's storage quota limits and usage. All fields are measured in bytes.
3116
+ properties:
3117
+ limit:
3118
+ description: The usage limit, if applicable. This will not be present if the user has unlimited storage.
3119
+ format: int64
3120
+ type: string
3121
+ usage:
3122
+ description: The total usage across all services.
3123
+ format: int64
3124
+ type: string
3125
+ usageInDrive:
3126
+ description: The usage by all files in Google Drive.
3127
+ format: int64
3128
+ type: string
3129
+ usageInDriveTrash:
3130
+ description: The usage by trashed files in Google Drive.
3131
+ format: int64
3132
+ type: string
3133
+ type: object
3134
+ teamDriveThemes:
3135
+ deprecated: true
3136
+ description: "Deprecated: Use `driveThemes` instead."
3137
+ items:
3138
+ properties:
3139
+ backgroundImageLink:
3140
+ deprecated: true
3141
+ description: "Deprecated: Use `driveThemes/backgroundImageLink` instead."
3142
+ type: string
3143
+ colorRgb:
3144
+ deprecated: true
3145
+ description: "Deprecated: Use `driveThemes/colorRgb` instead."
3146
+ type: string
3147
+ id:
3148
+ deprecated: true
3149
+ description: "Deprecated: Use `driveThemes/id` instead."
3150
+ type: string
3151
+ type: object
3152
+ type: array
3153
+ user:
3154
+ $ref: "#/components/schemas/User"
3155
+ description: The authenticated user.
3156
+ type: object
3157
+ App:
3158
+ description: The `apps` resource provides a list of apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details. Some resource methods (such as `apps.get`) require an `appId`. Use the `apps.list` method to retrieve the ID for an installed application.
3159
+ properties:
3160
+ authorized:
3161
+ description: Whether the app is authorized to access data on the user's Drive.
3162
+ type: boolean
3163
+ createInFolderTemplate:
3164
+ description: The template URL to create a file with this app in a given folder. The template contains the {folderId} to be replaced by the folder ID house the new file.
3165
+ type: string
3166
+ createUrl:
3167
+ description: The URL to create a file with this app.
3168
+ type: string
3169
+ hasDriveWideScope:
3170
+ description: Whether the app has Drive-wide scope. An app with Drive-wide scope can access all files in the user's Drive.
3171
+ type: boolean
3172
+ icons:
3173
+ description: The various icons for the app.
3174
+ items:
3175
+ $ref: "#/components/schemas/AppIcons"
3176
+ type: array
3177
+ id:
3178
+ description: The ID of the app.
3179
+ type: string
3180
+ installed:
3181
+ description: Whether the app is installed.
3182
+ type: boolean
3183
+ kind:
3184
+ default: drive#app
3185
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string "drive#app".'
3186
+ type: string
3187
+ longDescription:
3188
+ description: A long description of the app.
3189
+ type: string
3190
+ name:
3191
+ description: The name of the app.
3192
+ type: string
3193
+ objectType:
3194
+ description: The type of object this app creates such as a Chart. If empty, the app name should be used instead.
3195
+ type: string
3196
+ openUrlTemplate:
3197
+ description: The template URL for opening files with this app. The template contains {ids} or {exportIds} to be replaced by the actual file IDs. For more information, see Open Files for the full documentation.
3198
+ type: string
3199
+ primaryFileExtensions:
3200
+ description: The list of primary file extensions.
3201
+ items:
3202
+ type: string
3203
+ type: array
3204
+ primaryMimeTypes:
3205
+ description: The list of primary MIME types.
3206
+ items:
3207
+ type: string
3208
+ type: array
3209
+ productId:
3210
+ description: The ID of the product listing for this app.
3211
+ type: string
3212
+ productUrl:
3213
+ description: A link to the product listing for this app.
3214
+ type: string
3215
+ secondaryFileExtensions:
3216
+ description: The list of secondary file extensions.
3217
+ items:
3218
+ type: string
3219
+ type: array
3220
+ secondaryMimeTypes:
3221
+ description: The list of secondary MIME types.
3222
+ items:
3223
+ type: string
3224
+ type: array
3225
+ shortDescription:
3226
+ description: A short description of the app.
3227
+ type: string
3228
+ supportsCreate:
3229
+ description: Whether this app supports creating objects.
3230
+ type: boolean
3231
+ supportsImport:
3232
+ description: Whether this app supports importing from Google Docs.
3233
+ type: boolean
3234
+ supportsMultiOpen:
3235
+ description: Whether this app supports opening more than one file.
3236
+ type: boolean
3237
+ supportsOfflineCreate:
3238
+ description: Whether this app supports creating files when offline.
3239
+ type: boolean
3240
+ useByDefault:
3241
+ description: Whether the app is selected as the default handler for the types it supports.
3242
+ type: boolean
3243
+ type: object
3244
+ AppIcons:
3245
+ properties:
3246
+ category:
3247
+ description: "Category of the icon. Allowed values are: * `application` - The icon for the application. * `document` - The icon for a file associated with the app. * `documentShared` - The icon for a shared file associated with the app."
3248
+ type: string
3249
+ iconUrl:
3250
+ description: URL for the icon.
3251
+ type: string
3252
+ size:
3253
+ description: Size of the icon. Represented as the maximum of the width and height.
3254
+ format: int32
3255
+ type: integer
3256
+ type: object
3257
+ AppList:
3258
+ description: A list of third-party applications which the user has installed or given access to Google Drive.
3259
+ properties:
3260
+ defaultAppIds:
3261
+ description: The list of app IDs that the user has specified to use by default. The list is in reverse-priority order (lowest to highest).
3262
+ items:
3263
+ type: string
3264
+ type: array
3265
+ items:
3266
+ description: The list of apps.
3267
+ items:
3268
+ $ref: "#/components/schemas/App"
3269
+ type: array
3270
+ kind:
3271
+ default: drive#appList
3272
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string "drive#appList".'
3273
+ type: string
3274
+ selfLink:
3275
+ description: A link back to this list.
3276
+ type: string
3277
+ type: object
3278
+ Change:
3279
+ description: A change to a file or shared drive.
3280
+ properties:
3281
+ changeType:
3282
+ description: The type of the change. Possible values are `file` and `drive`.
3283
+ type: string
3284
+ drive:
3285
+ $ref: "#/components/schemas/Drive"
3286
+ description: The updated state of the shared drive. Present if the changeType is drive, the user is still a member of the shared drive, and the shared drive has not been deleted.
3287
+ driveId:
3288
+ description: The ID of the shared drive associated with this change.
3289
+ type: string
3290
+ file:
3291
+ $ref: "#/components/schemas/File"
3292
+ description: The updated state of the file. Present if the type is file and the file has not been removed from this list of changes.
3293
+ fileId:
3294
+ description: The ID of the file which has changed.
3295
+ type: string
3296
+ kind:
3297
+ default: drive#change
3298
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#change"`.'
3299
+ type: string
3300
+ removed:
3301
+ description: Whether the file or shared drive has been removed from this list of changes, for example by deletion or loss of access.
3302
+ type: boolean
3303
+ teamDrive:
3304
+ $ref: "#/components/schemas/TeamDrive"
3305
+ deprecated: true
3306
+ description: "Deprecated: Use `drive` instead."
3307
+ teamDriveId:
3308
+ deprecated: true
3309
+ description: "Deprecated: Use `driveId` instead."
3310
+ type: string
3311
+ time:
3312
+ description: The time of this change (RFC 3339 date-time).
3313
+ format: date-time
3314
+ type: string
3315
+ type:
3316
+ deprecated: true
3317
+ description: "Deprecated: Use `changeType` instead."
3318
+ type: string
3319
+ type: object
3320
+ ChangeList:
3321
+ description: A list of changes for a user.
3322
+ properties:
3323
+ changes:
3324
+ description: The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
3325
+ items:
3326
+ $ref: "#/components/schemas/Change"
3327
+ type: array
3328
+ kind:
3329
+ default: drive#changeList
3330
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#changeList"`.'
3331
+ type: string
3332
+ newStartPageToken:
3333
+ description: The starting page token for future changes. This will be present only if the end of the current changes list has been reached. The page token doesn't expire.
3334
+ type: string
3335
+ nextPageToken:
3336
+ description: The page token for the next page of changes. This will be absent if the end of the changes list has been reached. The page token doesn't expire.
3337
+ type: string
3338
+ type: object
3339
+ Channel:
3340
+ description: A notification channel used to watch for resource changes.
3341
+ properties:
3342
+ address:
3343
+ description: The address where notifications are delivered for this channel.
3344
+ type: string
3345
+ expiration:
3346
+ description: Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.
3347
+ format: int64
3348
+ type: string
3349
+ id:
3350
+ description: A UUID or similar unique string that identifies this channel.
3351
+ type: string
3352
+ kind:
3353
+ default: api#channel
3354
+ description: Identifies this as a notification channel used to watch for changes to a resource, which is `api#channel`.
3355
+ type: string
3356
+ params:
3357
+ additionalProperties:
3358
+ type: string
3359
+ description: Additional parameters controlling delivery channel behavior. Optional.
3360
+ type: object
3361
+ payload:
3362
+ description: A Boolean value to indicate whether payload is wanted. Optional.
3363
+ type: boolean
3364
+ resourceId:
3365
+ description: An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.
3366
+ type: string
3367
+ resourceUri:
3368
+ description: A version-specific identifier for the watched resource.
3369
+ type: string
3370
+ token:
3371
+ description: An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
3372
+ type: string
3373
+ type:
3374
+ description: The type of delivery mechanism used for this channel. Valid values are "web_hook" or "webhook".
3375
+ type: string
3376
+ type: object
3377
+ Comment:
3378
+ description: A comment on a file. Some resource methods (such as `comments.update`) require a `commentId`. Use the `comments.list` method to retrieve the ID for a comment in a file.
3379
+ properties:
3380
+ anchor:
3381
+ description: A region of the document represented as a JSON string. For details on defining anchor properties, refer to [Manage comments and replies](https://developers.google.com/drive/api/v3/manage-comments).
3382
+ type: string
3383
+ author:
3384
+ $ref: "#/components/schemas/User"
3385
+ description: Output only. The author of the comment. The author's email address and permission ID will not be populated.
3386
+ content:
3387
+ description: The plain text content of the comment. This field is used for setting the content, while `htmlContent` should be displayed.
3388
+ type: string
3389
+ createdTime:
3390
+ description: The time at which the comment was created (RFC 3339 date-time).
3391
+ format: date-time
3392
+ type: string
3393
+ deleted:
3394
+ description: Output only. Whether the comment has been deleted. A deleted comment has no content.
3395
+ type: boolean
3396
+ htmlContent:
3397
+ description: Output only. The content of the comment with HTML formatting.
3398
+ type: string
3399
+ id:
3400
+ description: Output only. The ID of the comment.
3401
+ type: string
3402
+ kind:
3403
+ default: drive#comment
3404
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#comment"`.'
3405
+ type: string
3406
+ modifiedTime:
3407
+ description: The last time the comment or any of its replies was modified (RFC 3339 date-time).
3408
+ format: date-time
3409
+ type: string
3410
+ quotedFileContent:
3411
+ description: The file content to which the comment refers, typically within the anchor region. For a text file, for example, this would be the text at the location of the comment.
3412
+ properties:
3413
+ mimeType:
3414
+ description: The MIME type of the quoted content.
3415
+ type: string
3416
+ value:
3417
+ description: The quoted content itself. This is interpreted as plain text if set through the API.
3418
+ type: string
3419
+ type: object
3420
+ replies:
3421
+ description: Output only. The full list of replies to the comment in chronological order.
3422
+ items:
3423
+ $ref: "#/components/schemas/Reply"
3424
+ type: array
3425
+ resolved:
3426
+ description: Output only. Whether the comment has been resolved by one of its replies.
3427
+ type: boolean
3428
+ type: object
3429
+ CommentList:
3430
+ description: A list of comments on a file.
3431
+ properties:
3432
+ comments:
3433
+ description: The list of comments. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
3434
+ items:
3435
+ $ref: "#/components/schemas/Comment"
3436
+ type: array
3437
+ kind:
3438
+ default: drive#commentList
3439
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#commentList"`.'
3440
+ type: string
3441
+ nextPageToken:
3442
+ 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
3443
+ type: string
3444
+ type: object
3445
+ ContentRestriction:
3446
+ description: A restriction for accessing the content of the file.
3447
+ properties:
3448
+ ownerRestricted:
3449
+ description: Whether the content restriction can only be modified or removed by a user who owns the file. For files in shared drives, any user with `organizer` capabilities can modify or remove this content restriction.
3450
+ type: boolean
3451
+ readOnly:
3452
+ description: Whether the content of the file is read-only. If a file is read-only, a new revision of the file may not be added, comments may not be added or modified, and the title of the file may not be modified.
3453
+ type: boolean
3454
+ reason:
3455
+ description: Reason for why the content of the file is restricted. This is only mutable on requests that also set `readOnly=true`.
3456
+ type: string
3457
+ restrictingUser:
3458
+ $ref: "#/components/schemas/User"
3459
+ description: Output only. The user who set the content restriction. Only populated if `readOnly` is true.
3460
+ restrictionTime:
3461
+ description: The time at which the content restriction was set (formatted RFC 3339 timestamp). Only populated if readOnly is true.
3462
+ format: date-time
3463
+ type: string
3464
+ systemRestricted:
3465
+ description: Output only. Whether the content restriction was applied by the system, for example due to an esignature. Users cannot modify or remove system restricted content restrictions.
3466
+ type: boolean
3467
+ type:
3468
+ description: Output only. The type of the content restriction. Currently the only possible value is `globalContentRestriction`.
3469
+ type: string
3470
+ type: object
3471
+ Drive:
3472
+ description: Representation of a shared drive. Some resource methods (such as `drives.update`) require a `driveId`. Use the `drives.list` method to retrieve the ID for a shared drive.
3473
+ properties:
3474
+ backgroundImageFile:
3475
+ description: An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on `drive.drives.update` requests that don't set `themeId`. When specified, all fields of the `backgroundImageFile` must be set.
3476
+ properties:
3477
+ id:
3478
+ description: The ID of an image file in Google Drive to use for the background image.
3479
+ type: string
3480
+ width:
3481
+ description: The width of the cropped image in the closed range of 0 to 1. This value represents the width of the cropped image divided by the width of the entire image. The height is computed by applying a width to height aspect ratio of 80 to 9. The resulting image must be at least 1280 pixels wide and 144 pixels high.
3482
+ format: float
3483
+ type: number
3484
+ xCoordinate:
3485
+ description: The X coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1. This value represents the horizontal distance from the left side of the entire image to the left side of the cropping area divided by the width of the entire image.
3486
+ format: float
3487
+ type: number
3488
+ yCoordinate:
3489
+ description: The Y coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1. This value represents the vertical distance from the top side of the entire image to the top side of the cropping area divided by the height of the entire image.
3490
+ format: float
3491
+ type: number
3492
+ type: object
3493
+ backgroundImageLink:
3494
+ description: Output only. A short-lived link to this shared drive's background image.
3495
+ type: string
3496
+ capabilities:
3497
+ description: Output only. Capabilities the current user has on this shared drive.
3498
+ properties:
3499
+ canAddChildren:
3500
+ description: Output only. Whether the current user can add children to folders in this shared drive.
3501
+ type: boolean
3502
+ canChangeCopyRequiresWriterPermissionRestriction:
3503
+ description: Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this shared drive.
3504
+ type: boolean
3505
+ canChangeDomainUsersOnlyRestriction:
3506
+ description: Output only. Whether the current user can change the `domainUsersOnly` restriction of this shared drive.
3507
+ type: boolean
3508
+ canChangeDriveBackground:
3509
+ description: Output only. Whether the current user can change the background of this shared drive.
3510
+ type: boolean
3511
+ canChangeDriveMembersOnlyRestriction:
3512
+ description: Output only. Whether the current user can change the `driveMembersOnly` restriction of this shared drive.
3513
+ type: boolean
3514
+ canChangeSharingFoldersRequiresOrganizerPermissionRestriction:
3515
+ description: Output only. Whether the current user can change the `sharingFoldersRequiresOrganizerPermission` restriction of this shared drive.
3516
+ type: boolean
3517
+ canComment:
3518
+ description: Output only. Whether the current user can comment on files in this shared drive.
3519
+ type: boolean
3520
+ canCopy:
3521
+ description: Output only. Whether the current user can copy files in this shared drive.
3522
+ type: boolean
3523
+ canDeleteChildren:
3524
+ description: Output only. Whether the current user can delete children from folders in this shared drive.
3525
+ type: boolean
3526
+ canDeleteDrive:
3527
+ description: Output only. Whether the current user can delete this shared drive. Attempting to delete the shared drive may still fail if there are untrashed items inside the shared drive.
3528
+ type: boolean
3529
+ canDownload:
3530
+ description: Output only. Whether the current user can download files in this shared drive.
3531
+ type: boolean
3532
+ canEdit:
3533
+ description: Output only. Whether the current user can edit files in this shared drive
3534
+ type: boolean
3535
+ canListChildren:
3536
+ description: Output only. Whether the current user can list the children of folders in this shared drive.
3537
+ type: boolean
3538
+ canManageMembers:
3539
+ description: Output only. Whether the current user can add members to this shared drive or remove them or change their role.
3540
+ type: boolean
3541
+ canReadRevisions:
3542
+ description: Output only. Whether the current user can read the revisions resource of files in this shared drive.
3543
+ type: boolean
3544
+ canRename:
3545
+ description: Output only. Whether the current user can rename files or folders in this shared drive.
3546
+ type: boolean
3547
+ canRenameDrive:
3548
+ description: Output only. Whether the current user can rename this shared drive.
3549
+ type: boolean
3550
+ canResetDriveRestrictions:
3551
+ description: Output only. Whether the current user can reset the shared drive restrictions to defaults.
3552
+ type: boolean
3553
+ canShare:
3554
+ description: Output only. Whether the current user can share files or folders in this shared drive.
3555
+ type: boolean
3556
+ canTrashChildren:
3557
+ description: Output only. Whether the current user can trash children from folders in this shared drive.
3558
+ type: boolean
3559
+ type: object
3560
+ colorRgb:
3561
+ description: The color of this shared drive as an RGB hex string. It can only be set on a `drive.drives.update` request that does not set `themeId`.
3562
+ type: string
3563
+ createdTime:
3564
+ description: The time at which the shared drive was created (RFC 3339 date-time).
3565
+ format: date-time
3566
+ type: string
3567
+ hidden:
3568
+ description: Whether the shared drive is hidden from default view.
3569
+ type: boolean
3570
+ id:
3571
+ description: Output only. The ID of this shared drive which is also the ID of the top level folder of this shared drive.
3572
+ type: string
3573
+ kind:
3574
+ default: drive#drive
3575
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#drive"`.'
3576
+ type: string
3577
+ name:
3578
+ description: The name of this shared drive.
3579
+ type: string
3580
+ orgUnitId:
3581
+ description: Output only. The organizational unit of this shared drive. This field is only populated on `drives.list` responses when the `useDomainAdminAccess` parameter is set to `true`.
3582
+ type: string
3583
+ restrictions:
3584
+ description: A set of restrictions that apply to this shared drive or items inside this shared drive. Note that restrictions can't be set when creating a shared drive. To add a restriction, first create a shared drive and then use `drives.update` to add restrictions.
3585
+ properties:
3586
+ adminManagedRestrictions:
3587
+ description: Whether administrative privileges on this shared drive are required to modify restrictions.
3588
+ type: boolean
3589
+ copyRequiresWriterPermission:
3590
+ description: Whether the options to copy, print, or download files inside this shared drive, should be disabled for readers and commenters. When this restriction is set to `true`, it will override the similarly named field to `true` for any file inside this shared drive.
3591
+ type: boolean
3592
+ domainUsersOnly:
3593
+ description: Whether access to this shared drive and items inside this shared drive is restricted to users of the domain to which this shared drive belongs. This restriction may be overridden by other sharing policies controlled outside of this shared drive.
3594
+ type: boolean
3595
+ driveMembersOnly:
3596
+ description: Whether access to items inside this shared drive is restricted to its members.
3597
+ type: boolean
3598
+ sharingFoldersRequiresOrganizerPermission:
3599
+ description: If true, only users with the organizer role can share folders. If false, users with either the organizer role or the file organizer role can share folders.
3600
+ type: boolean
3601
+ type: object
3602
+ themeId:
3603
+ description: The ID of the theme from which the background image and color will be set. The set of possible `driveThemes` can be retrieved from a `drive.about.get` response. When not specified on a `drive.drives.create` request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set `colorRgb` or `backgroundImageFile`.
3604
+ type: string
3605
+ type: object
3606
+ DriveList:
3607
+ description: A list of shared drives.
3608
+ properties:
3609
+ drives:
3610
+ description: The list of shared drives. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
3611
+ items:
3612
+ $ref: "#/components/schemas/Drive"
3613
+ type: array
3614
+ kind:
3615
+ default: drive#driveList
3616
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#driveList"`.'
3617
+ type: string
3618
+ nextPageToken:
3619
+ description: The page token for the next page of shared drives. This will be absent if the end of the 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
3620
+ type: string
3621
+ type: object
3622
+ File:
3623
+ description: The metadata for a file. Some resource methods (such as `files.update`) require a `fileId`. Use the `files.list` method to retrieve the ID for a file.
3624
+ properties:
3625
+ appProperties:
3626
+ additionalProperties:
3627
+ type: string
3628
+ description: |-
3629
+ A collection of arbitrary key-value pairs which are private to the requesting app.
3630
+ Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties.
3631
+ type: object
3632
+ capabilities:
3633
+ description: Output only. Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.
3634
+ properties:
3635
+ canAcceptOwnership:
3636
+ description: Output only. Whether the current user is the pending owner of the file. Not populated for shared drive files.
3637
+ type: boolean
3638
+ canAddChildren:
3639
+ description: Output only. Whether the current user can add children to this folder. This is always false when the item is not a folder.
3640
+ type: boolean
3641
+ canAddFolderFromAnotherDrive:
3642
+ description: Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
3643
+ type: boolean
3644
+ canAddMyDriveParent:
3645
+ description: Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
3646
+ type: boolean
3647
+ canChangeCopyRequiresWriterPermission:
3648
+ description: Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
3649
+ type: boolean
3650
+ canChangeSecurityUpdateEnabled:
3651
+ description: Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
3652
+ type: boolean
3653
+ canChangeViewersCanCopyContent:
3654
+ deprecated: true
3655
+ description: "Deprecated: Output only."
3656
+ type: boolean
3657
+ canComment:
3658
+ description: Output only. Whether the current user can comment on this file.
3659
+ type: boolean
3660
+ canCopy:
3661
+ description: Output only. Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder.
3662
+ type: boolean
3663
+ canDelete:
3664
+ description: Output only. Whether the current user can delete this file.
3665
+ type: boolean
3666
+ canDeleteChildren:
3667
+ description: Output only. Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.
3668
+ type: boolean
3669
+ canDownload:
3670
+ description: Output only. Whether the current user can download this file.
3671
+ type: boolean
3672
+ canEdit:
3673
+ description: Output only. Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see `canChangeCopyRequiresWriterPermission` or `canModifyContent`.
3674
+ type: boolean
3675
+ canListChildren:
3676
+ description: Output only. Whether the current user can list the children of this folder. This is always false when the item is not a folder.
3677
+ type: boolean
3678
+ canModifyContent:
3679
+ description: Output only. Whether the current user can modify the content of this file.
3680
+ type: boolean
3681
+ canModifyContentRestriction:
3682
+ deprecated: true
3683
+ description: "Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`."
3684
+ type: boolean
3685
+ canModifyEditorContentRestriction:
3686
+ description: Output only. Whether the current user can add or modify content restrictions on the file which are editor restricted.
3687
+ type: boolean
3688
+ canModifyLabels:
3689
+ description: Output only. Whether the current user can modify the labels on the file.
3690
+ type: boolean
3691
+ canModifyOwnerContentRestriction:
3692
+ description: Output only. Whether the current user can add or modify content restrictions which are owner restricted.
3693
+ type: boolean
3694
+ canMoveChildrenOutOfDrive:
3695
+ description: Output only. Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives.
3696
+ type: boolean
3697
+ canMoveChildrenOutOfTeamDrive:
3698
+ deprecated: true
3699
+ description: "Deprecated: Output only. Use `canMoveChildrenOutOfDrive` instead."
3700
+ type: boolean
3701
+ canMoveChildrenWithinDrive:
3702
+ description: Output only. Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder.
3703
+ type: boolean
3704
+ canMoveChildrenWithinTeamDrive:
3705
+ deprecated: true
3706
+ description: "Deprecated: Output only. Use `canMoveChildrenWithinDrive` instead."
3707
+ type: boolean
3708
+ canMoveItemIntoTeamDrive:
3709
+ deprecated: true
3710
+ description: "Deprecated: Output only. Use `canMoveItemOutOfDrive` instead."
3711
+ type: boolean
3712
+ canMoveItemOutOfDrive:
3713
+ description: Output only. Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added.
3714
+ type: boolean
3715
+ canMoveItemOutOfTeamDrive:
3716
+ deprecated: true
3717
+ description: "Deprecated: Output only. Use `canMoveItemOutOfDrive` instead."
3718
+ type: boolean
3719
+ canMoveItemWithinDrive:
3720
+ description: Output only. Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed.
3721
+ type: boolean
3722
+ canMoveItemWithinTeamDrive:
3723
+ deprecated: true
3724
+ description: "Deprecated: Output only. Use `canMoveItemWithinDrive` instead."
3725
+ type: boolean
3726
+ canMoveTeamDriveItem:
3727
+ deprecated: true
3728
+ description: "Deprecated: Output only. Use `canMoveItemWithinDrive` or `canMoveItemOutOfDrive` instead."
3729
+ type: boolean
3730
+ canReadDrive:
3731
+ description: Output only. Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives.
3732
+ type: boolean
3733
+ canReadLabels:
3734
+ description: Output only. Whether the current user can read the labels on the file.
3735
+ type: boolean
3736
+ canReadRevisions:
3737
+ description: Output only. Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it is not a folder, can be read.
3738
+ type: boolean
3739
+ canReadTeamDrive:
3740
+ deprecated: true
3741
+ description: "Deprecated: Output only. Use `canReadDrive` instead."
3742
+ type: boolean
3743
+ canRemoveChildren:
3744
+ description: Output only. Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use `canDeleteChildren` or `canTrashChildren` instead.
3745
+ type: boolean
3746
+ canRemoveContentRestriction:
3747
+ description: Output only. Whether there is a content restriction on the file that can be removed by the current user.
3748
+ type: boolean
3749
+ canRemoveMyDriveParent:
3750
+ description: Output only. Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files.
3751
+ type: boolean
3752
+ canRename:
3753
+ description: Output only. Whether the current user can rename this file.
3754
+ type: boolean
3755
+ canShare:
3756
+ description: Output only. Whether the current user can modify the sharing settings for this file.
3757
+ type: boolean
3758
+ canTrash:
3759
+ description: Output only. Whether the current user can move this file to trash.
3760
+ type: boolean
3761
+ canTrashChildren:
3762
+ description: Output only. Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.
3763
+ type: boolean
3764
+ canUntrash:
3765
+ description: Output only. Whether the current user can restore this file from trash.
3766
+ type: boolean
3767
+ type: object
3768
+ contentHints:
3769
+ description: Additional information about the content of the file. These fields are never populated in responses.
3770
+ properties:
3771
+ indexableText:
3772
+ description: Text to be indexed for the file to improve fullText queries. This is limited to 128KB in length and may contain HTML elements.
3773
+ type: string
3774
+ thumbnail:
3775
+ description: A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail.
3776
+ properties:
3777
+ image:
3778
+ description: The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5).
3779
+ format: byte
3780
+ type: string
3781
+ mimeType:
3782
+ description: The MIME type of the thumbnail.
3783
+ type: string
3784
+ type: object
3785
+ type: object
3786
+ contentRestrictions:
3787
+ description: Restrictions for accessing the content of the file. Only populated if such a restriction exists.
3788
+ items:
3789
+ $ref: "#/components/schemas/ContentRestriction"
3790
+ type: array
3791
+ copyRequiresWriterPermission:
3792
+ description: Whether the options to copy, print, or download this file, should be disabled for readers and commenters.
3793
+ type: boolean
3794
+ createdTime:
3795
+ description: The time at which the file was created (RFC 3339 date-time).
3796
+ format: date-time
3797
+ type: string
3798
+ description:
3799
+ description: A short description of the file.
3800
+ type: string
3801
+ driveId:
3802
+ description: Output only. ID of the shared drive the file resides in. Only populated for items in shared drives.
3803
+ type: string
3804
+ explicitlyTrashed:
3805
+ description: Output only. Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.
3806
+ type: boolean
3807
+ exportLinks:
3808
+ additionalProperties:
3809
+ type: string
3810
+ description: Output only. Links for exporting Docs Editors files to specific formats.
3811
+ readOnly: true
3812
+ type: object
3813
+ fileExtension:
3814
+ description: Output only. The final component of `fullFileExtension`. This is only available for files with binary content in Google Drive.
3815
+ type: string
3816
+ folderColorRgb:
3817
+ description: The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the `folderColorPalette` field of the About resource. If an unsupported color is specified, the closest color in the palette is used instead.
3818
+ type: string
3819
+ fullFileExtension:
3820
+ description: Output only. 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 Google Drive. This is automatically updated when the `name` field changes, however it is not cleared if the new name does not contain a valid extension.
3821
+ type: string
3822
+ hasAugmentedPermissions:
3823
+ description: Output only. Whether there are permissions directly on this file. This field is only populated for items in shared drives.
3824
+ type: boolean
3825
+ hasThumbnail:
3826
+ description: Output only. Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field.
3827
+ type: boolean
3828
+ headRevisionId:
3829
+ description: Output only. The ID of the file's head revision. This is currently only available for files with binary content in Google Drive.
3830
+ type: string
3831
+ iconLink:
3832
+ description: Output only. A static, unauthenticated link to the file's icon.
3833
+ type: string
3834
+ id:
3835
+ description: The ID of the file.
3836
+ type: string
3837
+ imageMediaMetadata:
3838
+ description: Output only. Additional metadata about image media, if available.
3839
+ properties:
3840
+ aperture:
3841
+ description: Output only. The aperture used to create the photo (f-number).
3842
+ format: float
3843
+ type: number
3844
+ cameraMake:
3845
+ description: Output only. The make of the camera used to create the photo.
3846
+ type: string
3847
+ cameraModel:
3848
+ description: Output only. The model of the camera used to create the photo.
3849
+ type: string
3850
+ colorSpace:
3851
+ description: Output only. The color space of the photo.
3852
+ type: string
3853
+ exposureBias:
3854
+ description: Output only. The exposure bias of the photo (APEX value).
3855
+ format: float
3856
+ type: number
3857
+ exposureMode:
3858
+ description: Output only. The exposure mode used to create the photo.
3859
+ type: string
3860
+ exposureTime:
3861
+ description: Output only. The length of the exposure, in seconds.
3862
+ format: float
3863
+ type: number
3864
+ flashUsed:
3865
+ description: Output only. Whether a flash was used to create the photo.
3866
+ type: boolean
3867
+ focalLength:
3868
+ description: Output only. The focal length used to create the photo, in millimeters.
3869
+ format: float
3870
+ type: number
3871
+ height:
3872
+ description: Output only. The height of the image in pixels.
3873
+ format: int32
3874
+ type: integer
3875
+ isoSpeed:
3876
+ description: Output only. The ISO speed used to create the photo.
3877
+ format: int32
3878
+ type: integer
3879
+ lens:
3880
+ description: Output only. The lens used to create the photo.
3881
+ type: string
3882
+ location:
3883
+ description: Output only. Geographic location information stored in the image.
3884
+ properties:
3885
+ altitude:
3886
+ description: Output only. The altitude stored in the image.
3887
+ format: double
3888
+ type: number
3889
+ latitude:
3890
+ description: Output only. The latitude stored in the image.
3891
+ format: double
3892
+ type: number
3893
+ longitude:
3894
+ description: Output only. The longitude stored in the image.
3895
+ format: double
3896
+ type: number
3897
+ type: object
3898
+ maxApertureValue:
3899
+ description: Output only. The smallest f-number of the lens at the focal length used to create the photo (APEX value).
3900
+ format: float
3901
+ type: number
3902
+ meteringMode:
3903
+ description: Output only. The metering mode used to create the photo.
3904
+ type: string
3905
+ rotation:
3906
+ description: Output only. The number of clockwise 90 degree rotations applied from the image's original orientation.
3907
+ format: int32
3908
+ type: integer
3909
+ sensor:
3910
+ description: Output only. The type of sensor used to create the photo.
3911
+ type: string
3912
+ subjectDistance:
3913
+ description: Output only. The distance to the subject of the photo, in meters.
3914
+ format: int32
3915
+ type: integer
3916
+ time:
3917
+ description: Output only. The date and time the photo was taken (EXIF DateTime).
3918
+ type: string
3919
+ whiteBalance:
3920
+ description: Output only. The white balance mode used to create the photo.
3921
+ type: string
3922
+ width:
3923
+ description: Output only. The width of the image in pixels.
3924
+ format: int32
3925
+ type: integer
3926
+ type: object
3927
+ isAppAuthorized:
3928
+ description: Output only. Whether the file was created or opened by the requesting app.
3929
+ type: boolean
3930
+ kind:
3931
+ default: drive#file
3932
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#file"`.'
3933
+ type: string
3934
+ labelInfo:
3935
+ description: Output only. An overview of the labels on the file.
3936
+ properties:
3937
+ labels:
3938
+ description: Output only. The set of labels on the file as requested by the label IDs in the `includeLabels` parameter. By default, no labels are returned.
3939
+ items:
3940
+ $ref: "#/components/schemas/Label"
3941
+ type: array
3942
+ type: object
3943
+ lastModifyingUser:
3944
+ $ref: "#/components/schemas/User"
3945
+ description: Output only. The last user to modify the file.
3946
+ linkShareMetadata:
3947
+ description: Contains details about the link URLs that clients are using to refer to this item.
3948
+ properties:
3949
+ securityUpdateEligible:
3950
+ description: Output only. Whether the file is eligible for security update.
3951
+ type: boolean
3952
+ securityUpdateEnabled:
3953
+ description: Output only. Whether the security update is enabled for this file.
3954
+ type: boolean
3955
+ type: object
3956
+ md5Checksum:
3957
+ description: Output only. The MD5 checksum for the content of the file. This is only applicable to files with binary content in Google Drive.
3958
+ type: string
3959
+ mimeType:
3960
+ description: The MIME type of the file. Google Drive attempts 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. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the About resource.
3961
+ type: string
3962
+ modifiedByMe:
3963
+ description: Output only. Whether the file has been modified by this user.
3964
+ type: boolean
3965
+ modifiedByMeTime:
3966
+ description: The last time the file was modified by the user (RFC 3339 date-time).
3967
+ format: date-time
3968
+ type: string
3969
+ modifiedTime:
3970
+ description: he last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime will also update modifiedByMeTime for the user.
3971
+ format: date-time
3972
+ type: string
3973
+ name:
3974
+ description: The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant.
3975
+ type: string
3976
+ originalFilename:
3977
+ description: The original filename of the uploaded content if available, or else the original value of the `name` field. This is only available for files with binary content in Google Drive.
3978
+ type: string
3979
+ ownedByMe:
3980
+ description: Output only. Whether the user owns the file. Not populated for items in shared drives.
3981
+ type: boolean
3982
+ owners:
3983
+ description: Output only. The owner of this file. Only certain legacy files may have more than one owner. This field isn't populated for items in shared drives.
3984
+ items:
3985
+ $ref: "#/components/schemas/User"
3986
+ type: array
3987
+ parents:
3988
+ description: The IDs of the parent folders which contain the file. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parents of the source file. Update requests must use the `addParents` and `removeParents` parameters to modify the parents list.
3989
+ items:
3990
+ type: string
3991
+ type: array
3992
+ permissionIds:
3993
+ description: Output only. List of permission IDs for users with access to this file.
3994
+ items:
3995
+ type: string
3996
+ type: array
3997
+ permissions:
3998
+ description: Output only. The full list of permissions for the file. This is only available if the requesting user can share the file. Not populated for items in shared drives.
3999
+ items:
4000
+ $ref: "#/components/schemas/Permission"
4001
+ type: array
4002
+ properties:
4003
+ additionalProperties:
4004
+ type: string
4005
+ description: |-
4006
+ A collection of arbitrary key-value pairs which are visible to all apps.
4007
+ Entries with null values are cleared in update and copy requests.
4008
+ type: object
4009
+ quotaBytesUsed:
4010
+ description: Output only. The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with `keepForever` enabled.
4011
+ format: int64
4012
+ type: string
4013
+ resourceKey:
4014
+ description: Output only. A key needed to access the item via a shared link.
4015
+ type: string
4016
+ sha1Checksum:
4017
+ description: Output only. The SHA1 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it is not populated for Docs Editors or shortcut files.
4018
+ type: string
4019
+ sha256Checksum:
4020
+ description: Output only. The SHA256 checksum associated with this file, if available. This field is only populated for files with content stored in Google Drive; it is not populated for Docs Editors or shortcut files.
4021
+ type: string
4022
+ shared:
4023
+ description: Output only. Whether the file has been shared. Not populated for items in shared drives.
4024
+ type: boolean
4025
+ sharedWithMeTime:
4026
+ description: The time at which the file was shared with the user, if applicable (RFC 3339 date-time).
4027
+ format: date-time
4028
+ type: string
4029
+ sharingUser:
4030
+ $ref: "#/components/schemas/User"
4031
+ description: Output only. The user who shared the file with the requesting user, if applicable.
4032
+ shortcutDetails:
4033
+ description: Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`.
4034
+ properties:
4035
+ targetId:
4036
+ description: The ID of the file that this shortcut points to.
4037
+ type: string
4038
+ targetMimeType:
4039
+ description: Output only. The MIME type of the file that this shortcut points to. The value of this field is a snapshot of the target's MIME type, captured when the shortcut is created.
4040
+ type: string
4041
+ targetResourceKey:
4042
+ description: Output only. The ResourceKey for the target file.
4043
+ type: string
4044
+ type: object
4045
+ size:
4046
+ description: Output only. Size in bytes of blobs and first party editor files. Won't be populated for files that have no size, like shortcuts and folders.
4047
+ format: int64
4048
+ type: string
4049
+ spaces:
4050
+ description: Output only. The list of spaces which contain the file. The currently supported values are 'drive', 'appDataFolder' and 'photos'.
4051
+ items:
4052
+ type: string
4053
+ type: array
4054
+ starred:
4055
+ description: Whether the user has starred the file.
4056
+ type: boolean
4057
+ teamDriveId:
4058
+ deprecated: true
4059
+ description: "Deprecated: Output only. Use `driveId` instead."
4060
+ type: string
4061
+ thumbnailLink:
4062
+ description: Output only. 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. If the file isn't shared publicly, the URL returned in `Files.thumbnailLink` must be fetched using a credentialed request.
4063
+ type: string
4064
+ thumbnailVersion:
4065
+ description: Output only. The thumbnail version for use in thumbnail cache invalidation.
4066
+ format: int64
4067
+ type: string
4068
+ trashed:
4069
+ description: Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, and other users cannot see files in the owner's trash.
4070
+ type: boolean
4071
+ trashedTime:
4072
+ description: The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives.
4073
+ format: date-time
4074
+ type: string
4075
+ trashingUser:
4076
+ $ref: "#/components/schemas/User"
4077
+ description: Output only. If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives.
4078
+ version:
4079
+ description: Output only. A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user.
4080
+ format: int64
4081
+ type: string
4082
+ videoMediaMetadata:
4083
+ description: Output only. Additional metadata about video media. This may not be available immediately upon upload.
4084
+ properties:
4085
+ durationMillis:
4086
+ description: Output only. The duration of the video in milliseconds.
4087
+ format: int64
4088
+ type: string
4089
+ height:
4090
+ description: Output only. The height of the video in pixels.
4091
+ format: int32
4092
+ type: integer
4093
+ width:
4094
+ description: Output only. The width of the video in pixels.
4095
+ format: int32
4096
+ type: integer
4097
+ type: object
4098
+ viewedByMe:
4099
+ description: Output only. Whether the file has been viewed by this user.
4100
+ type: boolean
4101
+ viewedByMeTime:
4102
+ description: The last time the file was viewed by the user (RFC 3339 date-time).
4103
+ format: date-time
4104
+ type: string
4105
+ viewersCanCopyContent:
4106
+ deprecated: true
4107
+ description: "Deprecated: Use `copyRequiresWriterPermission` instead."
4108
+ type: boolean
4109
+ webContentLink:
4110
+ description: Output only. A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive.
4111
+ type: string
4112
+ webViewLink:
4113
+ description: Output only. A link for opening the file in a relevant Google editor or viewer in a browser.
4114
+ type: string
4115
+ writersCanShare:
4116
+ description: Whether users with only `writer` permission can modify the file's permissions. Not populated for items in shared drives.
4117
+ type: boolean
4118
+ type: object
4119
+ FileList:
4120
+ description: A list of files.
4121
+ properties:
4122
+ files:
4123
+ description: The list of files. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
4124
+ items:
4125
+ $ref: "#/components/schemas/File"
4126
+ type: array
4127
+ incompleteSearch:
4128
+ description: Whether the search process was incomplete. If true, then some search results might be missing, since all documents were not searched. This can occur when searching multiple drives with the 'allDrives' corpora, but all corpora couldn't be searched. When this happens, it's suggested that clients narrow their query by choosing a different corpus such as 'user' or 'drive'.
4129
+ type: boolean
4130
+ kind:
4131
+ default: drive#fileList
4132
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#fileList"`.'
4133
+ type: string
4134
+ nextPageToken:
4135
+ 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
4136
+ type: string
4137
+ type: object
4138
+ GeneratedIds:
4139
+ description: A list of generated file IDs which can be provided in create requests.
4140
+ properties:
4141
+ ids:
4142
+ description: The IDs generated for the requesting user in the specified space.
4143
+ items:
4144
+ type: string
4145
+ type: array
4146
+ kind:
4147
+ default: drive#generatedIds
4148
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#generatedIds"`.'
4149
+ type: string
4150
+ space:
4151
+ description: The type of file that can be created with these IDs.
4152
+ type: string
4153
+ type: object
4154
+ Label:
4155
+ description: Representation of label and label fields.
4156
+ properties:
4157
+ fields:
4158
+ additionalProperties:
4159
+ $ref: "#/components/schemas/LabelField"
4160
+ description: A map of the fields on the label, keyed by the field's ID.
4161
+ type: object
4162
+ id:
4163
+ description: The ID of the label.
4164
+ type: string
4165
+ kind:
4166
+ description: This is always drive#label
4167
+ type: string
4168
+ revisionId:
4169
+ description: The revision ID of the label.
4170
+ type: string
4171
+ type: object
4172
+ LabelField:
4173
+ description: Representation of field, which is a typed key-value pair.
4174
+ properties:
4175
+ dateString:
4176
+ description: "Only present if valueType is dateString. RFC 3339 formatted date: YYYY-MM-DD."
4177
+ items:
4178
+ format: date
4179
+ type: string
4180
+ type: array
4181
+ id:
4182
+ description: The identifier of this label field.
4183
+ type: string
4184
+ integer:
4185
+ description: Only present if `valueType` is `integer`.
4186
+ items:
4187
+ format: int64
4188
+ type: string
4189
+ type: array
4190
+ kind:
4191
+ description: This is always drive#labelField.
4192
+ type: string
4193
+ selection:
4194
+ description: Only present if `valueType` is `selection`
4195
+ items:
4196
+ type: string
4197
+ type: array
4198
+ text:
4199
+ description: Only present if `valueType` is `text`.
4200
+ items:
4201
+ type: string
4202
+ type: array
4203
+ user:
4204
+ description: Only present if `valueType` is `user`.
4205
+ items:
4206
+ $ref: "#/components/schemas/User"
4207
+ type: array
4208
+ valueType:
4209
+ description: "The field type. While new values may be supported in the future, the following are currently allowed: * `dateString` * `integer` * `selection` * `text` * `user`"
4210
+ type: string
4211
+ type: object
4212
+ LabelFieldModification:
4213
+ description: A modification to a label's field.
4214
+ properties:
4215
+ fieldId:
4216
+ description: The ID of the field to be modified.
4217
+ type: string
4218
+ kind:
4219
+ description: This is always drive#labelFieldModification.
4220
+ type: string
4221
+ setDateValues:
4222
+ description: "Replaces the value of a dateString Field with these new values. The string must be in the RFC 3339 full-date format: YYYY-MM-DD."
4223
+ items:
4224
+ format: date
4225
+ type: string
4226
+ type: array
4227
+ setIntegerValues:
4228
+ description: Replaces the value of an `integer` field with these new values.
4229
+ items:
4230
+ format: int64
4231
+ type: string
4232
+ type: array
4233
+ setSelectionValues:
4234
+ description: Replaces a `selection` field with these new values.
4235
+ items:
4236
+ type: string
4237
+ type: array
4238
+ setTextValues:
4239
+ description: Sets the value of a `text` field.
4240
+ items:
4241
+ type: string
4242
+ type: array
4243
+ setUserValues:
4244
+ description: Replaces a `user` field with these new values. The values must be valid email addresses.
4245
+ items:
4246
+ type: string
4247
+ type: array
4248
+ unsetValues:
4249
+ description: Unsets the values for this field.
4250
+ type: boolean
4251
+ type: object
4252
+ LabelList:
4253
+ description: A list of labels applied to a file.
4254
+ properties:
4255
+ kind:
4256
+ description: This is always drive#labelList
4257
+ type: string
4258
+ labels:
4259
+ description: The list of labels.
4260
+ items:
4261
+ $ref: "#/components/schemas/Label"
4262
+ type: array
4263
+ nextPageToken:
4264
+ description: The page token for the next page of labels. This field will be absent if the end of the 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
4265
+ type: string
4266
+ type: object
4267
+ LabelModification:
4268
+ description: A modification to a label on a file. A LabelModification can be used to apply a label to a file, update an existing label on a file, or remove a label from a file.
4269
+ properties:
4270
+ fieldModifications:
4271
+ description: The list of modifications to this label's fields.
4272
+ items:
4273
+ $ref: "#/components/schemas/LabelFieldModification"
4274
+ type: array
4275
+ kind:
4276
+ description: This is always drive#labelModification.
4277
+ type: string
4278
+ labelId:
4279
+ description: The ID of the label to modify.
4280
+ type: string
4281
+ removeLabel:
4282
+ description: If true, the label will be removed from the file.
4283
+ type: boolean
4284
+ type: object
4285
+ ModifyLabelsRequest:
4286
+ description: A request to modify the set of labels on a file. This request may contain many modifications that will either all succeed or all fail atomically.
4287
+ properties:
4288
+ kind:
4289
+ description: This is always drive#modifyLabelsRequest.
4290
+ type: string
4291
+ labelModifications:
4292
+ description: The list of modifications to apply to the labels on the file.
4293
+ items:
4294
+ $ref: "#/components/schemas/LabelModification"
4295
+ type: array
4296
+ type: object
4297
+ ModifyLabelsResponse:
4298
+ description: Response to a ModifyLabels request. This contains only those labels which were added or updated by the request.
4299
+ properties:
4300
+ kind:
4301
+ description: This is always drive#modifyLabelsResponse
4302
+ type: string
4303
+ modifiedLabels:
4304
+ description: The list of labels which were added or updated by the request.
4305
+ items:
4306
+ $ref: "#/components/schemas/Label"
4307
+ type: array
4308
+ type: object
4309
+ Permission:
4310
+ description: A permission for a file. A permission grants a user, group, domain, or the world access to a file or a folder hierarchy. Some resource methods (such as `permissions.update`) require a `permissionId`. Use the `permissions.list` method to retrieve the ID for a file, folder, or shared drive.
4311
+ properties:
4312
+ allowFileDiscovery:
4313
+ description: Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type `domain` or `anyone`.
4314
+ type: boolean
4315
+ deleted:
4316
+ description: Output only. Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.
4317
+ type: boolean
4318
+ displayName:
4319
+ description: "Output only. The \"pretty\" name of the value of the permission. The following is a list of examples for each type of permission: * `user` - User's full name, as defined for their Google account, such as \"Joe Smith.\" * `group` - Name of the Google Group, such as \"The Company Administrators.\" * `domain` - String domain name, such as \"thecompany.com.\" * `anyone` - No `displayName` is present."
4320
+ type: string
4321
+ domain:
4322
+ description: The domain to which this permission refers.
4323
+ type: string
4324
+ emailAddress:
4325
+ description: The email address of the user or group to which this permission refers.
4326
+ type: string
4327
+ expirationTime:
4328
+ description: "The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions: - They can only be set on user and group permissions - The time must be in the future - The time cannot be more than a year in the future"
4329
+ format: date-time
4330
+ type: string
4331
+ id:
4332
+ description: Output only. The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as `permissionId`. IDs should be treated as opaque values.
4333
+ type: string
4334
+ kind:
4335
+ default: drive#permission
4336
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#permission"`.'
4337
+ type: string
4338
+ pendingOwner:
4339
+ description: Whether the account associated with this permission is a pending owner. Only populated for `user` type permissions for files that are not in a shared drive.
4340
+ type: boolean
4341
+ permissionDetails:
4342
+ description: Output only. Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.
4343
+ items:
4344
+ properties:
4345
+ inherited:
4346
+ description: Output only. Whether this permission is inherited. This field is always populated. This is an output-only field.
4347
+ type: boolean
4348
+ inheritedFrom:
4349
+ description: Output only. The ID of the item from which this permission is inherited. This is an output-only field.
4350
+ type: string
4351
+ permissionType:
4352
+ description: "Output only. The permission type for this user. While new values may be added in future, the following are currently possible: * `file` * `member`"
4353
+ type: string
4354
+ role:
4355
+ description: "Output only. The primary role for this user. While new values may be added in the future, the following are currently possible: * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader`"
4356
+ type: string
4357
+ type: object
4358
+ readOnly: true
4359
+ type: array
4360
+ photoLink:
4361
+ description: Output only. A link to the user's profile photo, if available.
4362
+ type: string
4363
+ role:
4364
+ description: "The role granted by this permission. While new values may be supported in the future, the following are currently allowed: * `owner` * `organizer` * `fileOrganizer` * `writer` * `commenter` * `reader`"
4365
+ type: string
4366
+ teamDrivePermissionDetails:
4367
+ deprecated: true
4368
+ description: "Output only. Deprecated: Output only. Use `permissionDetails` instead."
4369
+ items:
4370
+ properties:
4371
+ inherited:
4372
+ deprecated: true
4373
+ description: "Deprecated: Output only. Use `permissionDetails/inherited` instead."
4374
+ type: boolean
4375
+ inheritedFrom:
4376
+ deprecated: true
4377
+ description: "Deprecated: Output only. Use `permissionDetails/inheritedFrom` instead."
4378
+ type: string
4379
+ role:
4380
+ deprecated: true
4381
+ description: "Deprecated: Output only. Use `permissionDetails/role` instead."
4382
+ type: string
4383
+ teamDrivePermissionType:
4384
+ deprecated: true
4385
+ description: "Deprecated: Output only. Use `permissionDetails/permissionType` instead."
4386
+ type: string
4387
+ type: object
4388
+ readOnly: true
4389
+ type: array
4390
+ type:
4391
+ description: "The type of the grantee. Valid values are: * `user` * `group` * `domain` * `anyone` When creating a permission, if `type` is `user` or `group`, you must provide an `emailAddress` for the user or group. When `type` is `domain`, you must provide a `domain`. There isn't extra information required for an `anyone` type."
4392
+ type: string
4393
+ view:
4394
+ description: Indicates the view for this permission. Only populated for permissions that belong to a view. 'published' is the only supported value.
4395
+ type: string
4396
+ type: object
4397
+ PermissionList:
4398
+ description: A list of permissions for a file.
4399
+ properties:
4400
+ kind:
4401
+ default: drive#permissionList
4402
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#permissionList"`.'
4403
+ type: string
4404
+ nextPageToken:
4405
+ description: The page token for the next page of permissions. This field will be absent if the end of the permissions 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
4406
+ type: string
4407
+ permissions:
4408
+ description: The list of permissions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
4409
+ items:
4410
+ $ref: "#/components/schemas/Permission"
4411
+ type: array
4412
+ type: object
4413
+ Reply:
4414
+ description: A reply to a comment on a file. Some resource methods (such as `replies.update`) require a `replyId`. Use the `replies.list` method to retrieve the ID for a reply.
4415
+ properties:
4416
+ action:
4417
+ description: "The action the reply performed to the parent comment. Valid values are: * `resolve` * `reopen`"
4418
+ type: string
4419
+ author:
4420
+ $ref: "#/components/schemas/User"
4421
+ description: Output only. The author of the reply. The author's email address and permission ID will not be populated.
4422
+ content:
4423
+ description: The plain text content of the reply. This field is used for setting the content, while `htmlContent` should be displayed. This is required on creates if no `action` is specified.
4424
+ type: string
4425
+ createdTime:
4426
+ description: The time at which the reply was created (RFC 3339 date-time).
4427
+ format: date-time
4428
+ type: string
4429
+ deleted:
4430
+ description: Output only. Whether the reply has been deleted. A deleted reply has no content.
4431
+ type: boolean
4432
+ htmlContent:
4433
+ description: Output only. The content of the reply with HTML formatting.
4434
+ type: string
4435
+ id:
4436
+ description: Output only. The ID of the reply.
4437
+ type: string
4438
+ kind:
4439
+ default: drive#reply
4440
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#reply"`.'
4441
+ type: string
4442
+ modifiedTime:
4443
+ description: The last time the reply was modified (RFC 3339 date-time).
4444
+ format: date-time
4445
+ type: string
4446
+ type: object
4447
+ ReplyList:
4448
+ description: A list of replies to a comment on a file.
4449
+ properties:
4450
+ kind:
4451
+ default: drive#replyList
4452
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#replyList"`.'
4453
+ type: string
4454
+ nextPageToken:
4455
+ 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
4456
+ type: string
4457
+ replies:
4458
+ description: The list of replies. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
4459
+ items:
4460
+ $ref: "#/components/schemas/Reply"
4461
+ type: array
4462
+ type: object
4463
+ Revision:
4464
+ description: The metadata for a revision to a file. Some resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.
4465
+ properties:
4466
+ exportLinks:
4467
+ additionalProperties:
4468
+ type: string
4469
+ description: Output only. Links for exporting Docs Editors files to specific formats.
4470
+ type: object
4471
+ id:
4472
+ description: Output only. The ID of the revision.
4473
+ type: string
4474
+ keepForever:
4475
+ description: Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive.
4476
+ type: boolean
4477
+ kind:
4478
+ default: drive#revision
4479
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#revision"`.'
4480
+ type: string
4481
+ lastModifyingUser:
4482
+ $ref: "#/components/schemas/User"
4483
+ description: Output only. The last user to modify this revision.
4484
+ md5Checksum:
4485
+ description: Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive.
4486
+ type: string
4487
+ mimeType:
4488
+ description: Output only. The MIME type of the revision.
4489
+ type: string
4490
+ modifiedTime:
4491
+ description: The last time the revision was modified (RFC 3339 date-time).
4492
+ format: date-time
4493
+ type: string
4494
+ originalFilename:
4495
+ description: Output only. The original filename used to create this revision. This is only applicable to files with binary content in Drive.
4496
+ type: string
4497
+ publishAuto:
4498
+ description: Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.
4499
+ type: boolean
4500
+ published:
4501
+ description: Whether this revision is published. This is only applicable to Docs Editors files.
4502
+ type: boolean
4503
+ publishedLink:
4504
+ description: Output only. A link to the published revision. This is only populated for Google Sites files.
4505
+ type: string
4506
+ publishedOutsideDomain:
4507
+ description: Whether this revision is published outside the domain. This is only applicable to Docs Editors files.
4508
+ type: boolean
4509
+ size:
4510
+ description: Output only. The size of the revision's content in bytes. This is only applicable to files with binary content in Drive.
4511
+ format: int64
4512
+ type: string
4513
+ type: object
4514
+ RevisionList:
4515
+ description: A list of revisions of a file.
4516
+ properties:
4517
+ kind:
4518
+ default: drive#revisionList
4519
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#revisionList"`.'
4520
+ type: string
4521
+ nextPageToken:
4522
+ 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
4523
+ type: string
4524
+ revisions:
4525
+ description: The list of revisions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
4526
+ items:
4527
+ $ref: "#/components/schemas/Revision"
4528
+ type: array
4529
+ type: object
4530
+ StartPageToken:
4531
+ properties:
4532
+ kind:
4533
+ default: drive#startPageToken
4534
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#startPageToken"`.'
4535
+ type: string
4536
+ startPageToken:
4537
+ description: The starting page token for listing future changes. The page token doesn't expire.
4538
+ type: string
4539
+ type: object
4540
+ TeamDrive:
4541
+ description: "Deprecated: use the drive collection instead."
4542
+ properties:
4543
+ backgroundImageFile:
4544
+ description: An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on `drive.teamdrives.update` requests that don't set `themeId`. When specified, all fields of the `backgroundImageFile` must be set.
4545
+ properties:
4546
+ id:
4547
+ description: The ID of an image file in Drive to use for the background image.
4548
+ type: string
4549
+ width:
4550
+ description: The width of the cropped image in the closed range of 0 to 1. This value represents the width of the cropped image divided by the width of the entire image. The height is computed by applying a width to height aspect ratio of 80 to 9. The resulting image must be at least 1280 pixels wide and 144 pixels high.
4551
+ format: float
4552
+ type: number
4553
+ xCoordinate:
4554
+ description: The X coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1. This value represents the horizontal distance from the left side of the entire image to the left side of the cropping area divided by the width of the entire image.
4555
+ format: float
4556
+ type: number
4557
+ yCoordinate:
4558
+ description: The Y coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1. This value represents the vertical distance from the top side of the entire image to the top side of the cropping area divided by the height of the entire image.
4559
+ format: float
4560
+ type: number
4561
+ type: object
4562
+ backgroundImageLink:
4563
+ description: A short-lived link to this Team Drive's background image.
4564
+ type: string
4565
+ capabilities:
4566
+ description: Capabilities the current user has on this Team Drive.
4567
+ properties:
4568
+ canAddChildren:
4569
+ description: Whether the current user can add children to folders in this Team Drive.
4570
+ type: boolean
4571
+ canChangeCopyRequiresWriterPermissionRestriction:
4572
+ description: Whether the current user can change the `copyRequiresWriterPermission` restriction of this Team Drive.
4573
+ type: boolean
4574
+ canChangeDomainUsersOnlyRestriction:
4575
+ description: Whether the current user can change the `domainUsersOnly` restriction of this Team Drive.
4576
+ type: boolean
4577
+ canChangeSharingFoldersRequiresOrganizerPermissionRestriction:
4578
+ description: Whether the current user can change the `sharingFoldersRequiresOrganizerPermission` restriction of this Team Drive.
4579
+ type: boolean
4580
+ canChangeTeamDriveBackground:
4581
+ description: Whether the current user can change the background of this Team Drive.
4582
+ type: boolean
4583
+ canChangeTeamMembersOnlyRestriction:
4584
+ description: Whether the current user can change the `teamMembersOnly` restriction of this Team Drive.
4585
+ type: boolean
4586
+ canComment:
4587
+ description: Whether the current user can comment on files in this Team Drive.
4588
+ type: boolean
4589
+ canCopy:
4590
+ description: Whether the current user can copy files in this Team Drive.
4591
+ type: boolean
4592
+ canDeleteChildren:
4593
+ description: Whether the current user can delete children from folders in this Team Drive.
4594
+ type: boolean
4595
+ canDeleteTeamDrive:
4596
+ description: Whether the current user can delete this Team Drive. Attempting to delete the Team Drive may still fail if there are untrashed items inside the Team Drive.
4597
+ type: boolean
4598
+ canDownload:
4599
+ description: Whether the current user can download files in this Team Drive.
4600
+ type: boolean
4601
+ canEdit:
4602
+ description: Whether the current user can edit files in this Team Drive
4603
+ type: boolean
4604
+ canListChildren:
4605
+ description: Whether the current user can list the children of folders in this Team Drive.
4606
+ type: boolean
4607
+ canManageMembers:
4608
+ description: Whether the current user can add members to this Team Drive or remove them or change their role.
4609
+ type: boolean
4610
+ canReadRevisions:
4611
+ description: Whether the current user can read the revisions resource of files in this Team Drive.
4612
+ type: boolean
4613
+ canRemoveChildren:
4614
+ deprecated: true
4615
+ description: "Deprecated: Use `canDeleteChildren` or `canTrashChildren` instead."
4616
+ type: boolean
4617
+ canRename:
4618
+ description: Whether the current user can rename files or folders in this Team Drive.
4619
+ type: boolean
4620
+ canRenameTeamDrive:
4621
+ description: Whether the current user can rename this Team Drive.
4622
+ type: boolean
4623
+ canResetTeamDriveRestrictions:
4624
+ description: Whether the current user can reset the Team Drive restrictions to defaults.
4625
+ type: boolean
4626
+ canShare:
4627
+ description: Whether the current user can share files or folders in this Team Drive.
4628
+ type: boolean
4629
+ canTrashChildren:
4630
+ description: Whether the current user can trash children from folders in this Team Drive.
4631
+ type: boolean
4632
+ type: object
4633
+ colorRgb:
4634
+ description: The color of this Team Drive as an RGB hex string. It can only be set on a `drive.teamdrives.update` request that does not set `themeId`.
4635
+ type: string
4636
+ createdTime:
4637
+ description: The time at which the Team Drive was created (RFC 3339 date-time).
4638
+ format: date-time
4639
+ type: string
4640
+ id:
4641
+ description: The ID of this Team Drive which is also the ID of the top level folder of this Team Drive.
4642
+ type: string
4643
+ kind:
4644
+ default: drive#teamDrive
4645
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#teamDrive"`.'
4646
+ type: string
4647
+ name:
4648
+ description: The name of this Team Drive.
4649
+ type: string
4650
+ orgUnitId:
4651
+ description: The organizational unit of this shared drive. This field is only populated on `drives.list` responses when the `useDomainAdminAccess` parameter is set to `true`.
4652
+ type: string
4653
+ restrictions:
4654
+ description: A set of restrictions that apply to this Team Drive or items inside this Team Drive.
4655
+ properties:
4656
+ adminManagedRestrictions:
4657
+ description: Whether administrative privileges on this Team Drive are required to modify restrictions.
4658
+ type: boolean
4659
+ copyRequiresWriterPermission:
4660
+ description: Whether the options to copy, print, or download files inside this Team Drive, should be disabled for readers and commenters. When this restriction is set to `true`, it will override the similarly named field to `true` for any file inside this Team Drive.
4661
+ type: boolean
4662
+ domainUsersOnly:
4663
+ description: Whether access to this Team Drive and items inside this Team Drive is restricted to users of the domain to which this Team Drive belongs. This restriction may be overridden by other sharing policies controlled outside of this Team Drive.
4664
+ type: boolean
4665
+ sharingFoldersRequiresOrganizerPermission:
4666
+ description: If true, only users with the organizer role can share folders. If false, users with either the organizer role or the file organizer role can share folders.
4667
+ type: boolean
4668
+ teamMembersOnly:
4669
+ description: Whether access to items inside this Team Drive is restricted to members of this Team Drive.
4670
+ type: boolean
4671
+ type: object
4672
+ themeId:
4673
+ description: The ID of the theme from which the background image and color will be set. The set of possible `teamDriveThemes` can be retrieved from a `drive.about.get` response. When not specified on a `drive.teamdrives.create` request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set `colorRgb` or `backgroundImageFile`.
4674
+ type: string
4675
+ type: object
4676
+ TeamDriveList:
4677
+ description: A list of Team Drives.
4678
+ properties:
4679
+ kind:
4680
+ default: drive#teamDriveList
4681
+ description: 'Identifies what kind of resource this is. Value: the fixed string `"drive#teamDriveList"`.'
4682
+ type: string
4683
+ nextPageToken:
4684
+ description: The page token for the next page of Team Drives. This will be absent if the end of the Team Drives 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. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.
4685
+ type: string
4686
+ teamDrives:
4687
+ description: The list of Team Drives. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
4688
+ items:
4689
+ $ref: "#/components/schemas/TeamDrive"
4690
+ type: array
4691
+ type: object
4692
+ User:
4693
+ description: Information about a Drive user.
4694
+ properties:
4695
+ displayName:
4696
+ description: Output only. A plain text displayable name for this user.
4697
+ type: string
4698
+ emailAddress:
4699
+ description: Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.
4700
+ type: string
4701
+ kind:
4702
+ default: drive#user
4703
+ description: 'Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#user"`.'
4704
+ type: string
4705
+ me:
4706
+ description: Output only. Whether this user is the requesting user.
4707
+ type: boolean
4708
+ permissionId:
4709
+ description: Output only. The user's ID as visible in Permission resources.
4710
+ type: string
4711
+ photoLink:
4712
+ description: Output only. A link to the user's profile photo, if available.
4713
+ type: string
4714
+ type: object
4715
+ securitySchemes:
4716
+ Oauth2:
4717
+ description: Oauth 2.0 implicit authentication
4718
+ flows:
4719
+ implicit:
4720
+ authorizationUrl: https://accounts.google.com/o/oauth2/auth
4721
+ scopes:
4722
+ https://www.googleapis.com/auth/drive: See, edit, create, and delete all of your Google Drive files
4723
+ https://www.googleapis.com/auth/drive.appdata: See, create, and delete its own configuration data in your Google Drive
4724
+ https://www.googleapis.com/auth/drive.apps.readonly: View your Google Drive apps
4725
+ https://www.googleapis.com/auth/drive.file: See, edit, create, and delete only the specific Google Drive files you use with this app
4726
+ https://www.googleapis.com/auth/drive.metadata: View and manage metadata of files in your Google Drive
4727
+ https://www.googleapis.com/auth/drive.metadata.readonly: See information about your Google Drive files
4728
+ https://www.googleapis.com/auth/drive.photos.readonly: View the photos, videos and albums in your Google Photos
4729
+ https://www.googleapis.com/auth/drive.readonly: See and download all your Google Drive files
4730
+ https://www.googleapis.com/auth/drive.scripts: Modify your Google Apps Script scripts' behavior
4731
+ type: oauth2
4732
+ Oauth2c:
4733
+ description: Oauth 2.0 authorizationCode authentication
4734
+ flows:
4735
+ authorizationCode:
4736
+ authorizationUrl: https://accounts.google.com/o/oauth2/auth
4737
+ scopes:
4738
+ https://www.googleapis.com/auth/drive: See, edit, create, and delete all of your Google Drive files
4739
+ https://www.googleapis.com/auth/drive.appdata: See, create, and delete its own configuration data in your Google Drive
4740
+ https://www.googleapis.com/auth/drive.apps.readonly: View your Google Drive apps
4741
+ https://www.googleapis.com/auth/drive.file: See, edit, create, and delete only the specific Google Drive files you use with this app
4742
+ https://www.googleapis.com/auth/drive.metadata: View and manage metadata of files in your Google Drive
4743
+ https://www.googleapis.com/auth/drive.metadata.readonly: See information about your Google Drive files
4744
+ https://www.googleapis.com/auth/drive.photos.readonly: View the photos, videos and albums in your Google Photos
4745
+ https://www.googleapis.com/auth/drive.readonly: See and download all your Google Drive files
4746
+ https://www.googleapis.com/auth/drive.scripts: Modify your Google Apps Script scripts' behavior
4747
+ tokenUrl: https://accounts.google.com/o/oauth2/token
4748
+ type: oauth2