दस्तावेज़ पर जाएँ
API

हाल के मेल पर लेबल आज़माएँ

AI द्वारा लगाया जाने वाला लेबल इनबॉक्स के सबसे नए मेल में क्या पकड़ता, किसी पर लेबल लगाए बिना।

POST/labels/{id}/test

असली कॉल आपके वर्कस्पेस पर चलाता है।

POST /labels/{id}/test

AI द्वारा लगाया जाने वाला लेबल इनबॉक्स के सबसे नए मेल में क्या पकड़ता, किसी पर लेबल लगाए बिना।

उदाहरण

labels:write और threads:read चाहिए। ऐसे शब्द आज़माने के लिए aiInstructions भेजें जो आपने अभी सेव नहीं किए हैं, या लेबल में जो है उसे आज़माने के लिए {}।

curl
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"    }  ]}

यह इनबॉक्स के सबसे नए 20 थ्रेड पढ़ता है, और examined बताता है कि इसने कितने पढ़े। एन्क्रिप्टेड आया संदेश छोड़ दिया जाता है, और कुछ ख़ास पतों तक सीमित कुंजी सिर्फ़ वही थ्रेड पढ़ती है जो उन पतों पर डिलीवर हुए।

एक बार आज़माने पर कॉल करने वाले की एक AI क्रिया खर्च होती है, जो आने वाले मेल पर लेबल लगाने में कभी नहीं होती। आज कोई क्रिया न बची हो तो यह 429 ai_quota_exceeded है, अनुरोध में या लेबल पर निर्देश न हों तो 422 invalid_parameter, और बिना AI मॉडल वाले इंस्टॉल पर 409 ai_not_configured।

संदर्भ