Crea y administra documentos

En esta página de la API de Documentos de Google, se describe cómo realizar ciertas tareas de alto nivel que involucran documentos de Documentos de Google, como las siguientes:

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

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

Crea un documento en blanco

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

En la siguiente muestra 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')))

Cómo trabajar con carpetas de Google Drive

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

Sin embargo, hay 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 Cómo implementar 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 de 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 apropiado de la API de Drive para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Elige permisos para la API de Google Drive.