Method: spaces.findDirectMessage
指定されたユーザーとの既存のダイレクト メッセージを返します。直接メッセージ スペースが見つからない場合、404 NOT_FOUND
エラーが返されます。例については、ダイレクト メッセージを探すをご覧ください。
アプリの認証では、指定したユーザーと呼び出し元の Chat アプリ間のダイレクト メッセージ スペースを返します。
ユーザー認証では、指定したユーザーと認証されたユーザー間の直接メッセージ空間を返します。
// 次のタイプの認証をサポート:
HTTP リクエスト
GET https://chat.googleapis.com/v1/spaces:findDirectMessage
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ |
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 ユーザーのメールアドレスです。
|
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には Space
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.bot
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-11-12 UTC。
[null,null,["最終更新日 2024-11-12 UTC。"],[[["Retrieves the existing direct message with a specified user or Chat app, returning a 404 error if none is found."],["Supports both app authentication and user authentication for finding direct messages."],["Requires providing the resource name of the user in the `name` query parameter using specific formats."],["Uses a `GET` HTTP request to the `https://chat.googleapis.com/v1/spaces:findDirectMessage` endpoint with gRPC Transcoding syntax."],["Needs authorization with specific OAuth scopes like `chat.spaces`, `chat.spaces.readonly`, or `chat.bot`."]]],[]]