این سند حاوی اطلاعات مربوط به مجوز و احراز هویت مختص API مرکز هشدار است. قبل از مطالعه این سند، حتماً اطلاعات عمومی احراز هویت و مجوز Google Workspace را در بخش «درباره احراز هویت و مجوز بیشتر بدانید» مطالعه کنید.
پیکربندی OAuth 2.0 برای احراز هویت
صفحه رضایت OAuth را پیکربندی کنید و محدودههایی را برای تعریف اطلاعات نمایش داده شده به کاربران و بررسیکنندگان برنامه انتخاب کنید و برنامه خود را ثبت کنید تا بتوانید بعداً آن را منتشر کنید.
محدودههای API مرکز هشدار
برای تعریف سطح دسترسی اعطا شده به برنامه خود، باید حوزههای مجوز را شناسایی و اعلام کنید. حوزه مجوز، یک رشته URI از نوع OAuth 2.0 است که شامل نام برنامه Google Workspace، نوع دادههایی که به آنها دسترسی دارد و سطح دسترسی است. حوزهها، درخواستهای برنامه شما برای کار با دادههای Google Workspace، از جمله دادههای حساب Google کاربران، هستند.
وقتی برنامه شما نصب میشود، از کاربر خواسته میشود تا محدودههای مورد استفاده برنامه را اعتبارسنجی کند. به طور کلی، شما باید محدودهای را انتخاب کنید که بیشترین تمرکز را داشته باشد و از درخواست محدودههایی که برنامه شما به آنها نیاز ندارد، خودداری کنید. کاربران راحتتر به محدودههای محدود و واضح دسترسی میدهند.
API مرکز هشدار از حوزههای زیر پشتیبانی میکند:
| محدودهها | معنی |
|---|---|
https://www.googleapis.com/auth/apps.alerts | دسترسی خواندن و نوشتن به API مرکز هشدار |
ایجاد حساب کاربری سرویس
برای استفاده از API مرکز هشدار، باید از یک حساب کاربری سرویس استفاده کنید و نمایندگی در سطح دامنه را تنظیم کنید. برای جزئیات بیشتر، به ایجاد اعتبارنامههای دسترسی مراجعه کنید.