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

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

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

تصف الفقرات التالية هذه المهام بالتفصيل.

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

لإنشاء مستند، استخدِم الـ documents.create طريقة في الـ documents مجموعة.

تعرض عيّنة التعليمات البرمجية التالية كيفية إنشاء مستند فارغ بعنوان محدّد:

جافا

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());
}

Node.js

const title = 'My Document';
const resource = {
  title,
};
this.service.documents.create({
  resource,
}, (err, response) => {
  if (err) return console.log('The API returned an error: ' + err);
  console.log(`Created document with title: ${response.data.title}`);
});

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:

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

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

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

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

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

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

يُرجى العِلم أنّه لا يمكنك استخدام طريقة files.copy لنسخ مستند منشور. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة المستندات المنشورة.

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

https://docs.google.com/document/d/DOCUMENT_ID/edit

جافا

String copyTitle = "Copy Title";
File copyMetadata = new File().setName(copyTitle);
File documentCopyFile =
        driveService.files().copy(DOCUMENT_ID, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

Node.js

var copyTitle = "Copy Title";
let request = {
  name: copyTitle,
};
this.driveService.files.copy({
  fileId: DOCUMENT_ID,
  resource: request,
}, (err, driveResponse) => {
  let documentCopyId = driveResponse.id;
});

PHP


$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
    'name' => $copyTitle
));
$driveResponse = $driveService->files->copy(DOCUMENT_ID, $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.