Kişiler

from openemail import openemail page = openemail.contacts.list(limit=100)contact = openemail.contacts.get('[email protected]') saved = openemail.contacts.create({    'email': '[email protected]',    'name': 'Grace Hopper',    'notes': 'Met at the compiler workshop',}) openemail.contacts.update(saved['email'], {'notes': None})openemail.contacts.set_audiences(saved['email'], {    'audienceIds': ['aud_4c1b8e2a7d9f05c36b4e8a71'],})openemail.contacts.delete(saved['email']) print(len(page['items']), page['hasMore'], contact['source'], contact['lastSeenAt'])

En son görülenler başta, kendisine hiç posta gönderilmemiş kişiler sonda. Satır, bir üye uygulamanın yazma ekranından o adrese mesaj gönderdiği için yazıldığında source değeri auto olur; bu, birinin adresi bilerek kaydetmiş olmasından esasen 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 de katmak için bunları audienceIds içinde belirtin; bu ayrıca audiences:write gerektirir. Ya da kişiyi sonradan openemail.audiences.add_contact ile ekleyin. set_audiences bir kişinin tam olarak hangi listelerde olduğunu tek çağrıda belirtir.

contacts.list bir Page[ContactResource] döndürür; bu yüzden satırlar page['items'] içindedir ve gezinme, page['hasMore'] True olduğu sürece page['nextCursor'] değerini izler; list_all ve iterate bunu sizin için yapar. get, create, save, update, set_audiences, set_photo ve remove_photo her biri tek bir ContactDetailResource döndürür: aynı satır artı audiences. Adres defterinin sınırı yoktur; bu rotanın, sessizce 200'de duran bir liste döndürmek yerine sayfalamasının nedeni budur.

set_audiences(email, {'audienceIds': [...]}) bir kişinin tam olarak hangi kitlelerde olduğunu tek istekte belirtir. Kişi, listelenen ve henüz içinde olmadığı her kitleye katılır, diğer hepsinden ayrılır; çağrı değişiklikten sonraki ContactDetailResource değerini döndürür. Kişiyi değil üyelikleri yazdığı için audiences:write gerektirir ve yinelemek hiçbir şeyi değiştirmez.

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 biri saved, threads ve lastAt ile. list yalnızca kayıtlı kişilerdir. Postada görülen adresler yalnızca anahtar ayrıca threads:read tutuyorsa gelir, page['seen'] de gelip gelmediklerini söyler. sort recent, name ya da threads olur, q adları, adresleri ve notları arar, blocked=True de çalışma alanının engel listesinin engellediği kişileri tutar, tüm alan adını kapsayan kurallar dahil. blockedBy her satırda kuralı belirtir.

from openemail import openemail page = openemail.contacts.list_people(sort='threads', limit=50) for person in page['items']:    if not person['saved'] and (person['threads'] or 0) > 5:        openemail.contacts.save(person['email']) blocked = openemail.contacts.list_all_people(blocked=True)

save(email, {'name': ..., 'notes': ...}), Kişilere ekle ve Kişilerde tut'tur: henüz kişi olmayan bir adresi kaydeder, bir gönderimden kaydedilmiş olanı elle kaydedilmiş olarak tutar ve silinmiş olanı geri getirir. delete Sil'dir: kayıtlı kişiyi kaldırır ve adresi gizler, böylece düzenleyici onu yeniden kaydetmez, yalnızca postada görülmüş bir adresi de kabul eder. wasSaved hangisi olduğunu söyler. delete_many tek çağrıda en fazla 200 tanesini siler.

from pathlib import Path from openemail import openemail openemail.contacts.save('[email protected]', {'name': 'Grace Hopper'}) photo = Path('grace.jpg').read_bytes()contact = openemail.contacts.set_photo('[email protected]', photo, content_type='image/jpeg') openemail.contacts.remove_photo('[email protected]')openemail.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 yazdığı ya da ona yazılan ileti dizilerini tüm klasörlerde sayfa sayfa gezer, list_all_threads ve iterate_threads da hepsini 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, yanıtınızı bekleyen ileti dizileri ve iki yönde ortanca yanıt süresi. İkisi de threads:read gerektirir.

import time from openemail import openemail threads = openemail.contacts.list_threads('[email protected]', q='invoice') activity = openemail.contacts.activity(    '[email protected]',    minutes=30 * 24 * 60,    grain='day',    offset_minutes=time.localtime().tm_gmtoff // 60,) print(len(threads['items']), activity['totals']['waiting'])

• contacts.list()Tam başvuru
• contacts.list_all()Tam başvuru
• contacts.iterate()Tam başvuru
• contacts.get()Tam başvuru
• contacts.create()Tam başvuru
• contacts.save()Tam başvuru
• contacts.update()Tam başvuru
• contacts.set_audiences()Tam başvuru
• contacts.delete()Tam başvuru
• contacts.delete_many()Tam başvuru
• contacts.list_people()Tam başvuru
• contacts.list_all_people()Tam başvuru
• contacts.iterate_people()Tam başvuru
• contacts.set_photo()Tam başvuru
• contacts.remove_photo()Tam başvuru
• contacts.block()Tam başvuru
• contacts.unblock()Tam başvuru
• contacts.list_threads()Tam başvuru
• contacts.list_all_threads()Tam başvuru
• contacts.iterate_threads()Tam başvuru
• contacts.activity()Tam başvuru