Method: users.drafts.update
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
جایگزین محتوای پیشنویس میشود.
درخواست HTTP
- URI آپلود، برای درخواست های آپلود رسانه:
PUT https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/drafts/{id}
- URI فراداده، برای درخواستهای فقط فراداده:
PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
userId | string آدرس ایمیل کاربر. مقدار ویژه me می تواند برای نشان دادن کاربر تأیید شده استفاده شود. |
id | string شناسه پیشنویس برای بهروزرسانی. |
درخواست بدن
بدنه درخواست شامل نمونه ای از Draft
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Draft
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://mail.google.com/
-
https://www.googleapis.com/auth/gmail.modify
-
https://www.googleapis.com/auth/gmail.compose
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: users.drafts.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReplaces a draft's content.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `PUT https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/drafts/{id}`\n- Metadata URI, for metadata-only requests: \n `PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------|\n| `userId` | `string` The user's email address. The special value `me` can be used to indicate the authenticated user. |\n| `id` | `string` The ID of the draft to update. |\n\n### Request body\n\nThe request body contains an instance of [Draft](/workspace/gmail/api/reference/rest/v1/users.drafts#Draft).\n\n### Response body\n\nIf successful, the response body contains an instance of [Draft](/workspace/gmail/api/reference/rest/v1/users.drafts#Draft).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://mail.google.com/`\n- `\n https://www.googleapis.com/auth/gmail.modify`\n- `\n https://www.googleapis.com/auth/gmail.compose`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]