gmail cleaner

Limpiador de Gmail

Eche un vistazo rápidamente y elimine permanentemente los correos electrónicos en Gmail que coincidan con una etiqueta y una consulta de búsqueda específicas.

Esto se creó para eliminar más de 120.000 mensajes que la interfaz web de GMail y IMAP no pudieron manejar (simplemente se agotó el tiempo de espera). Además, también necesitaba un proyecto para probar un montón de herramientas de CI.

Instalar

Descargue el binario comprimido para su sistema operativo desde la página de lanzamiento y extráigalo.

Alternativamente, si tiene el nodo instalado, simplemente clone este repositorio usando git y luego ejecute npm install . Después de eso, puedes seguir los ejemplos a continuación, reemplazando todas las referencias a gmail_cleaner-linux con node gmail_cleaner.js .

Ejemplos

• Elimine hasta 15.000 correos electrónicos en la etiqueta Categories/Updates :

  $ ./gmail_cleaner-linux delete -l " CATEGORY_UPDATES " -n 15000
  Found 10381 matching emails in CATEGORY_UPDATES. Deleting them ...
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  1000 messages deleted.
  381 messages deleted.

• Verifique el resultado usando el comando emails :

  $ ./gmail_cleaner-linux emails -l " CATEGORY_UPDATES "
  No emails found.

• Usar la consulta de Gmail para dirigirse a correos electrónicos específicos y revisar muestras antes de eliminarlos:

  $ ./gmail_cleaner-linux delete -s -l " Corp " -q " subject:Birthday " --dry-run
  Found 47 matching emails in Corp. Deleting them ...
  dry-run is active, skip deleting emails.
  
  $ ./gmail_cleaner-linux emails -s -l " Corp " -q " subject:Birthday " -n 3 --no-snippet
  retrieving headers for 3 emails ..
  
  Matching email messages:
  
  Date                            From                             Subject
  Thu, 7 Nov 2019 22:00:14 +0000  Corp App < [email protected] >  [Employee] Happy Birthday To Foo
  Wed, 6 Nov 2019 22:06:52 +0000  Corp App < [email protected] >  [Employee] Happy Birthday To Bar
  Tue, 5 Nov 2019 22:00:13 +0000  Corp App < [email protected] >  [Employee] Happy Birthday To 42
  
  $ ./gmail_cleaner-linux delete -l " Corp " -q " subject:Birthday "
  Found 47 matching emails in Corp. Deleting them ...
  47 messages deleted.
  
  $ ./gmail_cleaner-linux emails -s -l " Corp " -q " subject:Birthday "
  no emails found.

Más sobre cómo utilizar

Utilice --help o -h para ver información de uso.

$ ./gmail_cleaner-linux -h
Usage: gmail_cleaner-linux < command > [options]

Commands:
  gmail_cleaner-linux labels  List all available Gmail labels
  gmail_cleaner-linux emails  List emails matching specific label and query
  gmail_cleaner-linux delete  Delete emails matching specific label and query

Options:
  --version              Show version number                           [boolean]
  --sec-warning-off, -s  Don ' t display security warning                [boolean]
  --verbose, -v          Show more verbose information                 [boolean]
  --help, -h             Show help                                     [boolean]

Examples:
  gmail_cleaner-linux delete -l "SPAM"      Delete all emails labeled "SPAM"
  gmail_cleaner-linux delete -l "INBOX" -q  Delete emails in "INBOX" that has
  "subject:spam" --unsafe                   ' spam ' in subject

También puedes ver más información sobre un comando específico como este:

$ ./gmail_cleaner-linux delete -h
$ ./gmail_cleaner-linux emails -h

Como parte del proceso de autenticación, este programa de forma predeterminada abrirá temporalmente el puerto 31338/tcp en localhost. Puede utilizar otro puerto especificando la variable de entorno GMAIL_CLEANER_PORT , por ejemplo:

$ GMAIL_CLEANER_PORT=1337 ./gmail_cleaner.js labels

Autorización y Seguridad

Este programa utiliza la API de Gmail, por lo que primero debe autorizarlo antes de que pueda acceder a su cuenta de Gmail.

La primera vez que acceda a Gmail, este programa no podrá localizar el archivo gmail_token.json y volverá a mostrar una URL de autorización. Ábrelo en un navegador y sigue los pasos para autorizar al programa a acceder a tu cuenta.

Después de esa primera ejecución, debes manejar el archivo gmail_token.json con cuidado: cualquiera que tenga acceso a él también tendrá acceso a tu cuenta de Gmail. A menos que se desactive con el interruptor -s , Gmail Cleaner mostrará la siguiente advertencia de seguridad en cada ejecución.

 ** SECURITY WARNING **

Do the following when you no longer need to use this program in the near future.
- Remove the app access to your account from https://myaccount.google.com/u/2/permissions
- Remove gmail_token.json file. Anyone who has access to it will have full control over your Gmail account.

Tenga en cuenta que eliminar el acceso a la aplicación desde https://myaccount.google.com/u/2/permissions simplemente invalida gmail_token.json , por lo que ya no se puede utilizar para acceder a su cuenta de Gmail. La "aplicación" Gmail Cleaner realmente no tiene ni necesita un componente de servidor/del lado de la nube que almacene el contenido de gmail_token.json o cualquier información sobre su cuenta. Si eso no es lo suficientemente bueno, siempre puedes crear tu propia "aplicación" siguiendo las siguientes instrucciones.

Usando tu propia "App"

• Cree un proyecto en Google Developer Console y habilite la API de Gmail en él.
• Configure una pantalla de consentimiento de oAuth en ese proyecto. Agregue https://mail.google.com/ a la lista de ámbitos para autorizar (ese alcance es necesario para la API de eliminación por lotes utilizada por gmail_cleaner ).
• Cree un ID de cliente OAuth 2.0 desde la página Credenciales del proyecto y descárguelo para reemplazar el archivo ./lib/client_id.json .
• Elimine el archivo gmail_token.json existente.

Después de eso, la próxima vez que ejecute el programa, le pedirá que autorice su propia aplicación en lugar de la predeterminada.