Créer et gérer des documents

Cette page explique comment effectuer certaines tâches de haut niveau impliquant des documents, 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 create sur la collection documents, comme illustré dans l'exemple suivant.

Cet exemple crée un document vierge avec un titre spécifique.

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 des dossiers Google Drive

Il n'est pas possible de créer un document directement dans un dossier Drive spécifié à l'aide de l'API Docs. Par défaut, le document créé est enregistré dans le dossier racine de l'utilisateur sur Drive.

Toutefois, il existe deux alternatives à l'enregistrement d'un fichier dans un dossier Drive:

• Une fois le document créé, déplacez-le dans 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 l'article Déplacer des fichiers d'un dossier à un autre.
• Ajoutez un document vierge à un dossier en utilisant 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 l'article Créer un fichier dans un dossier.

Dans les deux cas, vous devez ajouter les champs d'application d'API Drive appropriés pour autoriser l'appel.

Pour déplacer ou créer un fichier dans un dossier de Drive partagé, consultez Mettre en place 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.

Les exemples suivants copient un document existant. L'ID à utiliser pour l'appel d'API Drive se trouve dans l'URL 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 de l'API Drive approprié pour autoriser l'appel.