En esta página de la API de Documentos de Google, se describe cómo realizar ciertas tareas de alto nivel relacionadas con los 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 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')))
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:
Después de crear el documento, muévelo a una carpeta específica con el método
files.update
de la API de Drive. 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 el método
files.create
de la API de Drive y especificaapplication/vnd.google-apps.document
comomimeType
. Para obtener más información sobre cómo crear archivos, consulta Cómo crear un archivo en una carpeta específica.
Para cualquiera de las alternativas, deberás agregar los ámbitos de la API de Drive adecuados para autorizar la llamada. Para obtener más información sobre los alcances de Drive, consulta Cómo elegir los alcances de 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 la siguiente muestra 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 ámbito 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.