Method: users.messages.import
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
นําเข้าข้อความไปยังกล่องจดหมายของผู้ใช้รายนี้เท่านั้น โดยจะสแกนและจัดประเภทการนำส่งอีเมลมาตรฐานให้คล้ายกับการรับผ่าน SMTP วิธีนี้จะไม่ทำการตรวจสอบ SPF จึงอาจใช้ไม่ได้กับข้อความสแปมบางรายการ เช่น ข้อความที่พยายามทำการปลอมแปลงโดเมน วิธีนี้จะไม่ส่งข้อความ
คำขอ HTTP
- URI การอัปโหลดสำหรับคำขออัปโหลดสื่อ:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
- URI ของข้อมูลเมตาสำหรับคำขอข้อมูลเมตาเท่านั้น
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ |
userId |
string
อีเมลของผู้ใช้ ค่าพิเศษ me ใช้เพื่อระบุผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้
|
พารามิเตอร์การค้นหา
พารามิเตอร์ |
internalDateSource |
enum (InternalDateSource )
แหล่งที่มาของวันที่ภายในของข้อความ Gmail
|
neverMarkSpam |
boolean
ละเว้นผลการตัดสินของเครื่องแยกประเภทจดหมายขยะของ Gmail และอย่าทำเครื่องหมายอีเมลนี้ว่าเป็นจดหมายขยะในกล่องจดหมาย
|
processForCalendar |
boolean
ประมวลผลคำเชิญในปฏิทินในอีเมลและเพิ่มการประชุมที่ดึงข้อมูลไปยัง Google ปฏิทินของผู้ใช้รายนี้
|
deleted |
boolean
ทำเครื่องหมายอีเมลว่าลบอย่างถาวร (ไม่ใช่ถังขยะ) และมีผู้ดูแลระบบห้องนิรภัยเท่านั้นที่เห็นอีเมลดังกล่าวใน Google ห้องนิรภัย ใช้กับบัญชี Google Workspace เท่านั้น
|
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ Message
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Message
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[],[],null,["# Method: users.messages.import\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nImports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages, such as those attempting to perform domain spoofing. This method does not send a message.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import`\n- Metadata URI, for metadata-only requests: \n `POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import`\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\n### Query parameters\n\n| Parameters ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `internalDateSource` | `enum (`[InternalDateSource](/workspace/gmail/api/reference/rest/v1/InternalDateSource)`)` Source for Gmail's internal date of the message. |\n| `neverMarkSpam` | `boolean` Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox. |\n| `processForCalendar` | `boolean` Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user. |\n| `deleted` | `boolean` Mark the email as permanently deleted (not TRASH) and only visible in [Google Vault](http://support.google.com/vault/) to a Vault administrator. Only used for Google Workspace accounts. |\n\n### Request body\n\nThe request body contains an instance of [Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n### Response body\n\nIf successful, the response body contains an instance of [Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\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.insert`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]