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 בגרסה החדשה הראשית. ההגדרה הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive. אפשר לשמור לתמיד רק 200 גרסאות של הקובץ. אם מגיעים למגבלה, כדאי למחוק גרסאות מוצמדות.
ocrLanguage

string

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

boolean

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

boolean

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

string

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

string

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

boolean

האם להעתיק את התגובות הפתוחות (שלא נפתרו) שמשויכות לקובץ.

גוף הבקשה

גוף הבקשה מכיל מופע של 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

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