replies

Creates, updates, deletes, gets or lists a replies resource.

Overview

Name	replies
Type	Resource
Id	googleworkspace.drivev3.replies

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Output only. The ID of the reply.
action	string	The action the reply performed to the parent comment. The supported values are: * resolve * reopen
assigneeEmailAddress	string	Output only. The email address of the user assigned to this comment. If no user is assigned, the field is unset.
author	object	Information about a Drive user. (id: User)
content	string	The plain text content of the reply. This field is used for setting the content, while htmlContent should be displayed. This field is required by the create method if no action value is specified.
createdTime	string (date-time)	The time at which the reply was created (RFC 3339 date-time).
deleted	boolean	Output only. Whether the reply has been deleted. A deleted reply has no content.
htmlContent	string	Output only. The content of the reply with HTML formatting.
kind	string	Output only. Identifies what kind of resource this is. Value: the fixed string "drive#reply". (default: drive#reply)
mentionedEmailAddresses	array	Output only. A list of email addresses for users mentioned in this comment. If no users are mentioned, the list is empty.
modifiedTime	string (date-time)	The last time the reply was modified (RFC 3339 date-time).

list

Name	Datatype	Description
id	string	Output only. The ID of the reply.
action	string	The action the reply performed to the parent comment. The supported values are: * resolve * reopen
assigneeEmailAddress	string	Output only. The email address of the user assigned to this comment. If no user is assigned, the field is unset.
author	object	Information about a Drive user. (id: User)
content	string	The plain text content of the reply. This field is used for setting the content, while htmlContent should be displayed. This field is required by the create method if no action value is specified.
createdTime	string (date-time)	The time at which the reply was created (RFC 3339 date-time).
deleted	boolean	Output only. Whether the reply has been deleted. A deleted reply has no content.
htmlContent	string	Output only. The content of the reply with HTML formatting.
kind	string	Output only. Identifies what kind of resource this is. Value: the fixed string "drive#reply". (default: drive#reply)
mentionedEmailAddresses	array	Output only. A list of email addresses for users mentioned in this comment. If no users are mentioned, the list is empty.
modifiedTime	string (date-time)	The last time the reply was modified (RFC 3339 date-time).

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	fileId, commentId, replyId	includeDeleted	Gets a reply by ID. For more information, see Manage comments and replies.
list	select	fileId, commentId	pageToken, includeDeleted, pageSize	Lists a comment's replies. For more information, see Manage comments and replies.
create	insert	fileId, commentId		Creates a reply to a comment. For more information, see Manage comments and replies.
update	update	fileId, commentId, replyId		Updates a reply with patch semantics. For more information, see Manage comments and replies.
delete	delete	fileId, commentId, replyId		Deletes a reply. For more information, see Manage comments and replies.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
commentId	string
fileId	string
replyId	string
includeDeleted	boolean
pageSize	integer (int32)
pageToken	string

SELECT examples

get

Gets a reply by ID. For more information, see Manage comments and replies.

SELECT
id,
action,
assigneeEmailAddress,
author,
content,
createdTime,
deleted,
htmlContent,
kind,
mentionedEmailAddresses,
modifiedTime
FROM googleworkspace.drivev3.replies
WHERE fileId = '{{ fileId }}' -- required
AND commentId = '{{ commentId }}' -- required
AND replyId = '{{ replyId }}' -- required
AND includeDeleted = '{{ includeDeleted }}'
;

list

Lists a comment's replies. For more information, see Manage comments and replies.

SELECT
id,
action,
assigneeEmailAddress,
author,
content,
createdTime,
deleted,
htmlContent,
kind,
mentionedEmailAddresses,
modifiedTime
FROM googleworkspace.drivev3.replies
WHERE fileId = '{{ fileId }}' -- required
AND commentId = '{{ commentId }}' -- required
AND pageToken = '{{ pageToken }}'
AND includeDeleted = '{{ includeDeleted }}'
AND pageSize = '{{ pageSize }}'
;

INSERT examples

create

Creates a reply to a comment. For more information, see Manage comments and replies.

INSERT INTO googleworkspace.drivev3.replies (
data__modifiedTime,
data__htmlContent,
data__createdTime,
data__content,
data__author,
data__action,
data__id,
data__kind,
data__deleted,
fileId,
commentId
)
SELECT 
'{{ modifiedTime }}',
'{{ htmlContent }}',
'{{ createdTime }}',
'{{ content }}',
'{{ author }}',
'{{ action }}',
'{{ id }}',
'{{ kind }}',
{{ deleted }},
'{{ fileId }}',
'{{ commentId }}'
RETURNING
id,
action,
assigneeEmailAddress,
author,
content,
createdTime,
deleted,
htmlContent,
kind,
mentionedEmailAddresses,
modifiedTime
;

Manifest

# Description fields are for documentation purposes
- name: replies
props:
  - name: fileId
    value: "{{ fileId }}"
    description: Required parameter for the replies resource.
  - name: commentId
    value: "{{ commentId }}"
    description: Required parameter for the replies resource.
  - name: modifiedTime
    value: "{{ modifiedTime }}"
    description: |
      The last time the reply was modified (RFC 3339 date-time).
  - name: htmlContent
    value: "{{ htmlContent }}"
    description: |
      Output only. The content of the reply with HTML formatting.
  - name: createdTime
    value: "{{ createdTime }}"
    description: |
      The time at which the reply was created (RFC 3339 date-time).
  - name: content
    value: "{{ content }}"
    description: |
      The plain text content of the reply. This field is used for setting the content, while `htmlContent` should be displayed. This field is required by the `create` method if no `action` value is specified.
  - name: author
    description: |
      Information about a Drive user.
    value:
      emailAddress: "{{ emailAddress }}"
      permissionId: "{{ permissionId }}"
      photoLink: "{{ photoLink }}"
      displayName: "{{ displayName }}"
      kind: "{{ kind }}"
      me: {{ me }}
  - name: action
    value: "{{ action }}"
    description: |
      The action the reply performed to the parent comment. The supported values are: * `resolve` * `reopen`
  - name: id
    value: "{{ id }}"
    description: |
      Output only. The ID of the reply.
  - name: kind
    value: "{{ kind }}"
    description: |
      Output only. Identifies what kind of resource this is. Value: the fixed string `"drive#reply"`.
    default: drive#reply
  - name: deleted
    value: {{ deleted }}
    description: |
      Output only. Whether the reply has been deleted. A deleted reply has no content.

UPDATE examples

update

Updates a reply with patch semantics. For more information, see Manage comments and replies.

UPDATE googleworkspace.drivev3.replies
SET 
data__modifiedTime = '{{ modifiedTime }}',
data__htmlContent = '{{ htmlContent }}',
data__createdTime = '{{ createdTime }}',
data__content = '{{ content }}',
data__author = '{{ author }}',
data__action = '{{ action }}',
data__id = '{{ id }}',
data__kind = '{{ kind }}',
data__deleted = {{ deleted }}
WHERE 
fileId = '{{ fileId }}' --required
AND commentId = '{{ commentId }}' --required
AND replyId = '{{ replyId }}' --required
RETURNING
id,
action,
assigneeEmailAddress,
author,
content,
createdTime,
deleted,
htmlContent,
kind,
mentionedEmailAddresses,
modifiedTime;

DELETE examples

delete

Deletes a reply. For more information, see Manage comments and replies.

DELETE FROM googleworkspace.drivev3.replies
WHERE fileId = '{{ fileId }}' --required
AND commentId = '{{ commentId }}' --required
AND replyId = '{{ replyId }}' --required
;