ใช้งานรายการ

Google เอกสาร API สนับสนุนการแปลงย่อหน้าธรรมดาเป็นรายการหัวข้อย่อย และ นำสัญลักษณ์หัวข้อย่อยออกจากย่อหน้า

แปลงย่อหน้าเป็นรายการ

การจัดรูปแบบย่อหน้าโดยทั่วไปคือการแปลงย่อหน้าเป็นหัวข้อย่อย รายการ

หากต้องการสร้างรายการ ให้ใช้วิธี documents.batchUpdate แล้วระบุ CreateParagraphBulletsRequest ใส่ Range เพื่อระบุ ที่ได้รับผลกระทบและ BulletGlyphPreset เพื่อกำหนดรูปแบบของสัญลักษณ์หัวข้อย่อย

ย่อหน้าทั้งหมดที่ซ้อนทับกับช่วงที่ระบุจะถูกใส่สัญลักษณ์หัวข้อย่อย หากระบุ ทับซ้อนกับตาราง มีการใช้สัญลักษณ์หัวข้อย่อยภายในเซลล์ของตาราง ระดับการซ้อนของแต่ละย่อหน้าจะกำหนดโดยการนับแท็บนำอยู่ด้านหน้า ของแต่ละย่อหน้า

คุณปรับระดับการฝังของหัวข้อที่มีอยู่ไม่ได้ แต่คุณต้องลบหัวข้อย่อยแทน โดยตั้งแท็บที่นำอยู่หน้า แล้วสร้างหัวข้อย่อยอีกครั้ง โปรดดูข้อมูลเพิ่มเติมที่นำออก หัวข้อย่อยจากรายการ

คุณยังใช้ CreateParagraphBulletsRequest เพื่อเปลี่ยนรูปแบบหัวข้อย่อยสำหรับ รายการที่มีอยู่

ตัวอย่างโค้ดต่อไปนี้แสดงคำขอแบบกลุ่มที่แทรกข้อความที่ ส่วนต้นของเอกสาร จากนั้นจะสร้างรายการจากย่อหน้าต่างๆ 50 อักขระแรก BulletGlyphPreset ใช้ BULLET_ARROW_DIAMOND_DISC ซึ่งหมายถึงระดับการซ้อน 3 ระดับแรกของฟิลด์ รายการสัญลักษณ์หัวข้อย่อยจะแสดงด้วยลูกศร ข้าวหลามตัด และดิสก์

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setInsertText(new InsertTextRequest()
        .setText("Item One\n")
        .setLocation(new Location().setIndex(1).setTabId(TAB_ID))));

requests.add(new Request().setCreateParagraphBullets(
        new CreateParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))
                .setBulletPreset("BULLET_ARROW_DIAMOND_DISC")));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

Python

requests = [
        {
        'insertText': {
            'location': {
                'index': 1,
                'tabId': TAB_ID
            },
            'text': 'Item One\n',
        }}, {
        'createParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
            'bulletPreset': 'BULLET_ARROW_DIAMOND_DISC',
        }
    }
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()
วันที่ แปลงย่อหน้าเป็นรายการ
รูปที่ 1 แปลงย่อหน้าเป็นรายการ

นำสัญลักษณ์หัวข้อย่อยออกจากรายการ

หากต้องการนำหัวข้อย่อยออกจากรายการย่อหน้า ให้ใช้ documents.batchUpdate และระบุ DeleteParagraphBulletsRequest ใส่ Range เพื่อระบุ เซลล์ที่ได้รับผลกระทบ

เมธอดนี้จะลบหัวข้อทั้งหมดที่ทับซ้อนกับช่วงที่กำหนด โดยไม่คำนึงถึงระดับการฝัง ระบบจะเพิ่มการเยื้องไว้ที่ตอนต้นของย่อหน้าที่เกี่ยวข้องแต่ละย่อหน้าเพื่อรักษาระดับการฝังไว้

ตัวอย่างโค้ดต่อไปนี้แสดงคำขอแบบกลุ่มที่ลบหัวข้อย่อยจาก รายการย่อหน้า

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setDeleteParagraphBullets(
        new DeleteParagraphBulletsRequest()
                .setRange(new Range()
                        .setStartIndex(1)
                        .setEndIndex(50)
                        .setTabId(TAB_ID))));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

Python

requests = [
        {
        'deleteParagraphBullets': {
            'range': {
                'startIndex': 1,
                'endIndex':  50,
                'tabId': TAB_ID
            },
        }
    }
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()