Trả về tin nhắn trực tiếp hiện có với người dùng đã chỉ định. Nếu không tìm thấy không gian tin nhắn trực tiếp, hãy trả về lỗi 404 NOT_FOUND. Để biết ví dụ, hãy xem phần Tìm tin nhắn trực tiếp.
Với quy trình xác thực ứng dụng, trả về không gian tin nhắn trực tiếp giữa người dùng được chỉ định và ứng dụng Chat đang gọi.
Với quy trình xác thực người dùng, trả về không gian tin nhắn trực tiếp giữa người dùng được chỉ định và người dùng đã xác thực.
Bắt buộc. Tên tài nguyên của người dùng để tìm tin nhắn trực tiếp.
Định dạng: users/{user}, trong đó {user} là id cho người trong API People hoặc id cho người dùng trong API Directory. Ví dụ: nếu mã hồ sơ API People là 123456789, bạn có thể tìm thấy tin nhắn trực tiếp với người đó bằng cách sử dụng users/123456789 làm name. Khi xác thực là người dùng, bạn có thể sử dụng email làm bí danh cho {user}. Ví dụ: users/example@gmail.com, trong đó example@gmail.com là email của người dùng Google Chat.
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Space.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eRetrieves the existing direct message with a specified user or Chat app, returning a 404 error if none is found.\u003c/p\u003e\n"],["\u003cp\u003eSupports both app authentication and user authentication for finding direct messages.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the resource name of the user in the \u003ccode\u003ename\u003c/code\u003e query parameter using specific formats.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e HTTP request to the \u003ccode\u003ehttps://chat.googleapis.com/v1/spaces:findDirectMessage\u003c/code\u003e endpoint with gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with specific OAuth scopes like \u003ccode\u003echat.spaces\u003c/code\u003e, \u003ccode\u003echat.spaces.readonly\u003c/code\u003e, or \u003ccode\u003echat.bot\u003c/code\u003e.\u003c/p\u003e\n"]]],["This outlines how to retrieve an existing direct message space with a specific user via the Chat API. Use a `GET` request to `https://chat.googleapis.com/v1/spaces:findDirectMessage`. Provide the target user's resource name in the `name` query parameter (e.g., `users/123456789`). The request body should be empty. Upon success, the response includes a `Space` resource. Requires either App or User authentication and specific OAuth scopes like `chat.spaces` or `chat.spaces.readonly`.\n"],null,["# Method: spaces.findDirectMessage\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the existing direct message with the specified user. If no direct message space is found, returns a `404 NOT_FOUND` error. For an example, see [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message).\n\nWith [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app), returns the direct message space between the specified user and the calling Chat app.\n\nWith [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), returns the direct message space between the specified user and the authenticated user.\n\nSupports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):\n\n- [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope:\n\n - `https://www.googleapis.com/auth/chat.bot`\n- [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.spaces.readonly`\n - `https://www.googleapis.com/auth/chat.spaces`\n\n### HTTP request\n\n`GET https://chat.googleapis.com/v1/spaces:findDirectMessage`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the user to find direct message with. Format: `users/{user}`, where `{user}` is either the `id` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API profile ID is `123456789`, you can find a direct message with that person by using `users/123456789` as the `name`. When [authenticated as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can use the email as an alias for `{user}`. For example, `users/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Space](/workspace/chat/api/reference/rest/v1/spaces#Space).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.spaces`\n- `https://www.googleapis.com/auth/chat.spaces.readonly`\n- `https://www.googleapis.com/auth/chat.bot`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
