Criar e gerenciar documentos

Esta página da API Google Docs descreve como executar determinadas tarefas de alto nível que envolvem documentos Google, como:

  • Criar um documento
  • Copiar um documento

Os parágrafos a seguir descrevem essas tarefas em detalhes.

Criar um documento em branco

Para criar um documento, use o método documents.create na coleção documents.

O exemplo de código a seguir mostra como criar um documento em branco com um título especificado:

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')))

Trabalhar com as pastas do Google Drive

Não há a opção de criar um documento diretamente em uma pasta especificada do Drive usando a API Docs. Por padrão, o documento criado é salvo na pasta raiz do usuário no Drive.

No entanto, existem duas alternativas para salvar um arquivo em uma pasta do Drive:

  • Depois que o documento for criado, mova-o para uma pasta específica usando o método files.update da API Drive. Para mais informações sobre como mover arquivos, consulte Mover arquivos entre pastas.

  • Adicione um documento em branco a uma pasta usando o método files.create da API Drive, especificando application/vnd.google-apps.document como mimeType. Para mais informações sobre como criar arquivos, consulte Criar um arquivo em uma pasta específica.

Para qualquer alternativa, será preciso adicionar os escopos apropriados da API Drive para autorizar a chamada. Para mais informações sobre os escopos do Drive, consulte Escolher escopos da API Google Drive.

Para mover ou criar um arquivo em uma pasta de drive compartilhado, consulte Implementar o suporte ao drive compartilhado.

Copiar um documento

Para copiar um documento, use o método files.copy da API Drive.

O exemplo de código a seguir mostra como copiar um documento existente. Esse ID pode ser encontrado no URL do documento. Para mais informações, consulte ID do documento.

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')

É necessário usar um escopo adequado da API Drive para autorizar a chamada. Para mais informações sobre os escopos do Drive, consulte Escolher escopos da API Google Drive.