- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
Kullanıcının posta kutusundaki iletileri listeler.
HTTP isteği
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
userId |
Kullanıcının e-posta adresi. |
Sorgu parametreleri
Parametreler | |
---|---|
maxResults |
Döndürülecek maksimum ileti 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 |
Sayfa jetonu 'nu kullanın. |
q |
Yalnızca belirtilen sorguyla eşleşen iletileri döndürür. Gmail arama kutusuyla aynı sorgu biçimini destekler. Örneğin, |
labelIds[] |
Yalnızca belirtilen tüm etiket kimlikleriyle eşleşen etiketlere sahip iletileri döndürür. Bir ileti dizisindeki iletilerin etiketleri, aynı ileti dizisindeki diğer iletilerde bulunmaz. Daha fazla bilgi edinmek için İletiler ve mesaj dizilerindeki etiketleri yönetme başlıklı makaleyi inceleyin. |
includeSpamTrash |
Sonuçlara |
İ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 |
---|
{
"messages": [
{
object ( |
Alanlar | |
---|---|
messages[] |
İleti listesi. Her mesaj kaynağının yalnızca bir |
nextPageToken |
Jeton, listedeki sonuçların sonraki sayfasını almak için kullanılır. |
resultSizeEstimate |
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.