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 em detalhes.

Criar um documento em branco

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

O exemplo de código a seguir mostra como criar um documento em branco com um valor title

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á a opção de criar um documento diretamente em um pasta do Drive usando a API Docs. Por padrão, o o documento criado é salvo na pasta raiz do usuário no Google Drive.

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

  • Após a criação do documento, mova-o para uma pasta específica usando 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 as APIs do Drive Método files.create, especificando application/vnd.google-apps.document como mimeType. Para mais informações sobre como criar arquivos, consulte Criar um arquivo em um ou pasta.

Nas duas opções, é necessário adicionar a API Drive apropriada escopos para autorizar a ligação. Saiba mais sobre os escopos do Drive em Escolher escopos da API Google Drive.

Para mover ou criar um arquivo em uma pasta do drive compartilhado, consulte Implementar suporte ao Google Drive.

Copiar um documento

Para copiar um documento, use as APIs do Drive método files.copy.

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 uma API do Google Drive apropriada escopo para autorizar a chamada. Saiba mais sobre os escopos do Drive em Escolher escopos da API Google Drive.