صفحة واجهة برمجة التطبيقات لمحرّر مستندات 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