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

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

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

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

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

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

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

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

لنسخ مستند، يمكنك استخدام واجهة برمجة تطبيقات Drive files.copy.

يعرض نموذج الرمز البرمجي التالي كيفية نسخ مستند حالي. يمكنك الاطّلاع على رقم التعريف المطلوب استخدامه لطلب بيانات من 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