> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# מחברי Google Workspace

> חבר את Gmail,‏ Google Calendar,‏ Contacts,‏ Drive,‏ Docs ו-Sheets עם מחבר נפרד לכל שירות, או עבוד עם כולם דרך מחבר Google Workspace.

בחר מחבר וחבר אותו דרך חשבון משותף אחד או דרך החשבון האישי של כל אדם. ה-scopes הם ההרשאות שהאפליקציה מבקשת מ-Google, לכן בקש רק את אלה שהיא צריכה.

> [!NOTE]
>
> כדי להשתמש במחברים באפליקציה, צריך [**מסלול Builder**](https://base44.com/pricing) ומעלה.

***

## מה אפשר לעשות

חבר את האפליקציה לאימייל, ליומנים, לאנשי הקשר ולקבצים שלך.

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

> **סנכרון יומנים ואנשי קשר**
>
> סנכרן הזמנות, הצג את הזמינות שלך ושמור את אנשי הקשר מעודכנים.

> **עבודה עם קבצים ונתונים**
>
> שמור דוחות ב-Drive, צור מסמכי Docs, וייבא או ייצא נתונים מ-Sheets.

***

## מחבר Google Workspace

השתמש במחבר הזה כשהאפליקציה משלבת כמה שירותי Google. למשל, עוזר שעובד עם תיבת הדואר, היומן וקבצי ה-Drive שלך. אם היא משתמשת רק בשירות אחד או שניים, חבר אותם במקום.

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את שירותי Google המעורבים, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
תכיר אותי - עבור על האימיילים, הפגישות וקבצי ה-Drive שלי וספר לי על מה אני עובד.
```

```text wrap theme={null}
היה העוזר האישי שלי: עקוב אחרי תיבת הדואר והיומן שלי וספר לי מה דורש את תשומת לבי היום.
```

```text wrap theme={null}
הכן את הפגישה הבאה שלי משרשורי אימייל קשורים, מקבצים ומהפרטים של המשתתפים.
```

```text wrap theme={null}
נסח הודעות מעקב למשתתפים אחרי כל פגישה.
```

```text wrap theme={null}
הפוך את הפגישות והאימיילים של השבוע למסמך Doc ולגיליון Sheet.
```

**Scopes**

> המחבר הזה מבקש את ה-scopes שלמטה ב-6 שירותים, ולכן הוא צריך יותר גישה ממחבר נפרד.
>
> * **Gmail:** `gmail.readonly`, `gmail.modify`, `gmail.compose`, `gmail.send`
> * **Calendar:** `calendar.readonly`, `calendar.settings.readonly`, `calendar.events`
> * **Contacts:** `contacts.readonly`
> * **Drive:** `drive.readonly`, `drive`
> * **Docs:** `documents.readonly`, `documents`
> * **Sheets:** `spreadsheets.readonly`, `spreadsheets`
>
> כל scope מתואר תחת השירות שלו ב[שירותי Google](#google-services).
>
> **גישה:** האפליקציה עובדת עם הנתונים של חשבון ה-Google שמאשר את החיבור.

***

## חיבור שירות Google

חבר שירות Google דרך חשבון משותף אחד, או אפשר לכל אדם לחבר את החשבון שלו.

**מחבר משותף**

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

**כדי להוסיף מחבר Google משותף:**

1. לחץ על **Connectors** בסרגל הצד של אזור העבודה.
2. לחץ על **Add connector**.
3. חפש את השירות שאתה רוצה, כמו **Google Calendar** או **Google Workspace**, ולחץ עליו.
4. בחר **Shared connector** ולחץ על **Next**.
5. הזן **Connection name**.
6. בחר ב-**Who can access** היכן אפשר להשתמש בחיבור. ברירת המחדל היא **Apps and Super agent**.
7. אם מופיע **Permissions**, בחר **Read-only** כדי לצפות בנתונים, או **Read & write** אם האפליקציה צריכה לשלוח, ליצור או לשנות אותם. ברירת המחדל היא **Read-only**.
8. לחץ על **Add connector**, ואז התחבר עם חשבון ה-Google שאתה רוצה לשתף.
9. פתח את האפליקציה בעורך האפליקציות.
10. בקש מצ'אט ה-AI להשתמש בחיבור ה-Google המשותף עבור התכונה שאתה רוצה לבנות.

**מחבר למשתמשי אפליקציה**

כל אדם מחבר את חשבון ה-Google שלו, כך שהאפליקציה עובדת עם הנתונים שלו. ‏Google Calendar מציע גם את **Let Base44 manage OAuth**.

> [!TIP]
>
> **לפני שמתחילים:** בעלים ומנהלים של אזור העבודה מגדירים מחברים למשתמשי אפליקציה. כדי לאפשר ל-Base44 לנהל את ה-OAuth, צריך [מסלול Pro](https://base44.com/pricing) ומעלה. אם אתה משתמש בלקוח OAuth משלך, עיין ב[היקפי הרשאות](#scopes-and-permissions) לפני שאתה בונה.

אם אתה משתמש ב-**Let Base44 manage OAuth** עבור Google Calendar, דלג אל **כדי להוסיף מחבר Google למשתמשי אפליקציה**.

**כדי להכין לקוח OAuth משלך:**

1. צור פרויקט או בחר פרויקט קיים ב-Google Cloud console.
2. הפעל את ה-API של כל שירות Google שהאפליקציה משתמשת בו.
3. הגדר את מסך ההסכמה של OAuth עם ה-scopes שאתה מתכנן לבקש.
4. כל עוד אפליקציית ה-OAuth במצב בדיקה, הוסף כמשתמשי בדיקה את חשבונות ה-Google שאיתם תבדוק.
5. צור לקוח OAuth לאפליקציית ווב.
6. הוסף את `https://connectors.base44.com/api/oauth/callback` כ-URI הפניה מורשה.
7. העתק את ה-Client ID ואת ה-Client Secret.

**כדי להוסיף מחבר Google למשתמשי אפליקציה:**

1. לחץ על **Connectors** בסרגל הצד של אזור העבודה.
2. לחץ על **Add connector**.
3. חפש את השירות שאתה רוצה, כמו **Google Calendar** או **Google Drive**, ולחץ עליו.
4. בחר **App user connector** ולחץ על **Next**.
5. אם מופיע **Choose how to manage authentication**, בחר **Let Base44 manage OAuth** או **Use your own OAuth client**.
6. הזן **Connector name**.
7. אם אתה משתמש בלקוח OAuth משלך, הזן את ה-**Client ID** ואת ה-**Client Secret** שלו.
8. נקה תחת **Scopes** כל scope שהאפליקציה לא צריכה. עם לקוח OAuth משלך, אפשר להוסיף scopes נוספים תחת **Additional scopes**. כדי לראות מה כל scope עושה, ראה [שירותי Google](#google-services).
9. לחץ על **Add Connector**.
10. פתח את האפליקציה בעורך האפליקציות.
11. בקש מצ'אט ה-AI להוסיף דרך שבה אנשים יוכלו לחבר את חשבון ה-Google שלהם.

***

## שירותי Google

מצא את השירות שהאפליקציה משתמשת בו כדי לראות מה הוא יכול לעשות ואילו scopes הוא מבקש.

למחברי Google אחרים, כמו Google Analytics,‏ Google Meet ו-Google Search Console, ראה את [קטלוג המחברים](https://docs.base44.com/he/Integrations/connectors-catalog.md).

### Gmail

שלח, קרא ונהל אימיילים ב-[Gmail](https://base44.com/integrations/connectors/gmail).

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את שורת הנושא, גוף ההודעה, העיצוב, הנמענים וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
שלח אימיילי אישור אוטומטיים כשמתבצעת הזמנה חדשה.
```

```text wrap theme={null}
קרא ונתח אימיילים נכנסים כדי ליצור פניות תמיכה.
```

```text wrap theme={null}
הפעל תהליך עבודה אוטומטית כשמגיע אימייל חדש.
```

```text wrap theme={null}
שלח אימיילי מעקב מותאמים אישית ללידים חדשים.
```

```text wrap theme={null}
עדכן חברי צוות באימייל כשמוקצות להם משימות.
```

**Scopes**

> קריאת תוכן הדואר היא scope מוגבל (restricted) של Google.
>
> שמות ה-scopes של Gmail מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `gmail.readonly`: קריאת הודעות ומטא-נתונים
> * `gmail.modify`: קריאה, תיוג ושינוי של הודעות, בלי מחיקה לצמיתות
> * `gmail.compose`: יצירת טיוטות ושליחת אימייל
> * `gmail.send`: שליחת הודעות
> * `gmail.labels`: ניהול תוויות
> * `gmail.settings.basic`: ניהול מסננים, חתימות ומענה אוטומטי בחופשה
>
> **גישה:** האפליקציה עובדת עם הדואר של חשבון ה-Gmail שמאשר את החיבור.

### Google Calendar

גש לאירועים ב-[Google Calendar](https://base44.com/integrations/connectors/google-calendar) ונהל אותם.

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את היומן, את האירועים, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
סנכרן את כל ההזמנות שלי ישירות ל-Google Calendar שלי.
```

```text wrap theme={null}
הצג ללקוחות את הזמינות שלי בזמן אמת מ-Google Calendar.
```

```text wrap theme={null}
הרץ אוטומציה כשאירוע ביומן נוצר או מתעדכן.
```

```text wrap theme={null}
חסום אוטומטית זמני פגישות ביומן האישי שלי.
```

```text wrap theme={null}
הוסף אירועים חדשים ליומן כשמשימה מסומנת כהושלמה.
```

**Scopes**

> ה-scope הרחב `calendar` מנהל את כל היומנים. לכן בחר scope מצומצם יותר כשהאפליקציה רק קוראת אירועים או זמינות. עם **Let Base44 manage OAuth**, הבורר מציע רק את ה-scopes המצומצמים.
>
> שמות ה-scopes של Google Calendar מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `calendar`: ניהול כל היומנים והאירועים
> * `calendar.readonly`: צפייה בכל היומנים, האירועים וההגדרות שלהם
> * `calendar.events`: ניהול אירועים ביומנים
> * `calendar.events.readonly`: צפייה באירועים ביומנים
> * `calendar.events.freebusy`: צפייה במידע פנוי/תפוס מהיומנים בלי לראות את פרטי האירועים
> * `calendar.freebusy`: צפייה במידע פנוי/תפוס של יומנים
> * `calendar.app.created`: ניהול יומנים שהאפליקציה יצרה
> * `calendar.calendarlist.readonly`: צפייה ברשימת היומנים
> * `calendar.events.public.readonly`: צפייה באירועים ציבוריים ביומנים
> * `calendar.settings.readonly`: צפייה בהגדרות Google Calendar
>
> **גישה:** האפליקציה עובדת עם היומנים של חשבון ה-Google שמאשר את החיבור.

### Google Contacts

קרא, צור ונהל אנשי קשר ב-Google Contacts.

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את אנשי הקשר, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
בנה CRM שמסנכרן לקוחות בשני הכיוונים עם Google Contacts שלי.
```

```text wrap theme={null}
ייבא לידים מאנשים ששלחתי להם אימייל אבל לא שמרתי כאנשי קשר.
```

```text wrap theme={null}
נתח את רשת אנשי הקשר שלי וסווג אנשי קשר אוטומטית עם AI.
```

```text wrap theme={null}
צור ספרייה ניתנת לחיפוש של החברה מארגון Google Workspace שלי.
```

```text wrap theme={null}
שמור אוטומטית לקוחות חדשים כאנשי קשר כשהם נרשמים.
```

**Scopes**

> בחר `contacts.readonly` כשהאפליקציה צריכה רק לקרוא אנשי קשר שמורים.
>
> שמות ה-scopes של Google Contacts מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `contacts.readonly`: צפייה באנשי קשר
> * `contacts`: צפייה, יצירה, עריכה ומחיקה של אנשי קשר
> * `contacts.other.readonly`: צפייה באנשי קשר אחרים, כמו אנשים ששלחת להם אימייל אבל לא שמרת
> * `directory.readonly`: צפייה בספריית Google Workspace של הארגון
>
> **גישה:** האפליקציה עובדת עם אנשי הקשר של חשבון ה-Google שמאשר את החיבור.

### Google Drive

חפש, גש ונהל קבצים ב-[Google Drive](https://base44.com/integrations/connectors/google-drive).

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את הקבצים או התיקיות, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
הצג באפליקציה שלי רשימה של כל הקבצים ב-Google Drive שלי.
```

```text wrap theme={null}
חפש ב-Google Drive מסמכים שתואמים למילת מפתח והצג את התוצאות.
```

```text wrap theme={null}
שמור ב-Google Drive דוחות PDF שהאפליקציה שלי יוצרת.
```

```text wrap theme={null}
קרא גיליון אלקטרוני מ-Google Drive וייבא את הנתונים שלו לאפליקציה שלי.
```

```text wrap theme={null}
הפעל תהליך עבודה כשקובץ נוסף או מתעדכן ב-Drive.
```

**Scopes**

> ה-scope `drive` נותן לאפליקציה גישה לכל הקבצים והתיקיות ב-Google Drive. ה-scope `drive.file` מכסה רק את הקבצים שהאפליקציה יוצרת או פותחת.
>
> שמות ה-scopes של Google Drive מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `drive`: צפייה, יצירה, עריכה ומחיקה של כל הקבצים והתיקיות ב-Google Drive
> * `drive.readonly`: צפייה בכל הקבצים והתיקיות ב-Google Drive
> * `drive.file`: גישה רק לקבצים שהאפליקציה יוצרת או פותחת באישור
>
> **גישה:** האפליקציה עובדת עם קבצים ב-Google Drive של חשבון ה-Google שמאשר את החיבור.

### Google Docs

צור וערוך מסמכים ב-[Google Docs](https://base44.com/integrations/connectors/google-docs).

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את המסמך, מה מפעיל אותו וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
צור אוטומטית מסמכי סיכום פגישה.
```

```text wrap theme={null}
צור חוזים מתבניות עם נתוני הלקוח.
```

```text wrap theme={null}
עדכן מסמכים משותפים כשסטטוס הפרויקט משתנה.
```

```text wrap theme={null}
ייצא דוחות לפורמט Google Docs.
```

```text wrap theme={null}
שתף פעולה על מסמכים עם הערות של הצוות.
```

**Scopes**

> ה-scope `documents` מאפשר לאפליקציה לצפות ולערוך כל מסמך Google Docs בחשבון המחובר, לא רק את אלה שהיא יוצרת.
>
> שמות ה-scopes של Google Docs מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `documents`: צפייה, יצירה ועריכה של כל מסמכי Google Docs
> * `documents.readonly`: צפייה בכל מסמכי Google Docs
>
> **גישה:** האפליקציה עובדת עם המסמכים של חשבון ה-Google שמאשר את החיבור.

### Google Sheets

קרא וכתוב נתונים בגיליונות [Google Sheets](https://base44.com/integrations/connectors/google-sheets).

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את הגיליון, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
ייצא נתוני אפליקציה לגיליון Google Sheets.
```

```text wrap theme={null}
ייבא לידים מגיליון Google Sheet ל-CRM.
```

```text wrap theme={null}
עדכן אוטומטית את כמויות המלאי ב-Google Sheets.
```

```text wrap theme={null}
צור דוחות שבועיים ושמור אותם ב-Google Sheets.
```

```text wrap theme={null}
סנכרן שליחות טפסים למסד נתונים ב-Google Sheets.
```

**Scopes**

> ה-scope `spreadsheets` מאפשר לאפליקציה לשנות כל גיליון בחשבון, לא רק את אלה שהיא יוצרת.
>
> שמות ה-scopes של Google Sheets מתחילים ב-`https://www.googleapis.com/auth/`:
>
> * `spreadsheets`: צפייה, עריכה, יצירה ומחיקה של כל גיליונות Google Sheets
> * `spreadsheets.readonly`: צפייה בכל גיליונות Google Sheets
>
> **גישה:** האפליקציה עובדת עם הגיליונות של חשבון ה-Google שמאשר את החיבור.

***

## היקפי הרשאות

כשאתה משתמש בלקוח OAuth משלך, אפליקציית ה-OAuth שייכת לך ואתה מגיש את האימות שלה ל-Google. מחברי Google משותפים ו-**Let Base44 manage OAuth** פועלים על אפליקציית ה-OAuth של Base44, ולכן לא צריך להגיש עבורם שום דבר ל-Google. ראה [שימוש בלקוח OAuth משלך](https://docs.base44.com/he/Integrations/Connectors.md#using-your-own-oauth-client).

‏Google מחלקת את ההרשאות שהאפליקציה מבקשת ל-3 קטגוריות. הקטגוריות קובעות איזה אימות האפליקציה צריכה לפני שהיא עולה לאוויר. לכן בחר את ה-scopes המצומצמים ביותר שתומכים במה שהאפליקציה עושה. זה חשוב במיוחד ב-Gmail,‏ Drive ו-Calendar.

* **בסיסי (Basic):** מכסה שם, כתובת אימייל ופרופיל. ‏Google לא מבקשת שום דבר נוסף.
* **רגיש (Sensitive):** מכסה גישה רחבה יותר לשירות Google, כמו יצירת אירועים ביומן. ‏Google מבקשת אימות של האפליקציה, כולל בדיקה של אופן השימוש בנתונים.
* **מוגבל (Restricted):** מכסה קריאה של תוכן ההודעות או הקבצים של אדם, כמו קריאת Gmail. ‏Google מבקשת אימות של האפליקציה, ועשויה לדרוש גם הערכת אבטחה עצמאית שנתית.

> [!TIP]
>
> כדי לשלוח אימייל בלי אימות של scope מוגבל, בקש רק את `gmail.send`.

אימות של scope מוגבל יכול לקחת כמה שבועות. עד שהוא מסתיים, Google עשויה להגביל את מספר האנשים שיכולים להשתמש באפליקציה ולהציג אזהרה על אפליקציה לא מאומתת. אם Google דורשת הערכת אבטחה, מעריך עצמאי שמאושר על ידי Google בודק את האפליקציה לפי מסגרת CASA. ההערכה שואלת גם על הפלטפורמה שהאפליקציה רצה עליה וגם על הקוד שלך, לכן [פנה לצוות התמיכה](https://docs.base44.com/he/Community-and-support/Contacting-support.md) מוקדם. הדרישות, לוחות הזמנים והחריגים נקבעים על ידי Google. לכן עיין ב[תיעוד המפתחים של Google](https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification) לפני שאתה מתכנן לפיהם.

> [!NOTE]
>
> ‏Base44 תמיד מוסיפה את ה-scope `email` כדי לזהות את חשבון ה-Google. הוא תמיד כלול, ולכן מוצג כ-scope נעול תחת **Scopes**.

***

## שימוש בשירותי Google בפונקציית צד-שרת

אם אתה כותב פונקציות צד-שרת משלך, הן יכולות לקרוא ישירות ל-API של Google. ‏Base44 מטפלת בתהליך ה-OAuth ובאחסון האסימון.

בחיבור משותף, העבר ל-`getConnection()` מזהה שירות מהטבלה שלמטה. בחיבור של משתמש אפליקציה, העבר את המזהה של המחבר שלך, לא מזהה שירות.

**מחבר משותף**

```javascript theme={null}
// One account the whole app uses
const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");
// Use the access token to call the Google Calendar API.
```

**מחבר למשתמשי אפליקציה**

```javascript theme={null}
// The signed-in person's own account
const { accessToken } =
  await base44.asServiceRole.connectors.getCurrentAppUserConnection(
    "YOUR_CONNECTOR_ID",
  );
// Use the access token to call the Google API for that person.
```

| שירות | מזהה שירות (חיבורים משותפים) |
| - | - |
| Gmail | `gmail` |
| Google Calendar | `googlecalendar` |
| Google Contacts | `google_contacts` |
| Google Drive | `googledrive` |
| Google Docs | `googledocs` |
| Google Sheets | `googlesheets` |
| Google Workspace | `googleworkspace` |

> **[מחברים משותפים](https://docs.base44.com/he/developers/backend/resources/connectors/shared-connectors.md)**
>
> הגדר, פרוס וקרא לחיבור משותף מפונקציית צד-שרת.

> **[מחברים למשתמשי אפליקציה](https://docs.base44.com/he/developers/backend/resources/connectors/app-user-connectors.md)**
>
> קבל אסימון לכל משתמש וקרא ל-API בשם האדם המחובר.

***

## פתרון בעיות

אם אתה משתמש בלקוח OAuth משלך, בדוק את הדברים הבאים כשאנשים לא מצליחים לחבר את חשבון ה-Google שלהם.

> **חלק מהאנשים לא מצליחים לחבר את החשבון שלהם**
>
> לקוח OAuth משלך מתחיל במצב בדיקה, שבו רק משתמשי בדיקה מאושרים יכולים להתחבר. לפני שאתה פותח את הגישה לקהל רחב יותר, העבר את אפליקציית ה-OAuth לייצור והשלם כל אימות ש-Google דורשת.

> **החיבור נכשל עם שגיאת redirect URI**
>
> רשום את כתובת ה-callback שהחיבור משתמש בה כ-URI הפניה מורשה בלקוח ה-OAuth שלך ב-Google:
>
> * לכתובת callback יחידה, הזן בדיוק את `https://connectors.base44.com/api/oauth/callback`.
> * לכתובות callback לכל אפליקציה, ראה [הצגת כתובות ה-callback](https://docs.base44.com/he/Integrations/Connectors.md#viewing-your-callback-urls).

> [!NOTE]
>
> דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.