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
  • Copia 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 método en la documents colección.

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());
}

Node.js

const title = 'My Document';
const resource = {
  title,
};
this.service.documents.create({
  resource,
}, (err, response) => {
  if (err) return console.log('The API returned an error: ' + err);
  console.log(`Created document with title: ${response.data.title}`);
});

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 hay ninguna opción para 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 permisos adecuados de la API de Drive para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Elige permisos de la API de Google Drive.

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

Copia un documento existente

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

Ten en cuenta que no puedes usar el método files.copy para copiar un documento publicado. Para obtener más información, consulta Documentos publicados.

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(DOCUMENT_ID, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

Node.js

var copyTitle = "Copy Title";
let request = {
  name: copyTitle,
};
this.driveService.files.copy({
  fileId: DOCUMENT_ID,
  resource: request,
}, (err, driveResponse) => {
  let documentCopyId = driveResponse.id;
});

PHP


$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
    'name' => $copyTitle
));
$driveResponse = $driveService->files->copy(DOCUMENT_ID, $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 permiso adecuado de la API de Drive para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Elige permisos de la API de Google Drive.