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

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

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

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

  • أضِف مستندًا فارغًا إلى مجلد باستخدام واجهة برمجة التطبيقات Drive API ‎ files.create، مع تحديد 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.