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,
  "classificationLabelValues": [
    {
      object (ClassificationLabelValue)
    }
  ]
}
Alanlar
id

string

İletinin değişmez kimliği.
threadId

string

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

  1. İstenen threadId, isteğinizle birlikte gönderdiğiniz Message veya Draft.Message üzerinde belirtilmelidir.
  2. References ve In-Reply-To üstbilgileri, RFC 2822 standardına uygun olarak ayarlanmalıdır.
  3. Subject başlıkları eşleşmelidir.
labelIds[]

string

Bu iletiye uygulanan etiketlerin kimliklerinin listesi.
snippet

string

İleti metninin kısa bir bölümü.
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). Normal SMTP ile alınan e-postalarda bu, iletinin Google tarafından ilk kabul edildiği zamanı gösterir ve Date üstbilgisinden daha güvenilirdir. Ancak API ile taşınan postalar için, istemci tarafından Date üstbilgisine göre 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 boyutu.
raw

string (bytes format)

RFC 2822 biçiminde ve base64url kodlamalı dize olarak tüm e-posta iletisi. format=RAW parametresi sağlandığında messages.get ve drafts.get yanıtlarında döndürülür.

Base64 kodlu bir dize.
classificationLabelValues[]

object (ClassificationLabelValue)

İletideki sınıflandırma etiketi değerleri. Kullanılabilir sınıflandırma etiketi şemaları, Google Drive Etiketleri API'si kullanılarak sorgulanabilir. Her sınıflandırma etiketi kimliği benzersiz olmalıdır. Yinelenen kimlikler sağlanırsa yalnızca biri korunur ve seçim rastgeledir. Yalnızca Google Workspace hesapları için kullanılır.

MessagePart

Tek bir MIME mesajı bölümü.

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

string

İleti 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ü eki temsil ediyorsa bulunur.
headers[]

object (Header)

Bu ileti bölümündeki üstbilgilerin listesi. Tüm ileti yükünü temsil eden en üst düzey ileti bölümünde To, From ve Subject gibi standart RFC 2822 e-posta üstbilgileri bulunur.
body

object (MessagePartBody)

Bu bölüm için ileti bölümü gövdesi. 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 mesajı bölümleri (ör. multipart/*) için geçerlidir. text/plain gibi kapsayıcı olmayan MIME mesajı bölümü türleri için bu alan boştur. Daha fazla bilgi için RFC 1521'e bakın.
JSON gösterimi 
{
  "name": string,
  "value": string
}
Alanlar
name

string

: ayırıcıdan önceki üstbilginin adı. Örneğin, To.
value

string

: ayırıcısından sonraki başlığın değeri. Örneğin, someuser@example.com.

ClassificationLabelValue

E-posta iletisine uygulanan sınıflandırma etiketleri. Sınıflandırma etiketleri, Gmail gelen kutusu etiketlerinden farklıdır. Yalnızca Google Workspace hesapları için kullanılır. Sınıflandırma etiketleri hakkında daha fazla bilgi edinin.

JSON gösterimi 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
Alanlar
labelId

string

Zorunlu. Canonical veya ham alfanümerik sınıflandırma etiketi kimliği. Google Drive Etiketi kaynağının kimlik alanıyla eşleşir.
fields[]

object (ClassificationLabelFieldValue)

Belirli sınıflandırma etiketi kimliğinin alan değerleri.

ClassificationLabelFieldValue

Sınıflandırma etiketi için alan değerleri.

JSON gösterimi 
{
  "fieldId": string,
  "selection": string
}
Alanlar
fieldId

string

Zorunlu. Sınıflandırma Etiketi Değeri'nin alan kimliği. Google Drive Label.Field nesnesinin kimlik alanıyla eşleşir.
selection

string

Seçim seçeneğinin seçim tercihi kimliği. Yalnızca Google Drive Label.Field nesnesinde alan türü SELECTION ise ayarlanmalıdır. Google Drive Label.Field.SelectionOptions kaynağının kimlik alanıyla eşleşir.

Yöntemler

batchDelete

 İleti kimliğine göre birçok iletiyi siler.

batchModify

 Belirtilen iletilerdeki etiketleri değiştirir.

delete

 Belirtilen iletiyi hemen ve kalıcı olarak siler.

get

 Belirtilen iletiyi alır.

import

 İletiyi yalnızca bu kullanıcının posta kutusuna aktarır. SMTP üzerinden alınan iletilerde olduğu gibi standart e-posta teslimi taraması ve sınıflandırması yapılır.

insert

 IMAP APPEND'ya benzer şekilde, çoğu tarama ve sınıflandırmayı atlayarak yalnızca bu kullanıcının posta kutusuna doğrudan ileti ekler.

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.