پیش‌نویس‌ها
هر عملیات در این گروه: آنچه می‌پذیرد، آنچه برمی‌گرداند و خطاهایی که ممکن است با آن‌ها پاسخ دهد.
عملیات‌ها
GET/drafts
List drafts
Requires the drafts:read scope.
پارامترهای کوئری
querystringThe same search syntax as
GET /threads, read against each draft's subject, sender and the first 4,000 characters of its body. Plain words match loosely and a quoted phrase has to appear as written, filler words are dropped when something else is left to search for, and a value the search cannot use is ignored rather than narrowing. Recipients are not searched, soto:,cc:andbcc:match nothing here. The drafts folder always applies, soin:and folderis:operators cannot widen the search beyond drafts,in:anywhereincluded. A draft saved with no subject is stored as(no subject), sosubject:"no subject"finds it.limitintegerDrafts per page, a whole number from 1 to 100. Defaults to 25.
دست‌کم 1حداکثر 100pageTokenstringOpaque. Pass back what you were given, never construct one.
خروجی
A page of drafts.
خطاها
خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها
همچنین در دسترس در
POST/drafts
Create a draft
Requires the drafts:write scope.
خروجی
Created.
خطاها
خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها
همچنین در دسترس در
GET/drafts/{id}
Retrieve a draft
Requires the drafts:read scope.
پارامترهای مسیر
idstringالزامیDraft id, which starts with
draft-.
خروجی
The draft.
خطاها
خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها
همچنین در دسترس در
PATCH/drafts/{id}
Update a draft
A partial update, not an upsert. An unknown id, or the id of a thread that is not a draft, is a 404. The draft keeps the id you passed, and the response echoes it.
Requires the drafts:write scope.
پارامترهای مسیر
idstringالزامیDraft id, which starts with
draft-.
خروجی
Saved.
خطاها
خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها
همچنین در دسترس در
DELETE/drafts/{id}
Delete a draft
Requires the drafts:write scope.
پارامترهای مسیر
idstringالزامیDraft id, which starts with
draft-.
خروجی
Deleted.
خطاها
خطاهایی که هر عملیاتی ممکن است برگرداند400401403404422500فهرست خطاها