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