ความคิดเห็นคือความคิดเห็นที่ผู้ใช้ให้ไว้ในไฟล์ เช่น โปรแกรมอ่านเอกสารที่แนะนำวิธีปรับเปลี่ยนประโยค ความคิดเห็นมี 2 ประเภท ได้แก่ ความคิดเห็นที่ตรึงไว้และความคิดเห็นที่ไม่ได้ตรึงไว้ ความคิดเห็นที่ตรึงไว้จะเชื่อมโยงกับตำแหน่งที่เฉพาะเจาะจง เช่น ประโยคในเอกสารการประมวลผลคำ ภายในเอกสารในเวอร์ชันที่กำหนด ในทางกลับกัน ความคิดเห็นที่ไม่ได้ตรึงจะเชื่อมโยงกับเอกสารนั้น
การตอบกลับจะแนบไปกับความคิดเห็นและจะแสดงการตอบกลับความคิดเห็นของผู้ใช้ Google Drive API ช่วยให้ผู้ใช้เพิ่มความคิดเห็นและการตอบกลับเอกสาร ที่แอปของคุณสร้างได้ โดยความคิดเห็นที่มีการตอบกลับรวมกันเรียกว่าการสนทนา
เพิ่มความคิดเห็นที่ไม่ได้ตรึงไว้
หากต้องการเพิ่มความคิดเห็นที่ไม่ได้ตรึงลงในเอกสาร ให้เรียกใช้เมธอด comments.create
ด้วยพารามิเตอร์ fileId
และทรัพยากร comments
ที่มีความคิดเห็นดังกล่าว
ความคิดเห็นจะแทรกเป็นข้อความธรรมดา แต่เนื้อหาการตอบกลับจะมีช่อง htmlContent
ที่มีเนื้อหาซึ่งจัดรูปแบบสำหรับแสดงผล
เพิ่มการตอบกลับความคิดเห็น
หากต้องการเพิ่มการตอบกลับความคิดเห็น ให้เรียกใช้เมธอด replies.create
ที่มีความคิดเห็น พารามิเตอร์ fileId
และทรัพยากร reply
ที่มีการตอบกลับนั้น
ระบบจะแทรกการตอบกลับเป็นข้อความธรรมดา แต่เนื้อหาการตอบกลับจะมีช่อง htmlContent
ที่มีเนื้อหาซึ่งจัดรูปแบบสำหรับแสดงผล
เพิ่มความคิดเห็นที่ตรึงไว้ในการแก้ไขครั้งล่าสุดของเอกสาร
เมื่อเพิ่มความคิดเห็น คุณควรตรึงความคิดเห็นนั้นกับภูมิภาคในไฟล์ anchor กำหนดการแก้ไขและภูมิภาคของไฟล์ในไฟล์ที่อ้างอิงความคิดเห็น ทรัพยากร comments
กำหนดช่อง anchor
เป็นสตริง JSON
หากต้องการเพิ่มความคิดเห็นที่ตรึงไว้ ให้ทำดังนี้
(ไม่บังคับ) เรียกใช้เมธอด
revisions.list
เพื่อแสดงทุกๆrevisionID
สำหรับเอกสาร ทำตามขั้นตอนนี้เฉพาะเมื่อต้องการตรึงความคิดเห็นไว้กับการแก้ไขอื่นนอกเหนือจากการแก้ไขล่าสุด หากต้องการใช้การแก้ไขล่าสุด ให้ใช้head
สำหรับrevisionID
เรียกเมธอด
comments.create
ด้วยพารามิเตอร์fileID
ซึ่งเป็นทรัพยากรcomments
ที่มีความคิดเห็น และสตริง Anchor ของ JSON ที่มีrevisionID
(r
) และภูมิภาค (a
)
วิธีกำหนดภูมิภาคจะขึ้นอยู่กับประเภทเนื้อหาเอกสารที่คุณใช้งานอยู่ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อกำหนดภูมิภาคด้านล่าง
กำหนดภูมิภาค
ดังที่กล่าวไว้ก่อนหน้านี้ สตริง Anchor ของ JSON มี revisionID
(r
) และภูมิภาค (a
) ภูมิภาค (a
) เป็นอาร์เรย์ JSON ที่มีตัวแยกประเภทภูมิภาคซึ่งระบุรูปแบบและตำแหน่งที่จะตรึงความคิดเห็น ตัวแยกประเภทอาจเป็นสี่เหลี่ยมผืนผ้า 2 มิติสำหรับรูปภาพ บรรทัดข้อความในเอกสาร ระยะเวลาในวิดีโอ และอื่นๆ หากต้องการกำหนดภูมิภาค ให้เลือกตัวแยกประเภทภูมิภาคที่ตรงกับประเภทเนื้อหาที่คุณพยายามตรึงไว้ ตัวอย่างเช่น หากเนื้อหาเป็นข้อความ คุณก็มีแนวโน้มที่จะใช้ตัวแยกประเภทภูมิภาค txt
หรือ line
ดูรายการตัวแยกประเภทภูมิภาคใน API ของไดรฟ์ได้ที่ตัวแยกประเภทภูมิภาค
ตัวอย่างต่อไปนี้แสดงสตริง Anchor ของ JSON ที่ตรึงความคิดเห็นไว้ในบรรทัดในพื้นที่ 2 ส่วนแยกกันของเอกสาร
- พื้นที่แรกเริ่มต้นที่บรรทัดที่ 12 (
'n':12
) และขยายออกไปเป็น 3 บรรทัด ('l':3
) - ส่วนที่ 2 จะครอบคลุมเฉพาะบรรทัดที่ 18 (
'n':18, 'l':1
") เท่านั้น
{
'r': 'REVISION_ID',
'a': [
{
'line':
{
'n': 12,
'l': 3,
}
},
{
'line':
{
'n': 18,
'l': 1,
}
}]
}
แทนที่ REVISION_ID ด้วย head
หรือรหัสของการแก้ไขที่เฉพาะเจาะจง
ปิดความคิดเห็น
ใช้เมธอด comment.update
เพื่อตั้งค่าพร็อพเพอร์ตี้ resolved
ในแหล่งข้อมูล comments
เป็น true
เมื่อความคิดเห็นได้รับการแก้ไขแล้ว
เมื่อแอปตั้งค่าพร็อพเพอร์ตี้ resolved
เป็น true
UI ควรระบุว่าความคิดเห็นนั้นได้รับการแก้ไขแล้ว ตัวอย่างเช่น แอปอาจมีลักษณะดังนี้
- ไม่อนุญาตให้ตอบกลับเพิ่มเติมและหรี่แสงการตอบกลับก่อนหน้านี้ทั้งหมดบวกกับความคิดเห็นเดิม
- ซ่อนความคิดเห็นที่แก้ไขปัญหาแล้ว
ลบความคิดเห็น
ใช้วิธีการ comments.delete
เพื่อลบความคิดเห็น เมื่อลบความคิดเห็น ไดรฟ์จะทำเครื่องหมายทรัพยากรของความคิดเห็นเป็น "deleted": "true"
แสดงความคิดเห็น
ใช้เมธอด comments.list
เพื่อแสดงรายการความคิดเห็น หากคุณต้องการรวมความคิดเห็นที่ถูกลบไว้ในผลการค้นหา ให้ตั้งค่าช่อง includedDeleted
เป็น true