MailGDocumentation
البدء

التثبيت

تثبيت MailG من Google Workspace Marketplace وفتحه في Google Sheets.

خطوتان: تثبيت الإضافة، ثم تشغيلها من Sheets.

تثبيت MailG

  1. افتح قائمة MailG على Google Workspace Marketplace.
  2. انقر Install.
  3. اختر حساب Google الذي يجب أن يملك التثبيت.
  4. راجع الأذونات وانقر Allow.

عادةً ينتهي التثبيت في أقل من 15 ثانية. يجب أن ترى تأكيدًا بأن الإضافة ثُبّتت.

قائمة Marketplace

إذا لم تكن قائمة Marketplace متاحة بعد في منطقتك، استخدم زر التثبيت على www.mailg.io أو تواصل مع [email protected].

تشغيل MailG في Google Sheets

  1. افتح Google Sheets (حدّث إذا كان Sheets مفتوحًا بالفعل).
  2. انتظر بضع ثوانٍ حتى تُحمّل Extensions (غالبًا ~10–15 ثانية).
  3. انتقل إلى Extensions → MailG for Gmail → 🚀 Start.

لاحقًا يمكنك تشغيل Extensions → MailG for Gmail → 🔄 Refresh Tracking لمزامنة حالات الفتح دون فتح النافذة كاملة.

مشاكل التثبيت

هذه خصائص شائعة في Google Workspace، وليست أخطاء في MailG:

لا أرى نافذة «installed successfully» أبدًا

يحدث هذا غالبًا عند تسجيل الدخول بعدة حسابات Google ولم يستخدم التثبيت الحساب المتوقع.

الحل: افتح نافذة خاصة/تصفح متخفي، سجّل الدخول بحساب الهدف فقط، ثم ثبّت مرة أخرى من Marketplace.

MailG لا يظهر تحت Extensions

  1. حدّث جدول البيانات.
  2. انتظر نحو 10–15 ثانية حتى تُحمّل الإضافات.
  3. تأكد أنك في نفس حساب Google الذي ثبّت MailG.
  4. جرّب جدولًا آخر أو امسح ذاكرة التخزين المؤقت للمتصفح إذا كان لا يزال مفقودًا.

النشر الذاتي / المخصص

تثبيتات Marketplace مُعدّة مسبقًا. إذا نشرت MailG بنفسك، عيّن Apps Script script properties:

PropertyValue
APP_URLعنوان HTTPS عام لـ MailG API
APP_API_KEYنفس المفتاح كما في خادم API

لا يمكن للإضافة الوصول إلى localhost من خوادم Google — استخدم نفقًا (Cloudflare Tunnel، ngrok، إلخ) للاختبار المحلي.

التالي

تابع مع دليل دمج البريد.

On this page