API Google Tài liệu cho phép bạn chèn hoặc xoá văn bản trong tài liệu. Việc di chuyển văn bản liên quan đến cả hai hoạt động, đứng sau get
của nội dung.
Bạn có thể chèn hoặc xoá văn bản trong bất kỳ phân đoạn nào của tài liệu (phần nội dung, đầu trang, chân trang hoặc chú thích cuối trang).
Chèn văn bản
Để chèn văn bản vào tài liệu, hãy sử dụng phương thức documents.batchUpdate
và thêm InsertTextRequest
với văn bản và vị trí làm tải trọng.
Mã mẫu sau đây cho thấy cách bạn có thể chèn một loạt chuỗi văn bản tại các vị trí chỉ mục được chỉ định trong phần nội dung tài liệu. Ví dụ này sử dụng 3 độ lệch mục tiêu (25, 50 và 75) và chèn một chuỗi gồm 10 ký tự tại mỗi vị trí.
Java
List<Request> requests = new ArrayList<>(); requests.add(new Request().setInsertText(new InsertTextRequest() .setText(text1) .setLocation(new Location().setIndex(25)))); requests.add(new Request().setInsertText(new InsertTextRequest() .setText(text2) .setLocation(new Location().setIndex(50)))); requests.add(new Request().setInsertText(new InsertTextRequest() .setText(text3) .setLocation(new Location().setIndex(75)))); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
1.199
$requests = array(); $requests[] = new Google_Service_Docs_Request(array( 'insertText' => array( 'text' => $text1, 'location' => array( 'index' => 25, ), ), 'insertText' => array( 'text' => $text2, 'location' => array( 'index' => 50, ), ), 'insertText' => array( 'text' => $text3, 'location' => array( 'index' => 75, ), ), )); $batchUpdateRequest = new Google_Service_Docs_BatchUpdateDocumentRequest(array( 'requests' => $requests )); $response = $service->documents->batchUpdate($documentId, $batchUpdateRequest);
Python
requests = [ { 'insertText': { 'location': { 'index': 25, }, 'text': text1 } }, { 'insertText': { 'location': { 'index': 50, }, 'text': text2 } }, { 'insertText': { 'location': { 'index': 75, }, 'text': text3 } }, ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()
Mỗi lần chèn sẽ làm tăng tất cả các chỉ mục được đánh số cao hơn theo kích thước của văn bản được chèn. Ví dụ này tính toán trước kết quả của những thay đổi chỉ mục này để các lượt chèn tiếp theo diễn ra ở độ lệch mới và đã được sửa. Do đó, để chèn ở độ lệch mục tiêu ban đầu là 25, 50 và 75, chỉ mục chèn thực tế sẽ là:
- Lần chèn đầu tiên sẽ thêm 10 ký tự tại độ lệch 25.
- Chèn thứ hai thêm 10 ký tự tại độ lệch 50 + 10=60.
- Chèn thứ ba thêm 10 ký tự tại độ lệch 75 + 10 + 10=95.
Xoá văn bản
Để xoá văn bản khỏi một tài liệu, trước tiên, hãy tạo Range
giúp xác định phạm vi của văn bản cần xoá. Sau đó, sử dụng phương thức documents.batchUpdate
và bao gồm một DeleteContentRangeRequest
.
Mã mẫu sau đây cho bạn biết cách xoá văn bản giữa chỉ mục 10 và chỉ mục 24 trong phần nội dung của tài liệu.
Java
List<Request> requests = new ArrayList<>(); requests.add(new Request().setDeleteContentRange( new DeleteContentRangeRequest() .setRange(new Range() .setStartIndex(10) .setEndIndex(24)) )); BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests); BatchUpdateDocumentResponse response = docsService.documents() .batchUpdate(DOCUMENT_ID, body).execute();
1.199
$requests = array(); $requests[] = new Google_Service_Docs_Request(array( 'deleteContentRange' => array( 'range' => array( 'startIndex' => 10, 'endIndex' => 24 ), ), )); $batchUpdateRequest = new Google_Service_Docs_BatchUpdateDocumentRequest(array( 'requests' => $requests )); $response = $service->documents->batchUpdate($documentId, $batchUpdateRequest);
Python
requests = [ { 'deleteContentRange': { 'range': { 'startIndex': 10, 'endIndex': 24, } } }, ] result = service.documents().batchUpdate( documentId=DOCUMENT_ID, body={'requests': requests}).execute()
Đơn giản hoá vấn đề bằng cách viết ngược. Tương tự như thao tác chèn, việc xoá văn bản sẽ làm thay đổi chỉ mục của tất cả văn bản "bên dưới" trong đoạn. Xin nhắc lại, việc ghi ngược lại có thể đơn giản hoá quá trình xử lý các chỉ mục.
Di chuyển văn bản
Để di chuyển văn bản, bạn xoá văn bản đó ở một vị trí rồi chèn vào nơi khác. Việc xoá nội dung không cung cấp cho bạn một bản sao của nội dung đó (không có khái niệm tương đương về bảng nhớ tạm). Vì vậy, trước tiên, bạn phải trích xuất nội dung của dải ô để có thể sử dụng trong yêu cầu chèn văn bản.
Chủ đề có liên quan
- Tạo và quản lý tài liệu
- Hợp nhất văn bản vào tài liệu
- Cấu trúc của một tài liệu trên Google Tài liệu