diff --git a/wiki/GamUpdates.md b/wiki/GamUpdates.md index 2dba8f23..ce6a1110 100644 --- a/wiki/GamUpdates.md +++ b/wiki/GamUpdates.md @@ -10,6 +10,24 @@ Add the `-s` option to the end of the above commands to suppress creating the `g See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation +### 7.29.00 + +Added options `mappermissionsemail ` and ` mappermissionsemailfile endcsv` +to these commands: +``` +gam [] copy shareddriveacls to +gam [] sync shareddriveacls with +gam copy drivefile +gam move drivefile +``` +When `mappermissionsemail ` is specifed, an ACL that references the first `` +in the source will be modified to reference the second `` in the destination. + +Bulk permission email address mapping can be specified with `mappermissionsemailfile endcsv`. +`` must include these columns: `sourceEmail` and `destinationEmail`. + +These options will be most useful with inter-workspace Shared Drive copies and moves. + ### 7.28.13 Added option `addcsvdata ` to `gam print messages` diff --git a/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md b/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md index 21dac564..eea94c9d 100644 --- a/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md +++ b/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md @@ -252,7 +252,7 @@ writes the credentials into the file oauth2.txt. admin@server:/Users/admin$ rm -f /Users/admin/GAMConfig/oauth2.txt admin@server:/Users/admin$ gam version WARNING: Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: /Users/admin/GAMConfig/oauth2.txt, Not Found -GAM 7.28.13 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.29.00 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.1 x86_64 @@ -990,7 +990,7 @@ writes the credentials into the file oauth2.txt. C:\>del C:\GAMConfig\oauth2.txt C:\>gam version WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found -GAM 7.28.13 - https://github.com/GAM-team/GAM - pythonsource +GAM 7.29.00 - https://github.com/GAM-team/GAM - pythonsource GAM Team Python 3.14.0 64-bit final Windows 11 10.0.26200 AMD64 diff --git a/wiki/Shared-Drives.md b/wiki/Shared-Drives.md index a45d56ca..0b25587a 100644 --- a/wiki/Shared-Drives.md +++ b/wiki/Shared-Drives.md @@ -653,11 +653,13 @@ These commands are used to transfer ACLs from one Shared Drive to another. gam [] copy shareddriveacls to [showpermissionsmessages []] [excludepermissionsfromdomains|includepermissionsfromdomains ] + (mappermissionsemail endcsv] (mappermissionsdomain )* [adminaccess|asadmin] gam [] sync shareddriveacls with [showpermissionsmessages []] [excludepermissionsfromdomains|includepermissionsfromdomains ] + (mappermissionsemail endcsv] (mappermissionsdomain )* [adminaccess|asadmin] ``` @@ -665,8 +667,14 @@ When `excludepermissionsfromdomains ` is specified, any ACL that When `includepermissionsfromdomains ` is specified, only ACLs that reference a domain in `` will be copied. +When `mappermissionsemail ` is specifed, an ACL that references the first `` will be modified +to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple email addresses are to be mapped. + +Bulk permission email address mapping can be specified with `mappermissionsemailfile endcsv`. +`` must include these columns: `sourceEmail` and `destinationEmail`. + When `mappermissionsdomain ` is specifed, any ACL that references the first `` will be modified -to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple domain names are to me mapped. +to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple domain names are to be mapped. ## Display Shared Drive access diff --git a/wiki/Users-Drive-Copy-Move.md b/wiki/Users-Drive-Copy-Move.md index b72acf10..02454750 100644 --- a/wiki/Users-Drive-Copy-Move.md +++ b/wiki/Users-Drive-Copy-Move.md @@ -114,6 +114,7 @@ gam copy drivefile [copysheetprotectedrangesinheritedpermissions []] [copysheetprotectedrangesnoninheritedpermissions []] [excludepermissionsfromdomains|includepermissionsfromdomains ] + (mappermissionsemail endcsv] (mappermissionsdomain )* [sendemailifrequired []] [verifyorganizer []] @@ -313,8 +314,14 @@ When `excludepermissionsfromdomains ` is specified, any ACL that When `includepermissionsfromdomains ` is specified, only ACLs that reference a domain in `` will be copied. +When `mappermissionsemail ` is specifed, an ACL that references the first `` will be modified +to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple email addresses are to be mapped. + +Bulk permission email address mapping can be specified with `mappermissionsemailfile endcsv`. +`` must include these columns: `sourceEmail` and `destinationEmail`. + When `mappermissionsdomain ` is specified, any ACL that references the first `` will be modified -to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple domain names are to me mapped. +to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple domain names are to be mapped. When copying an ACL that references a non Google account, an error is generated unless an email is sent to the account; by default, no email notifications are sent. The `sendemailifrequired` options instructs GAM to send an email notification in this case. @@ -542,6 +549,7 @@ gam move drivefile [newfilename ]] [copysubfoldernoninheritedpermissions never|always|syncallfolders|syncupdatedfolders] [excludepermissionsfromdomains|includepermissionsfromdomains ] + (mappermissionsemail endcsv] (mappermissionsdomain )* [updatefilepermissions []] [retainsourcefolders []] @@ -666,8 +674,14 @@ When `excludepermissionsfromdomains ` is specified, any ACL that When `includepermissionsfromdomains ` is specified, only ACLs that reference a domain in `` will be copied. +When `mappermissionsemail ` is specifed, an ACL that references the first `` will be modified +to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple email addresses are to be mapped. + +Bulk permission email address mapping can ge specified with `mappermissionsemailfile endcsv`. +`` must include these columns: `sourceEmail` and `destinationEmail`. + When `mappermissionsdomain ` is specified, any ACL that references the first `` will be modified -to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple domain names are to me mapped. +to reference the second `` when copied; the original ACL is not modified. The option can be repeated if multiple domain names are to be mapped. When copying an ACL that references a non Google account, an error is generated unless an email is sent to the account; by default, no email notifications are sent. The `sendemailifrequired` options instructs GAM to send an email notification in this case. @@ -684,8 +698,14 @@ When `excludepermissionsfromdomains ` is specified, any ACL that When `includepermissionsfromdomains ` is specified, any ACLs that references a domain not in `` will be removed. +When `mappermissionsemail ` is specifed, an ACL that references the first `` will be removed; +a new ACL with the same properties referencing the second `` will be created. The option can be repeated if multiple domain names are to be mapped. + +Bulk email address mapping can ge specified with `mappermissionsemailfile endcsv`. +`` must include these columns: `sourceEmail` and `destinationEmail`. + When `mappermissionsdomain ` is specified, any ACL that references the first `` will be removed; -a new ACL with the same properties referencing the second `` will be created. The option can be repeated if multiple domain names are to me mapped. +a new ACL with the same properties referencing the second `` will be created. The option can be repeated if multiple domain names are to be mapped. When creating an ACL that references a non Google account, an error is generated unless an email is sent to the account; by default, no email notifications are sent. The `sendemailifrequired` options instructs GAM to send an email notification in this case. diff --git a/wiki/Version-and-Help.md b/wiki/Version-and-Help.md index 4529dcca..49e5209d 100644 --- a/wiki/Version-and-Help.md +++ b/wiki/Version-and-Help.md @@ -3,7 +3,7 @@ Print the current version of Gam with details ``` gam version -GAM 7.28.13 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.29.00 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.1 x86_64 @@ -15,7 +15,7 @@ Time: 2023-06-02T21:10:00-07:00 Print the current version of Gam with details and time offset information ``` gam version timeoffset -GAM 7.28.13 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.29.00 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.1 x86_64 @@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second Print the current version of Gam with extended details and SSL information ``` gam version extended -GAM 7.28.13 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.29.00 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.1 x86_64 @@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64 Path: /Users/Admin/bin/gam7 Version Check: Current: 5.35.08 - Latest: 7.28.13 + Latest: 7.29.00 echo $? 1 ``` @@ -76,7 +76,7 @@ echo $? Print the current version number without details ``` gam version simple -7.28.13 +7.29.00 ``` In Linux/MacOS you can do: ``` @@ -86,7 +86,7 @@ echo $VER Print the current version of Gam and address of this Wiki ``` gam help -GAM 7.28.13 - https://github.com/GAM-team/GAM +GAM 7.29.00 - https://github.com/GAM-team/GAM GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.1 x86_64