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

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