Criar e gerenciar documentos

Esta página da API Google Docs descreve como realizar determinadas tarefas de alto nível envolvendo documentos do Google Docs, como:

  • Criar um documento
  • Copiar um documento

Os parágrafos a seguir descrevem essas tarefas detalhadamente.

Criar um documento em branco

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

O exemplo de código abaixo 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 pastas do Google Drive

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

No entanto, há 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 a criação de arquivos, consulte Criar um arquivo em uma pasta específica.

Em qualquer uma das alternativas, você precisa adicionar os escopos adequados 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 suporte a drives compartilhados.

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. Você pode encontrar o ID a ser usado para a chamada da API Drive 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 Drive API para autorizar a chamada. Para mais informações sobre os escopos do Drive, consulte Escolher escopos da API Google Drive.