Dokümanlar oluşturun ve yönetin

Bu Google Dokümanlar API sayfasında, Google Dokümanlar belgeleriyle 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ş bir doküman oluşturma

Doküman oluşturmak için documents koleksiyonunda documents.create yöntemini kullanın.

Aşağıdaki kod örneğinde, belirtilen başlığa sahip boş bir belgenin 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'si kullanılarak doğrudan belirtilen bir Drive klasöründe doküman oluşturma seçeneği yoktur. Oluşturulan belge, varsayılan olarak kullanıcının Drive'daki kök klasörüne kaydedilir.

Ancak, dosyaları Drive klasörüne kaydetmek için iki alternatif vardır:

  • Belge 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 Dosyaları klasörler arasında taşıma başlıklı makaleyi inceleyin.

  • Drive API'nin files.create yöntemini kullanarak bir klasöre boş doküman ekleyin ve 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 alternatif için de aramayı yetkilendirmek üzere 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 belgenin nasıl kopyalanacağı gösterilmektedir. Drive API çağrısında kullanılacak kimliği belge URL'sinde bulabilirsiniz. Daha fazla bilgi için Belge Kimliği başlıklı makaleyi inceleyin.

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.