Google Chat API را پیکربندی کنید

هر برنامه Google Chat که ایجاد می‌کنید به پروژه Google Cloud خود با فعال و پیکربندی Chat API نیاز دارد. این صفحه نحوه پیکربندی Chat API را به شما نشان می دهد.

پیش نیازها

Chat API را پیکربندی کنید

  1. در کنسول Google Cloud، «Google Chat API» را جستجو کنید و روی Google Chat API کلیک کنید، سپس روی Manage کلیک کنید.

    به Chat API بروید

  2. روی تب Configuration کلیک کنید و اطلاعات مورد نیاز زیر را وارد کنید:

    • نام برنامه : نامی که افراد هنگام تعامل با برنامه چت شما از آن استفاده می کنند.
    • نشانی وب آواتار : نشانی اینترنتی HTTPS که به تصویر گرافیکی مربعی (مثلاً PNG یا JPEG)، حداقل ۱۲۸×۱۲۸ اشاره می‌کند که به‌عنوان نماد برنامه چت شما ظاهر می‌شود.
    • توضیحات : شرحی از هدف برنامه چت که در زیر نام برنامه چت شما ظاهر می شود.

  3. برای روشن کردن ویژگی‌های تعاملی، روی کلید فعال کردن ویژگی‌های تعاملی کلیک کنید تا کاربران با برنامه چت شما تعامل داشته باشند و از جدول زیر برای تکمیل پیکربندی استفاده کنند:

    رشته شرح
    عملکرد مجموعه‌ای از فیلدها که نحوه تعامل برنامه چت با کاربران را تعیین می‌کند:
    • دریافت پیام‌های ۱:۱ : کاربران می‌توانند برنامه چت را مستقیماً در چت Google پیدا کنند و پیام دهند.
    • پیوستن به فضاها و مکالمات گروهی : کاربران می توانند برنامه چت را به فضاها و مکالمات گروهی اضافه کنند.
    تنظیمات اتصال نقطه پایانی برای برنامه Chat که یکی از موارد زیر است:
    • URL برنامه : یک نقطه پایانی HTTPS که اجرای برنامه Chat را میزبانی می کند.
    • پروژه Apps Script : شناسه استقرار برای پروژه Apps Script که یک برنامه Chat را پیاده سازی می کند.
    • نام موضوع Cloud Pub/Sub : یک موضوع Pub/Sub که برنامه Chat به عنوان نقطه پایانی در آن مشترک شده است.
    • Dialogflow : برنامه Chat را با یکپارچه سازی Dialogflow ثبت می کند. برای اطلاعات بیشتر، به ساخت برنامه گفتگوی Google Chat که زبان طبیعی را می‌فهمد، مراجعه کنید.
    دستورات اسلش دستوراتی که می توانند برای کاربران در چت Google ظاهر شوند. به کاربران اجازه می‌دهد تا عملکردهای اصلی برنامه چت شما را در Google Chat ببینند و اقدام خاصی را که می‌خواهند با آن تعامل داشته باشند انتخاب کنند. برای اطلاعات بیشتر، پاسخ به دستورات اسلش را به‌عنوان برنامه چت ببینید.
    پیش نمایش پیوندها الگوهای نشانی وب که برنامه چت می شناسد و محتوای اضافی را برای زمانی که کاربران پیوند می فرستند ارائه می کند. برای اطلاعات بیشتر، پیش‌نمایش پیوندها را ببینید.
    دید حداکثر 5 نفر یا یک یا چند گروه Google که می‌توانند برنامه چت شما را مشاهده و نصب کنند. از این فیلد برای آزمایش برنامه چت یا اشتراک گذاری برنامه چت با تیم خود استفاده کنید. برای اطلاعات بیشتر، تنظیمات مشاهده و انتشار را برای برنامه گپ خود ببینید.

  4. برای ثبت خطاها در Cloud Logging هر زمان که برنامه Chat خطایی را برمی‌گرداند، کادر انتخاب Log errors to Logging را انتخاب کنید. برای اطلاعات بیشتر، به گزارش‌های خطای درخواست برای برنامه‌های گپ مراجعه کنید.

  5. روی ذخیره کلیک کنید. وقتی پیکربندی برنامه گپ را ذخیره می‌کنید، برنامه گپ شما برای کاربران مشخص‌شده در سازمان Google Workspace شما در دسترس است.

به افراد دیگر اجازه دهید تا برنامه چت را پیکربندی کنند

می‌توانید به کاربران خاصی اجازه دسترسی به صفحه پیکربندی برنامه چت را بدهید . از نقش‌های مالک برنامه‌های گپ و نمایشگر IAM برنامه‌های گپ استفاده کنید. کاربرانی که این نقش‌ها را دارند نمی‌توانند با استفاده از داشبورد APIs & Services به صفحه پیکربندی برنامه‌های گپ بروند، اما می‌توانند با پیمایش به کنسول Google Cloud برای پروژه میزبان برنامه Chat به شرح زیر به صفحه پیکربندی دسترسی پیدا کنند:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

جایی که PROJECT_ID شناسه پروژه پروژه Google Cloud است که میزبان برنامه Chat است.