gmail cleaner

Очиститель Gmail

Быстро просматривайте и безвозвратно удаляйте электронные письма в Gmail, соответствующие определенному ярлыку и поисковому запросу.

Это было создано для удаления более 120 тысяч сообщений, которые веб-интерфейс GMail и IMAP не смогли обработать (у них просто истекло время ожидания). Кроме того, мне также нужен был проект для тестирования набора инструментов CI.

Установить

Загрузите заархивированный двоичный файл для вашей ОС со страницы выпуска и распакуйте его.

В качестве альтернативы, если у вас установлен узел, просто клонируйте этот репозиторий с помощью git , а затем выполните npm install . После этого вы можете следовать приведенным ниже примерам, заменив все ссылки на gmail_cleaner-linux на node gmail_cleaner.js .

Примеры

• Удалить до 15 тысяч писем в ярлыке 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.

• Проверьте результат с помощью команды emails :

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

• Использование запроса Gmail для таргетинга на определенные электронные письма и проверка образцов перед их удалением:

  $ ./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.

Подробнее о том, как использовать

Используйте --help или -h чтобы просмотреть информацию об использовании.

$ ./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

Вы также можете просмотреть дополнительную информацию о конкретной команде следующим образом:

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

В рамках процесса аутентификации эта программа по умолчанию временно откроет порт 31338/tcp на локальном хосте. Вы можете использовать другой порт, указав переменную среды GMAIL_CLEANER_PORT , например:

$ GMAIL_CLEANER_PORT=1337 ./gmail_cleaner.js labels

Авторизация и безопасность

Эта программа использует API Gmail, поэтому вам необходимо сначала авторизовать ее, прежде чем она сможет получить доступ к вашей учетной записи Gmail.

При первом доступе к Gmail эта программа не сможет найти файл gmail_token.json и вернется к отображению URL-адреса авторизации. Откройте его в браузере и следуйте инструкциям, чтобы разрешить программе доступ к вашей учетной записи.

После первого запуска вам следует обращаться с файлом gmail_token.json осторожно: любой, у кого есть к нему доступ, также будет иметь доступ к вашей учетной записи Gmail. Если он не отключен с помощью переключателя -s , Gmail Cleaner будет отображать следующее предупреждение системы безопасности при каждом запуске.

 ** 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.

Обратите внимание, что удаление доступа к приложению из https://myaccount.google.com/u/2/permissions просто делает недействительным gmail_token.json , поэтому его больше нельзя использовать для доступа к вашей учетной записи Gmail. «Приложение» Gmail Cleaner на самом деле не имеет и не нуждается в серверном/облачном компоненте, который хранит содержимое gmail_token.json или какую-либо информацию о вашей учетной записи. Если этого недостаточно, вы всегда можете создать свое собственное «приложение», используя следующую инструкцию.

Использование собственного «приложения»

• Создайте проект в консоли разработчика Google и включите в нем API Gmail.
• Настройте экран согласия oAuth в этом проекте. Добавьте https://mail.google.com/ в список областей для авторизации (эта область необходима для API пакетного удаления, используемого gmail_cleaner ).
• Создайте идентификатор клиента OAuth 2.0 на странице учетных данных проекта и загрузите его, чтобы заменить файл ./lib/client_id.json .
• Удалите существующий файл gmail_token.json .

После этого при следующем запуске программы она предложит авторизовать ваше собственное приложение вместо стандартного.