Crea y administra documentos

En esta página de la API de Google Docs, se describe cómo realizar ciertas tareas de alto nivel relacionadas con los documentos de Google Docs, como las siguientes:

  • Crea un documento
  • Cómo copiar un documento existente

En los siguientes párrafos, se describen estas tareas en detalle.

Cómo crear un documento en blanco

Para crear un documento, usa el método documents.create en la colección documents.

En el siguiente ejemplo de código, se muestra cómo crear un documento en blanco con un 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')))

Trabaja con carpetas de Google Drive

No existe la opción de crear un documento directamente en una carpeta de Drive especificada con la API de Docs. De forma predeterminada, el documento creado se guarda en la carpeta raíz del usuario en Drive.

Sin embargo, existen dos alternativas para guardar un archivo en una carpeta de Drive:

Para cualquiera de las alternativas, deberás agregar los alcances de la API de Drive adecuados para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Elige permisos para la API de Google Drive.

Para mover o crear un archivo en una carpeta de unidad compartida, consulta Implementa la compatibilidad con unidades compartidas.

Cómo copiar un documento existente

Para copiar un documento, usa el método files.copy de la API de Drive.

En el siguiente ejemplo de código, se muestra cómo copiar un documento existente. Puedes encontrar el ID que se usará para la llamada a la API de Drive en la URL del documento. Para obtener más información, consulta ID del 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')

Ten en cuenta que debes usar un alcance de la API de Drive adecuado para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Elige permisos para la API de Google Drive.