From 0508554e2cac6a65aef3dff1ff01963b53738798 Mon Sep 17 00:00:00 2001
From: Ross Scroggs <ross.scroggs@gmail.com>
Date: Sun, 21 Aug 2016 13:46:09 -0700
Subject: [PATCH] Documentation update

---
 src/GamCommands.txt | 13 +++++++++++--
 src/whatsnew.txt    | 11 +++++++++++
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/src/GamCommands.txt b/src/GamCommands.txt
index 5d52b4ff..14217c4b 100644
--- a/src/GamCommands.txt
+++ b/src/GamCommands.txt
@@ -77,6 +77,7 @@ If an item contains spaces, it should be surrounded by " or '.
 <FilterID> ::= <Sttring>
 <FolderName> ::= <String>
 <GroupItem> ::= <EmailAddress>|<UniqueID>|<String>
+<GuardianID> ::= <String>
 <HostName> ::= <String>
 <Key> ::= <String>
 <LabelID> ::= <String>
@@ -197,7 +198,6 @@ If an item contains spaces, it should be surrounded by " or '.
 	webviewlink|
 	writerscanshare
 
-
 <GroupFieldName> ::=
 	admincreated|
 	aliases|
@@ -233,6 +233,10 @@ If an item contains spaces, it should be surrounded by " or '.
 	whocanviewgroup|
 	whocanviewmembership
 
+<GuardianState> ::=
+	complete|
+	pending
+
 <MembersFieldName> ::=
 	email|
 	group|
@@ -302,6 +306,7 @@ If an item contains spaces, it should be surrounded by " or '.
 <GroupFieldNameList> ::= '<GroupFieldName(,<GroupFieldName>)*'
 <GroupSettingsFieldNameList> ::= '<GroupSettingsFieldName(,<GroupSettingsFieldName>)*'
 <GroupList> ::= '<GroupItem>(,<GroupItem>)*'
+<GuardianStateList> ::= '<GuardianState>(,<GuardianState>)*'
 <LabelNameList> ::= '<LabelName>(,<LabelName)*'
 <MembersFieldNameList> ::= '<MembersFieldName(,<MembersFieldName>)*'
 <MobileList> ::= '<MobileId>(,<MobileId>)*'
@@ -599,7 +604,7 @@ gam info resource <ResourceID>
 gam print resources [todrive] [allfields] [id] [name] [description] [email] [type]
 
 gam create schema|schemas <SchemaName> <SchemaFieldDefinition>+
-gam update schema <SchemaName> <SchemaFieldDefinition>+
+gam update schema <SchemaName> <SchemaFieldDefinition>* (deletefield <FieldName>)*
 gam delete schema <SchemaName>
 gam info schema <SchemaName>
 gam show schema|schemas
@@ -640,6 +645,10 @@ gam course <CourseID> delete|remove teachers|students <UserItem>
 gam course <CourseID> sync teachers|students <UserTypeEntity>
 gam print course-participants [todrive](course <CourseID>)* [teacher] [student] [show all|students|teachers]
 
+gam create guardian|guardianinvite|inviteguardian <EmailAddress> <UserItem>
+gam delete guardian|guardians <GuardianID <UserItem>
+gam print guardian|guardians [nocsv] [todrive] [invitedguardian <GuardianID>] [student <UserItem>] [invitations] [states <GuardianStateList>] [<UserTypeEntity>]
+
 gam printer register
 gam update printer <PrinterID> <PrinterAttributes>+
 gam delete printer <PrinterID>
diff --git a/src/whatsnew.txt b/src/whatsnew.txt
index 18db9ba1..a5cbc295 100644
--- a/src/whatsnew.txt
+++ b/src/whatsnew.txt
@@ -2,6 +2,17 @@ GAM 3.7
 - Classroom Guardians API. Invite, list and delete guardians for a student.
 - Includes number of improvements from Ross in 3.66 (see below)
 
+To use this version, you must update the list of authorized scopes for your Gam OAuth2 Client and Service Account.
+Go here: https://github.com/jay0lee/GAM/wiki/CreatingClientSecretsFile
+Log on to the admin console as in steps 6.ii.c, d, e.
+In the list of Authorized API clients, locate your Gam OAuth2 Client, copy the Client ID and then remove the entry.
+Paste the Client ID into the Client name box as in step 6.ii.f, then do steps 6.ii.g and 6.ii.h.
+You'll notice that the API Scopes - OAuth2 list has additional entries, these are what is required in Gam 3.7.
+Skip down to step 6.iii.
+In the list of Authorized API clients, locate your Gam Service Account, copy the Client ID and then remove the entry.
+Paste the Client ID into the Client name box as in step 6.iii.c, then do steps 6.iii.d and 6.iii.e.
+You'll notice that the API Scopes - Service Account list has additional entries, these are what is required in Gam 3.7.
+
 GAM 3.66
 See GamCommands.txt for a complete syntax description.