Esta página de la API de Documentos de Google describe cómo realizar ciertas tareas de alto nivel que incluyen documentos de Documentos de Google, como las siguientes:
- Crea un documento
- 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 método
documents.create
en la colección
documents
.
En la siguiente muestra de código, se indica 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 existe la opción de crear un documento directamente en una carpeta de Drive específica con la API de Documentos. 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:
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
como lamimeType
. Si quieres obtener más información para crear archivos, consulta Cómo crear un archivo en una carpeta específica.
Como alternativa, deberás agregar los permisos de la API de Drive adecuados para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Cómo elegir los permisos de la API de Google Drive.
Para mover o crear un archivo dentro de una carpeta de una unidad compartida, consulta Cómo implementar la compatibilidad con unidades compartidas.
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 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 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 de API de Drive adecuado para autorizar la llamada. Para obtener más información sobre los permisos de Drive, consulta Cómo elegir los permisos de la API de Google Drive.