Gmail Temizleyici
Hazırlayan Otopilot EkibiSon güncelleme:
Kısa özetReklam ve promosyon postalarını kurallarınıza göre bulur, önce rapor verir, onayınızla çöp kutusuna taşır.
Kendi bilgisayarınızda veya sunucunuzda çalışır. Google OAuth istemcisini siz oluşturursunuz, postalarınız bize gelmez.
Neler yapar
- Kural tabanlı temizlik
- Önce rapor, sonra çöp kutusuna taşıma
- Postalar sizde kalır
Çalışma yeri
Kendi sunucumda
Paketi indirip kendi sunucunuza kurarsınız. Lisans anahtarı ile çalışır.
Platformlar
Gmail
Fiyata dahil
Temel, Standart destek, Zamanlı
Bir lisansla 1 kurulum
Ne yapar?
Gmail Temizleyici, kendi Gmail hesabınızdaki reklam, bülten ve promosyon postalarını sizin belirlediğiniz kurallarla bulur. Varsayılan olarak yalnız rapor verir; --apply ile eşleşen postaları çöp kutusuna taşır, kalıcı silmez ve Gmail çöp kutusundan 30 gün içinde geri alınabilir. Kendi Google Cloud OAuth istemcinizle çalışır, yalnız gmail.modify yetkisi ister ve postalarınız hiçbir sunucuya gönderilmez. Yapay zekâ kullanmaz.
Kimin işine yarar?
- Gelen kutusu promosyon ve bülten postasıyla dolan bireysel kullanıcılar
- Belirli göndericilerden gelen eski postaları düzenli temizlemek isteyenler
- Banka ve muhasebe gibi önemli göndericilere hiç dokunulmamasını isteyen işletme sahipleri
- Postalarının üçüncü bir hizmete gitmesini istemeyen kullanıcılar
Gereksinimler
- Python 3.10 veya üstü
- pip install -r requirements.txt ile kurulan requests, google-api-python-client, google-auth-oauthlib ve google-auth paketleri
- Kendi Google Cloud projenizde Gmail API'si etkin bir Masaüstü uygulaması OAuth istemcisi (client_secret.json)
- Panelden alınan lisans anahtarı; license.domain alanına lisansladığınız Gmail adresi yazılır
- İlk izin için tarayıcı açabilen bir bilgisayar
Adım adım kurulum ve kullanım
- 1Paketi Lisanslarım sayfasından indirip açın ve gmail-cleaner klasörüne geçin.
- 2Bağımlılıkları kurun: pip install -r requirements.txt
- 3console.cloud.google.com üzerinde yeni proje açın ve Gmail API'yi etkinleştirin.
- 4OAuth izin ekranını Harici olarak ayarlayın ve kendinizi test kullanıcısı olarak ekleyin.
- 5Kimlik bilgileri > OAuth istemci kimliği > Masaüstü uygulaması ile istemci oluşturun, JSON dosyasını paket klasörüne client_secret.json adıyla koyun.
- 6Ayar dosyasını oluşturun: cp config.example.json config.json; license.domain alanına Gmail adresinizi yazın.
- 7Lisans anahtarını verin: export BOT_LICENSE_KEY=...
- 8Lisansı kontrol edin: python3 bot.py check
- 9Rapor alın: python3 bot.py run; ilk çalıştırmada tarayıcıda izin istenir, izin anahtarı data/gmail-token.json dosyasına yalnız sizin okuyabileceğiniz izinle kaydedilir.
- 10Raporda her kuralın kaç posta bulduğunu ve toplamı kontrol edin; kuralları rules bölümünde düzenleyin.
- 11Taşımak için: python3 bot.py run --apply; eşleşen postalar çöp kutusuna taşınır.
- 12Zamanlama için /etc/cron.d/ altına dosya ekleyin, örnek: 30 7 * * * kullanici cd /yol/gmail-cleaner && BOT_LICENSE_KEY=... /usr/bin/python3 bot.py >> data/cron.log 2>&1; bu satır yalnız rapor verir, otomatik taşıma için komutun sonuna run --apply ekleyin.
Ayarlar ve anlamları
- license.domain
- Lisansladığınız Gmail adresi.
- gmail.client_secret_file
- OAuth istemci dosyasının yolu (varsayılan client_secret.json).
- gmail.open_browser
- İlk izinde tarayıcının kendiliğinden açılıp açılmayacağı (varsayılan true).
- rules.queries
- Gmail arama ifadeleri, örnek category:promotions. Boş bırakılırsa paketteki varsayılan liste kullanılır.
- rules.senders
- Bu göndericilerden gelen postalar (from: araması).
- rules.domains
- Bu alan adlarından gelen postalar.
- rules.keep_senders
- Hiçbir kuralda dokunulmayacak göndericiler (banka, muhasebe vb.).
- rules.protect_starred_important
- true ise yıldızlı ve önemli postalar hariç tutulur (varsayılan açık).
- rules.older_than_days
- Yalnız bu günden eski postalar eşleşir (örnekte 14).
- rules.max_per_run
- Tek çalıştırmada işlenecek en fazla posta (örnekte 2000).
- run.data_dir
- İzin anahtarı, kayıtlar ve lisans önbelleği klasörü (varsayılan data).
Sınırlar ve yapamadıkları
- Sürekli açık kalan bir izleyici modu yoktur; yeni gelen postalar yalnız bot çalıştırıldığında (elle veya cron ile) taranır.
- Postalar kalıcı silinmez, çöp kutusuna taşınır; Gmail çöp kutusunu 30 gün sonra kendisi boşaltır.
- Tek çalıştırmada en fazla rules.max_per_run kadar posta işlenir; büyük kutularda birkaç çalıştırma gerekebilir.
- Kurallar Gmail arama ifadeleriyle çalışır; içerik okuyarak sınıflandırma veya yapay zekâ kullanılmaz.
- Google OAuth istemcisini ve test kullanıcısı ayarını sizin oluşturmanız gerekir; pakette Google hesabı veya anahtarı bulunmaz.
Sık karşılaşılan sorunlar ve çözümleri
OAuth istemci dosyası yok: .../client_secret.json hatası.
Google Cloud'dan indirdiğiniz Masaüstü uygulaması JSON dosyasını paket klasörüne client_secret.json adıyla koyun veya gmail.client_secret_file ile yolunu verin.
Google izin ekranı erişimi engelliyor.
OAuth izin ekranında kendi Gmail adresinizi test kullanıcısı olarak eklediğinizi kontrol edin.
Daha önce verilen izin iptal edildi veya yenilenemiyor.
data/gmail-token.json dosyasını silip python3 bot.py run ile izni yeniden verin.
LİSANS: Lisans doğrulanmadı ... mesajı.
license.domain alanındaki Gmail adresinin lisanstaki adresle aynı olduğunu ve lisans anahtarını kontrol edin.
Rapor kipi: hiçbir posta taşınmadı mesajı.
Bu bir hata değildir; taşımak için komuta --apply ekleyin. --dry-run ile birlikte verilirse yine taşıma yapılmaz.
Güncelleme ve destek
Standart destek pakete dahildir; destek talebi veya e-postayla iş günlerinde yanıt veririz. Süreli lisansta güncellemeler lisans süresince, ömür boyu lisansta 12 ay boyunca Lisanslarım sayfasından sunulur. Google Cloud kurulumunu bizim yapmamızı isterseniz Kurulumu biz yapalım, daha hızlı yanıt için Öncelikli destek seçeneğini ekleyebilirsiniz. Destek sırasında postalarınızı veya izin anahtarı dosyanızı bizimle paylaşmanız gerekmez.
Sık sorulan sorular
Postalarım size veya başka bir sunucuya gider mi?
Hayır. Bot kendi bilgisayarınızda veya sunucunuzda, kendi OAuth istemcinizle doğrudan Gmail API'sine bağlanır. Lisans doğrulamasında yalnız anahtar, ürün kodu, alan adı ve sürüm gönderilir.
Yanlış posta silinirse geri alabilir miyim?
Evet. Bot postaları kalıcı silmez, çöp kutusuna taşır; Gmail çöp kutusundan 30 gün içinde geri alabilirsiniz.
Önemli postalarım korunur mu?
rules.protect_starred_important açıkken yıldızlı ve önemli postalar hariç tutulur, rules.keep_senders listesindeki göndericilere hiç dokunulmaz.
Yapay zekâ anahtarı gerekir mi?
Hayır. Bu ürün yapay zekâ kullanmaz, yalnız Gmail arama kurallarıyla çalışır.
Gmail Temizleyici hangi platformlarda çalışır?
Desteklenen platformlar: Gmail.
Gmail Temizleyici nerede çalışır, nasıl teslim edilir?
Kendi sunucumda: Paketi indirip kendi sunucunuza kurarsınız. Lisans anahtarı ile çalışır.
Bir lisansla kaç kurulum yapabilirim?
Bir lisansla 1 kurulum yapabilirsiniz. Lisans anahtarınız hesabınızdaki Lisanslarım sayfasında görünür.
Memnun kalmazsam iade alabilir miyim?
7 gün iade: Ödeme tarihinden itibaren 7 gün içinde gerekçe göstermeden iade isteyebilirsiniz.