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

כשהערך של given והפורמט הוא 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

מידע נוסף זמין במדריך ההרשאות.