كيفية الحصول على عنوان URL الدائم لرسالة بريد إلكتروني في Gmail مع البرنامج النصي للتطبيقات

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

عنوان URL لأي رسالة بريد إلكتروني هو Gmail يتبع تنسيقًا قياسيًا:

https://mail.google.com/mail/u/<<UserId>>/#label/<<Label>>/<<UniqueId>>

ال UserId هو المعرف المتسلسل لحساب Gmail الذي تم وضعه حاليًا (الافتراضي هو 0). ال Label هو اسم تسمية Gmail التي توجد بها الرسالة (أو استخدامها all). ال UniqueId هو معرف فريد يعينه Gmail لكل رسالة.

المفتاح هنا هو UniqueId تم تعيينه داخليًا بواسطة Gmail.

احصل على روابط رسائل Gmail مع البرنامج النصي لتطبيقات Google

عندما ترسل بريدًا إلكترونيًا باستخدام برنامج Google Apps Script ، تقوم Gmail API بإرجاع معرف فريد يمكنك استخدامه لتحديد عنوان URL لرسالة البريد الإلكتروني في عناصرك المرسلة.

فيما يلي إجراء بسيط لإرسال بريد إلكتروني يتم ترميزه.

const sendGmailMessage = (mimeText) => {
  const GMAIL_API = 'https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send';
  const params = {
    method: 'POST',
    contentType: 'message/rfc822',
    headers: {
      Authorization: `Bearer ${ScriptApp.getOAuthToken()}`
    },
    payload: mimeText
  };
  const response = UrlFetchApp.fetch(GMAIL_API, params);
  const { id: messageId } = JSON.parse(response.getContentText());
  return messageId;
};

الآن بعد أن لديك messageId من رسالة البريد الإلكتروني الصادرة ، هناك ثلاث طرق على الأقل للحصول على عنوان URL (الرابط الثابت) لرسالة البريد الإلكتروني:

الخيار 1: استخدم تنسيق عنوان URL القياسي

const getEmailMessageUrl = (messageId) => {
  return `https://mail.google.com/mail/u/0/#all/${messageId}`;
};

الخيار 2: استخدم البرنامج النصي للتطبيقات للحصول على عنوان URL لخيط البريد الإلكتروني

في هذا النهج ، نحصل على مؤشر الترابط المرتبط برسالة البريد الإلكتروني ثم نحصل على عنوان URL للرسالة الأولى في الموضوع.

const getThreadUrl = (messageId) => {
  const message = GmailApp.getMessageById(messageId);
  return message.getThread().getPermalink();
};

هذا هو النهج المفضل لدي لأنه الأكثر موثوقية. عندما ترسل رسالة بريد إلكتروني ، يتم تعيين معرف رسالة فريد إلى رسالة البريد الإلكتروني بواسطة خدمة إرسال. يتم تخزين معرف الرسالة هذا في Message-Id رأس رسالة البريد الإلكتروني ويستخدمه عميل البريد الإلكتروني الخاص بك لتجميع الرسائل في نفس المحادثة.

يوفر Gmail مشغل بحث خاص RFC822MSGID للبحث في رسائل البريد الإلكتروني حسب معرف الرسالة ويمكننا استخدام مشغل البحث هذا للحصول على عنوان URL لرسالة البريد الإلكتروني.

const getMessageUrl = (messageId) => {
  const message = GmailApp.getMessageById(messageId);
  const rfc822Id = message.getHeader('Message-Id');
  const searchQuery = `rfc822msgid:<${rfc822Id}>`;
  return `https://mail.google.com/mail/u/0/#search/${searchQuery}`;
};

ذات الصلة: احصل على عنوان بريد إلكتروني ثانٍ مع عنوان gmail الخاص بك