Method: spaces.messages.delete

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

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

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

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

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

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

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

درخواست 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 ، اگر پیامی دارای پاسخ های رشته ای باشد، حذف انجام نمی شود.

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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