Method: media.download

מקבל קובץ מצורף. כדי להוריד מדיה של קובץ מצורף באמצעות REST, צריך להשתמש בפרמטר השאילתה alt=media. הפונקציה מחזירה שגיאה 400 (בקשה לא חוקית) אם קובץ המדיה המצורף לא זמין בסוג ה-MIME המבוקש.

בקשת HTTP

GET https://keep.googleapis.com/v1/{name=notes/*/attachments/*}

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

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

פרמטרים
name

string

חובה. השם של הקובץ המצורף.

פרמטרים של שאילתה

פרמטרים
mimeType

string

הפורמט המבוקש של סוג ה-MIME של IANA. סוג ה-MIME המבוקש חייב להיות אחד מאלה שצוינו ב-attachment.mime_type. האפשרות הזו נדרשת כשמורידים מדיה מקבצים מצורפים, והמערכת מתעלמת ממנה במקרים אחרים.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Attachment.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/keep
  • https://www.googleapis.com/auth/keep.readonly

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