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

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

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

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

لنسخ مستند، استخدِم طريقة files.copy في Drive API.

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