Method: spaces.messages.delete

یک پیام را حذف می کند. برای مثال، حذف یک پیام را ببینید.

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

درخواست HTTP

DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

ضروری. نام منبع پیام

قالب: spaces/{space}/messages/{message}

اگر یک شناسه سفارشی برای پیام خود تنظیم کرده‌اید، می‌توانید از مقدار فیلد clientAssignedMessageId برای {message} استفاده کنید. برای جزئیات، به نام پیام مراجعه کنید.

پارامترهای پرس و جو

مولفه های
force

boolean

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

فقط هنگام احراز هویت به عنوان کاربر اعمال می شود. هنگام احراز هویت به عنوان یک برنامه چت تأثیری ندارد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ خالی است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

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