Kişiler

page = client.contacts.list(limit: 100)contact = client.contacts.get("[email protected]") saved = client.contacts.create(  email: "[email protected]",  name: "Grace Hopper",  notes: "Met at the compiler workshop") client.contacts.update("[email protected]", notes: nil)client.contacts.set_audiences("[email protected]", audienceIds: ["aud_4c1b8e2a7d9f05c36b4e8a71"])client.contacts.delete("[email protected]") puts page.items.size, page.has_more?, contact[:source], contact[:lastSeenAt], saved[:source]

list en son görülen kişileri önce, hiç posta gönderilmemiş kişileri ise en sona koyar. Satır, bir üye uygulamanın yazma ekranından o adrese bir ileti gönderdiği için yazıldıysa source değeri auto olur; bu, birinin onu kaydetmiş olmasından esaslı biçimde farklı bir iddiadır. Bir adresten gelen posta hiçbir şey yazmaz, bu API üzerinden yapılan bir gönderim de yazmaz.

Defter tek bir kişiye değil çalışma alanına aittir; bu yüzden herhangi bir üyenin kaydettiği kişi, her üyenin ve her anahtarın gördüğü kişidir. create, source değerini manual olarak yazar ve kişiyi yazıldığı anda varsayılan kitleye koyar. Aynı çağrıda kendi listelerinize katmak için onları audienceIds içinde belirtin (bu, audiences:write de gerektirir) ya da kişiyi daha sonra Kitleler sayfasında anlatılan audiences.add_contact ile ekleyin. set_audiences bir kişinin hangi listelerde olduğunu tek bir çağrıda tam olarak belirler.

contacts.list bir OpenEmail::Page döndürür; satırlar page.items içindedir ve dolaşma, page.has_more? true olduğu sürece page.next_cursor değerini izler. list_all tüm satırları tek bir Array olarak döndürür, iterate ise onları birer birer verir. get, create, update, save ve set_audiences her biri tek bir kişiyi Symbol anahtarlı bir Hash olarak döndürür: aynı satır ve ek olarak audiences. Adres defterinin bir sınırı yoktur; bu rotanın sessizce 200'de duran bir Array döndürmek yerine sayfalamasının nedeni budur.

set_audiences(email, audienceIds: [...]), tek bir kişinin hangi kitlelerde olduğunu tek bir istekte tam olarak belirler. Kişi, listelenen ve henüz içinde olmadığı her kitleye katılır ve diğer her kitleden ayrılır; çağrı da değişiklikten sonraki kişiyi audiences ile birlikte döndürür. Kişiyi değil üyelikleri yazdığı için audiences:write gerektirir; tekrarlanması hiçbir şeyi değiştirmez, bu yüzden gem bir ağ hatasından sonra onu yeniden dener.

list_people, uygulamadaki Kişiler sayfasının gösterdiği kişileri listeler: kayıtlı kişiler ve postada görülen her adres; her birinde saved, threads ve lastAt bulunur. Bir OpenEmail::PeoplePage döndürür; bu da items, has_more? ve next_cursor alanlarına seen ekler. list ise yalnızca kayıtlı kişileri döndürür. Postada görülen adresler yalnızca anahtar threads:read iznine de sahipse gelir ve gelip gelmediklerini page.seen söyler. sort: değeri recent, name ya da threads olur ve OpenEmail::PEOPLE_SORTS bunları adlandırır. q: adlarda, adreslerde ve notlarda arar; blocked: true ise tüm alan adını kapsayan kurallar dahil, çalışma alanının engel listesinin engellediği kişileri tutar. blockedBy her satırda kuralı belirtir.

page = client.contacts.list_people(sort: "threads", limit: 50) page.items.each do |person|  client.contacts.save(person[:email]) if !person[:saved] && person[:threads].to_i > 5end blocked = client.contacts.list_all_people(blocked: true)puts page.seen, blocked.size

İsteğe bağlı name: ve notes: ile save(email), Kişilere ekle ve Kişilerde tut işlemlerine karşılık gelir: henüz kişi olmayan bir adresi kaydeder, bir gönderimden kaydedilmiş olanı elle kaydedilmiş olarak tutar ve silinmiş olanı geri getirir. delete, Sil işlemine karşılık gelir: kayıtlı kişiyi kaldırır ve adresi gizler, böylece yazma ekranı onu yeniden kaydetmez; yalnızca postada görülmüş bir adresi de kabul eder. Döndürdüğü Hash'teki wasSaved hangisi olduğunu söyler. delete_many tek çağrıda en fazla 200 tanesini siler.

client.contacts.save("[email protected]", name: "Grace Hopper") contact = client.contacts.set_photo("[email protected]", File.binread("photo.jpg"), content_type: "image/jpeg")puts contact[:photoUrl] client.contacts.set_photo("[email protected]", Pathname("photo.png")) client.contacts.remove_photo("[email protected]")client.contacts.delete_many(["[email protected]", "[email protected]"])

block(email) adresi çalışma alanının engel listesine koyar, böylece ondan gelen posta reddedilir, artı etiketini de atar; unblock(email) ise onu engelleyen her kuralı kaldırır. İkisi de settings:write gerektirir, çünkü kişiyi değil engel listesini değiştirirler, ve hiçbiri adresin kişi olmasını gerektirmez.

list_threads(email), adresin her klasörde yazdığı ya da kendisine yazılan konuşma dizilerini sayfalar; list_all_threads ve iterate_threads bunları dolaşır. activity(email), bir kişinin Etkinlik sekmesinin arkasındaki sayıları döndürür: aralık başına alınan ve gönderilen iletiler, yanıtınızı bekleyen konuşma dizileri ve her iki yöndeki medyan yanıt süresi. İkisi de threads:read gerektirir.

threads = client.contacts.list_threads("[email protected]", q: "invoice") activity = client.contacts.activity(  "[email protected]",  minutes: 30 * 24 * 60,  grain: "day",  offset_minutes: Time.now.utc_offset / 60) puts threads.items.size, activity.dig(:totals, :waiting)