google-apis-drive_v3 0.26.0 → 0.44.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -20,10 +20,9 @@ require 'google/apis/errors'
20
20
  module Google
21
21
  module Apis
22
22
  module DriveV3
23
- # Drive API
23
+ # Google Drive API
24
24
  #
25
- # Manages files in Drive including uploading, downloading, searching, detecting
26
- # changes, and updating sharing permissions.
25
+ # The Google Drive API allows clients to access resources from Google Drive.
27
26
  #
28
27
  # @example
29
28
  # require 'google/apis/drive_v3'
@@ -39,14 +38,10 @@ module Google
39
38
  attr_accessor :key
40
39
 
41
40
  # @return [String]
42
- # An opaque string that represents a user for quota purposes. Must not exceed 40
43
- # characters.
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
43
  attr_accessor :quota_user
45
44
 
46
- # @return [String]
47
- # Deprecated. Please use quotaUser instead.
48
- attr_accessor :user_ip
49
-
50
45
  def initialize
51
46
  super('https://www.googleapis.com/', 'drive/v3/',
52
47
  client_name: 'google-apis-drive_v3',
@@ -58,10 +53,8 @@ module Google
58
53
  # @param [String] fields
59
54
  # Selector specifying which fields to include in a partial response.
60
55
  # @param [String] quota_user
61
- # An opaque string that represents a user for quota purposes. Must not exceed 40
62
- # characters.
63
- # @param [String] user_ip
64
- # Deprecated. Please use quotaUser instead.
56
+ # Available to use for quota purposes for server-side applications. Can be any
57
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
65
58
  # @param [Google::Apis::RequestOptions] options
66
59
  # Request-specific options
67
60
  #
@@ -74,33 +67,30 @@ module Google
74
67
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
75
68
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
76
69
  # @raise [Google::Apis::AuthorizationError] Authorization is required
77
- def get_about(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
70
+ def get_about(fields: nil, quota_user: nil, options: nil, &block)
78
71
  command = make_simple_command(:get, 'about', options)
79
72
  command.response_representation = Google::Apis::DriveV3::About::Representation
80
73
  command.response_class = Google::Apis::DriveV3::About
81
74
  command.query['fields'] = fields unless fields.nil?
82
75
  command.query['quotaUser'] = quota_user unless quota_user.nil?
83
- command.query['userIp'] = user_ip unless user_ip.nil?
84
76
  execute_or_queue_command(command, &block)
85
77
  end
86
78
 
87
79
  # Gets the starting pageToken for listing future changes.
88
80
  # @param [String] drive_id
89
81
  # The ID of the shared drive for which the starting pageToken for listing future
90
- # changes from that shared drive is returned.
82
+ # changes from that shared drive will be returned.
91
83
  # @param [Boolean] supports_all_drives
92
84
  # Whether the requesting application supports both My Drives and shared drives.
93
85
  # @param [Boolean] supports_team_drives
94
- # Deprecated use supportsAllDrives instead.
86
+ # Deprecated: Use `supportsAllDrives` instead.
95
87
  # @param [String] team_drive_id
96
- # Deprecated use driveId instead.
88
+ # Deprecated: Use `driveId` instead.
97
89
  # @param [String] fields
98
90
  # Selector specifying which fields to include in a partial response.
99
91
  # @param [String] quota_user
100
- # An opaque string that represents a user for quota purposes. Must not exceed 40
101
- # characters.
102
- # @param [String] user_ip
103
- # Deprecated. Please use quotaUser instead.
92
+ # Available to use for quota purposes for server-side applications. Can be any
93
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
104
94
  # @param [Google::Apis::RequestOptions] options
105
95
  # Request-specific options
106
96
  #
@@ -113,7 +103,7 @@ module Google
113
103
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
114
104
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
115
105
  # @raise [Google::Apis::AuthorizationError] Authorization is required
116
- def get_changes_start_page_token(drive_id: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
106
+ def get_changes_start_page_token(drive_id: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, options: nil, &block)
117
107
  command = make_simple_command(:get, 'changes/startPageToken', options)
118
108
  command.response_representation = Google::Apis::DriveV3::StartPageToken::Representation
119
109
  command.response_class = Google::Apis::DriveV3::StartPageToken
@@ -123,7 +113,6 @@ module Google
123
113
  command.query['teamDriveId'] = team_drive_id unless team_drive_id.nil?
124
114
  command.query['fields'] = fields unless fields.nil?
125
115
  command.query['quotaUser'] = quota_user unless quota_user.nil?
126
- command.query['userIp'] = user_ip unless user_ip.nil?
127
116
  execute_or_queue_command(command, &block)
128
117
  end
129
118
 
@@ -133,9 +122,9 @@ module Google
133
122
  # be set to the value of 'nextPageToken' from the previous response or to the
134
123
  # response from the getStartPageToken method.
135
124
  # @param [String] drive_id
136
- # The shared drive from which changes are returned. If specified the change IDs
137
- # will be reflective of the shared drive; use the combined drive ID and change
138
- # ID as an identifier.
125
+ # The shared drive from which changes will be returned. If specified the change
126
+ # IDs will be reflective of the shared drive; use the combined drive ID and
127
+ # change ID as an identifier.
139
128
  # @param [Boolean] include_corpus_removals
140
129
  # Whether changes should include the file resource if the file is still
141
130
  # accessible by the user at the time of the request, even when a file was
@@ -144,7 +133,7 @@ module Google
144
133
  # @param [Boolean] include_items_from_all_drives
145
134
  # Whether both My Drive and shared drive items should be included in results.
146
135
  # @param [String] include_labels
147
- # A comma-separated list of IDs of labels to include in the labelInfo part of
136
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
148
137
  # the response.
149
138
  # @param [String] include_permissions_for_view
150
139
  # Specifies which additional view's permissions to include in the response. Only
@@ -153,7 +142,7 @@ module Google
153
142
  # Whether to include changes indicating that items have been removed from the
154
143
  # list of changes, for example by deletion or loss of access.
155
144
  # @param [Boolean] include_team_drive_items
156
- # Deprecated use includeItemsFromAllDrives instead.
145
+ # Deprecated: Use `includeItemsFromAllDrives` instead.
157
146
  # @param [Fixnum] page_size
158
147
  # The maximum number of changes to return per page.
159
148
  # @param [Boolean] restrict_to_my_drive
@@ -161,21 +150,19 @@ module Google
161
150
  # omits changes to files such as those in the Application Data folder or shared
162
151
  # files which have not been added to My Drive.
163
152
  # @param [String] spaces
164
- # A comma-separated list of spaces to query within the user corpus. Supported
165
- # values are 'drive', 'appDataFolder' and 'photos'.
153
+ # A comma-separated list of spaces to query within the corpora. Supported values
154
+ # are 'drive' and 'appDataFolder'.
166
155
  # @param [Boolean] supports_all_drives
167
156
  # Whether the requesting application supports both My Drives and shared drives.
168
157
  # @param [Boolean] supports_team_drives
169
- # Deprecated use supportsAllDrives instead.
158
+ # Deprecated: Use `supportsAllDrives` instead.
170
159
  # @param [String] team_drive_id
171
- # Deprecated use driveId instead.
160
+ # Deprecated: Use `driveId` instead.
172
161
  # @param [String] fields
173
162
  # Selector specifying which fields to include in a partial response.
174
163
  # @param [String] quota_user
175
- # An opaque string that represents a user for quota purposes. Must not exceed 40
176
- # characters.
177
- # @param [String] user_ip
178
- # Deprecated. Please use quotaUser instead.
164
+ # Available to use for quota purposes for server-side applications. Can be any
165
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
179
166
  # @param [Google::Apis::RequestOptions] options
180
167
  # Request-specific options
181
168
  #
@@ -188,7 +175,7 @@ module Google
188
175
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
189
176
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
190
177
  # @raise [Google::Apis::AuthorizationError] Authorization is required
191
- def list_changes(page_token, drive_id: nil, include_corpus_removals: nil, include_items_from_all_drives: nil, include_labels: nil, include_permissions_for_view: nil, include_removed: nil, include_team_drive_items: nil, page_size: nil, restrict_to_my_drive: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
178
+ def list_changes(page_token, drive_id: nil, include_corpus_removals: nil, include_items_from_all_drives: nil, include_labels: nil, include_permissions_for_view: nil, include_removed: nil, include_team_drive_items: nil, page_size: nil, restrict_to_my_drive: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, options: nil, &block)
192
179
  command = make_simple_command(:get, 'changes', options)
193
180
  command.response_representation = Google::Apis::DriveV3::ChangeList::Representation
194
181
  command.response_class = Google::Apis::DriveV3::ChangeList
@@ -208,7 +195,6 @@ module Google
208
195
  command.query['teamDriveId'] = team_drive_id unless team_drive_id.nil?
209
196
  command.query['fields'] = fields unless fields.nil?
210
197
  command.query['quotaUser'] = quota_user unless quota_user.nil?
211
- command.query['userIp'] = user_ip unless user_ip.nil?
212
198
  execute_or_queue_command(command, &block)
213
199
  end
214
200
 
@@ -219,9 +205,9 @@ module Google
219
205
  # response from the getStartPageToken method.
220
206
  # @param [Google::Apis::DriveV3::Channel] channel_object
221
207
  # @param [String] drive_id
222
- # The shared drive from which changes are returned. If specified the change IDs
223
- # will be reflective of the shared drive; use the combined drive ID and change
224
- # ID as an identifier.
208
+ # The shared drive from which changes will be returned. If specified the change
209
+ # IDs will be reflective of the shared drive; use the combined drive ID and
210
+ # change ID as an identifier.
225
211
  # @param [Boolean] include_corpus_removals
226
212
  # Whether changes should include the file resource if the file is still
227
213
  # accessible by the user at the time of the request, even when a file was
@@ -230,7 +216,7 @@ module Google
230
216
  # @param [Boolean] include_items_from_all_drives
231
217
  # Whether both My Drive and shared drive items should be included in results.
232
218
  # @param [String] include_labels
233
- # A comma-separated list of IDs of labels to include in the labelInfo part of
219
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
234
220
  # the response.
235
221
  # @param [String] include_permissions_for_view
236
222
  # Specifies which additional view's permissions to include in the response. Only
@@ -239,7 +225,7 @@ module Google
239
225
  # Whether to include changes indicating that items have been removed from the
240
226
  # list of changes, for example by deletion or loss of access.
241
227
  # @param [Boolean] include_team_drive_items
242
- # Deprecated use includeItemsFromAllDrives instead.
228
+ # Deprecated: Use `includeItemsFromAllDrives` instead.
243
229
  # @param [Fixnum] page_size
244
230
  # The maximum number of changes to return per page.
245
231
  # @param [Boolean] restrict_to_my_drive
@@ -247,21 +233,19 @@ module Google
247
233
  # omits changes to files such as those in the Application Data folder or shared
248
234
  # files which have not been added to My Drive.
249
235
  # @param [String] spaces
250
- # A comma-separated list of spaces to query within the user corpus. Supported
251
- # values are 'drive', 'appDataFolder' and 'photos'.
236
+ # A comma-separated list of spaces to query within the corpora. Supported values
237
+ # are 'drive' and 'appDataFolder'.
252
238
  # @param [Boolean] supports_all_drives
253
239
  # Whether the requesting application supports both My Drives and shared drives.
254
240
  # @param [Boolean] supports_team_drives
255
- # Deprecated use supportsAllDrives instead.
241
+ # Deprecated: Use `supportsAllDrives` instead.
256
242
  # @param [String] team_drive_id
257
- # Deprecated use driveId instead.
243
+ # Deprecated: Use `driveId` instead.
258
244
  # @param [String] fields
259
245
  # Selector specifying which fields to include in a partial response.
260
246
  # @param [String] quota_user
261
- # An opaque string that represents a user for quota purposes. Must not exceed 40
262
- # characters.
263
- # @param [String] user_ip
264
- # Deprecated. Please use quotaUser instead.
247
+ # Available to use for quota purposes for server-side applications. Can be any
248
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
265
249
  # @param [Google::Apis::RequestOptions] options
266
250
  # Request-specific options
267
251
  #
@@ -274,7 +258,7 @@ module Google
274
258
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
275
259
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
276
260
  # @raise [Google::Apis::AuthorizationError] Authorization is required
277
- def watch_change(page_token, channel_object = nil, drive_id: nil, include_corpus_removals: nil, include_items_from_all_drives: nil, include_labels: nil, include_permissions_for_view: nil, include_removed: nil, include_team_drive_items: nil, page_size: nil, restrict_to_my_drive: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
261
+ def watch_change(page_token, channel_object = nil, drive_id: nil, include_corpus_removals: nil, include_items_from_all_drives: nil, include_labels: nil, include_permissions_for_view: nil, include_removed: nil, include_team_drive_items: nil, page_size: nil, restrict_to_my_drive: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, options: nil, &block)
278
262
  command = make_simple_command(:post, 'changes/watch', options)
279
263
  command.request_representation = Google::Apis::DriveV3::Channel::Representation
280
264
  command.request_object = channel_object
@@ -296,19 +280,16 @@ module Google
296
280
  command.query['teamDriveId'] = team_drive_id unless team_drive_id.nil?
297
281
  command.query['fields'] = fields unless fields.nil?
298
282
  command.query['quotaUser'] = quota_user unless quota_user.nil?
299
- command.query['userIp'] = user_ip unless user_ip.nil?
300
283
  execute_or_queue_command(command, &block)
301
284
  end
302
285
 
303
- # Stop watching resources through this channel
286
+ # Stops watching resources through this channel.
304
287
  # @param [Google::Apis::DriveV3::Channel] channel_object
305
288
  # @param [String] fields
306
289
  # Selector specifying which fields to include in a partial response.
307
290
  # @param [String] quota_user
308
- # An opaque string that represents a user for quota purposes. Must not exceed 40
309
- # characters.
310
- # @param [String] user_ip
311
- # Deprecated. Please use quotaUser instead.
291
+ # Available to use for quota purposes for server-side applications. Can be any
292
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
312
293
  # @param [Google::Apis::RequestOptions] options
313
294
  # Request-specific options
314
295
  #
@@ -321,27 +302,24 @@ module Google
321
302
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
322
303
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
323
304
  # @raise [Google::Apis::AuthorizationError] Authorization is required
324
- def stop_channel(channel_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
305
+ def stop_channel(channel_object = nil, fields: nil, quota_user: nil, options: nil, &block)
325
306
  command = make_simple_command(:post, 'channels/stop', options)
326
307
  command.request_representation = Google::Apis::DriveV3::Channel::Representation
327
308
  command.request_object = channel_object
328
309
  command.query['fields'] = fields unless fields.nil?
329
310
  command.query['quotaUser'] = quota_user unless quota_user.nil?
330
- command.query['userIp'] = user_ip unless user_ip.nil?
331
311
  execute_or_queue_command(command, &block)
332
312
  end
333
313
 
334
- # Creates a new comment on a file.
314
+ # Creates a comment on a file.
335
315
  # @param [String] file_id
336
316
  # The ID of the file.
337
317
  # @param [Google::Apis::DriveV3::Comment] comment_object
338
318
  # @param [String] fields
339
319
  # Selector specifying which fields to include in a partial response.
340
320
  # @param [String] quota_user
341
- # An opaque string that represents a user for quota purposes. Must not exceed 40
342
- # characters.
343
- # @param [String] user_ip
344
- # Deprecated. Please use quotaUser instead.
321
+ # Available to use for quota purposes for server-side applications. Can be any
322
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
345
323
  # @param [Google::Apis::RequestOptions] options
346
324
  # Request-specific options
347
325
  #
@@ -354,7 +332,7 @@ module Google
354
332
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
355
333
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
356
334
  # @raise [Google::Apis::AuthorizationError] Authorization is required
357
- def create_comment(file_id, comment_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
335
+ def create_comment(file_id, comment_object = nil, fields: nil, quota_user: nil, options: nil, &block)
358
336
  command = make_simple_command(:post, 'files/{fileId}/comments', options)
359
337
  command.request_representation = Google::Apis::DriveV3::Comment::Representation
360
338
  command.request_object = comment_object
@@ -363,7 +341,6 @@ module Google
363
341
  command.params['fileId'] = file_id unless file_id.nil?
364
342
  command.query['fields'] = fields unless fields.nil?
365
343
  command.query['quotaUser'] = quota_user unless quota_user.nil?
366
- command.query['userIp'] = user_ip unless user_ip.nil?
367
344
  execute_or_queue_command(command, &block)
368
345
  end
369
346
 
@@ -375,10 +352,8 @@ module Google
375
352
  # @param [String] fields
376
353
  # Selector specifying which fields to include in a partial response.
377
354
  # @param [String] quota_user
378
- # An opaque string that represents a user for quota purposes. Must not exceed 40
379
- # characters.
380
- # @param [String] user_ip
381
- # Deprecated. Please use quotaUser instead.
355
+ # Available to use for quota purposes for server-side applications. Can be any
356
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
382
357
  # @param [Google::Apis::RequestOptions] options
383
358
  # Request-specific options
384
359
  #
@@ -391,13 +366,12 @@ module Google
391
366
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
392
367
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
393
368
  # @raise [Google::Apis::AuthorizationError] Authorization is required
394
- def delete_comment(file_id, comment_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
369
+ def delete_comment(file_id, comment_id, fields: nil, quota_user: nil, options: nil, &block)
395
370
  command = make_simple_command(:delete, 'files/{fileId}/comments/{commentId}', options)
396
371
  command.params['fileId'] = file_id unless file_id.nil?
397
372
  command.params['commentId'] = comment_id unless comment_id.nil?
398
373
  command.query['fields'] = fields unless fields.nil?
399
374
  command.query['quotaUser'] = quota_user unless quota_user.nil?
400
- command.query['userIp'] = user_ip unless user_ip.nil?
401
375
  execute_or_queue_command(command, &block)
402
376
  end
403
377
 
@@ -412,10 +386,8 @@ module Google
412
386
  # @param [String] fields
413
387
  # Selector specifying which fields to include in a partial response.
414
388
  # @param [String] quota_user
415
- # An opaque string that represents a user for quota purposes. Must not exceed 40
416
- # characters.
417
- # @param [String] user_ip
418
- # Deprecated. Please use quotaUser instead.
389
+ # Available to use for quota purposes for server-side applications. Can be any
390
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
419
391
  # @param [Google::Apis::RequestOptions] options
420
392
  # Request-specific options
421
393
  #
@@ -428,7 +400,7 @@ module Google
428
400
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
429
401
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
430
402
  # @raise [Google::Apis::AuthorizationError] Authorization is required
431
- def get_comment(file_id, comment_id, include_deleted: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
403
+ def get_comment(file_id, comment_id, include_deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
432
404
  command = make_simple_command(:get, 'files/{fileId}/comments/{commentId}', options)
433
405
  command.response_representation = Google::Apis::DriveV3::Comment::Representation
434
406
  command.response_class = Google::Apis::DriveV3::Comment
@@ -437,7 +409,6 @@ module Google
437
409
  command.query['includeDeleted'] = include_deleted unless include_deleted.nil?
438
410
  command.query['fields'] = fields unless fields.nil?
439
411
  command.query['quotaUser'] = quota_user unless quota_user.nil?
440
- command.query['userIp'] = user_ip unless user_ip.nil?
441
412
  execute_or_queue_command(command, &block)
442
413
  end
443
414
 
@@ -458,10 +429,8 @@ module Google
458
429
  # @param [String] fields
459
430
  # Selector specifying which fields to include in a partial response.
460
431
  # @param [String] quota_user
461
- # An opaque string that represents a user for quota purposes. Must not exceed 40
462
- # characters.
463
- # @param [String] user_ip
464
- # Deprecated. Please use quotaUser instead.
432
+ # Available to use for quota purposes for server-side applications. Can be any
433
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
465
434
  # @param [Google::Apis::RequestOptions] options
466
435
  # Request-specific options
467
436
  #
@@ -474,7 +443,7 @@ module Google
474
443
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
475
444
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
476
445
  # @raise [Google::Apis::AuthorizationError] Authorization is required
477
- def list_comments(file_id, include_deleted: nil, page_size: nil, page_token: nil, start_modified_time: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
446
+ def list_comments(file_id, include_deleted: nil, page_size: nil, page_token: nil, start_modified_time: nil, fields: nil, quota_user: nil, options: nil, &block)
478
447
  command = make_simple_command(:get, 'files/{fileId}/comments', options)
479
448
  command.response_representation = Google::Apis::DriveV3::CommentList::Representation
480
449
  command.response_class = Google::Apis::DriveV3::CommentList
@@ -485,7 +454,6 @@ module Google
485
454
  command.query['startModifiedTime'] = start_modified_time unless start_modified_time.nil?
486
455
  command.query['fields'] = fields unless fields.nil?
487
456
  command.query['quotaUser'] = quota_user unless quota_user.nil?
488
- command.query['userIp'] = user_ip unless user_ip.nil?
489
457
  execute_or_queue_command(command, &block)
490
458
  end
491
459
 
@@ -498,10 +466,8 @@ module Google
498
466
  # @param [String] fields
499
467
  # Selector specifying which fields to include in a partial response.
500
468
  # @param [String] quota_user
501
- # An opaque string that represents a user for quota purposes. Must not exceed 40
502
- # characters.
503
- # @param [String] user_ip
504
- # Deprecated. Please use quotaUser instead.
469
+ # Available to use for quota purposes for server-side applications. Can be any
470
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
505
471
  # @param [Google::Apis::RequestOptions] options
506
472
  # Request-specific options
507
473
  #
@@ -514,7 +480,7 @@ module Google
514
480
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
515
481
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
516
482
  # @raise [Google::Apis::AuthorizationError] Authorization is required
517
- def update_comment(file_id, comment_id, comment_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
483
+ def update_comment(file_id, comment_id, comment_object = nil, fields: nil, quota_user: nil, options: nil, &block)
518
484
  command = make_simple_command(:patch, 'files/{fileId}/comments/{commentId}', options)
519
485
  command.request_representation = Google::Apis::DriveV3::Comment::Representation
520
486
  command.request_object = comment_object
@@ -524,25 +490,22 @@ module Google
524
490
  command.params['commentId'] = comment_id unless comment_id.nil?
525
491
  command.query['fields'] = fields unless fields.nil?
526
492
  command.query['quotaUser'] = quota_user unless quota_user.nil?
527
- command.query['userIp'] = user_ip unless user_ip.nil?
528
493
  execute_or_queue_command(command, &block)
529
494
  end
530
495
 
531
- # Creates a new shared drive.
496
+ # Creates a shared drive.
532
497
  # @param [String] request_id
533
- # An ID, such as a random UUID, which uniquely identifies this user's request
534
- # for idempotent creation of a shared drive. A repeated request by the same user
535
- # and with the same request ID will avoid creating duplicates by attempting to
536
- # create the same shared drive. If the shared drive already exists a 409 error
537
- # will be returned.
498
+ # Required. An ID, such as a random UUID, which uniquely identifies this user's
499
+ # request for idempotent creation of a shared drive. A repeated request by the
500
+ # same user and with the same request ID will avoid creating duplicates by
501
+ # attempting to create the same shared drive. If the shared drive already exists
502
+ # a 409 error will be returned.
538
503
  # @param [Google::Apis::DriveV3::Drive] drive_object
539
504
  # @param [String] fields
540
505
  # Selector specifying which fields to include in a partial response.
541
506
  # @param [String] quota_user
542
- # An opaque string that represents a user for quota purposes. Must not exceed 40
543
- # characters.
544
- # @param [String] user_ip
545
- # Deprecated. Please use quotaUser instead.
507
+ # Available to use for quota purposes for server-side applications. Can be any
508
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
546
509
  # @param [Google::Apis::RequestOptions] options
547
510
  # Request-specific options
548
511
  #
@@ -555,7 +518,7 @@ module Google
555
518
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
556
519
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
557
520
  # @raise [Google::Apis::AuthorizationError] Authorization is required
558
- def create_drive(request_id, drive_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
521
+ def create_drive(request_id, drive_object = nil, fields: nil, quota_user: nil, options: nil, &block)
559
522
  command = make_simple_command(:post, 'drives', options)
560
523
  command.request_representation = Google::Apis::DriveV3::Drive::Representation
561
524
  command.request_object = drive_object
@@ -564,17 +527,16 @@ module Google
564
527
  command.query['requestId'] = request_id unless request_id.nil?
565
528
  command.query['fields'] = fields unless fields.nil?
566
529
  command.query['quotaUser'] = quota_user unless quota_user.nil?
567
- command.query['userIp'] = user_ip unless user_ip.nil?
568
530
  execute_or_queue_command(command, &block)
569
531
  end
570
532
 
571
- # Permanently deletes a shared drive for which the user is an organizer. The
533
+ # Permanently deletes a shared drive for which the user is an `organizer`. The
572
534
  # shared drive cannot contain any untrashed items.
573
535
  # @param [String] drive_id
574
536
  # The ID of the shared drive.
575
537
  # @param [Boolean] allow_item_deletion
576
538
  # Whether any items inside the shared drive should also be deleted. This option
577
- # is only supported when useDomainAdminAccess is also set to true.
539
+ # is only supported when `useDomainAdminAccess` is also set to `true`.
578
540
  # @param [Boolean] use_domain_admin_access
579
541
  # Issue the request as a domain administrator; if set to true, then the
580
542
  # requester will be granted access if they are an administrator of the domain to
@@ -582,10 +544,8 @@ module Google
582
544
  # @param [String] fields
583
545
  # Selector specifying which fields to include in a partial response.
584
546
  # @param [String] quota_user
585
- # An opaque string that represents a user for quota purposes. Must not exceed 40
586
- # characters.
587
- # @param [String] user_ip
588
- # Deprecated. Please use quotaUser instead.
547
+ # Available to use for quota purposes for server-side applications. Can be any
548
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
589
549
  # @param [Google::Apis::RequestOptions] options
590
550
  # Request-specific options
591
551
  #
@@ -598,14 +558,13 @@ module Google
598
558
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
599
559
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
600
560
  # @raise [Google::Apis::AuthorizationError] Authorization is required
601
- def delete_drive(drive_id, allow_item_deletion: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
561
+ def delete_drive(drive_id, allow_item_deletion: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
602
562
  command = make_simple_command(:delete, 'drives/{driveId}', options)
603
563
  command.params['driveId'] = drive_id unless drive_id.nil?
604
564
  command.query['allowItemDeletion'] = allow_item_deletion unless allow_item_deletion.nil?
605
565
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
606
566
  command.query['fields'] = fields unless fields.nil?
607
567
  command.query['quotaUser'] = quota_user unless quota_user.nil?
608
- command.query['userIp'] = user_ip unless user_ip.nil?
609
568
  execute_or_queue_command(command, &block)
610
569
  end
611
570
 
@@ -619,10 +578,8 @@ module Google
619
578
  # @param [String] fields
620
579
  # Selector specifying which fields to include in a partial response.
621
580
  # @param [String] quota_user
622
- # An opaque string that represents a user for quota purposes. Must not exceed 40
623
- # characters.
624
- # @param [String] user_ip
625
- # Deprecated. Please use quotaUser instead.
581
+ # Available to use for quota purposes for server-side applications. Can be any
582
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
626
583
  # @param [Google::Apis::RequestOptions] options
627
584
  # Request-specific options
628
585
  #
@@ -635,7 +592,7 @@ module Google
635
592
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
636
593
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
637
594
  # @raise [Google::Apis::AuthorizationError] Authorization is required
638
- def get_drive(drive_id, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
595
+ def get_drive(drive_id, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
639
596
  command = make_simple_command(:get, 'drives/{driveId}', options)
640
597
  command.response_representation = Google::Apis::DriveV3::Drive::Representation
641
598
  command.response_class = Google::Apis::DriveV3::Drive
@@ -643,7 +600,6 @@ module Google
643
600
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
644
601
  command.query['fields'] = fields unless fields.nil?
645
602
  command.query['quotaUser'] = quota_user unless quota_user.nil?
646
- command.query['userIp'] = user_ip unless user_ip.nil?
647
603
  execute_or_queue_command(command, &block)
648
604
  end
649
605
 
@@ -653,10 +609,8 @@ module Google
653
609
  # @param [String] fields
654
610
  # Selector specifying which fields to include in a partial response.
655
611
  # @param [String] quota_user
656
- # An opaque string that represents a user for quota purposes. Must not exceed 40
657
- # characters.
658
- # @param [String] user_ip
659
- # Deprecated. Please use quotaUser instead.
612
+ # Available to use for quota purposes for server-side applications. Can be any
613
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
660
614
  # @param [Google::Apis::RequestOptions] options
661
615
  # Request-specific options
662
616
  #
@@ -669,18 +623,20 @@ module Google
669
623
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
670
624
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
671
625
  # @raise [Google::Apis::AuthorizationError] Authorization is required
672
- def hide_drive(drive_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
626
+ def hide_drive(drive_id, fields: nil, quota_user: nil, options: nil, &block)
673
627
  command = make_simple_command(:post, 'drives/{driveId}/hide', options)
674
628
  command.response_representation = Google::Apis::DriveV3::Drive::Representation
675
629
  command.response_class = Google::Apis::DriveV3::Drive
676
630
  command.params['driveId'] = drive_id unless drive_id.nil?
677
631
  command.query['fields'] = fields unless fields.nil?
678
632
  command.query['quotaUser'] = quota_user unless quota_user.nil?
679
- command.query['userIp'] = user_ip unless user_ip.nil?
680
633
  execute_or_queue_command(command, &block)
681
634
  end
682
635
 
683
- # Lists the user's shared drives.
636
+ # Lists the user's shared drives. This method accepts the `q` parameter, which
637
+ # is a search query combining one or more search terms. For more information,
638
+ # see the [Search for shared drives](/drive/api/guides/search-shareddrives)
639
+ # guide.
684
640
  # @param [Fixnum] page_size
685
641
  # Maximum number of shared drives to return per page.
686
642
  # @param [String] page_token
@@ -693,10 +649,8 @@ module Google
693
649
  # @param [String] fields
694
650
  # Selector specifying which fields to include in a partial response.
695
651
  # @param [String] quota_user
696
- # An opaque string that represents a user for quota purposes. Must not exceed 40
697
- # characters.
698
- # @param [String] user_ip
699
- # Deprecated. Please use quotaUser instead.
652
+ # Available to use for quota purposes for server-side applications. Can be any
653
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
700
654
  # @param [Google::Apis::RequestOptions] options
701
655
  # Request-specific options
702
656
  #
@@ -709,7 +663,7 @@ module Google
709
663
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
710
664
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
711
665
  # @raise [Google::Apis::AuthorizationError] Authorization is required
712
- def list_drives(page_size: nil, page_token: nil, q: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
666
+ def list_drives(page_size: nil, page_token: nil, q: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
713
667
  command = make_simple_command(:get, 'drives', options)
714
668
  command.response_representation = Google::Apis::DriveV3::DriveList::Representation
715
669
  command.response_class = Google::Apis::DriveV3::DriveList
@@ -719,7 +673,6 @@ module Google
719
673
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
720
674
  command.query['fields'] = fields unless fields.nil?
721
675
  command.query['quotaUser'] = quota_user unless quota_user.nil?
722
- command.query['userIp'] = user_ip unless user_ip.nil?
723
676
  execute_or_queue_command(command, &block)
724
677
  end
725
678
 
@@ -729,10 +682,8 @@ module Google
729
682
  # @param [String] fields
730
683
  # Selector specifying which fields to include in a partial response.
731
684
  # @param [String] quota_user
732
- # An opaque string that represents a user for quota purposes. Must not exceed 40
733
- # characters.
734
- # @param [String] user_ip
735
- # Deprecated. Please use quotaUser instead.
685
+ # Available to use for quota purposes for server-side applications. Can be any
686
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
736
687
  # @param [Google::Apis::RequestOptions] options
737
688
  # Request-specific options
738
689
  #
@@ -745,14 +696,13 @@ module Google
745
696
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
746
697
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
747
698
  # @raise [Google::Apis::AuthorizationError] Authorization is required
748
- def unhide_drive(drive_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
699
+ def unhide_drive(drive_id, fields: nil, quota_user: nil, options: nil, &block)
749
700
  command = make_simple_command(:post, 'drives/{driveId}/unhide', options)
750
701
  command.response_representation = Google::Apis::DriveV3::Drive::Representation
751
702
  command.response_class = Google::Apis::DriveV3::Drive
752
703
  command.params['driveId'] = drive_id unless drive_id.nil?
753
704
  command.query['fields'] = fields unless fields.nil?
754
705
  command.query['quotaUser'] = quota_user unless quota_user.nil?
755
- command.query['userIp'] = user_ip unless user_ip.nil?
756
706
  execute_or_queue_command(command, &block)
757
707
  end
758
708
 
@@ -767,10 +717,8 @@ module Google
767
717
  # @param [String] fields
768
718
  # Selector specifying which fields to include in a partial response.
769
719
  # @param [String] quota_user
770
- # An opaque string that represents a user for quota purposes. Must not exceed 40
771
- # characters.
772
- # @param [String] user_ip
773
- # Deprecated. Please use quotaUser instead.
720
+ # Available to use for quota purposes for server-side applications. Can be any
721
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
774
722
  # @param [Google::Apis::RequestOptions] options
775
723
  # Request-specific options
776
724
  #
@@ -783,7 +731,7 @@ module Google
783
731
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
784
732
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
785
733
  # @raise [Google::Apis::AuthorizationError] Authorization is required
786
- def update_drive(drive_id, drive_object = nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
734
+ def update_drive(drive_id, drive_object = nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
787
735
  command = make_simple_command(:patch, 'drives/{driveId}', options)
788
736
  command.request_representation = Google::Apis::DriveV3::Drive::Representation
789
737
  command.request_object = drive_object
@@ -793,12 +741,11 @@ module Google
793
741
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
794
742
  command.query['fields'] = fields unless fields.nil?
795
743
  command.query['quotaUser'] = quota_user unless quota_user.nil?
796
- command.query['userIp'] = user_ip unless user_ip.nil?
797
744
  execute_or_queue_command(command, &block)
798
745
  end
799
746
 
800
747
  # Creates a copy of a file and applies any requested updates with patch
801
- # semantics. Folders cannot be copied.
748
+ # semantics.
802
749
  # @param [String] file_id
803
750
  # The ID of the file.
804
751
  # @param [Google::Apis::DriveV3::File] file_object
@@ -811,7 +758,7 @@ module Google
811
758
  # the domain by default; this parameter bypasses that behavior for the request.
812
759
  # Permissions are still inherited from parent folders.
813
760
  # @param [String] include_labels
814
- # A comma-separated list of IDs of labels to include in the labelInfo part of
761
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
815
762
  # the response.
816
763
  # @param [String] include_permissions_for_view
817
764
  # Specifies which additional view's permissions to include in the response. Only
@@ -826,14 +773,12 @@ module Google
826
773
  # @param [Boolean] supports_all_drives
827
774
  # Whether the requesting application supports both My Drives and shared drives.
828
775
  # @param [Boolean] supports_team_drives
829
- # Deprecated use supportsAllDrives instead.
776
+ # Deprecated: Use `supportsAllDrives` instead.
830
777
  # @param [String] fields
831
778
  # Selector specifying which fields to include in a partial response.
832
779
  # @param [String] quota_user
833
- # An opaque string that represents a user for quota purposes. Must not exceed 40
834
- # characters.
835
- # @param [String] user_ip
836
- # Deprecated. Please use quotaUser instead.
780
+ # Available to use for quota purposes for server-side applications. Can be any
781
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
837
782
  # @param [Google::Apis::RequestOptions] options
838
783
  # Request-specific options
839
784
  #
@@ -846,7 +791,7 @@ module Google
846
791
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
847
792
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
848
793
  # @raise [Google::Apis::AuthorizationError] Authorization is required
849
- def copy_file(file_id, file_object = nil, enforce_single_parent: nil, ignore_default_visibility: nil, include_labels: nil, include_permissions_for_view: nil, keep_revision_forever: nil, ocr_language: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
794
+ def copy_file(file_id, file_object = nil, enforce_single_parent: nil, ignore_default_visibility: nil, include_labels: nil, include_permissions_for_view: nil, keep_revision_forever: nil, ocr_language: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, options: nil, &block)
850
795
  command = make_simple_command(:post, 'files/{fileId}/copy', options)
851
796
  command.request_representation = Google::Apis::DriveV3::File::Representation
852
797
  command.request_object = file_object
@@ -863,11 +808,26 @@ module Google
863
808
  command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
864
809
  command.query['fields'] = fields unless fields.nil?
865
810
  command.query['quotaUser'] = quota_user unless quota_user.nil?
866
- command.query['userIp'] = user_ip unless user_ip.nil?
867
811
  execute_or_queue_command(command, &block)
868
812
  end
869
813
 
870
- # Creates a new file.
814
+ # Creates a new file. This method supports an */upload* URI and accepts
815
+ # uploaded media with the following characteristics: - *Maximum file size:* 5,
816
+ # 120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type,
817
+ # rather than the literal `*/*` value. The literal `*/*` is only used to
818
+ # indicate that any valid MIME type can be uploaded. For more information on
819
+ # uploading files, see [Upload file data](/drive/api/guides/manage-uploads).
820
+ # Apps creating shortcuts with `files.create` must specify the MIME type `
821
+ # application/vnd.google-apps.shortcut`. Apps should specify a file extension in
822
+ # the `name` property when inserting files with the API. For example, an
823
+ # operation to insert a JPEG file should specify something like `"name": "cat.
824
+ # jpg"` in the metadata. Subsequent `GET` requests include the read-only `
825
+ # fileExtension` property populated with the extension originally specified in
826
+ # the `title` property. When a Google Drive user requests to download a file, or
827
+ # when the file is downloaded through the sync client, Drive builds a full
828
+ # filename (with extension) based on the title. In cases where the extension is
829
+ # missing, Drive attempts to determine the extension based on the file's MIME
830
+ # type.
871
831
  # @param [Google::Apis::DriveV3::File] file_object
872
832
  # @param [Boolean] enforce_single_parent
873
833
  # Deprecated. Creating files in multiple folders is no longer supported.
@@ -877,7 +837,7 @@ module Google
877
837
  # the domain by default; this parameter bypasses that behavior for the request.
878
838
  # Permissions are still inherited from parent folders.
879
839
  # @param [String] include_labels
880
- # A comma-separated list of IDs of labels to include in the labelInfo part of
840
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
881
841
  # the response.
882
842
  # @param [String] include_permissions_for_view
883
843
  # Specifies which additional view's permissions to include in the response. Only
@@ -892,16 +852,14 @@ module Google
892
852
  # @param [Boolean] supports_all_drives
893
853
  # Whether the requesting application supports both My Drives and shared drives.
894
854
  # @param [Boolean] supports_team_drives
895
- # Deprecated use supportsAllDrives instead.
855
+ # Deprecated: Use `supportsAllDrives` instead.
896
856
  # @param [Boolean] use_content_as_indexable_text
897
857
  # Whether to use the uploaded content as indexable text.
898
858
  # @param [String] fields
899
859
  # Selector specifying which fields to include in a partial response.
900
860
  # @param [String] quota_user
901
- # An opaque string that represents a user for quota purposes. Must not exceed 40
902
- # characters.
903
- # @param [String] user_ip
904
- # Deprecated. Please use quotaUser instead.
861
+ # Available to use for quota purposes for server-side applications. Can be any
862
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
905
863
  # @param [IO, String] upload_source
906
864
  # IO stream or filename containing content to upload
907
865
  # @param [String] content_type
@@ -918,7 +876,7 @@ module Google
918
876
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
919
877
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
920
878
  # @raise [Google::Apis::AuthorizationError] Authorization is required
921
- def create_file(file_object = nil, enforce_single_parent: nil, ignore_default_visibility: nil, include_labels: nil, include_permissions_for_view: nil, keep_revision_forever: nil, ocr_language: nil, supports_all_drives: nil, supports_team_drives: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
879
+ def create_file(file_object = nil, enforce_single_parent: nil, ignore_default_visibility: nil, include_labels: nil, include_permissions_for_view: nil, keep_revision_forever: nil, ocr_language: nil, supports_all_drives: nil, supports_team_drives: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
922
880
  if upload_source.nil?
923
881
  command = make_simple_command(:post, 'files', options)
924
882
  else
@@ -941,30 +899,27 @@ module Google
941
899
  command.query['useContentAsIndexableText'] = use_content_as_indexable_text unless use_content_as_indexable_text.nil?
942
900
  command.query['fields'] = fields unless fields.nil?
943
901
  command.query['quotaUser'] = quota_user unless quota_user.nil?
944
- command.query['userIp'] = user_ip unless user_ip.nil?
945
902
  execute_or_queue_command(command, &block)
946
903
  end
947
904
 
948
905
  # Permanently deletes a file owned by the user without moving it to the trash.
949
- # If the file belongs to a shared drive the user must be an organizer on the
950
- # parent. If the target is a folder, all descendants owned by the user are also
951
- # deleted.
906
+ # If the file belongs to a shared drive, the user must be an `organizer` on the
907
+ # parent folder. If the target is a folder, all descendants owned by the user
908
+ # are also deleted.
952
909
  # @param [String] file_id
953
910
  # The ID of the file.
954
911
  # @param [Boolean] enforce_single_parent
955
- # Deprecated. If an item is not in a shared drive and its last parent is deleted
912
+ # Deprecated: If an item is not in a shared drive and its last parent is deleted
956
913
  # but the item itself is not, the item will be placed under its owner's root.
957
914
  # @param [Boolean] supports_all_drives
958
915
  # Whether the requesting application supports both My Drives and shared drives.
959
916
  # @param [Boolean] supports_team_drives
960
- # Deprecated use supportsAllDrives instead.
917
+ # Deprecated: Use `supportsAllDrives` instead.
961
918
  # @param [String] fields
962
919
  # Selector specifying which fields to include in a partial response.
963
920
  # @param [String] quota_user
964
- # An opaque string that represents a user for quota purposes. Must not exceed 40
965
- # characters.
966
- # @param [String] user_ip
967
- # Deprecated. Please use quotaUser instead.
921
+ # Available to use for quota purposes for server-side applications. Can be any
922
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
968
923
  # @param [Google::Apis::RequestOptions] options
969
924
  # Request-specific options
970
925
  #
@@ -977,7 +932,7 @@ module Google
977
932
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
978
933
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
979
934
  # @raise [Google::Apis::AuthorizationError] Authorization is required
980
- def delete_file(file_id, enforce_single_parent: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
935
+ def delete_file(file_id, enforce_single_parent: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, options: nil, &block)
981
936
  command = make_simple_command(:delete, 'files/{fileId}', options)
982
937
  command.params['fileId'] = file_id unless file_id.nil?
983
938
  command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
@@ -985,21 +940,20 @@ module Google
985
940
  command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
986
941
  command.query['fields'] = fields unless fields.nil?
987
942
  command.query['quotaUser'] = quota_user unless quota_user.nil?
988
- command.query['userIp'] = user_ip unless user_ip.nil?
989
943
  execute_or_queue_command(command, &block)
990
944
  end
991
945
 
992
946
  # Permanently deletes all of the user's trashed files.
947
+ # @param [String] drive_id
948
+ # If set, empties the trash of the provided shared drive.
993
949
  # @param [Boolean] enforce_single_parent
994
- # Deprecated. If an item is not in a shared drive and its last parent is deleted
950
+ # Deprecated: If an item is not in a shared drive and its last parent is deleted
995
951
  # but the item itself is not, the item will be placed under its owner's root.
996
952
  # @param [String] fields
997
953
  # Selector specifying which fields to include in a partial response.
998
954
  # @param [String] quota_user
999
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1000
- # characters.
1001
- # @param [String] user_ip
1002
- # Deprecated. Please use quotaUser instead.
955
+ # Available to use for quota purposes for server-side applications. Can be any
956
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1003
957
  # @param [Google::Apis::RequestOptions] options
1004
958
  # Request-specific options
1005
959
  #
@@ -1012,12 +966,12 @@ module Google
1012
966
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1013
967
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1014
968
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1015
- def empty_file_trash(enforce_single_parent: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
969
+ def empty_file_trash(drive_id: nil, enforce_single_parent: nil, fields: nil, quota_user: nil, options: nil, &block)
1016
970
  command = make_simple_command(:delete, 'files/trash', options)
971
+ command.query['driveId'] = drive_id unless drive_id.nil?
1017
972
  command.query['enforceSingleParent'] = enforce_single_parent unless enforce_single_parent.nil?
1018
973
  command.query['fields'] = fields unless fields.nil?
1019
974
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1020
- command.query['userIp'] = user_ip unless user_ip.nil?
1021
975
  execute_or_queue_command(command, &block)
1022
976
  end
1023
977
 
@@ -1026,14 +980,12 @@ module Google
1026
980
  # @param [String] file_id
1027
981
  # The ID of the file.
1028
982
  # @param [String] mime_type
1029
- # The MIME type of the format requested for this export.
983
+ # Required. The MIME type of the format requested for this export.
1030
984
  # @param [String] fields
1031
985
  # Selector specifying which fields to include in a partial response.
1032
986
  # @param [String] quota_user
1033
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1034
- # characters.
1035
- # @param [String] user_ip
1036
- # Deprecated. Please use quotaUser instead.
987
+ # Available to use for quota purposes for server-side applications. Can be any
988
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1037
989
  # @param [IO, String] download_dest
1038
990
  # IO stream or filename to receive content download
1039
991
  # @param [Google::Apis::RequestOptions] options
@@ -1048,7 +1000,7 @@ module Google
1048
1000
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1049
1001
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1050
1002
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1051
- def export_file(file_id, mime_type, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
1003
+ def export_file(file_id, mime_type, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
1052
1004
  if download_dest.nil?
1053
1005
  command = make_simple_command(:get, 'files/{fileId}/export', options)
1054
1006
  else
@@ -1059,7 +1011,6 @@ module Google
1059
1011
  command.query['mimeType'] = mime_type unless mime_type.nil?
1060
1012
  command.query['fields'] = fields unless fields.nil?
1061
1013
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1062
- command.query['userIp'] = user_ip unless user_ip.nil?
1063
1014
  execute_or_queue_command(command, &block)
1064
1015
  end
1065
1016
 
@@ -1071,15 +1022,13 @@ module Google
1071
1022
  # are 'drive' and 'appDataFolder'. (Default: 'drive')
1072
1023
  # @param [String] type
1073
1024
  # The type of items which the IDs can be used for. Supported values are 'files'
1074
- # and 'shortcuts'. Note that 'shortcuts' are only supported in the drive 'space'.
1075
- # (Default: 'files')
1025
+ # and 'shortcuts'. Note that 'shortcuts' are only supported in the `drive` '
1026
+ # space'. (Default: 'files')
1076
1027
  # @param [String] fields
1077
1028
  # Selector specifying which fields to include in a partial response.
1078
1029
  # @param [String] quota_user
1079
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1080
- # characters.
1081
- # @param [String] user_ip
1082
- # Deprecated. Please use quotaUser instead.
1030
+ # Available to use for quota purposes for server-side applications. Can be any
1031
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1083
1032
  # @param [Google::Apis::RequestOptions] options
1084
1033
  # Request-specific options
1085
1034
  #
@@ -1092,7 +1041,7 @@ module Google
1092
1041
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1093
1042
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1094
1043
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1095
- def generate_file_ids(count: nil, space: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1044
+ def generate_file_ids(count: nil, space: nil, type: nil, fields: nil, quota_user: nil, options: nil, &block)
1096
1045
  command = make_simple_command(:get, 'files/generateIds', options)
1097
1046
  command.response_representation = Google::Apis::DriveV3::GeneratedIds::Representation
1098
1047
  command.response_class = Google::Apis::DriveV3::GeneratedIds
@@ -1101,18 +1050,22 @@ module Google
1101
1050
  command.query['type'] = type unless type.nil?
1102
1051
  command.query['fields'] = fields unless fields.nil?
1103
1052
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1104
- command.query['userIp'] = user_ip unless user_ip.nil?
1105
1053
  execute_or_queue_command(command, &block)
1106
1054
  end
1107
1055
 
1108
- # Gets a file's metadata or content by ID.
1056
+ # Gets a file's metadata or content by ID. If you provide the URL parameter `
1057
+ # alt=media`, then the response includes the file contents in the response body.
1058
+ # Downloading content with `alt=media` only works if the file is stored in Drive.
1059
+ # To download Google Docs, Sheets, and Slides use [`files.export`](/drive/api/
1060
+ # reference/rest/v3/files/export) instead. For more information, see [Download &
1061
+ # export files](/drive/api/guides/manage-downloads).
1109
1062
  # @param [String] file_id
1110
1063
  # The ID of the file.
1111
1064
  # @param [Boolean] acknowledge_abuse
1112
1065
  # Whether the user is acknowledging the risk of downloading known malware or
1113
1066
  # other abusive files. This is only applicable when alt=media.
1114
1067
  # @param [String] include_labels
1115
- # A comma-separated list of IDs of labels to include in the labelInfo part of
1068
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
1116
1069
  # the response.
1117
1070
  # @param [String] include_permissions_for_view
1118
1071
  # Specifies which additional view's permissions to include in the response. Only
@@ -1120,14 +1073,12 @@ module Google
1120
1073
  # @param [Boolean] supports_all_drives
1121
1074
  # Whether the requesting application supports both My Drives and shared drives.
1122
1075
  # @param [Boolean] supports_team_drives
1123
- # Deprecated use supportsAllDrives instead.
1076
+ # Deprecated: Use `supportsAllDrives` instead.
1124
1077
  # @param [String] fields
1125
1078
  # Selector specifying which fields to include in a partial response.
1126
1079
  # @param [String] quota_user
1127
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1128
- # characters.
1129
- # @param [String] user_ip
1130
- # Deprecated. Please use quotaUser instead.
1080
+ # Available to use for quota purposes for server-side applications. Can be any
1081
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1131
1082
  # @param [IO, String] download_dest
1132
1083
  # IO stream or filename to receive content download
1133
1084
  # @param [Google::Apis::RequestOptions] options
@@ -1142,7 +1093,7 @@ module Google
1142
1093
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1143
1094
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1144
1095
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1145
- def get_file(file_id, acknowledge_abuse: nil, include_labels: nil, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
1096
+ def get_file(file_id, acknowledge_abuse: nil, include_labels: nil, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
1146
1097
  if download_dest.nil?
1147
1098
  command = make_simple_command(:get, 'files/{fileId}', options)
1148
1099
  else
@@ -1159,40 +1110,40 @@ module Google
1159
1110
  command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
1160
1111
  command.query['fields'] = fields unless fields.nil?
1161
1112
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1162
- command.query['userIp'] = user_ip unless user_ip.nil?
1163
1113
  execute_or_queue_command(command, &block)
1164
1114
  end
1165
1115
 
1166
- # Lists or searches files.
1116
+ # Lists the user's files. This method accepts the `q` parameter, which is a
1117
+ # search query combining one or more search terms. For more information, see the
1118
+ # [Search for files & folders](/drive/api/guides/search-files) guide. *Note:*
1119
+ # This method returns *all* files by default, including trashed files. If you
1120
+ # don't want trashed files to appear in the list, use the `trashed=false` query
1121
+ # parameter to remove trashed files from the results.
1167
1122
  # @param [String] corpora
1168
- # Groupings of files to which the query applies. Supported groupings are: 'user'
1169
- # (files created by, opened by, or shared directly with the user), 'drive' (
1170
- # files in the specified shared drive as indicated by the 'driveId'), 'domain' (
1171
- # files shared to the user's domain), and 'allDrives' (A combination of 'user'
1172
- # and 'drive' for all drives where the user is a member). When able, use 'user'
1173
- # or 'drive', instead of 'allDrives', for efficiency.
1123
+ # Bodies of items (files/documents) to which the query applies. Supported bodies
1124
+ # are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to '
1125
+ # allDrives' for efficiency. By default, corpora is set to 'user'. However, this
1126
+ # can change depending on the filter set through the 'q' parameter.
1174
1127
  # @param [String] corpus
1175
- # The source of files to list. Deprecated: use 'corpora' instead.
1128
+ # Deprecated: The source of files to list. Use 'corpora' instead.
1176
1129
  # @param [String] drive_id
1177
1130
  # ID of the shared drive to search.
1178
1131
  # @param [Boolean] include_items_from_all_drives
1179
1132
  # Whether both My Drive and shared drive items should be included in results.
1180
1133
  # @param [String] include_labels
1181
- # A comma-separated list of IDs of labels to include in the labelInfo part of
1134
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
1182
1135
  # the response.
1183
1136
  # @param [String] include_permissions_for_view
1184
1137
  # Specifies which additional view's permissions to include in the response. Only
1185
1138
  # 'published' is supported.
1186
1139
  # @param [Boolean] include_team_drive_items
1187
- # Deprecated use includeItemsFromAllDrives instead.
1140
+ # Deprecated: Use `includeItemsFromAllDrives` instead.
1188
1141
  # @param [String] order_by
1189
1142
  # A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', '
1190
1143
  # modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', '
1191
1144
  # recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts
1192
- # ascending by default, but may be reversed with the 'desc' modifier. Example
1193
- # usage: ?orderBy=folder,modifiedTime desc,name. Please note that there is a
1194
- # current limitation for users with approximately one million files in which the
1195
- # requested sort order is ignored.
1145
+ # ascending by default, but can be reversed with the 'desc' modifier. Example
1146
+ # usage: ?orderBy=folder,modifiedTime desc,name.
1196
1147
  # @param [Fixnum] page_size
1197
1148
  # The maximum number of files to return per page. Partial or empty result pages
1198
1149
  # are possible even before the end of the files list has been reached.
@@ -1200,24 +1151,22 @@ module Google
1200
1151
  # The token for continuing a previous list request on the next page. This should
1201
1152
  # be set to the value of 'nextPageToken' from the previous response.
1202
1153
  # @param [String] q
1203
- # A query for filtering the file results. See the "Search for Files" guide for
1204
- # supported syntax.
1154
+ # A query for filtering the file results. See the "Search for files & folders"
1155
+ # guide for supported syntax.
1205
1156
  # @param [String] spaces
1206
- # A comma-separated list of spaces to query within the corpus. Supported values
1157
+ # A comma-separated list of spaces to query within the corpora. Supported values
1207
1158
  # are 'drive' and 'appDataFolder'.
1208
1159
  # @param [Boolean] supports_all_drives
1209
1160
  # Whether the requesting application supports both My Drives and shared drives.
1210
1161
  # @param [Boolean] supports_team_drives
1211
- # Deprecated use supportsAllDrives instead.
1162
+ # Deprecated: Use `supportsAllDrives` instead.
1212
1163
  # @param [String] team_drive_id
1213
- # Deprecated use driveId instead.
1164
+ # Deprecated: Use `driveId` instead.
1214
1165
  # @param [String] fields
1215
1166
  # Selector specifying which fields to include in a partial response.
1216
1167
  # @param [String] quota_user
1217
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1218
- # characters.
1219
- # @param [String] user_ip
1220
- # Deprecated. Please use quotaUser instead.
1168
+ # Available to use for quota purposes for server-side applications. Can be any
1169
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1221
1170
  # @param [Google::Apis::RequestOptions] options
1222
1171
  # Request-specific options
1223
1172
  #
@@ -1230,7 +1179,7 @@ module Google
1230
1179
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1231
1180
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1232
1181
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1233
- def list_files(corpora: nil, corpus: nil, drive_id: nil, include_items_from_all_drives: nil, include_labels: nil, include_permissions_for_view: nil, include_team_drive_items: nil, order_by: nil, page_size: nil, page_token: nil, q: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1182
+ def list_files(corpora: nil, corpus: nil, drive_id: nil, include_items_from_all_drives: nil, include_labels: nil, include_permissions_for_view: nil, include_team_drive_items: nil, order_by: nil, page_size: nil, page_token: nil, q: nil, spaces: nil, supports_all_drives: nil, supports_team_drives: nil, team_drive_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1234
1183
  command = make_simple_command(:get, 'files', options)
1235
1184
  command.response_representation = Google::Apis::DriveV3::FileList::Representation
1236
1185
  command.response_class = Google::Apis::DriveV3::FileList
@@ -1251,26 +1200,22 @@ module Google
1251
1200
  command.query['teamDriveId'] = team_drive_id unless team_drive_id.nil?
1252
1201
  command.query['fields'] = fields unless fields.nil?
1253
1202
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1254
- command.query['userIp'] = user_ip unless user_ip.nil?
1255
1203
  execute_or_queue_command(command, &block)
1256
1204
  end
1257
1205
 
1258
1206
  # Lists the labels on a file.
1259
1207
  # @param [String] file_id
1260
- # The ID of the file.
1208
+ # The ID for the file.
1261
1209
  # @param [Fixnum] max_results
1262
- # The maximum number of labels to return per page. When not set, this defaults
1263
- # to 100.
1210
+ # The maximum number of labels to return per page. When not set, defaults to 100.
1264
1211
  # @param [String] page_token
1265
1212
  # The token for continuing a previous list request on the next page. This should
1266
1213
  # be set to the value of 'nextPageToken' from the previous response.
1267
1214
  # @param [String] fields
1268
1215
  # Selector specifying which fields to include in a partial response.
1269
1216
  # @param [String] quota_user
1270
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1271
- # characters.
1272
- # @param [String] user_ip
1273
- # Deprecated. Please use quotaUser instead.
1217
+ # Available to use for quota purposes for server-side applications. Can be any
1218
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1274
1219
  # @param [Google::Apis::RequestOptions] options
1275
1220
  # Request-specific options
1276
1221
  #
@@ -1283,7 +1228,7 @@ module Google
1283
1228
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1284
1229
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1285
1230
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1286
- def list_file_labels(file_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1231
+ def list_file_labels(file_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1287
1232
  command = make_simple_command(:get, 'files/{fileId}/listLabels', options)
1288
1233
  command.response_representation = Google::Apis::DriveV3::LabelList::Representation
1289
1234
  command.response_class = Google::Apis::DriveV3::LabelList
@@ -1292,21 +1237,19 @@ module Google
1292
1237
  command.query['pageToken'] = page_token unless page_token.nil?
1293
1238
  command.query['fields'] = fields unless fields.nil?
1294
1239
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1295
- command.query['userIp'] = user_ip unless user_ip.nil?
1296
1240
  execute_or_queue_command(command, &block)
1297
1241
  end
1298
1242
 
1299
- # Modifies the set of labels on a file.
1243
+ # Modifies the set of labels applied to a file. Returns a list of the labels
1244
+ # that were added or modified.
1300
1245
  # @param [String] file_id
1301
- # The ID of the file for which the labels are modified.
1246
+ # The ID of the file to which the labels belong.
1302
1247
  # @param [Google::Apis::DriveV3::ModifyLabelsRequest] modify_labels_request_object
1303
1248
  # @param [String] fields
1304
1249
  # Selector specifying which fields to include in a partial response.
1305
1250
  # @param [String] quota_user
1306
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1307
- # characters.
1308
- # @param [String] user_ip
1309
- # Deprecated. Please use quotaUser instead.
1251
+ # Available to use for quota purposes for server-side applications. Can be any
1252
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1310
1253
  # @param [Google::Apis::RequestOptions] options
1311
1254
  # Request-specific options
1312
1255
  #
@@ -1319,7 +1262,7 @@ module Google
1319
1262
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1320
1263
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1321
1264
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1322
- def modify_file_labels(file_id, modify_labels_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1265
+ def modify_file_labels(file_id, modify_labels_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1323
1266
  command = make_simple_command(:post, 'files/{fileId}/modifyLabels', options)
1324
1267
  command.request_representation = Google::Apis::DriveV3::ModifyLabelsRequest::Representation
1325
1268
  command.request_object = modify_labels_request_object
@@ -1328,24 +1271,28 @@ module Google
1328
1271
  command.params['fileId'] = file_id unless file_id.nil?
1329
1272
  command.query['fields'] = fields unless fields.nil?
1330
1273
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1331
- command.query['userIp'] = user_ip unless user_ip.nil?
1332
1274
  execute_or_queue_command(command, &block)
1333
1275
  end
1334
1276
 
1335
1277
  # Updates a file's metadata and/or content. When calling this method, only
1336
1278
  # populate fields in the request that you want to modify. When updating fields,
1337
- # some fields might change automatically, such as modifiedDate. This method
1338
- # supports patch semantics.
1279
+ # some fields might be changed automatically, such as `modifiedDate`. This
1280
+ # method supports patch semantics. This method supports an */upload* URI and
1281
+ # accepts uploaded media with the following characteristics: - *Maximum file
1282
+ # size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME
1283
+ # type, rather than the literal `*/*` value. The literal `*/*` is only used to
1284
+ # indicate that any valid MIME type can be uploaded. For more information on
1285
+ # uploading files, see [Upload file data](/drive/api/guides/manage-uploads).
1339
1286
  # @param [String] file_id
1340
1287
  # The ID of the file.
1341
1288
  # @param [Google::Apis::DriveV3::File] file_object
1342
1289
  # @param [String] add_parents
1343
1290
  # A comma-separated list of parent IDs to add.
1344
1291
  # @param [Boolean] enforce_single_parent
1345
- # Deprecated. Adding files to multiple folders is no longer supported. Use
1292
+ # Deprecated: Adding files to multiple folders is no longer supported. Use
1346
1293
  # shortcuts instead.
1347
1294
  # @param [String] include_labels
1348
- # A comma-separated list of IDs of labels to include in the labelInfo part of
1295
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
1349
1296
  # the response.
1350
1297
  # @param [String] include_permissions_for_view
1351
1298
  # Specifies which additional view's permissions to include in the response. Only
@@ -1362,16 +1309,14 @@ module Google
1362
1309
  # @param [Boolean] supports_all_drives
1363
1310
  # Whether the requesting application supports both My Drives and shared drives.
1364
1311
  # @param [Boolean] supports_team_drives
1365
- # Deprecated use supportsAllDrives instead.
1312
+ # Deprecated: Use `supportsAllDrives` instead.
1366
1313
  # @param [Boolean] use_content_as_indexable_text
1367
1314
  # Whether to use the uploaded content as indexable text.
1368
1315
  # @param [String] fields
1369
1316
  # Selector specifying which fields to include in a partial response.
1370
1317
  # @param [String] quota_user
1371
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1372
- # characters.
1373
- # @param [String] user_ip
1374
- # Deprecated. Please use quotaUser instead.
1318
+ # Available to use for quota purposes for server-side applications. Can be any
1319
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1375
1320
  # @param [IO, String] upload_source
1376
1321
  # IO stream or filename containing content to upload
1377
1322
  # @param [String] content_type
@@ -1388,7 +1333,7 @@ module Google
1388
1333
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1389
1334
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1390
1335
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1391
- def update_file(file_id, file_object = nil, add_parents: nil, enforce_single_parent: nil, include_labels: nil, include_permissions_for_view: nil, keep_revision_forever: nil, ocr_language: nil, remove_parents: nil, supports_all_drives: nil, supports_team_drives: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
1336
+ def update_file(file_id, file_object = nil, add_parents: nil, enforce_single_parent: nil, include_labels: nil, include_permissions_for_view: nil, keep_revision_forever: nil, ocr_language: nil, remove_parents: nil, supports_all_drives: nil, supports_team_drives: nil, use_content_as_indexable_text: nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
1392
1337
  if upload_source.nil?
1393
1338
  command = make_simple_command(:patch, 'files/{fileId}', options)
1394
1339
  else
@@ -1413,13 +1358,10 @@ module Google
1413
1358
  command.query['useContentAsIndexableText'] = use_content_as_indexable_text unless use_content_as_indexable_text.nil?
1414
1359
  command.query['fields'] = fields unless fields.nil?
1415
1360
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1416
- command.query['userIp'] = user_ip unless user_ip.nil?
1417
1361
  execute_or_queue_command(command, &block)
1418
1362
  end
1419
1363
 
1420
- # Subscribes to changes to a file. While you can establish a channel for changes
1421
- # to a file on a shared drive, a change to a shared drive file won't create a
1422
- # notification.
1364
+ # Subscribes to changes to a file.
1423
1365
  # @param [String] file_id
1424
1366
  # The ID of the file.
1425
1367
  # @param [Google::Apis::DriveV3::Channel] channel_object
@@ -1427,7 +1369,7 @@ module Google
1427
1369
  # Whether the user is acknowledging the risk of downloading known malware or
1428
1370
  # other abusive files. This is only applicable when alt=media.
1429
1371
  # @param [String] include_labels
1430
- # A comma-separated list of IDs of labels to include in the labelInfo part of
1372
+ # A comma-separated list of IDs of labels to include in the `labelInfo` part of
1431
1373
  # the response.
1432
1374
  # @param [String] include_permissions_for_view
1433
1375
  # Specifies which additional view's permissions to include in the response. Only
@@ -1435,16 +1377,12 @@ module Google
1435
1377
  # @param [Boolean] supports_all_drives
1436
1378
  # Whether the requesting application supports both My Drives and shared drives.
1437
1379
  # @param [Boolean] supports_team_drives
1438
- # Deprecated use supportsAllDrives instead.
1380
+ # Deprecated: Use `supportsAllDrives` instead.
1439
1381
  # @param [String] fields
1440
1382
  # Selector specifying which fields to include in a partial response.
1441
1383
  # @param [String] quota_user
1442
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1443
- # characters.
1444
- # @param [String] user_ip
1445
- # Deprecated. Please use quotaUser instead.
1446
- # @param [IO, String] download_dest
1447
- # IO stream or filename to receive content download
1384
+ # Available to use for quota purposes for server-side applications. Can be any
1385
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1448
1386
  # @param [Google::Apis::RequestOptions] options
1449
1387
  # Request-specific options
1450
1388
  #
@@ -1457,13 +1395,8 @@ module Google
1457
1395
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1458
1396
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1459
1397
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1460
- def watch_file(file_id, channel_object = nil, acknowledge_abuse: nil, include_labels: nil, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
1461
- if download_dest.nil?
1462
- command = make_simple_command(:post, 'files/{fileId}/watch', options)
1463
- else
1464
- command = make_download_command(:post, 'files/{fileId}/watch', options)
1465
- command.download_dest = download_dest
1466
- end
1398
+ def watch_file(file_id, channel_object = nil, acknowledge_abuse: nil, include_labels: nil, include_permissions_for_view: nil, supports_all_drives: nil, supports_team_drives: nil, fields: nil, quota_user: nil, options: nil, &block)
1399
+ command = make_simple_command(:post, 'files/{fileId}/watch', options)
1467
1400
  command.request_representation = Google::Apis::DriveV3::Channel::Representation
1468
1401
  command.request_object = channel_object
1469
1402
  command.response_representation = Google::Apis::DriveV3::Channel::Representation
@@ -1476,23 +1409,24 @@ module Google
1476
1409
  command.query['supportsTeamDrives'] = supports_team_drives unless supports_team_drives.nil?
1477
1410
  command.query['fields'] = fields unless fields.nil?
1478
1411
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1479
- command.query['userIp'] = user_ip unless user_ip.nil?
1480
1412
  execute_or_queue_command(command, &block)
1481
1413
  end
1482
1414
 
1483
- # Creates a permission for a file or shared drive.
1415
+ # Creates a permission for a file or shared drive. **Warning:** Concurrent
1416
+ # permissions operations on the same file are not supported; only the last
1417
+ # update is applied.
1484
1418
  # @param [String] file_id
1485
1419
  # The ID of the file or shared drive.
1486
1420
  # @param [Google::Apis::DriveV3::Permission] permission_object
1487
1421
  # @param [String] email_message
1488
1422
  # A plain text custom message to include in the notification email.
1489
1423
  # @param [Boolean] enforce_single_parent
1490
- # Deprecated. See moveToNewOwnersRoot for details.
1424
+ # Deprecated: See `moveToNewOwnersRoot` for details.
1491
1425
  # @param [Boolean] move_to_new_owners_root
1492
1426
  # This parameter will only take effect if the item is not in a shared drive and
1493
- # the request is attempting to transfer the ownership of the item. If set to
1494
- # true, the item will be moved to the new owner's My Drive root folder and all
1495
- # prior parents removed. If set to false, parents are not changed.
1427
+ # the request is attempting to transfer the ownership of the item. If set to `
1428
+ # true`, the item will be moved to the new owner's My Drive root folder and all
1429
+ # prior parents removed. If set to `false`, parents are not changed.
1496
1430
  # @param [Boolean] send_notification_email
1497
1431
  # Whether to send a notification email when sharing to users or groups. This
1498
1432
  # defaults to true for users and groups, and is not allowed for other requests.
@@ -1500,15 +1434,11 @@ module Google
1500
1434
  # @param [Boolean] supports_all_drives
1501
1435
  # Whether the requesting application supports both My Drives and shared drives.
1502
1436
  # @param [Boolean] supports_team_drives
1503
- # Deprecated use supportsAllDrives instead.
1437
+ # Deprecated: Use `supportsAllDrives` instead.
1504
1438
  # @param [Boolean] transfer_ownership
1505
1439
  # Whether to transfer ownership to the specified user and downgrade the current
1506
1440
  # owner to a writer. This parameter is required as an acknowledgement of the
1507
- # side effect. File owners can only transfer ownership of files existing on My
1508
- # Drive. Files existing in a shared drive are owned by the organization that
1509
- # owns that shared drive. Ownership transfers are not supported for files and
1510
- # folders in shared drives. Organizers of a shared drive can move items from
1511
- # that shared drive into their My Drive which transfers the ownership to them.
1441
+ # side effect.
1512
1442
  # @param [Boolean] use_domain_admin_access
1513
1443
  # Issue the request as a domain administrator; if set to true, then the
1514
1444
  # requester will be granted access if the file ID parameter refers to a shared
@@ -1517,10 +1447,8 @@ module Google
1517
1447
  # @param [String] fields
1518
1448
  # Selector specifying which fields to include in a partial response.
1519
1449
  # @param [String] quota_user
1520
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1521
- # characters.
1522
- # @param [String] user_ip
1523
- # Deprecated. Please use quotaUser instead.
1450
+ # Available to use for quota purposes for server-side applications. Can be any
1451
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1524
1452
  # @param [Google::Apis::RequestOptions] options
1525
1453
  # Request-specific options
1526
1454
  #
@@ -1533,7 +1461,7 @@ module Google
1533
1461
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1534
1462
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1535
1463
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1536
- def create_permission(file_id, permission_object = nil, email_message: nil, enforce_single_parent: nil, move_to_new_owners_root: nil, send_notification_email: nil, supports_all_drives: nil, supports_team_drives: nil, transfer_ownership: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1464
+ def create_permission(file_id, permission_object = nil, email_message: nil, enforce_single_parent: nil, move_to_new_owners_root: nil, send_notification_email: nil, supports_all_drives: nil, supports_team_drives: nil, transfer_ownership: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
1537
1465
  command = make_simple_command(:post, 'files/{fileId}/permissions', options)
1538
1466
  command.request_representation = Google::Apis::DriveV3::Permission::Representation
1539
1467
  command.request_object = permission_object
@@ -1550,11 +1478,11 @@ module Google
1550
1478
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
1551
1479
  command.query['fields'] = fields unless fields.nil?
1552
1480
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1553
- command.query['userIp'] = user_ip unless user_ip.nil?
1554
1481
  execute_or_queue_command(command, &block)
1555
1482
  end
1556
1483
 
1557
- # Deletes a permission.
1484
+ # Deletes a permission. **Warning:** Concurrent permissions operations on the
1485
+ # same file are not supported; only the last update is applied.
1558
1486
  # @param [String] file_id
1559
1487
  # The ID of the file or shared drive.
1560
1488
  # @param [String] permission_id
@@ -1562,7 +1490,7 @@ module Google
1562
1490
  # @param [Boolean] supports_all_drives
1563
1491
  # Whether the requesting application supports both My Drives and shared drives.
1564
1492
  # @param [Boolean] supports_team_drives
1565
- # Deprecated use supportsAllDrives instead.
1493
+ # Deprecated: Use `supportsAllDrives` instead.
1566
1494
  # @param [Boolean] use_domain_admin_access
1567
1495
  # Issue the request as a domain administrator; if set to true, then the
1568
1496
  # requester will be granted access if the file ID parameter refers to a shared
@@ -1571,10 +1499,8 @@ module Google
1571
1499
  # @param [String] fields
1572
1500
  # Selector specifying which fields to include in a partial response.
1573
1501
  # @param [String] quota_user
1574
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1575
- # characters.
1576
- # @param [String] user_ip
1577
- # Deprecated. Please use quotaUser instead.
1502
+ # Available to use for quota purposes for server-side applications. Can be any
1503
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1578
1504
  # @param [Google::Apis::RequestOptions] options
1579
1505
  # Request-specific options
1580
1506
  #
@@ -1587,7 +1513,7 @@ module Google
1587
1513
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1588
1514
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1589
1515
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1590
- def delete_permission(file_id, permission_id, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1516
+ def delete_permission(file_id, permission_id, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
1591
1517
  command = make_simple_command(:delete, 'files/{fileId}/permissions/{permissionId}', options)
1592
1518
  command.params['fileId'] = file_id unless file_id.nil?
1593
1519
  command.params['permissionId'] = permission_id unless permission_id.nil?
@@ -1596,7 +1522,6 @@ module Google
1596
1522
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
1597
1523
  command.query['fields'] = fields unless fields.nil?
1598
1524
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1599
- command.query['userIp'] = user_ip unless user_ip.nil?
1600
1525
  execute_or_queue_command(command, &block)
1601
1526
  end
1602
1527
 
@@ -1608,7 +1533,7 @@ module Google
1608
1533
  # @param [Boolean] supports_all_drives
1609
1534
  # Whether the requesting application supports both My Drives and shared drives.
1610
1535
  # @param [Boolean] supports_team_drives
1611
- # Deprecated use supportsAllDrives instead.
1536
+ # Deprecated: Use `supportsAllDrives` instead.
1612
1537
  # @param [Boolean] use_domain_admin_access
1613
1538
  # Issue the request as a domain administrator; if set to true, then the
1614
1539
  # requester will be granted access if the file ID parameter refers to a shared
@@ -1617,10 +1542,8 @@ module Google
1617
1542
  # @param [String] fields
1618
1543
  # Selector specifying which fields to include in a partial response.
1619
1544
  # @param [String] quota_user
1620
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1621
- # characters.
1622
- # @param [String] user_ip
1623
- # Deprecated. Please use quotaUser instead.
1545
+ # Available to use for quota purposes for server-side applications. Can be any
1546
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1624
1547
  # @param [Google::Apis::RequestOptions] options
1625
1548
  # Request-specific options
1626
1549
  #
@@ -1633,7 +1556,7 @@ module Google
1633
1556
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1634
1557
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1635
1558
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1636
- def get_permission(file_id, permission_id, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1559
+ def get_permission(file_id, permission_id, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
1637
1560
  command = make_simple_command(:get, 'files/{fileId}/permissions/{permissionId}', options)
1638
1561
  command.response_representation = Google::Apis::DriveV3::Permission::Representation
1639
1562
  command.response_class = Google::Apis::DriveV3::Permission
@@ -1644,7 +1567,6 @@ module Google
1644
1567
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
1645
1568
  command.query['fields'] = fields unless fields.nil?
1646
1569
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1647
- command.query['userIp'] = user_ip unless user_ip.nil?
1648
1570
  execute_or_queue_command(command, &block)
1649
1571
  end
1650
1572
 
@@ -1664,7 +1586,7 @@ module Google
1664
1586
  # @param [Boolean] supports_all_drives
1665
1587
  # Whether the requesting application supports both My Drives and shared drives.
1666
1588
  # @param [Boolean] supports_team_drives
1667
- # Deprecated use supportsAllDrives instead.
1589
+ # Deprecated: Use `supportsAllDrives` instead.
1668
1590
  # @param [Boolean] use_domain_admin_access
1669
1591
  # Issue the request as a domain administrator; if set to true, then the
1670
1592
  # requester will be granted access if the file ID parameter refers to a shared
@@ -1673,10 +1595,8 @@ module Google
1673
1595
  # @param [String] fields
1674
1596
  # Selector specifying which fields to include in a partial response.
1675
1597
  # @param [String] quota_user
1676
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1677
- # characters.
1678
- # @param [String] user_ip
1679
- # Deprecated. Please use quotaUser instead.
1598
+ # Available to use for quota purposes for server-side applications. Can be any
1599
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1680
1600
  # @param [Google::Apis::RequestOptions] options
1681
1601
  # Request-specific options
1682
1602
  #
@@ -1689,7 +1609,7 @@ module Google
1689
1609
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1690
1610
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1691
1611
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1692
- def list_permissions(file_id, include_permissions_for_view: nil, page_size: nil, page_token: nil, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1612
+ def list_permissions(file_id, include_permissions_for_view: nil, page_size: nil, page_token: nil, supports_all_drives: nil, supports_team_drives: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
1693
1613
  command = make_simple_command(:get, 'files/{fileId}/permissions', options)
1694
1614
  command.response_representation = Google::Apis::DriveV3::PermissionList::Representation
1695
1615
  command.response_class = Google::Apis::DriveV3::PermissionList
@@ -1702,11 +1622,11 @@ module Google
1702
1622
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
1703
1623
  command.query['fields'] = fields unless fields.nil?
1704
1624
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1705
- command.query['userIp'] = user_ip unless user_ip.nil?
1706
1625
  execute_or_queue_command(command, &block)
1707
1626
  end
1708
1627
 
1709
- # Updates a permission with patch semantics.
1628
+ # Updates a permission with patch semantics. **Warning:** Concurrent permissions
1629
+ # operations on the same file are not supported; only the last update is applied.
1710
1630
  # @param [String] file_id
1711
1631
  # The ID of the file or shared drive.
1712
1632
  # @param [String] permission_id
@@ -1717,15 +1637,11 @@ module Google
1717
1637
  # @param [Boolean] supports_all_drives
1718
1638
  # Whether the requesting application supports both My Drives and shared drives.
1719
1639
  # @param [Boolean] supports_team_drives
1720
- # Deprecated use supportsAllDrives instead.
1640
+ # Deprecated: Use `supportsAllDrives` instead.
1721
1641
  # @param [Boolean] transfer_ownership
1722
1642
  # Whether to transfer ownership to the specified user and downgrade the current
1723
1643
  # owner to a writer. This parameter is required as an acknowledgement of the
1724
- # side effect. File owners can only transfer ownership of files existing on My
1725
- # Drive. Files existing in a shared drive are owned by the organization that
1726
- # owns that shared drive. Ownership transfers are not supported for files and
1727
- # folders in shared drives. Organizers of a shared drive can move items from
1728
- # that shared drive into their My Drive which transfers the ownership to them.
1644
+ # side effect.
1729
1645
  # @param [Boolean] use_domain_admin_access
1730
1646
  # Issue the request as a domain administrator; if set to true, then the
1731
1647
  # requester will be granted access if the file ID parameter refers to a shared
@@ -1734,10 +1650,8 @@ module Google
1734
1650
  # @param [String] fields
1735
1651
  # Selector specifying which fields to include in a partial response.
1736
1652
  # @param [String] quota_user
1737
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1738
- # characters.
1739
- # @param [String] user_ip
1740
- # Deprecated. Please use quotaUser instead.
1653
+ # Available to use for quota purposes for server-side applications. Can be any
1654
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1741
1655
  # @param [Google::Apis::RequestOptions] options
1742
1656
  # Request-specific options
1743
1657
  #
@@ -1750,7 +1664,7 @@ module Google
1750
1664
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1751
1665
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1752
1666
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1753
- def update_permission(file_id, permission_id, permission_object = nil, remove_expiration: nil, supports_all_drives: nil, supports_team_drives: nil, transfer_ownership: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1667
+ def update_permission(file_id, permission_id, permission_object = nil, remove_expiration: nil, supports_all_drives: nil, supports_team_drives: nil, transfer_ownership: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
1754
1668
  command = make_simple_command(:patch, 'files/{fileId}/permissions/{permissionId}', options)
1755
1669
  command.request_representation = Google::Apis::DriveV3::Permission::Representation
1756
1670
  command.request_object = permission_object
@@ -1765,11 +1679,10 @@ module Google
1765
1679
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
1766
1680
  command.query['fields'] = fields unless fields.nil?
1767
1681
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1768
- command.query['userIp'] = user_ip unless user_ip.nil?
1769
1682
  execute_or_queue_command(command, &block)
1770
1683
  end
1771
1684
 
1772
- # Creates a new reply to a comment.
1685
+ # Creates a reply to a comment.
1773
1686
  # @param [String] file_id
1774
1687
  # The ID of the file.
1775
1688
  # @param [String] comment_id
@@ -1778,10 +1691,8 @@ module Google
1778
1691
  # @param [String] fields
1779
1692
  # Selector specifying which fields to include in a partial response.
1780
1693
  # @param [String] quota_user
1781
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1782
- # characters.
1783
- # @param [String] user_ip
1784
- # Deprecated. Please use quotaUser instead.
1694
+ # Available to use for quota purposes for server-side applications. Can be any
1695
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1785
1696
  # @param [Google::Apis::RequestOptions] options
1786
1697
  # Request-specific options
1787
1698
  #
@@ -1794,7 +1705,7 @@ module Google
1794
1705
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1795
1706
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1796
1707
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1797
- def create_reply(file_id, comment_id, reply_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1708
+ def create_reply(file_id, comment_id, reply_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1798
1709
  command = make_simple_command(:post, 'files/{fileId}/comments/{commentId}/replies', options)
1799
1710
  command.request_representation = Google::Apis::DriveV3::Reply::Representation
1800
1711
  command.request_object = reply_object
@@ -1804,7 +1715,6 @@ module Google
1804
1715
  command.params['commentId'] = comment_id unless comment_id.nil?
1805
1716
  command.query['fields'] = fields unless fields.nil?
1806
1717
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1807
- command.query['userIp'] = user_ip unless user_ip.nil?
1808
1718
  execute_or_queue_command(command, &block)
1809
1719
  end
1810
1720
 
@@ -1818,10 +1728,8 @@ module Google
1818
1728
  # @param [String] fields
1819
1729
  # Selector specifying which fields to include in a partial response.
1820
1730
  # @param [String] quota_user
1821
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1822
- # characters.
1823
- # @param [String] user_ip
1824
- # Deprecated. Please use quotaUser instead.
1731
+ # Available to use for quota purposes for server-side applications. Can be any
1732
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1825
1733
  # @param [Google::Apis::RequestOptions] options
1826
1734
  # Request-specific options
1827
1735
  #
@@ -1834,14 +1742,13 @@ module Google
1834
1742
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1835
1743
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1836
1744
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1837
- def delete_reply(file_id, comment_id, reply_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1745
+ def delete_reply(file_id, comment_id, reply_id, fields: nil, quota_user: nil, options: nil, &block)
1838
1746
  command = make_simple_command(:delete, 'files/{fileId}/comments/{commentId}/replies/{replyId}', options)
1839
1747
  command.params['fileId'] = file_id unless file_id.nil?
1840
1748
  command.params['commentId'] = comment_id unless comment_id.nil?
1841
1749
  command.params['replyId'] = reply_id unless reply_id.nil?
1842
1750
  command.query['fields'] = fields unless fields.nil?
1843
1751
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1844
- command.query['userIp'] = user_ip unless user_ip.nil?
1845
1752
  execute_or_queue_command(command, &block)
1846
1753
  end
1847
1754
 
@@ -1858,10 +1765,8 @@ module Google
1858
1765
  # @param [String] fields
1859
1766
  # Selector specifying which fields to include in a partial response.
1860
1767
  # @param [String] quota_user
1861
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1862
- # characters.
1863
- # @param [String] user_ip
1864
- # Deprecated. Please use quotaUser instead.
1768
+ # Available to use for quota purposes for server-side applications. Can be any
1769
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1865
1770
  # @param [Google::Apis::RequestOptions] options
1866
1771
  # Request-specific options
1867
1772
  #
@@ -1874,7 +1779,7 @@ module Google
1874
1779
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1875
1780
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1876
1781
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1877
- def get_reply(file_id, comment_id, reply_id, include_deleted: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1782
+ def get_reply(file_id, comment_id, reply_id, include_deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
1878
1783
  command = make_simple_command(:get, 'files/{fileId}/comments/{commentId}/replies/{replyId}', options)
1879
1784
  command.response_representation = Google::Apis::DriveV3::Reply::Representation
1880
1785
  command.response_class = Google::Apis::DriveV3::Reply
@@ -1884,7 +1789,6 @@ module Google
1884
1789
  command.query['includeDeleted'] = include_deleted unless include_deleted.nil?
1885
1790
  command.query['fields'] = fields unless fields.nil?
1886
1791
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1887
- command.query['userIp'] = user_ip unless user_ip.nil?
1888
1792
  execute_or_queue_command(command, &block)
1889
1793
  end
1890
1794
 
@@ -1904,10 +1808,8 @@ module Google
1904
1808
  # @param [String] fields
1905
1809
  # Selector specifying which fields to include in a partial response.
1906
1810
  # @param [String] quota_user
1907
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1908
- # characters.
1909
- # @param [String] user_ip
1910
- # Deprecated. Please use quotaUser instead.
1811
+ # Available to use for quota purposes for server-side applications. Can be any
1812
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1911
1813
  # @param [Google::Apis::RequestOptions] options
1912
1814
  # Request-specific options
1913
1815
  #
@@ -1920,7 +1822,7 @@ module Google
1920
1822
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1921
1823
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1922
1824
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1923
- def list_replies(file_id, comment_id, include_deleted: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1825
+ def list_replies(file_id, comment_id, include_deleted: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1924
1826
  command = make_simple_command(:get, 'files/{fileId}/comments/{commentId}/replies', options)
1925
1827
  command.response_representation = Google::Apis::DriveV3::ReplyList::Representation
1926
1828
  command.response_class = Google::Apis::DriveV3::ReplyList
@@ -1931,7 +1833,6 @@ module Google
1931
1833
  command.query['pageToken'] = page_token unless page_token.nil?
1932
1834
  command.query['fields'] = fields unless fields.nil?
1933
1835
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1934
- command.query['userIp'] = user_ip unless user_ip.nil?
1935
1836
  execute_or_queue_command(command, &block)
1936
1837
  end
1937
1838
 
@@ -1946,10 +1847,8 @@ module Google
1946
1847
  # @param [String] fields
1947
1848
  # Selector specifying which fields to include in a partial response.
1948
1849
  # @param [String] quota_user
1949
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1950
- # characters.
1951
- # @param [String] user_ip
1952
- # Deprecated. Please use quotaUser instead.
1850
+ # Available to use for quota purposes for server-side applications. Can be any
1851
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1953
1852
  # @param [Google::Apis::RequestOptions] options
1954
1853
  # Request-specific options
1955
1854
  #
@@ -1962,7 +1861,7 @@ module Google
1962
1861
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1963
1862
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1964
1863
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1965
- def update_reply(file_id, comment_id, reply_id, reply_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1864
+ def update_reply(file_id, comment_id, reply_id, reply_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1966
1865
  command = make_simple_command(:patch, 'files/{fileId}/comments/{commentId}/replies/{replyId}', options)
1967
1866
  command.request_representation = Google::Apis::DriveV3::Reply::Representation
1968
1867
  command.request_object = reply_object
@@ -1973,7 +1872,6 @@ module Google
1973
1872
  command.params['replyId'] = reply_id unless reply_id.nil?
1974
1873
  command.query['fields'] = fields unless fields.nil?
1975
1874
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1976
- command.query['userIp'] = user_ip unless user_ip.nil?
1977
1875
  execute_or_queue_command(command, &block)
1978
1876
  end
1979
1877
 
@@ -1988,10 +1886,8 @@ module Google
1988
1886
  # @param [String] fields
1989
1887
  # Selector specifying which fields to include in a partial response.
1990
1888
  # @param [String] quota_user
1991
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1992
- # characters.
1993
- # @param [String] user_ip
1994
- # Deprecated. Please use quotaUser instead.
1889
+ # Available to use for quota purposes for server-side applications. Can be any
1890
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1995
1891
  # @param [Google::Apis::RequestOptions] options
1996
1892
  # Request-specific options
1997
1893
  #
@@ -2004,13 +1900,12 @@ module Google
2004
1900
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2005
1901
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2006
1902
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2007
- def delete_revision(file_id, revision_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1903
+ def delete_revision(file_id, revision_id, fields: nil, quota_user: nil, options: nil, &block)
2008
1904
  command = make_simple_command(:delete, 'files/{fileId}/revisions/{revisionId}', options)
2009
1905
  command.params['fileId'] = file_id unless file_id.nil?
2010
1906
  command.params['revisionId'] = revision_id unless revision_id.nil?
2011
1907
  command.query['fields'] = fields unless fields.nil?
2012
1908
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2013
- command.query['userIp'] = user_ip unless user_ip.nil?
2014
1909
  execute_or_queue_command(command, &block)
2015
1910
  end
2016
1911
 
@@ -2025,10 +1920,8 @@ module Google
2025
1920
  # @param [String] fields
2026
1921
  # Selector specifying which fields to include in a partial response.
2027
1922
  # @param [String] quota_user
2028
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2029
- # characters.
2030
- # @param [String] user_ip
2031
- # Deprecated. Please use quotaUser instead.
1923
+ # Available to use for quota purposes for server-side applications. Can be any
1924
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2032
1925
  # @param [IO, String] download_dest
2033
1926
  # IO stream or filename to receive content download
2034
1927
  # @param [Google::Apis::RequestOptions] options
@@ -2043,7 +1936,7 @@ module Google
2043
1936
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2044
1937
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2045
1938
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2046
- def get_revision(file_id, revision_id, acknowledge_abuse: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
1939
+ def get_revision(file_id, revision_id, acknowledge_abuse: nil, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
2047
1940
  if download_dest.nil?
2048
1941
  command = make_simple_command(:get, 'files/{fileId}/revisions/{revisionId}', options)
2049
1942
  else
@@ -2057,7 +1950,6 @@ module Google
2057
1950
  command.query['acknowledgeAbuse'] = acknowledge_abuse unless acknowledge_abuse.nil?
2058
1951
  command.query['fields'] = fields unless fields.nil?
2059
1952
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2060
- command.query['userIp'] = user_ip unless user_ip.nil?
2061
1953
  execute_or_queue_command(command, &block)
2062
1954
  end
2063
1955
 
@@ -2072,10 +1964,8 @@ module Google
2072
1964
  # @param [String] fields
2073
1965
  # Selector specifying which fields to include in a partial response.
2074
1966
  # @param [String] quota_user
2075
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2076
- # characters.
2077
- # @param [String] user_ip
2078
- # Deprecated. Please use quotaUser instead.
1967
+ # Available to use for quota purposes for server-side applications. Can be any
1968
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2079
1969
  # @param [Google::Apis::RequestOptions] options
2080
1970
  # Request-specific options
2081
1971
  #
@@ -2088,7 +1978,7 @@ module Google
2088
1978
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2089
1979
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2090
1980
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2091
- def list_revisions(file_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1981
+ def list_revisions(file_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2092
1982
  command = make_simple_command(:get, 'files/{fileId}/revisions', options)
2093
1983
  command.response_representation = Google::Apis::DriveV3::RevisionList::Representation
2094
1984
  command.response_class = Google::Apis::DriveV3::RevisionList
@@ -2097,7 +1987,6 @@ module Google
2097
1987
  command.query['pageToken'] = page_token unless page_token.nil?
2098
1988
  command.query['fields'] = fields unless fields.nil?
2099
1989
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2100
- command.query['userIp'] = user_ip unless user_ip.nil?
2101
1990
  execute_or_queue_command(command, &block)
2102
1991
  end
2103
1992
 
@@ -2110,10 +1999,8 @@ module Google
2110
1999
  # @param [String] fields
2111
2000
  # Selector specifying which fields to include in a partial response.
2112
2001
  # @param [String] quota_user
2113
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2114
- # characters.
2115
- # @param [String] user_ip
2116
- # Deprecated. Please use quotaUser instead.
2002
+ # Available to use for quota purposes for server-side applications. Can be any
2003
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2117
2004
  # @param [Google::Apis::RequestOptions] options
2118
2005
  # Request-specific options
2119
2006
  #
@@ -2126,7 +2013,7 @@ module Google
2126
2013
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2127
2014
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2128
2015
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2129
- def update_revision(file_id, revision_id, revision_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2016
+ def update_revision(file_id, revision_id, revision_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2130
2017
  command = make_simple_command(:patch, 'files/{fileId}/revisions/{revisionId}', options)
2131
2018
  command.request_representation = Google::Apis::DriveV3::Revision::Representation
2132
2019
  command.request_object = revision_object
@@ -2136,25 +2023,22 @@ module Google
2136
2023
  command.params['revisionId'] = revision_id unless revision_id.nil?
2137
2024
  command.query['fields'] = fields unless fields.nil?
2138
2025
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2139
- command.query['userIp'] = user_ip unless user_ip.nil?
2140
2026
  execute_or_queue_command(command, &block)
2141
2027
  end
2142
2028
 
2143
- # Deprecated use drives.create instead.
2029
+ # Deprecated: Use `drives.create` instead.
2144
2030
  # @param [String] request_id
2145
- # An ID, such as a random UUID, which uniquely identifies this user's request
2146
- # for idempotent creation of a Team Drive. A repeated request by the same user
2147
- # and with the same request ID will avoid creating duplicates by attempting to
2148
- # create the same Team Drive. If the Team Drive already exists a 409 error will
2149
- # be returned.
2031
+ # Required. An ID, such as a random UUID, which uniquely identifies this user's
2032
+ # request for idempotent creation of a Team Drive. A repeated request by the
2033
+ # same user and with the same request ID will avoid creating duplicates by
2034
+ # attempting to create the same Team Drive. If the Team Drive already exists a
2035
+ # 409 error will be returned.
2150
2036
  # @param [Google::Apis::DriveV3::TeamDrive] team_drive_object
2151
2037
  # @param [String] fields
2152
2038
  # Selector specifying which fields to include in a partial response.
2153
2039
  # @param [String] quota_user
2154
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2155
- # characters.
2156
- # @param [String] user_ip
2157
- # Deprecated. Please use quotaUser instead.
2040
+ # Available to use for quota purposes for server-side applications. Can be any
2041
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2158
2042
  # @param [Google::Apis::RequestOptions] options
2159
2043
  # Request-specific options
2160
2044
  #
@@ -2167,7 +2051,7 @@ module Google
2167
2051
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2168
2052
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2169
2053
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2170
- def create_teamdrive(request_id, team_drive_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2054
+ def create_teamdrive(request_id, team_drive_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2171
2055
  command = make_simple_command(:post, 'teamdrives', options)
2172
2056
  command.request_representation = Google::Apis::DriveV3::TeamDrive::Representation
2173
2057
  command.request_object = team_drive_object
@@ -2176,20 +2060,17 @@ module Google
2176
2060
  command.query['requestId'] = request_id unless request_id.nil?
2177
2061
  command.query['fields'] = fields unless fields.nil?
2178
2062
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2179
- command.query['userIp'] = user_ip unless user_ip.nil?
2180
2063
  execute_or_queue_command(command, &block)
2181
2064
  end
2182
2065
 
2183
- # Deprecated use drives.delete instead.
2066
+ # Deprecated: Use `drives.delete` instead.
2184
2067
  # @param [String] team_drive_id
2185
2068
  # The ID of the Team Drive
2186
2069
  # @param [String] fields
2187
2070
  # Selector specifying which fields to include in a partial response.
2188
2071
  # @param [String] quota_user
2189
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2190
- # characters.
2191
- # @param [String] user_ip
2192
- # Deprecated. Please use quotaUser instead.
2072
+ # Available to use for quota purposes for server-side applications. Can be any
2073
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2193
2074
  # @param [Google::Apis::RequestOptions] options
2194
2075
  # Request-specific options
2195
2076
  #
@@ -2202,16 +2083,15 @@ module Google
2202
2083
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2203
2084
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2204
2085
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2205
- def delete_teamdrive(team_drive_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2086
+ def delete_teamdrive(team_drive_id, fields: nil, quota_user: nil, options: nil, &block)
2206
2087
  command = make_simple_command(:delete, 'teamdrives/{teamDriveId}', options)
2207
2088
  command.params['teamDriveId'] = team_drive_id unless team_drive_id.nil?
2208
2089
  command.query['fields'] = fields unless fields.nil?
2209
2090
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2210
- command.query['userIp'] = user_ip unless user_ip.nil?
2211
2091
  execute_or_queue_command(command, &block)
2212
2092
  end
2213
2093
 
2214
- # Deprecated use drives.get instead.
2094
+ # Deprecated: Use `drives.get` instead.
2215
2095
  # @param [String] team_drive_id
2216
2096
  # The ID of the Team Drive
2217
2097
  # @param [Boolean] use_domain_admin_access
@@ -2221,10 +2101,8 @@ module Google
2221
2101
  # @param [String] fields
2222
2102
  # Selector specifying which fields to include in a partial response.
2223
2103
  # @param [String] quota_user
2224
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2225
- # characters.
2226
- # @param [String] user_ip
2227
- # Deprecated. Please use quotaUser instead.
2104
+ # Available to use for quota purposes for server-side applications. Can be any
2105
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2228
2106
  # @param [Google::Apis::RequestOptions] options
2229
2107
  # Request-specific options
2230
2108
  #
@@ -2237,7 +2115,7 @@ module Google
2237
2115
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2238
2116
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2239
2117
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2240
- def get_teamdrive(team_drive_id, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2118
+ def get_teamdrive(team_drive_id, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
2241
2119
  command = make_simple_command(:get, 'teamdrives/{teamDriveId}', options)
2242
2120
  command.response_representation = Google::Apis::DriveV3::TeamDrive::Representation
2243
2121
  command.response_class = Google::Apis::DriveV3::TeamDrive
@@ -2245,11 +2123,10 @@ module Google
2245
2123
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
2246
2124
  command.query['fields'] = fields unless fields.nil?
2247
2125
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2248
- command.query['userIp'] = user_ip unless user_ip.nil?
2249
2126
  execute_or_queue_command(command, &block)
2250
2127
  end
2251
2128
 
2252
- # Deprecated use drives.list instead.
2129
+ # Deprecated: Use `drives.list` instead.
2253
2130
  # @param [Fixnum] page_size
2254
2131
  # Maximum number of Team Drives to return.
2255
2132
  # @param [String] page_token
@@ -2262,10 +2139,8 @@ module Google
2262
2139
  # @param [String] fields
2263
2140
  # Selector specifying which fields to include in a partial response.
2264
2141
  # @param [String] quota_user
2265
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2266
- # characters.
2267
- # @param [String] user_ip
2268
- # Deprecated. Please use quotaUser instead.
2142
+ # Available to use for quota purposes for server-side applications. Can be any
2143
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2269
2144
  # @param [Google::Apis::RequestOptions] options
2270
2145
  # Request-specific options
2271
2146
  #
@@ -2278,7 +2153,7 @@ module Google
2278
2153
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2279
2154
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2280
2155
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2281
- def list_teamdrives(page_size: nil, page_token: nil, q: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2156
+ def list_teamdrives(page_size: nil, page_token: nil, q: nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
2282
2157
  command = make_simple_command(:get, 'teamdrives', options)
2283
2158
  command.response_representation = Google::Apis::DriveV3::TeamDriveList::Representation
2284
2159
  command.response_class = Google::Apis::DriveV3::TeamDriveList
@@ -2288,11 +2163,10 @@ module Google
2288
2163
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
2289
2164
  command.query['fields'] = fields unless fields.nil?
2290
2165
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2291
- command.query['userIp'] = user_ip unless user_ip.nil?
2292
2166
  execute_or_queue_command(command, &block)
2293
2167
  end
2294
2168
 
2295
- # Deprecated use drives.update instead
2169
+ # Deprecated: Use `drives.update` instead.
2296
2170
  # @param [String] team_drive_id
2297
2171
  # The ID of the Team Drive
2298
2172
  # @param [Google::Apis::DriveV3::TeamDrive] team_drive_object
@@ -2303,10 +2177,8 @@ module Google
2303
2177
  # @param [String] fields
2304
2178
  # Selector specifying which fields to include in a partial response.
2305
2179
  # @param [String] quota_user
2306
- # An opaque string that represents a user for quota purposes. Must not exceed 40
2307
- # characters.
2308
- # @param [String] user_ip
2309
- # Deprecated. Please use quotaUser instead.
2180
+ # Available to use for quota purposes for server-side applications. Can be any
2181
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2310
2182
  # @param [Google::Apis::RequestOptions] options
2311
2183
  # Request-specific options
2312
2184
  #
@@ -2319,7 +2191,7 @@ module Google
2319
2191
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2320
2192
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2321
2193
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2322
- def update_teamdrive(team_drive_id, team_drive_object = nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2194
+ def update_teamdrive(team_drive_id, team_drive_object = nil, use_domain_admin_access: nil, fields: nil, quota_user: nil, options: nil, &block)
2323
2195
  command = make_simple_command(:patch, 'teamdrives/{teamDriveId}', options)
2324
2196
  command.request_representation = Google::Apis::DriveV3::TeamDrive::Representation
2325
2197
  command.request_object = team_drive_object
@@ -2329,7 +2201,6 @@ module Google
2329
2201
  command.query['useDomainAdminAccess'] = use_domain_admin_access unless use_domain_admin_access.nil?
2330
2202
  command.query['fields'] = fields unless fields.nil?
2331
2203
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2332
- command.query['userIp'] = user_ip unless user_ip.nil?
2333
2204
  execute_or_queue_command(command, &block)
2334
2205
  end
2335
2206
 
@@ -2338,7 +2209,6 @@ module Google
2338
2209
  def apply_command_defaults(command)
2339
2210
  command.query['key'] = key unless key.nil?
2340
2211
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2341
- command.query['userIp'] = user_ip unless user_ip.nil?
2342
2212
  end
2343
2213
  end
2344
2214
  end