Метки

$page = $client->labels->list(limit: 50);$every = $client->labels->listAll();$colors = $client->labels->listColors();echo count($page), ' ', count($every), ' ', count($colors), PHP_EOL; foreach ($client->labels->iterate() as $row) {    echo $row['name'], ' ', $row['threadCount'], PHP_EOL;} $created = $client->labels->create([    'name' => 'Invoices',    'color' => ['backgroundColor' => 'gradient:sunset'],]); $client->labels->update($created['id'], ['name' => 'Invoices 2027']);$client->labels->update($created['id'], ['color' => ['backgroundColor' => '#3B82F6']]); $label = $client->labels->get($created['id']);echo $label['name'], ' ', $label['color']['backgroundColor'] ?? 'no colour', PHP_EOL; $client->labels->delete($created['id']);

list возвращает одну OpenEmail\Result\Page ярлыков, отсортированных по имени, а listAll и iterate обходят все страницы. listAll возвращает один массив, а iterate возвращает Generator, который выдаёт ярлыки по одному. Каждый ярлык является массивом с ключами в camelCase, который несёт цвет, threadCount и время создания и последнего изменения. listColors возвращает палитру, которую предлагает приложение, четырнадцать сплошных цветов и семь градиентов, как обычный список массивов без постраничной выдачи. type всегда равен user. Идентификатор образуется из имени, с которым ярлык был создан, поэтому Invoices становится USER_INVOICES, и он никогда не меняется.

Поля create и update являются ключами одного массива с именами из API, поэтому цвет задаётся как 'color' => ['backgroundColor' => '#3B82F6'].

Ярлык является массивом с ключами в camelCase, поэтому $label['threadCount'] читает количество, а $label['color']['backgroundColor'] ?? null читает цвет и даёт null, если у ярлыка его нет.