REST Resource: spaces.messages

string

ID。メッセージのリソース名。

形式: spaces/{space}/messages/{message}

ここで、{space} はメッセージが投稿されたスペースの ID、{message} はメッセージにシステムによって割り当てられた ID です。例: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

メッセージを作成するときにカスタム ID を設定した場合は、{message} を clientAssignedMessageId フィールドの値に置き換えることで、この ID を使用してリクエストでメッセージを指定できます。例: spaces/AAAAAAAAAAA/messages/client-custom-name。詳しくは、メッセージに名前を付けるをご覧ください。

object (User)

出力専用。メッセージを作成したユーザー。Chat アプリがユーザーとして認証されると、出力にユーザー name と type が入力されます。

string (Timestamp format)

省略可。変更不可。Chat で作成されたスペースの場合は、メッセージが作成された時刻。このフィールドは、インポートモードのスペースで使用する場合を除き、出力専用です。

インポート モードのスペースの場合は、元の作成時間を保持するために、このフィールドをソースでメッセージが作成された過去のタイムスタンプに設定します。

string (Timestamp format)

出力専用。ユーザーが最後にメッセージを編集した日時。メッセージが編集されていない場合、このフィールドは空白です。

string (Timestamp format)

出力専用。Google Chat でメッセージが削除された時刻。メッセージが削除されない場合は、このフィールドは空です。

string

省略可。メッセージのプレーン テキスト本文。画像、動画、ウェブページへの最初のリンクでプレビュー チップが生成されます。Google Chat ユーザーの名前リンクや、スペース内の全ユーザーの名前リンクを指定することもできます。

テキスト メッセージの作成については、メッセージを送信するをご覧ください。

string

出力専用。書式を指定するためにマークアップが追加されたメッセージ text が含まれます。このフィールドには、UI に表示される書式設定がすべて含まれるわけではありませんが、次のような書式設定が含まれます。

• 太字、斜体、取り消し線、等幅、等幅ブロック、箇条書きリストのマークアップ構文。

• <users/{user}> 形式のユーザーのメンション。

• <{url}|{rendered_text}> 形式のカスタム ハイパーリンク。最初の文字列は URL、2 番目の文字列はレンダリングされたテキストです（例: <http://example.com|custom text>）。

• :{emojiName}: の形式のカスタム絵文字（例: :smile:）。これは、笑顔の絵文字の U+1F600 など、Unicode 絵文字には適用されません。

詳しくは、メッセージで送信されたテキストの書式設定を表示するをご覧ください。

object (Card)

非推奨: 代わりに、cardsV2 を使用してください。

書式設定されたリッチなインタラクティブ カード。書式設定されたテキスト、ボタン、クリック可能な画像などの UI 要素を表示できます。カードは通常、メッセージのプレーンテキストの本文の下に表示されます。cards と cardsV2 の最大サイズは 32 KB です。

object (CardWithId)

省略可。カードの配列。

カードを作成できるのは Chat アプリのみです。チャットアプリがユーザーとして認証されている場合、メッセージにカードを含めることはできません。

カードを含むメッセージを作成する方法については、メッセージを送信するをご覧ください。

カードビルダーを使用してカードをデザインし、プレビューします。

object (Annotation)

出力専用。このメッセージの text に関連付けられているアノテーション。

object (Thread)

メッセージが属するスレッド。使用例については、メッセージ スレッドを開始または返信するをご覧ください。

object (Space)

出力専用。Chat アプリがユーザーとして認証する場合、出力にはスペース name のみが入力されます。

string

省略可。メッセージのカードに関するプレーンテキストの説明。実際のカード（モバイル通知など）を表示できない場合に使用されます。

object (ActionResponse)

入力のみのChat アプリがレスポンスの投稿方法を構成するために使用できるパラメータ。

string

出力専用。Chat アプリの記述がすべて削除された、メッセージの本文の書式なしテキスト。

object (SlashCommand)

出力専用。スラッシュ コマンドに関する情報（該当する場合）。

object (Attachment)

省略可。ユーザーがアップロードした添付ファイル。

object (MatchedUrl)

出力専用。リンク プレビュー パターンと一致する spaces.messages.text の URL。詳細については、プレビュー リンクをご覧ください。

boolean

出力専用。true の場合、メッセージは返信スレッド内の返信です。false の場合、メッセージはスレッドの最初のメッセージとして、またはスレッド形式の返信のないメッセージとして、スペースの最上位の会話に表示されます。

スレッドでの返信がサポートされていないスペースの場合、このフィールドは常に false です。

string

省略可。メッセージのカスタム ID。フィールドを使用して、メッセージを識別したり、メッセージを取得、削除、更新したりできます。カスタム ID を設定するには、メッセージを作成するときに messageId フィールドを指定します。詳しくは、メッセージに名前を付けるをご覧ください。

object (EmojiReactionSummary)

出力専用。メッセージに対する絵文字のリアクションの概要のリスト。

object (User)

省略可。変更不可。メッセージを作成する場合は入力、それ以外の場合は出力のみ。メッセージを表示できるユーザー。設定すると、メッセージは非公開になり、指定したユーザーと Chat アプリにのみ表示されます。このフィールドをリクエストに含めるには、アプリ認証を使用して Chat API を呼び出し、次の項目を省略する必要があります。

• 添付ファイル
• アクセサリー ウィジェット

詳しくは、メッセージを非公開で送信するをご覧ください。

object (DeletionMetadata)

出力専用。削除されたメッセージに関する情報。deleteTime が設定されていると、メッセージは削除されます。

object (QuotedMessageMetadata)

出力専用。スペース内の Google Chat ユーザーが引用したメッセージに関する情報。Google Chat のユーザーは、メッセージを引用して返信できます。

object (AttachedGif)

出力専用。メッセージに添付された GIF 画像。

object (AccessoryWidget)

省略可。メッセージの下部に表示される 1 つ以上のインタラクティブ ウィジェット。アクセサリ ウィジェットは、テキスト、カード、またはテキストとカードの両方を含むメッセージに追加できます。ダイアログを含むメッセージには対応していません。詳しくは、メッセージの下部にインタラクティブなウィジェットを追加するをご覧ください。

アクセサリ ウィジェットを含むメッセージを作成するには、アプリの認証が必要です。