عیب‌یابی و رفع خطاهای برنامه Google Chat

این بخش مشکلات رایجی را که می‌توانید هنگام ساخت و آزمایش برنامه‌های چت با آن‌ها مواجه شوید، توضیح می‌دهد.

پیام کارت، گفتگو یا پیش‌نمایش پیوند آنطور که انتظار می‌رود ارائه نمی‌شود یا کار نمی‌کند

برای راهنمایی در مورد عیب‌یابی خطاهای کارت، به عیب‌یابی و تعمیر کارت‌ها مراجعه کنید.

برنامه پاسخ نمی دهد

اگر به برنامه چت پیام دادید و پاسخ داد «برنامه پاسخ نمی‌دهد»، پیکربندی برنامه چت را تأیید کنید:

  1. در کنسول Google Cloud، > محصولات بیشتر > Google Workspace > کتابخانه محصول > Google Chat API > مدیریت > پیکربندی کلیک کنید.

    به Chat API بروید

  2. در زیر وضعیت برنامه ، مطمئن شوید که Live-Distained to users را انتخاب کرده اید.

  3. در بخش ویژگی‌های تعاملی ، مطمئن شوید که تنظیمات برای عملکرد برنامه شما مناسب است. اگر برنامه چت شما با کاربران تعامل دارد، مطمئن شوید که فعال کردن ویژگی‌های تعاملی را روشن کرده‌اید:

    1. اگر برنامه شما به پیام‌ها پاسخ می‌دهد، مطمئن شوید که دریافت پیام‌های ۱:۱ را انتخاب کرده‌اید.
    2. در تنظیمات اتصال ، مطمئن شوید URL نقطه پایانی HTTP ، شناسه استقرار پروژه Apps Script، Cloud Pub/Sub Topic Name یا عامل Dialogflow به درستی تنظیم شده باشد و مستقر شده باشد.
    3. در قسمت Visibility ، مطمئن شوید که کاربران مناسب با آدرس ایمیل یا گروهی در دامنه Google Workspace به برنامه دسترسی دارند. اگر برنامه با Google Workspace Marketplace SDK مستقر شده باشد، تنظیمات نمایان بودن لازم نیست زیرا تنظیمات Google Workspace Marketplace اولویت دارند.

  4. اگر برنامه با Google Workspace Marketplace SDK منتشر شده است، تنظیمات Google Workspace Marketplace را مرور کنید.

  5. روی ذخیره کلیک کنید.

  6. دوباره به برنامه پیام ارسال کنید.

Google Chat API فقط برای کاربران Google Workspace در دسترس است

هنگام پیکربندی برنامه گپ، ممکن است این خطا را دریافت کنید که Google Chat API is only available to Google Workspace users . این پیام به این معنی است که حساب Google که برای پیکربندی Chat API استفاده کرده‌اید، بخشی از یک سازمان Google Workspace نیست. برای ایجاد یک برنامه Chat یا استفاده از Chat API، باید از یک حساب Google Workspace استفاده کنید.

توجه داشته باشید که کاربران چت Google می‌توانند از برنامه‌های چت بدون حساب Google Workspace استفاده کنند. برای آشنایی بیشتر با نحوه کشف و نصب برنامه‌های گپ توسط کاربران، به انتشار برنامه‌های گپ Google مراجعه کنید.

کاربران را می توان از فضاها حذف کرد

اگر یک سرپرست Google Workspace به کاربران اجازه نمی‌دهد سابقه گپ را روشن یا خاموش کنند ، ممکن است مواقعی پیش بیاید که کاربران نتوانند به فضایی بپیوندند یا در آن بمانند به دلیل تضاد بین تنظیمات سطح کاربر که باعث می‌شود تاریخچه گپ روشن یا خاموش شود. فضایی که محیط اجباری در سطح سازمان را به ارث می برد.

به عنوان مثال، اگر یک کاربر تنظیمات سابقه گپ را "روشن" اجباری داشته باشد و یک فضا دارای تنظیمات سابقه گپ اجباری "خاموش" باشد، آن کاربر ممکن است نتواند به این فضا بپیوندد. علاوه بر این، اگر کاربر قبل از تداخل به آن ملحق شده باشد، ممکن است از فضا حذف شود و پس از درگیری پیامی را در فضا ارسال کند.

در این سناریو و سایر سناریوهایی که بین تنظیمات سابقه تداخل وجود دارد، Chat API ممکن است نتواند عضویت ایجاد کند، یا ایجاد یک پیام با احراز هویت کاربر ممکن است کاربر احراز هویت شده با تنظیم تاریخچه گپ متناقض را از فضا حذف کند.

برای کسب اطلاعات بیشتر، رجوع کنید کاربران را می توان از فضاهای موجود در مرکز راهنمای Google Workspace Admin مستثنی کرد .

عیب‌یابی سرویس گفتگوی پیشرفته در Google Apps Script

صفحه Apps Script را در مورد سرویس چت پیشرفته ببینید.

کاربران نمی توانند یک برنامه چت را به یک فضا اضافه کنند

اگر کاربران با پیام خطا مواجه شوند This organization's administrator must allow users to install this Chat app ، این خطا ممکن است به یکی از دلایل زیر ایجاد شود:

  • سازمان برنامه‌های چت را غیرفعال کرده است.
  • سازمان این برنامه چت خاص را به لیست مجاز سازمان اضافه نکرده است.

اگر کاربر هنگام تلاش برای تعامل با یک برنامه گپ با این پیام خطا مواجه شود، ممکن است به دلیل اعطای دسترسی سازمان به یک واحد زیر سازمانی، بدون فعال کردن آن برای واحد سازمانی والد، ایجاد شود.

برای کسب اطلاعات در مورد نحوه حل این مشکل، به کاربران اجازه نصب برنامه‌های گپ را ببینید.

سرپرست باید دامنه مجوز OAuth مورد نیاز را برای این اقدام به برنامه بدهد

هنگام احراز هویت به عنوان یک برنامه چت ، ممکن است خطای زیر را دریافت کنید:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

این پیام خطا به این معنی است که یک سرپرست Google Workspace هنوز برای برنامه Chat برای استفاده از محدوده‌های مجوزی که با نام https://www.googleapis.com/auth/chat.app.* شروع می‌شود، یک بار تأیید نکرده است.

برای رفع خطا:

  • از سرپرست Google Workspace بخواهید تا برنامه چت شما را تأیید کند . هنگام رسیدگی به این خطا در منطق برنامه Chat خود، پیامی ارسال کنید که اعلام کند برنامه Chat برای انجام عملکرد درخواستی به تأیید سرپرست نیاز دارد، شاید: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • اگر روش Chat API از محدوده مجوز https://www.googleapis.com/auth/chat.bot پشتیبانی می‌کند که به تأیید سرپرست نیاز ندارد، به جای آن از آن استفاده کنید. برای بررسی اینکه یک روش از کدام حوزه مجوز پشتیبانی می‌کند، به برنامه‌های Google Chat و درخواست‌های API Chat Google Authenticate و مجوز دادن مراجعه کنید.

عیب یابی خطاهای Cloud Function

اگر برنامه چت با توابع Cloud اجرا می‌شود و کار نمی‌کند، بخش‌های زیر به عیب‌یابی و رفع مشکل کمک می‌کنند.

گزارش‌های عملکرد ابر را بررسی کنید

به عنوان اولین قدم، گزارش‌های عملکردهای ابری را برای وجود خطا بررسی کنید.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. برای باز کردن گزارش‌ها، عملکرد Cloud برنامه Chat خود را پیدا کنید، سپس روی Show actions > مشاهده گزارش‌ها کلیک کنید.

Logs Explorer باز می شود و درخواستی را اجرا می کند که گزارش های Cloud Function، از جمله خطاها را نشان می دهد.

اگر اطلاعات پیش‌فرض ثبت‌شده برای اشکال‌زدایی برنامه شما کافی نیست، می‌توانید گزارش‌های اضافی را از کد عملکرد Cloud خود اضافه کنید. مشاهده و نوشتن گزارش‌های Cloud Function را ببینید.

خطاهای Cloud Function را بررسی کنید

به غیر از گزارش‌ها، Cloud Function ممکن است خطاهایی را که در حین اجرا با آنها مواجه می‌شود گزارش کند.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. روی عملکرد Cloud برنامه چت خود کلیک کنید.

  3. در صفحه جزئیات عملکرد، خطاها در زیر خطاها فهرست می شوند.

  4. برای عیب یابی بیشتر یک خطا، روی آن کلیک کنید.

رفع خطاهای رایج Cloud Function

گاهی اوقات هنگام ساختن یک برنامه چت با توابع ابری با خطاهای زیر مواجه می شوید.

عملکرد ChatApp در منطقه REGION_NAME در پروژه PROJECT_NAME از قبل وجود دارد

هنگام استقرار یک تابع Cloud، ممکن است خطای Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists دریافت کنید. این پیام به این معنی است که یک تابع ابری دیگر هم نامی دارد که شما در حال استقرار آن هستید. نام را تغییر دهید و تابع را دوباره اجرا کنید. بررسی کنید که برنامه Chat از URL ماشه برای عملکرد Cloud شما استفاده می کند، نه از URL ماشه عملکرد Cloud از قبل موجود.

یک یا چند کاربر نام‌گذاری شده در خط‌مشی به مشتری مجاز تعلق ندارند

هنگام استقرار یک تابع Cloud، ممکن است این خطا را دریافت کنید. The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." اگر این خطا را دریافت کردید و سپس به برنامه Chat پیام دادید، با این خطا مواجه می شوید که برنامه پاسخ نمی دهد زیرا Google Chat نمی تواند به سرور میزبان عملکرد Cloud دسترسی پیدا کند. این پیام به این معنی است که کاربری به نام "allUsers" اجازه تماس با عملکرد Cloud را ندارد. دادن نقش «Cloud Functions Invoker» به «allUsers» به این معنی است که عملکرد Cloud که برنامه را تقویت می‌کند در دسترس عموم و بدون احراز هویت در دسترس است. برای یادگیری نحوه اختصاص یک نقش، به Grant a single Role مراجعه کنید.

این خطا ممکن است به این معنی باشد که پروژه Google Cloud محدود به دامنه است. برای اطلاعات بیشتر در مورد محدودیت های محدودیت دامنه، به محدود کردن هویت ها بر اساس دامنه مراجعه کنید.

برای حل این مشکل، بررسی کنید که عملکرد Cloud شما به فراخوان‌های احراز هویت نشده اجازه می‌دهد. برای آشنایی با نحوه مجاز کردن فراخوان‌های احراز هویت نشده برای یک عملکرد Cloud موجود، به اجازه دسترسی عمومی (غیر احراز هویت) مراجعه کنید.

،

این بخش مشکلات رایجی را که می‌توانید هنگام ساخت و آزمایش برنامه‌های چت با آن‌ها مواجه شوید، توضیح می‌دهد.

پیام کارت، گفتگو یا پیش‌نمایش پیوند آنطور که انتظار می‌رود ارائه نمی‌شود یا کار نمی‌کند

برای راهنمایی در مورد عیب‌یابی خطاهای کارت، به عیب‌یابی و تعمیر کارت‌ها مراجعه کنید.

برنامه پاسخ نمی دهد

اگر به برنامه چت پیام دادید و پاسخ داد «برنامه پاسخ نمی‌دهد»، پیکربندی برنامه چت را تأیید کنید:

  1. در کنسول Google Cloud، > محصولات بیشتر > Google Workspace > کتابخانه محصول > Google Chat API > مدیریت > پیکربندی کلیک کنید.

    به Chat API بروید

  2. در زیر وضعیت برنامه ، مطمئن شوید که Live-Distained to users را انتخاب کرده اید.

  3. در بخش ویژگی‌های تعاملی ، مطمئن شوید که تنظیمات برای عملکرد برنامه شما مناسب است. اگر برنامه چت شما با کاربران تعامل دارد، مطمئن شوید که فعال کردن ویژگی‌های تعاملی را روشن کرده‌اید:

    1. اگر برنامه شما به پیام‌ها پاسخ می‌دهد، مطمئن شوید که دریافت پیام‌های ۱:۱ را انتخاب کرده‌اید.
    2. در تنظیمات اتصال ، مطمئن شوید URL نقطه پایانی HTTP ، شناسه استقرار پروژه Apps Script، Cloud Pub/Sub Topic Name یا عامل Dialogflow به درستی تنظیم شده باشد و مستقر شده باشد.
    3. در قسمت Visibility ، مطمئن شوید که کاربران مناسب با آدرس ایمیل یا گروهی در دامنه Google Workspace به برنامه دسترسی دارند. اگر برنامه با Google Workspace Marketplace SDK مستقر شده باشد، تنظیمات نمایان بودن لازم نیست زیرا تنظیمات Google Workspace Marketplace اولویت دارند.

  4. اگر برنامه با Google Workspace Marketplace SDK منتشر شده است، تنظیمات Google Workspace Marketplace را مرور کنید.

  5. روی ذخیره کلیک کنید.

  6. دوباره به برنامه پیام ارسال کنید.

Google Chat API فقط برای کاربران Google Workspace در دسترس است

هنگام پیکربندی برنامه گپ، ممکن است این خطا را دریافت کنید که Google Chat API is only available to Google Workspace users . این پیام به این معنی است که حساب Google که برای پیکربندی Chat API استفاده کرده‌اید، بخشی از یک سازمان Google Workspace نیست. برای ایجاد یک برنامه Chat یا استفاده از Chat API، باید از یک حساب Google Workspace استفاده کنید.

توجه داشته باشید که کاربران چت Google می‌توانند از برنامه‌های چت بدون حساب Google Workspace استفاده کنند. برای آشنایی بیشتر با نحوه کشف و نصب برنامه‌های گپ توسط کاربران، به انتشار برنامه‌های گپ Google مراجعه کنید.

کاربران را می توان از فضاها حذف کرد

اگر یک سرپرست Google Workspace به کاربران اجازه نمی‌دهد سابقه گپ را روشن یا خاموش کنند ، ممکن است مواقعی پیش بیاید که کاربران نتوانند به فضایی بپیوندند یا در آن بمانند به دلیل تضاد بین تنظیمات سطح کاربر که باعث می‌شود تاریخچه گپ روشن یا خاموش شود. فضایی که محیط اجباری در سطح سازمان را به ارث می برد.

به عنوان مثال، اگر یک کاربر تنظیمات سابقه گپ را "روشن" اجباری داشته باشد و یک فضا دارای تنظیمات سابقه گپ اجباری "خاموش" باشد، آن کاربر ممکن است نتواند به این فضا بپیوندد. علاوه بر این، اگر کاربر قبل از تداخل به آن ملحق شده باشد، ممکن است از فضا حذف شود و پس از درگیری پیامی را در فضا ارسال کند.

در این سناریو و سایر سناریوهایی که بین تنظیمات سابقه تداخل وجود دارد، Chat API ممکن است نتواند عضویت ایجاد کند، یا ایجاد یک پیام با احراز هویت کاربر ممکن است کاربر احراز هویت شده با تنظیم تاریخچه گپ متناقض را از فضا حذف کند.

برای کسب اطلاعات بیشتر، رجوع کنید کاربران را می توان از فضاهای موجود در مرکز راهنمای Google Workspace Admin مستثنی کرد .

عیب‌یابی سرویس گفتگوی پیشرفته در Google Apps Script

صفحه Apps Script را در مورد سرویس چت پیشرفته ببینید.

کاربران نمی توانند یک برنامه چت را به یک فضا اضافه کنند

اگر کاربران با پیام خطا مواجه شوند This organization's administrator must allow users to install this Chat app ، این خطا ممکن است به یکی از دلایل زیر ایجاد شود:

  • سازمان برنامه‌های چت را غیرفعال کرده است.
  • سازمان این برنامه چت خاص را به لیست مجاز سازمان اضافه نکرده است.

اگر کاربر هنگام تلاش برای تعامل با یک برنامه گپ با این پیام خطا مواجه شود، ممکن است به دلیل اعطای دسترسی سازمان به یک واحد زیر سازمانی، بدون فعال کردن آن برای واحد سازمانی والد، ایجاد شود.

برای کسب اطلاعات در مورد نحوه حل این مشکل، به کاربران اجازه نصب برنامه‌های گپ را ببینید.

سرپرست باید دامنه مجوز OAuth مورد نیاز را برای این اقدام به برنامه بدهد

هنگام احراز هویت به عنوان یک برنامه چت ، ممکن است خطای زیر را دریافت کنید:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

این پیام خطا به این معنی است که یک سرپرست Google Workspace هنوز برای برنامه Chat برای استفاده از محدوده‌های مجوزی که با نام https://www.googleapis.com/auth/chat.app.* شروع می‌شود، یک بار تأیید نکرده است.

برای رفع خطا:

  • از سرپرست Google Workspace بخواهید تا برنامه چت شما را تأیید کند . هنگام رسیدگی به این خطا در منطق برنامه Chat خود، پیامی ارسال کنید که اعلام کند برنامه Chat برای انجام عملکرد درخواستی به تأیید سرپرست نیاز دارد، شاید: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • اگر روش Chat API از محدوده مجوز https://www.googleapis.com/auth/chat.bot پشتیبانی می‌کند که به تأیید سرپرست نیاز ندارد، به جای آن از آن استفاده کنید. برای بررسی اینکه یک روش از کدام حوزه مجوز پشتیبانی می‌کند، به برنامه‌های Google Chat و درخواست‌های API Chat Google Authenticate و مجوز دادن مراجعه کنید.

عیب یابی خطاهای Cloud Function

اگر برنامه چت با توابع Cloud اجرا می‌شود و کار نمی‌کند، بخش‌های زیر به عیب‌یابی و رفع مشکل کمک می‌کنند.

گزارش‌های عملکرد ابر را بررسی کنید

به عنوان اولین قدم، گزارش‌های عملکردهای ابری را برای وجود خطا بررسی کنید.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. برای باز کردن گزارش‌ها، عملکرد Cloud برنامه Chat خود را پیدا کنید، سپس روی Show actions > مشاهده گزارش‌ها کلیک کنید.

Logs Explorer باز می شود و درخواستی را اجرا می کند که گزارش های Cloud Function، از جمله خطاها را نشان می دهد.

اگر اطلاعات پیش‌فرض ثبت‌شده برای اشکال‌زدایی برنامه شما کافی نیست، می‌توانید گزارش‌های اضافی را از کد عملکرد Cloud خود اضافه کنید. مشاهده و نوشتن گزارش‌های Cloud Function را ببینید.

خطاهای Cloud Function را بررسی کنید

به غیر از گزارش‌ها، Cloud Function ممکن است خطاهایی را که در حین اجرا با آنها مواجه می‌شود گزارش کند.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. روی عملکرد Cloud برنامه چت خود کلیک کنید.

  3. در صفحه جزئیات عملکرد، خطاها در زیر خطاها فهرست می شوند.

  4. برای عیب یابی بیشتر یک خطا، روی آن کلیک کنید.

رفع خطاهای رایج Cloud Function

گاهی اوقات هنگام ساختن یک برنامه چت با توابع ابری با خطاهای زیر مواجه می شوید.

عملکرد ChatApp در منطقه REGION_NAME در پروژه PROJECT_NAME از قبل وجود دارد

هنگام استقرار یک تابع Cloud، ممکن است خطای Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists دریافت کنید. این پیام به این معنی است که یک تابع ابری دیگر هم نامی دارد که شما در حال استقرار آن هستید. نام را تغییر دهید و تابع را دوباره اجرا کنید. بررسی کنید که برنامه Chat از URL ماشه برای عملکرد Cloud شما استفاده می کند، نه از URL ماشه عملکرد Cloud از قبل موجود.

یک یا چند کاربر نام‌گذاری شده در خط‌مشی به مشتری مجاز تعلق ندارند

هنگام استقرار یک تابع Cloud، ممکن است این خطا را دریافت کنید. The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." اگر این خطا را دریافت کردید و سپس به برنامه Chat پیام دادید، با این خطا مواجه می شوید که برنامه پاسخ نمی دهد زیرا Google Chat نمی تواند به سرور میزبان عملکرد Cloud دسترسی پیدا کند. این پیام به این معنی است که کاربری به نام "allUsers" اجازه تماس با عملکرد Cloud را ندارد. دادن نقش «Cloud Functions Invoker» به «allUsers» به این معنی است که عملکرد Cloud که برنامه را تقویت می‌کند در دسترس عموم و بدون احراز هویت در دسترس است. برای یادگیری نحوه اختصاص یک نقش، به Grant a single Role مراجعه کنید.

این خطا ممکن است به این معنی باشد که پروژه Google Cloud محدود به دامنه است. برای اطلاعات بیشتر در مورد محدودیت های محدودیت دامنه، به محدود کردن هویت ها بر اساس دامنه مراجعه کنید.

برای حل این مشکل، بررسی کنید که Cloud Function شما اجازه فراخوان‌های احراز هویت نشده را می‌دهد. برای آشنایی با نحوه مجاز کردن فراخوان‌های احراز هویت نشده برای یک عملکرد Cloud موجود، به اجازه دسترسی عمومی (غیر احراز هویت) مراجعه کنید.

،

این بخش مشکلات رایجی را که می‌توانید هنگام ساخت و آزمایش برنامه‌های چت با آن‌ها مواجه شوید، توضیح می‌دهد.

پیام کارت، گفتگو یا پیش‌نمایش پیوند آنطور که انتظار می‌رود ارائه نمی‌شود یا کار نمی‌کند

برای راهنمایی در مورد عیب‌یابی خطاهای کارت، به عیب‌یابی و تعمیر کارت‌ها مراجعه کنید.

برنامه پاسخ نمی دهد

اگر به برنامه چت پیام دادید و پاسخ داد «برنامه پاسخ نمی‌دهد»، پیکربندی برنامه چت را تأیید کنید:

  1. در کنسول Google Cloud، > محصولات بیشتر > Google Workspace > کتابخانه محصول > Google Chat API > مدیریت > پیکربندی کلیک کنید.

    به Chat API بروید

  2. در زیر وضعیت برنامه ، مطمئن شوید که Live-Distained to users را انتخاب کرده اید.

  3. در بخش ویژگی‌های تعاملی ، مطمئن شوید که تنظیمات برای عملکرد برنامه شما مناسب است. اگر برنامه چت شما با کاربران تعامل دارد، مطمئن شوید که فعال کردن ویژگی‌های تعاملی را روشن کرده‌اید:

    1. اگر برنامه شما به پیام‌ها پاسخ می‌دهد، مطمئن شوید که دریافت پیام‌های ۱:۱ را انتخاب کرده‌اید.
    2. در تنظیمات اتصال ، مطمئن شوید URL نقطه پایانی HTTP ، شناسه استقرار پروژه Apps Script، Cloud Pub/Sub Topic Name یا عامل Dialogflow به درستی تنظیم شده باشد و مستقر شده باشد.
    3. در قسمت Visibility ، مطمئن شوید که کاربران مناسب با آدرس ایمیل یا گروهی در دامنه Google Workspace به برنامه دسترسی دارند. اگر برنامه با Google Workspace Marketplace SDK مستقر شده باشد، تنظیمات نمایان بودن لازم نیست زیرا تنظیمات Google Workspace Marketplace اولویت دارند.

  4. اگر برنامه با Google Workspace Marketplace SDK منتشر شده است، تنظیمات Google Workspace Marketplace را مرور کنید.

  5. روی ذخیره کلیک کنید.

  6. دوباره به برنامه پیام ارسال کنید.

Google Chat API فقط برای کاربران Google Workspace در دسترس است

هنگام پیکربندی برنامه Chat، ممکن است این خطا را دریافت کنید که Google Chat API is only available to Google Workspace users . این پیام به این معنی است که حساب Google که برای پیکربندی Chat API استفاده کرده‌اید، بخشی از یک سازمان Google Workspace نیست. برای ایجاد یک برنامه Chat یا استفاده از Chat API، باید از یک حساب Google Workspace استفاده کنید.

توجه داشته باشید که کاربران چت Google می‌توانند از برنامه‌های چت بدون حساب Google Workspace استفاده کنند. برای آشنایی بیشتر با نحوه کشف و نصب برنامه‌های گپ توسط کاربران، به انتشار برنامه‌های گپ Google مراجعه کنید.

کاربران را می توان از فضاها حذف کرد

اگر یک سرپرست Google Workspace به کاربران اجازه نمی‌دهد سابقه گپ را روشن یا خاموش کنند ، ممکن است مواقعی پیش بیاید که کاربران نتوانند به فضایی بپیوندند یا در آن بمانند به دلیل تضاد بین تنظیمات سطح کاربر که باعث می‌شود تاریخچه گپ روشن یا خاموش شود. فضایی که محیط اجباری در سطح سازمان را به ارث می برد.

به عنوان مثال، اگر یک کاربر تنظیمات سابقه گپ را "روشن" اجباری داشته باشد و یک فضا دارای تنظیمات سابقه گپ اجباری "خاموش" باشد، آن کاربر ممکن است نتواند به این فضا بپیوندد. علاوه بر این، اگر کاربر قبل از تداخل به آن ملحق شده باشد، ممکن است از فضا حذف شود و پس از درگیری پیامی را در فضا ارسال کند.

در این سناریو و سایر سناریوهایی که بین تنظیمات سابقه تداخل وجود دارد، Chat API ممکن است نتواند عضویت ایجاد کند، یا ایجاد یک پیام با احراز هویت کاربر ممکن است کاربر احراز هویت شده با تنظیم تاریخچه گپ متناقض را از فضا حذف کند.

برای کسب اطلاعات بیشتر، رجوع کنید کاربران را می توان از فضاهای موجود در مرکز راهنمای Google Workspace Admin مستثنی کرد .

عیب‌یابی سرویس گفتگوی پیشرفته در Google Apps Script

صفحه Apps Script را در مورد سرویس چت پیشرفته ببینید.

کاربران نمی توانند یک برنامه چت را به یک فضا اضافه کنند

اگر کاربران با پیام خطا مواجه شوند This organization's administrator must allow users to install this Chat app ، این خطا ممکن است به یکی از دلایل زیر ایجاد شود:

  • سازمان برنامه‌های چت را غیرفعال کرده است.
  • سازمان این برنامه چت خاص را به لیست مجاز سازمان اضافه نکرده است.

اگر کاربر هنگام تلاش برای تعامل با یک برنامه گپ با این پیام خطا مواجه شود، ممکن است به دلیل اعطای دسترسی سازمان به یک واحد زیر سازمانی، بدون فعال کردن آن برای واحد سازمانی والد، ایجاد شود.

برای کسب اطلاعات در مورد نحوه حل این مشکل، به کاربران اجازه نصب برنامه‌های گپ را ببینید.

سرپرست باید دامنه مجوز OAuth مورد نیاز را برای این اقدام به برنامه بدهد

هنگام احراز هویت به عنوان یک برنامه چت ، ممکن است خطای زیر را دریافت کنید:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

این پیام خطا به این معنی است که یک سرپرست Google Workspace هنوز برای برنامه Chat برای استفاده از محدوده‌های مجوزی که با نام https://www.googleapis.com/auth/chat.app.* شروع می‌شود، یک بار تأیید نکرده است.

برای رفع خطا:

  • از سرپرست Google Workspace بخواهید تا برنامه چت شما را تأیید کند . هنگام رسیدگی به این خطا در منطق برنامه Chat خود، پیامی ارسال کنید که اعلام کند برنامه Chat برای انجام عملکرد درخواستی به تأیید سرپرست نیاز دارد، شاید: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • اگر روش Chat API از محدوده مجوز https://www.googleapis.com/auth/chat.bot پشتیبانی می‌کند که به تأیید سرپرست نیاز ندارد، به جای آن از آن استفاده کنید. برای بررسی اینکه یک روش از کدام حوزه مجوز پشتیبانی می‌کند، به برنامه‌های Google Chat و درخواست‌های API Chat Google Authenticate و مجوز دادن مراجعه کنید.

عیب یابی خطاهای Cloud Function

اگر برنامه چت با توابع Cloud اجرا می‌شود و کار نمی‌کند، بخش‌های زیر به عیب‌یابی و رفع مشکل کمک می‌کنند.

گزارش‌های عملکرد ابر را بررسی کنید

به عنوان اولین قدم، گزارش‌های عملکردهای ابری را برای وجود خطا بررسی کنید.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. برای باز کردن گزارش‌ها، عملکرد Cloud برنامه Chat خود را پیدا کنید، سپس روی Show actions > مشاهده گزارش‌ها کلیک کنید.

Logs Explorer باز می شود و درخواستی را اجرا می کند که گزارش های Cloud Function، از جمله خطاها را نشان می دهد.

اگر اطلاعات پیش‌فرض ثبت‌شده برای اشکال‌زدایی برنامه شما کافی نیست، می‌توانید گزارش‌های اضافی را از کد عملکرد Cloud خود اضافه کنید. مشاهده و نوشتن گزارش‌های Cloud Function را ببینید.

خطاهای Cloud Function را بررسی کنید

به غیر از گزارش‌ها، Cloud Function ممکن است خطاهایی را که در حین اجرا با آنها مواجه می‌شود گزارش کند.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. روی عملکرد Cloud برنامه چت خود کلیک کنید.

  3. در صفحه جزئیات عملکرد، خطاها در زیر خطاها فهرست می شوند.

  4. برای عیب یابی بیشتر یک خطا، روی آن کلیک کنید.

رفع خطاهای رایج Cloud Function

گاهی اوقات هنگام ساختن یک برنامه چت با توابع ابری با خطاهای زیر مواجه می شوید.

عملکرد ChatApp در منطقه REGION_NAME در پروژه PROJECT_NAME از قبل وجود دارد

هنگام استقرار یک تابع Cloud، ممکن است خطای Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists دریافت کنید. این پیام به این معنی است که یک تابع ابری دیگر هم نامی دارد که شما در حال استقرار آن هستید. نام را تغییر دهید و تابع را دوباره اجرا کنید. بررسی کنید که برنامه Chat از URL ماشه برای عملکرد Cloud شما استفاده می کند، نه از URL ماشه عملکرد Cloud از قبل موجود.

یک یا چند کاربر نام‌گذاری شده در خط‌مشی به مشتری مجاز تعلق ندارند

هنگام استقرار یک تابع Cloud، ممکن است این خطا را دریافت کنید. The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." اگر این خطا را دریافت کردید و سپس به برنامه Chat پیام دادید، با این خطا مواجه می شوید که برنامه پاسخ نمی دهد زیرا Google Chat نمی تواند به سرور میزبان عملکرد Cloud دسترسی پیدا کند. این پیام به این معنی است که کاربری به نام "allUsers" اجازه تماس با عملکرد Cloud را ندارد. دادن نقش «Cloud Functions Invoker» به «allUsers» به این معنی است که عملکرد Cloud که برنامه را تقویت می‌کند در دسترس عموم و بدون احراز هویت در دسترس است. برای یادگیری نحوه اختصاص یک نقش، به Grant a single Role مراجعه کنید.

این خطا ممکن است به این معنی باشد که پروژه Google Cloud محدود به دامنه است. برای اطلاعات بیشتر در مورد محدودیت های محدودیت دامنه، به محدود کردن هویت ها بر اساس دامنه مراجعه کنید.

برای حل این مشکل، بررسی کنید که عملکرد Cloud شما به فراخوان‌های احراز هویت نشده اجازه می‌دهد. برای آشنایی با نحوه مجاز کردن فراخوان‌های احراز هویت نشده برای یک عملکرد Cloud موجود، به اجازه دسترسی عمومی (غیر احراز هویت) مراجعه کنید.

،

این بخش مشکلات رایجی را که می‌توانید هنگام ساخت و آزمایش برنامه‌های چت با آن‌ها مواجه شوید، توضیح می‌دهد.

پیام کارت، گفتگو یا پیش‌نمایش پیوند آنطور که انتظار می‌رود ارائه نمی‌شود یا کار نمی‌کند

برای راهنمایی در مورد عیب‌یابی خطاهای کارت، به عیب‌یابی و تعمیر کارت‌ها مراجعه کنید.

برنامه پاسخ نمی دهد

اگر به برنامه چت پیام دادید و پاسخ داد «برنامه پاسخ نمی‌دهد»، پیکربندی برنامه چت را تأیید کنید:

  1. در کنسول Google Cloud، > محصولات بیشتر > Google Workspace > کتابخانه محصول > Google Chat API > مدیریت > پیکربندی کلیک کنید.

    به Chat API بروید

  2. در زیر وضعیت برنامه ، مطمئن شوید که Live-Distained to users را انتخاب کرده اید.

  3. در بخش ویژگی‌های تعاملی ، مطمئن شوید که تنظیمات برای عملکرد برنامه شما مناسب است. اگر برنامه چت شما با کاربران تعامل دارد، مطمئن شوید که فعال کردن ویژگی‌های تعاملی را روشن کرده‌اید:

    1. اگر برنامه شما به پیام‌ها پاسخ می‌دهد، مطمئن شوید که دریافت پیام‌های ۱:۱ را انتخاب کرده‌اید.
    2. در تنظیمات اتصال ، مطمئن شوید URL نقطه پایانی HTTP ، شناسه استقرار پروژه Apps Script، Cloud Pub/Sub Topic Name یا عامل Dialogflow به درستی تنظیم شده باشد و مستقر شده باشد.
    3. در قسمت Visibility ، مطمئن شوید که کاربران مناسب با آدرس ایمیل یا گروهی در دامنه Google Workspace به برنامه دسترسی دارند. اگر برنامه با Google Workspace Marketplace SDK مستقر شده باشد، تنظیمات نمایان بودن لازم نیست زیرا تنظیمات Google Workspace Marketplace اولویت دارند.

  4. اگر برنامه با Google Workspace Marketplace SDK منتشر شده است، تنظیمات Google Workspace Marketplace را مرور کنید.

  5. روی ذخیره کلیک کنید.

  6. دوباره به برنامه پیام ارسال کنید.

Google Chat API فقط برای کاربران Google Workspace در دسترس است

هنگام پیکربندی برنامه گپ، ممکن است این خطا را دریافت کنید که Google Chat API is only available to Google Workspace users . این پیام به این معنی است که حساب Google که برای پیکربندی Chat API استفاده کرده‌اید، بخشی از یک سازمان Google Workspace نیست. برای ایجاد یک برنامه Chat یا استفاده از Chat API، باید از یک حساب Google Workspace استفاده کنید.

توجه داشته باشید که کاربران چت Google می‌توانند از برنامه‌های چت بدون حساب Google Workspace استفاده کنند. برای آشنایی بیشتر با نحوه کشف و نصب برنامه‌های گپ توسط کاربران، به انتشار برنامه‌های گپ Google مراجعه کنید.

کاربران را می توان از فضاها حذف کرد

اگر یک سرپرست Google Workspace به کاربران اجازه نمی‌دهد سابقه گپ را روشن یا خاموش کنند ، ممکن است مواقعی پیش بیاید که کاربران نتوانند به فضایی بپیوندند یا در آن بمانند به دلیل تضاد بین تنظیمات سطح کاربر که باعث می‌شود تاریخچه گپ روشن یا خاموش شود. فضایی که محیط اجباری در سطح سازمان را به ارث می برد.

به عنوان مثال، اگر یک کاربر تنظیمات سابقه گپ را "روشن" اجباری داشته باشد و یک فضا دارای تنظیمات سابقه گپ اجباری "خاموش" باشد، آن کاربر ممکن است نتواند به این فضا بپیوندد. علاوه بر این، اگر کاربر قبل از تداخل به آن ملحق شده باشد، ممکن است از فضا حذف شود و پس از درگیری پیامی را در فضا ارسال کند.

در این سناریو و سایر سناریوهایی که بین تنظیمات سابقه تداخل وجود دارد، Chat API ممکن است نتواند عضویت ایجاد کند، یا ایجاد یک پیام با احراز هویت کاربر ممکن است کاربر احراز هویت شده با تنظیم تاریخچه گپ متناقض را از فضا حذف کند.

برای کسب اطلاعات بیشتر، رجوع کنید کاربران را می توان از فضاهای موجود در مرکز راهنمای Google Workspace Admin مستثنی کرد .

عیب‌یابی سرویس گفتگوی پیشرفته در Google Apps Script

صفحه Apps Script را در مورد سرویس چت پیشرفته ببینید.

کاربران نمی توانند یک برنامه چت را به یک فضا اضافه کنند

اگر کاربران با پیام خطا مواجه شوند This organization's administrator must allow users to install this Chat app ، این خطا ممکن است به یکی از دلایل زیر ایجاد شود:

  • سازمان برنامه‌های چت را غیرفعال کرده است.
  • سازمان این برنامه چت خاص را به لیست مجاز سازمان اضافه نکرده است.

اگر کاربر هنگام تلاش برای تعامل با یک برنامه گپ با این پیام خطا مواجه شود، ممکن است به دلیل اعطای دسترسی سازمان به یک واحد زیر سازمانی، بدون فعال کردن آن برای واحد سازمانی والد، ایجاد شود.

برای کسب اطلاعات در مورد نحوه حل این مشکل، به کاربران اجازه نصب برنامه‌های گپ را ببینید.

سرپرست باید دامنه مجوز OAuth مورد نیاز را برای این اقدام به برنامه بدهد

هنگام احراز هویت به عنوان یک برنامه چت ، ممکن است خطای زیر را دریافت کنید:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

این پیام خطا به این معنی است که یک سرپرست Google Workspace هنوز برای برنامه Chat برای استفاده از محدوده‌های مجوزی که با نام https://www.googleapis.com/auth/chat.app.* شروع می‌شود، یک بار تأیید نکرده است.

برای رفع خطا:

  • از سرپرست Google Workspace بخواهید تا برنامه چت شما را تأیید کند . هنگام رسیدگی به این خطا در منطق برنامه Chat خود، پیامی ارسال کنید که اعلام کند برنامه Chat برای انجام عملکرد درخواستی به تأیید سرپرست نیاز دارد، شاید: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • اگر روش Chat API از محدوده مجوز https://www.googleapis.com/auth/chat.bot پشتیبانی می‌کند که به تأیید سرپرست نیاز ندارد، به جای آن از آن استفاده کنید. برای بررسی اینکه یک روش از کدام حوزه مجوز پشتیبانی می‌کند، به برنامه‌های Google Chat و درخواست‌های API Chat Google Authenticate و مجوز دادن مراجعه کنید.

عیب یابی خطاهای Cloud Function

اگر برنامه چت با توابع Cloud اجرا می‌شود و کار نمی‌کند، بخش‌های زیر به عیب‌یابی و رفع مشکل کمک می‌کنند.

گزارش‌های عملکرد ابر را بررسی کنید

به عنوان اولین قدم، گزارش‌های عملکردهای ابری را برای وجود خطا بررسی کنید.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. برای باز کردن گزارش‌ها، عملکرد Cloud برنامه Chat خود را پیدا کنید، سپس روی Show actions > مشاهده گزارش‌ها کلیک کنید.

Logs Explorer باز می شود و درخواستی را اجرا می کند که گزارش های Cloud Function، از جمله خطاها را نشان می دهد.

اگر اطلاعات پیش‌فرض ثبت‌شده برای اشکال‌زدایی برنامه شما کافی نیست، می‌توانید گزارش‌های اضافی را از کد عملکرد Cloud خود اضافه کنید. مشاهده و نوشتن گزارش‌های Cloud Function را ببینید.

خطاهای Cloud Function را بررسی کنید

به غیر از گزارش‌ها، Cloud Function ممکن است خطاهایی را که در حین اجرا با آنها مواجه می‌شود گزارش کند.

  1. در کنسول Google Cloud، به صفحه Cloud Functions بروید:

    به Cloud Functions بروید

  2. روی عملکرد Cloud برنامه چت خود کلیک کنید.

  3. در صفحه جزئیات عملکرد، خطاها در زیر خطاها فهرست می شوند.

  4. برای عیب یابی بیشتر یک خطا، روی آن کلیک کنید.

رفع خطاهای رایج Cloud Function

گاهی اوقات هنگام ساختن یک برنامه چت با توابع ابری با خطاهای زیر مواجه می شوید.

عملکرد ChatApp در منطقه REGION_NAME در پروژه PROJECT_NAME از قبل وجود دارد

هنگام استقرار یک تابع Cloud، ممکن است خطای Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists دریافت کنید. این پیام به این معنی است که یک تابع ابری دیگر هم نامی دارد که شما در حال استقرار آن هستید. نام را تغییر دهید و تابع را دوباره اجرا کنید. بررسی کنید که برنامه Chat از URL ماشه برای عملکرد Cloud شما استفاده می کند، نه از URL ماشه عملکرد Cloud از قبل موجود.

یک یا چند کاربر نام‌گذاری شده در خط‌مشی به مشتری مجاز تعلق ندارند

هنگام استقرار یک تابع Cloud، ممکن است این خطا را دریافت کنید. The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." اگر این خطا را دریافت کردید و سپس به برنامه Chat پیام دادید، با این خطا مواجه می شوید که برنامه پاسخ نمی دهد زیرا Google Chat نمی تواند به سرور میزبان عملکرد Cloud دسترسی پیدا کند. این پیام به این معنی است که کاربری به نام "allUsers" اجازه تماس با عملکرد Cloud را ندارد. دادن نقش «Cloud Functions Invoker» به «allUsers» به این معنی است که عملکرد Cloud که برنامه را تقویت می‌کند در دسترس عموم و بدون احراز هویت در دسترس است. برای یادگیری نحوه اختصاص یک نقش، به Grant a single Role مراجعه کنید.

این خطا ممکن است به این معنی باشد که پروژه Google Cloud محدود به دامنه است. برای اطلاعات بیشتر در مورد محدودیت های محدودیت دامنه، به محدود کردن هویت ها بر اساس دامنه مراجعه کنید.

برای حل این مسئله ، تأیید کنید که عملکرد ابر شما امکان دعوت های غیرمجاز را فراهم می کند. برای یادگیری چگونگی امکان دعوت های غیرمجاز برای یک عملکرد ابر موجود ، به امکان دسترسی عمومی (غیر معتبر) مراجعه کنید.