Etiquetas

$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 devolve uma OpenEmail\Result\Page de etiquetas ordenadas por nome, e listAll e iterate percorrem todas as páginas. listAll devolve um único array, e iterate devolve um Generator que entrega uma etiqueta de cada vez. Cada etiqueta é um array com chaves em camelCase que tem a sua cor, threadCount e quando foi criada e alterada pela última vez. listColors devolve a paleta que a aplicação oferece, catorze sólidas e sete gradientes, como uma lista simples de arrays sem paginação. type é sempre user. O id vem do nome com que a etiqueta foi criada, por isso Invoices é USER_INVOICES, e nunca muda.

Os campos de create e update são as chaves de um único array com os nomes da API, por isso uma cor é 'color' => ['backgroundColor' => '#3B82F6'].

Uma etiqueta é um array com chaves em camelCase, por isso $label['threadCount'] lê a contagem, e $label['color']['backgroundColor'] ?? null lê a cor e dá null quando a etiqueta não tem nenhuma.