Method: users.threads.list

رشته های موجود در صندوق پستی کاربر را فهرست می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
userId

string

آدرس ایمیل کاربر. مقدار ویژه me می تواند برای نشان دادن کاربر تأیید شده استفاده شود.

پارامترهای پرس و جو

مولفه های
maxResults

integer ( uint32 format)

حداکثر تعداد رشته برای بازگشت. این فیلد به طور پیش فرض 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 را در نتایج قرار دهید.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
زمینه های
threads[]

object ( Thread )

لیست رشته ها توجه داشته باشید که هر منبع رشته حاوی لیستی از messages نیست. فهرست messages یک رشته معین را می‌توان با استفاده از روش threads.get واکشی کرد.

nextPageToken

string

نشانه صفحه برای بازیابی صفحه بعدی نتایج در لیست.

resultSizeEstimate

integer ( uint32 format)

تعداد کل نتایج تخمینی

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • 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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.