Package google.chat.v1

インデックス

ChatService

デベロッパーが Google Chat Platform で Chat アプリと統合を構築できるようにします。

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse)

指定したスペースのインポート プロセスが完了し、ユーザーに表示されます。

アプリ認証とドメイン全体の委任が必要です。詳細については、Google Chat アプリにデータのインポートを許可するをご覧ください。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.import

詳しくは、認可ガイドをご覧ください。

CreateCustomEmoji

rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji)

カスタム絵文字を作成します。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.customemojis

詳しくは、認可ガイドをご覧ください。

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

呼び出し元の Chat アプリ、ユーザー、Google グループのメンバーシップを作成します。他の Chat アプリのメンバーシップの作成はサポートされていません。メンバーシップを作成するときに、指定したメンバーの自動承認ポリシーがオフになっている場合、そのメンバーは招待された後、スペースへの招待を承諾してから参加する必要があります。それ以外の場合は、メンバーシップを作成すると、指定したスペースにメンバーが直接追加されます。

次のタイプの認証をサポートしています。

使用例については、以下をご覧ください。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

詳しくは、認可ガイドをご覧ください。

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message)

Google Chat スペースにメッセージを作成します。例については、メッセージを送信するをご覧ください。

create() メソッドには、ユーザー認証またはアプリ認証のいずれかが必要です。Chat は、リクエストで使用する認証の種類に応じて、メッセージの送信者を異なる方法で属性付けします。

次の図は、アプリ認証を使用する場合に Chat がメッセージをどのように属性付けるかを示しています。Chat には、メッセージの送信者として Chat アプリが表示されます。メッセージのコンテンツには、テキスト(text)、カード(cardsV2)、アクセサリ ウィジェット(accessoryWidgets)を含めることができます。

アプリ認証で送信されたメッセージ

次の図は、ユーザー認証を使用した場合に Chat がメッセージをどのように属性付けるかを示しています。Chat では、ユーザーがメッセージの送信者として表示され、Chat アプリの名前を表示することでメッセージに関連付けられます。メッセージの内容にはテキスト(text)のみを含めることができます。

ユーザー認証で送信されたメッセージ

メッセージの内容を含むメッセージの最大サイズは 32,000 バイトです。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

詳しくは、認可ガイドをご覧ください。

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction)

リアクションを作成してメッセージに追加します。サポートされているのは Unicode 絵文字のみです。例については、メッセージにリアクションを追加するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.create

詳しくは、認可ガイドをご覧ください。

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space)

スペースを作成します。Import mode で名前付きスペースまたはグループ チャットを作成するために使用できます。例については、スペースを作成するをご覧ください。

次のタイプの認証をサポートしています。

アプリとして認証する場合は、リクエストで space.customer フィールドを設定する必要があります。

作成時のスペースの参加資格は、スペースが Import mode で作成されたかどうかによって異なります。

  • インポート モード: メンバーは作成されません。
  • その他のすべてのモード: 呼び出し元のユーザーがメンバーとして追加されます。次のようにします。
    • アプリ認証を使用している場合、アプリ自体。
    • ユーザー認証を使用している場合は、人間のユーザー。

スペースの作成時にエラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

詳しくは、認可ガイドをご覧ください。

DeleteCustomEmoji

rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty)

カスタム絵文字を削除します。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.customemojis

詳しくは、認可ガイドをご覧ください。

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

メンバーシップを削除します。例については、スペースからユーザーまたは Google Chat アプリを削除するをご覧ください。

次のタイプの認証をサポートしています。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

詳しくは、認可ガイドをご覧ください。

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty)

メッセージを削除します。例については、メッセージを削除するをご覧ください。

次のタイプの認証をサポートしています。

アプリ認証を使用する場合、リクエストで削除できるのは、呼び出し元の Chat アプリによって作成されたメッセージのみです。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

詳しくは、認可ガイドをご覧ください。

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty)

メッセージに対するリアクションを削除します。サポートされているのは Unicode 絵文字のみです。例については、リアクションを削除するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.reactions

詳しくは、認可ガイドをご覧ください。

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty)

名前付きスペースを削除します。常にカスケード削除を実行します。つまり、スペースの子リソース(スペースに投稿されたメッセージやスペースのメンバーシップなど)も削除されます。例については、Space を削除するをご覧ください。

次のタイプの認証をサポートしています。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

詳しくは、認可ガイドをご覧ください。

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space)

指定されたユーザーとの既存のダイレクト メッセージを返します。直接メッセージ スペースが見つからない場合、404 NOT_FOUND エラーが返されます。例については、ダイレクト メッセージを探すをご覧ください。

アプリ認証では、指定したユーザーと呼び出し元の Chat アプリ間のダイレクト メッセージ スペースを返します。

ユーザー認証では、指定したユーザーと認証されたユーザー間の直接メッセージ空間を返します。

// 次のタイプの認証をサポートしています。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

詳しくは、認可ガイドをご覧ください。

GetAttachment

rpc GetAttachment(GetAttachmentRequest) returns (Attachment)

メッセージの添付ファイルのメタデータを取得します。添付ファイルのデータは media API を使用して取得されます。例については、メッセージの添付ファイルに関するメタデータを取得するをご覧ください。アプリ認証が必要です。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.bot

詳しくは、認可ガイドをご覧ください。

GetCustomEmoji

rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji)

カスタム絵文字に関する詳細を返します。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

詳しくは、認可ガイドをご覧ください。

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

メンバーシップの詳細を返します。例については、ユーザーまたは Google Chat アプリのメンバーシップの詳細を取得するをご覧ください。

次のタイプの認証をサポートしています。

  • アプリの認証

  • ユーザー認証 リクエストで use_admin_access フィールドを設定すると、管理者権限でこのメソッドを認証して承認できます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

詳しくは、認可ガイドをご覧ください。

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message)

メッセージの詳細を返します。例については、メッセージの詳細を取得するをご覧ください。

次のタイプの認証をサポートしています。

注: ブロックしたメンバーまたはスペースからのメッセージが返されることがあります。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

詳しくは、認可ガイドをご覧ください。

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space)

スペースの詳細を返します。例については、スペースの詳細を取得するをご覧ください。

次のタイプの認証をサポートしています。

  • アプリの認証

  • ユーザー認証 リクエストで use_admin_access フィールドを設定すると、管理者権限でこのメソッドを認証して承認できます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.app.spaces

詳しくは、認可ガイドをご覧ください。

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent)

Google Chat スペースのイベントを返します。イベント ペイロードには、変更されたリソースの最新バージョンが含まれています。たとえば、新しいメッセージに関するイベントをリクエストした後でメッセージが更新された場合、サーバーはイベント ペイロードで更新された Message リソースを返します。

注: このリクエストの Space イベントデータの Space オブジェクトには、permissionSettings フィールドは返されません。

ユーザー認証が必要です。イベントを取得するには、認証されたユーザーがスペースのメンバーである必要があります。

例については、Google Chat スペースからイベントの詳細を取得するをご覧ください。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

詳しくは、認可ガイドをご覧ください。

GetSpaceNotificationSetting

rpc GetSpaceNotificationSetting(GetSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

スペースの通知状態の設定を取得します。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.users.spacesettings

詳しくは、認可ガイドをご覧ください。

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState)

スペース内のユーザーの既読ステータスの詳細を返します。未読と既読のメッセージを識別するために使用されます。例については、ユーザーのスペースの読み取り状態の詳細を取得するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

詳しくは、認可ガイドをご覧ください。

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState)

スレッド内のユーザーの未読ステータスの詳細を返します。未読と既読のメッセージを識別するために使用されます。例については、ユーザーのスレッドの読み取りステータスの詳細を取得するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.users.readstate
  • https://www.googleapis.com/auth/chat.users.readstate.readonly

詳しくは、認可ガイドをご覧ください。

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse)

認証済みユーザーに表示されるカスタム絵文字を一覧表示します。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

詳しくは、認可ガイドをご覧ください。

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

スペース内のメンバーシップを一覧表示します。例については、スペース内のユーザーと Google Chat アプリを一覧表示するをご覧ください。アプリ認証でメンバーシップを一覧表示すると、Chat アプリがアクセスできるスペースのメンバーシップが一覧表示されます。ただし、Chat アプリのメンバーシップ(自身を含む)は除外されます。[ユーザー認証] でメンバーシップを一覧表示すると、認証されたユーザーがアクセスできるスペースのメンバーシップが一覧表示されます。

次のタイプの認証をサポートしています。

  • アプリの認証

  • ユーザー認証 リクエストで use_admin_access フィールドを設定すると、管理者権限でこのメソッドを認証して承認できます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

詳しくは、認可ガイドをご覧ください。

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse)

呼び出し元がメンバーであるスペース内のメッセージ(ブロックされたメンバーやスペースからのメッセージを含む)を一覧表示します。メッセージのないスペースのメッセージを一覧表示すると、レスポンスは空のオブジェクトになります。REST/HTTP インターフェースを使用している場合、レスポンスには空の JSON オブジェクト {} が含まれます。例については、メッセージを一覧表示するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly

詳しくは、認可ガイドをご覧ください。

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse)

メッセージに対するリアクションを一覧表示します。例については、メッセージのリアクションを一覧表示するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

詳しくは、認可ガイドをご覧ください。

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse)

Google Chat スペースのイベントを一覧表示します。イベントごとに、ペイロードには最新バージョンの Chat リソースが含まれます。たとえば、新しいスペース メンバーに関するイベントをリストすると、最新のメンバーの詳細を含む Membership リソースがサーバーから返されます。リクエストされた期間中に新規メンバーが削除された場合、イベント ペイロードには空の Membership リソースが含まれます。

ユーザー認証が必要です。イベントを一覧表示するには、認証済みユーザーがスペースのメンバーである必要があります。

例については、Google Chat スペースのイベントを一覧表示するをご覧ください。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

詳しくは、認可ガイドをご覧ください。

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse)

呼び出し元がメンバーになっているスペースを一覧表示します。グループ チャットと DM は、最初のメッセージが送信されるまで一覧に表示されません。例については、スペースを一覧表示するをご覧ください。

次のタイプの認証をサポートしています。

Google Workspace 組織のすべての名前付きスペースを一覧表示するには、代わりに Workspace 管理者権限を使用して spaces.search() メソッドを使用します。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

詳しくは、認可ガイドをご覧ください。

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse)

管理者の検索に基づいて、Google Workspace 組織内のスペースのリストを返します。

管理者権限を持つユーザー認証が必要です。リクエストでは、use_admin_accesstrue に設定します。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly

詳しくは、認可ガイドをご覧ください。

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space)

スペースを作成し、指定したユーザーを追加します。呼び出し元のユーザーはスペースに自動的に追加されるため、リクエストでメンバーシップとして指定する必要はありません。例については、初期メンバーを含むスペースを設定するをご覧ください。

追加するユーザー メンバーを指定する場合は、適切な membership.member.name を使用してメンバーシップを追加します。人間のユーザーを追加するには、users/{user} を使用します。ここで、{user} はユーザーのメールアドレスにできます。同じ Workspace 組織内のユーザーの場合、{user} は People API のユーザーの id または Directory API のユーザーの id にすることもできます。たとえば、user@example.com の People API の個人プロファイル ID が 123456789 の場合、membership.member.nameusers/user@example.com または users/123456789 に設定することで、ユーザーを Space に追加できます。

追加する Google グループを指定するには、適切な membership.group_member.name を使用してメンバーシップを追加します。Google グループを追加または招待するには、groups/{group} を使用します。ここで、{group} は Cloud Identity Groups API のグループの id です。たとえば、Cloud Identity Groups lookup API を使用して、グループメール group@example.com の ID 123456789 を取得し、membership.group_member.namegroups/123456789 に設定して、グループをスペースに追加できます。グループメールはサポートされていません。また、Google グループは名前付きスペースにメンバーとしてのみ追加できます。

名前付きスペースまたはグループ チャットの場合、呼び出し元が一部のメンバーをブロックしている、または一部のメンバーからブロックされている、または一部のメンバーを追加する権限がない場合は、それらのメンバーは作成されたスペースに追加されません。

呼び出し元のユーザーと別の人間ユーザーとの間でダイレクト メッセージ(DM)を作成するには、人間ユーザーを表すメンバーシップを 1 つだけ指定します。一方のユーザーがもう一方のユーザーをブロックしている場合、リクエストは失敗し、DM は作成されません。

呼び出し元のユーザーと呼び出し元のアプリの間に DM を作成するには、Space.singleUserBotDmtrue に設定し、メンバーシップを指定しません。この方法は、呼び出し元のアプリとの DM の設定にのみ使用できます。呼び出し元のアプリをスペースのメンバーとして追加する場合や、2 人のユーザー間の既存の DM に追加する場合は、ユーザーまたはアプリをスペースに招待または追加するをご覧ください。

2 人のユーザー間にすでに DM が存在する場合、リクエスト時に一方のユーザーがもう一方をブロックしても、既存の DM が返されます。

スレッド形式の返信を含むスペースはサポートされていません。スペースの設定時にエラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

詳しくは、認可ガイドをご覧ください。

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership)

メンバーシップを更新します。例については、スペース内のユーザーのメンバーシップを更新するをご覧ください。

次のタイプの認証をサポートしています。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships

詳しくは、認可ガイドをご覧ください。

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message)

メッセージを更新します。patch メソッドと update メソッドには違いがあります。patch メソッドは patch リクエストを使用し、update メソッドは put リクエストを使用します。patch メソッドを使用することをおすすめします。例については、メッセージを更新するをご覧ください。

次のタイプの認証をサポートしています。

アプリ認証を使用する場合、リクエストで更新できるのは、呼び出し元の Chat アプリによって作成されたメッセージのみです。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

詳しくは、認可ガイドをご覧ください。

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space)

スペースを更新します。例については、スペースを更新するをご覧ください。

displayName フィールドを更新しているときにエラー メッセージ ALREADY_EXISTS が表示された場合は、別の表示名を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

次のタイプの認証をサポートしています。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

詳しくは、認可ガイドをご覧ください。

UpdateSpaceNotificationSetting

rpc UpdateSpaceNotificationSetting(UpdateSpaceNotificationSettingRequest) returns (SpaceNotificationSetting)

スペースの通知状態の設定を更新します。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.users.spacesettings

詳しくは、認可ガイドをご覧ください。

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState)

スペース内のユーザーの既読ステータスを更新します。これは、既読と未読のメッセージを識別するために使用されます。例については、ユーザーのスペースの読み取り状態を更新するをご覧ください。

ユーザー認証が必要です。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/chat.users.readstate

詳しくは、認可ガイドをご覧ください。

AccessoryWidget

メッセージの下部に表示される 1 つ以上のインタラクティブ ウィジェット。詳しくは、メッセージの下部にインタラクティブなウィジェットを追加するをご覧ください。

フィールド
共用体フィールド action。アクションの種類。action は次のいずれかになります。
button_list

ButtonList

ボタンのリスト。

ActionResponse

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

フィールド
type

ResponseType

入力のみのChat アプリのレスポンスのタイプ。

url

string

入力のみのユーザーが認証または構成するための URL。(REQUEST_CONFIG レスポンス タイプの場合のみ)。

dialog_action

DialogAction

入力のみのダイアログに関連するインタラクション イベントへのレスポンス。ResponseType.Dialog を指定する必要があります。

updated_widget

UpdatedWidget

入力のみの更新されたウィジェットのレスポンス。

ResponseType

Chat アプリのレスポンスのタイプ。

列挙型
TYPE_UNSPECIFIED NEW_MESSAGE として処理されるデフォルトのタイプ。
NEW_MESSAGE トピックに新しいメッセージとして投稿します。
UPDATE_MESSAGE Chat アプリのメッセージを更新します。これは、メッセージの送信者のタイプが BOT である CARD_CLICKED イベントでのみ許可されます。
UPDATE_USER_MESSAGE_CARDS ユーザーのメッセージのカードが更新されます。これは、URL が一致する MESSAGE イベントまたは、メッセージ送信者のタイプが HUMANCARD_CLICKED イベントに対するレスポンスとしてのみ許可されます。テキストは無視されます。
REQUEST_CONFIG 追加の認証や構成について、お客様に非公開で依頼します。
DIALOG ダイアログを表示します。
UPDATE_WIDGET ウィジェットのテキスト オートコンプリート オプションのクエリ。

SelectionItems

ウィジェットの予測入力結果のリスト。

フィールド
items[]

SelectionItem

SelectionItem オブジェクトの配列。

UpdatedWidget

更新されたウィジェットのレスポンス。ウィジェットの予測入力オプションを提供するために使用されます。

フィールド
widget

string

更新されたウィジェットの ID。ID は、更新リクエストをトリガーしたウィジェットの ID と一致している必要があります。

共用体フィールド updated_widget。ユーザーの操作に応じて更新されたウィジェット。updated_widget は次のいずれかになります。
suggestions

SelectionItems

ウィジェット オートコンプリートの結果のリスト

ActionStatus

ダイアログを呼び出すか送信するリクエストのステータスを表します。

フィールド
status_code

Code

ステータス コード。

user_facing_message

string

リクエストのステータスに関するメッセージをユーザーに送信します。設定されていない場合、status_code に基づく汎用メッセージが送信されます。

Annotation

出力専用。メッセージのプレーン テキスト本文に関連付けられたアノテーション。テキスト メッセージに基本的な書式を追加するには、テキスト メッセージの書式を設定するをご覧ください。

プレーンテキスト メッセージ本文の例:

Hello @FooBot how are you!"

対応するアノテーション メタデータ:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
フィールド
type

AnnotationType

このアノテーションのタイプ。

length

int32

このアノテーションが対応する、プレーンテキスト メッセージ本文のサブ文字列の長さ。

start_index

int32

このアノテーションが対応するプレーンテキスト メッセージ本文の開始インデックス(0 から始まる番号、両端を含む)。

共用体フィールド metadata。アノテーションに関する追加のメタデータ。metadata は次のいずれかになります。
user_mention

UserMentionMetadata

ユーザーのメンションのメタデータ。

slash_command

SlashCommandMetadata

スラッシュ コマンドのメタデータ。

AnnotationType

アノテーションの型。

列挙型
ANNOTATION_TYPE_UNSPECIFIED 列挙型のデフォルト値。使用しないでください。
USER_MENTION ユーザーがメンションされている。
SLASH_COMMAND スラッシュ コマンドが呼び出されます。

AttachedGif

URL で指定された GIF 画像。

フィールド
uri

string

出力専用。GIF 画像をホストする URL。

添付ファイル

Google Chat の添付ファイル。

フィールド
name

string

省略可。アタッチメントのリソース名(spaces/{space}/messages/{message}/attachments/{attachment} の形式)。

content_name

string

出力専用。コンテンツの元のファイル名(フルパスではない)。

content_type

string

出力専用。ファイルのコンテンツ タイプ(MIME タイプ)。

thumbnail_uri

string

出力専用。人間のユーザーに添付ファイルをプレビューするために使用するサムネイル URL。チャットアプリでは、この URL を使用して添付コンテンツをダウンロードしないでください。

download_uri

string

出力専用。人間のユーザーが添付ファイルをダウンロードできるようにするために使用するダウンロード URL。チャットアプリでは、この URL を使用して添付コンテンツをダウンロードしないでください。

source

Source

出力専用。添付ファイルのソース。

共用体フィールド data_ref。添付ファイルを参照するデータ。data_ref は次のいずれかになります。
attachment_data_ref

AttachmentDataRef

省略可。添付データへの参照。このフィールドは、添付ファイルを含むメッセージを作成または更新する場合、または media API を使用して添付ファイルのデータをダウンロードする場合に使用します。

drive_data_ref

DriveDataRef

出力専用。Google ドライブの添付ファイルへの参照。このフィールドは Google Drive API で使用されます。

ソース

添付ファイルのソース。

列挙型
SOURCE_UNSPECIFIED 予約済み。
DRIVE_FILE ファイルが Google ドライブ ファイルである。
UPLOADED_CONTENT ファイルが Chat にアップロードされます。

AttachmentDataRef

添付データへの参照。

フィールド
resource_name

string

省略可。添付データのリソース名。このフィールドは、media API で添付データのダウンロードに使用されます。

attachment_upload_token

string

省略可。アップロードされた添付ファイルへの参照を含む不透明なトークン。クライアントでは不透明な文字列として扱われ、添付ファイルを含む Chat メッセージの作成または更新に使用されます。

CardWithId

Google Chat メッセージのカード

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

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

カードビルダーを開く

フィールド
card_id

string

メッセージに複数のカードが含まれている場合は必須です。メッセージ内のカードの一意の識別子。

card

Card

カード。最大サイズは 32 KB です。

ChatSpaceLinkData

Chat スペースのリンクのデータ。

フィールド
space

string

リンクされた Chat スペース リソースのスペース。

形式: spaces/{space}

thread

string

リンクされた Chat スペース リソースのスレッド。

形式: spaces/{space}/threads/{thread}

message

string

リンクされた Chat スペース リソースのメッセージ。

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

CompleteImportSpaceRequest

スペースのインポート プロセスを完了するためのリクエスト メッセージ。

フィールド
name

string

必須。インポート モードのスペースのリソース名。

形式: spaces/{space}

CompleteImportSpaceResponse

スペースのインポート プロセスが完了したことを示すレスポンス メッセージ。

フィールド
space

Space

インポート モードのスペース。

ContextualAddOnMarkup

この型にはフィールドがありません。

コンテキスト アドオンのコンテンツを指定するデベロッパー向けのマークアップ。

カード

カードは、テキストや画像などの UI ウィジェットを含めることができる UI 要素です。

フィールド
header

CardHeader

カードのヘッダー。ヘッダーには通常、タイトルと画像が含まれます。

sections[]

Section

セクションは線で区切ります。

card_actions[]

CardAction

このカードのアクション。

name

string

カードの名前。

CardAction

カードアクションは、カードに関連付けられたアクションです。請求書カードの場合、一般的なアクションは、請求書の削除、請求書のメール送信、ブラウザでの請求書の開くなどです。

Google Chat アプリではサポートされていません。

フィールド
action_label

string

アクション メニュー項目に表示されていたラベル。

on_click

OnClick

このアクション アイテムの onclick アクション。

CardHeader

フィールド
title

string

タイトルを指定する必要があります。ヘッダーの高さは固定です。タイトルとサブタイトルの両方が指定されている場合、それぞれ 1 行を占有します。タイトルのみを指定した場合、タイトルは両方の行に表示されます。

subtitle

string

カード ヘッダーのサブタイトル。

image_style

ImageStyle

画像の種類(正方形の枠線、円形の枠線など)。

image_url

string

カード ヘッダーの画像の URL。

ImageStyle

列挙型
IMAGE_STYLE_UNSPECIFIED
IMAGE 正方形の枠線。
AVATAR 円形の枠線。

セクション

セクションには、指定された順序で(垂直方向に)レンダリングされるウィジェットのコレクションが含まれています。すべてのプラットフォームでカードの幅は狭く固定されているため、現在のところ、レイアウト プロパティ(float など)は必要ありません。

フィールド
header

string

セクションのヘッダー。書式設定されたテキストがサポートされています。テキストの書式設定の詳細については、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

widgets[]

WidgetMarkup

セクションには、少なくとも 1 つのウィジェットを含める必要があります。

CreateCustomEmojiRequest

カスタム絵文字を作成するリクエスト。

フィールド
custom_emoji

CustomEmoji

必須。作成するカスタム絵文字。

CreateMembershipRequest

メンバーシップの作成リクエスト メッセージ。

フィールド
parent

string

必須。メンバーシップを作成する Space のリソース名。

形式: spaces/{space}

membership

Membership

必須。作成するメンバーシップ リレーション。

memberType フィールドには、user.name フィールドと user.type フィールドが設定されたユーザーを含める必要があります。サーバーはリソース名を割り当て、指定されたものを上書きします。

Chat アプリが人間のユーザーのメンバーシップ関係を作成する場合は、特定の認可スコープを使用し、特定のフィールドに特定の値を設定する必要があります。

  • ユーザーとして認証する場合は、chat.memberships 承認スコープが必要です。

  • アプリとして認証する場合は、chat.app.memberships 承認スコープが必要です。アプリとして認証できるのは、

  • user.typeHUMAN に設定し、user.nameusers/{user} 形式で設定します。ここで、{user} はユーザーのメールアドレスにできます。同じ Workspace 組織内のユーザーの場合、{user} は People API のユーザーid または Directory API のユーザーの id にすることもできます。たとえば、user@example.com の People API の個人プロファイル ID が 123456789 の場合、membership.member.nameusers/user@example.com または users/123456789 に設定することで、ユーザーを Space に追加できます。

スペースを所有する Workspace 組織外のユーザーを招待するには、ユーザー認証が必要です。

Chat アプリが自身のメンバーシップ関係を作成する場合は、ユーザーとして認証し、chat.memberships.app スコープを使用して、user.typeBOT に設定し、user.nameusers/app に設定する必要があります。

use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships OAuth 2.0 スコープが必要です。

管理者の Google Workspace 組織外のユーザーのアプリ メンバーシップやメンバーシップの作成は、管理者権限を使用してサポートされていません。

CreateMessageRequest

メッセージを作成します。

フィールド
parent

string

必須。メッセージを作成するスペースのリソース名。

形式: spaces/{space}

message

Message

必須。メッセージ本文。

thread_key
(deprecated)

string

省略可。非推奨: 代わりに thread.thread_key を使用してください。スレッドの ID。最大 4,000 文字までサポートされます。スレッドを開始または追加するには、メッセージを作成して threadKey または thread.name を指定します。使用例については、メッセージ スレッドを開始または返信するをご覧ください。

request_id

string

省略可。このメッセージの一意のリクエスト ID。既存のリクエスト ID を指定すると、新しいメッセージが作成されるのではなく、その ID で作成されたメッセージが返されます。

message_reply_option

MessageReplyOption

省略可。メッセージがスレッドを開始するか、スレッドに返信するかを指定します。名前付きスペースでのみサポートされます。

ユーザー操作に応答する場合、このフィールドは無視されます。スレッド内のやり取りの場合、返信は同じスレッド内に作成されます。それ以外の場合は、返信が新しいスレッドとして作成されます。

message_id

string

省略可。メッセージのカスタム ID。システムが割り当てた ID をメッセージのリソース名(メッセージの name フィールドに表示)に保存しなくても、Chat アプリがメッセージを取得、更新、削除できるようにします。

このフィールドの値は、次の要件を満たす必要があります。

  • client- で始まります。たとえば、client-custom-name は有効なカスタム ID ですが、custom-name は有効ではありません。
  • 63 文字以下で、小文字、数字、ハイフンのみを使用できます。
  • スペース内で一意です。チャットアプリでは、異なるメッセージに同じカスタム ID を使用できません。

詳しくは、メッセージに名前を付けるをご覧ください。

MessageReplyOption

メッセージへの返信方法を指定します。今後、他の州も追加される可能性があります。

列挙型
MESSAGE_REPLY_OPTION_UNSPECIFIED デフォルト。新しいスレッドを開始します。このオプションを使用すると、含まれる thread ID または thread_key は無視されます。
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD thread ID または thread_key で指定されたスレッドへの返信としてメッセージを作成します。失敗した場合は、メッセージが代わりに新しいスレッドを開始します。
REPLY_MESSAGE_OR_FAIL thread ID または thread_key で指定されたスレッドへの返信としてメッセージを作成します。新しい thread_key が使用されると、新しいスレッドが作成されます。メッセージの作成に失敗した場合は、代わりに NOT_FOUND エラーが返されます。

CreateReactionRequest

メッセージに対するリアクションを作成します。

フィールド
parent

string

必須。リアクションが作成されたメッセージ。

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

reaction

Reaction

必須。作成するリアクション。

CreateSpaceRequest

メンバーのない名前付き空間の作成リクエスト。

フィールド
space

Space

必須。displayName フィールドと spaceType フィールドに値を設定する必要があります。SpaceType.SPACESpaceType.GROUP_CHAT のみがサポートされています。SpaceType.GROUP_CHAT は、importMode が true に設定されている場合にのみ使用できます。

エラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

スペース name はサーバーで割り当てられるため、このフィールドで指定されたものはすべて無視されます。

request_id

string

省略可。このリクエストの一意の識別子。ランダムな UUID を使用することをおすすめします。既存のリクエスト ID を指定すると、新しいスペースが作成されるのではなく、その ID で作成されたスペースが返されます。同じ Chat アプリの既存のリクエスト ID を指定して、認証済みのユーザーが異なると、エラーが返されます。

CustomEmoji

カスタム絵文字を表します。

フィールド
name

string

ID。サーバーが割り当てたカスタム絵文字のリソース名。

形式: customEmojis/{customEmoji}

uid

string

出力専用。カスタム絵文字リソースの一意のキー。

emoji_name

string

省略可。変更不可。カスタム絵文字にユーザーが指定した名前。組織内で一意にする必要があります。

カスタム絵文字を作成する場合は必須ですが、それ以外の場合は出力専用です。

絵文字名は先頭と末尾にコロンを配置し、小文字で入力する必要があります。また、英数字、ハイフン、アンダースコアのみを使用できます。なお、ハイフンとアンダースコアは単語を区切る目的にのみ使用してください。これらを連続して使用することはできません。

例: :valid-emoji-name:

temporary_image_uri

string

出力専用。カスタム 絵文字の画像 URL(有効期間は 10 分以上)。カスタム絵文字の作成時にレスポンスに入力されないことに注意してください。

payload

CustomEmojiPayload

省略可。入力のみのペイロード データ。カスタム絵文字を作成する場合に必要です。

CustomEmojiPayload

カスタム絵文字のペイロード データ。

フィールド
file_content

bytes

必須。入力のみのカスタム絵文字に使用する画像。

ペイロードは 256 KB 未満で、画像のサイズは 64 ~ 500 ピクセルの範囲で指定する必要があります。制限は変更される可能性があります。

filename

string

必須。入力のみの画像ファイル名。

サポートされているファイル拡張子: .png.jpg.gif

DeleteCustomEmojiRequest

カスタム絵文字の削除リクエスト。

フィールド
name

string

必須。削除するカスタム絵文字のリソース名。

形式: customEmojis/{customEmoji}

絵文字名は {customEmoji} のエイリアスとして使用できます。たとえば、customEmojis/:example-emoji: です。ここで、:example-emoji: はカスタム絵文字の絵文字名です。

DeleteMembershipRequest

スペースのメンバーシップを削除するリクエスト。

フィールド
name

string

必須。削除するメンバーシップのリソース名。チャットアプリは、人間のユーザーまたは自身のメンバーシップを削除できます。チャットアプリは、他のアプリのメンバーシップを削除できません。

人間のメンバーシップを削除する場合は、chat.memberships スコープと spaces/{space}/members/{member} 形式が必要です。このメールアドレスは、{member} のエイリアスとして使用できます。たとえば、spaces/{space}/members/example@gmail.com です。ここで、example@gmail.com は Google Chat ユーザーのメールアドレスです。

アプリ メンバーシップを削除する場合は、chat.memberships.app スコープと spaces/{space}/members/app 形式が必要です。

形式: spaces/{space}/members/{member} または spaces/{space}/members/app

use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships OAuth 2.0 スコープが必要です。

管理者権限を使用してスペース内のアプリ メンバーシップを削除することはできません。

DeleteMessageRequest

メッセージを削除するリクエスト。

フィールド
name

string

必須。メッセージのリソース名。

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

メッセージにカスタム ID を設定している場合は、{message}clientAssignedMessageId フィールドの値を使用できます。詳しくは、メッセージに名前を付けるをご覧ください。

force

bool

省略可。true の場合、メッセージを削除すると、スレッド形式の返信も削除されます。false の場合、メッセージにスレッド形式の返信がある場合、削除は失敗します。

ユーザーとして認証する場合にのみ適用されます。Chat アプリとして認証する場合は効果がありません。

DeleteReactionRequest

メッセージに対するリアクションを削除します。

フィールド
name

string

必須。削除するリアクションの名前。

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

DeleteSpaceRequest

スペースの削除リクエスト。

フィールド
name

string

必須。削除するスペースのリソース名。

形式: spaces/{space}

use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.delete OAuth 2.0 スコープが必要です。

DeletionMetadata

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

フィールド
deletion_type

DeletionType

メッセージを削除したユーザーを示します。

DeletionType

メッセージを削除したユーザーと削除方法。今後、値が追加される可能性があります。

列挙型
DELETION_TYPE_UNSPECIFIED この値は使用されません。
CREATOR ユーザーが自分のメッセージを削除した。
SPACE_OWNER スペースのオーナーがメッセージを削除した。
ADMIN Google Workspace 管理者がメッセージを削除しました。
APP_MESSAGE_EXPIRY 有効期限が切れた Chat アプリが独自のメッセージを削除した。
CREATOR_VIA_APP Chat アプリがユーザーに代わってメッセージを削除した。
SPACE_OWNER_VIA_APP Chat アプリがスペースのオーナーに代わってメッセージを削除した。

ダイアログ

ダイアログのカード本文をラップします。

フィールド
body

Card

入力のみのダイアログの本文。モーダルでレンダリングされます。Google Chat アプリは、DateTimePickerOnChangeAction のカード エンティティをサポートしていません。

DialogAction

ダイアログとリクエスト ステータス コードが含まれます。

フィールド
action_status

ActionStatus

入力のみのダイアログを呼び出すか送信するリクエストのステータス。必要に応じて、ステータスとメッセージをユーザーに表示します。たとえば、エラーや成功の場合などです。

共用体フィールド action。実行するアクション。action は次のいずれかになります。
dialog

Dialog

入力のみのリクエストのダイアログ

DriveDataRef

ドライブ アタッチメントのデータへの参照。

フィールド
drive_file_id

string

ドライブ ファイルの ID。Drive API で使用します。

DriveLinkData

Google ドライブのリンクのデータ。

フィールド
drive_data_ref

DriveDataRef

Google ドライブ ファイルを参照する DriveDataRef

mime_type

string

リンクされた Google ドライブ リソースの MIME タイプ。

絵文字

メッセージに対するリアクションとして使用される絵文字。

フィールド
共用体フィールド content。必須。絵文字の内容。content は次のいずれかになります。
unicode

string

省略可。Unicode 文字列で表される基本的な絵文字。

custom_emoji

CustomEmoji

出力専用。カスタム絵文字。

EmojiReactionSummary

特定の絵文字でメッセージにリアクションしたユーザーの数。

フィールド
emoji

Emoji

出力専用。リアクションに関連付けられた絵文字。

reaction_count

int32

出力専用。関連付けられた絵文字を使用したリアクションの合計数。

FindDirectMessageRequest

ユーザー リソースに基づいてダイレクト メッセージ スペースを取得するためのリクエスト。

フィールド
name

string

必須。ダイレクト メッセージを検索するユーザーのリソース名。

形式: users/{user}。ここで、{user} は People API のユーザーid または Directory API のユーザーid です。たとえば、People API のプロフィール ID が 123456789 の場合、name として users/123456789 を使用して、そのユーザーとのダイレクト メッセージを検索できます。ユーザーとして認証されると、メールアドレスを {user} のエイリアスとして使用できます。たとえば、users/example@gmail.com です。ここで、example@gmail.com は Google Chat ユーザーのメールアドレスです。

GetAttachmentRequest

添付ファイルを取得するリクエスト。

フィールド
name

string

必須。アタッチメントのリソース名(spaces/{space}/messages/{message}/attachments/{attachment} の形式)。

GetCustomEmojiRequest

1 つのカスタム絵文字を返すリクエスト。

フィールド
name

string

必須。カスタム絵文字のリソース名。

形式: customEmojis/{customEmoji}

絵文字名は {customEmoji} のエイリアスとして使用できます。たとえば、customEmojis/:example-emoji: です。ここで、:example-emoji: はカスタム絵文字の絵文字名です。

GetMembershipRequest

スペースのメンバーシップを取得するリクエスト。

フィールド
name

string

必須。取得するメンバーシップのリソース名。

ユーザー認証を使用してアプリ独自のメンバーシップを取得するには、必要に応じて spaces/{space}/members/app を使用します。

形式: spaces/{space}/members/{member} または spaces/{space}/members/app

ユーザーのメールアドレスを {member} のエイリアスとして使用できます。たとえば、spaces/{space}/members/example@gmail.com です。ここで、example@gmail.com は Google Chat ユーザーのメールアドレスです。

use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships または chat.admin.memberships.readonlyOAuth 2.0 スコープが必要です。

管理者権限を使用している場合、スペース内のアプリ メンバーシップの取得はサポートされていません。

GetMessageRequest

メッセージを取得するためのリクエスト。

フィールド
name

string

必須。メッセージのリソース名。

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

メッセージにカスタム ID を設定している場合は、{message}clientAssignedMessageId フィールドの値を使用できます。詳しくは、メッセージに名前を付けるをご覧ください。

GetSpaceEventRequest

スペース イベントを取得するリクエスト メッセージ。

フィールド
name

string

必須。スペース イベントのリソース名。

形式: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceNotificationSettingRequest

スペースの通知設定を取得するリクエスト メッセージ。通話発信側のユーザーの通知設定の取得のみをサポートします。

フィールド
name

string

必須。形式: users/{user}/spaces/{space}/spaceNotificationSetting

  • users/me/spaces/{space}/spaceNotificationSetting、OR
  • users/user@example.com/spaces/{space}/spaceNotificationSetting、OR
  • users/123456789/spaces/{space}/spaceNotificationSetting。注: パスには、呼び出し元のユーザー ID またはメールアドレスのみを使用できます。

GetSpaceReadStateRequest

GetSpaceReadState API のリクエスト メッセージ。

フィールド
name

string

必須。取得するスペースの読み取り状態のリソース名。

呼び出し元のユーザーの読み取りステータスの取得のみをサポートします。

呼び出し元のユーザーを参照するには、次のいずれかを設定します。

  • me エイリアス。例: users/me/spaces/{space}/spaceReadState

  • Workspace のメールアドレス。たとえば、users/user@example.com/spaces/{space}/spaceReadState です。

  • ユーザー ID。たとえば、users/123456789/spaces/{space}/spaceReadState です。

形式: users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

1 つのスペースを返すリクエスト。

フィールド
name

string

必須。スペースのリソース名(spaces/{space} の形式)。

形式: spaces/{space}

use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.spaces または chat.admin.spaces.readonlyOAuth 2.0 スコープが必要です。

GetThreadReadStateRequest

GetThreadReadStateRequest API のリクエスト メッセージ。

フィールド
name

string

必須。取得するスレッドの読み取り状態のリソース名。

呼び出し元のユーザーの読み取りステータスの取得のみをサポートします。

呼び出し元のユーザーを参照するには、次のいずれかを設定します。

  • me エイリアス。例: users/me/spaces/{space}/threads/{thread}/threadReadState

  • Workspace のメールアドレス。たとえば、users/user@example.com/spaces/{space}/threads/{thread}/threadReadState です。

  • ユーザー ID。たとえば、users/123456789/spaces/{space}/threads/{thread}/threadReadState です。

形式: users/{user}/spaces/{space}/threads/{thread}/threadReadState

グループ

Google Chat の Google グループ。

フィールド
name

string

Google グループのリソース名。

Cloud Identity Groups API のグループを表します。

形式: groups/{group}

HistoryState

メッセージとスペースの履歴の状態。メッセージと会話スレッドの作成後に保持する期間を指定します。

列挙型
HISTORY_STATE_UNSPECIFIED デフォルト値。使用しないでください。
HISTORY_OFF 履歴がオフ。メッセージとスレッドは 24 時間保持されます
HISTORY_ON 履歴がオンになっています。組織の Vault の保持ルールで、メッセージとスレッドを保持する期間を指定します。

ListCustomEmojisRequest

カスタム絵文字のリストを返すリクエスト。

フィールド
page_size

int32

省略可。返されるカスタム絵文字の最大数。サービスが返すカスタム 絵文字は、この値より少ない場合があります。指定しない場合、デフォルト値は 25 です。最大値は 200 です。200 を超える値は 200 に変更されます。

page_token

string

省略可。(前のクエリから再開する場合)。

前回の list custom emoji 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページネーションを行う場合、フィルタ値はページトークンを受け取った呼び出しと一致している必要があります。別の値を渡すと、予期しない結果になる可能性があります。

filter

string

省略可。クエリフィルタ。

クリエイターによるフィルタリングがサポートされています。

クリエイター別にフィルタするには、有効な値を指定する必要があります。現在、呼び出し元のユーザーによって作成されたかどうかでカスタム絵文字をフィルタするには、creator("users/me")NOT creator("users/me") のみが使用できます。

たとえば、次のクエリは、呼び出し元によって作成されたカスタム絵文字を返します。

creator("users/me")

無効なクエリは、INVALID_ARGUMENT エラーでサーバーが拒否します。

ListCustomEmojisResponse

カスタム絵文字のリストに対するレスポンス。

フィールド
custom_emojis[]

CustomEmoji

順序なしリスト。リクエストされた(または最初の)ページのカスタム絵文字のリスト。

next_page_token

string

結果の次のページを取得するために pageToken として送信できるトークン。空の場合、後続のページはありません。

ListMembershipsRequest

メンバーシップのリスティングのリクエスト メッセージ。

フィールド
parent

string

必須。メンバーシップ リストを取得するスペースのリソース名。

形式: spaces/{space}

page_size

int32

省略可。返されるメンバーシップの最大数。サービスが返す値はこれよりも少ないことがあります。

指定されていない場合は、最大で 100 件のメンバーシップが返されます。

最大値は 1,000 です。1,000 を超える値を使用すると、自動的に 1,000 に変更されます。

負の値を指定すると、INVALID_ARGUMENT エラーが返されます。

page_token

string

省略可。メンバーシップの一覧を取得する前に呼び出しで受け取ったページトークン。後続のページを取得するには、このパラメータを指定します。

ページネーションを行う場合、指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致している必要があります。他のパラメータに異なる値を渡すと、予期しない結果になる可能性があります。

filter

string

省略可。クエリフィルタ。

メンバーシップは、メンバーのロール(role)とタイプ(member.type)でフィルタできます。

ロールでフィルタするには、roleROLE_MEMBER または ROLE_MANAGER に設定します。

タイプ別にフィルタするには、member.typeHUMAN または BOT に設定します。!= 演算子を使用して member.type をフィルタすることもできます。

ロールとタイプの両方でフィルタするには、AND 演算子を使用します。ロールまたはタイプでフィルタするには、OR 演算子を使用します。

use_admin_access が true に設定されている場合は、member.type = "HUMAN" または member.type != "BOT" のいずれかが必要です。その他のメンバー タイプのフィルタは拒否されます。

たとえば、次のクエリは有効です。

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

次のクエリは無効です。

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

無効なクエリは、INVALID_ARGUMENT エラーでサーバーが拒否します。

show_groups

bool

省略可。true の場合、他のタイプのメンバーシップに加えて、Google Group に関連付けられているメンバーシップも返されます。filter が設定されている場合、フィルタ条件に一致しない Google Group メンバーシップは返されません。

show_invited

bool

省略可。true の場合、他のタイプのメンバーシップに加えて、invited メンバーに関連付けられているメンバーシップも返されます。フィルタが設定されている場合、フィルタ条件に一致しない invited メンバーシップは返されません。

現在、ユーザー認証が必要です。

use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships.readonly または chat.admin.membershipsOAuth 2.0 スコープが必要です。

管理者権限を使用している場合、スペースにアプリのメンバーシップを表示することはできません。

ListMembershipsResponse

スペースのメンバーシップを一覧表示するレスポンス。

フィールド
memberships[]

Membership

順序なしリスト。リクエストされた(または最初の)ページのメンバーシップのリスト。

next_page_token

string

結果の次のページを取得するために pageToken として送信できるトークン。空の場合、後続のページはありません。

ListMessagesRequest

ユーザーがメンバーになっている、指定したスペース内のメッセージを一覧表示します。

フィールド
parent

string

必須。メッセージを一覧表示するスペースのリソース名。

形式: spaces/{space}

page_size

int32

省略可。返されるメッセージの最大数。サービスが返すメッセージはこれよりも少ないことがあります。

指定されていない場合は、最大 25 件が返されます。

最大値は 1,000 です。1,000 を超える値を使用すると、自動的に 1,000 に変更されます。

負の値を指定すると、INVALID_ARGUMENT エラーが返されます。

page_token

string

省略可。前回の list messages 呼び出しから受け取ったページトークン。後続のページを取得するには、このパラメータを指定します。

ページネーションを行う場合、指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致している必要があります。他のパラメータに異なる値を渡すと、予期しない結果になる可能性があります。

filter

string

省略可。クエリフィルタ。

メッセージは日付(create_time)とスレッド(thread.name)でフィルタできます。

作成日でメッセージをフィルタするには、RFC-3339 形式のタイムスタンプと二重引用符を使用して create_time を指定します。例: "2023-04-21T11:30:00-04:00"。大なり演算子 > を使用すると、タイムスタンプ後に作成されたメッセージを一覧表示できます。小なり演算子 < を使用すると、タイムスタンプより前に作成されたメッセージを一覧表示できます。期間内のメッセージをフィルタするには、2 つのタイムスタンプの間に AND 演算子を使用します。

スレッドでフィルタするには、spaces/{space}/threads/{thread} 形式の thread.name を指定します。1 つのクエリで指定できる thread.name は 1 つだけです。

スレッドと日付の両方でフィルタするには、クエリで AND 演算子を使用します。

たとえば、次のクエリは有効です。

create_time > "2012-04-21T11:30:00-04:00"

create_time > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

create_time > "2012-04-21T11:30:00+00:00" AND

create_time < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

無効なクエリは、INVALID_ARGUMENT エラーでサーバーが拒否します。

order_by

string

省略可。メッセージのリストの並べ替え順序。並べ替えオペレーションで並べ替える値を指定します。有効な並べ替えオペレーションの値は次のとおりです。

  • 昇順の場合は ASC です。

  • DESC: 降順。

デフォルトの順序は create_time ASC です。

show_deleted

bool

省略可。削除されたメールを含めるかどうか。削除されたメールには、削除日時と削除に関するメタデータが含まれますが、メールの内容は利用できません。

ListMessagesResponse

メッセージのリストに対するレスポンス メッセージ。

フィールド
messages[]

Message

メッセージのリスト。

next_page_token

string

トークンを pageToken として送信して、結果の次のページを取得できます。空の場合、後続のページはありません。

ListReactionsRequest

メッセージに対するリアクションを一覧表示します。

フィールド
parent

string

必須。ユーザーがリアクションしたメッセージ。

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

page_size

int32

省略可。返されるリアクションの最大数。サービスが返すリアクションは、この値より少ない場合があります。指定しない場合、デフォルト値は 25 です。最大値は 200 です。200 を超える値は 200 に変更されます。

page_token

string

省略可。(前のクエリから再開する場合)。

前回の list reactions 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページネーションを行う場合、フィルタ値はページトークンを受け取った呼び出しと一致している必要があります。別の値を渡すと、予期しない結果になる可能性があります。

filter

string

省略可。クエリフィルタ。

リアクションは、絵文字emoji.unicode または emoji.custom_emoji.uid)とユーザーuser.name)でフィルタできます。

複数の絵文字またはユーザーのリアクションをフィルタするには、類似のフィールドを OR 演算子(emoji.unicode = "🙂" OR emoji.unicode = "👍"user.name = "users/AAAAAA" OR user.name = "users/BBBBBB" など)で結合します。

絵文字とユーザーでリアクションをフィルタするには、AND 演算子(emoji.unicode = "🙂" AND user.name = "users/AAAAAA" など)を使用します。

クエリで ANDOR の両方を使用する場合は、括弧でグループ化します。

たとえば、次のクエリは有効です。

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

次のクエリは無効です。

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

無効なクエリは、INVALID_ARGUMENT エラーでサーバーが拒否します。

ListReactionsResponse

リアクションのリクエストに対するレスポンス。

フィールド
reactions[]

Reaction

リクエストされた(または最初の)ページのリアクションのリスト。

next_page_token

string

結果の次のページを取得するための継続トークン。結果の最後のページの場合は空になります。

ListSpaceEventsRequest

リスティング スペース イベントのリクエスト メッセージ。

フィールド
parent

string

必須。イベントが発生した Google Chat スペースのリソース名。

形式: spaces/{space}

page_size

int32

省略可。返されるスペース イベントの最大数。サービスが返す値はこれよりも少ないことがあります。

負の値を指定すると、INVALID_ARGUMENT エラーが返されます。

page_token

string

省略可。前回の list space events 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページネーションを行う場合、list space events に指定する他のすべてのパラメータは、ページトークンを受け取った呼び出しと一致している必要があります。他のパラメータに異なる値を渡すと、予期しない結果になる可能性があります。

filter

string

必須。クエリフィルタ。

has : 演算子を使用して、イベントタイプを少なくとも 1 つ(event_type)指定する必要があります。複数のイベントタイプでフィルタするには、OR 演算子を使用します。フィルタでバッチ イベントタイプを省略します。リクエストは、関連するバッチイベントを自動的に返します。たとえば、新しいリアクション(google.workspace.chat.reaction.v1.created)でフィルタすると、新しいリアクション イベント(google.workspace.chat.reaction.v1.batchCreated)もバッチで返されます。サポートされているイベントタイプの一覧については、SpaceEvents リファレンス ドキュメントをご覧ください。

必要に応じて、開始時間(start_time)と終了時間(end_time)でフィルタすることもできます。

  • start_time: スペース イベントの一覧表示を開始する排他的タイムスタンプ。最大 28 日前に発生したイベントを一覧表示できます。指定しない場合、過去 28 日間のスペース イベントが一覧表示されます。
  • end_time: スペース イベントが表示されるタイムスタンプ(終了日時を含む)。指定しない場合、リクエスト時点までのイベントが一覧表示されます。

開始時間または終了時間を指定するには、等号 = 演算子を使用して RFC-3339 形式で指定します。start_timeend_time の両方でフィルタするには、AND 演算子を使用します。

たとえば、次のクエリは有効です。

start_time="2023-08-23T19:20:33+00:00" AND
end_time="2023-08-23T19:21:54+00:00"
start_time="2023-08-23T19:20:33+00:00" AND
(event_types:"google.workspace.chat.space.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created")

次のクエリは無効です。

start_time="2023-08-23T19:20:33+00:00" OR
end_time="2023-08-23T19:21:54+00:00"
event_types:"google.workspace.chat.space.v1.updated" AND
event_types:"google.workspace.chat.message.v1.created"

無効なクエリは、INVALID_ARGUMENT エラーでサーバーが拒否します。

ListSpaceEventsResponse

スペース イベントを一覧表示するためのレスポンス メッセージ。

フィールド
space_events[]

SpaceEvent

結果は時系列順(最も古いイベントから)に返されます。注: リスト リクエストの Space オブジェクトには permissionSettings フィールドが返されません。

next_page_token

string

追加のイベントの取得に使用される連続トークン。このフィールドを省略すると、後続のページはなくなります。

ListSpacesRequest

呼び出し元がメンバーであるスペースを一覧表示するリクエスト。

フィールド
page_size

int32

省略可。返されるスペースの最大数。サービスが返す値はこれよりも少ないことがあります。

指定されていない場合は、最大で 100 個のスペースが返されます。

最大値は 1,000 です。1,000 を超える値を使用すると、自動的に 1,000 に変更されます。

負の値を指定すると、INVALID_ARGUMENT エラーが返されます。

page_token

string

省略可。前回の list spaces 呼び出しから受け取ったページトークン。後続のページを取得するには、このパラメータを指定します。

ページネーションを行う場合、フィルタ値はページトークンを受け取った呼び出しと一致している必要があります。別の値を渡すと、予期しない結果になる可能性があります。

filter

string

省略可。クエリフィルタ。

スペースはスペースの種類(space_type)でフィルタできます。

スペースタイプでフィルタするには、SPACEGROUP_CHAT などの有効な列挙型の値を指定する必要があります(space_typeSPACE_TYPE_UNSPECIFIED にすることはできません)。複数のスペースタイプをクエリするには、OR 演算子を使用します。

たとえば、次のクエリは有効です。

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

無効なクエリは、INVALID_ARGUMENT エラーでサーバーが拒否します。

ListSpacesResponse

リスト スペース リクエストのレスポンス。

フィールド
spaces[]

Space

リクエストされた(または最初の)ページのスペースのリスト。注: リスト リクエストの Space オブジェクトには permissionSettings フィールドが返されません。

next_page_token

string

トークンを pageToken として送信して、結果の次のページを取得できます。空の場合、後続のページはありません。

MatchedUrl

Chat メッセージ内の一致した URL。チャットアプリでは、一致した URL をプレビューできます。詳しくは、リンクをプレビューするをご覧ください。

フィールド
url

string

出力専用。一致した URL。

メンバーシップ

Google Chat のメンバーシップ関係を表します。たとえば、ユーザーまたは Chat アプリがスペースに招待されているかどうか、スペースに参加しているかどうか、スペースに含まれていないかどうかなどです。

フィールド
name

string

ID。サーバーによって割り当てられたメンバーシップのリソース名。

形式: spaces/{space}/members/{member}

state

MembershipState

出力専用。メンバーシップの状態。

role

MembershipRole

省略可。Chat スペース内のユーザーのロール。スペースで許可されるアクションが決まります。

このフィールドは、UpdateMembership で入力としてのみ使用できます。

create_time

Timestamp

省略可。変更不可。メンバーシップの作成日時(メンバーがスペースに参加した日時や、スペースへの参加を招待された日時など)。このフィールドは、インポート モードのスペースで過去のメンバーシップをインポートする場合を除き、出力専用です。

delete_time

Timestamp

省略可。変更不可。メンバーシップの削除日時(メンバーがスペースから退出または削除された日時など)。このフィールドは、インポート モードのスペースで過去のメンバーシップをインポートする場合を除き、出力専用です。

共用体フィールド memberType。このメンバーシップに関連付けられているメンバー。今後、他のメンバータイプもサポートされる可能性があります。memberType は次のいずれかになります。
member

User

省略可。メンバーシップが対応する Google Chat ユーザーまたはアプリ。Chat アプリがユーザーとして認証されると、出力にユーザー nametype が入力されます。

group_member

Group

省略可。メンバーシップが対応する Google グループ。

Google グループのメンバーシップを読み取ったり変更したりするには、ユーザー認証が必要です。

MembershipRole

Chat スペースでユーザーに許可されているアクションを表します。今後、列挙型の値が追加される可能性があります。

列挙型
MEMBERSHIP_ROLE_UNSPECIFIED デフォルト値。users: スペースのメンバーではありませんが、招待できます。Google Groups の場合: 常にこのロールが割り当てられます(今後、他の列挙値が使用される可能性があります)。
ROLE_MEMBER スペースのメンバー。ユーザーには、スペースへのメッセージの送信などの基本的な権限が付与されます。1 対 1 の会話と名前のないグループの会話では、全員がこの役割を持ちます。
ROLE_MANAGER スペースの管理者。ユーザーには、すべての基本権限に加えて、メンバーの追加や削除など、スペースを管理するための管理者権限が付与されます。SpaceType.SPACE でのみサポートされています。

MembershipState

メンバーとスペースの関係を指定します。今後、他の加盟国もサポートされる可能性があります。

列挙型
MEMBERSHIP_STATE_UNSPECIFIED デフォルト値。使用しないでください。
JOINED ユーザーがスペースに追加され、スペースに参加できるようになります。
INVITED ユーザーがスペースへの参加を招待されているが、まだ参加していない。
NOT_A_MEMBER ユーザーがスペースに属しておらず、スペースへの参加の招待が保留中ではない。

MembershipBatchCreatedEventData

複数の新しいメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.batchCreated

フィールド
memberships[]

MembershipCreatedEventData

新しいメンバーシップのリスト。

MembershipBatchDeletedEventData

複数の削除されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.batchDeleted

フィールド
memberships[]

MembershipDeletedEventData

削除されたメンバーシップのリスト。

MembershipBatchUpdatedEventData

複数の更新されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.batchUpdated

フィールド
memberships[]

MembershipUpdatedEventData

更新されたメンバーシップのリスト。

MembershipCreatedEventData

新しいメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.created

フィールド
membership

Membership

新しいメンバーシップ。

MembershipDeletedEventData

削除されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.deleted

フィールド
membership

Membership

削除されたメンバーシップ。name フィールドと state フィールドのみが入力されます。

MembershipUpdatedEventData

更新されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.updated

フィールド
membership

Membership

更新されたメンバーシップ。

メッセージ

Google Chat スペース内のメッセージ。

フィールド
name

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。詳しくは、メッセージに名前を付けるをご覧ください。

sender

User

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

create_time

Timestamp

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

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

last_update_time

Timestamp

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

delete_time

Timestamp

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

text

string

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

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

formatted_text

string

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

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

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

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

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

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

cards[]
(deprecated)

Card

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

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

cards_v2[]

CardWithId

省略可。カードの配列。

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

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

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

カードビルダーを開く

annotations[]

Annotation

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

thread

Thread

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

space

Space

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

fallback_text

string

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

action_response

ActionResponse

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

argument_text

string

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

slash_command

SlashCommand

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

attachment[]

Attachment

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

matched_url

MatchedUrl

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

thread_reply

bool

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

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

client_assigned_message_id

string

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

emoji_reaction_summaries[]

EmojiReactionSummary

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

private_message_viewer

User

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

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

deletion_metadata

DeletionMetadata

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

quoted_message_metadata

QuotedMessageMetadata

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

attached_gifs[]

AttachedGif

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

accessory_widgets[]

AccessoryWidget

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

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

MessageBatchCreatedEventData

複数の新しいメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.batchCreated

フィールド
messages[]

MessageCreatedEventData

新しいメッセージのリスト。

MessageBatchDeletedEventData

複数の削除されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.batchDeleted

フィールド
messages[]

MessageDeletedEventData

削除されたメッセージのリスト。

MessageBatchUpdatedEventData

複数の更新されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.batchUpdated

フィールド
messages[]

MessageUpdatedEventData

更新されたメッセージのリスト。

MessageCreatedEventData

新しいメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.created

フィールド
message

Message

新しいメッセージ。

MessageDeletedEventData

削除されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.deleted

フィールド
message

Message

削除されたメッセージ。namecreateTimedeleteTimedeletionMetadata の各フィールドにのみ値が入力されます。

MessageUpdatedEventData

更新されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.updated

フィールド
message

Message

更新されたメッセージ。

QuotedMessageMetadata

引用されたメッセージに関する情報。

フィールド
name

string

出力専用。引用されたメッセージのリソース名。

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

last_update_time

Timestamp

出力専用。引用されたメッセージが作成されたとき、または引用されたメッセージが最後に更新されたときのタイムスタンプ。

リアクション

メッセージに対するリアクション。

フィールド
name

string

ID。リアクションのリソース名。

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

user

User

出力専用。リアクションを作成したユーザー。

emoji

Emoji

必須。リアクションで使用された絵文字。

ReactionBatchCreatedEventData

複数の新しいリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.batchCreated

フィールド
reactions[]

ReactionCreatedEventData

新しいリアクションのリスト。

ReactionBatchDeletedEventData

複数の削除されたリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.batchDeleted

フィールド
reactions[]

ReactionDeletedEventData

削除されたリアクションのリスト。

ReactionCreatedEventData

新しいリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.created

フィールド
reaction

Reaction

新しいリアクション。

ReactionDeletedEventData

削除されたリアクションのイベント ペイロード。

タイプ: google.workspace.chat.reaction.v1.deleted

フィールド
reaction

Reaction

削除されたリアクション。

RichLinkMetadata

リソースへのリッチリンク。

フィールド
uri

string

このリンクの URI。

共用体フィールド data。リンクされたリソースのデータ。data は次のいずれかになります。

RichLinkType

リッチリンクのタイプ。今後、他の種類も追加される可能性があります。

列挙型
DRIVE_FILE Google ドライブのリッチリンク タイプ。
CHAT_SPACE Chat スペースのリッチリンク タイプ。たとえば、スペースのスマートチップなどです。

SearchSpacesRequest

クエリに基づいてスペースのリストを検索するリクエスト。

フィールド
use_admin_access

bool

true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.spaces.readonly または chat.admin.spacesOAuth 2.0 スコープが必要です。

現在、この方法は管理者アクセスのみをサポートしているため、このフィールドには true のみが使用できます。

page_size

int32

返されるスペースの最大数。サービスが返す値はこれよりも少ないことがあります。

指定されていない場合は、最大で 100 個のスペースが返されます。

最大値は 1,000 です。1,000 を超える値を使用すると、自動的に 1,000 に変更されます。

page_token

string

前回の search spaces 呼び出しから受け取ったトークン。後続のページを取得するには、このパラメータを指定します。

ページネーションを行う場合、指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致している必要があります。他のパラメータに異なる値を渡すと、予期しない結果になる可能性があります。

query

string

必須。検索クエリ。

次のパラメータを使用して検索できます。

  • create_time
  • customer
  • display_name
  • external_user_allowed
  • last_active_time
  • space_history_state
  • space_type

create_timelast_active_timeRFC-3339 形式のタイムスタンプを受け入れます。サポートされている比較演算子は、=<><=>= です。

customer は必須で、スペースを取得するお客様を指定するために使用されます。サポートされる値は customers/my_customer のみです。

display_nameHAS:)演算子のみを受け入れます。照合するテキストはまずトークン化され、各トークンはスペースの display_name 内の任意のサブストリングとして、大文字と小文字を区別せずに個別に接頭辞照合されます。たとえば、Fun EveFun event または The evening was fun と一致しますが、notFun eventeven とは一致します。

external_user_allowedtrue または false を受け入れます。

space_history_state は、space リソースの historyState フィールドの値のみを受け入れます。

space_type は必須で、有効な値は SPACE のみです。

異なるフィールドでは、AND 演算子のみがサポートされます。有効な例は space_type = "SPACE" AND display_name:"Hello" で、無効な例は space_type = "SPACE" OR display_name:"Hello" です。

同じフィールド内で、space_typeAND 演算子と OR 演算子をサポートしていません。display_name、space_history_state、external_user_allowed は OR 演算子のみサポートしています。last_active_timecreate_time は、AND 演算子と OR 演算子の両方をサポートしています。AND は、last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00" などの区間を表す場合にのみ使用できます。

次のクエリの例は有効です。

customer = "customers/my_customer" AND space_type = "SPACE"

customer = "customers/my_customer" AND space_type = "SPACE" AND
display_name:"Hello World"

customer = "customers/my_customer" AND space_type = "SPACE" AND
(last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(display_name:"Hello World" OR display_name:"Fun event") AND
(last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(create_time > "2019-01-01T00:00:00+00:00" AND create_time <
"2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
(space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
order_by

string

省略可。スペースのリストの並べ替え順序。

並べ替えに使用できる属性は次のとおりです。

  • membership_count.joined_direct_human_user_count - スペースに直接参加した人間のユーザー数を示します。
  • last_active_time - このスペースのいずれかのトピックに最後に対象アイテムが追加された時刻を示します。
  • create_time - スペースの作成時刻を示します。

有効な並べ替えオペレーションの値は次のとおりです。

  • 昇順の場合は ASC です。デフォルト値。

  • DESC: 降順。

サポートされている構文は次のとおりです。

  • membership_count.joined_direct_human_user_count DESC
  • membership_count.joined_direct_human_user_count ASC
  • last_active_time DESC
  • last_active_time ASC
  • create_time DESC
  • create_time ASC

SearchSpacesResponse

検索スペース リクエストに対応するスペースのリストを含むレスポンス。

フィールド
spaces[]

Space

リクエストされたスペースのページ。

next_page_token

string

次のページを取得するために使用できるトークン。このフィールドが空の場合、後続のページはありません。

total_size

int32

クエリに一致するスペースの総数(すべてのページにわたる)。結果が 10,000 スペースを超える場合、この値は推定値です。

SetUpSpaceRequest

スペースを作成して、指定したユーザーを追加するようリクエストします。

フィールド
space

Space

必須。Space.spaceType 項目は必須です。

スペースを作成するには、Space.spaceTypeSPACE に設定し、Space.displayName を設定します。スペースの設定時にエラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

グループ チャットを作成するには、Space.spaceTypeGROUP_CHAT に設定します。Space.displayName は設定しないでください。

人間間の 1 対 1 の会話を作成するには、Space.spaceTypeDIRECT_MESSAGE に設定し、Space.singleUserBotDmfalse に設定します。Space.displayName または Space.spaceDetails は設定しないでください。

人間と呼び出し元の Chat アプリとの 1 対 1 の会話を作成するには、Space.spaceTypeDIRECT_MESSAGE に、Space.singleUserBotDmtrue に設定します。Space.displayName または Space.spaceDetails は設定しないでください。

DIRECT_MESSAGE スペースがすでに存在する場合は、新しいスペースを作成する代わりに、そのスペースが返されます。

request_id

string

省略可。このリクエストの一意の識別子。ランダムな UUID を使用することをおすすめします。既存のリクエスト ID を指定すると、新しいスペースが作成されるのではなく、その ID で作成されたスペースが返されます。同じ Chat アプリの既存のリクエスト ID を指定して、認証済みのユーザーが異なると、エラーが返されます。

memberships[]

Membership

省略可。スペースに参加するよう招待する Google Chat ユーザーまたはグループ。呼び出し元のユーザーは自動的に追加されるため、省略します。

現在、このセットでは(呼び出し元に加えて)最大 20 個のメンバーシップが許可されています。

人間のメンバーシップの場合、Membership.member フィールドには、name が入力された user(形式: users/{user})を含め、typeUser.Type.HUMAN に設定する必要があります。スペースの設定時にのみ、人間のユーザーを追加できます(Chat アプリの追加は、呼び出し元のアプリでのダイレクト メッセージの設定でのみサポートされます)。ユーザーのメールアドレスを {user} のエイリアスとして使用してメンバーを追加することもできます。たとえば、user.nameusers/example@gmail.com です。Gmail ユーザーまたは外部 Google Workspace ドメインのユーザーを招待するには、{user} にユーザーのメールアドレスを使用する必要があります。

Google グループのメンバーシップの場合、Membership.group_member フィールドに name が入力された group を含める必要があります(形式は groups/{group})。Google グループを追加できるのは、Space.spaceTypeSPACE に設定した場合のみです。

Space.spaceTypeSPACE に設定する場合は省略可。

Space.spaceTypeGROUP_CHAT に設定する場合は、少なくとも 2 つのメンバーシップとともに必須です。

人間のユーザーで Space.spaceTypeDIRECT_MESSAGE に設定する場合、1 つのメンバーシップとともに必須です。

人間と呼び出し元の Chat アプリとの 1 対 1 の会話を作成する場合は空にする必要があります(Space.spaceTypeDIRECT_MESSAGE に、Space.singleUserBotDmtrue に設定する場合)。

SlashCommand

Google Chat のスラッシュ コマンド

フィールド
command_id

int64

呼び出されたスラッシュ コマンドの ID。

SlashCommandMetadata

スラッシュ コマンド(/)のアノテーション メタデータ。

フィールド
bot

User

コマンドが呼び出された Chat アプリ。

type

Type

スラッシュ コマンドのタイプ。

command_name

string

呼び出されたスラッシュ コマンドの名前。

command_id

int64

呼び出されたスラッシュ コマンドのコマンド ID。

triggers_dialog

bool

スラッシュ コマンドがダイアログ用かどうかを示します。

タイプ

列挙型
TYPE_UNSPECIFIED 列挙型のデフォルト値。使用しないでください。
ADD スペースに Chat アプリを追加する。
INVOKE スペースでスラッシュ コマンドを呼び出す。

スペース

Google Chat のスペース。スペースは、複数のユーザー間の会話や、ユーザーと Chat アプリ間の 1 対 1 のメッセージです。

フィールド
name

string

ID。Space のリソース名。

形式: spaces/{space}

ここで、{space} はスペースにシステムによって割り当てられた ID を表します。スペース ID は、spaces.list() メソッドを呼び出すか、スペースの URL から取得できます。たとえば、スペースの URL が https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA の場合、スペース ID は AAAAAAAAA です。

type
(deprecated)

Type

出力専用。非推奨: 代わりに space_type を使用してください。スペースのタイプ。

space_type

SpaceType

省略可。スペースのタイプ。スペースを作成するとき、またはスペースのスペースタイプを更新するときに必要です。他の用途の場合は出力のみ。

single_user_bot_dm

bool

省略可。スペースが Chat アプリと 1 人のユーザーとの DM かどうか。

threaded
(deprecated)

bool

出力専用。非推奨: 代わりに spaceThreadingState を使用してください。このスペースでメッセージがスレッド形式になっているかどうか。

display_name

string

省略可。スペースの表示名。spaceTypeSPACEスペースを作成する場合は必須です。スペースの作成時や displayName の更新時にエラー メッセージ ALREADY_EXISTS が表示された場合は、別の displayName を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

ダイレクト メッセージの場合、このフィールドは空になることがあります。

最大 128 文字をサポートします。

external_user_allowed

bool

省略可。変更不可。このスペースで Google Chat のすべてのユーザーをメンバーとして許可するかどうか。Google Workspace 組織でスペースを作成するときに入力します。次の条件でスペースを作成する場合は、このフィールドを省略します。

  • 認証されたユーザーが一般ユーザー アカウント(管理対象外のユーザー アカウント)を使用している。デフォルトでは、一般ユーザーのアカウントで作成されたスペースには、すべての Google Chat ユーザーがアクセスできます。

既存のスペースの場合、このフィールドは出力専用です。

space_threading_state

SpaceThreadingState

出力専用。Chat スペースのスレッド状態。

space_details

SpaceDetails

省略可。スペースの詳細(説明やルールなど)。

space_history_state

HistoryState

省略可。このスペース内のメッセージとスレッドのメッセージ履歴の状態。

import_mode

bool

省略可。このスペースが、Google Workspace へのデータ移行の一環として Import Mode に作成されたかどうか。スペースのインポート中は、インポートが完了するまでユーザーには表示されません。

Import Mode でスペースを作成するには、ユーザー認証が必要です。

create_time

Timestamp

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

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

spaceTypeGROUP_CHAT または SPACE の場合にのみ出力に入力されます。

last_active_time

Timestamp

出力専用。スペース内の最後のメッセージのタイムスタンプ。

admin_installed

bool

出力専用。Chat アプリを使用したダイレクト メッセージ(DM)スペースの場合、そのスペースが Google Workspace 管理者によって作成されたかどうか。管理者は、組織内のユーザーに代わって Chat アプリをインストールしてダイレクト メッセージを設定できます。

管理者によるインストールをサポートするには、Chat アプリにダイレクト メッセージ機能が必要です。

membership_count

MembershipCount

出力専用。メンバータイプ別にグループ化された、参加しているメンバーシップの数。space_typeSPACEDIRECT_MESSAGEGROUP_CHAT の場合に入力されます。

access_settings

AccessSettings

省略可。スペースのアクセス設定を指定します。space_typeSPACE の場合にのみ入力されます。

space_uri

string

出力専用。ユーザーがスペースにアクセスするための URI。

import_mode_expire_time

Timestamp

出力専用。インポート モードのままの場合に、スペースがシステムによって自動的に削除される日時。

インポート モードで作成された各スペースは、この有効期限の前に spaces.completeImport を使用してこのモードを終了する必要があります。

このフィールドは、インポート モードで作成されたスペースにのみ入力されます。

customer

string

省略可。変更不可。スペースのドメインのお客様 ID。アプリ認証でスペースを作成し、SpaceTypeSPACE の場合にのみ必要です。それ以外の場合は設定しないでください。

customers/{customer} 形式で指定します。ここで、customer は [Admin SDK の顧客リソース]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers)id です。限定公開アプリは、customers/my_customer エイリアスを使用して、アプリと同じ Google Workspace 組織にスペースを作成することもできます。

DM の場合、このフィールドは入力されません。

共用体フィールド space_permission_settings。スペースの権限設定を表します。space_typeSPACE の場合にのみ入力されます。

ユーザー認証が必要です。space_permission_settings は次のいずれかになります。

predefined_permission_settings

PredefinedPermissionSettings

省略可。入力のみのスペースの権限の事前設定。スペースを作成するときにのみ入力します。このフィールドが設定されていない場合、コラボレーション スペースが作成されます。スペースを作成すると、設定が PermissionSettings フィールドに入力されます。

permission_settings

PermissionSettings

省略可。既存のスペースのスペース権限の設定。スペースの権限設定を正確に更新するための入力。既存の権限設定が置き換えられます。出力には、現在の権限設定が一覧表示されます。

AccessSettings

スペースのアクセス設定を表します。

フィールド
access_state

AccessState

出力専用。スペースのアクセス状態を示します。

audience

string

省略可。スペースを検索、参加、プレビューできる対象グループのリソース名。設定されていない場合、スペースに個別に招待または追加されたユーザーまたは Google グループのみがスペースにアクセスできます。詳しくは、スペースを対象グループに見つけやすくするをご覧ください。

形式: audiences/{audience}

Google Workspace 組織のデフォルトの対象グループを使用するには、audiences/default に設定します。

対象ユーザーの読み取りは、次の機能をサポートしています。

アプリ認証chat.bot スコープを使用する場合、このフィールドは入力されません。

対象グループを設定するには、ユーザー認証が必要です。

AccessState

スペースのアクセス状態を表します。

列挙型
ACCESS_STATE_UNSPECIFIED アクセス権の状態が不明であるか、この API でサポートされていません。
PRIVATE スペースを検出してアクセスできるのは、他のユーザーまたは Google Workspace 管理者によって個別に追加または招待されたユーザーまたは Google グループのみです。
DISCOVERABLE

スペースの管理者が、対象ユーザーにスペースへのアクセス権を付与している。スペースに個別に追加または招待されたユーザーや Google グループも、スペースを見つけてアクセスできます。詳しくは、特定のユーザーがスペースを見つけられるようにするをご覧ください。

検出可能なスペースを作成するには、ユーザー認証が必要です。

MembershipCount

スペースのメンバーシップ数をカテゴリ別に表します。

フィールド
joined_direct_human_user_count

int32

出力専用。スペースに直接参加した人間のユーザーの数。参加しているグループのメンバーシップによって参加したユーザーはカウントされません。

joined_group_count

int32

出力専用。スペースに直接参加したすべてのグループの数。

PermissionSetting

スペースの権限設定を表します。

フィールド
managers_allowed

bool

省略可。スペースの管理者にこの権限があるかどうか。

members_allowed

bool

省略可。管理者以外のメンバーにこの権限があるかどうか。

PermissionSettings

既存の名前付きスペースを更新するときに指定できる権限設定

スペースの作成時に権限設定を設定するには、リクエストで PredefinedPermissionSettings フィールドを指定します。

フィールド
manage_members_and_groups

PermissionSetting

省略可。スペースのメンバーとグループを管理するための設定。

modify_space_details

PermissionSetting

省略可。スペースの名前、アバター、説明、ガイドラインを更新するための設定。

toggle_history

PermissionSetting

省略可。スペースの履歴のオンとオフを切り替える設定。

use_at_mention_all

PermissionSetting

省略可。スペースで @all を使用する設定。

manage_apps

PermissionSetting

省略可。スペース内のアプリを管理するための設定。

manage_webhooks

PermissionSetting

省略可。スペース内の Webhook を管理するための設定。

post_messages

PermissionSetting

出力専用。スペースにメッセージを投稿するための設定。

reply_messages

PermissionSetting

省略可。スペース内のメッセージに返信するための設定。

PredefinedPermissionSettings

名前付きスペースを作成するときにのみ指定できる、事前定義された権限設定。今後、他の設定も追加される可能性があります。名前付き空間の権限設定の詳細については、空間の詳細をご覧ください。

列挙型
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED 指定なし。使用しないでください。
COLLABORATION_SPACE すべてのメンバーがメッセージを投稿できるコラボレーション スペースに設定する。
ANNOUNCEMENT_SPACE スペースを、スペースの管理者のみがメッセージを投稿できるお知らせスペースに設定する設定。

SpaceDetails

スペースの詳細(説明やルールなど)。

フィールド
description

string

省略可。スペースの説明。たとえば、スペースのディスカッション トピック、機能的な目的、参加者について説明します。

最大 150 文字をサポートします。

guidelines

string

省略可。スペースのルール、期待値、エチケット。

最大 5,000 文字までサポートされます。

SpaceThreadingState

Chat スペースのスレッド状態のタイプを指定します。

列挙型
SPACE_THREADING_STATE_UNSPECIFIED 予約済み。
THREADED_MESSAGES メッセージ スレッドをサポートする名前付きスペース。ユーザーはメッセージに返信する際にスレッド内で返信できます。これにより、返信が元のメッセージのコンテキスト内に保持されます。
GROUPED_MESSAGES 会話がトピック別に整理された名前付きスペース。トピックとその返信はグループ化されます。
UNTHREADED_MESSAGES 2 人間のダイレクト メッセージ(DM)と、3 人以上のグループ会話。

SpaceType

スペースのタイプ。スペースの作成または更新時に必要です。他の用途の場合は出力のみ。

列挙型
SPACE_TYPE_UNSPECIFIED 予約済み。
SPACE メッセージの送信、ファイルの共有、コラボレーションを行う場所です。SPACE には Chat アプリを含めることができます。
GROUP_CHAT 3 人以上のグループ会話。GROUP_CHAT には Chat アプリを含めることができます。
DIRECT_MESSAGE 2 人のユーザー間、またはユーザーと Chat アプリ間の 1 対 1 のメッセージ。

タイプ

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

列挙型
TYPE_UNSPECIFIED 予約済み。
ROOM 2 人以上の人間との会話。
DM 人間と Chat アプリ間の 1 対 1 のダイレクト メッセージ。すべてのメッセージがフラットです。ただし、人間同士のダイレクト メッセージは対象外です。

SpaceBatchUpdatedEventData

スペースの複数の更新に関するイベント ペイロード。

イベントタイプ: google.workspace.chat.space.v1.batchUpdated

フィールド
spaces[]

SpaceUpdatedEventData

更新されたスペースのリスト。

SpaceEvent

Google Chat スペースでの変更やアクティビティを表すイベント。詳しくは、Google Chat のイベントを操作するをご覧ください。

フィールド
name

string

スペース イベントのリソース名。

形式: spaces/{space}/spaceEvents/{spaceEvent}

event_time

Timestamp

イベントが発生した時刻。

event_type

string

スペース イベントのタイプ。各イベントタイプにはバッチ バージョンがあります。これは、短時間に発生したイベントタイプの複数のインスタンスのことです。spaceEvents.list() リクエストの場合は、クエリフィルタでバッチ イベントタイプを省略します。デフォルトでは、サーバーはイベントタイプとそのバッチ バージョンの両方を返します。

メッセージでサポートされているイベントタイプ:

  • 新しいメッセージ: google.workspace.chat.message.v1.created
  • 更新されたメッセージ: google.workspace.chat.message.v1.updated
  • 削除されたメッセージ: google.workspace.chat.message.v1.deleted
  • 複数の新着メッセージ: google.workspace.chat.message.v1.batchCreated
  • 複数の更新メッセージ: google.workspace.chat.message.v1.batchUpdated
  • 複数の削除済みメッセージ: google.workspace.chat.message.v1.batchDeleted

メンバーシップでサポートされているイベントタイプ:

  • 新しいメンバーシップ: google.workspace.chat.membership.v1.created
  • 更新されたメンバーシップ: google.workspace.chat.membership.v1.updated
  • 削除されたメンバーシップ: google.workspace.chat.membership.v1.deleted
  • 複数の新規メンバーシップ: google.workspace.chat.membership.v1.batchCreated
  • 複数のメンバーシップの更新: google.workspace.chat.membership.v1.batchUpdated
  • 複数の削除済みメンバーシップ: google.workspace.chat.membership.v1.batchDeleted

リアクションでサポートされているイベントタイプ:

  • 新しいリアクション: google.workspace.chat.reaction.v1.created
  • 削除されたリアクション: google.workspace.chat.reaction.v1.deleted
  • 複数の新しいリアクション: google.workspace.chat.reaction.v1.batchCreated
  • 複数のリアクションを削除した場合: google.workspace.chat.reaction.v1.batchDeleted

スペースに関するサポートされているイベントタイプ:

  • 更新されたスペース: google.workspace.chat.space.v1.updated
  • 複数のスペースの更新: google.workspace.chat.space.v1.batchUpdated

共用体フィールド payload

payload は次のいずれかになります。

message_created_event_data

MessageCreatedEventData

新しいメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.created

message_updated_event_data

MessageUpdatedEventData

更新されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.updated

message_deleted_event_data

MessageDeletedEventData

削除されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.deleted

message_batch_created_event_data

MessageBatchCreatedEventData

複数の新しいメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.batchCreated

message_batch_updated_event_data

MessageBatchUpdatedEventData

複数の更新されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.batchUpdated

message_batch_deleted_event_data

MessageBatchDeletedEventData

複数の削除されたメッセージのイベント ペイロード。

イベントタイプ: google.workspace.chat.message.v1.batchDeleted

space_updated_event_data

SpaceUpdatedEventData

スペースの更新イベント ペイロード。

イベントタイプ: google.workspace.chat.space.v1.updated

space_batch_updated_event_data

SpaceBatchUpdatedEventData

スペースの複数の更新に関するイベント ペイロード。

イベントタイプ: google.workspace.chat.space.v1.batchUpdated

membership_created_event_data

MembershipCreatedEventData

新しいメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.created

membership_updated_event_data

MembershipUpdatedEventData

更新されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.updated

membership_deleted_event_data

MembershipDeletedEventData

削除されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.deleted

membership_batch_created_event_data

MembershipBatchCreatedEventData

複数の新しいメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.batchCreated

membership_batch_updated_event_data

MembershipBatchUpdatedEventData

複数の更新されたメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.batchUpdated

membership_batch_deleted_event_data

MembershipBatchDeletedEventData

複数の削除済みメンバーシップのイベント ペイロード。

イベントタイプ: google.workspace.chat.membership.v1.batchDeleted

reaction_created_event_data

ReactionCreatedEventData

新しいリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.created

reaction_deleted_event_data

ReactionDeletedEventData

削除されたリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.deleted

reaction_batch_created_event_data

ReactionBatchCreatedEventData

複数の新しいリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.batchCreated

reaction_batch_deleted_event_data

ReactionBatchDeletedEventData

複数の削除されたリアクションのイベント ペイロード。

イベントタイプ: google.workspace.chat.reaction.v1.batchDeleted

SpaceNotificationSetting

スペース内のユーザーの通知設定。

フィールド
name

string

ID。スペースの通知設定のリソース名。形式: users/{user}/spaces/{space}/spaceNotificationSetting

notification_setting

NotificationSetting

通知設定。

mute_setting

MuteSetting

スペースの通知のミュート設定。

MuteSetting

スペースの通知ミュート設定の種類。

列挙型
MUTE_SETTING_UNSPECIFIED 予約済み。
UNMUTED ユーザーには、通知設定に基づいてそのスペースに関する通知が届きます。
MUTED 通知設定に関係なく、ユーザーはスペースに関する通知を受け取ることはありません。

NotificationSetting

通知設定の種類。

列挙型
NOTIFICATION_SETTING_UNSPECIFIED 予約済み。
ALL 通知は、名前リンク、フォロー中のスレッド、新しいスレッドの最初のメッセージによってトリガーされます。ユーザーが手動でフォローを解除しない限り、新しいスレッドはすべて自動的にフォローされます。
MAIN_CONVERSATIONS 通知は、名前リンク付きメッセージ、フォロー中のスレッド、新しいスレッドの最初のメッセージによってトリガーされます。1 対 1 のダイレクト メッセージには使用できません。
FOR_YOU 通知は、名前リンクとフォロー中のスレッドによってトリガーされます。1 対 1 のダイレクト メッセージには使用できません。
OFF 通知がオフになっている。

SpaceReadState

スペース内のユーザーの既読ステータス。既読と未読のメッセージを識別するために使用されます。

フィールド
name

string

Space の読み取り状態のリソース名。

形式: users/{user}/spaces/{space}/spaceReadState

last_read_time

Timestamp

省略可。ユーザーのスペースの読み取りステータスが更新された時刻。通常、これは最後に読まれたメッセージのタイムスタンプか、スペース内の最後に読まれた位置をマークするためにユーザーが指定したタイムスタンプに対応しています。

SpaceUpdatedEventData

更新されたスペースのイベント ペイロード。

イベントタイプ: google.workspace.chat.space.v1.updated

フィールド
space

Space

更新されたスペース。

スレッド

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

メッセージを作成するときにスレッドを指定する場合は、messageReplyOption フィールドを設定して、一致するスレッドが見つからない場合の処理を決定できます。

フィールド
name

string

ID。スレッドのリソース名。

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

thread_key

string

省略可。スレッドの作成または更新用の入力。それ以外の場合は、出力のみ。スレッドの ID。最大 4,000 文字をサポートします。

この ID は、設定した Chat アプリに固有のものです。たとえば、複数の Chat アプリが同じスレッドキーを使用してメッセージを作成した場合、メッセージは異なるスレッドに投稿されます。ユーザーまたは別の Chat アプリによって作成されたスレッドに返信するには、代わりにスレッドの name フィールドを指定します。

ThreadReadState

スレッド内のユーザーの読み取りステータス。未読と既読のメッセージを識別するために使用されます。

フィールド
name

string

スレッドの読み取り状態のリソース名。

形式: users/{user}/spaces/{space}/threads/{thread}/threadReadState

last_read_time

Timestamp

ユーザーのスレッドの読み取りステータスが更新された時刻。通常、これはスレッド内で最後に読み取られたメッセージのタイムスタンプに対応しています。

UpdateMembershipRequest

メンバーシップの更新リクエスト メッセージ。

フィールド
membership

Membership

必須。更新するメンバーシップ。update_mask で指定されたフィールドのみが更新されます。

update_mask

FieldMask

必須。更新するフィールドパス。複数の値をカンマで区切るか、* を使用してすべてのフィールドパスを更新します。

現在サポートされているフィールドパスは次のとおりです。

  • role
use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships OAuth 2.0 スコープが必要です。

UpdateMessageRequest

メッセージを更新するリクエスト。

フィールド
message

Message

必須。フィールドが更新されたメッセージ。

update_mask

FieldMask

必須。更新するフィールドパス。複数の値をカンマで区切るか、* を使用してすべてのフィールドパスを更新します。

現在サポートされているフィールドパスは次のとおりです。

allow_missing

bool

省略可。true とメッセージが見つからない場合は、新しいメッセージが作成され、updateMask は無視されます。指定したメッセージ ID はクライアントが割り当てた ID である必要があります。そうでない場合、リクエストは失敗します。

UpdateSpaceNotificationSettingRequest

スペースの通知設定を更新するリクエスト。呼び出し元のユーザーの通知設定の更新のみをサポートします。

フィールド
space_notification_setting

SpaceNotificationSetting

必須。スペースの通知設定のリソース名は、users/{user}/spaces/{space}/spaceNotificationSetting の形式で入力する必要があります。update_mask で指定されたフィールドのみが更新されます。

update_mask

FieldMask

必須。サポートされているフィールドパス: - notification_setting - mute_setting

UpdateSpaceReadStateRequest

UpdateSpaceReadState API のリクエスト メッセージ。

フィールド
space_read_state

SpaceReadState

必須。スペースの読み取り状態と更新するフィールド。

呼び出し元のユーザーの読み取りステータスの更新のみをサポートします。

呼び出し元のユーザーを参照するには、次のいずれかを設定します。

  • me エイリアス。例: users/me/spaces/{space}/spaceReadState

  • Workspace のメールアドレス。たとえば、users/user@example.com/spaces/{space}/spaceReadState です。

  • ユーザー ID。たとえば、users/123456789/spaces/{space}/spaceReadState です。

形式: users/{user}/spaces/{space}/spaceReadState

update_mask

FieldMask

必須。更新するフィールドパス。現在サポートされているフィールドパスは次のとおりです。

  • last_read_time

last_read_time が最新のメッセージの作成時間より前の場合、スペースは UI で未読として表示されます。

スペースを既読としてマークするには、last_read_time を最新のメッセージ作成時間より後の値(大きい値)に設定します。last_read_time は、最新のメッセージ作成時間に合わせて強制変換されます。スペースの未読ステータスは、スペースの最上位の会話に表示されるメッセージの未読ステータスにのみ影響します。スレッド内の返信は、このタイムスタンプの影響を受けず、スレッドの読み取り状態に依存します。

UpdateSpaceRequest

1 つのスペースを更新するリクエスト。

フィールド
space

Space

必須。更新するフィールドを含む Space。Space.name には spaces/{space} の形式で値を入力する必要があります。update_mask で指定されたフィールドのみが更新されます。

update_mask

FieldMask

必須。更新するフィールドパス(複数ある場合はカンマで区切ります)。

スペースの次のフィールドを更新できます。

space_details: スペースの説明を更新します。最大 150 文字をサポートします。

display_name: spaceType フィールドが SPACE であるスペースの表示名の更新のみをサポートします。エラー メッセージ ALREADY_EXISTS が表示された場合は、別の値を試してください。Google Workspace 組織内の既存のスペースで、この表示名がすでに使用されている可能性があります。

space_type: GROUP_CHAT スペースタイプを SPACE に変更することのみをサポートします。更新マスクに space_type とともに display_name を含め、指定されたスペースに空でない表示名と SPACE スペースタイプがあることを確認します。既存のスペースにすでに SPACE 型が含まれている場合、表示名を更新するときに、指定されたスペースに space_type マスクと SPACE 型を含めるかどうかは任意です。他の方法でスペースタイプを更新しようとすると、引数が無効というエラーが発生します。space_typeuseAdminAccess ではサポートされていません。

space_history_state: スペースの履歴をオンまたはオフにして、スペースの履歴設定を更新します。Google Workspace 組織で履歴設定が有効になっている場合にのみサポートされます。スペースの履歴の状態を更新するには、リクエストで他のフィールド マスクをすべて省略する必要があります。space_history_stateuseAdminAccess ではサポートされていません。

access_settings.audience: spaceType フィールドが SPACE のネームド スペースで、スペースを検出してスペースに参加したり、メッセージをプレビューしたりできるユーザーのアクセス設定を更新します。既存のスペースに対象グループがある場合は、このフィールドマスクの値を省略して、対象グループを削除し、スペースへのアクセスを制限できます。スペースのアクセス設定を更新するには、認証を行うユーザーがスペース マネージャーであり、リクエスト内の他のフィールド マスクをすべて省略する必要があります。スペースがインポート モードの場合、このフィールドを更新することはできません。詳しくは、特定のユーザーがスペースを見つけられるようにするをご覧ください。access_settings.audienceuseAdminAccess ではサポートされていません。

permission_settings: スペースの権限設定の変更をサポートします。権限設定を更新する場合は、permissionSettings フィールド マスクのみを指定できます。他のフィールド マスクを同時に更新することはできません。permissionSettingsuseAdminAccess ではサポートされていません。サポートされているフィールド マスクは次のとおりです。

  • permission_settings.manageMembersAndGroups
  • permission_settings.modifySpaceDetails
  • permission_settings.toggleHistory
  • permission_settings.useAtMentionAll
  • permission_settings.manageApps
  • permission_settings.manageWebhooks
  • permission_settings.replyMessages
use_admin_access

bool

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。

chat.admin.spaces OAuth 2.0 スコープが必要です。

一部の FieldMask 値は、管理者権限を使用してサポートされていません。詳しくは、update_mask の説明をご覧ください。

ユーザー

Google Chat のユーザー。リクエストからの出力として返される場合、Chat アプリがユーザーとして認証すると、User リソースの出力にはユーザーの nametype のみが入力されます。

フィールド
name

string

Google Chat user のリソース名。

形式: users/{user}users/app は、呼び出し元のアプリ bot ユーザーのエイリアスとして使用できます。

human users の場合、{user} は次のユーザー ID と同じです。

  • People API の Personid です。たとえば、Chat API の users/123456789 は、People API の 123456789 個人プロファイル ID と同じユーザーを表します。

  • Admin SDK Directory API の ユーザーid

  • ユーザーのメールアドレスは、API リクエストで {user} のエイリアスとして使用できます。たとえば、user@example.com の People API の個人プロファイル ID が 123456789 の場合、users/user@example.com をエイリアスとして使用して users/123456789 を参照できます。API から返されるのは、正規のリソース名(users/123456789 など)のみです。

display_name

string

出力専用。ユーザーの表示名。

domain_id

string

ユーザーの Google Workspace ドメインの一意の識別子。

type

Type

ユーザータイプ。

is_anonymous

bool

出力専用。true の場合、ユーザーは削除されているか、プロフィールが表示されません。

タイプ

列挙型
TYPE_UNSPECIFIED 列挙型のデフォルト値。使用しないでください。
HUMAN 人間のユーザー。
BOT Chat アプリのユーザー。

UserMentionMetadata

ユーザーのメンション(@)のアノテーション メタデータ。

フィールド
user

User

お客様が言及した内容。

type

Type

ユーザーのメンションのタイプ。

タイプ

列挙型
TYPE_UNSPECIFIED 列挙型のデフォルト値。使用しないでください。
ADD スペースにユーザーを追加します。
MENTION スペース内でユーザーをメンションする。

WidgetMarkup

ウィジェットは、テキストと画像を表示する UI 要素です。

フィールド
buttons[]

Button

ボタンのリスト。Buttons も oneof data です。これらのフィールドはどちらか 1 つのみを設定する必要があります。

共用体フィールド dataWidgetMarkup には次のいずれかの項目のみを含めることができます。複数の WidgetMarkup フィールドを使用して、より多くのアイテムを表示できます。data は次のいずれかになります。
text_paragraph

TextParagraph

このウィジェットにテキストの段落を表示します。

image

Image

このウィジェットに画像を表示します。

key_value

KeyValue

このウィジェットに Key-Value アイテムを表示します。

ボタン

ボタン。テキスト ボタンまたは画像ボタンを使用できます。

フィールド

共用体フィールド type

type は次のいずれかになります。

text_button

TextButton

テキストと onclick アクションを含むボタン。

image_button

ImageButton

画像と onclick アクションを含むボタン。

FormAction

フォーム アクションは、フォームが送信されたときの動作を記述します。たとえば、Apps Script を呼び出してフォームを処理できます。

フィールド
action_method_name

string

メソッド名は、フォームのどの部分がフォーム送信をトリガーしたかを特定するために使用されます。この情報は、カードのクリック イベントの一部として Chat アプリにエコーバックされます。共通の動作をトリガーする複数の要素に同じメソッド名を使用できます。

parameters[]

ActionParameter

アクション パラメータのリスト。

ActionParameter

アクション メソッドが呼び出されるときに指定する文字列パラメータのリスト。たとえば、3 つのスヌーズ ボタン(今すぐスヌーズ、1 日スヌーズ、来週スヌーズ)があるとします。action method = snooze() を使用して、スヌーズ タイプとスヌーズ時間を文字列パラメータのリストで渡すことができます。

フィールド
key

string

アクション スクリプトのパラメータの名前。

value

string

パラメータ値。

アイコン

サポートされているアイコンのセット。

列挙型
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

画像

URL で指定され、onclick アクションを設定できる画像。

フィールド
image_url

string

画像の URL です。

on_click

OnClick

onclick アクション。

aspect_ratio

double

この画像のアスペクト比(幅と高さ)。このフィールドを使用すると、画像の読み込みを待機している間に、画像に適切な高さを予約できます。画像の組み込みのアスペクト比をオーバーライドするものではありません。設定されていない場合、サーバーはイメージをプリフェッチして埋めます。

ImageButton

onclick アクションを含む画像ボタン。

フィールド
on_click

OnClick

onclick アクション。

name

string

ユーザー補助に使用されるこの image_button の名前。この名前が指定されていない場合は、デフォルト値が提供されます。

共用体フィールド icons。アイコンは、Icon enum または URL で指定できます。icons は次のいずれかになります。
icon

Icon

Chat API から提供されたアイコンをインデックスする enum で指定されたアイコン。

icon_url

string

URL で指定されたアイコン。

KeyValue

UI 要素には、キー(ラベル)と値(コンテンツ)が含まれています。この要素には、onclick ボタンなどのアクションも含めることができます。

フィールド
top_label

string

上部ラベルのテキスト。書式設定されたテキストがサポートされています。テキストの書式設定の詳細については、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

content

string

コンテンツのテキスト。書式設定されたテキストがサポートされており、常に必須です。テキストの書式設定の詳細については、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

content_multiline

bool

コンテンツを複数行にするかどうか。

bottom_label

string

下部ラベルのテキスト。書式設定されたテキストがサポートされています。テキストの書式設定の詳細については、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

on_click

OnClick

onclick アクション。クリックできるのは、上部ラベル、下部ラベル、コンテンツ領域のみです。

共用体フィールド icons。アイコン top_labelbottom_label の少なくとも 1 つを定義する必要があります。icons は次のいずれかになります。
icon

Icon

Chat API によって対応するアイコン画像に置き換えられる列挙型の値。

icon_url

string

URL で指定されたアイコン。

共用体フィールド control。コントロール ウィジェット。button または switch_widget を設定できますが、両方は設定できません。control は次のいずれかになります。
button

Button

クリックしてアクションをトリガーできるボタン。

OnClick

onclick アクション(リンクを開くなど)。

フィールド

共用体フィールド data

data は次のいずれかになります。

action

FormAction

フォーム アクションは、この onclick アクションによってトリガーされます(指定されている場合)。

TextButton

テキストと onclick アクションを含むボタン。

フィールド
text

string

ボタンのテキスト。

on_click

OnClick

ボタンの onclick アクション。

TextParagraph

段落のテキスト。書式設定されたテキストがサポートされています。テキストの書式設定の詳細については、Google Chat アプリでのテキストの書式設定Google Workspace アドオンでのテキストの書式設定をご覧ください。

フィールド
text

string