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' => null]);$client->contacts->setAudiences('[email protected]', ['audienceIds' => ['aud_4c1b8e2a7d9f05c36b4e8a71']]);$client->contacts->delete('[email protected]'); echo count($page), ' ', $page->hasMore ? 'more to come' : 'that is all', PHP_EOL;echo $contact['source'], ' ', $contact['lastSeenAt'] ?? 'never mailed', ' ', $saved['source'], PHP_EOL;

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->addContact ile ekleyin. setAudiences bir kişinin hangi listelerde olduğunu tek bir çağrıda tam olarak belirler.

contacts->list bir OpenEmail\Result\Page döndürür; satırlar $page->items içindedir ve dolaşma, $page->hasMore true olduğu sürece $page->nextCursor değerini izler. listAll tüm satırları tek bir dizi olarak döndürür, iterate ise onları birer birer veren bir Generator döndürür. get, create, update, save ve setAudiences her biri tek bir kişiyi camelCase anahtarlı bir dizi 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 dizi döndürmek yerine sayfalamasının nedeni budur.

setAudiences($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 istemci bir ağ hatasından sonra onu yeniden dener.

listPeople, 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\Result\PeoplePage döndürür; bu da items, hasMore ve nextCursor 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\Constants\PeopleSorts 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.

use OpenEmail\Constants\PeopleSorts; $page = $client->contacts->listPeople(sort: PeopleSorts::THREADS, limit: 50); foreach ($page as $person) {    if (!$person['saved'] && $person['threads'] > 5) {        $client->contacts->save($person['email']);    }} $blocked = $client->contacts->listAllPeople(blocked: true);echo $page->seen ? 'saved and seen' : 'saved only', ', ', count($blocked), ' blocked', PHP_EOL;

İsteğe bağlı bir name ve notes dizisiyle 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üğü dizideki wasSaved hangisi olduğunu söyler. deleteMany tek çağrıda en fazla 200 tanesini siler.

$client->contacts->save('[email protected]', ['name' => 'Grace Hopper']); $contact = $client->contacts->setPhoto('[email protected]', file_get_contents('photo.jpg'), contentType: 'image/jpeg');echo $contact['photoUrl'], PHP_EOL; $client->contacts->setPhoto('[email protected]', new \SplFileInfo('avatar.png')); $client->contacts->removePhoto('[email protected]');$client->contacts->deleteMany(['[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.

listThreads($email), adresin her klasörde yazdığı ya da kendisine yazılan konuşma dizilerini sayfalar; listAllThreads ve iterateThreads 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->listThreads('[email protected]', q: 'invoice'); $activity = $client->contacts->activity(    '[email protected]',    minutes: 30 * 24 * 60,    grain: 'day',    offsetMinutes: intdiv((int) date('Z'), 60),); echo count($threads), ' threads, ', $activity['totals']['waiting'], ' waiting on you', PHP_EOL;