Blame - docs/dyn/drive_v3.permissions.html - platform/external/python/google-api-python-client

2019-06-14 16:50:42 -0700

[diff] [blame]

82

<p class="firstline">Creates a permission for a file or shared drive.</p>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

83

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

84

<code><a href="#delete">delete(fileId, permissionId, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None)</a></code></p>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

85

<p class="firstline">Deletes a permission.</p>

86

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

87

<code><a href="#get">get(fileId, permissionId, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None)</a></code></p>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

88

<p class="firstline">Gets a permission by ID.</p>

89

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

90

<code><a href="#list">list(fileId, includePermissionsForView=None, pageSize=None, pageToken=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None)</a></code></p>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

91

<p class="firstline">Lists a file's or shared drive's permissions.</p>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

92

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

93

<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>

94

<p class="firstline">Retrieves the next page of results.</p>

95

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

96

<code><a href="#update">update(fileId, permissionId, body=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None)</a></code></p>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

97

<p class="firstline">Updates a permission with patch semantics.</p>

98

<h3>Method Details</h3>

99

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

100

<code class="details" id="close">close()</code>

101

<pre>Close httplib2 connections.</pre>

</div>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

105

<code class="details" id="create">create(fileId, body=None, emailMessage=None, enforceSingleParent=None, moveToNewOwnersRoot=None, sendNotificationEmail=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

106

<pre>Creates a permission for a file or shared drive.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

107

108

Args:

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

109

fileId: string, The ID of the file or shared drive. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

110

body: object, The request body.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

111

The object takes the form of:

112

113

{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

114

"allowFileDiscovery": True or False, # Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone.

115

"deleted": True or False, # Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.

116

"displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:

117

# - user - User's full name, as defined for their Google account, such as "Joe Smith."

118

# - group - Name of the Google Group, such as "The Company Administrators."

119

# - domain - String domain name, such as "thecompany.com."

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

120

# - anyone - No displayName is present.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

121

"domain": "A String", # The domain to which this permission refers.

122

"emailAddress": "A String", # The email address of the user or group to which this permission refers.

123

"expirationTime": "A String", # The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

124

# - They can only be set on user and group permissions

125

# - The time must be in the future

126

# - The time cannot be more than a year in the future

127

"id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.

128

"kind": "drive#permission", # Identifies what kind of resource this is. Value: the fixed string "drive#permission".

yoshi-code-bot

2021-11-15 23:24:17 -0800

[diff] [blame]

129

"pendingOwner": True or False, # Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that are not in a shared drive.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

130

"permissionDetails": [ # Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

131

{

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

132

"inherited": True or False, # Whether this permission is inherited. This field is always populated. This is an output-only field.

133

"inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.

134

"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:

135

# - file

136

# - member

137

"role": "A String", # The primary role for this user. While new values may be added in the future, the following are currently possible:

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

143

},

144

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

145

"photoLink": "A String", # A link to the user's profile photo, if available.

146

"role": "A String", # The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

147

# - owner

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

148

# - organizer

149

# - fileOrganizer

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

150

# - writer

151

# - commenter

152

# - reader

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

153

"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.

154

{

155

"inherited": True or False, # Deprecated - use permissionDetails/inherited instead.

156

"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.

157

"role": "A String", # Deprecated - use permissionDetails/role instead.

158

"teamDrivePermissionType": "A String", # Deprecated - use permissionDetails/permissionType instead.

159

},

160

],

161

"type": "A String", # The type of the grantee. Valid values are:

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

162

# - user

163

# - group

164

# - domain

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

165

# - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

166

"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

167

}

168

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

169

emailMessage: string, A plain text custom message to include in the notification email.

Yoshi Automation Bot

c2228be

2020-11-24 15:48:03 -0800

[diff] [blame]

170

enforceSingleParent: boolean, Deprecated. See moveToNewOwnersRoot for details.

171

moveToNewOwnersRoot: boolean, This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to true, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to false, parents are not changed.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

172

sendNotificationEmail: boolean, Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

173

supportsAllDrives: boolean, Whether the requesting application supports both My Drives and shared drives.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

174

supportsTeamDrives: boolean, Deprecated use supportsAllDrives instead.

yoshi-code-bot

1a4514d

2021-07-13 00:20:24 -0700

[diff] [blame]

175

transferOwnership: boolean, Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. File owners can only transfer ownership of files existing on My Drive. Files existing in a shared drive are owned by the organization that owns that shared drive. Ownership transfers are not supported for files and folders in shared drives. Organizers of a shared drive can move items from that shared drive into their My Drive which transfers the ownership to them.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

176

useDomainAdminAccess: boolean, Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

177

178

Returns:

179

An object of the form:

180

181

{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

182

"allowFileDiscovery": True or False, # Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone.

183

"deleted": True or False, # Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.

184

"displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:

185

# - user - User's full name, as defined for their Google account, such as "Joe Smith."

186

# - group - Name of the Google Group, such as "The Company Administrators."

187

# - domain - String domain name, such as "thecompany.com."

188

# - anyone - No displayName is present.

189

"domain": "A String", # The domain to which this permission refers.

190

"emailAddress": "A String", # The email address of the user or group to which this permission refers.

191

"expirationTime": "A String", # The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

192

# - They can only be set on user and group permissions

193

# - The time must be in the future

194

# - The time cannot be more than a year in the future

195

"id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.

196

"kind": "drive#permission", # Identifies what kind of resource this is. Value: the fixed string "drive#permission".

yoshi-code-bot

2021-11-15 23:24:17 -0800

[diff] [blame]

197

"pendingOwner": True or False, # Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that are not in a shared drive.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

198

"permissionDetails": [ # Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.

199

{

200

"inherited": True or False, # Whether this permission is inherited. This field is always populated. This is an output-only field.

201

"inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.

202

"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:

203

# - file

204

# - member

205

"role": "A String", # The primary role for this user. While new values may be added in the future, the following are currently possible:

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

},

],

"photoLink": "A String", # A link to the user's profile photo, if available.

214

"role": "A String", # The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

# - owner

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.

222

{

223

"inherited": True or False, # Deprecated - use permissionDetails/inherited instead.

224

"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.

225

"role": "A String", # Deprecated - use permissionDetails/role instead.

226

"teamDrivePermissionType": "A String", # Deprecated - use permissionDetails/permissionType instead.

227

},

228

],

229

"type": "A String", # The type of the grantee. Valid values are:

# - user

# - group

# - domain

# - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.

234

"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value.

235

}</pre>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

</div>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

239

<code class="details" id="delete">delete(fileId, permissionId, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None)</code>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

240

<pre>Deletes a permission.

241

242

Args:

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

243

fileId: string, The ID of the file or shared drive. (required)

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

244

permissionId: string, The ID of the permission. (required)

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

245

supportsAllDrives: boolean, Whether the requesting application supports both My Drives and shared drives.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

246

supportsTeamDrives: boolean, Deprecated use supportsAllDrives instead.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

247

useDomainAdminAccess: boolean, Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

</pre>

</div>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

252

<code class="details" id="get">get(fileId, permissionId, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None)</code>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

253

<pre>Gets a permission by ID.

254

255

Args:

256

fileId: string, The ID of the file. (required)

257

permissionId: string, The ID of the permission. (required)

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

258

supportsAllDrives: boolean, Whether the requesting application supports both My Drives and shared drives.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

259

supportsTeamDrives: boolean, Deprecated use supportsAllDrives instead.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

260

useDomainAdminAccess: boolean, Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

261

262

Returns:

263

An object of the form:

264

265

{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

266

"allowFileDiscovery": True or False, # Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone.

267

"deleted": True or False, # Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.

268

"displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:

269

# - user - User's full name, as defined for their Google account, such as "Joe Smith."

270

# - group - Name of the Google Group, such as "The Company Administrators."

271

# - domain - String domain name, such as "thecompany.com."

272

# - anyone - No displayName is present.

273

"domain": "A String", # The domain to which this permission refers.

274

"emailAddress": "A String", # The email address of the user or group to which this permission refers.

275

"expirationTime": "A String", # The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

276

# - They can only be set on user and group permissions

277

# - The time must be in the future

278

# - The time cannot be more than a year in the future

279

"id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.

280

"kind": "drive#permission", # Identifies what kind of resource this is. Value: the fixed string "drive#permission".

yoshi-code-bot

2021-11-15 23:24:17 -0800

[diff] [blame]

281

"pendingOwner": True or False, # Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that are not in a shared drive.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

282

"permissionDetails": [ # Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.

283

{

284

"inherited": True or False, # Whether this permission is inherited. This field is always populated. This is an output-only field.

285

"inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.

286

"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:

287

# - file

288

# - member

289

"role": "A String", # The primary role for this user. While new values may be added in the future, the following are currently possible:

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

},

],

"photoLink": "A String", # A link to the user's profile photo, if available.

298

"role": "A String", # The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

# - owner

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.

306

{

307

"inherited": True or False, # Deprecated - use permissionDetails/inherited instead.

308

"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.

309

"role": "A String", # Deprecated - use permissionDetails/role instead.

310

"teamDrivePermissionType": "A String", # Deprecated - use permissionDetails/permissionType instead.

311

},

312

],

313

"type": "A String", # The type of the grantee. Valid values are:

# - user

# - group

# - domain

# - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.

318

"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value.

319

}</pre>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

</div>

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

323

<code class="details" id="list">list(fileId, includePermissionsForView=None, pageSize=None, pageToken=None, supportsAllDrives=None, supportsTeamDrives=None, useDomainAdminAccess=None)</code>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

324

<pre>Lists a file's or shared drive's permissions.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

325

326

Args:

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

327

fileId: string, The ID of the file or shared drive. (required)

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

328

includePermissionsForView: string, Specifies which additional view's permissions to include in the response. Only 'published' is supported.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

329

pageSize: integer, The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

330

pageToken: string, The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

331

supportsAllDrives: boolean, Whether the requesting application supports both My Drives and shared drives.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

332

supportsTeamDrives: boolean, Deprecated use supportsAllDrives instead.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

333

useDomainAdminAccess: boolean, Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

334

335

Returns:

336

An object of the form:

337

338

{ # A list of permissions for a file.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

339

"kind": "drive#permissionList", # Identifies what kind of resource this is. Value: the fixed string "drive#permissionList".

340

"nextPageToken": "A String", # The page token for the next page of permissions. This field will be absent if the end of the permissions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results.

341

"permissions": [ # The list of permissions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.

342

{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

343

"allowFileDiscovery": True or False, # Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone.

344

"deleted": True or False, # Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.

345

"displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:

346

# - user - User's full name, as defined for their Google account, such as "Joe Smith."

347

# - group - Name of the Google Group, such as "The Company Administrators."

348

# - domain - String domain name, such as "thecompany.com."

349

# - anyone - No displayName is present.

350

"domain": "A String", # The domain to which this permission refers.

351

"emailAddress": "A String", # The email address of the user or group to which this permission refers.

352

"expirationTime": "A String", # The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

353

# - They can only be set on user and group permissions

354

# - The time must be in the future

355

# - The time cannot be more than a year in the future

356

"id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.

357

"kind": "drive#permission", # Identifies what kind of resource this is. Value: the fixed string "drive#permission".

yoshi-code-bot

2021-11-15 23:24:17 -0800

[diff] [blame]

358

"pendingOwner": True or False, # Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that are not in a shared drive.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

359

"permissionDetails": [ # Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.

360

{

361

"inherited": True or False, # Whether this permission is inherited. This field is always populated. This is an output-only field.

362

"inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.

363

"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:

364

# - file

365

# - member

366

"role": "A String", # The primary role for this user. While new values may be added in the future, the following are currently possible:

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

},

],

"photoLink": "A String", # A link to the user's profile photo, if available.

375

"role": "A String", # The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

# - owner

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.

383

{

384

"inherited": True or False, # Deprecated - use permissionDetails/inherited instead.

385

"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.

386

"role": "A String", # Deprecated - use permissionDetails/role instead.

387

"teamDrivePermissionType": "A String", # Deprecated - use permissionDetails/permissionType instead.

388

},

389

],

390

"type": "A String", # The type of the grantee. Valid values are:

# - user

# - group

# - domain

# - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.

395

"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value.

396

},

397

],

398

}</pre>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

</div>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

402

<code class="details" id="list_next">list_next(previous_request, previous_response)</code>

403

<pre>Retrieves the next page of results.

404

405

Args:

406

previous_request: The request for the previous page. (required)

407

previous_response: The response from the request for the previous page. (required)

408

409

Returns:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

410

A request object that you can call 'execute()' on to request the next

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

411

page. Returns None if there are no more items in the collection.

</pre>

</div>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

416

<code class="details" id="update">update(fileId, permissionId, body=None, removeExpiration=None, supportsAllDrives=None, supportsTeamDrives=None, transferOwnership=None, useDomainAdminAccess=None)</code>

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

417

<pre>Updates a permission with patch semantics.

418

419

Args:

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

420

fileId: string, The ID of the file or shared drive. (required)

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

421

permissionId: string, The ID of the permission. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

422

body: object, The request body.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

423

The object takes the form of:

424

425

{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

426

"allowFileDiscovery": True or False, # Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone.

427

"deleted": True or False, # Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.

428

"displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:

429

# - user - User's full name, as defined for their Google account, such as "Joe Smith."

430

# - group - Name of the Google Group, such as "The Company Administrators."

431

# - domain - String domain name, such as "thecompany.com."

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

432

# - anyone - No displayName is present.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

433

"domain": "A String", # The domain to which this permission refers.

434

"emailAddress": "A String", # The email address of the user or group to which this permission refers.

435

"expirationTime": "A String", # The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

436

# - They can only be set on user and group permissions

437

# - The time must be in the future

438

# - The time cannot be more than a year in the future

439

"id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.

440

"kind": "drive#permission", # Identifies what kind of resource this is. Value: the fixed string "drive#permission".

yoshi-code-bot

2021-11-15 23:24:17 -0800

[diff] [blame]

441

"pendingOwner": True or False, # Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that are not in a shared drive.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

442

"permissionDetails": [ # Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

443

{

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

444

"inherited": True or False, # Whether this permission is inherited. This field is always populated. This is an output-only field.

445

"inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.

446

"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:

447

# - file

448

# - member

449

"role": "A String", # The primary role for this user. While new values may be added in the future, the following are currently possible:

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

455

},

456

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

457

"photoLink": "A String", # A link to the user's profile photo, if available.

458

"role": "A String", # The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

459

# - owner

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

460

# - organizer

461

# - fileOrganizer

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

462

# - writer

463

# - commenter

464

# - reader

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

465

"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.

466

{

467

"inherited": True or False, # Deprecated - use permissionDetails/inherited instead.

468

"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.

469

"role": "A String", # Deprecated - use permissionDetails/role instead.

470

"teamDrivePermissionType": "A String", # Deprecated - use permissionDetails/permissionType instead.

471

},

472

],

473

"type": "A String", # The type of the grantee. Valid values are:

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

474

# - user

475

# - group

476

# - domain

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

477

# - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

478

"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

479

}

480

Jon Wayne Parrott

7d5badb

2016-08-16 12:44:29 -0700

[diff] [blame]

481

removeExpiration: boolean, Whether to remove the expiration date.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

482

supportsAllDrives: boolean, Whether the requesting application supports both My Drives and shared drives.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

483

supportsTeamDrives: boolean, Deprecated use supportsAllDrives instead.

yoshi-code-bot

1a4514d

2021-07-13 00:20:24 -0700

[diff] [blame]

484

transferOwnership: boolean, Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. File owners can only transfer ownership of files existing on My Drive. Files existing in a shared drive are owned by the organization that owns that shared drive. Ownership transfers are not supported for files and folders in shared drives. Organizers of a shared drive can move items from that shared drive into their My Drive which transfers the ownership to them.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

485

useDomainAdminAccess: boolean, Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Jon Wayne Parrott

2016-02-19 16:02:29 -0800

[diff] [blame]

486

487

Returns:

488

An object of the form:

489

490

{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

491

"allowFileDiscovery": True or False, # Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type domain or anyone.

492

"deleted": True or False, # Whether the account associated with this permission has been deleted. This field only pertains to user and group permissions.

493

"displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:

494

# - user - User's full name, as defined for their Google account, such as "Joe Smith."

495

# - group - Name of the Google Group, such as "The Company Administrators."

496

# - domain - String domain name, such as "thecompany.com."

497

# - anyone - No displayName is present.

498

"domain": "A String", # The domain to which this permission refers.

499

"emailAddress": "A String", # The email address of the user or group to which this permission refers.

500

"expirationTime": "A String", # The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:

501

# - They can only be set on user and group permissions

502

# - The time must be in the future

503

# - The time cannot be more than a year in the future

504

"id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.

505

"kind": "drive#permission", # Identifies what kind of resource this is. Value: the fixed string "drive#permission".

yoshi-code-bot

2021-11-15 23:24:17 -0800

[diff] [blame]

506

"pendingOwner": True or False, # Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that are not in a shared drive.

Yoshi Automation Bot

2021-01-15 07:10:04 -0800

[diff] [blame]

507

"permissionDetails": [ # Details of whether the permissions on this shared drive item are inherited or directly on this item. This is an output-only field which is present only for shared drive items.

508

{

509

"inherited": True or False, # Whether this permission is inherited. This field is always populated. This is an output-only field.

510

"inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.

511

"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:

512

# - file

513

# - member

514

"role": "A String", # The primary role for this user. While new values may be added in the future, the following are currently possible:

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

},

],

"photoLink": "A String", # A link to the user's profile photo, if available.

523

"role": "A String", # The role granted by this permission. While new values may be supported in the future, the following are currently allowed:

# - owner

# - organizer

# - fileOrganizer

# - writer

# - commenter

# - reader

"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.

531

{

532

"inherited": True or False, # Deprecated - use permissionDetails/inherited instead.

533

"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.

534

"role": "A String", # Deprecated - use permissionDetails/role instead.

535

"teamDrivePermissionType": "A String", # Deprecated - use permissionDetails/permissionType instead.

536

},

537

],

538

"type": "A String", # The type of the grantee. Valid values are:

# - user

# - group

# - domain

# - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.

543

"view": "A String", # Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value.

544

}</pre>

Jon Wayne Parrott