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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי להפעיל את האפשרות גיליונות מקושרים בתפריט גלגל השיניים 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 ופותחים את Google Sheets API.

    כניסה ל-Google Sheets API

  2. ב Google Cloud מסוף, פותחים את הכלי לבחירת פרויקטים ובוחרים את הפרויקט שרוצים להשתמש בו כדי להתחבר ל-Google Sheets מהחקירות ב-Looker. אתם צריכים להשתמש באותו פרויקט במסוף 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, לוחצים על הכפתור Add URI. מוסיפים את ה-URI הבא:

    https://LOOKER_INSTANCE_URL/oauth2callback

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

    https://LOOKER_INSTANCE_URL/external_oauth/redirect

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

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

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

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

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

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

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

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

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

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

פתרון בעיות

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