Kontaktet

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'])

Të parët ata që janë parë së fundmi, kurse kontaktet të cilëve nuk u është dërguar kurrë mail vijnë të fundit. source është auto kur rreshti u shkrua sepse një anëtar i dërgoi asaj adrese një mesazh nga kompozuesi i aplikacionit, që është një pohim thelbësisht i ndryshëm nga fakti se dikush e ka ruajtur. Mail-i që mbërrin nga një adresë nuk shkruan asgjë, e as një dërgim përmes këtij API-je.

Libri i adresave i përket hapësirës së punës dhe jo një personi, pra një kontakt i ruajtur nga cilido anëtar është kontakti që sheh çdo anëtar dhe çdo çelës. create e shkruan source si manual dhe e vendos kontaktin te audienca e parazgjedhur në çastin që shkruhet. Emërtoni listat tuaja te audienceIds për t'i bashkuar në të njëjtën thirrje, gjë që kërkon edhe audiences:write, ose shtojeni kontaktin më vonë me openemail.audiences.add_contact. set_audiences thotë saktësisht në cilat lista është një kontakt, me një thirrje.

contacts.list kthen një Page[ContactResource], kështu që rreshtat janë te page['items'] dhe përshkimi ndjek page['nextCursor'] sa kohë që page['hasMore'] është True, gjë që list_all dhe iterate e bëjnë për ju. get, create, save, update, set_audiences, set_photo dhe remove_photo kthejnë secila një ContactDetailResource, të njëjtin rresht plus audiences. Libri i adresave është i pakufizuar, prandaj kjo rrugë faqos në vend që të kthejë një listë që ndalej në heshtje te 200.

set_audiences(email, {'audienceIds': [...]}) përcakton saktësisht në cilat audienca është një kontakt, me një kërkesë. Kontakti hyn në çdo audiencë të listuar ku ende nuk është dhe del nga çdo tjetër, dhe thirrja kthen ContactDetailResource pas ndryshimit. Kërkon audiences:write, sepse shkruan anëtarësime dhe jo kontaktin, dhe përsëritja e saj nuk ndryshon asgjë.

list_people liston personat që shfaq faqja Kontaktet në aplikacion: kontaktet e ruajtura dhe çdo adresë e parë në postë, secila me saved, threads dhe lastAt. list janë vetëm kontaktet e ruajtura. Adresat e para në postë vijnë vetëm kur çelësi mban edhe threads:read, dhe page['seen'] thotë nëse erdhën. sort është recent, name ose threads, q kërkon te emrat, adresat dhe shënimet, dhe blocked=True mban personat që i bllokon lista e bllokimit e hapësirës së punës, përfshirë rregullat për domene të tëra. blockedBy emërton rregullin në çdo rresht.

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': ...}) është Shto te kontaktet dhe Mbaje te kontaktet: ruan një adresë që ende nuk është kontakt, mban si të ruajtur me dorë një të regjistruar nga një dërgim dhe kthen një të fshirë. delete është Fshi: heq kontaktin e ruajtur dhe fsheh adresën, që redaktori të mos e regjistrojë sërish, dhe pranon edhe një adresë të parë vetëm në postë. wasSaved thotë cili rast ishte. delete_many fshin deri në 200 në një thirrje.

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) vendos adresën në listën e bllokimit të hapësirës së punës që posta prej saj të refuzohet, duke hedhur çdo etiketë me plus, dhe unblock(email) heq çdo rregull që e bllokon. Të dyja kërkojnë settings:write, sepse ndryshojnë listën e bllokimit dhe jo kontaktin, dhe asnjëra nuk kërkon që adresa të jetë kontakt.

list_threads(email) shfleton faqe pas faqeje fijet që adresa ka shkruar ose ku i është shkruar, në çdo dosje, dhe list_all_threads dhe iterate_threads i përshkojnë të gjitha. activity(email) kthen numrat pas skedës Veprimtaria të një kontakti: të marra dhe të dërguara për çdo interval, fije që presin përgjigjen tënde, dhe koha mesatare e përgjigjes në secilin drejtim. Të dyja kërkojnë threads:read.

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()Referenca e plotë
• contacts.list_all()Referenca e plotë
• contacts.iterate()Referenca e plotë
• contacts.get()Referenca e plotë
• contacts.create()Referenca e plotë
• contacts.save()Referenca e plotë
• contacts.update()Referenca e plotë
• contacts.set_audiences()Referenca e plotë
• contacts.delete()Referenca e plotë
• contacts.delete_many()Referenca e plotë
• contacts.list_people()Referenca e plotë
• contacts.list_all_people()Referenca e plotë
• contacts.iterate_people()Referenca e plotë
• contacts.set_photo()Referenca e plotë
• contacts.remove_photo()Referenca e plotë
• contacts.block()Referenca e plotë
• contacts.unblock()Referenca e plotë
• contacts.list_threads()Referenca e plotë
• contacts.list_all_threads()Referenca e plotë
• contacts.iterate_threads()Referenca e plotë
• contacts.activity()Referenca e plotë