Crea e gestisci documenti

Questa pagina dell'API Google Docs descrive come eseguire determinate attività di alto livello che coinvolgono i documenti Google Docs, ad esempio:

  • Crea un documento
  • Copiare un documento esistente

I paragrafi che seguono descrivono queste attività nel dettaglio.

Creare un documento vuoto

Per creare un documento, utilizza il metodo documents.create nella raccolta documents.

Il seguente esempio di codice mostra come creare un documento vuoto con un titolo specificato:

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')))

Lavorare con le cartelle di Google Drive

Non esiste alcuna opzione per creare un documento direttamente all'interno di una cartella Drive specificata utilizzando l'API Documenti. Per impostazione predefinita, il documento creato viene salvato nella cartella principale dell'utente su Drive.

Tuttavia, esistono due alternative al salvataggio di un file in una cartella di Drive:

Per entrambe le alternative, dovrai aggiungere gli ambiti dell'API Drive per autorizzare la chiamata. Per ulteriori informazioni sugli ambiti di Drive, vedi Scegliere gli ambiti dell'API Google Drive.

Per spostare o creare un file all'interno di una cartella del Drive condiviso, consulta Implementare il supporto del Drive condiviso.

Copiare un documento esistente

Per copiare un documento, utilizza il metodo files.copy dell'API Drive.

Il seguente esempio di codice mostra come copiare un documento esistente. Puoi trovare l'ID da utilizzare per la chiamata all'API Drive nell'URL del documento. Per saperne di più, consulta ID 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')

Tieni presente che per autorizzare la chiamata devi utilizzare un ambito API Drive appropriato. Per ulteriori informazioni sugli ambiti di Drive, vedi Scegliere gli ambiti dell'API Google Drive.