Audiències
`audiences.list`, `get`, `create`, `update`, `delete`, `listContacts`, `addContact` i `removeContact`.
Tots els mètodes
const audiences = await openemail.audiences.list()const everyone = audiences.find((audience) => audience.builtin === 'default') const list = await openemail.audiences.create({ name: 'Product updates', description: 'Customers who asked to hear about releases',}) await openemail.contacts.create({ email: '[email protected]', name: 'Grace Hopper' })await openemail.audiences.addContact(list.id, { email: '[email protected]' }) const members = await openemail.audiences.listContacts(list.id, { limit: 200 }) await openemail.audiences.update(list.id, { name: 'Release notes' })await openemail.audiences.removeContact(list.id, '[email protected]')await openemail.audiences.delete(list.id) console.log(everyone?.contactCount, members.length)Una audiència és una llista de contactes amb nom dins d'aquest espai de treball. Tot contacte és a l'audiència per defecte integrada des del moment en què existeix, i builtin és el que identifica aquella fila; la resta les crees, les omples i les esborres tu. Ramifica segons builtin i no segons el nom, que qualsevol pot canviar.
Aquesta versió gestiona llistes i no els envia res. No hi ha cap mètode de difusió que valgui la pena buscar, i posar un contacte en una audiència és una escriptura a l'audiència i no pas al contacte, de manera que audiences:write és l'únic scope que es comprova.
addContact accepta una adreça que ja sigui un contacte i rebutja la que no ho és, amb un 422 contact_not_found. Desa-la abans amb openemail.contacts.create. Afegir algú dues vegades respon amb la pertinença que ja hi havia, amb el seu addedAt original, de manera que la crida es pot reintentar sense perill.
L'audiència per defecte es pot reanomenar i descriure com qualsevol altra, però no es pot esborrar ni buidar parcialment. Totes dues coses es rebutgen amb un 409 audience_immutable. Esborra el contacte quan el que vols és que marxi el contacte.
Resposta: AudienceResource
list es resol en un array pla d'aquests, amb l'audiència per defecte primer i la resta de la més nova a la més antiga, i get, create i update es resolen cadascun en un de sol. listContacts, en canvi, es resol en un array de ContactResource, és a dir, els contactes mateixos i no pas registres de pertinença.
idstring- L'identificador durador, `aud_` seguit de 24 caràcters hexadecimals. Els noms no són únics, així que això és el que ha d'anar a la configuració desada.
namestring- S'escapça en escriure, d'1 a 120 caràcters. Dues audiències poden compartir nom, perquè una audiència s'adreça pel seu id.
descriptionstring | null- Text lliure per a qui llegeixi la llista més endavant. Null quan ningú no n'ha escrit cap, i un null explícit a `update` el buida.
builtin'default' | (string & {}) | null- `default` en exactament una fila per espai de treball, l'audiència que conté tots els contactes, i null a totes les audiències creades per algú. La unió es manté oberta perquè una audiència integrada afegida més endavant s'acoti dins d'un editor sense trencar el tipus publicat.
contactCountnumber- Quants contactes hi ha a l'audiència, comptats en el moment de la lectura i no pas desats en memòria cau. Dues lectures a banda i banda d'un `contacts.create` difereixen en un.
createdAtstring- ISO-8601 UTC, quan es va crear l'audiència. Fixa l'ordre de la llista després de la per defecte.
updatedAtstring- ISO-8601 UTC, actualitzat per un canvi de nom o de descripció. Els canvis de pertinença no el toquen.