Na tej stronie interfejsu API Dokumentów Google opisujemy, jak wykonywać ogólne zadania dotyczące dokumentów Dokumentów Google, takie jak:
- Utwórz dokument
- Kopiowanie istniejącego dokumentu
W kolejnych akapitach opisano te zadania szczegółowo.
Tworzenie pustego dokumentu
Aby utworzyć dokument, użyj metody documents.create
w kolekcji documents
.
Poniższy przykładowy kod pokazuje, jak utworzyć pusty dokument o określonym tytule:
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')))
Praca z folderami Dysku Google
Nie można utworzyć dokumentu bezpośrednio w określonym folderze Dysku za pomocą interfejsu API Dokumentów. Domyślnie utworzony dokument jest zapisywany w folderze głównym użytkownika na Dysku.
Istnieją jednak dwie możliwości zapisania pliku w folderze na Dysku:
Po utworzeniu dokumentu przenieś go do określonego folderu za pomocą metody
files.update
interfejsu Drive API. Więcej informacji o przenoszeniu plików znajdziesz w artykule Przenoszenie plików między folderami.Dodaj pusty dokument do folderu za pomocą metody
files.create
interfejsu Drive API, podającapplication/vnd.google-apps.document
jakomimeType
. Więcej informacji o tworzeniu plików znajdziesz w artykule Tworzenie pliku w określonym folderze.
W obu przypadkach musisz dodać odpowiednie zakresy interfejsu Drive API, aby autoryzować wywołanie. Więcej informacji o zakresach dotyczących Dysku znajdziesz w artykule Wybieranie zakresów interfejsów API Dysku Google.
Informacje o tym, jak przenieść lub utworzyć plik w obrębie folderu dysku współdzielonego, znajdziesz w artykule Wdrażanie obsługi dysków współdzielonych.
Kopiowanie istniejącego dokumentu
Aby skopiować dokument, użyj metody files.copy
interfejsu Drive API.
Poniższy przykładowy kod pokazuje, jak skopiować istniejący dokument. Identyfikator użyty do wywołania interfejsu Drive API znajdziesz w adresie URL dokumentu. Więcej informacji znajdziesz w artykule Identyfikator dokumentu.
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')
Pamiętaj, że do autoryzacji wywołania musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach dotyczących Dysku znajdziesz w artykule Wybieranie zakresów interfejsów API Dysku Google.