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