จัดการความคิดเห็นและการตอบกลับ

ความคิดเห็น คือความคิดเห็นที่ได้จากผู้ใช้เกี่ยวกับไฟล์ เช่น ผู้อ่านของ เอกสารประมวลผลคำที่แนะนำวิธีปรับเปลี่ยนประโยค มี 2 แบบ ประเภทของความคิดเห็น ได้แก่ ความคิดเห็นที่ตรึงไว้และความคิดเห็นที่ไม่ได้ตรึงไว้ แท็ก Anchor ความคิดเห็นเชื่อมโยงกับตำแหน่งที่เจาะจง เช่น ประโยคใน เอกสาร Word ภายในเอกสารเวอร์ชันที่เจาะจง ในทางกลับกัน ความคิดเห็นที่ไม่ได้ตรึงไว้ ก็เชื่อมโยงกับเอกสารเช่นกัน

การตอบกลับจะแนบไปกับความคิดเห็นและแสดงถึงคำตอบของผู้ใช้ต่อ ความคิดเห็น API ไดรฟ์จะช่วยให้ผู้ใช้สามารถแสดงความคิดเห็นและตอบกลับ ที่แอปของคุณสร้างขึ้น ความคิดเห็นที่มีการตอบกลับเรียกรวมกันว่า การอภิปราย

เพิ่มความคิดเห็นที่ไม่ได้ตรึง

หากต้องการเพิ่มความคิดเห็นที่ไม่ได้ตรึงลงในเอกสาร ให้เรียกเมธอด comments.create ที่มีพารามิเตอร์ fileId และ ทรัพยากร comments ที่มีความคิดเห็นดังกล่าว

ระบบจะแทรกความคิดเห็นเป็นข้อความธรรมดา แต่เนื้อหาการตอบกลับจะแสดง ฟิลด์ htmlContent ซึ่งมีเนื้อหาที่จัดรูปแบบสำหรับการแสดงผล

เพิ่มการตอบกลับความคิดเห็น

ในการเพิ่มการตอบกลับความคิดเห็น ให้เรียกใช้ replies.create ที่มีความคิดเห็น พารามิเตอร์ fileId และทรัพยากร replies ที่มีการตอบนั้นอยู่

ระบบจะแทรกการตอบกลับเป็นข้อความธรรมดา แต่เนื้อหาการตอบกลับจะแสดง ฟิลด์ htmlContent ซึ่งมีเนื้อหาที่จัดรูปแบบสำหรับการแสดงผล

เพิ่มความคิดเห็นที่ตรึงไว้ในการแก้ไขล่าสุดของเอกสาร

เมื่อคุณเพิ่มความคิดเห็น คุณควรตรึงความคิดเห็นไว้ในภูมิภาคในไฟล์ CANNOT TRANSLATE anchor กำหนดการแก้ไขไฟล์และภูมิภาคในไฟล์ที่ความคิดเห็น อ้างอิง ทรัพยากร comments กำหนด anchor เป็นสตริง JSON

วิธีเพิ่มความคิดเห็นที่ตรึงไว้มีดังนี้

  1. (ไม่บังคับ) โทรหา revisions.list เพื่อแสดง revisionID ทั้งหมดสำหรับเอกสาร โปรดทำตามขั้นตอนนี้เมื่อ คุณต้องตรึงความคิดเห็นไว้ในการแก้ไขอื่นๆ ที่ไม่ใช่การแก้ไขล่าสุด หากต้องการใช้การแก้ไขล่าสุด ให้ใช้ head สำหรับ revisionID

  2. เรียกใช้เมธอด comments.create ที่มีพารามิเตอร์ fileID แอตทริบิวต์ comments ที่มีความคิดเห็น และสตริง Anchor ของ JSON ที่มี revisionID (r) และภูมิภาค (a)

วิธีกำหนดภูมิภาคจะขึ้นอยู่กับประเภทของเนื้อหาเอกสารที่คุณกําลังทํางาน ด้วย ดูข้อมูลเพิ่มเติมได้ที่กำหนดภูมิภาค

กำหนดภูมิภาค

ดังที่กล่าวไว้ก่อนหน้านี้ สตริง Anchor ของ JSON มี revisionID (r) และ ภูมิภาค (a) Region (a) คืออาร์เรย์ JSON ที่มีตัวแยกประเภทภูมิภาค ระบุรูปแบบและตำแหน่งที่จะตรึงความคิดเห็นไว้ ตัวแยกประเภท อาจเป็นสี่เหลี่ยมผืนผ้า 2 มิติสำหรับรูปภาพ บรรทัดข้อความในเอกสาร หรือระยะเวลาในวิดีโอ หากต้องการกำหนดภูมิภาค ให้เลือกภูมิภาค ตัวแยกประเภทที่ตรงกับประเภทเนื้อหาที่คุณพยายามจะยึด สำหรับ ตัวอย่างเช่น หากเนื้อหาเป็นข้อความ คุณอาจจะใช้ txt หรือตัวแยกประเภทภูมิภาค line

สำหรับรายการตัวแยกประเภทภูมิภาคใน Drive API โปรดดูภูมิภาค ตัวแยกประเภท

ตัวอย่างต่อไปนี้แสดงสตริง Anchor ของ JSON ที่ยึดความคิดเห็นไว้ในบรรทัด ออกเป็น 2 ส่วนแยกกันของเอกสาร ได้แก่

  • พื้นที่แรกเริ่มต้นที่บรรทัดที่ 12 ('n':12) และขยายเป็นสามบรรทัด ('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