این راهنما نحوه استفاده از متد delete() در منبع Message از API چت گوگل برای حذف یک پیام متنی یا کارتی را توضیح میدهد.
در API چت، یک پیام چت توسط منبع Message نمایش داده میشود. در حالی که کاربران چت فقط میتوانند پیامهایی حاوی متن ارسال کنند، برنامههای چت میتوانند از بسیاری از ویژگیهای پیامرسانی دیگر، از جمله نمایش رابطهای کاربری ایستا یا تعاملی، جمعآوری اطلاعات از کاربران و ارسال پیامها به صورت خصوصی، استفاده کنند. برای کسب اطلاعات بیشتر در مورد ویژگیهای پیامرسانی موجود برای API چت، به نمای کلی پیامهای Google Chat مراجعه کنید.
با احراز هویت برنامه ، میتوانید از این روش برای حذف پیامی که برنامه چت ارسال کرده است استفاده کنید. با احراز هویت کاربر ، میتوانید از این روش برای حذف پیامی که کاربر احراز هویت شده ارسال کرده است استفاده کنید. اگر کاربر، مدیر فضای آن فضا باشد، ممکن است بتوانید پیامی را که سایر اعضای فضا ارسال کردهاند نیز حذف کنید. برای اطلاعات بیشتر، به «درباره نقش خود به عنوان مدیر فضا بیاموزید» مراجعه کنید.
پیشنیازها
نود جی اس
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری Node.js را نصب کنید.
- بر اساس نحوهی احراز هویت در درخواست API چت گوگل خود، اعتبارنامههای دسترسی ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید. - برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
پایتون
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری پایتون را نصب کنید.
- بر اساس نحوهی احراز هویت در درخواست API چت گوگل خود، اعتبارنامههای دسترسی ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید. - برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
جاوا
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری جاوا را نصب کنید.
- بر اساس نحوهی احراز هویت در درخواست API چت گوگل خود، اعتبارنامههای دسترسی ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید. - برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
اسکریپت برنامهها
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- یک پروژه مستقل Apps Script ایجاد کنید و سرویس چت پیشرفته (Advanced Chat Service) را فعال کنید.
- در این راهنما، شما باید از احراز هویت کاربر یا برنامه استفاده کنید. برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس ایجاد کنید. برای مراحل، به «احراز هویت و مجوز به عنوان یک برنامه چت گوگل» مراجعه کنید.
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
حذف پیام با احراز هویت کاربر
برای حذف پیام با احراز هویت کاربر ، موارد زیر را در درخواست خود وارد کنید:
- دامنه مجوز
chat.messagesرا مشخص کنید. - متد
DeleteMessage()را فراخوانی کنید. -
nameمنبع پیامی که قرار است حذف شود را مشخص کنید.
مثال زیر پیامی را با احراز هویت کاربر حذف میکند:
نود جی اس
پایتون
جاوا
اسکریپت برنامهها
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SPACE_NAME: شناسهای که ازnameفضا گرفته شده است. میتوانید شناسه را با فراخوانی متدListSpaces()یا از URL فضا به دست آورید. -
MESSAGE_NAME: شناسهیnameپیام. میتوانید شناسه را از بدنهی پاسخی که پس از ایجاد پیام به صورت ناهمگام با Chat API برگردانده میشود، یا با نام سفارشی که در زمان ایجاد به پیام اختصاص داده شده است، دریافت کنید.
در صورت موفقیت، بدنه پاسخ خالی است که نشان میدهد پیام حذف شده است.
حذف پیام با احراز هویت برنامه
برای حذف پیام با احراز هویت برنامه ، موارد زیر را در درخواست خود ارسال کنید:
- دامنه مجوز
chat.botرا مشخص کنید. - متد
DeleteMessage()را فراخوانی کنید. -
nameمنبع پیامی که قرار است حذف شود را مشخص کنید.
مثال زیر یک پیام را با احراز هویت برنامه حذف میکند:
نود جی اس
پایتون
جاوا
اسکریپت برنامهها
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SPACE_NAME: شناسهای که ازnameفضا گرفته شده است. میتوانید شناسه را با فراخوانی متدListSpaces()یا از URL فضا به دست آورید. -
MESSAGE_NAME: شناسهیnameپیام. میتوانید شناسه را از بدنهی پاسخی که پس از ایجاد پیام به صورت ناهمگام با Chat API برگردانده میشود، یا با نام سفارشی که در زمان ایجاد به پیام اختصاص داده شده است، دریافت کنید.
در صورت موفقیت، بدنه پاسخ خالی است که نشان میدهد پیام حذف شده است.
مباحث مرتبط
- یک پیام را قالببندی کنید .
- دریافت جزئیات مربوط به یک پیام
- پیامها را در یک فاصله فهرست کنید .
- بهروزرسانی یک پیام
- پیام ارسال کنید .