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

בדף הזה של 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());
}

Node.js

const title = 'My Document';
const resource = {
  title,
};
this.service.documents.create({
  resource,
}, (err, response) => {
  if (err) return console.log('The API returned an error: ' + err);
  console.log(`Created document with title: ${response.data.title}`);
});

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. מידע נוסף על העברת קבצים זמין במאמר העברת קבצים בין תיקיות.

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

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

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

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

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

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

בדוגמת הקוד הבאה מוצג איך מעתיקים מסמך קיים. אפשר למצוא את המזהה שמשמש לקריאה ל-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(DOCUMENT_ID, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

Node.js

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

PHP

$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
    'name' => $copyTitle
));
$driveResponse = $driveService->files->copy(DOCUMENT_ID, $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.

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

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