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, tels que:

  • 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 documents.create sur la collection documents.

L'exemple de code suivant montre comment créer un document vierge avec un élément titre:

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

Aucune option ne permet de créer un document directement dans une Drive à l'aide de l'API Docs. Par défaut, document créé est enregistré dans le dossier racine de l'utilisateur sur Drive.

Toutefois, il existe deux façons d'enregistrer un fichier dans Drive. dossier:

  • Une fois le document créé, déplacez-le vers un dossier spécifique en utilisant files.update de l'API Drive . Pour en savoir plus sur le déplacement de fichiers, consultez l'article Déplacer des fichiers entre dossiers.

  • Ajouter un document vierge à un dossier à l'aide de l'API Drive files.create, en spécifiant application/vnd.google-apps.document en tant que mimeType. Pour plus sur la création de fichiers, consultez la section Créer un fichier dans un dossier.

Dans les deux cas, vous devez ajouter l'API Drive appropriée champs d'application pour autoriser l'appel. Pour en savoir plus sur les habilitations Drive, consultez l'article Choisir Champs d'application des API Google Drive

Pour déplacer ou créer un fichier dans un dossier de Drive partagé, consultez Implémenter le partage Drive.

Copier un document existant

Pour copier un document, utilisez les API Drive files.copy.

L'exemple de code suivant montre comment copier un document existant. Vous trouverez ID à utiliser pour l'appel d'API Drive dans l'URL du document. Pour 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 une API Drive appropriée d'application pour autoriser . Pour en savoir plus sur les habilitations Drive, consultez l'article Choisir Champs d'application des API Google Drive