الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

gmail-unsubscribe

يقوم برنامج Google Apps Script + Combo Google Combo بإلغاء وصفك من جميع الرسائل ذات التسمية المحددة (الافتراضي "إلغاء الاشتراك"). على عكس الخدمات مثل unroll.me التي تبيع بياناتك ولكن لا تعمل بالفعل ، فإن هذا البرنامج النصي خاص تمامًا : جميع البيانات تبقى في حساب Google الخاص بك ، ويمكنك التحقق من سلوك البرنامج النصي من خلال قراءة مصدره قبل منحه الوصول إلى حسابك .

احصل عليه هنا!

لقطة الشاشة من القائمة

الاستخدام

الجري لأول مرة

  1. انسخ Gmail Unsbscriber إلى Google Drive. ستتمكن من مراجعة الرمز قبل إنشاء النسخة. هذه النسخة ، بما في ذلك الرمز ، خاصة بك تمامًا ولا يمكن الوصول إليها أو تحديثها من قبل أي شخص آخر.
  2. (اختياري) لتغيير الملصقات التي يستخدمها البرنامج النصي ، اختار "Gmail Unsubscriber> الإعدادات ..."
  3. اختر "Gmail unbscriber> إنشاء ملصقات". سيؤدي ذلك إلى إنشاء الملصقات في حساب Gmail الخاص بك. اسمح للنص بالوصول إلى حساب Gmail الخاص بك عند المطالبة.
  4. افتح صندوق الوارد Gmail الخاص بك ، وأضف تسمية "إلغاء الاشتراك" إلى بعض رسائل البريد الإلكتروني غير المرغوب فيها. يمكنك النقر على رسائل البريد الإلكتروني وسحبها على الملصق.
  5. ارجع إلى جدول البيانات واختر "Gmail unbscriber> Run Now" لإلغاء الاشتراك من الرسائل التي تم وضع علامة عليها للتو. بعد لحظات قليلة ، يجب أن ترى حالة كل مؤشر ترابط تظهر في جدول البيانات.

تشغيل تلقائيا

يمكنك اختيار "Gmail unbscriber> بدء تشغيل" لتشغيل البرنامج النصي بشكل دوري ، حتى عند إغلاق جدول البيانات.

وبهذه الطريقة ، يمكنك إسقاط رسائل بريد إلكتروني جديدة في تسمية "إلغاء الاشتراك" وقتما تشاء ، وسيقوم البرنامج النصي تلقائيًا بإلغاء الاشتراك منها.

يمكنك استخدام مرشحات Gmail لإضافة تسمية "إلغاء الاشتراك" تلقائيًا إلى أنواع معينة من رسائل البريد الإلكتروني أو المرسلين أيضًا.

استكشاف الأخطاء وإصلاحها

إذا لم نتمكن من معرفة كيفية إلغاء الاشتراك من مؤشر ترابط أو حدوث خطأ ، فسوف نضيف ملاحظة إلى جدول البيانات ، وإعادة تسمية البريد الإلكتروني "فشل إلغاء الاشتراك". يمكنك النقر فوق موضوع موضوع لفتحه في Gmail وإلغاء الاشتراك يدويًا.

يزيل

  • تعطيل مؤقتًا: اختر "Gmail unbscriber> توقف عن التشغيل" لإيقاف البرنامج النصي من التشغيل تلقائيًا.
  • إزالة بشكل دائم: احذف الورقة من محرك الأقراص.

كيف تعمل

يوفر برنامج تطبيقات Google API API يتيح لنا الاتصال بحساب Gmail الخاص بك من ورقة Google. نستخدم API هذا للاستعلام عن مؤشرات الترابط مع التسمية "Unsbscribe" (قابلة للتكوين). لكل موضوع ، نحاول عدة طرق لإلغاء الاشتراك:

  • تتضمن رسائل البريد الإلكتروني من القوائم ذات السمعة الطيبة رأس list-unsubscribe ، وهو تعليمات قابلة للقراءة الآلي لكيفية إلغاء الاشتراك تلقائيًا.
    • من الناحية المثالية ، يحدد الرأس mailto: رابط مثل mailto:[email protected]?subject=XXXXX الذي يحدد كيفية إلغاء الاشتراك من القائمة عن طريق إرسال بريد إلكتروني. إذا رأينا هذا ، فقد أرسلنا البريد الإلكتروني إلغاء الاشتراك تلقائيًا.
    • إذا كان الرأس يحدد عنوان ويب مثل https://example.com/unsubscribe?id=XXXXX ، فقد أرسلنا طلب POST HTTP إلى هذا العنوان.
  • إذا لم يتم العثور على رأس ، فإننا ننظر في جسم HTML للبريد الإلكتروني للحصول على روابط تحتوي على كلمة "إلغاء الاشتراك". إذا وجدت ، نرسل HTTP GET على طلب إلى عنوان URL هذا. قد لا يعمل هذا إذا كانوا يتوقعون أن تتفاعل مع الصفحة لإلغاء الاشتراك.

بعد ذلك ، نقوم بتسجيل حالة مؤشر الترابط في جدول البيانات ، ونغير ملصق الخيط من "إلغاء الاشتراك" إلى "إلغاء النجاح" أو "إلغاء الاشتراك فشل" (قابل للتكوين).

يحتوي الكود المصدر على تعليقات مكتوبة لمبرمجي المبتدئين إذا كنت ترغب في معرفة المزيد.

معلومات المطور

يتكون البرنامج من جزأين - ورقة Google لواجهة المستخدم ، ومصدر البرنامج النصي للتطبيقات الذي يعمل على تشغيل الإجراءات. يحتوي هذا الريبو فقط على مصدر برنامج Apps Script ، ويحتاج إلى الاتصال بورقة Google للعمل. نستخدم Google/Clasp لإدارة مصدر Script Apps.

بمجرد نسخ الورقة إلى حسابك ، يمكنك تحرير ملف .clasp.json للإشارة إلى معرف نسختك.

ثم ، قم بتثبيت تبعيات التطوير مع yarn install أو npm install .

لنشر البرنامج النصي على حسابك ، قم بتشغيل yarn push أو npx clasp push . في المرة الأولى التي تقوم فيها بذلك ، سوف يسير clasp لك من خلال تصريح حساب Google الخاص بك وتمكين Apps Script API. انظر دليل المشبك لمزيد من المعلومات.

يمكنك إضافة --watch إلى أمر الضغط للدفع كلما قمت بتحرير ملف.

الاعتمادات

كتب Amit Agarwal إصدار 2017 الأصلي من Gmail-unsubscribe. اقرأ المقال الأصلي هنا: كيفية إلغاء الاشتراك من قوائم البريد والنشرات الإخبارية غير المرغوب فيها في Gmail.

قام جيك تيتون لاندس بإعادة كتابة البرنامج النصي إلى الميزات المضافة والمشكلات التي تم تصحيحها التي جعلت الأصل غير الفعال:

  • تمت إضافة زر "تشغيل الآن" لاتخاذ الإجراء على الفور ، وأعيد صياغة القوائم لإظهار حالة النص والإعدادات.
  • تمت إضافة علامات "النجاح" و "FAIL" للفرز داخل Gmail.
  • أخطاء منطقية ثابتة تسببت في تعطل الإصدار القديم على رسائل البريد الإلكتروني الخاصة بي.
  • تحسين معالجة الأخطاء. تم إحباط الإصدار القديم على الخطأ الأول في أي مؤشر ترابط بدون مؤشر للمستخدم. إلى جانب الجدول الزمني لمدة 15 دقيقة ، سيستغرق الأمر 12 ساعة لمعالجة 100 رسالة بريد إلكتروني بمعدل فشل قدره 50 ٪. سيقوم نسختنا بتسجيل الخطأ في جدول البيانات والمتابعة إلى الموضوع التالي ، وخفض الوقت إلى ~ دقائق.
  • افترض الإصدار القديم أن طلب الحصول على رابط في الجسم يكفي لإلغاء الاشتراك. ما زلنا نحاول إرسال طلب الحصول على الحصول ، ولكن يتم وضع علامة "ربما" في جدول البيانات ونقلها إلى علامة "Fail" حتى يتمكن المستخدم من الفرز.
  • تحسين المعالجة المتوافقة مع RFC لرأس list-unsubscribe :
    • بالنسبة إلى http(s): نحن الآن بما في ذلك تشمل هيئة list-unsubscribe-post في الطلب ، وهو أمر مطلوب لإلغاء الاشتراك بنقرة واحدة ، لكل RFC8058 القسم 3.2.
    • بالنسبة إلى mailto: عنوان URL ، نحترم الآن معلمات subject body ، والتي قد تكون ضرورية لتحديد المستخدم عند إلغاء الاشتراك ، كما هو مقترح في أمثلة في RFC2369.
  • مكتوبة في TypeScript ، ملتزمة بـ GIT ، ودفعت إلى Github ، وإدارتها مع clasp .
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل