@maxim_mazurok/gapi.client.drive-v3 0.0.20230206 → 0.0.20230219

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://www.googleapis.com/discovery/v1/apis/drive/v3/rest
-// Revision: 20230206
+// Revision: 20230219
 
 /// <reference types="gapi.client" />
 
@@ -227,6 +227,8 @@ declare namespace gapi.client {
                 canChangeDriveBackground?: boolean;
                 /** Whether the current user can change the driveMembersOnly restriction of this shared drive. */
                 canChangeDriveMembersOnlyRestriction?: boolean;
+                /** Whether the current user can change the sharingFoldersRequiresOrganizerPermission restriction of this shared drive. */
+                canChangeSharingFoldersRequiresOrganizerPermissionRestriction?: boolean;
                 /** Whether the current user can comment on files in this shared drive. */
                 canComment?: boolean;
                 /** Whether the current user can copy files in this shared drive. */
@@ -286,6 +288,8 @@ declare namespace gapi.client {
                 domainUsersOnly?: boolean;
                 /** Whether access to items inside this shared drive is restricted to its members. */
                 driveMembersOnly?: boolean;
+                /** If true, only users with the organizer role can share folders. If false, users with either the organizer role or the file organizer role can share folders. */
+                sharingFoldersRequiresOrganizerPermission?: boolean;
             };
             /**
              * The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a
@@ -776,44 +780,48 @@ declare namespace gapi.client {
             deleted?: boolean;
             /**
              * The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
-             * - user - User's full name, as defined for their Google account, such as "Joe Smith."
+             * - user - User's full name, as defined for their Google Account, such as "Joe Smith."
              * - group - Name of the Google Group, such as "The Company Administrators."
-             * - domain - String domain name, such as "thecompany.com."
+             * - domain - String domain name, such as "your-company.com."
              * - anyone - No displayName is present.
              */
             displayName?: string;
-            /** The domain to which this permission refers. */
+            /**
+             * The domain to which this permission refers. The following options are currently allowed:
+             * - The entire domain, such as "your-company.com."
+             * - A target audience, such as "ID.audience.googledomains.com."
+             */
             domain?: string;
             /** The email address of the user or group to which this permission refers. */
             emailAddress?: string;
             /**
              * The time at which this permission will expire (RFC 3339 date-time). Expiration times have the following restrictions:
-             * - They cannot be set on shared drive items
-             * - They can only be set on user and group permissions
-             * - The time must be in the future
-             * - The time cannot be more than a year in the future
+             * - They cannot be set on shared drive items.
+             * - They can only be set on user and group permissions.
+             * - The time must be in the future.
+             * - The time cannot be more than one year in the future.
              */
             expirationTime?: 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. */
             id?: string;
             /** Identifies what kind of resource this is. Value: the fixed string "drive#permission". */
             kind?: string;
-            /** 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. */
+            /** Whether the account associated with this permission is a pending owner. Only populated for user type permissions for files that aren't in a shared drive. */
             pendingOwner?: boolean;
-            /** 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. */
+            /** Details of whether the permissions on this shared drive item are inherited or are directly on this item. This is an output-only field that's present only for shared drive items. */
             permissionDetails?: Array<{
                 /** Whether this permission is inherited. This field is always populated. This is an output-only field. */
                 inherited?: boolean;
                 /** The ID of the item from which this permission is inherited. This is an output-only field. */
                 inheritedFrom?: string;
                 /**
-                 * The permission type for this user. While new values may be added in future, the following are currently possible:
+                 * The permission type for this user. While new values may be added in future, the following are currently allowed:
                  * - file
                  * - member
                  */
                 permissionType?: string;
                 /**
-                 * The primary role for this user. While new values may be added in the future, the following are currently possible:
+                 * The primary role for this user. While new values may be added in the future, the following are currently allowed:
                  * - organizer
                  * - fileOrganizer
                  * - writer
@@ -851,7 +859,7 @@ declare namespace gapi.client {
              * - 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.
+             * extra information required for the anyone type.
              */
             type?: string;
             /** Indicates the view for this permission. Only populated for permissions that belong to a view. published is the only supported value. */
@@ -988,6 +996,8 @@ declare namespace gapi.client {
                 canChangeCopyRequiresWriterPermissionRestriction?: boolean;
                 /** Whether the current user can change the domainUsersOnly restriction of this Team Drive. */
                 canChangeDomainUsersOnlyRestriction?: boolean;
+                /** Whether the current user can change the sharingFoldersRequiresOrganizerPermission restriction of this Team Drive. */
+                canChangeSharingFoldersRequiresOrganizerPermissionRestriction?: boolean;
                 /** Whether the current user can change the background of this Team Drive. */
                 canChangeTeamDriveBackground?: boolean;
                 /** Whether the current user can change the teamMembersOnly restriction of this Team Drive. */
@@ -1049,6 +1059,8 @@ declare namespace gapi.client {
                  * other sharing policies controlled outside of this Team Drive.
                  */
                 domainUsersOnly?: boolean;
+                /** If true, only users with the organizer role can share folders. If false, users with either the organizer role or the file organizer role can share folders. */
+                sharingFoldersRequiresOrganizerPermission?: boolean;
                 /** Whether access to items inside this Team Drive is restricted to members of this Team Drive. */
                 teamMembersOnly?: boolean;
             };
@@ -1183,7 +1195,7 @@ declare namespace gapi.client {
                 /** Deprecated. Please use quotaUser instead. */
                 userIp?: string;
             }): Request<ChangeList>;
-            /** Subscribes to changes for a user. */
+            /** Subscribes to changes for a user. To use this method, you must include the pageToken query parameter. */
             watch(request: {
                 /** Data format for the response. */
                 alt?: string;
@@ -2259,7 +2271,7 @@ declare namespace gapi.client {
             body: Channel): Request<Channel>;
         }
         interface PermissionsResource {
-            /** Creates a permission for a file or shared drive. */
+            /** Creates a permission for a file or shared drive. For more information on creating permissions, see Share files, folders & drives. */
             create(request: {
                 /** Data format for the response. */
                 alt?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.drive-v3",
-  "version": "0.0.20230206",
+  "version": "0.0.20230219",
   "description": "TypeScript typings for Drive API v3",
   "license": "MIT",
   "author": {

package/readme.md

@@ -103,7 +103,7 @@ Lists the changes for a user or shared drive.
 await gapi.client.drive.changes.list({ pageToken: "pageToken",  });
 
 /*
-Subscribes to changes for a user.
+Subscribes to changes for a user. To use this method, you must include the pageToken query parameter.
 */
 await gapi.client.drive.changes.watch({ pageToken: "pageToken",  });
 
@@ -233,7 +233,7 @@ Subscribes to changes to a file. While you can establish a channel for changes t
 await gapi.client.drive.files.watch({ fileId: "fileId",  });
 
 /*
-Creates a permission for a file or shared drive.
+Creates a permission for a file or shared drive. For more information on creating permissions, see Share files, folders & drives.
 */
 await gapi.client.drive.permissions.create({ fileId: "fileId",  });
 

package/tests.ts

@@ -3,7 +3,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 
-// Revision: 20230206
+// Revision: 20230219
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -69,7 +69,7 @@ gapi.load('client', async () => {
             supportsTeamDrives: true,
             teamDriveId: "Test string",
         });
-        /** Subscribes to changes for a user. */
+        /** Subscribes to changes for a user. To use this method, you must include the pageToken query parameter. */
         await gapi.client.drive.changes.watch({
             driveId: "Test string",
             includeCorpusRemovals: true,
@@ -243,6 +243,7 @@ gapi.load('client', async () => {
                 canChangeDomainUsersOnlyRestriction: true,
                 canChangeDriveBackground: true,
                 canChangeDriveMembersOnlyRestriction: true,
+                canChangeSharingFoldersRequiresOrganizerPermissionRestriction: true,
                 canComment: true,
                 canCopy: true,
                 canDeleteChildren: true,
@@ -270,6 +271,7 @@ gapi.load('client', async () => {
                 copyRequiresWriterPermission: true,
                 domainUsersOnly: true,
                 driveMembersOnly: true,
+                sharingFoldersRequiresOrganizerPermission: true,
             },
             themeId: "Test string",
         });
@@ -317,6 +319,7 @@ gapi.load('client', async () => {
                 canChangeDomainUsersOnlyRestriction: true,
                 canChangeDriveBackground: true,
                 canChangeDriveMembersOnlyRestriction: true,
+                canChangeSharingFoldersRequiresOrganizerPermissionRestriction: true,
                 canComment: true,
                 canCopy: true,
                 canDeleteChildren: true,
@@ -344,6 +347,7 @@ gapi.load('client', async () => {
                 copyRequiresWriterPermission: true,
                 domainUsersOnly: true,
                 driveMembersOnly: true,
+                sharingFoldersRequiresOrganizerPermission: true,
             },
             themeId: "Test string",
         });
@@ -1316,7 +1320,7 @@ gapi.load('client', async () => {
             token: "Test string",
             type: "Test string",
         });
-        /** Creates a permission for a file or shared drive. */
+        /** Creates a permission for a file or shared drive. For more information on creating permissions, see Share files, folders & drives. */
         await gapi.client.drive.permissions.create({
             emailMessage: "Test string",
             enforceSingleParent: true,
@@ -1554,6 +1558,7 @@ gapi.load('client', async () => {
                 canAddChildren: true,
                 canChangeCopyRequiresWriterPermissionRestriction: true,
                 canChangeDomainUsersOnlyRestriction: true,
+                canChangeSharingFoldersRequiresOrganizerPermissionRestriction: true,
                 canChangeTeamDriveBackground: true,
                 canChangeTeamMembersOnlyRestriction: true,
                 canComment: true,
@@ -1582,6 +1587,7 @@ gapi.load('client', async () => {
                 adminManagedRestrictions: true,
                 copyRequiresWriterPermission: true,
                 domainUsersOnly: true,
+                sharingFoldersRequiresOrganizerPermission: true,
                 teamMembersOnly: true,
             },
             themeId: "Test string",
@@ -1618,6 +1624,7 @@ gapi.load('client', async () => {
                 canAddChildren: true,
                 canChangeCopyRequiresWriterPermissionRestriction: true,
                 canChangeDomainUsersOnlyRestriction: true,
+                canChangeSharingFoldersRequiresOrganizerPermissionRestriction: true,
                 canChangeTeamDriveBackground: true,
                 canChangeTeamMembersOnlyRestriction: true,
                 canComment: true,
@@ -1646,6 +1653,7 @@ gapi.load('client', async () => {
                 adminManagedRestrictions: true,
                 copyRequiresWriterPermission: true,
                 domainUsersOnly: true,
+                sharingFoldersRequiresOrganizerPermission: true,
                 teamMembersOnly: true,
             },
             themeId: "Test string",