Method: files.copy

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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 ו-conversion=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

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