GAM 3.4 "Oktoberfest" and A Call For Help!

1,006 views
Skip to first unread message

Jay Lee

unread,
Sep 24, 2014, 8:16:18 AM9/24/14
to google-ap...@googlegroups.com
GAM 3.4 is out. Release notes below but I need your help!

I've been working to move GAM off of Google Code onto GitHub (http://git.io/gam). More than anything, I could use some volunteers to help move the Wiki out of Google Code:


over to GitHub's Wiki:


the GitHub Wiki should be editable by all. There is a handy script for reformatting the Wiki syntax between the two at http://goo.gl/yEXqir but it doesn't get it 100%. Additionally some pages need updating and some pages (anything GAM 2.xx) don't need to be moved at all. Any help you can provide would be greatly appreciated!

Now on to GAM 3.4 the "Oktoberfest" release:


  • Support for creating and setting custom user schemas http://goo.gl/M9rQrI
  • End user view of print users and user info commands.
  • fix updating name/description for groups
  • fix groups sync commands
  • gam print groups members no longer fails on zero member groups
  • make sure downloaded Drive file names are safe for OS filenames.
  • gam info domain should no longer crash on getting customer ID
  • other minor bug fixes

Here's a quick tutorial for custom schemas:
  1. Create a custom schema with a command like

    gam create schema StudentData field StudentID type string indexed restricted endfield field GradeLevel type int64 indexed endfield

  2. See what schemas exist in your Google Apps instance with:

    gam print schemas

  3. See details about a particular schema with:

    gam info schema StudentData

  4. Set a user's custom schema values:

    gam create user johnny...@school.org firstname Johny lastname Smith password p@ssw3rd StudentData.StudentID 287-432-831 StudentData.GradeLevel 4

    or

    gam update user johny...@school.org StudentData.StudentID 287-432-831 StudentData.GradeLevel 4

  5. Search for users based on schema data:

    gam print users query StudentData.StudentID=287-432-831

AlCrosby

unread,
Sep 25, 2014, 4:18:17 PM9/25/14
to google-ap...@googlegroups.com
I can confirm that the "Oktoberfest" release definitely fixes the group sync issue.

Hoorah!  Jay... If you want to come to NW Arkansas, I'll buy you a cool one! 

And to visit Race to The Top winning school district deploying thousands of Chromebooks, you might be able to convince your bosses to send you out!

I can now rest peacefully about Google Groups!

Many thanks!

Albert

Jenna B

unread,
Sep 29, 2014, 4:18:37 PM9/29/14
to google-ap...@googlegroups.com
I am new to Google APPS and appreciate help.

Jay Lee

unread,
Oct 2, 2014, 7:51:41 AM10/2/14
to google-ap...@googlegroups.com
Just a quick note that I've released GAM 3.41 with just a few fixes:

  • fix "gam audit export download" failures due to Google no longer declaring download size
  • 2nd attempt to fix "gam info domain" errors on getting Customer ID
  • license commands should now soft fail (keeps going for other users)


Jay

Jan Almeroth

unread,
Oct 2, 2014, 8:09:35 AM10/2/14
to google-ap...@googlegroups.com
  • 2nd attempt to fix "gam info domain" errors on getting Customer ID

Works for me now, thank you! :)

--
You received this message because you are subscribed to the Google Groups "Google Apps Manager" group.
To unsubscribe from this group and stop receiving emails from it, send an email to google-apps-man...@googlegroups.com.
To post to this group, send email to google-ap...@googlegroups.com.
Visit this group at http://groups.google.com/group/google-apps-manager.
To view this discussion on the web visit https://groups.google.com/d/msgid/google-apps-manager/031c5270-e472-4b4e-a7a4-15c8bd5b4258%40googlegroups.com.

For more options, visit https://groups.google.com/d/optout.

Nattard

unread,
Oct 2, 2014, 9:53:26 PM10/2/14
to google-ap...@googlegroups.com
Hi I have tried using 3.4 and 3.41

I am very happy to say that printing all groups and members (for a large domain) now works.
I did find a problem. I used to run a report :
gam print users firstname lastname username suspended .... which worked fine prior to 3.4 now I get an error 
"NameError: global name 'exit" is not defined"

What I found out is that the report runs ok if I don't include "username"

Has this changes as I couldn't find anything that says it did.

Thanks

Jan Almeroth

unread,
Oct 3, 2014, 3:57:20 AM10/3/14
to google-ap...@googlegroups.com
Hey Jay,

I am willing to help you with the conversion of the old wiki. Unfortunately, I get an permission error while committing my changes to GH via my GitHub-application. Could you take a look here? In case you need to allow a certain user my GH-handle is "jalmeroth".

Regards,
Jan

--
You received this message because you are subscribed to the Google Groups "Google Apps Manager" group.
To unsubscribe from this group and stop receiving emails from it, send an email to google-apps-man...@googlegroups.com.
To post to this group, send email to google-ap...@googlegroups.com.
Visit this group at http://groups.google.com/group/google-apps-manager.

Jay Lee

unread,
Oct 3, 2014, 5:39:59 AM10/3/14
to google-ap...@googlegroups.com
I made some modifications, with 3.4 and added the "emailparts" argument which splits the local and domain parts of the primaryEmail:

$ gam print users emailparts

I'll see about adding the "username" argument back in as an alias to emailparts for the next release but the CSV headers will remain as shown above.

...


Jay Lee

--
You received this message because you are subscribed to the Google Groups "Google Apps Manager" group.
To unsubscribe from this group and stop receiving emails from it, send an email to google-apps-man...@googlegroups.com.
To post to this group, send email to google-ap...@googlegroups.com.
Visit this group at http://groups.google.com/group/google-apps-manager.

Jay Lee

unread,
Oct 3, 2014, 5:44:14 AM10/3/14
to google-ap...@googlegroups.com
Hi Jan,

  Thanks! I see you succeeded in recreating the client_secrets page and updating it. What errors are you getting on what pages? Everything's open as far as I can tell.


Jay Lee

Jan Almeroth

unread,
Oct 3, 2014, 6:00:00 AM10/3/14
to google-ap...@googlegroups.com
Hi Jay,

yeah, I updated this page in the online editor, but I would like to convert the other pages locally and just push them.

Unfortunately I get this error:
Inline image 1

I did a successful test with a wiki I created. Any ideas?

Jan


For more options, visit https://groups.google.com/d/optout.



--

Brucknerstraße 15
22083 Hamburg

Telefon: (040) 63 94 37 27
Mobil: (0151) 22 36 84 99

Jay Lee

unread,
Oct 3, 2014, 6:11:34 AM10/3/14
to google-ap...@googlegroups.com
Hmm... Looks like while anyone can update the GitHub wikis online, git level commits are limited to project owners.

Can you try the forking instructions at:


and see if they work for you? I should be able to pull in your changes once you're ready.

Let me know if this process proves to be painful. The goal here is to make updating the Wiki very simple so it's update while not getting spammed. I realize it may take some tweaking and rethinking the process to get there though!


Jay Lee

Jan Almeroth

unread,
Oct 3, 2014, 7:14:13 AM10/3/14
to google-ap...@googlegroups.com
Ok, I forked GAM now and made a basic import: <https://github.com/jalmeroth/GAM/wiki>.
Do you want to merge them now so everyone can help editing on the original wiki?


For more options, visit https://groups.google.com/d/optout.

Jay Lee

unread,
Oct 3, 2014, 8:27:37 AM10/3/14
to google-ap...@googlegroups.com

Sharon Barnard

unread,
Oct 6, 2014, 12:16:04 PM10/6/14
to google-ap...@googlegroups.com
Hi Jay,

I'm new to GAM (only a couple of weeks now) but the new http://git.io/gam site seems much less friendly to me that what you had before.  Maybe because I'm still a newby or not much of a programmer but I don't know where to really dive in to find GAM help (commands, syntax etc).  Can you give directions or a link as to where I could find this?

___________________________________

Anaheim Union High School District
E-mail Confidentiality Notice

This e-mail communication and any attachments, including documents, files, or previous e-mail messages, constitute electronic communications within the scope of the Electronic Communications Privacy Act, 18 U.S.C. § 2510 et seq. This e-mail communication may contain non-public, confidential or legally privileged information intended for the sole use of the designated recipient(s). The unauthorized and intentional interception, use, copy or disclosure of such information, or attempt to do so, is strictly prohibited and may be unlawful under applicable laws. 18 U.S.C. § 2511. If you have received this e-mail communication in error, please immediately notify the sender by return e-mail and delete the original e-mail from your system. 

Jesica Paula Yabo

unread,
Oct 12, 2014, 11:21:43 PM10/12/14
to google-ap...@googlegroups.com
Hi guys

I'm trying to install GAM in my computer and I'm running it as an administrator but unfortunately it doesn't install.... I see quickly a cmd window and then disappears letting me wonder why nothing else is happening

Can you please help me?

thanks a lot
Jesica



On Wednesday, 24 September 2014 22:16:18 UTC+10, Jay Lee wrote:

Karl

unread,
Nov 12, 2014, 10:20:19 AM11/12/14
to google-ap...@googlegroups.com
Hi Jay this is amazing! Love the Custom Schema support.

Is there a way to print all users with a certain attribute i try for example:
gam print users query MasterData.id=668944 MasterData.id=772857  > MasterData.csv
gam print users query MasterData.id=*  > MasterData.csv
gam print users query MasterData.id > MasterData.csv
gam print users query MasterData.id!=null > MasterData.csv

Is it possible? otherwise a big wish from my side =)

//Karl 

Jay Lee

unread,
Nov 12, 2014, 10:25:44 AM11/12/14
to google-ap...@googlegroups.com
Query syntax is shown at:


GAM simply passes your query on to Google. You need to put double quotes around the whole query so GAM sees it as one argument and single quotes around any values that contain spaces so Google sees it as one value. Try:

gam print users query "MasterData.id=*"


Jay Lee

--
You received this message because you are subscribed to the Google Groups "Google Apps Manager" group.
To unsubscribe from this group and stop receiving emails from it, send an email to google-apps-man...@googlegroups.com.
To post to this group, send email to google-ap...@googlegroups.com.
Visit this group at http://groups.google.com/group/google-apps-manager.
Reply all
Reply to author
Forward
0 new messages