Method: files.generateIds

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

בקשת HTTP

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

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

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

פרמטרים
count

integer

מספר המזהים להחזרה.
space

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

ייצוג ב-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

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