CommentThread

Représente un fil de discussion unique dans une présentation.

Représentation JSON
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
Champs
commentId

string

Identifiant unique du fil de discussion.

anchorId

string

ID de l'CommentAnchor de la présentation auquel ce fil de discussion est associé.

headPost

object (Post)

Premier post du fil de discussion.

replies[]

object (Post)

Réponses au post principal.

status

enum (Status)

Indique si le fil de discussion est ouvert ou résolu.

Texte cité de l'élément de page au moment de la création du commentaire. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
plainTextQuote

string

Texte cité de l'élément de page au moment de la création du commentaire, mis en forme en texte brut.

Fin des champs qui s'excluent mutuellement.

Publier

Représente un seul post dans un fil de commentaires.

Représentation JSON
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedPresentation": boolean,
  "fromCopiedPresentation": boolean,
  "assigneeEmail": string,
  "commentAction": enum (CommentActionType)
}
Champs
postId

string

Uniquement en sortie. Identifiant unique du post.

content

string

Contenu du post.

Obligatoire et non vide si commentAction n'est pas RESOLVE ni REOPEN.

Ce contenu textuel sera traité de la même manière que les commentaires créés dans l'éditeur Slides. Il aura des comportements similaires pour la mise en forme, les notifications, etc.

Ne doit pas dépasser 2 048 unités de code UTF-8.

contentHtml

string

Uniquement en sortie. Contenu du post au format HTML.

author

object (PostAuthor)

Uniquement en sortie. Utilisateur qui a créé le post.

createTime

string (Timestamp format)

Uniquement en sortie. Heure de création du post.

updateTime

string (Timestamp format)

Uniquement en sortie. Date et heure de la dernière mise à jour du post.

deleted

boolean

Uniquement en sortie. Indique si le post a été supprimé. Si true, les champs content et author seront vides.

fromImportedPresentation

boolean

Uniquement en sortie. Indique si le post provient d'une présentation importée. Ce champ ne peut pas être défini directement par les appelants.

fromCopiedPresentation

boolean

Uniquement en sortie. Indique si le post provient d'une présentation copiée. Ce champ ne peut pas être défini directement par les appelants.

assigneeEmail

string

Facultatif. Adresse e-mail de l'utilisateur qui est nouvellement attribué au fil de discussion dans ce post.

Renvoie une erreur 400 (requête incorrecte) si :

  • Le thread parent est un CommentThread dont le headPost n'a pas d'attributaire.

  • commentAction est spécifié comme RESOLVE ou REOPEN.

  • assigneeEmail dépasse 2 048 unités de code UTF-8.

commentAction

enum (CommentActionType)

Action effectuée lors de la création du post.

PostAuthor

Représente un utilisateur qui a créé un post de commentaire.

Représentation JSON
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
Champs
displayName

string

Nom à afficher de l'utilisateur. Peut être absent si l'auteur est anonyme.

me

boolean

Indique si l'utilisateur est l'utilisateur authentifié qui effectue la demande.

anonymous

boolean

Indique si l'utilisateur est anonyme.

user

string

Nom de ressource de l'utilisateur auteur du post, qui peut également être utilisé pour identifier l'utilisateur dans l'API Google People. Format : users/{user}. Ce champ ne sera pas renseigné si le champ "Anonyme" est défini sur true ou si le post provient d'une présentation importée.

CommentActionType

Action effectuée avec cette réponse à un fil de commentaires.

Enums
COMMENT_ACTION_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
NO_COMMENT_ACTION_CHANGE Aucune modification d'action dans ce post.
RESOLVE Ce post clôture le fil de discussion.
REOPEN Ce post rouvre le fil de discussion.

État

Options d'état du fil de discussion.

Enums
STATUS_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
OPEN Le fil de commentaires est ouvert.
RESOLVED Le fil de commentaires est résolu.