Method: users.messages.get

מקבל את ההודעה שצוינה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
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.