מחברי Google Workspace

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

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

מה אפשר לעשות

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

אוטומציה של אימייל

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

סנכרון יומנים ואנשי קשר

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

עבודה עם קבצים ונתונים

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

מחבר Google Workspace

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

תכיר אותי - עבור על האימיילים, הפגישות וקבצי ה-Drive שלי וספר לי על מה אני עובד.

היה העוזר האישי שלי: עקוב אחרי תיבת הדואר והיומן שלי וספר לי מה דורש את תשומת לבי היום.

הכן את הפגישה הבאה שלי משרשורי אימייל קשורים, מקבצים ומהפרטים של המשתתפים.

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

הפוך את הפגישות והאימיילים של השבוע למסמך 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 שמאשר את החיבור.

חיבור שירות Google

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

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

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

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

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

לפני שמתחילים: בעלים ומנהלים של אזור העבודה מגדירים מחברים למשתמשי אפליקציה. כדי לאפשר ל-Base44 לנהל את ה-OAuth, צריך מסלול Pro ומעלה. אם אתה משתמש בלקוח OAuth משלך, עיין בהיקפי הרשאות לפני שאתה בונה.

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

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

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

לחץ על Connectors בסרגל הצד של אזור העבודה.
לחץ על Add connector.
חפש את השירות שאתה רוצה, כמו Google Calendar או Google Drive, ולחץ עליו.
בחר App user connector ולחץ על Next.
אם מופיע Choose how to manage authentication, בחר Let Base44 manage OAuth או Use your own OAuth client.
הזן Connector name.
אם אתה משתמש בלקוח OAuth משלך, הזן את ה-Client ID ואת ה-Client Secret שלו.
נקה תחת Scopes כל scope שהאפליקציה לא צריכה. עם לקוח OAuth משלך, אפשר להוסיף scopes נוספים תחת Additional scopes. כדי לראות מה כל scope עושה, ראה שירותי Google.
לחץ על Add Connector.
פתח את האפליקציה בעורך האפליקציות.
בקש מצ’אט ה-AI להוסיף דרך שבה אנשים יוכלו לחבר את חשבון ה-Google שלהם.

שירותי Google

מצא את השירות שהאפליקציה משתמשת בו כדי לראות מה הוא יכול לעשות ואילו scopes הוא מבקש. למחברי Google אחרים, כמו Google Analytics,‏ Google Meet ו-Google Search Console, ראה את קטלוג המחברים.

Gmail

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

שלח אימיילי אישור אוטומטיים כשמתבצעת הזמנה חדשה.

קרא ונתח אימיילים נכנסים כדי ליצור פניות תמיכה.

הפעל תהליך עבודה אוטומטית כשמגיע אימייל חדש.

שלח אימיילי מעקב מותאמים אישית ללידים חדשים.

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

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 ונהל אותם. הנחיות לדוגמה תאר בצ’אט ה-AI את היומן, את האירועים, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

סנכרן את כל ההזמנות שלי ישירות ל-Google Calendar שלי.

הצג ללקוחות את הזמינות שלי בזמן אמת מ-Google Calendar.

הרץ אוטומציה כשאירוע ביומן נוצר או מתעדכן.

חסום אוטומטית זמני פגישות ביומן האישי שלי.

הוסף אירועים חדשים ליומן כשמשימה מסומנת כהושלמה.

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 את אנשי הקשר, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

בנה CRM שמסנכרן לקוחות בשני הכיוונים עם Google Contacts שלי.

ייבא לידים מאנשים ששלחתי להם אימייל אבל לא שמרתי כאנשי קשר.

נתח את רשת אנשי הקשר שלי וסווג אנשי קשר אוטומטית עם AI.

צור ספרייה ניתנת לחיפוש של החברה מארגון Google Workspace שלי.

שמור אוטומטית לקוחות חדשים כאנשי קשר כשהם נרשמים.

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. הנחיות לדוגמה תאר בצ’אט ה-AI את הקבצים או התיקיות, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

הצג באפליקציה שלי רשימה של כל הקבצים ב-Google Drive שלי.

חפש ב-Google Drive מסמכים שתואמים למילת מפתח והצג את התוצאות.

שמור ב-Google Drive דוחות PDF שהאפליקציה שלי יוצרת.

קרא גיליון אלקטרוני מ-Google Drive וייבא את הנתונים שלו לאפליקציה שלי.

הפעל תהליך עבודה כשקובץ נוסף או מתעדכן ב-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. הנחיות לדוגמה תאר בצ’אט ה-AI את המסמך, מה מפעיל אותו וכל שדה דינמי. לדוגמה:

צור אוטומטית מסמכי סיכום פגישה.

צור חוזים מתבניות עם נתוני הלקוח.

עדכן מסמכים משותפים כשסטטוס הפרויקט משתנה.

ייצא דוחות לפורמט Google Docs.

שתף פעולה על מסמכים עם הערות של הצוות.

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. הנחיות לדוגמה תאר בצ’אט ה-AI את הגיליון, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

ייצא נתוני אפליקציה לגיליון Google Sheets.

ייבא לידים מגיליון Google Sheet ל-CRM.

עדכן אוטומטית את כמויות המלאי ב-Google Sheets.

צור דוחות שבועיים ושמור אותם ב-Google Sheets.

סנכרן שליחות טפסים למסד נתונים ב-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 משלך. ‏Google מחלקת את ההרשאות שהאפליקציה מבקשת ל-3 קטגוריות. הקטגוריות קובעות איזה אימות האפליקציה צריכה לפני שהיא עולה לאוויר. לכן בחר את ה-scopes המצומצמים ביותר שתומכים במה שהאפליקציה עושה. זה חשוב במיוחד ב-Gmail,‏ Drive ו-Calendar.

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

כדי לשלוח אימייל בלי אימות של scope מוגבל, בקש רק את gmail.send.

אימות של scope מוגבל יכול לקחת כמה שבועות. עד שהוא מסתיים, Google עשויה להגביל את מספר האנשים שיכולים להשתמש באפליקציה ולהציג אזהרה על אפליקציה לא מאומתת. אם Google דורשת הערכת אבטחה, מעריך עצמאי שמאושר על ידי Google בודק את האפליקציה לפי מסגרת CASA. ההערכה שואלת גם על הפלטפורמה שהאפליקציה רצה עליה וגם על הקוד שלך, לכן פנה לצוות התמיכה מוקדם. הדרישות, לוחות הזמנים והחריגים נקבעים על ידי Google. לכן עיין בתיעוד המפתחים של Google לפני שאתה מתכנן לפיהם.

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

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

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

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

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

// 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`

מחברים משותפים

הגדר, פרוס וקרא לחיבור משותף מפונקציית צד-שרת.

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

קבל אסימון לכל משתמש וקרא ל-API בשם האדם המחובר.

פתרון בעיות

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

חלק מהאנשים לא מצליחים לחבר את החשבון שלהם

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

החיבור נכשל עם שגיאת redirect URI

רשום את כתובת ה-callback שהחיבור משתמש בה כ-URI הפניה מורשה בלקוח ה-OAuth שלך ב-Google:

לכתובת callback יחידה, הזן בדיוק את https://connectors.base44.com/api/oauth/callback.
לכתובות callback לכל אפליקציה, ראה הצגת כתובות ה-callback.

דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.

תחילת העבודה

בניית האפליקציה

אבטחת האפליקציה

קידום האפליקציה

מחברים

יומן שינויים

מה אפשר לעשות

אוטומציה של אימייל

סנכרון יומנים ואנשי קשר

עבודה עם קבצים ונתונים

מחבר Google Workspace

חיבור שירות Google

שירותי Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

היקפי הרשאות

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

מחברים משותפים

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

פתרון בעיות

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

אוטומציה של אימייל

סנכרון יומנים ואנשי קשר

עבודה עם קבצים ונתונים

​מחבר Google Workspace

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

​שירותי Google

​Gmail

​Google Calendar

​Google Contacts

​Google Drive

​Google Docs

​Google Sheets

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

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

מחברים משותפים

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

​פתרון בעיות

מה אפשר לעשות

מחבר Google Workspace

חיבור שירות Google

שירותי Google

Gmail

Google Calendar

Google Contacts

Google Drive

Google Docs

Google Sheets

היקפי הרשאות

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

פתרון בעיות