Bu Google Docs API sayfası, Google Dokümanlar dokümanlarını içeren belirli üst düzey görevlerin nasıl gerçekleştirileceğini açıklar. Örneğin:
- Doküman oluştur
- Mevcut bir dokümanı kopyalama
Aşağıdaki paragraflarda bu görevler ayrıntılı olarak açıklanmaktadır.
Boş bir doküman oluştur
Belge oluşturmak için documents
koleksiyonundaki documents.create
yöntemini kullanın.
Aşağıdaki kod örneğinde, belirtilen başlığa sahip boş bir dokümanın nasıl oluşturulacağı gösterilmektedir:
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 klasörleriyle çalışma
Docs API'yi kullanarak doğrudan belirli bir Drive klasörü içinde doküman oluşturmak mümkün değildir. Oluşturulan doküman, varsayılan olarak kullanıcının Drive'daki kök klasörüne kaydedilir.
Ancak, bir dosyayı Drive klasörüne kaydetmenin iki alternatifi vardır:
Oluşturulan belgeyi, Drive API'nin
files.update
yöntemini kullanarak belirli bir klasöre taşıyın. Dosyaları taşıma hakkında daha fazla bilgi için Dosyaları klasörler arasında taşıma bölümüne bakın.Drive API'nin
files.create
yöntemini kullanarak klasöre boş bir doküman ekleyin veapplication/vnd.google-apps.document
ilemimeType
değerini belirtin. Dosya oluşturma hakkında daha fazla bilgi için Belirli bir klasörde dosya oluşturma bölümüne bakın.
Her iki alternatifte de çağrıyı yetkilendirmek için uygun Drive API kapsamlarını eklemeniz gerekir. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleye bakın.
Ortak Drive klasörü içinde dosya taşımak veya oluşturmak için Ortak Drive desteğini uygulama başlıklı makaleyi inceleyin.
Mevcut bir dokümanı kopyalama
Bir dokümanı kopyalamak için Drive API'nin files.copy
yöntemini kullanın.
Aşağıdaki kod örneğinde, mevcut bir dokümanın nasıl kopyalanacağı gösterilmektedir. Drive API çağrısı için kullanılacak kimliği belge URL'sinde bulabilirsiniz. Daha fazla bilgi için Doküman Kimliği bölümüne bakın.
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')
Çağrıyı yetkilendirmek için uygun bir Drive API kapsamı kullanmanız gerektiğini unutmayın. Drive kapsamları hakkında daha fazla bilgi edinmek için Google Drive API kapsamlarını seçme başlıklı makaleye bakın.