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

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

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

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

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

برای ایجاد سند، از روش 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());
}

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

پایتون

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، به انتخاب حوزه‌های API Google Drive مراجعه کنید.

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

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

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

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

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

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;

پایتون

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، به انتخاب حوزه‌های API Google Drive مراجعه کنید.