Method: files.generateIds

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

בקשת HTTP

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

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

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

פרמטרים
count

integer

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

space

string

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

type

string

סוג הפריטים שאפשר להשתמש בהם במזהים. הערכים הנתמכים הם 'קבצים'. ו'קיצורי דרך'. שים לב ש'קיצורי דרך' נתמכים רק ב'מרחב' drive. (ברירת מחדל: 'קבצים')

גוף הבקשה

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

גוף התשובה

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

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

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

string

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

space

string

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

kind

string

מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה "drive#generatedIds".

היקפי ההרשאות

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

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

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