Method: files.copy

יצירת עותק של הקובץ שצוין.

בקשת HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/copy

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

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

פרמטרים
fileId

string

המזהה של הקובץ שרוצים להעתיק.

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

פרמטרים
convert

boolean

האם להמיר את הקובץ הזה לפורמט המתאים של עורכי Docs.
enforceSingleParent
(deprecated)

boolean

הוצא משימוש: אין יותר תמיכה בהעתקת קבצים לכמה תיקיות. במקום זאת, אפשר להשתמש במקשי קיצור.
ocr

boolean

האם לנסות לבצע OCR בהעלאות של קבצים בפורמטים ‎ .jpg,‏ ‎.png,‏ ‎.gif או ‎ .pdf.
ocrLanguage

string

אם הערך של ocr הוא true, הוא נותן רמז לגבי השפה שבה צריך להשתמש. הערכים החוקיים הם קודים של BCP 47.
pinned

boolean

האם להצמיד את הגרסה הראשית של העותק החדש. בכל קובץ אפשר להצמיד עד 200 גרסאות.
supportsAllDrives

boolean

האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
timedTextLanguage

string

השפה של הטקסט המתוזמן.
timedTextTrackName

string

השם של הטראק של הטקסט המתוזמן.
visibility

enum (Visibility)

סטטוס החשיפה של הקובץ החדש. הפרמטר הזה רלוונטי רק כשהמקור הוא לא מסמך Google Docs מקורי ו-convert=false.
includePermissionsForView

string

מציין אילו הרשאות של תצוגה נוספת צריך לכלול בתשובה. יש תמיכה רק ב-published.
includeLabels

string

רשימה מופרדת בפסיקים של מזהי תוויות שרוצים לכלול בחלק labelInfo של התשובה.

גוף הבקשה

גוף הבקשה מכיל מופע של File.

גוף התשובה

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של 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.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.photos.readonly

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