REST Resource: spaces.messages

Recurso: Message

Uma mensagem em um espaço do Google Chat.

Representação JSON 
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": 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)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
Campos
name

string

Identificador. Nome do recurso da mensagem.

Formato: spaces/{space}/messages/{message}

Em que {space} é o ID do espaço em que a mensagem foi postada e {message} é um ID atribuído pelo sistema à mensagem. Por exemplo, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Se você definir um ID personalizado ao criar uma mensagem, poderá usar esse ID para especificar a mensagem em uma solicitação. Para isso, substitua {message} pelo valor do campo clientAssignedMessageId. Por exemplo, spaces/AAAAAAAAAAA/messages/client-custom-name. Para mais detalhes, consulte Nomear uma mensagem.
sender

object (User)

Apenas saída. O usuário que criou a mensagem. Se o app do Chat autenticar como um usuário, a saída vai preencher os name e type do usuário.
createTime

string (Timestamp format)

Opcional. Imutável. Para espaços criados no Chat, a hora em que a mensagem foi criada. Esse campo é somente saída, exceto quando usado em espaços no modo de importação.

Para espaços no modo de importação, defina esse campo como o carimbo de data/hora histórico em que a mensagem foi criada na origem para preservar o horário de criação original.
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 foi editada, esse campo fica 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 vai ficar vazio.
text

string

Opcional. Corpo de texto simples da mensagem. O primeiro link para uma imagem, um vídeo ou uma página da Web gera um ícone de prévia. Você também pode @mencionar um usuário do Google Chat ou todos no espaço.

Para saber como criar mensagens de texto, consulte Enviar uma mensagem.
formattedText

string

Apenas saída. Contém a mensagem text com marcações adicionadas para comunicar a formatação. Esse campo pode não capturar toda a formatação visível na interface, mas inclui o seguinte:

  • Sintaxe de marcação para negrito, itálico, tachado, monoespaçado, bloco monoespaçado e lista com marcadores.

  • Menções de usuários usando o formato <users/{user}>.

  • Hiperlinks personalizados usando o formato <{url}|{rendered_text}>, em que a primeira string é o URL e a segunda é o texto renderizado. Por exemplo, <http://example.com|custom text>.

  • Emojis personalizados usando o formato :{emojiName}:, por exemplo, :smile:. Isso não se aplica a emojis Unicode, como U+1F600 para um emoji de rosto sorrindo.

Para mais informações, consulte Ver a formatação de texto enviada em uma mensagem.
cards[]
(deprecated)

object (Card)

Descontinuado: use cardsV2.

Cartões avançados, formatados e interativos que podem ser usados para mostrar elementos de interface, como textos formatados, botões e imagens clicáveis. Os cards normalmente aparecem abaixo do corpo de texto simples da mensagem. cards e cardsV2 podem ter um tamanho máximo de 32 KB.
cardsV2[]

object (CardWithId)

Opcional. Uma matriz de cards.

Somente os apps do Chat podem criar cards. Se o app de chat autenticar como um usuário, as mensagens não poderão conter cards.

Para saber como criar uma mensagem com cards, consulte Enviar uma mensagem.

Crie e visualize cards com o Card Builder.

Abrir o Criador de cards
annotations[]

object (Annotation)

Apenas saída. As anotações podem ser associadas ao corpo de texto simples da mensagem ou a chips que vinculam recursos do Google Workspace, como Documentos ou Planilhas Google, com startIndex e length de 0.
thread

object (Thread)

A conversa a que a mensagem pertence. Para ver um exemplo de uso, consulte Iniciar ou responder a uma conversa por mensagem.
space

object (Space)

Apenas saída. Se o app Chat autenticar como um usuário, a saída vai preencher apenas o name do espaço.
fallbackText

string

Opcional. Uma descrição em texto simples dos cards da mensagem, usada quando os cards reais não podem ser mostrados, por exemplo, em notificações para dispositivos móveis.
actionResponse

object (ActionResponse)

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

string

Apenas saída. Corpo de texto simples da mensagem com todas as menções ao app Chat removidas.
slashCommand

object (SlashCommand)

Apenas saída. Informações sobre o comando de barra, se aplicável.
attachment[]

object (Attachment)

Opcional. 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 de resposta. Quando false, a mensagem fica visível na conversa de nível superior do espaço como a primeira mensagem de uma conversa ou uma mensagem sem respostas agrupadas.

Se o espaço não aceitar respostas em conversas, esse campo será sempre false.
clientAssignedMessageId

string

Opcional. Um ID personalizado para a mensagem. É possível usar o campo para identificar, receber, excluir ou atualizar uma mensagem. Para definir um ID personalizado, especifique o campo messageId ao criar a mensagem. Para mais detalhes, consulte Nomear uma mensagem.
emojiReactionSummaries[]

object (EmojiReactionSummary)

Apenas saída. A lista de resumos de reações com emojis na mensagem.
privateMessageViewer

object (User)

Opcional. Imutável. Entrada para criar uma mensagem ou apenas saída. O usuário que pode ver a mensagem. Quando definido, a mensagem é particular e só fica visível para o usuário especificado e o app do Chat. Para incluir esse campo na sua solicitação, chame a API Chat usando a autenticação do app e omita o seguinte:

Para mais detalhes, consulte Enviar uma mensagem particular.
deletionMetadata

object (DeletionMetadata)

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

object (QuotedMessageMetadata)

Apenas saída. Informações sobre uma mensagem citada por um usuário do Google Chat em um espaço. Os usuários do Google Chat podem citar uma mensagem para responder a ela.
attachedGifs[]

object (AttachedGif)

Apenas saída. Imagens GIF anexadas à mensagem.
accessoryWidgets[]

object (AccessoryWidget)

Opcional. Um ou mais widgets interativos que aparecem na parte de baixo de uma mensagem. É possível adicionar widgets acessórios a mensagens que contêm texto, cards ou ambos. Não é compatível com mensagens que contêm caixas de diálogo. Para mais detalhes, consulte Adicionar widgets interativos na parte de baixo de uma mensagem.

Para criar uma mensagem com widgets de acessórios, é necessário fazer a autenticação do app.

CardWithId

Um card em uma mensagem do Google Chat.

Somente os apps do Chat podem criar cards. Se o app Chat autenticar como um usuário, a mensagem não poderá conter cards.

Crie e visualize cards com o Card Builder.

Abrir o Criador de cards

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

string

Obrigatório se a mensagem tiver vários cards. Um identificador exclusivo de um card em uma mensagem.
card

object (Card)

Um cartão. O tamanho máximo é de 32 KB.

Nota

Apenas saída. As anotações podem ser associadas ao corpo de texto simples da mensagem ou a chips que vinculam recursos do Google Workspace, como Documentos ou Planilhas Google, com startIndex e length de 0. Para adicionar formatação básica a uma mensagem de texto, consulte Formatar mensagens de texto.

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)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campos
type

enum (AnnotationType)

O tipo desta anotação.
length

integer

Comprimento da substring no corpo da mensagem de texto simples a que esta anotação corresponde. Se não estiver presente, indica um comprimento de 0.
startIndex

integer

Índice inicial (com base em zero, inclusive) no corpo da mensagem de texto simples a que essa 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 ao usuário.
slashCommand

object (SlashCommandMetadata)

Os metadados de um comando de barra.
customEmojiMetadata

object (CustomEmojiMetadata)

Os metadados de um emoji personalizado.

AnnotationType

Tipo da anotação.

Enums
ANNOTATION_TYPE_UNSPECIFIED Valor padrão para a enumeração. Não use.
USER_MENTION Um usuário é mencionado.
SLASH_COMMAND Um comando de barra é invocado.
CUSTOM_EMOJI Uma anotação de emoji personalizado.

UserMentionMetadata

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 mencionado.
type

enum (Type)

O tipo de menção ao usuário.

Tipo

Enums
TYPE_UNSPECIFIED Valor padrão para a enumeração. Não use.
ADD Adicione um usuário ao espaço.
MENTION Mencionar 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 para a enumeração. Não use.
ADD Adicione o app do Chat ao espaço.
INVOKE Chame o comando de barra no espaço.

RichLinkMetadata

Um link avançado para um recurso. Os links avançados podem ser associados ao corpo de texto simples da mensagem ou representar chips que se vinculam a recursos do Google Workspace, como Documentos ou Planilhas Google, com startIndex e length de 0.

Representação JSON 
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  },
  "meetSpaceLinkData": {
    object (MeetSpaceLinkData)
  },
  "calendarEventLinkData": {
    object (CalendarEventLinkData)
  }
  // End of list of possible types for union field data.
}
Campos
uri

string

O URI deste link.
Campo de união data. Dados do recurso vinculado. data pode ser apenas de um dos tipos a seguir:

RichLinkType

O tipo de link rich. Mais tipos podem ser adicionados no futuro.

Enums
DRIVE_FILE Um tipo de link rich do Google Drive.
CHAT_SPACE Um tipo de link rich do espaço do Chat. Por exemplo, um ícone inteligente de espaço.
MEET_SPACE Um tipo de link rich media de mensagem do Meet. Por exemplo, um ícone do Meet.
CALENDAR_EVENT Um tipo de link rich de mensagem do Google Agenda. Por exemplo, um ícone da Agenda.

DriveLinkData

Dados para links do Google Drive.

Representação JSON 
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Campos
driveDataRef

object (DriveDataRef)

Um DriveDataRef que faz referência a um arquivo do Google Drive.
mimeType

string

O tipo MIME do recurso vinculado do Google Drive.

ChatSpaceLinkData

Dados de links de espaços do Chat.

Representação JSON 
{
  "space": string,
  "thread": string,
  "message": string
}
Campos
space

string

O espaço do recurso vinculado do Chat.

Formato: spaces/{space}
thread

string

A conversa do recurso de espaço do Chat vinculado.

Formato: spaces/{space}/threads/{thread}
message

string

A mensagem do recurso de espaço do Chat vinculado.

Formato: spaces/{space}/messages/{message}

MeetSpaceLinkData

Dados para links de espaços do Meet.

Representação JSON 
{
  "meetingCode": string,
  "type": enum (Type),
  "huddleStatus": enum (HuddleStatus)
}
Campos
meetingCode

string

Código da reunião do espaço vinculado do Meet.
type

enum (Type)

Indica o tipo de espaço do Meet.
huddleStatus

enum (HuddleStatus)

Opcional. Apenas saída. Se a reunião for um encontro rápido, indica o status dele. Caso contrário, ele não será definido.

Tipo

O tipo de espaço do Meet.

Enums
TYPE_UNSPECIFIED Valor padrão para a enumeração. Não use.
MEETING O espaço do Meet é uma reunião.
HUDDLE O espaço do Meet é uma reunião rápida.

HuddleStatus

O status da conversa em grupo

Enums
HUDDLE_STATUS_UNSPECIFIED Valor padrão para a enumeração. Não use.
STARTED A reunião rápida começou.
ENDED A reunião rápida foi encerrada. Nesse caso, o URI e os identificadores do espaço do Meet não serão mais válidos.
MISSED A reunião rápida foi perdida. Nesse caso, o URI e os identificadores do espaço do Meet não serão mais válidos.

CalendarEventLinkData

Dados de links de eventos do Google Agenda.

Representação JSON 
{
  "calendarId": string,
  "eventId": string
}
Campos
calendarId

string

O identificador da Agenda vinculada.
eventId

string

O identificador do evento do evento vinculado da Agenda.

CustomEmojiMetadata

Metadados de anotação para emojis personalizados.

Representação JSON 
{
  "customEmoji": {
    object (CustomEmoji)
  }
}
Campos
customEmoji

object (CustomEmoji)

O emoji personalizado.

Conversa

Uma conversa em um espaço do Google Chat. Para ver um exemplo de uso, consulte Iniciar ou responder a uma conversa por mensagem.

Se você especificar uma conversa ao criar uma mensagem, poderá definir o campo messageReplyOption para determinar o que acontece se nenhuma conversa correspondente for encontrada.

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

string

Identificador. Nome do recurso da conversa.

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

string

Opcional. Entrada para criar ou atualizar uma conversa. Caso contrário, apenas saída. ID da conversa. Aceita até 4.000 caracteres.

Esse ID é exclusivo do app Chat que o define. Por exemplo, se vários apps de chat criarem uma mensagem usando a mesma chave de conversa, as mensagens serão postadas em conversas diferentes. Para responder em uma conversa criada por uma pessoa ou outro app de chat, especifique o campo name da conversa.

ActionResponse

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)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Campos
type

enum (ResponseType)

Somente entrada. O tipo de resposta do app Chat.
url

string

Somente entrada. URL para os usuários autenticarem ou configurarem. (Somente para tipos de resposta REQUEST_CONFIG.)
dialogAction

object (DialogAction)

Somente entrada. Uma resposta a um evento de interação relacionado a uma caixa de diálogo. Precisa ser acompanhado de ResponseType.Dialog.
updatedWidget

object (UpdatedWidget)

Somente entrada. A resposta do widget atualizado.

ResponseType

O tipo de resposta do app Chat.

Enums
TYPE_UNSPECIFIED Tipo padrão processado 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 Atualiza os cards em uma mensagem de um usuário. Isso só é permitido como resposta a um evento MESSAGE com um URL correspondente ou a um evento CARD_CLICKED em que o tipo de remetente da mensagem é HUMAN. O texto é ignorado.
REQUEST_CONFIG Pedir ao usuário, de forma privada, autenticação ou configuração adicional.
DIALOG Apresenta uma caixa de diálogo.
UPDATE_WIDGET Consulta de opções de preenchimento automático de texto do widget.

DialogAction

Contém um 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)

Somente entrada. Status de uma solicitação para invocar ou enviar um diálogo. Mostra um status e uma mensagem aos usuários, se necessário. Por exemplo, em caso de erro ou sucesso.
Campo de união action. Ação a ser realizada. action pode ser apenas de um dos tipos a seguir:
dialog

object (Dialog)

Somente entrada. Dialog para a solicitação.

Caixa de diálogo

Wrapper ao redor do corpo do card da caixa de diálogo.

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

object (Card)

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

ActionStatus

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. 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 precisar tentar novamente em um nível mais alto. Por exemplo, quando um teste e um conjunto especificado pelo cliente falha, indicando que o cliente precisa 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 houver falha em um "rmdir" porque o diretório não está vazio, FAILED_PRECONDITION será retornado, porque o cliente não precisa 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 usar 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 a fim de detectar quando tiverem concluído.

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

UpdatedWidget

Para widgets selectionInput, retorna sugestões de preenchimento automático para um menu de seleção múltipla.

Representação JSON 
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
Campos
widget

string

O ID do widget atualizado. O ID precisa corresponder ao do widget que acionou a solicitação de atualização.
Campo de união updated_widget. O widget foi atualizado em resposta a uma ação do usuário. updated_widget pode ser apenas de um dos tipos a seguir:
suggestions

object (SelectionItems)

Lista de resultados de preenchimento automático do widget

SelectionItems

Lista de resultados de preenchimento automático do widget.

Representação JSON 
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Campos
items[]

object (SelectionItem)

Uma matriz de objetos SelectionItem.

SlashCommand

Metadados sobre um comando de barra no Google Chat.

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

string (int64 format)

O ID do comando de barra.

MatchedUrl

Uma URL correspondente em uma mensagem do Chat. Os apps de chat podem visualizar URLs correspondentes. Para mais informações, consulte Visualizar links.

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

string

Apenas saída. O URL que foi correspondido.

EmojiReactionSummary

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)

Apenas saída. Emoji associado às reações.
reactionCount

integer

Apenas saída. O número total de reações usando o emoji associado.

DeletionMetadata

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.

DeletionType

Quem e como a mensagem foi excluída. Mais valores podem ser adicionados no futuro. Consulte Editar ou excluir uma mensagem no Google Chat para saber quando as mensagens podem ser excluídas.

Enums
DELETION_TYPE_UNSPECIFIED Esse valor não é usado.
CREATOR O usuário excluiu a própria mensagem.
SPACE_OWNER Um administrador do espaço excluiu a mensagem.
ADMIN Um administrador do Google Workspace excluiu a mensagem. Os administradores podem excluir qualquer mensagem no espaço, incluindo as enviadas por qualquer participante ou pelo app Chat.
APP_MESSAGE_EXPIRY Um app do Chat excluiu a própria mensagem quando ela expirou.
CREATOR_VIA_APP Um app de chat excluiu a mensagem em nome do criador (usando a autenticação do usuário).
SPACE_OWNER_VIA_APP Um app do Chat excluiu a mensagem em nome de um administrador do espaço (usando a autenticação do usuário).
SPACE_MEMBER Um participante do espaço excluiu a mensagem. Os usuários podem excluir mensagens enviadas por apps.

QuotedMessageMetadata

Informações sobre uma mensagem citada.

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

string

Apenas saída. Nome do recurso da mensagem citada.

Formato: spaces/{space}/messages/{message}
lastUpdateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que a mensagem citada foi criada ou atualizada pela última vez.

AttachedGif

Uma imagem GIF especificada por um URL.

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

string

Apenas saída. O URL que hospeda a imagem GIF.

AccessoryWidget

Um ou mais widgets interativos que aparecem na parte de baixo de uma mensagem. Para mais detalhes, consulte Adicionar widgets interativos na parte de baixo de uma mensagem.

Representação JSON 
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Campos
Campo de união action. O tipo de ação. action pode ser apenas de um dos tipos a seguir:
buttonList

object (ButtonList)

Uma lista de botões.

Métodos

create

 Cria uma mensagem em um espaço do Google Chat.

delete

 Exclui uma mensagem.

get

 Retorna detalhes sobre uma mensagem.

list

 Lista as mensagens em um espaço de que o usuário é participante, incluindo mensagens de participantes e espaços bloqueados.

patch

 Atualiza uma mensagem.

update

 Atualiza uma mensagem.