Probar una etiqueta en el correo reciente
Lo que una etiqueta aplicada por la IA captaría en el correo más reciente de la bandeja de entrada, sin etiquetar nada.
Ejecuta la llamada real en tu espacio de trabajo.
POST /labels/{id}/test
Lo que una etiqueta aplicada por la IA captaría en el correo más reciente de la bandeja de entrada, sin etiquetar nada.
Ejemplo
Requiere labels:write y threads:read. Envía aiInstructions para probar un texto que aún no has guardado, o {} para probar lo que tiene la etiqueta.
curl -X POST "$OE/labels/USER_INVOICES/test" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "aiInstructions": "invoices and receipts" }'{ "object": "label_test", "labelId": "USER_INVOICES", "examined": 20, "matched": [ { "threadId": "thr_7c1e4a90", "subject": "Your September invoice", "sender": "[email protected]", "receivedOn": "Wed, 23 Sep 2026 10:02:44 +0000" } ]}Lee las 20 conversaciones más recientes de la bandeja de entrada, y examined dice cuántas leyó. Un mensaje que llegó cifrado se omite, y una clave limitada a ciertas direcciones solo lee las conversaciones entregadas a ellas.
Una prueba gasta una acción de IA de quien hace la llamada, cosa que el etiquetado del correo que llega nunca hace. Si hoy no queda ninguna es un 429 ai_quota_exceeded, sin instrucciones en la petición ni en la etiqueta un 422 invalid_parameter, y en una instalación sin modelo de IA un 409 ai_not_configured.