Créer et gérer des documents

Cette page de l'API Google Docs explique comment effectuer certaines tâches de haut niveau impliquant des documents Google Docs, telles que :

• Créer un document
• Copier un document existant

Les paragraphes suivants décrivent ces tâches en détail.

Créer un document vide

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 vide avec un titre spécifié :

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

$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);

title = 'My Document'
body = {
    'title': title
}
doc = service.documents() \
    .create(body=body).execute()
print('Created document with title: {0}'.format(
    doc.get('title')))

Travailler avec des dossiers Google Drive

L'API Docs ne permet pas de créer un document directement dans un dossier Drive spécifique. Par défaut, le document créé est enregistré dans le dossier racine de l'utilisateur sur Drive.

Toutefois, il existe deux alternatives pour 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 Déplacer des fichiers entre des dossiers.

• Ajoutez un document vide à un dossier à l'aide de la méthode files.create de l'API Drive, en spécifiant application/vnd.google-apps.document comme mimeType. Pour en savoir plus sur la création de fichiers, consultez Créer un fichier dans un dossier spécifique.

Dans les deux cas, vous devrez ajouter les scopes de l'API Drive appropriés pour autoriser l'appel. Pour en savoir plus sur les habilitations Drive, consultez Choisir les habilitations de l'API Google Drive.

Pour déplacer ou créer un fichier dans un dossier de Drive partagé, consultez Implémenter la prise en charge des 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 de l'API Drive dans l'URL du document. Pour en savoir plus, consultez ID de document.

https://docs.google.com/document/d/DOCUMENT_ID/edit

String copyTitle = "Copy Title";
File copyMetadata = new File().setName(copyTitle);
File documentCopyFile =
        driveService.files().copy(documentId, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

var copyTitle = "Copy Title";
let request = {
  name: copyTitle,
};
this.driveService.files.copy({
  fileId: documentId,
  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($documentId, $copy);
$documentCopyId = $driveResponse->id;

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 de l'API Drive approprié pour autoriser l'appel. Pour en savoir plus sur les habilitations Drive, consultez Choisir les habilitations de l'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