انتقل إلى المحتوى

ضبط توقيع جيميل لكل المستخدمين عبر GAM أو الواجهة البرمجية

كيف ينشر مدير Google Workspace توقيعًا لكل مستخدم عبر Gmail API أو GAM، والصلاحيات المطلوبة، وما الذي يتعطل عادةً.
فريق Sendoffقراءة 2 دقيقة

يضبط مدير Google Workspace توقيع جيميل للجميع عبر الدالة users.settings.sendAs.update (أو patch) في Gmail API، باستخدام حساب خدمة مفوّض على مستوى النطاق وبصلاحية gmail.settings.basic. وأداة GAM، وهي أداة إدارة مفتوحة المصدر تعمل من سطر الأوامر، تغلّف هذه الدالة، فيكفي أمر واحد مع ملف CSV بالمستخدمين لكتابة توقيع شخصي للنطاق كله. ينظّف جيميل شيفرة HTML عند حفظها، والحد الأقصى للتوقيع 10,000 حرف.

ما الذي تفعله الواجهة البرمجية

كل عنوان يرسل منه الشخص، عنوانه الأساسي وأي عناوين بديلة، هو هوية sendAs لها توقيعها. وتحديث الحقل signature لهذه الهوية يعادل تعديل المستخدم له في إعدادات جيميل. انظر sendAs في المسرد.

تحتاج إلى:

  1. مشروع على Google Cloud فيه Gmail API مفعّلة.
  2. حساب خدمة مع التفويض على مستوى النطاق، تأذن له من Admin console ضمن Security ثم API controls.
  3. الصلاحية https://www.googleapis.com/auth/gmail.settings.basic. أما تعديل العناوين البديلة غير العنوان الأساسي فيتطلب أن يعمل حساب الخدمة بتفويض على مستوى النطاق.

باستخدام GAM

تستطيع GAM (ونسختها الموسعة GAMADV-XTD3) ضبط التوقيع من نص أو من ملف HTML، لمستخدم واحد أو مجموعة أو كل المستخدمين. والطريقة الشائعة قالب HTML فيه حقول متغيرة، مع ملف CSV بالأسماء والمسميات، فيحصل كل شخص على بياناته. تختلف الأوامر بين إصدارات GAM، فانسخ الصيغة الدقيقة من صفحة تواقيع send-as في ويكي GAMADV-XTD3، لا من منشور قديم في منتدى.

ما الذي يتعطل عادةً

  • تنظيف HTML. يحذف جيميل بعض الوسوم والأنماط عند الحفظ. جرّب على حساب واحد قبل تشغيل السكربت للجميع.
  • حد 10,000 حرف. الأنماط المضمّنة الطويلة والصور بصيغة base64 تتجاوزه. انظر حدود حجم التوقيع.
  • الصور يجب أن تكون مستضافة. استخدم عناوين HTTPS عامة.
  • الموظفون الجدد وتغيّر المسميات. لا بد من إعادة تشغيل السكربت، وإلا صار التوقيع قديمًا. انظر تحديث التواقيع عند تغيّر المسمى الوظيفي.

دون سكربت

يفعل Sendoff ذلك عبر Gmail API نفسها. في خطة Team تربط Google Workspace، فيزامن الأشخاص من دليلك، ويكتب زر النشر توقيع كل شخص بما في ذلك العناوين البديلة. لا شيء تصونه، ولا يمر بريدك عبر Sendoff. انظر تواقيع الشركة في Google Workspace.

الأسئلة الشائعة

ما الصلاحية التي أحتاجها لضبط تواقيع جيميل؟ تكفي gmail.settings.basic لتحديث التوقيع في هوية sendAs.

هل أستطيع ضبط التواقيع لكل المستخدمين دون أن يسجلوا الدخول؟ نعم، بحساب خدمة مفوّض على مستوى النطاق.

هل يحتفظ جيميل بشيفرة HTML كما هي؟ لا. ينظّف جيميل HTML التوقيع عند الحفظ، فجرّب النتيجة.

المصادر

اصنع توقيعك الآن

كل قالب في Sendoff مبني وفق القواعد الواردة في هذه الأدلة. مجاني وبلا حاجة إلى حساب.

أنشئ توقيعي