ממשק API לקישור

מבוא

Linking API מספק ממשק מהימן להגדרה ולהעברה של משתמשים ישירות לדוח Looker Studio דרך כתובת URL. כשמשתמשים מפעילים קישור API כתובת ה-URL שהם יוכלו ליהנות מחוויית שימוש יעילה כדי לצפות בה במהירות וליצור איתה אינטראקציה בנתונים שלהם.

במסמך זה מתואר הפורמט הנדרש של כתובות URL של Linking API, וכן פרמטרים זמינים נוספים.

תרחיש לדוגמה ויתרונות

אפשר להשתמש ב-Link API כדי לספק ללקוחות דוחות שהוגדרו מראש כדי להציג את הנתונים שלהם ולקיים איתם אינטראקציה. אלה היתרונות המרכזיים של ממשק ה-API לקישור ככה:

  • חוויה ליצירת דוחות בלחיצה אחת עבור הלקוחות.
    • הגדרת הנתונים מסופקת בכתובת ה-URL כך שהמשתמשים לא צריכים להגדיר את הדוח עם הנתונים שלהם.
    • המשתמשים יכולים לשמור את הדוח בלחיצה אחת ולחזור אל הדוח בכתובת בכל שלב.
  • יצירת דוחות בקנה מידה נרחב. Linking API מפחית את הזמן שנדרש כדי לשכפל או ליצור דוחות חדשים.
  • מפעילים שילובי מוצרים. הממשק היציב מאפשר לכם לשלב את Looker Studio בתהליך העבודה של המוצר.

איך זה עובד

בהמשך מוסבר על האינטראקציה של מפתחים ומשתמשים עם ה-Link API.

קישור תהליך העבודה של מפתחי API

המפתח מכין את תבניות הדוחות, מקורות הנתונים והפורמטים של קישור כתובת ה-URL של ה-API. תהליך העבודה האופייני למפתחים הוא:

  1. מחליטים אם להשתמש בדוח ריק – תבנית הדוח שמוגדרת כברירת המחדל. של Looker Studio או ליצור דוח של Looker Studio שישמש תבנית. הפעולות האלה כוללות הגדרה של מקורות הנתונים של התבניות.
  2. עיצוב כתובת URL של Linking API בהתאם לתרחיש הספציפי לדוגמה שלכם. אם רלוונטי, יש לציין תבנית הדוח ופרמטרים אחרים, כולל שם הדוח, הנתונים שם המקור וההגדרות האישיות של מקור הנתונים.
  3. משתמשים בכתובת ה-URL של ה-API לקישור כדי להפנות משתמשים לדוח.

קישור חוויית המשתמש ב-API

המשתמש עוקב אחר כתובת URL של Linking API, שאם היא מוגדרת כראוי על ידי יפנה אותם לדוח Looker Studio שמאפשר להם להציג וליצור אינטראקציה עם נתונים שיש להם גישה אליהם. חוויית משתמש טיפוסית יכולה להיות ככה:

  1. בדפדפן, המשתמש מבקר בשירות שמשולב עם הקישור API.
  2. קריאה לפעולה מזמינה את המשתמש ללחוץ על קישור כדי לצפות בנתונים שלו Looker Studio.
  3. המשתמש לוחץ על הקישור ומועבר לדוח Looker Studio. נטען והמשתמש יכול להציג את הנתונים שלו ולקיים איתם אינטראקציה.
  4. המשתמש לוחץ על 'עריכה ושיתוף'. הדוח נשמר ב-Looker Studio חשבון.
  5. למשתמש יש עכשיו גישה מלאה ושליטה בעותק שלו של הדוח. הם יכולים להציג, לערוך ולשתף בכל שלב.

דרישות

כדי להבטיח שכתובת URL של Linking API תפעל כצפוי, נדרשים:

  1. דוח שמשמש כתבנית. אם לא סופק, דוח ריק או אפשר להשתמש בדוח ברירת המחדל שסופק על ידי Looker Studio.
  2. משתמשים בכתובת URL של Linking API חייבים להיות, לכל הפחות, גישת צפייה אל תבנית דוח. בהתאם לסוג מקורות הנתונים שנעשה בהם שימוש בדוח ובתצורה שמסופקת דרך ה-Link API, המשתמשים עשויים לדרוש גם צפייה במקורות נתונים. בקטע הרשאות תבנית יש הסבר על פרטים.
  3. סוג המחבר של כל מקור נתונים חייב לתמוך בהגדרה דרך ממשק API לקישור. רשימה של מכשירים נתמכים זמינה בחומר העזר בנושא מחברים מחברים אחרים.
  4. למשתמשים בכתובת ה-URL של ה-API לקישור צריכה להיות גישה לנתונים שהוגדרו ב- כתובת ה-URL של ה-API בקישור. אם למשתמש אין גישה לנתונים הבסיסיים, כל רכיבי הדוח התלויים יציגו שגיאה.

פרמטרים של כתובת אתר

כתובת ה-URL של ה-API לקישור צריכה להיות בפורמט הבא:

https://lookerstudio.google.com/reporting/create?parameters

יש להשתמש בכתובת ה-URL בהקשר של דפדפן אינטרנט, בדרך כלל על ידי משתמש לוחץ על קישור או מופנה לכתובת ה-URL. אפשר להשתמש בו גם כדי מטמיעים דוח.

כתובת URL לדוגמה

לפניכם דוגמה לכתובת URL של Linking API. שם הדוח מוגדר הוגדר מקור נתונים ב-BigQuery:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.connector=bigQuery
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

יש פרמטרים של כתובות אתרים שחובה לספק, ויש פרמטרים שהם אופציונליים. בהמשך מופיע רשימת הפרמטרים שמשמשים להגדרת כתובת URL של Linking API:

פרמטרים של בקרה

פרמטרים של בקרה קובעים את מצב הדוח כשמציגים אותו דרך הקישור כתובת ה-URL של ה-API.

שם הפרמטר תיאור
c.reportId
זה שינוי אופציונלי. מזהה הדוח של התבנית. אפליקציית Looker Studio תיפתח ויוגדר הדוח שצוין. הוראות למציאת המזהה מפורטות כאן מזהה הדיווח. אם לא צוין דוח ריק או שבתבנית ברירת המחדל של הדוח, ראה שימוש בתבנית ריק או דוח ברירת מחדל לפרטים.
c.pageId
זה שינוי אופציונלי. המזהה של הדף הראשון שנטען בדוח. ברירת המחדל היא הדף הראשון של הדוח אם לא צוין אחרת, .
c.mode
זה שינוי אופציונלי. מצב הדיווח הראשוני. אחד מ- view או edit אם לא צויין ערך, ערך ברירת המחדל הוא view.
c.explain
זה שינוי אופציונלי. הרשאות הגישה לתיבת הדו-שיח למידע או לניפוי באגים. הגדרה לערך true כדי להציג את הלחצן של תיבת הדו-שיח. ברירת המחדל היא false אם לא צוין. ראו מידע נוסף על פתרון בעיות שקשורות להגדרות האישיות

דוגמה

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &c.pageId=g7u8s9
  &c.mode=edit
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

פרמטרים של דוח

פרמטרים של דוח מבטלים את מאפייני הדוח.

שם הפרמטר תיאור
r.reportName
זה שינוי אופציונלי. מגדיר את שם הדוח. אם לא צוין, ברירת המחדל היא שם הדוח של התבנית.
r.measurementId

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

אם r.measurementId וגם r.keepMeasurementId לא צוינו, הדוח מזהי מדידה של Google Analytics ערך ברירת המחדל הוא לא מוגדר. אם r.measurementId וגם הערכים r.keepMeasurementId מוגדרים, r.keepMeasurementId מקבל עדיפות על הגדרת המזהה.

r.keepMeasurementId

זה שינוי אופציונלי. כדי להשתמש בדוח התבנית צריך להגדיר את הערך true מזהי מדידה של Google Analytics. ברירת המחדל היא false. אם לא צוין

אם r.measurementId וגם r.keepMeasurementId לא צוינו, הדוח מזהי מדידה של Google Analytics ערך ברירת המחדל הוא לא מוגדר. אם r.measurementId וגם הערכים r.keepMeasurementId מוגדרים, r.keepMeasurementId מקבל עדיפות על הגדרת המזהה.

דוגמה

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &r.measurementId=G-XXXXXXXXXX
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.projectId=project-1234
  &ds.ds0.type=TABLE
  &ds.ds0.datasetId=456
  &ds.ds0.tableId=789

פרמטרים של מקור נתונים

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

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

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

פרמטרים של מקור נתונים

הפרמטרים הבאים משותפים בכל סוגי המחברים:

שם תיאור
ds.alias.datasourceName

זה שינוי אופציונלי. מגדיר את השם של מקור הנתונים.

אם ds.datasourceName וגם לא צוין ds.keepDatasourceName, שם מקור הנתונים מוגדר כברירת מחדל למוסכמות מתן שמות שכוללות את סוג המחבר ואת שעת היצירה (למשל דגימות - 12/12/21, 22:53). אם המיקום ds.datasourceName ו-ds.keepDatasourceName הם מוגדר, ds.datasourceName מקבל קדימות להגדרת הנתונים שם המקור.

ds.alias.keepDatasourceName

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

אם ds.datasourceName וגם לא צוין ds.keepDatasourceName, שם מקור הנתונים מוגדר כברירת מחדל למוסכמות מתן שמות שכוללות את סוג המחבר ואת שעת היצירה (למשל דגימות - 12/12/21, 22:53). אם המיקום ds.datasourceName ו-ds.keepDatasourceName הם מוגדר, ds.datasourceName מקבל קדימות להגדרת הנתונים שם המקור.

ds.alias.connector
זה שינוי אופציונלי.

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

אם המדיניות מוגדרת, כל הנדרש את הפרמטרים של המחבר לסוג המחבר יש לציין הקישור בין כתובת ה-URL של ה-API לבין ההגדרה של מקור הנתונים בתבנית יהיה הוחלף בשלמותו.

אם לא צוין, אפס או יותר את הפרמטרים של המחבר לסוג המחבר ניתן לציין כתובת ה-URL של ה-API בקישור. ההגדרה של מקור נתוני התבנית תשמש כדי: לציין פרמטרים שלא סופקו בכתובת ה-URL של ה-API לקישור. לפרטים שמסביר איך לזהות את סוג המחבר של מקור נתוני התבנית, סוג המחבר.

למידע נוסף על השפעת הפרמטר ds.connector האם ההגדרה של מקור נתונים בתבנית תוחלף במלואה או משמש לעדכון פרמטרים שלא צוינו, החלפה לעומת עדכון.

ds.alias.refreshFields
זה שינוי אופציונלי.

צריך להגדיר את הערך כ-true כדי להשתמש בהגדרה של מקור הנתונים שצוין באמצעות ה-Link API כדי רענון בשדות של מקור הנתונים ולעדכן את רכיבי הדוח בשדה חדש שנבחרו. true הוא בדרך כלל שצוינו כשמחליפים את סוג המחבר או עבור סוגי מחברים שבהם שינוי תצורה מוביל לשדות שונים (למשל, שדות של מקורות נתונים ב-BigQuery משתנים לעיתים קרובות בהתאם לטבלה שונה ).

כדי לצאת מהשדות של מקור הנתונים צריך להגדיר את הערך false ללא שינוי מדוח התבנית. false הוא בדרך כלל מצוין כאשר הגדרת הנתונים החדשה מפיקה את אותם שדות בדיוק ואתה מעדיף לשמור את השינויים שביצעת בשדה את מקור הנתונים של התבנית.

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

שיקולים לשימוש במאפיין refreshFields:
  • אם המדיניות refreshFields מוגדרת לערך false וגם הגדרת מקור נתונים שצוינה דרך Link API תפיק שונים מהשדות המשמשים בדוח התבנית, המשתמש סביר להניח שתוצג שגיאת הגדרה של הרכיבים המושפעים.
  • שינויים בשדות במקור הנתונים של התבנית (למשל: שם, סוג או צבירה וכו') לא יועברו למקורות נתונים חדשים כאשר הערך של refreshFields הוא true. סיום refreshFields עד false כדי לשמור על השדה ממקור הנתונים של התבנית.
  • שדות מחושבים וגם פרמטרים שהוגדרו במקורות הנתונים של התבניות תמיד יועתקו למקורות נתונים חדשים, ולא מושפעים מהערך של refreshFields
ds.alias.connectorParameters
נדרש. ההגדרה של מקור הנתונים סוג המחבר. לפרטים על זיהוי המחבר ששימש ליצירת מקור נתונים. סוג המחבר. פרטים על הנתונים הזמינים לכל סוג מחבר, חומר עזר בנושא המחבר.

החלפה לעומת עדכון – הגדרות של מקור נתונים

כשמגדירים פרמטרים של מקור נתונים, נוכחות או השמטה של בפרמטר ds.connector בכתובת ה-URL של ה-API לקישור מצוין מתכוונים להחליף או לעדכן את ההגדרה של מקור הנתונים בתבנית, בהתאמה.

בטבלה הבאה מפורט האופן שבו הפרמטר ds.connector משפיע ההגדרה של מקור הנתונים של התבנית תוחלף במלואה או משמשת לעדכון פרמטרים שלא צוינו:

האם ds.connector מוגדר? ההגדרות ואופן הפעולה הצפויים שימוש רגיל
כן החלפה. ההגדרה של מקור נתוני התבנית תוחלף במלואו, באמצעות הפרמטרים של מקור הנתונים שצוינו בקישור כתובת ה-URL של ה-API. צריך לציין את כל הפרמטרים הנדרשים עבור סוג מתקן הטעינה. ראו פרמטרים נדרשים כאשר ds.connector מוגדר.
  • כשמשנים את סוג המחבר של מקור נתונים. לדוגמה אם הגדרתם מקור נתונים של BigQuery בדוח התבנית, אבל אתם רוצים להגדיר מקור נתונים של Sheets דרך Linking API. לשם כך יידרשו הגדרת מחבר חדשה שתיקבע בשלמותה.
  • כשרוצים להבטיח את ההגדרה של מקור נתונים. החלפת ההגדרות האישיות מונעת ערכים לא ידועים שבו נעשה שימוש ממקור הנתונים של התבנית.
לא עדכון. ההגדרה של מקור נתוני התבנית תשמש כדי: לציין פרמטרים שלא סופקו בכתובת ה-URL של ה-API לקישור. כל המחברים עבור סוג המחבר הם אופציונליים, אלא אם צוין אחרת.

זה מפשט את כתובת ה-URL של Linking API, ולרוב מומלץ להשתמש בה מכירים את ההגדרות של מקור הנתונים של התבנית ורוצים לשנות קבוצת משנה של פרמטרים.
  • אם רוצים לספק רק ערכי פרמטרים השונים את מקור הנתונים של התבנית, ואפשר להסתמך על נתוני התבנית מקור לפרמטרים של המחבר שלא צוינו. לדוגמה יש לשנות רק את מזהה הפרויקט לחיוב בהגדרות של מקור נתונים ב-BigQuery להגדרת התבנית לכל הפרמטרים האחרים.

הפרמטרים הנדרשים כאשר ds.connector מוגדר

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

דוגמאות

מגדירה דוח עם מקור נתונים אחד של BigQuery (ds0) ומחליפה את את ההגדרה של מקור נתונים בשלמותו:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare

אפשר להשמיט את הכינוי של מקור הנתונים כשהדוח כולל מקור נתונים אחד. ניתן לפשט את כתובת ה-URL שלמעלה כך:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.datasourceName=MyNewDataSource
  &ds.connector=bigQuery
  &ds.type=TABLE
  &ds.projectId=bigquery-public-data
  &ds.datasetId=samples
  &ds.tableId=shakespeare

מגדיר דוח עם מקור נתונים אחד של BigQuery (ds0) וגם מעדכן רק את מזהה הפרויקט לחיוב של מקור נתונים:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.billingProjectId=my-billing-project

מגדיר דוח עם שני מקורות נתונים, מקור נתונים של BigQuery (ds0) ו מקור הנתונים של Google Analytics (ds1). הגדרת מקור הנתונים של BigQuery היא מוחלפת במלואה, בעוד שההגדרה של Google Analytics מעדכנת יחיד, ומסתמך על מקור הנתונים של התבנית ds1 פרמטרים לא מזוהים של מחבר:

https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &r.reportName=MyNewReportWithMultipleDataSources
  &ds.ds0.datasourceName=MyNewDataSource
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds1.viewId=92320289

יצירה לעומת הוספה

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

  1. מקור הנתונים הוא לשימוש חוזר (מידע נוסף זמין במאמר מקורות נתונים מוטמעים לעומת מקורות נתונים לשימוש חוזר)
  2. כתובת ה-URL לא מפנה למקור הנתונים לפי כינוי
  3. בכתובת ה-URL אין שימוש בתו כללי לחיפוש (ראו תו כללי לחיפוש חלופי של מקור נתונים)

כשמקור נתונים חדש נוצר באמצעות Linking API, הוא משתמש בפרטי הכניסה של המשתמש שלחץ על כתובת ה-URL. המשמעות היא שלמשתמש צריכה להיות גישה נתונים בסיסיים, אחרת החיבור לא יפעל. הוספה מחדש של מקור הנתונים לדוח החדש שנוצר מאפשרת לשמר את פרטי הכניסה שלהם, כדי שמשתמשים יוכלו להמשיך לגשת לנתונים בדוחות החדשים שלהם.

תו כללי לחיפוש של מקור נתונים חלופי

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

האפשרות הזו תעזור לכם להסיר פרמטרים שחוזרים על עצמם מכתובת ה-URL. עבור לדוגמה, אם יש לכם תבנית שמצורפים אליה שלושה מקורות נתונים של BigQuery, וגם אני רוצה להחליף את projectId ואת datasetId אבל משמרים את הערך tableId, אפשר לכתוב אותו כך:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.ds1.projectId=client-project
  &ds.ds1.datasetId=client-dataset
  &ds.ds2.projectId=client-project
  &ds.ds2.datasetId=client-dataset
  &ds.ds3.projectId=client-project
  &ds.ds3.datasetId=client-dataset

לחלופין, באמצעות התו הכללי לחיפוש ds.*, אפשר להשתמש בכתובת ה-URL המקבילה הבאה:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset

הפרמטרים שסופקו ל-API לקישור בלי להשתמש בתו הכללי לחיפוש ds.* הם שקיבלו עדיפות על פני אלה שיש להם. בדוגמה שלמעלה אפשר להוסיף כינוי ספציפי של מקור נתונים כדי לעקוף את הערך מהתו הכללי לחיפוש.

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset
  &ds.ds1.datasetId=client-dataset

באופן כללי, סדר הקדימות של הפרמטרים הוא:

  1. ניתן פרמטר עם כינוי ספציפי (ds.ds1.datasetId)
  2. פרמטר שסופק באמצעות התו הכללי לחיפוש (ds.*.datasetId)
  3. ערך שנגזר ממקור הנתונים של התבנית, אם לא צוין ds.connector (מידע נוסף זמין במאמר החלפה לעומת עדכון).
  4. ערך ברירת המחדל של הפרמטר, אם הוא אופציונלי.

סימוכין למחבר

ה-Link API תומך בהגדרות ובמחברים הבאים. בכל פעם מחבר, רשימת הפרמטרים הזמינים של מקור הנתונים.

BigQuery

מחבר BigQuery תומך בשני סוגי שאילתות, שאילתת TABLE, מציינים את מזהה הטבלה של הטבלה ליצירת שאילתה, וגם CUSTOM_QUERY, שבו מספקים הצהרת SQL כדי להריץ שאילתה על טבלה.

שאילתות לגבי טבלה

הפרמטרים הבאים רלוונטיים כאשר type מוגדר ל-TABLE ואתם לספק את מזהה הטבלה ליצירת השאילתה.

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-bigQuery עבור BigQuery מחבר.

אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- שהוגדרה ב-BigQuery. צפייה החלפה לעומת עדכון.
ds.alias.type
חובה** סוג השאילתה. הגדרה לערך TABLE
ds.alias.projectId
חובה** מזהה הפרויקט של הטבלה ליצירת שאילתה.
ds.alias.datasetId
חובה** מזהה מערך הנתונים של הטבלה כדי שאילתה.
ds.alias.tableId
חובה** מזהה הטבלה של הטבלה כדי שאילתה.

טבלאות מפוצלות של תאריכים:
* (תו כללי לחיפוש) או YYYYMMDD נתמכים כשמריצים שאילתות על טבלאות מפוצלות של תאריכים.
אם טבלה מזוהה בתור Google Analytics , Firebase Analytics או Firebase Crashlytics, שדות ברירת מחדל התבנית תיבחר, אלא אם תצוין תבנית. לצפייה פרמטרים שקשורים לטבלה של fields template.
ds.alias.billingProjectId
זה שינוי אופציונלי. מזהה הפרויקט שמשמש לחיוב. אם היא לא מוגדרת, ייעשה שימוש בprojectId.
ds.alias.isPartitioned
זה שינוי אופציונלי. הערך הוא true אם הטבלה מחולקת למחיצות רוצים להשתמש בעמודה 'חלוקה למחיצות' בתור מאפיין של טווח תאריכים. הדבר רלוונטי רק לחלוקה למחיצות (partitioning) מבוססת-זמן (למשל, או את העמודה _PARTITIONTIME לא פועלת בטבלאות עם טווח של מספרים שלמים שמחולקות למחיצות. ברירת המחדל היא false אם לא צוין. מידע נוסף זמין במאמר הבא: מבוא לטבלאות שמחולקות למחיצות (Partitions).
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true. צפייה לפרטים נוספים, refreshFields.
תבנית של שדות ב-Google Analytics, ב-Firebase Analytics וב-Crashlytics

לטבלאות שמזוהות כ-Google Analytics, Firebase Analytics או Firebase Crashlytics, פרמטרים נוספים זמינים להגדרת תבנית השדות. אם המיקום לא צוין, תיבחר תבנית ברירת מחדל.

שם תיאור
ds.alias.gaTemplateLevel
זה שינוי אופציונלי. תבנית השדות ב-Google Analytics שבה צריך להשתמש. רלוונטי בלבד כשנשלחת שאילתה לגבי ייצוא של BigQuery לטבלה של Google Analytics. אחת מתוך ALL, SESSION, HITS. ל-Google טבלאות Analytics. אם לא צויין ערך, ערך ברירת המחדל הוא ALL.
ds.alias.firebaseTemplateLevel
זה שינוי אופציונלי. תבנית השדות של Firebase Analytics שבה צריך להשתמש. רלוונטי רק כשנשלחת שאילתה לגבי טבלה לייצוא של BigQuery עבור Firebase Analytics. אפשר להגדיר רק את הערך EVENTS. לגבי טבלאות של Firebase Analytics, אם לא צויין ערך, ערך ברירת המחדל הוא EVENTS.
ds.alias.crashlyticsTemplateLevel
תבנית השדות של Firebase Crashlytics שבה צריך להשתמש. ניתן להגדיר רק ל: DEFAULT רלוונטי רק כאשר מיוצאים ל-BigQuery Export ל-Firebase יש שאילתה לגבי טבלת Crashlytics. לטבלאות של Firebase Crashlytics: אם לא צויין ערך, ערך ברירת המחדל הוא DEFAULT.

שאילתות מותאמות אישית

הפרמטרים הבאים רלוונטיים כאשר type מוגדר ל-CUSTOM_QUERY ול- מספקים הצהרת SQL כדי להריץ שאילתה על טבלה.

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-bigQuery עבור BigQuery מחבר.

אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- שהוגדרה ב-BigQuery. צפייה החלפה לעומת עדכון.
ds.alias.type
חובה** סוג השאילתה. הגדרה לערך CUSTOM_QUERY
ds.alias.sql
חובה** שאילתת ה-SQL להרצה.
ds.alias.billingProjectId
זה שינוי אופציונלי. מזהה הפרויקט שמשמש לחיוב. אם היא לא מוגדרת, ייעשה שימוש בprojectId. אם המדיניות projectId לא מוגדרת אז ייעשה שימוש בפרויקט של הטבלה עם השאילתה.
ds.alias.sqlReplace

זה שינוי אופציונלי. רשימה מופרדת בפסיקים של מחרוזות דפוסים ומחרוזות חלופיות יחולו על שאילתת ה-SQL. החלפת מחרוזות חלה רק אם קיימת התאמה לדפוס. צריך להשתמש בפסיק כדי להפריד בין הדפוס לבין המחרוזת החלופית זוגות של מילים. לדוגמה, stringPattern1,replacementString1, stringPattern2,replacementString2.

ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true. צפייה לפרטים נוספים, refreshFields.

דוגמאות

הגדרת סוג TABLE שבה השאילתה מוגדרת עם מזהה טבלה:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds0.billingProjectId=myProject

הגדרה של סוג TABLE כדי לשלוח שאילתה על טבלה מפוצלת של תאריכים באמצעות התו הכללי לחיפוש סיומת תווים:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_*
  

הגדרה של סוג TABLE כדי לשלוח שאילתה על טבלה מפוצלת של תאריכים באמצעות YYYYMMDD סיומת:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_YYYYMMDD
  

הגדרה של סוג TABLE לשליחת שאילתות על BigQuery Export ל-Google Analytics הטבלה, באמצעות תבנית השדות SESSION:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=my-gabq-project
  &ds.ds0.datasetId=1234567
  &ds.ds0.tableId=ga_sessions_YYYYMMDD
  &ds.ds0.gaTemplateLevel=SESSION
  

הגדרה של סוג TABLE לשליחת שאילתה על טבלה שמחולקת למחיצות (Partitions) לפי זמן הטמעת הנתונים, וגם להשתמש בעמודה 'חלוקה למחיצות' כמאפיין של טווח תאריכים:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=TABLE
  &ds.ds0.projectId=acme-co-logs
  &ds.ds0.datasetId=logs
  &ds.ds0.tableId=logs_table
  &ds.ds0.isPartitioned=true

תצורה של סוג CUSTOM_QUERY, שבה השאילתה מוגדרת באמצעות SQL הצהרה:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.connector=bigQuery
  &ds.ds0.type=CUSTOM_QUERY
  &ds.ds0.projectId=bigquery-public-data
  &ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
  &ds.ds0.billingProjectId=myProject

הגדרה של סוג CUSTOM_QUERY שבה רק הצהרת ה-SQL מתעדכנת מקור הנתונים של התבנית משמש לשאר ההגדרות האישיות:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60

הגדרה של סוג CUSTOM_QUERY שבה הצהרת ה-SQL של נתוני התבנית המקור מתעדכן באמצעות sqlReplace:

https://lookerstudio.google.com/reporting/create?
  c.reportId=123abc
  &ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset

# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
#   SELECT word, word_count FROM big-query-public-data.samples.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
#   SELECT word, word_count FROM new-project.new-dataset.shakespeare
#   INNER JOIN
#   SELECT word, word_count FROM new-project.new-dataset.raleigh

Cloud Spanner

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר לערך cloudSpanner עבור ענן מחבר Spanner.

אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- סופקה של Cloud Spanner. צפייה החלפה לעומת עדכון.
ds.alias.projectId
חובה** מזהה הפרויקט.
ds.alias.instanceId
חובה** מזהה המכונה.
ds.alias.databaseId
חובה** מזהה מסד הנתונים.
ds.alias.sql
חובה** שאילתת ה-SQL להרצה.
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true. פרטים נוספים זמינים במאמר refreshFields.

דוגמה

הגדרה של Cloud Spanner באמצעות הצהרת SQL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=456def
  &ds.ds1.connector=cloudSpanner
  &ds.ds1.projectId=myProject
  &ds.ds1.instanceId=production
  &ds.ds1.datasetId=transactions
  &ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B

מחברים קהילתיים

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-community עבור מחבר הקהילה.

אם הוא מוגדר, הוא מחליף את מקור הנתונים במחבר הקהילה שסופק הגדרה אישית. צפייה החלפה לעומת עדכון.
ds.alias.connectorId
חובה** מחבר הקהילה connectorId (נקרא גם deploymentId).
ds.alias.parameters
זה שינוי אופציונלי. פרמטרים נוספים שספציפיים למחבר, כפי שהוגדרו על ידי של מחבר הקהילה ההגדרות האישיות של המחבר.
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true. צפייה לפרטים נוספים, refreshFields.

דוגמה

צריך להתחבר למחבר קהילה עם הגדרות אישיות של state ו-city :

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=community
  &ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
  &ds.ds5.state=CA
  &ds.ds5.city=Sacramento

Google Analytics

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-googleAnalytics עבור Google מחבר Analytics.

אם ההגדרה מוגדרת, היא מחליפה את מקור הנתונים ב- את ההגדרות האישיות ב-Google Analytics. צפייה החלפה לעומת עדכון.
ds.alias.accountId
חובה** מספר החשבון.
ds.alias.propertyId
חובה** מזהה הנכס.
ds.alias.viewId
מזהה התצוגה המפורטת.
חובה** ל-Universal נכסי Analytics.
אין להגדיר נכסי Google Analytics 4.
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא false. צפייה לפרטים נוספים, refreshFields.

דוגמאות

הגדרה של Google Analytics לנכס Universal Analytics:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=UA-54516992-1
  &ds.ds2.viewId=92320289

הגדרה של Google Analytics לנכס Google Analytics 4:

https://lookerstudio.google.com/reporting/create?
  c.reportId=789ghi
  &ds.ds2.connector=googleAnalytics
  &ds.ds2.accountId=54516992
  &ds.ds2.propertyId=213025502

Google Cloud Storage

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. הגדרה לערך googleCloudStorage Google מחבר Cloud Storage.

אם ההגדרה מוגדרת, היא מחליפה את מקור הנתונים עם ההגדרות האישיות של Google Cloud Storage. צפייה החלפה לעומת עדכון.
ds.alias.pathType
חובה** סוג הנתיב. כדאי להשתמש FILE כדי לבחור קובץ יחיד, או FOLDER כדי לבחור כל הקבצים לנתיב הנתון.
ds.alias.path
חובה** נתיב הקובץ (למשל MyBucket/MyData/MyFile.csv) אם pathType הוא FILE או נתיב התיקייה (למשל *MyBucket/MyData) אם pathType בתאריך FOLDER.
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true. פרטים נוספים זמינים במאמר refreshFields.

דוגמה

הגדרות אישיות של Google Cloud Storage לקובץ יחיד:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FILE
  &ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv

הגדרה של Google Cloud Storage לכל הקבצים בנתיב:

https://lookerstudio.google.com/reporting/create?
  c.reportId=231908kpf
  &ds.ds50.connector=googleCloudStorage
  &ds.ds50.pathType=FOLDER
  &ds.ds50.path=MyBucket%2FMyData

Google Sheets

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-googleSheets עבור Google מחבר Sheets.

אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- שסופקה ב-Google Sheets. צפייה החלפה לעומת עדכון.
ds.alias.spreadsheetId
חובה** מזהה הגיליון האלקטרוני.
ds.alias.worksheetId
חובה** מזהה גיליון העבודה.
ds.alias.hasHeader
זה שינוי אופציונלי. כדי להשתמש בשורה הראשונה ככותרות צריך להגדיר את הערך true. אם לא צויין ערך, ערך ברירת המחדל הוא true. כותרות העמודות חייבות להיות ייחודיות. עמודות עם כותרות ריקות לא יתווספו למקור הנתונים.
ds.alias.includeHiddenCells
זה שינוי אופציונלי. צריך להגדיר את הערך true כדי לכלול תאים מוסתרים. אם לא צויין ערך, ערך ברירת המחדל הוא true.
ds.alias.includeFilteredCell
זה שינוי אופציונלי. צריך להגדיר את הערך true כדי לכלול תאים מסוננים. אם לא צויין ערך, ערך ברירת המחדל הוא true.
ds.alias.range
זה שינוי אופציונלי. טווח, למשל A1:B52.
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true. צפייה לפרטים נוספים, refreshFields.

דוגמאות

הגדרות אישיות ב-Google Sheets:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437

תצורה של Google Sheets עם השורה הראשונה המשמשת ככותרות והיא מוסתרת תאים מסוננים כלולים:

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.hasHeader=true
  &ds.ds3.includeHiddenCells=true
  &ds.ds3.includeFilteredCells=true

הגדרה של Google Sheets עם טווח (A1:D20):

https://lookerstudio.google.com/reporting/create?
  c.reportId=101112jkl
  &ds.ds3.connector=googleSheets
  &ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
  &ds.ds3.worksheetId=903806437
  &ds.ds3.range=A1%3AD20

Looker

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-looker עבור מחבר Looker.

אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- ההגדרות האישיות של Looker. צפייה החלפה לעומת עדכון.
ds.alias.instanceUrl
חובה** כתובת ה-URL של המכונה של Looker.
ds.alias.model
חובה** המודל של Looker.
ds.alias.explore
חובה** האפשרויות ב-Looker Explore.
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא false. צפייה לפרטים נוספים, refreshFields.

דוגמה

התחברות אל Looker Explore:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=looker
  &ds.ds5.instanceUrl=my.looker.com
  &ds.ds5.model=thelook
  &ds.ds5.explore=orders

Search Console

שם הפרמטר תיאור
ds.alias.connector
זה שינוי אופציונלי. מוגדר ל-searchConsole עבור חיפוש מחבר המסוף.

אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- ההגדרה האישית ב-Search Console. צפייה החלפה לעומת עדכון.
ds.alias.siteUrl
חובה** כתובת האתר. עבור דומיין מאפיין, עם קידומת sc-domain\:.
ds.alias.tableType
חובה** מגדיר את סוג הטבלה. יכול להיות אחד מהערכים SITE_IMPRESSION או URL_IMPRESSION.
ds.alias.searchType
חובה** מגדיר את סוג החיפוש. יכול להיות אחד מהערכים WEB, IMAGE, VIDEO או NEWS
ds.alias.refreshFields
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא false. צפייה לפרטים נוספים, refreshFields.

דוגמה

הגדרה של Search Console לנכס עם קידומת של כתובת URL:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  &ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

הגדרה של נכסי הדומיין ב-Search Console:

https://lookerstudio.google.com/reporting/create?
  c.reportId=161718pqr
  ds.ds5.connector=searchConsole
  &ds.ds5.siteUrl=sc-domain%3Aexample.com
  &ds.ds5.tableType=SITE_IMPRESSION
  &ds.ds5.searchType=WEB

הרשאות לתבנית

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

הטבלה הבאה מספקת את הגישה המומלצת למקור הנתונים כדי לבצע אופטימיזציה של חוויית משתמש על סמך מקורות הנתונים של התבנית ו-Link API תצורה:

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

שימוש בדוח ריק או בדוח ברירת מחדל

כדי להשתמש בדוח ריק או בדוח ברירת מחדל, צריך להגדיר את ה-link API כך: ככה:

סוג הדוח מגדירים את פרמטר הבקרה reportId הגדרת הפרמטרים של מקור הנתונים (ds). הערות
דוח ריק לא לא
דוח ברירת מחדל לא כן

דוח ברירת המחדל מסופק על ידי Looker Studio.

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

בדוגמאות הבאות מוצגות כתובות URL שונות של Linking API באמצעות שדה ריק או ברירת מחדל שלנו.

התחלת תהליך העבודה של יצירת דוח עם דוח ריק:

https://lookerstudio.google.com/reporting/create

התחלת תהליך העבודה של יצירת דוח עם דוח ריק והגדרת הדוח שם:

https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport

שימוש בתבנית ברירת המחדל של הדוח עם הגדרות מחבר של Google Sheets:

https://lookerstudio.google.com/reporting/create?
  ds.connector=googleSheets
  &ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
  &ds.worksheetId=0

הטמעת דוח

כדי להטמיע דוח שנוצר באמצעות Linking API, צריך להגדיר פרמטרים של כתובת אתר וכוללים את הנתיב /embed/. ממשק API לקישור כתובת URL להטמעה חייבת להיות בפורמט הבא:

https://lookerstudio.google.com/embed/reporting/create?parameters

חיפוש מזהים וכינויים

מזהה דוח

כך מאתרים את מזהה הדוח:

  1. פותחים את הדוח שבו רוצים להשתמש כתבנית. לבדוק את כתובת ה-URL של שלנו. החלק בין reporting/ לבין /page הוא מזהה הדוח. עבור לדוגמה, בכתובת ה-URL הבאה, 0B_U5RNpwhcE6SF85TENURnc4UjA הוא הדוח מזהה:
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
סרגל כתובות בדפדפן שבו מוצגת כתובת ה-URL של דוח Looker Studio.
            מזהה הדוח מודגש.
מוצאים את מזהה הדוח בכתובת ה-URL של הדוח.

כינוי של מקור נתונים

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

כדי למצוא מקור נתונים חלופי:

  1. עורכים את הדוח.
  2. בסרגל הכלים, בוחרים באפשרות Resource > ניהול של מקורות נתונים שנוספו
  3. בודקים בעמודה כינוי כדי למצוא פרטי כינוי לכל מקור נתונים.

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

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

סוג המחבר

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

  1. עורכים את הדוח.
  2. בסרגל הכלים, בוחרים באפשרות Resource > ניהול של מקורות נתונים שנוספו
  3. בוחנים את העמודה סוג המחבר כדי לזהות את המחבר שבו נעשה שימוש יוצרים מקור נתונים.
רשימה של מקורות נתונים בדף ניהול המשאבים של מקור הנתונים.
            העמודה 'סוג המחבר' מודגשת.
מחפשים את סוג המחבר של מקור הנתונים בקטע מקורות נתונים דף הניהול.

טיפים פתרון בעיות

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

תיבת דו-שיח של ניפוי באגים

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

  • מקרים שבהם אירעה שגיאה במהלך הניתוח של Linking API לכתובת אתר, תוצג באופן אוטומטי תיבת דו-שיח עם פרטים על שגיאה.
  • כאשר מתרחשת שגיאה ולא מוצגת תיבת דו-שיח באופן אוטומטי, לחצן המידע שנמצא בפינה השמאלית העליונה של הדוח. קליק למשך מידע נוסף על תוצאות ניפוי הבאגים.
    לחצן מידע שמסביר איך נוצר דוח.
  • אם הלחצן לא זמין, אפשר להפעיל אותו באמצעות מוסיפים את הפרמטר &c.explain=true בסוף בכל כתובת URL של Linking API.

הרשאות

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

עדכון לעומת החלפה

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

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

רענון השדות

אם הגדרתם שמות של שדות, סוגים או נתונים נצברים לנתוני תבנית מקור, השינויים האלה יחולו רק על נתונים שהוגדרו ל-Link API מקור אם הפרמטר ds.refreshFields מוגדר false

בודקים את הפרמטר ds.refreshFields של מקור הנתונים כתובת ה-URL של ה-API בקישור. אם הושמט, עליך לוודא שערך ברירת המחדל של הפרמטר עבור הפרמטר כל סוג של מחבר מתאים לתרחיש לדוגמה שלכם.

באופן כללי, אם יש שדות שהגדרתם במקור הנתונים של התבנית שהגדרות חדשות של מקור נתונים דרך ה-Link API תמיד תיצור בדיוק את אותם השדות, ואז הגדרת refreshFields ל-false תהיה מומלץ.

לדוגמה, אם במהלך היצירה של תבנית דוח, Looker Studio מזהה שדה ספציפי של מקור נתונים מסוג Number ומשנים אותו ל- מקלידים Year – השינוי הזה בהגדרות של השדה הוא עכשיו חלק מנתוני התבנית. מקור. כל תרשים בתבנית הדוח שנעשה בו שימוש בשדה המתוקן צפוי שנה, ואם התרשים מבוסס על זמן, ייתכן שהוא לא יוצג באופן אחר. אם המיקום ממשק ה-API לקישור משמש כדי לספק הגדרה חדשה של מקור נתונים שמובילה בדיוק באותם שדות, יש שתי תוצאות המבוססות על הערך הפרמטר refreshFields:

  • אם המדיניות מוגדרת לערך true, הגדרות השדה ממקור נתוני התבנית: לא של העברות המשך, ויכול להיות שטעינת התרשימים תיכשל אם הם תלויים באותה הגדרת שדה (כלומר, צפוי שדה מסוג Year).

  • אם המדיניות מוגדרת לערך false, הגדרת השדה ממקור הנתונים של התבנית יועברו למקור הנתונים החדש, ותרשימי הדוחות יקבלו את באותם שדות עם אותן הגדרות אישיות ולטעון אותם בהצלחה.

משוב ותמיכה

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

יומן שינויים

2023-06-06

  • הוספת את r.measurementId וגם r.keepMeasurementId פרמטרים של הדוח להגדרה את ההגדרה של הדוח מזהי מדידה ב-Google Analytics.
  • הוספת את ds.keepDatasourceName כדי לשלוט בשימוש חוזר ב- שם מקור הנתונים של התבנית.
  • נוסף קטע בשם הטמעת דוח.
  • מחבר BigQuery
    • הוספת את sqlReplace. מאפשר לכם לציין והחלפת מחרוזות בתבנית כדי לעדכן את שאילתת ה-SQL של התבנית מקור הנתונים.

2023-05-22

2022-11-21

2022-11-14

2022-06-15

  • שלב הבטא
    • השם של Integration API השתנה ל-Linking API.
    • גרסת הבטא של Linking API הסתיימה.
  • הוספת פרמטר הבקרה pageId כדי לאפשר קישור לדוח ספציפי הדף הזה.
  • הוספתם את פרמטר הבקרה mode כדי להגדיר את מצב הדוח כView או מצב עריכה בטעינה.
  • עכשיו אפשר להחליף את ההגדרות של מקורות הנתונים באופן מלא או חלקי עודכן. התנהגות זו נקבעת לפי הפרמטר ds.connector הוגדר. מידע נוסף זמין בקטע החלפה לעומת עדכון. לקבלת פרטים.
  • אם לא סופקה תבנית דוח באמצעות תבנית ברירת מחדל, אפשר להשתמש עכשיו בתבנית ברירת מחדל הפרמטר c.reportId.
  • נוסף הפרמטר ds.refreshFields של מקור נתונים. כך אפשר אפשרות לקבוע אם יתבצע רענון של שדות של מקור נתונים כשטוענים מקור נתונים הגדרה אישית.
  • מחבר BigQuery
    • הפונקציה projectId לא נדרשת אם type מוגדר לערך CUSTOM_QUERY.
    • אם המדיניות billingProjectId לא מוגדרת, פרויקט החיוב חלופה ל-projectId או לפרויקט של טבלת השאילתות.
    • נוספה תמיכה בטבלאות שמחולקות למחיצות לפי תאריך. הגדרת isPartitioned לפרמטר true כדי להשתמש בשדה החלוקה כטווח תאריכים המאפיין.
    • נוספה תמיכה בשאילתות לגבי טבלאות מחולקות למחיצות (Partitions) לפי תאריך באמצעות התו הכללי לחיפוש תו או YYYYMMDD בסיומת הטבלה.
    • נוספה תמיכה בשאילתות לגבי Google Analytics, Firebase Analytics או טבלאות Crashlytics ובחירת תבנית שדות.
  • גיליון אלקטרוני ב-Google Sheets
    • ערך ברירת המחדל של hasHeader הוא true, בהתאם לברירת המחדל של ממשק המשתמש באינטרנט.
    • includeHiddenAndFilteredCell פוצל ל-includeHiddenCells ו-
    • includeFilteredCells ברירת המחדל של שניהם היא true, בהתאם ברירת מחדל של ממשק המשתמש באינטרנט.
  • מחבר Search Console
    • שם הפרמטר propertyType שונה ל-searchType.
  • מחבר של Google Surveys
    • עכשיו אפשר להזין ב-surveyId מזהה סקר אחד או רשימה מופרדת בפסיקים של מזהי סקרים.

2021-12-16

  • גרסה ראשונית של Integration API.
    • מאפשרת לקשר לדוח קיים ולהגדיר שם לדוח.
    • אפשר להגדיר כמה מקורות נתונים, ואפשר להגדיר כל שם של מקור נתונים הוגדרה.
    • תמיכה בסוגי המחברים הבאים: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Sheets, Google Surveys, Search Console.