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 iletiyi veya taslağı bir ileti dizisine eklemek için aşağıdaki ölçütlerin karşılanması gerekir:

  1. İstenen threadId, talebinizle birlikte gönderdiğiniz Message veya Draft.Message üzerinde belirtilmelidir.
  2. References ve In-Reply-To üstbilgileri, RFC 2822 standardına uygun şekilde 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ı (dönem 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. messages.get ve drafts.get yanıtlarında, format=RAW parametresi sağlandığı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. Aynı kimlikler gönderilirse yalnızca biri saklanır ve seçim rastgele yapılır. Yalnızca Google Workspace hesaplarında kullanılır. İstek başına 20 sınıflandırma etiketi değeri sınırı vardır. Sınıflandırma etiketi değerleri, izin verilen maksimum sayıyı aşarsa istek başarısız olur.

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 ü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ün ileti kısmı gövdesi. Kapsayıcı MIME ileti kısımları 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 için geçerlidir (ör. multipart/*). 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ında 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şlenir.
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ğerinin 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 ve sınıflandırma etiketi değerlerini 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 alma işlemine benzer şekilde, 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 ve sınıflandırma etiketi değerlerini 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.