annotation_logs

sift/annotation_logs/v1/annotation_logs.proto

Field	Type	Label	Description
type	AnnotationCommentBodyElementType
text	string
user_mention	AnnotationCommentUserMention

Field	Type	Label	Description
user_id	string
user_email	string

Field	Type	Label	Description
assigned_to_user_id	string
assigned_to_user_email	string

Field	Type	Label	Description
body	AnnotationCommentBodyElement	repeated

Field	Type	Label	Description
annotation_log_id	string
created_date	google.protobuf.Timestamp
modified_date	google.protobuf.Timestamp
annotation_id	string
kind	AnnotationLogKind
created_by_user_id	string
created_by_user_name	string
assigned	AnnotationLogAssignedProperties
state_update	AnnotationLogStateUpdateProperties
comment	AnnotationLogCommentProperties

Field	Type	Label	Description
state	AnnotationLogState

The request for a call to AnnotationLogService_CreateAnnotationLog to create an annotation log.

Field	Type	Description
annotation_id	string	The ID of the parent annotation associated to associate with the new annotation log.
kind	AnnotationLogKind	The kind of annotation log to create.
assigned	AnnotationLogAssignedProperties
state_update	AnnotationLogStateUpdateProperties
comment	AnnotationLogCommentProperties

The response of a call to AnnotationLogService_CreateAnnotationLog.

Field	Type	Label	Description
annotation_log	AnnotationLogSearchResult

The request for a call to AnnotationLogService_DeleteAnnotationLog to delete an annotation log.

Field	Type	Label	Description
annotation_id	string		The ID of the parent annotation associated with the annotation log to be deleted.
annotation_log_id	string		ID of the annotation log to be deleted.

The Response of a call to AnnotationLogService_DeleteAnnotationLog.

The request for a call to AnnotationLogService_ListAnnotationLogs to retrieve annotation logs.

Field	Type	Description
annotation_id	string	The ID of the parent annotation associated with the annotation logs.
page_size	uint32	The maximum number of annotation logs to return. The service may return fewer than this value. If unspecified, at most 50 annotation logs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
page_token	string	A page token, received from a previous `ListAnnotationLogs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAnnotationLogs` must match the call that provided the page token.
filter	string	A Common Expression Language (CEL) filter string. Available fields to filter by are `annotation_log_id`, `annotation_id`, `created_by_user_id`, `created_date`, `modified_date`, and `kind`. For further information about how to use CELs, please refer to this guide. For more information about the fields used for filtering, please refer to this definition. Optional.

The response of a call to AnnotationLogService_ListAnnotationLogs.

Field	Type	Label	Description
annotation_logs	AnnotationLogSearchResult	repeated
next_page_token	string

Name	Number	Description
ANNOTATION_COMMENT_BODY_ELEMENT_TYPE_UNSPECIFIED	0
ANNOTATION_COMMENT_BODY_ELEMENT_TYPE_TEXT	1
ANNOTATION_COMMENT_BODY_ELEMENT_TYPE_USER_MENTION	2

Name	Number	Description
ANNOTATION_LOG_KIND_UNSPECIFIED	0
ANNOTATION_LOG_KIND_COMMENT	1
ANNOTATION_LOG_KIND_STATE_UPDATE	2
ANNOTATION_LOG_KIND_ASSIGNED	3

Name	Number	Description
ANNOTATION_LOG_STATE_UNSPECIFIED	0
ANNOTATION_LOG_STATE_CREATED	1
ANNOTATION_LOG_STATE_OPEN	2
ANNOTATION_LOG_STATE_FLAGGED	3
ANNOTATION_LOG_STATE_RESOLVED	4

Method Name	Request Type	Response Type	Description
CreateAnnotationLog	CreateAnnotationLogRequest	CreateAnnotationLogResponse	Creates an annotation log on an annotation.
ListAnnotationLogs	ListAnnotationLogsRequest	ListAnnotationLogsResponse	Retrieves annotation logs using an optional filter.
DeleteAnnotationLog	DeleteAnnotationLogRequest	DeleteAnnotationLogResponse	Deletes an annotation log.