Method: files.copy

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

בקשת HTTP

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

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

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

פרמטרים
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

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