Method: users.drafts.list

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

HTTP isteği

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts

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
maxResults

integer (uint32 format)

Döndürülecek maksimum taslak sayısı. Bu alanın varsayılan değeri 100'dür. Bu alan için izin verilen maksimum değer 500'dür.

pageToken

string

Listedeki belirli bir sonuç sayfasını almak için kullanılan sayfa jetonu.

q

string

Yalnızca belirtilen sorguyla eşleşen taslak iletileri döndürür. Gmail arama kutusuyla aynı sorgu biçimini destekler. Örneğin, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".

includeSpamTrash

boolean

SPAM ve TRASH adreslerindeki taslakları sonuçlara dahil edin.

İstek metni

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Alanlar
drafts[]

object (Draft)

Taslakların listesi. Her Draft kaynağındaki Message özelliğinin yalnızca id ve threadId içerdiğini unutmayın. messages.get yöntemi, ek ileti ayrıntılarını getirebilir.

nextPageToken

string

Listedeki sonuçların sonraki sayfasını almak için kullanılan jeton.

resultSizeEstimate

integer (uint32 format)

Tahmini toplam sonuç sayısı.

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.compose
  • https://www.googleapis.com/auth/gmail.readonly

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.