Method: files.copy

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

המזהה של הקובץ.

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

פרמטרים
enforceSingleParent
(deprecated)

boolean

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

boolean

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

boolean

האם להגדיר את השדה keepForever בגרסה החדשה של head. ההגדרה הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive. אפשר לשמור לתמיד רק 200 גרסאות של הקובץ. אם מגיעים למגבלה, אפשר לנסות למחוק גרסאות מוצמדות.
ocrLanguage

string

רמז לשפה לעיבוד OCR במהלך ייבוא תמונה (קוד ISO 639-1).
supportsAllDrives

boolean

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

boolean

יצא משימוש: במקומו צריך להשתמש ב-supportsAllDrives.
includePermissionsForView

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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