Method: files.generateIds

יוצרת קבוצה של מזהי קבצים שאפשר לספק בבקשות להוספה או להעתקה.

בקשת HTTP

GET https://www.googleapis.com/drive/v2/files/generateIds

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
maxResults

integer

המספר המקסימלי של מזהים להחזרה.

space

string

המרחב שבו ניתן להשתמש במזהים כדי ליצור קבצים חדשים. הערכים הנתמכים הם drive ו-appDataFolder. (ברירת המחדל: drive)

type

string

סוג הפריטים שעבורם ניתן להשתמש במזהים. הערכים הנתמכים הם files ו-shortcuts. לתשומת ליבך: יש תמיכה ב-shortcuts רק ב-space של drive. (ברירת המחדל: files)

גוף הבקשה

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

גוף התגובה

רשימה של המזהים שנוצרו שניתן לספק בבקשות הוספה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON
{
  "ids": [
    string
  ],
  "space": string,
  "kind": string
}
שדות
ids[]

string

המזהים שנוצרו עבור המשתמש המבקש במרחב המשותף שצוין.

space

string

סוג הקובץ שניתן ליצור עם המזהים האלה.

kind

string

הערך הוא תמיד drive#generatedIds

היקפי הרשאות

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

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.