Dokümanlar oluşturun ve yönetin

Bu Google Dokümanlar API sayfasında, Google Dokümanlar dokümanlarıyla ilgili belirli üst düzey görevlerin nasıl gerçekleştirileceği açıklanmaktadır. Örneğin:

  • Doküman oluştur
  • Mevcut bir dokümanı kopyalama

Aşağıdaki paragraflarda bu görevler ayrıntılı olarak açıklanmıştır.

Boş doküman oluşturma

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

Dokümanlar API'sini kullanarak doğrudan belirli bir Drive klasöründe doküman oluşturma seçeneği yoktur. 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:

  • Doküman oluşturulduktan sonra Drive API'nin files.update yöntemini kullanarak belirli bir klasöre taşıyın. Dosya taşıma hakkında daha fazla bilgi için Klasörler arasında dosya taşıma başlıklı makaleyi inceleyin.

  • Drive API'nin files.create yöntemini kullanarak bir klasöre boş bir doküman ekleyin. mimeType olarak application/vnd.google-apps.document değerini belirtin. Dosya oluşturma hakkında daha fazla bilgi için Belirli bir klasörde dosya oluşturma başlıklı makaleyi inceleyin.

Her iki durumda da, çağrıyı yetkilendirmek için uygun Drive API kapsamlarını eklemeniz gerekir. Drive kapsamları hakkında daha fazla bilgi için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.

Ortak Drive klasöründe 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 Belge 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 için Google Drive API kapsamlarını seçme başlıklı makaleyi inceleyin.