اسناد را ایجاد و مدیریت کنید

این صفحه API گوگل داکس نحوه انجام برخی وظایف سطح بالا مربوط به اسناد گوگل داکس را شرح می‌دهد، مانند:

• ایجاد یک سند
• کپی کردن یک سند موجود

پاراگراف‌های بعدی این وظایف را به تفصیل شرح می‌دهند.

یک سند خالی ایجاد کنید

برای ایجاد یک سند، از متد documents.create در مجموعه documents استفاده کنید.

نمونه کد زیر نحوه ایجاد یک سند خالی با عنوان مشخص شده را نشان می‌دهد:

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());
}

$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);

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

کار با پوشه‌های گوگل درایو

هیچ گزینه‌ای برای ایجاد مستقیم سند در یک پوشه مشخص شده در درایو با استفاده از Docs API وجود ندارد. به طور پیش‌فرض، سند ایجاد شده در پوشه ریشه کاربر در درایو ذخیره می‌شود.

با این حال، دو گزینه برای ذخیره فایل در پوشه Drive وجود دارد:

• پس از ایجاد سند، آن را با استفاده از متد files.update از رابط برنامه‌نویسی کاربردی درایو (Drive API) به یک پوشه خاص منتقل کنید. برای اطلاعات بیشتر در مورد جابجایی فایل‌ها، به بخش «انتقال فایل‌ها بین پوشه‌ها» مراجعه کنید.

• با استفاده از متد files.create از API درایو، یک سند خالی را به یک پوشه اضافه کنید و application/vnd.google-apps.document را به عنوان mimeType مشخص کنید. برای اطلاعات بیشتر در مورد ایجاد فایل‌ها، به بخش «ایجاد فایل در یک پوشه خاص» مراجعه کنید.

برای هر یک از گزینه‌های جایگزین، باید محدوده‌های API درایو مناسب را برای تأیید فراخوانی اضافه کنید. برای اطلاعات بیشتر در مورد محدوده‌های درایو، به «انتخاب محدوده‌های API گوگل درایو» مراجعه کنید.

برای جابجایی یا ایجاد فایل در پوشه درایو مشترک، به بخش پیاده‌سازی پشتیبانی از درایو مشترک مراجعه کنید.

کپی کردن یک سند موجود

برای کپی کردن یک سند، از متد files.copy در Drive API استفاده کنید.

نمونه کد زیر نحوه کپی کردن یک سند موجود را نشان می‌دهد. می‌توانید شناسه مورد استفاده برای فراخوانی Drive API را در URL سند پیدا کنید. برای اطلاعات بیشتر، به Document ID مراجعه کنید.

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

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

var copyTitle = "Copy Title";
let request = {
  name: copyTitle,
};
this.driveService.files.copy({
  fileId: documentId,
  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($documentId, $copy);
$documentCopyId = $driveResponse->id;

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')

توجه داشته باشید که برای تأیید فراخوانی باید از یک محدوده‌ی API درایو مناسب استفاده کنید. برای اطلاعات بیشتر در مورد محدوده‌های درایو، به «انتخاب محدوده‌های API گوگل درایو» مراجعه کنید.

مباحث مرتبط

• درج، حذف و جابجایی متن
• ادغام متن در یک سند
• مفاهیم سند