حداکثر تعداد رشته برای بازگشت. این فیلد به طور پیش فرض 100 است. حداکثر مقدار مجاز برای این فیلد 500 است.
pageToken
string
نشانه صفحه برای بازیابی صفحه خاصی از نتایج در لیست.
q
string
فقط رشته هایی را برمی گرداند که با پرس و جوی مشخص شده مطابقت دارند. از همان فرمت پرس و جو مانند جعبه جستجوی Gmail پشتیبانی می کند. برای مثال، "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread" . هنگام دسترسی به api با استفاده از دامنه gmail.metadata نمی توان از پارامتر استفاده کرد.
labelIds[]
string
فقط رشته هایی را با برچسب هایی برگردانید که با همه شناسه های برچسب مشخص شده مطابقت داشته باشند.
includeSpamTrash
boolean
رشته هایی از SPAM و TRASH را در نتایج قرار دهید.
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
لیست رشته ها توجه داشته باشید که هر منبع رشته حاوی لیستی از messages نیست. فهرست messages یک رشته معین را میتوان با استفاده از روش threads.get واکشی کرد.