ईमेल भेजें

email = client.emails.send(  from: {email: "[email protected]", name: "Acme Billing"},  to: ["[email protected]", "Grace <[email protected]>"],  cc: "[email protected]",  bcc: [{email: "[email protected]"}],  replyTo: "[email protected]",  subject: "Your September invoice",  html: "<p>Invoice attached.</p>",  text: "Invoice attached.",  headers: {"X-Campaign" => "invoices"},  attachments: [{filename: "invoice.pdf", content: Pathname("invoice.pdf")}],  threadId: "CAHk7pQ2x9LmZ4-mail.example.com",  scheduledAt: "PT1H",  tags: {order: "4021"},  tracking: {opens: true, clicks: true}) puts email[:id], email[:status]

to, cc और bcc एक प्राप्तकर्ता या उनकी एक Array लेते हैं, और अकेला हो तो आपके लिए Array में लपेट दिया जाता है। हर एक सादा पता, Name <addr@host>, या email और name वाला Hash हो सकता है।

संदेश keyword arguments के रूप में, या एक Hash के रूप में दिया जाता है। Hash के साथ दिए गए keyword arguments उसमें मिला दिए जाते हैं और जहाँ दोनों एक ही फ़ील्ड का नाम लें वहाँ वही जीतते हैं, इसलिए client.emails.send(message, subject: "Re: your invoice") पहले बनाए गए संदेश का एक फ़ील्ड बदल देता है। कुंजियाँ API के नाम बनाए रखती हैं, इसीलिए replyTo और scheduledAt camelCase में रहते हैं, जबकि idempotency_key: और api_key: कॉल के विकल्प हैं और कभी संदेश का हिस्सा नहीं होते।

Symbol कुंजियों वाला एक Hash, इसलिए email[:status] status पढ़ता है।

translate संदेश को जाने से पहले किसी और की भाषा में लिख देता है। body, और जब तक आप उसे बंद न करें तब तक विषय भी, तब अनूदित होता है जब API रिक्वेस्ट स्वीकार करता है, और जो निकला वही बाहर जाता है: जो अनुवाद बन ही नहीं सका, वह संदेश को आपकी लिखी भाषा में भेजने के बजाय send को अस्वीकार कर देता है।

email = client.emails.send(  from: "[email protected]",  to: "[email protected]",  subject: "Your September invoice",  html: "<p>Invoice attached. Payment is due on the 14th.</p>",  translate: {to: "de"}) p email[:translation]

तब email[:translation] यह पढ़ता है: {language: "de", languageName: "German", detectedSourceLanguage: "en", subject: true, includeOriginal: true}।

जाने से पहले उसे किसी ने नहीं पढ़ा। emails.translate वही आना-जाना है जो एक क़दम पहले रुक जाता है। इसे किसी व्यक्ति को दिखाएँ, उसे बदलने दें, फिर उसने जो स्वीकृत किया उसे कॉल पर बिना किसी translate के भेजें। इसे दोबारा पास करने से दूसरी बार अनुवाद होता और उसके बदलाव फेंक दिए जाते।

preview = client.emails.translate(  subject: "Your September invoice",  html: "<p>Invoice attached. Payment is due on the 14th.</p>",  to: "de") puts preview.dig(:language, :native), preview[:subject], preview[:html]print "Send it as it is? [y/N] " if $stdin.gets.to_s.strip.casecmp?("y")  client.emails.send(    from: "[email protected]",    to: "[email protected]",    subject: preview[:subject],    html: preview[:html]  )end

p OpenEmail::LANGUAGES.size current = client.languages.listp current.size p OpenEmail.resolve_language("Deutsch")&.fetch(:code)p OpenEmail.resolve_language("zh-TW")&.fetch(:code)p OpenEmail.language_by_code("DE")&.fetch(:native)p OpenEmail.rtl_language?("ar")

ये पंक्तियाँ 200 छापती हैं, यानी वे पंक्तियाँ जिनके साथ यह वर्शन आता है, फिर यह कि API में अभी कितनी हैं, फिर "de", "zh-Hant", "Deutsch" और true। यह तालिका picker के क्रम में OpenEmail::LANGUAGES के रूप में साथ आती है, code, label, native, flag और rtl वाले Hashes की एक frozen Array, ताकि पहली रिक्वेस्ट से पहले ही picker भरा जा सके। languages.list यही पंक्तियाँ नेटवर्क से एक सादी Array के रूप में लौटाता है, उस कॉलर के लिए जिसे इस वर्शन के साथ आई पंक्तियों के बजाय मौजूदा पंक्तियाँ चाहिए। OpenEmail.resolve_language एक कोड, अंग्रेज़ी नाम, भाषा का अपना नाम या कोई उपनाम लेता है (zh-TW एक ऐसे कोड का उपनाम है जो अब सूची में नहीं है) और कुछ मेल न खाए तो nil लौटाता है, OpenEmail.language_by_code किसी भी case में सटीक कोड मिलाता है, और सोलह पंक्तियाँ दाएँ से बाएँ हैं। native, label और code को साथ में खोजें, पहले native दिखाएँ, और कोड सहेजें।

• —जिस भाषा को API मिला न सके वह कुछ भी भेजे जाने से पहले translate.to पर validation_error है।
• —30,000 वर्णों से ज़्यादा पर translation_too_long, जब इंस्टॉल में कोई AI कॉन्फ़िगर न हो तो translation_not_configured, जब वर्कस्पेस ने आज की AI कार्रवाइयाँ इस्तेमाल कर ली हों तो 429 ai_quota_exceeded (यह UTC की आधी रात को रीसेट होता है और इस पर पुनः प्रयास नहीं होता), जब प्रदाता ने जवाब न दिया हो तो translation_failed। इनमें से कोई भी फ़ॉलबैक के रूप में संदेश बिना अनुवाद के नहीं भेजता।
• —template के साथ काम करता है: अनुवाद render किए गए आउटपुट का होता है, इसलिए एक संग्रहित body आपके ग्राहकों की हर पढ़ी जाने वाली भाषा में काम आता है। पूरा दस्तावेज़ render करने वाला template अपना doctype, अपने <style> ब्लॉक और अपने @font-face नियम बनाए रखता है: model के पास केवल body जाता है और बाक़ी सब उसके चारों ओर वापस रख दिया जाता है। उसका <title> अछूता छोड़ दिया जाता है, जिसे वैसे भी कुछ नहीं दिखाता।
• —retry का कोई अतिरिक्त ख़र्च नहीं। अनुवाद idempotency fingerprint का हिस्सा नहीं है (रिक्वेस्ट है, translate सहित), इसलिए बिना उत्तर वाले send को उसी Idempotency-Key के साथ दोबारा भेजना पहले से मौजूद संदेश को दोहरा देता है, दूसरी बार अनुवाद करके भेजता नहीं।
• —जो अनुवादित संदेश queued या scheduled है वह अपने स्वीकृत शब्द बनाए रखता है। emails.reschedule फिर भी उसे खिसका सकता है, जबकि emails.update नए शब्दों को 409 translation_locked के साथ अस्वीकार करता है, इसलिए उसकी बात बदलने का मतलब है रद्द करके फिर से भेजना।

नेटवर्क पर content base64 है। बाइट्स पास करें और वे आपके लिए एन्कोड हो जाते हैं: File.binread जैसी binary String, खुली File जैसा IO, या Pathname, जिसे आपके लिए पढ़ लिया जाता है।

attachments = [  {filename: "invoice.pdf", content: File.binread("invoice.pdf"), contentType: "application/pdf"},  {filename: "report.pdf", content: Pathname("report.pdf")},  {fileId: "file_6bb640f5b99e47deb758f1f5"}] client.emails.send(  from: "[email protected]",  to: "[email protected]",  subject: "Your documents",  text: "Both are attached.",  attachments:)