REST Resource: users.messages

Kaynak: Mesaj

Bir e-posta iletisi.

JSON gösterimi
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Alanlar
id

string

İletinin sabit kimliğidir.

threadId

string

İletinin ait olduğu ileti dizisinin kimliği. Bir ileti dizisine ileti veya taslak eklemek için aşağıdaki ölçütlerin karşılanması gerekir:

  1. İstenen threadId, isteğinizle birlikte sağladığınız Message veya Draft.Message öğesinde belirtilmelidir.
  2. References ve In-Reply-To üstbilgileri, RFC 2822 standardına uygun olarak ayarlanmalıdır.
  3. Subject üstbilgileri eşleşmelidir.

labelIds[]

string

Bu iletiye uygulanan etiketlerin kimliklerinin listesi.

snippet

string

Mesaj metninin kısa bir bölümüdür.

historyId

string

Bu mesajı değiştiren son geçmiş kaydının kimliği.

internalDate

string (int64 format)

Gelen kutusundaki sıralamayı belirleyen dahili ileti oluşturma zaman damgası (epoch ms). SMTP tarafından alınan normal e-postalarda bu değer, iletinin ilk olarak Google tarafından kabul edildiği zamanı gösterir ve Date üstbilgisinden daha güvenilirdir. Ancak API ile taşınan postalar için bu, istemci tarafından Date başlığını temel alacak şekilde yapılandırılabilir.

payload

object (MessagePart)

İleti bölümlerindeki ayrıştırılmış e-posta yapısı.

sizeEstimate

integer

İletinin baytı cinsinden tahmini boyuttur.

raw

string (bytes format)

RFC 2822 biçimli ve base64url kodlamalı bir dizedeki e-posta iletisinin tamamı. format=RAW parametresi sağlandığında messages.get ve drafts.get yanıt olarak döndürülür.

base64 kodlu bir dize.

MessagePart

Tek bir MIME ileti parçası.

JSON gösterimi
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Alanlar
partId

string

Mesaj bölümünün sabit kimliği.

mimeType

string

İleti bölümünün MIME türü.

filename

string

Ekin dosya adı. Yalnızca bu ileti bölümü bir eki temsil ediyorsa mevcut olur.

headers[]

object (Header)

Bu ileti bölümündeki üstbilgilerin listesi. İleti yükünün tamamını temsil eden üst düzey ileti bölümü için To, From ve Subject gibi standart RFC 2822 e-posta üstbilgileri bulunur.

body

object (MessagePartBody)

Bu bölümün ileti bölümü gövdesi. Bu gövde, kapsayıcı MIME ileti bölümleri için boş olabilir.

parts[]

object (MessagePart)

Bu bölümün alt MIME ileti bölümleri. Bu yalnızca kapsayıcı MIME ileti bölümleri için geçerlidir (ör. multipart/*). text/plain gibi kapsayıcı olmayan MIME ileti parçası türleri için bu alan boştur. Daha fazla bilgi edinmek için RFC 1521 sayfasına bakın.

JSON gösterimi
{
  "name": string,
  "value": string
}
Alanlar
name

string

: ayırıcıdan önceki, başlığın adı. Örneğin, To.

value

string

Üstbilginin : ayırıcısından sonraki değeri. Örneğin, someuser@example.com.

Yöntemler

batchDelete

İleti kimliğine göre çok sayıda iletiyi siler.

batchModify

Belirtilen iletilerdeki etiketleri değiştirir.

delete

Belirtilen iletiyi hemen ve kalıcı olarak siler.

get

Belirtilen mesajı alır.

import

Bir iletiyi, yalnızca bu kullanıcının posta kutusuna aktarır. Standart e-posta teslimi taraması ve SMTP yoluyla alma yöntemine benzer bir sınıflandırma kullanır.

insert

İletiyi doğrudan bu kullanıcının IMAP APPEND benzeri posta kutusuna doğrudan ekler. Böylece çoğu tarama ve sınıflandırma atlanır.

list

Kullanıcının posta kutusundaki iletileri listeler.

modify

Belirtilen iletideki etiketleri değiştirir.

send

Belirtilen iletiyi To, Cc ve Bcc üstbilgilerindeki alıcılara gönderir.

trash

Belirtilen iletiyi çöp kutusuna taşır.

untrash

Belirtilen iletiyi çöp kutusundan kaldırır.