קישור מהיר לגיליונות מקושרים

בדף הזה מוסבר איך להפעיל את האפשרות גיליונות מקושרים בתפריט ההגדרות (סמל גלגל השיניים) פעולות בדוח ב-Looker ואיך להשתמש בה. האפשרות גיליונות מקושרים פותחת את Google Sheets ויוצרת קישור מ-Google Sheets אל Looker Explore. לאחר מכן תוכלו ליצור דוחות, טבלאות צירים או תרשימים בגיליון האלקטרוני החדש של Google Sheets באמצעות השדות מניתוח הנתונים שנבחר ב-Looker.

לפני שמתחילים

כדי להשתמש בקישור המהיר גיליונות מקושרים, צריך:

אם האדמין שלכם ב-Looker הפעיל את התכונה, אתם יכולים ליצור קישור בין Google Sheets לבין כל דוח Explore שיש לכם גישה אליו:

  1. מתחברים ל-Looker באמצעות כתובת האימייל שמשויכת לחשבון Google.

  2. ב-Looker, עוברים לניתוח שרוצים להשתמש בו כמקור נתונים.

  3. לוחצים על סמל גלגל השיניים Explore actions ובוחרים באפשרות Connected Sheets.

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

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

  6. בכרטיסייה חדשה בדפדפן נפתח Google Sheets ומוצג דו-שיח שבו נשאלים אם רוצים לקשר את חשבון Google לחשבון Looker. לוחצים על קישור החשבון.

גיליון Google Sheets מקושר עכשיו ל-Looker Explore שממנו התחלתם. בגיליון האלקטרוני של Google Sheets, אתם יכולים להוסיף שדות מ'ניתוח נתונים', ליצור טבלאות צירים, לבנות תרשימים ולהחיל נוסחאות כדי לנתח את הנתונים מ'ניתוח נתונים' ב-Looker.

מידע נוסף על יצירת שאילתות בגיליונות מקושרים זמין במאמר שימוש בגיליונות מקושרים ל-Looker.

הפעלה והגדרה של הקישור המהיר 'גיליונות מקושרים'

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

כדי להפעיל את האפשרות Connected Sheets בתפריט ההגדרות Explore actions במופע Looker, אדמין צריך לבצע את המשימות הכלליות האלה, שמתוארות בקטעים הבאים:

הפעלת Google Sheets API במסוף Google Cloud

הקישור המהיר גיליונות משולבים משתמש ב-Google Sheets API, ולכן צריך להפעיל את ה-API הזה באותו פרויקט שבו תשתמשו כדי ליצור את לקוח OAuth. משתמש IAM עם הרשאת IAM‏ roles/serviceusage.serviceUsageAdmin יכול להפעיל את Google Sheets API.

כדי להפעיל את Google Sheets API:

  1. בתפריט הניווט של מסוף Google Cloud , עוברים אל APIs & Services > Library (ממשקי API ושירותים > ספרייה) ופותחים את Google Sheets API.

    מעבר אל Google Sheets API

  2. במסוף, לוחצים על Open project picker ובוחרים את הפרויקט שבו רוצים להשתמש כדי להתחבר ל-Google Sheets מתוך Looker Explores. Google Cloud צריך להשתמש באותו פרויקט במסוף Google Cloud לאורך כל תהליך ההגדרה של הקישור המהיר של 'גיליונות משולבים', כדי ש-Google Sheets API יופעל באותו פרויקט שבו מגדירים את OAuth.

  3. בדף Google Sheets API, לוחצים על Enable אם ה-API עדיין לא מופעל.

יצירת לקוח OAuth

משתמש IAM עם התפקידים הנדרשים צריך ליצור לקוח OAuth.

אפשר להגדיר את לקוח OAuth בכל Google Cloud פרויקט שרוצים. עם זאת, צריך להפעיל את Google Sheets API באותו פרויקט.

כדי ליצור את הלקוח ואת פרטי הכניסה שלו, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , משתמשים ב Google Cloud כלי לבחירת פרויקט כדי לפתוח את אותו פרויקט שבו הפעלתם את Google Sheets API.

    כניסה ל Google Cloud מסוף

  2. בתפריט הראשי של מסוף Google Cloud , עוברים אל APIs & Services > Credentials.

  3. בדף Credentials, לוחצים על התפריט הנפתח Create Credentials ובוחרים באפשרות מזהה לקוח OAuth.

  4. בתפריט הנפתח Application type בוחרים באפשרות אפליקציית אינטרנט.

  5. בשדה Name (שם), מזינים שם ללקוח OAuth, כמו Looker to Connected Sheets.

  6. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על הלחצן Add URI (הוספת כתובת URI). מוסיפים את ה-URI הבא:

    https://LOOKER_INSTANCE_URL/oauth2callback

  7. לוחצים על הלחצן הוספת URI כדי להוסיף גם את ה-URI הבא:

    https://LOOKER_INSTANCE_URL/external_oauth/redirect

  8. לוחצים על יצירה.

  9. אחרי שלוחצים על יצירה, מופיע החלון נוצר לקוח OAuth. בחלון הזה מוצגים מזהה הלקוח וסוד הלקוח שנוצרו במסוף Google Cloud עבור לקוח OAuth. מעתיקים את הערכים האלה ורושמים אותם, כי תצטרכו אותם כשתגדירו את האפשרות 'הפעלת קישור מהיר ל-Connected Sheets'.

הגדרת האפשרות 'הפעלת קישור מהיר לגיליונות מקושרים'

אחרי שמפעילים את Google Sheets API ב Google Cloud מסוף ויוצרים את לקוח OAuth ב Google Cloud מסוף, אפשר להפעיל את הקישור המהיר Connected Sheets במופע Looker באמצעות השלבים הבאים:

  1. במופע Looker, בוחרים באפשרות BI Connectors (מחברי BI) בקטע Platform (פלטפורמה) בחלונית Admin (ניהול).
  2. מפעילים את המתג Google Sheets אם הוא עדיין לא מופעל.
  3. מפעילים את המתג המשובץ הפעלת קישור מהיר ל-Connected Sheets.
  4. בשדות מזהה לקוח וסוד לקוח, מדביקים את הערכים שהעתקתם מ Google Cloud המסוף כשיצרתם את לקוח OAuth ב Google Cloud מסוף.
  5. לוחצים על Save.

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

מעבר מתוכנית הפיילוט

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

כדי לעבור לגרסה החדשה, אדמין צריך להגדיר לקוח OAuth משלו לארגון ב Google Cloud מסוף ואז להגדיר את פרטי הכניסה בדף האדמין של Looker BI Connectors. השלבים זהים לאלה של ההגדרה הראשונית, שמתוארים בקטעים הבאים בדף הזה:

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

פתרון בעיות

  • שגיאה של אי התאמה בכתובת האימייל: אם נתקלתם בשגיאה במהלך שלב האימות של Google, ודאו שכתובת האימייל בחשבון Google שבחרתם זהה לכתובת האימייל בחשבון המשתמש שלכם ב-Looker.
  • האפשרות 'גיליונות מחוברים' לא מוצגת: האפשרות הזו תופיע בתפריט ההגדרות (סמל גלגל השיניים) של פעולות ב'חיפוש והצגה' רק אם האדמין של Looker הפעיל את התכונה בהגדרות של BI Connectors. לקבלת עזרה, פנו לאדמין ב-Looker.
  • Google Cloud הרשאות במסוף: לאדמין שמגדיר את לקוח OAuth ואת מסך ההסכמה צריכות להיות ההרשאות roles/oauthconfig.editor ו-roles/serviceusage.serviceUsageAdmin ב Google Cloud פרויקט.
  • אם יש לכם בעיות אחרות או משוב במהלך תקופת התצוגה המקדימה הפתוחה, אתם יכולים לשלוח אימייל לכתובת looker-connected-sheets-external@google.com.