توضّح صفحة 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.