Cette page de l'API Google Docs explique comment effectuer certaines tâches de haut niveau impliquant des documents Google Docs, par exemple:
- Créer un document
- Copier un document existant
Les paragraphes suivants décrivent ces tâches en détail.
Créer un document vierge
Pour créer un document, utilisez la méthode documents.create
sur la collection documents
.
L'exemple de code suivant montre comment créer un document vierge avec un titre spécifié:
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')))
Utiliser les dossiers Google Drive
Il n'est pas possible de créer un document directement dans un dossier Drive spécifié avec l'API Docs. Par défaut, le document créé est enregistré dans le dossier racine de l'utilisateur sur Drive.
Toutefois, il existe deux façons d'enregistrer un fichier dans un dossier Drive:
Une fois le document créé, déplacez-le vers un dossier spécifique à l'aide de la méthode
files.update
de l'API Drive. Pour en savoir plus sur le déplacement de fichiers, consultez la page Déplacer des fichiers entre des dossiers.Ajoutez un document vierge à un dossier à l'aide de la méthode
files.create
de l'API Drive, en spécifiantapplication/vnd.google-apps.document
commemimeType
. Pour en savoir plus sur la création de fichiers, consultez la section Créer un fichier dans un dossier spécifique.
Dans les deux cas, vous devez ajouter les champs d'application de l'API Drive appropriés pour autoriser l'appel. Pour en savoir plus sur les champs d'application Drive, consultez Choisir les champs d'application des API Google Drive.
Pour déplacer ou créer un fichier dans un dossier de Drive partagé, consultez Implémenter la compatibilité avec les Drive partagés.
Copier un document existant
Pour copier un document, utilisez la méthode files.copy
de l'API Drive.
L'exemple de code suivant montre comment copier un document existant. Vous trouverez l'ID à utiliser pour l'appel d'API Drive dans l'URL du document. Pour en savoir plus, consultez la section ID du document.
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')
Notez que vous devez utiliser un champ d'application d'API Drive approprié pour autoriser l'appel. Pour en savoir plus sur les champs d'application Drive, consultez Choisir les champs d'application des API Google Drive.
Articles associés
- Insérer, supprimer et déplacer du texte
- Fusionner du texte dans un document
- Concepts liés aux documents