REST Resource: spaces.messages

Recurso: message

Uma mensagem no Google Chat.

Representação JSON
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "deletionMetadata": {
    object (DeletionMetadata)
  }
}
Campos
name

string

Nome do recurso no formato spaces/*/messages/*.

Exemplo: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

sender

object (User)

Apenas saída. O usuário que criou a mensagem. Se o app Chat for autenticado como usuário, a saída vai preencher o usuário name e type.

createTime

string (Timestamp format)

Apenas saída. A hora em que a mensagem foi criada no Google Chat.

lastUpdateTime

string (Timestamp format)

Apenas saída. A hora em que a mensagem foi editada pela última vez por um usuário. Se a mensagem nunca tiver sido editada, esse campo estará vazio.

deleteTime

string (Timestamp format)

Apenas saída. A hora em que a mensagem foi excluída no Google Chat. Se a mensagem nunca for excluída, esse campo estará vazio.

text

string

Corpo de texto simples da mensagem. O primeiro link para uma imagem, vídeo, página da Web ou outro item que pode ser visualizado gera um ícone de visualização.

cards[]
(deprecated)

object (Card)

Obsoleto: use cardsV2.

Cards ricos, formatados e interativos que você pode usar para exibir elementos da IU, como textos formatados, botões e imagens clicáveis. Os cartões normalmente são exibidos abaixo do corpo de texto simples da mensagem. cards e cardsV2 podem ter um tamanho máximo de 32 KB.

cardsV2[]

object (CardWithId)

Cards interativos e bem formatados que exibem elementos de IU e widgets editáveis, como:

  • Texto formatado
  • Botões
  • Imagens clicáveis
  • Caixas de seleção
  • Botões de opção
  • Widgets de entrada.

Os cards costumam aparecer abaixo do corpo de uma mensagem do Chat, mas podem aparecer em outras situações, como caixas de diálogo. Cada cartão pode ter um tamanho máximo de 32 KB.

O cardId é um identificador exclusivo entre os cards na mesma mensagem e para identificar valores de entrada do usuário.

Os widgets compatíveis no momento incluem:

  • TextParagraph
  • DecoratedText
  • Image
  • ButtonList
  • Divider
  • TextInput
  • SelectionInput
  • Grid
annotations[]

object (Annotation)

Apenas saída. Anotações associadas ao text nesta mensagem.

thread

object (Thread)

A sequência à qual a mensagem pertence. Para ver um exemplo de uso, consulte Iniciar ou responder a uma conversa.

space

object (Space)

Se o app Chat tiver a autenticação como usuário, a saída preencherá o espaço name.

fallbackText

string

Uma descrição em texto simples dos cartões da mensagem, usada quando os cartões não podem ser exibidos. Por exemplo, notificações para dispositivos móveis.

actionResponse

object (ActionResponse)

Apenas entrada. Parâmetros que um app de chat pode usar para configurar como a resposta é postada.

argumentText

string

Apenas saída. Corpo em texto simples da mensagem com todas as menções do app Chat removidas.

slashCommand

object (SlashCommand)

Apenas saída. Informações do comando de barra, se aplicável.

attachment[]

object (Attachment)

Anexo enviado pelo usuário.

matchedUrl

object (MatchedUrl)

Apenas saída. Um URL em spaces.messages.text que corresponde a um padrão de visualização de link. Para mais informações, consulte Links de visualização.

threadReply

boolean

Apenas saída. Quando true, a mensagem é uma resposta em uma conversa. Quando false, a mensagem fica visível na conversa de nível superior do espaço como a primeira mensagem de uma conversa ou sem mensagens.

Se o espaço não for compatível com a resposta em conversas, este campo será sempre false.

clientAssignedMessageId

string

Um nome personalizado para uma mensagem do Chat atribuída na criação. Precisa começar com client- e conter apenas letras minúsculas, números e hifens com até 63 caracteres. Especifique este campo para receber, atualizar ou excluir a mensagem com o valor especificado. A atribuição de um nome personalizado permite que um app de chat retorne a mensagem sem salvar a mensagem name do corpo da resposta retornada ao criá-la. A atribuição de um nome personalizado não substitui o campo name gerado, o nome do recurso da mensagem. Em vez disso, ele define o nome personalizado como o campo clientAssignedMessageId, que pode ser referenciado ao processar operações posteriores, como atualizar ou excluir a mensagem. Para ver um exemplo de uso, consulte Nomear uma mensagem criada.

emojiReactionSummaries[]

object (EmojiReactionSummary)

Apenas saída. A lista de resumos de reação com emoji na mensagem.

deletionMetadata

object (DeletionMetadata)

Apenas saída. Informações sobre uma mensagem excluída. Uma mensagem é excluída quando deleteTime é definido.

ID do cartão

Widgets para apps de chat especificar.

Representação JSON
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Campos
cardId

string

Obrigatório para cardsV2 mensagens. Identificador específico do app de chat para este widget. No escopo de uma mensagem.

card

object (Card)

Os cards são compatíveis com um layout definido, elementos interativos de IU, como botões, e rich media, como imagens. Use este cartão para apresentar informações detalhadas, coletar informações dos usuários e orientá-los a dar o próximo passo.

Nota

Anotações associadas ao corpo da mensagem em texto simples.

Exemplo de corpo de mensagem de texto simples:

Hello @FooBot how are you!"

Os metadados de anotações correspondentes:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
Representação JSON
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campos
type

enum (AnnotationType)

O tipo dessa anotação.

length

integer

Comprimento da substring no corpo da mensagem de texto simples a que esta anotação corresponde.

startIndex

integer

Índice inicial (base 0, inclusive) no corpo da mensagem em texto simples a que esta anotação corresponde.

Campo de união metadata. Metadados adicionais sobre a anotação. metadata pode ser apenas de um dos tipos a seguir:
userMention

object (UserMentionMetadata)

Os metadados da menção do usuário.

slashCommand

object (SlashCommandMetadata)

Os metadados de um comando de barra.

AnnotationType

Tipo da anotação.

Enums
ANNOTATION_TYPE_UNSPECIFIED Valor padrão do enum. Não use.
USER_MENTION Um usuário é mencionado.
SLASH_COMMAND Um comando de barra é invocado.

Metadados de referência do usuário

Metadados de anotação para menções de usuários (@).

Representação JSON
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Campos
user

object (User)

O usuário mencionou.

type

enum (Type)

O tipo de referência do usuário.

Tipo

Enums
TYPE_UNSPECIFIED Valor padrão do enum. Não use.
ADD Adicionar usuário ao espaço.
MENTION Mencione o usuário no espaço.

SlashCommandMetadata

Metadados de anotação para comandos de barra (/).

Representação JSON
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Campos
bot

object (User)

O app Chat cujo comando foi invocado

type

enum (Type)

O tipo de comando de barra.

commandName

string

O nome do comando de barra invocado.

commandId

string (int64 format)

O ID do comando de barra invocado.

triggersDialog

boolean

Indica se o comando de barra é para uma caixa de diálogo.

Tipo

Enums
TYPE_UNSPECIFIED Valor padrão do enum. Não use.
ADD Adicione o app Chat ao espaço.
INVOKE Invoque o comando de barra no espaço.

Conversa

Uma conversa no Google Chat.

Representação JSON
{
  "name": string,
  "threadKey": string
}
Campos
name

string

Nome do recurso da linha de execução.

Exemplo: spaces/{space}/threads/{thread}

threadKey

string

Opcional. Identificador de thread opaco. Para iniciar ou adicionar a uma linha de execução, crie uma mensagem e especifique um threadKey ou o thread.name. Para ver um exemplo de uso, consulte Iniciar ou responder a uma conversa.

Para outras solicitações, esse é um campo somente de saída.

Resposta de ação

Parâmetros que um app de chat pode usar para configurar como a resposta é postada.

Representação JSON
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  }
}
Campos
type

enum (ResponseType)

Apenas entrada. É o tipo de resposta do app Chat.

url

string

Apenas entrada. URL para os usuários se autenticarem ou configurarem. Apenas para os tipos de resposta REQUEST_CONFIG.

dialogAction

object (DialogAction)

Apenas entrada. Uma resposta a um evento relacionado a uma caixa de diálogo. Precisa estar acompanhado por ResponseType.Dialog.

Tipo de resposta

É o tipo de resposta do app Chat.

Enums
TYPE_UNSPECIFIED Tipo padrão que é tratado como NEW_MESSAGE.
NEW_MESSAGE Postar como uma nova mensagem no tópico.
UPDATE_MESSAGE Atualize a mensagem do app Chat. Isso só é permitido em um evento CARD_CLICKED em que o tipo de remetente da mensagem é BOT.
UPDATE_USER_MESSAGE_CARDS Atualize os cards na mensagem de um usuário. Isso só é permitido como uma resposta a um evento MESSAGE com um URL correspondente ou um evento CARD_CLICKED em que o tipo de remetente da mensagem é HUMAN. O texto é ignorado.
REQUEST_CONFIG Solicite ao usuário autenticação ou configuração adicional.
DIALOG Apresenta uma caixa de diálogo.

DialogAction

Contém uma caixa de diálogo e um código de status da solicitação.

Representação JSON
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Campos
actionStatus

object (ActionStatus)

Apenas entrada. Status de uma solicitação para invocar ou enviar uma caixa de diálogo. Exibe um status e uma mensagem aos usuários, se necessário. Por exemplo, em caso de erro ou sucesso.

Campo de união action.

action pode ser apenas de um dos tipos a seguir:

dialog

object (Dialog)

Apenas entrada. Dialog para a solicitação.

Caixa de diálogo

Wrapper no corpo do cartão da caixa de diálogo.

Representação JSON
{
  "body": {
    object (Card)
  }
}
Campos
body

object (Card)

Apenas entrada. Corpo da caixa de diálogo, que é renderizado em um modal. Os apps do Google Chat não são compatíveis com as seguintes entidades de cartão: DateTimePicker, OnChangeAction.

Status da ação

Representa o status de uma solicitação para invocar ou enviar uma caixa de diálogo.

Representação JSON
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Campos
statusCode

enum (Code)

O código de status.

userFacingMessage

string

A mensagem a ser enviada aos usuários sobre o status da solicitação deles. Se não for definido, uma mensagem genérica com base no statusCode será enviada.

Código

Códigos de erros canônicos para APIs gRPC.

Às vezes, vários códigos de erros podem ser aplicados. Os serviços retornam o código do erro mais específico aplicável. Por exemplo, dê preferência a OUT_OF_RANGE em vez de FAILED_PRECONDITION, se ambos os códigos se aplicarem. Da mesma maneira, dê preferência a NOT_FOUND ou ALREADY_EXISTS em vez de FAILED_PRECONDITION.

Enums
OK

Não é um erro. Retornado quando bem-sucedido.

Mapeamento HTTP: 200 OK

CANCELLED

A operação foi cancelada, geralmente pelo chamador

Mapeamento HTTP: 499 Solicitação fechada pelo cliente

UNKNOWN

Erro desconhecido. Por exemplo, esse erro pode ser retornado quando um valor Status recebido de outro espaço de endereço pertence a um espaço de erro desconhecido nesse espaço de endereço. Além disso, os erros gerados por APIs que não retornam informações de erro suficientes podem ser convertidos neste erro.

Mapeamento HTTP: 500 Erro interno do servidor

INVALID_ARGUMENT

O cliente especificou um argumento inválido. Observe que isso é diferente de FAILED_PRECONDITION. INVALID_ARGUMENT indica argumentos problemáticos, independentemente do estado do sistema. Por exemplo, um nome de arquivo incorreto.

Mapeamento HTTP: 400 Solicitação inválida

DEADLINE_EXCEEDED

O prazo expirou antes do término da operação. Para operações que alteram o estado do sistema, este erro pode ser retornado mesmo que a operação tenha sido concluída com sucesso. Por exemplo, uma resposta bem-sucedida de um servidor pode ter atrasado tempo suficiente para que o prazo expirasse.

Mapeamento HTTP: 504 Tempo limite do gateway

NOT_FOUND

Alguma entidade solicitada não foi encontrada. Por exemplo, arquivo ou diretório.

Observação para desenvolvedores de servidor: se uma solicitação for negada para uma classe inteira de usuários, como a implementação gradual de recursos ou a lista de permissões não documentada de permissões, NOT_FOUND poderá ser usado. Se uma solicitação for negada para alguns usuários de uma classe, como o controle de acesso baseado em usuário, PERMISSION_DENIED precisará ser usado.

Mapeamento HTTP: 404 Não encontrado

ALREADY_EXISTS

A entidade que um cliente tentou criar já existe. Por exemplo, arquivo ou diretório.

Mapeamento HTTP: 409 Conflito

PERMISSION_DENIED

O autor da chamada não tem permissão para executar a operação especificada. PERMISSION_DENIED não pode ser usado para rejeições causadas pelo esgotamento de algum recurso. Em vez dele, use RESOURCE_EXHAUSTED para esses erros. PERMISSION_DENIED não poderá ser usado se o autor da chamada não for identificado. Em vez dele, use UNAUTHENTICATED para esses erros. Esse código do erro não indica que a solicitação seja válida nem que a entidade solicitada exista ou satisfaça outras condições prévias.

Mapeamento HTTP: 403 Proibido

UNAUTHENTICATED

A solicitação não tem credenciais válidas de autenticação para a operação.

Mapeamento HTTP: 401 Não autorizado

RESOURCE_EXHAUSTED

Houve o esgotamento de algum recurso, como uma cota por usuário. Também é possível que todo sistema de arquivos esteja sem espaço.

Mapeamento HTTP: 429 Há muitas solicitações

FAILED_PRECONDITION

A operação foi rejeitada porque o estado do sistema não é o necessário para a execução dela. Por exemplo, o diretório a ser excluído não está vazio, uma operação "rmdir" foi aplicada a um elemento que não é um diretório etc.

Os implementadores de serviços podem usar as diretrizes a seguir para decidir entre FAILED_PRECONDITION, ABORTED e UNAVAILABLE: (a) usar UNAVAILABLE se o cliente puder repetir apenas a chamada com falha. (b) Use ABORTED se o cliente tentar novamente em um nível superior. Por exemplo, quando um teste e um conjunto especificados pelo cliente falham, indicando que o cliente deve reiniciar uma sequência de leitura/modificação/gravação. (c) Use FAILED_PRECONDITION se o cliente não tentar novamente até que o estado do sistema seja explicitamente corrigido. Por exemplo, se um "rmdir" falhar porque o diretório não está vazio, FAILED_PRECONDITION será retornado, porque o cliente não poderá tentar novamente, a menos que os arquivos sejam excluídos do diretório.

Mapeamento HTTP: 400 Solicitação inválida

ABORTED

A operação foi cancelada. Isso ocorre normalmente devido a um problema de simultaneidade, como falha na verificação do sequenciador ou cancelamento da transação.

Consulte as diretrizes acima para decidir entre FAILED_PRECONDITION, ABORTED e UNAVAILABLE.

Mapeamento HTTP: 409 Conflito

OUT_OF_RANGE

Houve uma tentativa da operação depois do intervalo válido. Por exemplo, busca ou leitura após o fim do arquivo.

Diferentemente de INVALID_ARGUMENT, este erro indica um problema que poderá ser corrigido se o estado do sistema mudar. Por exemplo, um sistema de arquivos de 32 bits gerará INVALID_ARGUMENT se for solicitado a ler em um deslocamento fora do intervalo [0,2^32-1], mas gerará OUT_OF_RANGE se for solicitado a ler um deslocamento que ultrapasse o tamanho do arquivo atual.

Há alguma sobreposição entre FAILED_PRECONDITION e OUT_OF_RANGE. Recomendamos o uso de OUT_OF_RANGE (o erro mais específico) quando aplicável para que os autores da chamada que estão iterando por meio de um espaço possam procurar facilmente um erro OUT_OF_RANGE para detectar quando terminarem.

Mapeamento HTTP: 400 Solicitação inválida

UNIMPLEMENTED

A operação não foi implementada ou não é compatível nem está ativada neste serviço.

Mapeamento HTTP: 501 Não implementado

INTERNAL

Erros internos. Significa que algumas invariantes esperadas pelo sistema subjacente foram corrompidas. Este código do erro é reservado para erros graves.

Mapeamento HTTP: 500 Erro interno do servidor

UNAVAILABLE

Atualmente, o serviço não está disponível. Muito provavelmente, trata-se de uma condição temporária, que pode ser corrigida ao tentar novamente com uma retirada. Nem sempre é seguro repetir operações não idempotentes.

Consulte as diretrizes acima para decidir entre FAILED_PRECONDITION, ABORTED e UNAVAILABLE.

Mapeamento HTTP: 503 Serviço indisponível

DATA_LOSS

Perda ou corrupção irrecuperável de dados.

Mapeamento HTTP: 500 Erro interno do servidor

SlashCommand

Um comando de barra no Google Chat.

Representação JSON
{
  "commandId": string
}
Campos
commandId

string (int64 format)

O ID do comando de barra invocado.

URL correspondente

Um URL correspondente em uma mensagem do Chat. Os apps de chat podem visualizar os URLs correspondentes. Saiba mais em Visualizar links.

Representação JSON
{
  "url": string
}
Campos
url

string

Apenas saída. O URL correspondente.

ResumodeEmojis

O número de pessoas que reagiram a uma mensagem com um emoji específico.

Representação JSON
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Campos
emoji

object (Emoji)

Emojis associados às reações.

reactionCount

integer

O número total de reações usando os emojis associados.

Metadados de exclusão

Informações sobre uma mensagem excluída. Uma mensagem é excluída quando deleteTime é definido.

Representação JSON
{
  "deletionType": enum (DeletionType)
}
Campos
deletionType

enum (DeletionType)

Indica quem excluiu a mensagem.

Tipo de exclusão

Quem excluiu a mensagem e como ela foi excluída.

Enums
DELETION_TYPE_UNSPECIFIED Esse valor não é usado.
CREATOR O usuário excluiu a própria mensagem.
SPACE_OWNER O proprietário do espaço excluiu a mensagem.
ADMIN Um administrador do Google Workspace excluiu a mensagem.
APP_MESSAGE_EXPIRY Um app de chat excluiu a própria mensagem quando expirou.
CREATOR_VIA_APP Um app de chat excluiu a mensagem em nome do usuário.
SPACE_OWNER_VIA_APP Um app Chat excluiu a mensagem em nome do proprietário do espaço.

Métodos

create

Cria uma mensagem.

delete

Exclui uma mensagem.

get

Retorna detalhes sobre uma mensagem.

list

Lista as mensagens em um espaço de que o autor da chamada é participante, inclusive as mensagens de participantes e espaços bloqueados.

patch

Atualiza uma mensagem.

update

Atualiza uma mensagem.