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 incluyan documentos de Documentos de Google, como:

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

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

Crear un documento en blanco

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

En la siguiente muestra de código, se indica cómo crear un documento en blanco con un valor especificado título:

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 es posible crear un documento directamente dentro de un carpeta de Drive con la API de Documentos. De forma predeterminada, el el documento creado se guarda en la carpeta raíz del usuario en Drive.

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

  • Luego de crear el documento, muévelo a una carpeta específica con API de Drive files.update . Para obtener más información sobre cómo mover archivos, consulta Cómo mover archivos entre carpetas.

  • Agrega un documento en blanco a una carpeta con las APIs de Drive files.create si se especifica application/vnd.google-apps.document como mimeType. Para ver más información sobre la creación de archivos, consulta Crear un archivo en un carpeta.

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

Para mover o crear un archivo en una carpeta de una unidad compartida, consulta Cómo implementar archivos compartidos para fomentar la asistencia al cliente.

Cómo copiar un documento existente

Para copiar un documento, usa las APIs de Drive files.copy.

En la siguiente muestra de código, se indica 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 ver más 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 una API de Drive correcta permiso para autorizar el llamada. Para obtener más información sobre los alcances de Drive, consulta Elige Permisos de la API de Google Drive