Method: users.threads.get

رشته مشخص شده را دریافت می کند.

درخواست HTTP

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

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

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

مولفه های
userId

string

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

id

string

شناسه موضوع برای بازیابی.

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

مولفه های
format

enum ( Format )

فرمت برای بازگرداندن پیام ها

metadataHeaders[]

string

وقتی فرمت داده شده و METADATA است، فقط سرصفحه های مشخص شده را شامل شود.

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

به یکی از حوزه های 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

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

قالب

Enums
full اطلاعات کامل پیام ایمیل را با محتوای متن تجزیه شده در فیلد payload برمی‌گرداند. میدان raw استفاده نمی شود. هنگام دسترسی به api با استفاده از دامنه gmail.metadata نمی توان از قالب استفاده کرد.
metadata فقط شناسه‌های پیام ایمیل، برچسب‌ها و سرصفحه‌های ایمیل را برمی‌گرداند.
minimal فقط شناسه‌ها و برچسب‌های پیام ایمیل را برمی‌گرداند. سرصفحه، بدنه یا محموله ایمیل را باز نمی گرداند.