Method: users.threads.list

Kullanıcının posta kutusundaki ileti dizilerini listeler.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
userId

string

Kullanıcının e-posta adresi. me özel değeri, kimliği doğrulanmış kullanıcıyı belirtmek için kullanılabilir.

Sorgu parametreleri

Parametreler
maxResults

integer (uint32 format)

Döndürülecek maksimum ileti dizisi 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

Sayfa jetonu 'nu kullanın.
q

string

Yalnızca belirtilen sorguyla eşleşen ileti dizilerini döndürür. Gmail arama kutusuyla aynı sorgu biçimini destekler. Örneğin, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread". gmail.metadata kapsamı kullanılarak API'ye erişilirken parametre kullanılamaz.
labelIds[]

string

Yalnızca belirtilen tüm etiket kimlikleriyle eşleşen etiketlerin bulunduğu ileti dizilerini döndürür.
includeSpamTrash

boolean

Sonuçlara SPAM ve TRASH kaynaklı ileti dizilerini dahil edin.

İstek içeriği

İ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 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Alanlar
threads[]

object (Thread)

İleti dizileri listesi. Her ileti dizisi kaynağının bir messages listesi içermediğini unutmayın. Belirli bir ileti dizisine ait messages listesi, threads.get yöntemi kullanılarak getirilebilir.
nextPageToken

string

Sayfa jetonu 'nu kullanın.
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.readonly
  • https://www.googleapis.com/auth/gmail.metadata

Daha fazla bilgi için Yetkilendirme kılavuzuna göz atın.