Na tej stronie interfejsu Google Docs API opisaliśmy, jak wykonywać niektóre zadania na poziomie ogólnym dotyczące dokumentów Dokumentów Google, takie jak:
- Utwórz dokument
- Kopiowanie istniejącego dokumentu
W następnych akapitach szczegółowo opisujemy te zadania.
Tworzenie pustego dokumentu
Aby utworzyć dokument, użyj metody documents.create
w kolekcji documents
.
Poniższy przykładowy kod pokazuje, jak utworzyć pusty dokument z określonym tytułem:
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 na Dysku Google
Nie można utworzyć dokumentu bezpośrednio w określonym folderze Dysku za pomocą interfejsu Docs API. Domyślnie utworzony dokument jest zapisywany w folderze głównym użytkownika na Dysku.
Istnieją jednak 2 alternatywne sposoby zapisywania plików w folderze 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, używając 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 Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.
Aby przenieść plik lub utworzyć go w folderze dysku współdzielonego, zapoznaj się z artykułem 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 do użycia w wywołaniu interfejsu Drive API znajdziesz w adresie URL dokumentu. Więcej informacji znajdziesz w artykule Document ID.
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 aby autoryzować wywołanie, musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.
Powiązane artykuły
- Wstawianie, usuwanie i przenoszenie tekstu
- Scalanie tekstu w dokumencie
- Pojęcia związane z dokumentami