Pour commencer nous allons devoir télécharger notre version de GAM.

La page officielle du Wiki vous donne les indications pour pouvoir télécharger GAM : https://github.com/taers232c/GAMADV-X/wiki/Downloads

Nous choisissons une nouvelle installation et lançons la commande depuis notre HOME Directory :

bash <(curl -s -S -L https://git.io/vMHsV)

• Une fois GAM téléchargé, la commande va automatiquement lancer l'installation et la configuration de GAM.
• Vous devrez indiquer à GAM que vous êtes sur Linux et donc ne disposez pas d'un navigateur Internet sur cette Machine (accès par SSH).
• Renseignez votre adresse mail d'Administrateur GSuite. Attention le compte doit être autorisé à créer des projets sur votre Console Google Developers, sinon reportez-vous à la documentation officielle présentant une solution pour configurer GAM en lui indiquant un projet Google à utiliser déjà existant. Il faudra également privilégier un compte générique et non un compte nominatif utilisateur pour éviter un problème après la suppression de son compte.
• GAM vous donnera à plusieurs reprises des liens URL à copier et coller dans votre propre navigateur Internet. Il faudra alors le faire sur un navigateur authentifié avec votre compte Google Administrateur (renseigné précédemment).
• Google vous demandera si vous accepter de donner les accès à l'application en votre nom, acceptez. Il vous donnera un code à copier qu'il faudra coller sur votre machine distante pour l'installation de GAM là où "Enter verification code:" apparaît.
• GAM va automatiquement créer le projet Google sur votre Console Google Developers et activer les API sur le projet.
• Rendez-vous ensuite au lien indiquer et procédez comme indiqué par GAM :
  • Cliquez sur le bouton bleu : Créer des identifiants et sélectionnez ID client OAuth
    • Cliquez sur le bouton bleu : Configurer l'écran d'autorisation
      • Renseignez un nom pour l'application, dans notre exemple : Démo GAM
      • On clique ensuite sur Enregistrer
    • On sélectionne le type d'application : Autre
    • On renseigne le nom de l'application, dans notre exemple : Démo GAM
    • Maintenant Google vous donne un ID client et un code secret client
    • Copiez l'ID client pour le coller dans votre console SSH là où "Enter your Client ID:" apparaît
    • Puis copiez le code secret client pour le coller dans votre console SSH là où "Enter your Client Secret:" apparaît
    • Retournez sur votre navigateur internet pour cliquer sur "OK" afin de fermer le Popup "Client OAuth" et appuyez sur Entrer une fois revenu dans votre console SSH
  • Indiquez que vous êtes prêt pour passer à la suite en renseignant "yes" dans votre console SSH
  • L'écran qui va suivre vous permet de choisir les API que vous souhaitez pouvoir utiliser avec votre projet GAM, pour faire simple nous allons tous les sélectionner dans cette démo en faisant comme suit :
    • Taper "s" pour sélectionner toutes les API
    • Taper "c" pour poursuivre
    • Copiez le lien et rendez-vous y depuis votre navigateur authentifié comme précédemment
    • Autorisez l'application à utiliser les API
    • Copiez le lien donné par Google et collez le dans votre console SSH là où "Enter verification code:" apparaît
    • Indiquez que vous êtes prêt à poursuivre en saisissant "yes"
    • Saisissez l'adresse d'un compte google de votre plateforme (administrateur ou non)
      • GAM va vérifier qu'il soit en mesure d'administrer l'utilisateur
      • Pour votre premier essaie cela doit échouer, GAM va ensuite vous indiquer les éléments nécessaires pour l'autoriser à administrer votre console et vos utilisateurs
      • Pour commencer rendez-vous sur la page pour Gérer l'accès au client API (Admin > Sécurité > Paramètres avancés > Gérer l'accès au client API)
      • Copiez ensuite la valeur de votre "Service Account Client name" pour le coller sur la page web dans "Nom du client"
      • Copiez ensuite la liste des "scopes" fournies par GAM (comme ci-dessous, cela peut différer d'une version à l'autre)

https://mail.google.com/,

https://sites.google.com/feeds,

https://www.google.com/m8/feeds,

https://www.googleapis.com/auth/activity,

https://www.googleapis.com/auth/apps.alerts,

https://www.googleapis.com/auth/calendar,

https://www.googleapis.com/auth/classroom.announcements,

https://www.googleapis.com/auth/classroom.coursework.students,

https://www.googleapis.com/auth/classroom.rosters,

https://www.googleapis.com/auth/classroom.topics,

https://www.googleapis.com/auth/contacts,

https://www.googleapis.com/auth/drive,

https://www.googleapis.com/auth/drive.activity,

https://www.googleapis.com/auth/gmail.modify,

https://www.googleapis.com/auth/gmail.settings.basic,

https://www.googleapis.com/auth/gmail.settings.sharing,

https://www.googleapis.com/auth/spreadsheets

• Pour finir, cliquez sur "Autoriser"
• Revenez sur votre console SSH et saisissez à nouveau "yes"
• GAM va tester une nouvelle fois l'accès pour chaque "scope", tous les statuts doivent devenir "PASS"
• Il faudra continuer à saisir "yes" tant qu'au moins l'un des "scopes" affichera "FAIL"
• Lorsque ce sera bon, GAM vous indiquera "Service account authorization complete."
• GAM a créé un dossier nommé : gamadv-x
• Renommez le de sorte à pouvoir identifier la version de GAM, ceci sera pratique à terme lorsque vous aurez installé plusieurs versions, avec un certain nombre de projets basés sur une version de GAM il vous sera difficile de n'avoir qu'une seule version exploitée.

mv gamadv-x gam4.90.00

• Vous allez maintenant pouvoir créer votre alias GAM, modifiez votre .bashrc pour ajouter un nouvel alias :

alias gam='~/gam4.90.00/gam'

• Mettez à jour vos paramètres dans votre fichier ~/.gam/gam.cfg en copiant-collant la commande suivante :

customer_id=`gam info domain | grep -e "^Customer ID:" | sed -e "s/.* //"`;domain=`gam info domain | grep -e "^Primary Domain:" | sed -e "s/.* //"`;sed -i -e "/^customer_id = /s/=.*/= ${customer_id}/" -e "/^domain = /s/=.*/= ${domain}/" -e "/^no_update_check = /s/=.*/= true/" ~/.gam/gam.cfg