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

בדף הזה של 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.

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

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