#הגדרות Google

This feature is provided by the commercial plugin «מנהל דוא\"ל», please purchase to use

#דרישות מקדימות

כדי שמשתמשים יוכלו לחבר את חשבונות Google Mail שלהם ל-NocoBase, המערכת חייבת להיות פרוסה על שרת שתומך בגישה לשירותי Google, מכיוון שה-backend יבצע קריאות ל-Google API.

#רישום חשבון

1. פתחו את https://console.cloud.google.com/welcome כדי לעבור ל-Google Cloud.
2. בכניסה הראשונה תצטרכו להסכים לתנאים וההגבלות הרלוונטיים.

#יצירת אפליקציה

1. לחצו על "Select a project" בחלק העליון.

2. לחצו על כפתור "NEW PROJECT" בחלון הקופץ.

3. מלאו את פרטי הפרויקט.

4. לאחר יצירת הפרויקט, בחרו אותו.

#הפעלת Gmail API

1. לחצו על כפתור "APIs & Services".

2. עברו ללוח המחוונים של APIs & Services.

3. חפשו "mail".

4. לחצו על כפתור "ENABLE" כדי להפעיל את Gmail API.

#הגדרת מסך הסכמה של OAuth

1. לחצו על תפריט "OAuth consent screen" בצד שמאל.

2. בחרו "External".

3. מלאו את פרטי הפרויקט (אלה יוצגו בדף האישור) ולחצו על שמירה.

4. מלאו את פרטי יצירת הקשר של המפתח (Developer contact information) ולחצו על המשך.

5. לחצו על המשך.

6. הוסיפו משתמשי בדיקה לצורך בדיקה לפני פרסום האפליקציה.

7. לחצו על המשך.

8. עברו על סיכום המידע וחזרו ללוח המחוונים.

#יצירת אישורים (Credentials)

1. לחצו על תפריט "Credentials" בצד שמאל.

2. לחצו על כפתור "CREATE CREDENTIALS" ובחרו "OAuth client ID".

3. בחרו "Web application".

4. מלאו את פרטי האפליקציה.

5. הזינו את הדומיין הסופי של פריסת הפרויקט (הדוגמה כאן היא כתובת בדיקה של NocoBase).

6. הוסיפו את כתובת ה-URI של ההפניה החוזרת המאושרת. היא חייבת להיות דומיין + "/admin/settings/mail/oauth2". לדוגמה: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. לחצו על יצירה כדי לצפות בפרטי OAuth.

8. העתיקו את ה-Client ID ואת ה-Client secret והדביקו אותם בדף הגדרות הדוא"ל.

9. לחצו על שמירה כדי להשלים את ההגדרה.

#פרסום האפליקציה

לאחר השלמת התהליך הנ"ל ובדיקת תכונות כמו התחברות משתמש בדיקה עם הרשאה ושליחת דוא"ל, תוכלו לפרסם את האפליקציה.

1. לחצו על תפריט "OAuth consent screen".

2. לחצו על כפתור "EDIT APP", ולאחר מכן לחצו על כפתור "SAVE AND CONTINUE" בתחתית.

3. לחצו על כפתור "ADD OR REMOVE SCOPES" כדי לבחור את היקפי ההרשאות של המשתמש.

4. חפשו "Gmail API", ולאחר מכן סמנו את "Gmail API" (ודאו שערך ה-Scope הוא Gmail API עם "https://mail.google.com/").

5. לחצו על כפתור "UPDATE" בתחתית כדי לשמור.

6. לחצו על כפתור "SAVE AND CONTINUE" בתחתית כל עמוד, ולבסוף לחצו על כפתור "BACK TO DASHBOARD" כדי לחזור לדף לוח המחוונים.

7. לחצו על כפתור "PUBLISH APP". יופיע דף אישור פרסום, המפרט את המידע הנדרש לפרסום. לאחר מכן לחצו על כפתור "CONFIRM".

8. חזרו לדף הקונסולה ותראו שסטטוס הפרסום הוא "In production".

9. לחצו על כפתור "PREPARE FOR VERIFICATION", מלאו את המידע הנדרש ולחצו על כפתור "SAVE AND CONTINUE" (הנתונים בתמונה הם להמחשה בלבד).

10. המשיכו למלא את המידע הנדרש (הנתונים בתמונה הם להמחשה בלבד).

11. לחצו על כפתור "SAVE AND CONTINUE".

12. לחצו על כפתור "SUBMIT FOR VERIFICATION" כדי לשלוח לאימות (Verification).

13. המתינו לתוצאת האישור.

14. אם האישור עדיין ממתין, משתמשים יכולים ללחוץ על הקישור הלא בטוח (unsafe link) כדי לאשר ולהתחבר.