gog

Que fait gog ?

Utilisez gog pour Gmail, Agenda, Drive, Contacts, Sheets et Docs. Nécessite une configuration OAuth.

Configuration (une fois)

• gog auth credentials /chemin/vers/client_secret.json
• gog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheets
• gog auth list

Commandes courantes

• Recherche Gmail : gog gmail search 'newer_than:7d' --max 10
• Recherche de messages Gmail (par email, ignore le threading) : gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account [email protected]
• Envoi Gmail (simple) : gog gmail send --to [email protected] --subject "Salut" --body "Bonjour"
• Envoi Gmail (multi-ligne) : gog gmail send --to [email protected] --subject "Salut" --body-file ./message.txt
• Envoi Gmail (stdin) : gog gmail send --to [email protected] --subject "Salut" --body-file -
• Envoi Gmail (HTML) : gog gmail send --to [email protected] --subject "Salut" --body-html "<p>Bonjour</p>"
• Brouillon Gmail : gog gmail drafts create --to [email protected] --subject "Salut" --body-file ./message.txt
• Envoyer un brouillon Gmail : gog gmail drafts send <draftId>
• Répondre Gmail : gog gmail send --to [email protected] --subject "Re: Salut" --body "Réponse" --reply-to-message-id <msgId>
• Lister les événements de l'agenda : gog calendar events <calendarId> --from <iso> --to <iso>
• Créer un événement dans l'agenda : gog calendar create <calendarId> --summary "Titre" --from <iso> --to <iso>
• Créer un événement avec couleur : gog calendar create <calendarId> --summary "Titre" --from <iso> --to <iso> --event-color 7
• Mettre à jour un événement : gog calendar update <calendarId> <eventId> --summary "Nouveau titre" --event-color 4
• Afficher les couleurs de l'agenda : gog calendar colors
• Recherche Drive : gog drive search "requête" --max 10
• Contacts : gog contacts list --max 20
• Lire une feuille de calcul : gog sheets get <sheetId> "Tab!A1:D10" --json
• Mettre à jour une feuille de calcul : gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Ajouter à une feuille de calcul : gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Effacer une feuille de calcul : gog sheets clear <sheetId> "Tab!A2:Z"
• Métadonnées d'une feuille de calcul : gog sheets metadata <sheetId> --json
• Exporter un document : gog docs export <docId> --format txt --out /tmp/doc.txt
• Afficher un document : gog docs cat <docId>

Couleurs de l'agenda

• Utilisez gog calendar colors pour voir toutes les couleurs d'événement disponibles (IDs 1-11)
• Ajoutez des couleurs aux événements avec le drapeau --event-color <id>
• IDs des couleurs d'événement (d'après la sortie de gog calendar colors) :
  • 1 : #a4bdfc
  • 2 : #7ae7bf
  • 3 : #dbadff
  • 4 : #ff887c
  • 5 : #fbd75b
  • 6 : #ffb878
  • 7 : #46d6db
  • 8 : #e1e1e1
  • 9 : #5484ed
  • 10 : #51b749
  • 11 : #dc2127

Formatage des courriels

• Préférez le texte brut. Utilisez --body-file pour les messages multi-paragraphes (ou --body-file - pour stdin).

• Le même motif --body-file fonctionne pour les brouillons et les réponses.

• --body n'échappe pas \n. Si vous avez besoin de retours à la ligne en ligne, utilisez un heredoc ou $'Ligne 1\n\nLigne 2'.

• Utilisez --body-html uniquement lorsque vous avez besoin d'un formatage riche.

• Balises HTML : <p> pour les paragraphes, <br> pour les sauts de ligne, <strong> pour le gras, <em> pour l'italique, <a href="url"> pour les liens, <ul>/<li> pour les listes.

• Exemple (texte brut via stdin) :

  gog gmail send --to [email protected] \
    --subject "Suivi de réunion" \
    --body-file - <<'EOF'
  Bonjour Nom,
  
  Merci pour la réunion d'aujourd'hui. Prochaines étapes :
  - Élément un
  - Élément deux
  
  Cordialement,
  Votre Nom
  EOF
  

• Exemple (liste HTML) :

  gog gmail send --to [email protected] \
    --subject "Suivi de réunion" \
    --body-html "<p>Bonjour Nom,</p><p>Merci pour la réunion d'aujourd'hui. Voici les prochaines étapes :</p><ul><li>Élément un</li><li>Élément deux</li></ul><p>Cordialement,<br>Votre Nom</p>"
  

Remarques

• Définissez [email protected] pour éviter de répéter --account.
• Pour les scripts, préférez --json avec --no-input.
• Les valeurs des feuilles de calcul peuvent être transmises via --values-json (recommandé) ou sous forme de lignes en ligne.
• Docs prend en charge l'exportation, l'affichage et la copie. Les modifications en place nécessitent un client API Docs (pas dans gog).
• Confirmez avant d'envoyer un courriel ou de créer un événement.
• gog gmail search retourne une ligne par fil de discussion ; utilisez gog gmail messages search lorsque vous avez besoin de chaque courriel individuel retourné séparément.