댓글은 리더와 같이 사용자가 파일에 제공한 의견입니다. 워드 프로세싱 문서입니다. 두 가지 앵커 댓글과 고정되지 않은 댓글의 유형이 있습니다. 고정된 댓글이 특정 위치와 연결되어 있는 경우, 예를 들어 워드 프로세싱 문서를 대상으로 합니다. 반대로 고정되지 않은 주석은 문서와 연결됩니다.
답글은 댓글에 첨부되어 다음 항목에 대한 사용자의 응답을 나타냅니다. 있습니다. Drive API를 사용하면 사용자가 문서를 만들 수 있습니다 답글이 있는 댓글을 통칭하여 토론
고정되지 않은 댓글 추가
문서에 고정되지 않은 댓글을 추가하려면 fileId 매개변수와 함께 comments.create 메서드를 호출하고
댓글이 포함된 comments 리소스입니다.
주석은 일반 텍스트로 삽입되지만 응답 본문은
표시할 형식의 콘텐츠가 포함된 htmlContent 필드
댓글에 답글 추가
댓글에 답글을 추가하려면
replies.create 메서드를 주석으로 교체합니다.
fileId 매개변수 및 replies 리소스
답장이 포함됩니다.
답장은 일반 텍스트로 삽입되지만 응답 본문은
표시할 형식의 콘텐츠가 포함된 htmlContent 필드
문서의 최신 버전에 앵커 댓글 추가하기
주석을 추가할 때 파일의 특정 영역에 고정할 수 있습니다.
앵커는 댓글이 달린 파일의 파일 버전 및 지역을 정의합니다.
나타냅니다. comments 리소스는
anchor 필드를 JSON 문자열로 표현합니다.
고정 댓글을 추가하려면 다음 단계를 따르세요.
(선택사항)
revisions.list를 호출합니다. 메서드를 사용하여 문서의 모든revisionID를 나열할 수 있습니다. 다음 경우에만 이 단계를 따르세요. 최신 버전이 아닌 다른 버전에 댓글을 고정하려는 경우 최신 버전을 사용하려면revisionID에head를 사용합니다.comments.create메서드 호출fileID매개변수,comments리소스, 그리고revisionID(r) 및 리전 (a)
지역을 정의하는 방법은 작업 중인 문서 콘텐츠의 유형에 따라 다릅니다. 있습니다. 자세한 내용은 리전 정의를 참고하세요.
지역 정의
앞서 언급했듯이 JSON 앵커 문자열에는 revisionID (r) 및
리전 (a)을 선택합니다. 리전 (a)은 리전 분류 기준이 포함된 JSON 배열입니다.
주석이 고정되는 형식과 위치를 지정합니다. 분류기
이미지의 2차원 직사각형, 문서의 텍스트 줄,
동영상의 길이로 지정할 수 있습니다. 리전을 정의하려면 리전을 선택합니다.
분류 기준을 지정합니다. 대상
예를 들어 콘텐츠가 텍스트인 경우 txt
또는 line 지역 분류 기준입니다.
Drive API의 지역 분류 기준 목록은 지역을 참조하세요. 분류 기준을 참조하세요.
다음 예는 주석을 줄에 고정하는 JSON 앵커 문자열을 보여줍니다. 은 문서의 두 개별 영역에 표시됩니다.
- 첫 번째 영역은 12번 행 (
'n':12)에서 시작하여 3줄까지 확장됩니다. ('l':3). - 두 번째 영역은 18번 줄 (
'n':18, 'l':1`)만 포함합니다.
{
'r': 'REVISION_ID',
'a': [
{
'line':
{
'n': 12,
'l': 3,
}
},
{
'line':
{
'n': 18,
'l': 1,
}
}]
}
REVISION_ID를 head 또는 특정 ID로 바꿉니다.
있습니다.
댓글 해결
comment.update 메서드를 사용하여
comments의 resolved 속성
댓글이 처리되면 true에 리소스를 보냅니다.
앱에서 resolved 속성을 true로 설정하면 UI는 다음을 나타내야 합니다.
댓글이 처리되었음을 알립니다. 앱의 예는 다음과 같습니다.
- 추가 답장을 허용하지 않으며 이전 답장과 원본 답장을 모두 흐리게 표시합니다. 있습니다.
- 해결된 댓글을 숨깁니다.
댓글 삭제
comments.delete 메서드를 사용하여 다음을 수행합니다.
댓글을 삭제합니다. 댓글이 삭제되면 Drive에서
"deleted": "true"로 주석 리소스를 추가합니다.
댓글 나열
comments.list 메서드를 사용하여 나열
있습니다. 삭제된 댓글을 결과에 포함하려면
includedDeleted 필드를 true로 변경합니다.