إنشاء المستندات وإدارتها

توضّح صفحة Google Docs API هذه كيفية تنفيذ بعض المهام العالية المستوى التي تتضمّن مستندات Google، مثل:

  • إنشاء مستند
  • نسخ مستند حالي

توضّح الفقرات التالية هذه المهام بالتفصيل.

إنشاء مستند فارغ

لإنشاء مستند، استخدِم الطريقة 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 باستخدام واجهة برمجة التطبيقات الخاصة بـ "مستندات Google". يتم تلقائيًا حفظ المستند الذي تم إنشاؤه في المجلد الجذر للمستخدم على Drive.

ومع ذلك، هناك بديلان لحفظ ملف في مجلد على Drive:

  • بعد إنشاء المستند، يمكنك نقله إلى مجلد معيّن باستخدام طريقة files.update في Drive API. لمزيد من المعلومات حول نقل الملفات، يُرجى الاطّلاع على نقل الملفات بين المجلدات.

  • أضِف مستندًا فارغًا إلى مجلد باستخدام طريقة files.create في Drive API، مع تحديد application/vnd.google-apps.document كـ mimeType. لمزيد من المعلومات حول إنشاء الملفات، يُرجى الاطّلاع على إنشاء ملف في مجلد معيّن.

في كلتا الحالتين، عليك إضافة نطاقات Drive API المناسبة للسماح بالطلب. لمزيد من المعلومات حول نطاقات Drive، يُرجى الاطّلاع على مقالة اختيار نطاقات Google Drive API.

لنقل ملف أو إنشائه داخل مجلد في مساحة تخزين سحابي مشتركة، يُرجى الاطّلاع على تنفيذ ميزة مساحة التخزين السحابي المشتركة.

نسخ مستند حالي

لنسخ مستند، استخدِم طريقة 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.