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

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

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

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

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

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

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

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

لنسخ مستند، استخدِم طريقة 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 مناسب للسماح بالاتصال. لمزيد من المعلومات عن نطاقات Drive، يُرجى الاطِّلاع على مقالة اختيار نطاقات واجهة برمجة تطبيقات Google Drive.