Method: users.messages.get

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
userId

string

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

id

string

شناسه‌ی پیامی که باید بازیابی شود. این شناسه معمولاً با استفاده از messages.list بازیابی می‌شود. این شناسه همچنین هنگام درج ( messages.insert ) یا وارد کردن ( messages.import ) پیام، در نتیجه نیز وجود دارد.

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

پارامترها
format

enum ( Format )

قالبی که پیام باید با آن برگردانده شود.

metadataHeaders[]

string

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

درخواست بدنه

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

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Message خواهد بود.

دامنه‌های مجوز

به یکی از حوزه‌های 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
  • https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  • https://www.googleapis.com/auth/gmail.addons.current.message.action

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .