Аудитории
Именованные списки, на которые разбиты контакты.
Инструменты аудиторий
| Инструмент | Что делает |
|---|---|
| listAudiences | Списки, на которые этот ящик разбивает свои контакты, начиная со списка по умолчанию. Аудитория — это группировка и ничего больше. |
| getAudience | Одна аудитория целиком: её название, для чего она, сколько в ней контактов и является ли она аудиторией по умолчанию. |
| createAudience | Создать именованный список. Он создаётся пустым, и ничто не мешает двум аудиториям носить одно название, поэтому сначала прочитайте список. |
| updateAudience | Переименовать аудиторию или изменить описание её назначения. Аудиторию по умолчанию можно переименовать, как любую другую, и она остаётся аудиторией по умолчанию, как бы ни называлась. |
| deleteAudience | Удалить аудиторию. Членство уходит, каждый контакт, который в ней был, остаётся. Аудиторию по умолчанию удалить нельзя. |
| listAudienceContacts | Кто входит в одну аудиторию. Запрос аудитории по умолчанию перечисляет все контакты этого ящика. |
| addContactToAudience | Поместить существующий контакт в аудиторию. Контакт при этом никогда не создаётся, потому что адрес с опечаткой стал бы постоянной строкой, о которой никто не просил. |
| removeContactFromAudience | Убрать контакт из аудитории. Он остаётся контактом, со своими заметками и своими другими аудиториями. |
У каждого ящика есть аудитория по умолчанию, содержащая все контакты, и это единственное здесь, что нельзя ни удалить, ни проредить. Убрать оттуда кого-то означало бы контакт, который listContacts показывает, а listAudienceContacts не может, — то есть книгу, спорящую сама с собой. Из ящика целиком человека убирает deleteContact.
Ничто здесь не отправляет письма аудитории, и инструмента, который это делает, нет. Аудитория — способ группировать контакты, а не список подписки, и помещение кого-то в неё не шлёт ему ничего.
Добавление контакта в список — это запись в СПИСОК, а не в контакт, поэтому оно закрыто разрешением audiences:write, а не contacts:write. Для чтения адресов в аудитории нужно только audiences:read.