Method: spaces.messages.update
یک پیام را به روز می کند. بین روش های patch
و update
تفاوت وجود دارد. متد patch
از یک درخواست patch
استفاده می کند در حالی که روش update
از یک درخواست put
استفاده می کند. توصیه می کنیم از روش patch
استفاده کنید. برای مثال، بهروزرسانی یک پیام را ببینید.
از انواع احراز هویت زیر پشتیبانی می کند:
هنگام استفاده از احراز هویت برنامه، درخواستها فقط میتوانند پیامهای ایجاد شده توسط برنامه چت را بهروزرسانی کنند.
درخواست HTTP
PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
message.name | string شناسه. نام منبع پیام قالب: spaces/{space}/messages/{message} جایی که {space} شناسه فضایی است که پیام در آن پست شده است و {message} یک شناسه اختصاص داده شده توسط سیستم برای پیام است. برای مثال، spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB . اگر هنگام ایجاد پیام، یک شناسه سفارشی تنظیم کنید، میتوانید با جایگزین کردن {message} با مقدار فیلد clientAssignedMessageId ، از این شناسه برای تعیین پیام در یک درخواست استفاده کنید. به عنوان مثال، spaces/AAAAAAAAAAA/messages/client-custom-name . برای جزئیات، به نام پیام مراجعه کنید. |
پارامترهای پرس و جو
پارامترها |
---|
updateMask | string ( FieldMask format) مورد نیاز. مسیرهای میدانی برای به روز رسانی چندین مقدار را با کاما جدا کنید یا از * برای به روز رسانی تمام مسیرهای فیلد استفاده کنید. مسیرهای فیلد پشتیبانی شده در حال حاضر: |
allowMissing | boolean اختیاری. اگر true و پیام پیدا نشد، یک پیام جدید ایجاد می شود و updateMask نادیده گرفته می شود. شناسه پیام مشخص شده باید به مشتری اختصاص داده شود در غیر این صورت درخواست انجام نمی شود. |
درخواست بدن
بدنه درخواست شامل یک نمونه از Message
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Message
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chat.bot
-
https://www.googleapis.com/auth/chat.import
-
https://www.googleapis.com/auth/chat.messages
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی."],[[["Updates a Google Chat message using the `PUT` method, preferably with the `patch` approach for partial modifications."],["Requires providing the message's resource name in the URL path for identification."],["Allows specifying fields to update using `updateMask` and supports creating a new message if the original is missing with `allowMissing` set to `true`."],["Authentication can be done using app authentication or user authentication, with app authentication restricting updates to messages created by the calling Chat app."],["Needs authorization with specific OAuth scopes like `chat.bot`, `chat.import`, or `chat.messages`."]]],["This describes updating messages in Google Chat using either `patch` or `put` requests, recommending `patch`. The `PUT` request uses the format `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. Updating requires specifying the `message.name` path parameter and the `updateMask` query parameter to identify fields to modify. Optional `allowMissing` creates a new message if one is not found. The request and response body are `Message` instances. Authorization requires specific OAuth scopes. App authentication can update messages from the calling app only.\n"]]