Dërgoni një email

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 dhe bcc marrin një marrës ose një Array marrësish, dhe një marrës i vetëm mbështillet për ju. Secili mund të jetë një adresë e zhveshur, Name <addr@host> ose një Hash me email dhe name.

Mesazhi jepet si argumente me fjalë kyçe ose si një Hash i vetëm. Argumentet me fjalë kyçe pranë një Hash-i bashkohen në të dhe kanë përparësi kur të dyja emërtojnë një fushë, ndaj client.emails.send(message, subject: "Re: your invoice") ndryshon një fushë të një mesazhi që e ndërtuat më parë. Çelësat ruajnë emrat e API-së; prandaj replyTo dhe scheduledAt mbeten në camelCase, ndërsa idempotency_key: dhe api_key: janë opsione të thirrjes dhe kurrë pjesë e mesazhit.

Një Hash me çelësa Symbol, ndaj email[:status] lexon statusin.

translate e shkruan mesazhin në gjuhën e dikujt tjetër para se ai të niset. Trupi, dhe subjekti veç nëse e fikni, përkthehet kur API-ja e pranon kërkesën, dhe ajo që doli është ajo që niset: një përkthim që nuk mund të prodhohej e refuzon dërgimin në vend që ta nisë mesazhin në gjuhën në të cilën e shkruat.

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]

Atëherë email[:translation] lexon {language: "de", languageName: "German", detectedSourceLanguage: "en", subject: true, includeOriginal: true}.

Askush nuk e lexoi atë para se të nisej. emails.translate është e njëjta vajtje-ardhje e ndalur një hap më herët. Tregojani një personi, lëreni ta ndryshojë, pastaj dërgoni atë që ai miratoi pa asnjë translate te thirrja. Dhënia e tij sërish do ta përkthente tekstin për herë të dytë dhe do t’i hidhte poshtë redaktimet e tij.

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")

Këto rreshta printojnë 200, rreshtat me të cilët vjen ky version, pastaj sa mban API-ja tani, pastaj "de", "zh-Hant", "Deutsch" dhe true. Tabela përfshihet në gem, në rendin e përzgjedhësit, si OpenEmail::LANGUAGES, një Array i ngrirë Hash-esh me code, label, native, flag dhe rtl, ndaj një përzgjedhës mund të mbushet para kërkesës së parë. languages.list kthen të njëjtët rreshta nga rrjeti si Array i thjeshtë, për një thirrës që preferon rreshtat aktualë në vend të atyre me të cilët erdhi ky version. OpenEmail.resolve_language merr një kod, një emër në anglisht, një endonim ose një pseudonim (zh-TW është pseudonim i një kodi që nuk listohet më) dhe kthen nil kur asgjë nuk përputhet, OpenEmail.language_by_code përputh një kod të saktë pavarësisht shkronjave të mëdha a të vogla, dhe gjashtëmbëdhjetë nga rreshtat shkruhen nga e djathta në të majtë. Kërkoni njëkohësisht te native, label dhe code, tregoni së pari native dhe ruani kodin.

• —Një gjuhë që API-ja nuk mund ta përputhë jep një validation_error te translate.to, para se të dërgohet çfarëdo.
• —translation_too_long mbi 30.000 karaktere, translation_not_configured kur instalimi nuk ka AI të konfiguruar, një 429 ai_quota_exceeded kur hapësira e punës i ka përdorur veprimet e AI-së për sot (rivendoset në mesnatë UTC dhe nuk riprovohet), translation_failed kur ofruesi nuk u përgjigj. Asnjëri prej tyre nuk e dërgon mesazhin të papërkthyer si zgjidhje rezervë.
• —Funksionon me template: ajo që përkthehet është dalja e RENDERUAR, kështu që një trup i vetëm i ruajtur u shërben të gjitha gjuhëve në të cilat lexojnë klientët tuaj. Një template që renderon një dokument të tërë e ruan doctype-in e vet, blloqet e veta <style> dhe rregullat @font-face: te modeli shkon vetëm trupi dhe pjesa tjetër vendoset sërish rreth tij. <title> i tij lihet i paprekur, gjë që nuk e shfaq gjithsesi asgjë.
• —Një riprovim nuk kushton asgjë më shumë. Përkthimi nuk është pjesë e gjurmës së idempotencës (kërkesa është, përfshirë translate), kështu që riprovimi i një dërgimi pa përgjigje me të njëjtin Idempotency-Key riluan mesazhin që ekziston tashmë në vend që të përkthejë e të dërgojë një të dytë.
• —Një mesazh i përkthyer që është në radhë ose i planifikuar e ruan tekstin e miratuar. emails.reschedule e zhvendos ende, ndërsa emails.update e refuzon një tekst të ri me një 409 translation_locked, ndaj ndryshimi i asaj që thotë do të thotë anulim dhe dërgim nga e para.

content është base64 në rrjet. Jepni bajtet dhe ato kodohen për ju: një String binar si ai që kthen File.binread, një IO si një File i hapur, ose një Pathname, që lexohet për ju.

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:)