יצירה וניהול של מסמכים

בדף הזה של Google Docs API מוסבר איך לבצע משימות מסוימות ברמה גבוהה שכוללות מסמכים ב-Google Docs, כמו:

• יצירת מסמך
• העתקת מסמך קיים

הפעולות האלה מתוארות בפירוט בפסקה הבאה.

יצירת מסמך ריק

כדי ליצור מסמך, משתמשים ב-method‏ documents.create באוסף documents.

בקטע הקוד הבא מוסבר איך ליצור מסמך ריק עם שם מסוים:

Java

private static void createDoc(Docs service) throws IOException {
    Document doc = new Document()
            .setTitle("My Document");
    doc = service.documents().create(doc)
            .execute();
    System.out.println("Created document with title: " + doc.getTitle());
}

PHP

$title = 'My Document';
$document = new Google_Service_Docs_Document(array(
    'title' => $title
));

$document = $service->documents->create($document);
printf("Created document with title: %s\n", $document->title);

Python

title = 'My Document'
body = {
    'title': title
}
doc = service.documents() \
    .create(body=body).execute()
print('Created document with title: {0}'.format(
    doc.get('title')))

עבודה עם תיקיות ב-Google Drive

אי אפשר ליצור מסמך ישירות בתיקייה מסוימת ב-Drive באמצעות Docs API. כברירת מחדל, המסמך שנוצר נשמר בתיקיית השורש של המשתמש ב-Drive.

עם זאת, יש שתי חלופות לשמירת קובץ בתיקייה ב-Drive:

• אחרי שיוצרים את המסמך, מעבירים אותו לתיקייה ספציפית באמצעות השיטה files.update של Drive API. מידע נוסף על העברת קבצים זמין במאמר העברת קבצים בין תיקיות.

• מוסיפים מסמך ריק לתיקייה באמצעות השיטה files.create של Drive API, ומציינים את application/vnd.google-apps.document בתור mimeType. למידע נוסף על יצירת קבצים, ראו יצירת קובץ בתיקייה ספציפית.

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

במאמר הטמעת תמיכה באחסון שיתופי מוסבר איך להעביר או ליצור קובץ בתיקייה באחסון שיתופי.

העתקת מסמך קיים

כדי להעתיק מסמך, משתמשים ב-method‏ files.copy של Drive API.

בקוד לדוגמה הבא מוצג איך מעתיקים מסמך קיים. המזהה שצריך להשתמש בו בקריאה ל-Drive API מופיע בכתובת ה-URL של המסמך. למידע נוסף, ראו מזהה מסמך.

https://docs.google.com/document/d/DOCUMENT_ID/edit

Java

String copyTitle = "Copy Title";
File copyMetadata = new File().setName(copyTitle);
File documentCopyFile =
        driveService.files().copy(documentId, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

Node.js

var copyTitle = "Copy Title";
let request = {
  name: copyTitle,
};
this.driveService.files.copy({
  fileId: documentId,
  resource: request,
}, (err, driveResponse) => {
  let documentCopyId = driveResponse.id;
});

PHP

<?php
$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
    'name' => $copyTitle
));
$driveResponse = $driveService->files->copy($documentId, $copy);
$documentCopyId = $driveResponse->id;

Python

copy_title = 'Copy Title'
body = {
    'name': copy_title
}
drive_response = drive_service.files().copy(
    fileId=document_id, body=body).execute()
document_copy_id = drive_response.get('id')

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

נושאים קשורים

• הוספה, מחיקה והזזה של טקסט
• מיזוג טקסט למסמך
• מושגי מסמכים