Crea e gestisci documenti

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

  • Crea un documento
  • Copia un documento esistente

I seguenti paragrafi descrivono nel dettaglio queste attività.

Crea un documento vuoto

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

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

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

Lavora con le cartelle di Google Drive

Non è possibile creare un documento direttamente all'interno di una Drive utilizzando l'API Documenti. Per impostazione predefinita, viene salvato nella cartella principale dell'utente su Drive.

Tuttavia, esistono due alternative per salvare un file su Drive cartella:

  • Dopo aver creato il documento, spostalo in una cartella specifica utilizzando API Drive: files.update . Per ulteriori informazioni sullo spostamento di file, vedi Spostare file tra cartelle.

  • Aggiungi un documento vuoto a una cartella utilizzando lo strumento files.create, specificando application/vnd.google-apps.document come mimeType. Per ulteriori informazioni informazioni sulla creazione dei file, consulta l'articolo Creare un file in una cartella cartella.

Per entrambe le alternative, dovrai aggiungere l'API Drive appropriata ambiti da autorizzare la chiamata. Per ulteriori informazioni sugli ambiti di Drive, consulta l'articolo sulla scelta degli Ambiti dell'API Google Drive.

Per spostare o creare un file all'interno della cartella di un Drive condiviso, vedi Implementare i file condivisi assistenza Drive.

Copia un documento esistente

Per copiare un documento, utilizza l'API Drive files.copy.

Il seguente esempio di codice mostra come copiare un documento esistente. Puoi visualizzare L'ID da utilizzare per la chiamata all'API Drive nell'URL del documento. Per ulteriori informazioni informazioni, 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 devi utilizzare un'API Drive appropriata ambito per autorizzare chiamata. Per ulteriori informazioni sugli ambiti di Drive, consulta l'articolo sulla scelta degli Ambiti dell'API Google Drive.