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