Method: users.messages.import
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
İleti, SMTP üzerinden alınana benzer standart e-posta teslimi taraması ve sınıflandırması ile yalnızca bu kullanıcının posta kutusuna aktarılır. Bu yöntem SPF kontrolleri gerçekleştirmediğinden, alan adı sahteciliği yapmaya çalışanlar gibi bazı spam iletiler için işe yaramayabilir. Bu yöntemle mesaj gönderilmez.
HTTP isteği
- Medya yükleme istekleri için yükleme URI'si:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
- Yalnızca meta veri istekleri için meta veri URI'si:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
userId |
string
Kullanıcının e-posta adresi. Kimliği doğrulanmış kullanıcıyı belirtmek için me özel değeri kullanılabilir.
|
Sorgu parametreleri
Parametreler |
internalDateSource |
enum (InternalDateSource )
Gmail'in ileti için kullandığı dahili tarih kaynağı.
|
neverMarkSpam |
boolean
Gmail spam sınıflandırıcısının kararını yoksayın ve bu e-postayı posta kutusunda hiçbir zaman SPAM olarak işaretlemeyin.
|
processForCalendar |
boolean
E-postadaki takvim davetlerini işleyin ve ayıklanan toplantıları bu kullanıcının Google Takvim'ine ekleyin.
|
deleted |
boolean
E-postayı kalıcı olarak silinmiş (ÇÖP değil) ve yalnızca Apps Kasası yöneticisi tarafından Google Apps Kasası'nda görülebilecek şekilde işaretleyin. Yalnızca Google Workspace hesapları için kullanılır.
|
İstek içeriği
İstek metni, Message
öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılıysa yanıt metni, Message
öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]