Integrate Wikis - Step 1

GAM-team · Oct 6, 2024 · caddda2 · caddda2
1 parent f63a04a
commit caddda2
Show file tree

Hide file tree

Showing 182 changed files with 6,386 additions and 4,093 deletions.
diff --git a/docs/Addresses.md b/docs/Addresses.md
@@ -1,4 +1,4 @@
-# Addresses
+!# Addresses
 - [API documentation](#api-documentation)
 - [Display addresses](#display-addresses)
 

diff --git a/docs/Administrators.md b/docs/Administrators.md
@@ -1,4 +1,4 @@
-# Administrators
+!# Administrators
 - [Administrator roles documentation](#administrator-roles-documentation)
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)

diff --git a/docs/Alert-Center.md b/docs/Alert-Center.md
@@ -1,4 +1,4 @@
-# Alert Center
+!# Alert Center
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Introduction](#introduction)

diff --git a/docs/Aliases.md b/docs/Aliases.md
@@ -30,7 +30,7 @@ See [Collections of Items](Collections-of-Items)
 <EmailAddress> ::= <String>@<DomainName>
 <EmailAddressList> ::= "<EmailAddress>(,<EmailAddress>)*"
 <EmailAddressEntity> ::= <EmailAddressList> | <FileSelector> | <CSVkmdSelector> | <CSVDataSelector>
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 <UniqueID> ::= id:<String>
 ```
 ## Create an alias for a target

diff --git a/docs/Authorization.md b/docs/Authorization.md
@@ -168,7 +168,7 @@ gam oauth update
 <ProjectIDEntity> ::=
         current | gam | <ProjectID> | (filter <String>) |
         (select <ProjectIDList> | <FileSelector> | <CSVFileSelector>)
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 <ProjectName> ::= <String>
         Must match this Python Regular Expression: [a-zA-Z0-9 '"!-]{4,30}
 <ServiceAccountName> ::= <String>

diff --git a/docs/BNF-Syntax.md b/docs/BNF-Syntax.md
@@ -1,4 +1,4 @@
-# Syntax
+!# Syntax
 
 ## BNF Syntax
 This Wiki describes the GAM7 command line syntax in modified BNF.

diff --git a/docs/Basic-Items.md b/docs/Basic-Items.md
@@ -1,4 +1,4 @@
-# Basic Items
+!# Basic Items
 - [Primitives](#primitives)
 - [Items built from primitives](#items-built-from-primitives)
 - [Named items](#named-items)

diff --git a/docs/Bulk-Processing.md b/docs/Bulk-Processing.md
@@ -1,4 +1,4 @@
-# Bulk Processing
+!# Bulk Processing
 - [Introduction](#introduction)
 - [Python Regular Expressions](Python-Regular-Expressions)
 - [GAM Configuration](gam.cfg)

diff --git a/docs/CSV-Input-Filtering.md b/docs/CSV-Input-Filtering.md
@@ -16,7 +16,7 @@ There are two values in `gam.cfg` that can be used to filter the input from `gam
 * `csv_input_row_drop_filter` - A list or JSON dictionary used to exclude specific rows based on column values
 
 These filters can be used alone or in conjunction with the `matchfield|skipfield <FieldName> <RegularExpression>` options.
-* https://github.com/taers232c/GAMADV-XTD3/wiki/Bulk-Processing#csv-files
+* https://github.com/GAM-team/GAM/wiki/Bulk-Processing#csv-files
 
 ## Definitions
 [Data Selectors](Collections-of-items)

diff --git a/docs/CSV-Output-Filtering.md b/docs/CSV-Output-Filtering.md
@@ -1,4 +1,4 @@
-# CSV Output Filtering
+!# CSV Output Filtering
 - [Python Regular Expressions](Python-Regular-Expressions) Search function
 - [Definitions](#definitions)
 - [Quoting rules](#quoting-rules)

diff --git a/docs/CSV-Special-Characters.md b/docs/CSV-Special-Characters.md
@@ -1,4 +1,4 @@
-# CSV Special Characters
+!# CSV Special Characters
 - [Python CSV documentation](https://docs.python.org/3/library/csv.html#dialects-and-formatting-parameters)
 
 ## Python variables that control CSV file reading/writing:

diff --git a/docs/CalendarExamples.md b/docs/CalendarExamples.md
@@ -0,0 +1,260 @@
+- [Modifying and Viewing Calendar Access Control Lists (ACLs)](#modifying-and-viewing-calendar-access-control-lists-acls)
+  - [Viewing a Calender's ACL](#viewing-a-calenders-acl)
+  - [Adding Users to a Calendar's ACL](#adding-users-to-a-calendars-acl)
+  - [Updating a User Entry in a Calendar ACL](#updating-a-user-entry-in-a-calendar-acl)
+  - [Deleting Users from a Calendar's ACL](#deleting-users-from-a-calendars-acl)
+- [Viewing and Modifying a User's List of Calendars](#viewing-and-modifying-a-users-list-of-calendars)
+  - [Retrieving a Calendar a User Has Listed](#retrieving-a-calendar-a-user-has-listed)
+  - [Showing the Calendars a User Has Listed](#showing-the-calendars-a-user-has-listed)
+  - [Printing the Calendars a User Has Listed](#printing-the-calendars-a-user-has-listed)
+  - [Deleting a Calendar from a User(s) List of Calendars](#deleting-a-calendar-from-a-users-list-of-calendars)
+  - [Adding a Calendar to a User(s) List of Calendars](#adding-a-calendar-to-a-users-list-of-calendars)
+  - [Updating a Calendar in a User(s) List of Calendars](#updating-a-calendar-in-a-users-list-of-calendars)
+- [Deleting Events for a Calendar](#deleting-events-for-a-calendar)
+- [Wiping a User's Primary Calendar](#wiping-a-users-primary-calendar)
+
+GAM now supports Google Calendar Management with the ability to modify Access Control Lists (ACLs) for calendars and to add, list and remove calendars from a users Google Calendar display. GAM can work with user primary and secondary calendars as well as resource calendars.
+
+All Google Calendars have an email address associated with them. All users who have the Calendar service enabled have a primary calendar identified by their email address. Secondary calendars created by or for the user have a special calendar email address which can be learned with the ` gam user <username> show calendars ` command. Resource Calendars also have a special email address that can be learned with the ` gam print resources ` command.
+
+# Modifying and Viewing Calendar Access Control Lists (ACLs)
+## Viewing a Calender's ACL
+### Syntax
+```
+gam calendar <calendar email> showacl|printacl
+```
+Shows the ACLs for the given calendar (showacl) or prints CSV output of the ACLs (printacl). The ACL list will show who has access to the calendar and what level of access they have.
+
+### Example
+This example displays the Calendar ACLs for [email protected]
+```
+gam calendar [email protected] showacl
+```
+
+---
+
+
+## Adding Users to a Calendar's ACL
+### Syntax
+```
+gam calendar <calendar email> add freebusy|read|editor|owner <user email> [sendnotifications true|false]
+```
+Gives user email the desired level of access to the given calendar by adding the user to the ACL. freebusy allows the user to see only times whe n the calendar is busy without showing event details. read gives the user rights to view but not edit the calendar. editor gives read/write access to the calendar but not ACL or settings modification rights. owner gives the user full access to the calendar with the ability to modify the ACL and calendar settings.
+
+Use the optional sendnotifications flag to choose whether to send notifications about the calendar sharing change or not. The default is True.
+
+**Note:** The special users domain and default cannot be added to a calendar, they can only be updated or deleted by GAM (see below)
+
+**Note:** giving a user rights to another calendar adds that calendar to their list of calendars automatically. A separate command to add the calendar should not be necessary. *Update*: this no longer seems to happen as of early 2020. You'll need to add the calendar to the user's list of calendar's separately.
+
+### Example
+This example gives Bob editor access to Joe's primary calendar.
+```
+gam calendar [email protected] add editor [email protected]
+```
+
+---
+
+
+## Updating a User Entry in a Calendar ACL
+### Syntax
+```
+gam calendar <calendar email> update freebusy|read|editor|owner <user email>
+```
+Update the given user's rights to the given calendar. The user should already have explicit access to the calendar. This command will upgrade (or downgrade) the user's access to the desired level of freebusy, read, editor or owner.
+
+**Note:** the special users domain and default can be used instead of an actual user email address to modify public sharing of the calendar. domain applies to all users in the Google Apps organization. default applies to anyone with a Google account (even @gmail.com) and is limited to read or freebusy. Note that your Calendar control panel settings may prevent read sharing of calendars outside the domain in which case you'll get an error trying to set default to read.
+
+### Example
+This example upgrades Bob to be owner of Joe's Calendar:
+```
+gam calendar [email protected] update owner [email protected]
+```
+
+This example allows anyone with an account in your domain to edit the given resource calendar (including delete others appointments!).
+
+```
+gam calendar example.com_436d6e646572656e6365526f6f6d732d3239352d3372642d5164616d536d6974682d38@resource.calendar.google.com update editor domain
+```
+
+This example allows anyone with a Google account to view Bob's calendar
+```
+gam calendar [email protected] update read default
+```
+
+---
+
+
+## Deleting Users from a Calendar's ACL
+### Syntax
+```
+gam calendar <calendar email> delete [user <user email>] [id <ACL id>]
+```
+Removes user email rights to the given calendar. Note that the user may still have some level of rights (freebusy or read) to the calendar based on the default level of access to calendars set within the domain. Specifying the ACL by ID is also supported and takes the id column of the [printacl command](#viewing-a-calenders-acl)
+
+**Note:** deleting the domain and default users disables public sharing of your calendar. domain applies to everyone in your Google Apps domain while default applies to everyone with a Google Account.
+
+### Example
+This example removes Bob's direct rights to Joe's calendar
+```
+gam calendar [email protected] delete user [email protected]
+```
+
+These two examples remove all public sharing of Bob's calendar. Only those with explicit rights will be able to see anything (including freebusy):
+
+```
+gam calendar [email protected] delete user domain
+gam calendar [email protected] delete user default
+```
+
+---
+
+
+# Viewing and Modifying a User's List of Calendars
+## Retrieving a Calendar a User Has Listed
+### Syntax
+```
+gam user <user>|group <group>|ou <ou>|all users info calendar <calendar email>
+```
+Displays the details of the users' specific Calendar.
+
+### Example
+This example displays a specific calendar that Bob has added to his Google Calendar app
+```
+gam user [email protected] info calendar [email protected]
+
+User: [email protected]'s Calendar:
+  Calendar: test
+    ID: [email protected]
+    Access Level: root
+    Timezone: America/New_York
+    Hidden: false
+    Selected: true
+    Color: #2952A3
+```
+
+## Showing the Calendars a User Has Listed
+### Syntax
+```
+gam user <user>|group <group>|ou <ou>|all users show calendars
+```
+Displays the details of all of the Calendars the user has listed in their Google Calendar.
+
+### Example
+This example lists the calendars that Bob has added to his Google Calendar app
+```
+gam user [email protected] show calendars
+
+User: [email protected]'s Calendars
+  Calendar: [email protected]
+    ID: [email protected]
+    Access Level: owner
+    Timezone: America/New_York
+    Hidden: false
+    Selected: false
+    Color: #2F6309
+  Calendar: test
+    ID: [email protected]
+    Access Level: root
+    Timezone: America/New_York
+    Hidden: false
+    Selected: true
+    Color: #2952A3
+  Calendar: Canadian Holidays
+    ID: en.canadian#[email protected]
+    Access Level: read
+    Timezone: America/New_York
+    Hidden: false
+    Selected: true
+    Color: #2952A3
+```
+
+## Printing the Calendars a User Has Listed
+### Syntax
+```
+gam user <user>|group <group>|ou <ou>|all users print calendars [todrive]
+```
+Display or upload to Google Drive a CSV report of all of the users' calendars. The optional `todrive` parameter specifies that the results should be uploaded to Google Drive rather than being displayed on screen or piped to a CSV text file. 
+
+### Example
+This example lists the calendars that all users have specified in the Calendar app.
+```
+gam all users print calendars
+```
+
+---
+
+
+## Deleting a Calendar from a User(s) List of Calendars
+### Syntax
+```
+gam user <user>|group <group>|ou <ou>|all users delete calendar <calendar email>
+```
+Removes the given calendar from each of the users' list of calendars. Deleting a calendar from a user's calendar list does not change ACLs on the calendar, it simply removes it from the display.
+
+### Example
+This example removes Joe's calendar from Bob's display of calendars.
+```
+gam user [email protected] delete calendar [email protected]
+```
+
+---
+
+
+## Adding a Calendar to a User(s) List of Calendars
+### Syntax
+```
+gam user <user>|group <group>|ou <ou>|all users add calendar <calendar email> [selected true|false] [hidden true|false] [reminder email|sms|popup <minutes>] [notification email|sms eventcreation|eventchange|eventcancellation|eventresponse|agenda] [summary <summary>] [colorindex <1-24>] [backgroundcolor <htmlcolor>] [foregroundcolor <htmlcolor>]
+```
+Adds the given calendar to each of the users' list of calendars. Adding a calendar to a user's calendar list does not give them any rights to the calendar that they didn't have before. If the user does not have rights to the calendar, use the ACL command above to both grant them rights and add the calendar to their list of calendars.
+
+The optional argument `selected` determines if the calendar is selected in the user's list of subscribed calendars by default. The optional argument `hidden` determines if the calendar is hidden from the user's list of subscribed calendars. The optional argument `reminder` sets the default reminder type and time for calendar events and can be repeated. The optional argument `notification` sets the default notification type for calendar events and can be repeated. The optional argument `summary` overrides the calendar's default name. The optional argument `colorindex` sets the calendar entries colors. Index colors can be viewed [here](http://calendar-colors.appspot.com/). The optional arguments `backgroundcolor` and `foregroundcolor` manually set the calendars colors.
+
+### Example
+The following example adds Bob's calendar to Joe's list of calendars without it being selected in Joe's calendar display.
+
+```
+gam user [email protected] add calendar [email protected] selected false
+```
+
+---
+
+
+## Updating a Calendar in a User(s) List of Calendars
+### Syntax
+```
+gam user <user>|group <group>|ou <ou>|all users update calendar <calendar email> [selected true|false] [hidden true|false] [reminder (email|sms|popup <minutes>)|clear] [notification (email|sms eventcreation|eventchange|eventcancellation|eventresponse|agenda)|clear] [summary <summary>] [colorindex <1-24>] [backgroundcolor <htmlcolor>] [foregroundcolor <htmlcolor>]
+```
+Update how a given calendar is displayed in a user's list of calendars. The optional argument `selected` determines if the calendar is selected in the user's list of subscribed calendars by default. The optional argument `hidden` determines if the calendar is hidden from the user's list of subscribed calendars. The optional argument `reminder` sets the default reminder type and time for calendar events and can be repeated. The argument `reminder clear` clears all reminders from the calendar. The optional argument `notification` sets the default notification type for calendar events and can be repeated. The argument `notification clear` clears all notifications from the calendar. The optional argument `summary` overrides the calendar's default name. The optional argument `colorindex` sets the calendar entries colors. Index colors can be viewed [here](http://calendar-colors.appspot.com/). The optional arguments `backgroundcolor` and `foregroundcolor` manually set the calendars colors.
+
+### Example
+The following example updates Bob's view of Joe's calendars, changing the color to green.
+
+```
+gam user [email protected] update calendar [email protected] colorindex 9
+```
+
+---
+
+# Deleting Events for a Calendar
+### Syntax
+```
+gam calendar <email> deleteevent [eventid <id>] [query <query>] [notifyattendees] [doit]
+```
+Delete event(s) off the given calendar. You should specify either the single event ID with the eventid argument or a query to perform against the calendar to determine which events should be deleted. Query operates in a similar fashion to Calendar UIs search but you should test results carefully, a bad query can delete more events than you intended. The optional argument notifyattendees will send event attendees an email notification that the event is cancelled, removed. Because this command involves deletion of user data, GAM will not perform the action by default unless the doit argument is supplied.
+
+# Wiping a User's Primary Calendar
+### Syntax
+```
+gam calendar <user email> wipe
+```
+Wipe all data from a user's primary calendar. **WARNING: This will delete all user events and there is no way to recover them!** Email address must be a Google Apps user. It's not possible to wipe resource or secondary calendars.
+
+### Example
+The following example deletes all data for Joe's Calendar.
+
+```
+gam calendar [email protected] wipe
+```
+
+---
diff --git a/docs/Calendars-Access.md b/docs/Calendars-Access.md
@@ -28,7 +28,7 @@ Calendar ACL roles (as seen in Calendar GUI):
 <CalendarItem> ::= <EmailAddress>
 <CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*"
 <CalendarEntity> ::= <CalendarList> | <FileSelector> | <CSVkmdSelector> | <CSVDataSelector>
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 
 <CalendarACLRole> ::= editor|freebusy|freebusyreader|owner|reader|writer
 <CalendarACLScope> ::= <EmailAddress>|user:<EmailAdress>|group:<EmailAddress>|domain:<DomainName>|domain|default

diff --git a/docs/Calendars-Events.md b/docs/Calendars-Events.md
@@ -63,12 +63,12 @@ Client access works when accessing Resource calendars.
 <CalendarItem> ::= <EmailAddress>
 <CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*"
 <CalendarEntity> ::= <CalendarList> | <FileSelector> | <CSVkmdSelector> | <CSVDataSelector>
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 <DomainName> ::= <String>(.<String>)+
 <EmailAddress> ::= <String>@<DomainName>
 <EmailAddressList> ::= "<EmailAddess>(,<EmailAddress>)*"
 <EmailAddressEntity> ::= <EmailAddressList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector>
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 
 <EventAttachmentsSubfieldName> ::=
         attachments.fileid|
@@ -220,7 +220,7 @@ Client access works when accessing Resource calendars.
         (id|eventid <EventId>) |
         (event|events <EventIdList> |
         <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVSubkeySelector> | <CSVDataSelector>)
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 <EventSelectEntity> ::=
         (<EventSelectProperty>+ <EventMatchProperty>*)
 

diff --git a/docs/Calendars.md b/docs/Calendars.md
@@ -21,7 +21,7 @@ Client access works when accessing Resource calendars.
 <CalendarItem> ::= <EmailAddress>
 <CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*"
 <CalendarEntity> ::= <CalendarList> | <FileSelector> | <CSVkmdSelector> | <CSVDataSelector>
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 
 <TimeZone> ::= <String>
         See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

diff --git a/docs/Chat-Bot.md b/docs/Chat-Bot.md
@@ -1,4 +1,4 @@
-# Chat Bot
+!# Chat Bot
 
 - [Notes](#notes)
 - [API documentation](#api-documentation)

diff --git a/docs/Chrome-AUE-Counts.md b/docs/Chrome-AUE-Counts.md
@@ -1,4 +1,4 @@
-# Chrome Auto Update Expiration Counts
+!# Chrome Auto Update Expiration Counts
 
 - [Chrome Auto Update Expiration Counts](#chrome-auto-update-expiration-counts)
   - [API documentation](#api-documentation)

diff --git a/docs/Chrome-Browser-Cloud-Management.md b/docs/Chrome-Browser-Cloud-Management.md
@@ -41,7 +41,7 @@
         (query:<QueryBrowser>)|(query:orgunitpath:<OrgUnitPath>)|(query <QueryBrowser>) |
         (browserou <OrgUnitItem>) | (browserous <OrgUnitList>) |
         <FileSelector> | <CSVFileSelector>
-        See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
+        See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
 
 <BrowserAttribute> ::=
         (annotatedassetid|asset|assetid <String>)|