Method: spaces.messages.update

• درخواست HTTP
• پارامترهای مسیر
• پارامترهای پرس و جو
• درخواست بدن
• بدن پاسخگو
• محدوده مجوز
• آن را امتحان کنید!

یک پیام را به روز می کند. بین روش های patch و update تفاوت وجود دارد. متد patch از یک درخواست patch استفاده می کند در حالی که روش update از یک درخواست put استفاده می کند. توصیه می کنیم از روش patch استفاده کنید. برای مثال، به‌روزرسانی یک پیام را ببینید.

از انواع احراز هویت زیر پشتیبانی می کند:

• احراز هویت برنامه با محدوده مجوز:

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

• احراز هویت کاربر با یکی از حوزه های مجوز زیر:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import (فقط فضاهای حالت واردات)

هنگام استفاده از احراز هویت برنامه، درخواست‌ها فقط می‌توانند پیام‌های ایجاد شده توسط برنامه چت را به‌روزرسانی کنند.

درخواست 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) مورد نیاز. مسیرهای میدانی برای به روز رسانی چندین مقدار را با کاما جدا کنید یا از * برای به روز رسانی تمام مسیرهای فیلد استفاده کنید. مسیرهای فیلد پشتیبانی شده در حال حاضر: text attachment cards (نیاز به تأیید اعتبار برنامه است.) cardsV2 (نیاز به احراز هویت برنامه دارد.) accessoryWidgets (نیاز به احراز هویت برنامه دارد.) quotedMessageMetadata (فقط اجازه حذف پیام نقل قول را می دهد.)
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.