CommentThread

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "plainTextQuote": string
  // End of mutually exclusive fields.
}
Champs
commentId

string

Identifiant unique du fil de commentaires.

anchorId

string

Identifiant de l'élément CommentAnchor de la présentation auquel ce fil est associé.

headPost

object (Post)

Premier message du fil.

replies[]

object (Post)

Réponses au message principal.

status

enum (Status)

Indique si le fil est ouvert ou résolu.

Texte cité de l'élément de la page lors de la création du commentaire. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul de ces champs sera défini dans une réponse :
plainTextQuote

string

Texte cité de l'élément de la page lors de la création du commentaire, au format texte brut.

Fin des champs mutuellement exclusifs.

Publier

Représente un message unique 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 message.

content

string

Contenu du message.

Doit être non vide si commentAction n'est pas RESOLVE ou 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 en termes de mise en forme, de notifications, etc.

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

contentHtml

string

Uniquement en sortie. Contenu du message au format HTML.

author

object (PostAuthor)

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

createTime

string (Timestamp format)

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

updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour du message.

deleted

boolean

Uniquement en sortie. Indique si le message est supprimé. Si la valeur est true, les champs content et author sont vides.

fromImportedPresentation

boolean

Uniquement en sortie. Indique si le message 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 message 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 dans le cadre de ce message.

Renvoie une erreur 400 Bad Request si :

  • Le fil parent est un CommentThread dont le headPost n'a pas de destinataire.

  • 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 message.

PostAuthor

Représente un utilisateur qui a créé un message 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 requête.

anonymous

boolean

Indique si l'utilisateur est anonyme.

user

string

Nom de ressource de l'utilisateur auteur du message, qui peut également être utilisé pour identifier l'utilisateur dans l'API Google People. Format: users/{user}. Ne sera pas renseigné si le champ anonyme est true ou si le message 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 de l'action dans ce message.
RESOLVE Ce message résout le fil.
REOPEN Ce message rouvre le fil.

État

Options d'état du fil de commentaires.

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.