מבוא
Linking API מספק ממשק מהימן להגדרה ולהעברה של משתמשים ישירות לדוח Looker Studio דרך כתובת URL. כשמשתמשים מפעילים קישור API כתובת ה-URL שהם יוכלו ליהנות מחוויית שימוש יעילה כדי לצפות בה במהירות וליצור איתה אינטראקציה בנתונים שלהם.
במסמך זה מתואר הפורמט הנדרש של כתובות URL של Linking API, וכן פרמטרים זמינים נוספים.
תרחיש לדוגמה ויתרונות
אפשר להשתמש ב-Link API כדי לספק ללקוחות דוחות שהוגדרו מראש כדי להציג את הנתונים שלהם ולקיים איתם אינטראקציה. אלה היתרונות המרכזיים של ממשק ה-API לקישור ככה:
- חוויה ליצירת דוחות בלחיצה אחת עבור הלקוחות.
- הגדרת הנתונים מסופקת בכתובת ה-URL כך שהמשתמשים לא צריכים להגדיר את הדוח עם הנתונים שלהם.
- המשתמשים יכולים לשמור את הדוח בלחיצה אחת ולחזור אל הדוח בכתובת בכל שלב.
- יצירת דוחות בקנה מידה נרחב. Linking API מפחית את הזמן שנדרש כדי לשכפל או ליצור דוחות חדשים.
- מפעילים שילובי מוצרים. הממשק היציב מאפשר לכם לשלב את Looker Studio בתהליך העבודה של המוצר.
איך זה עובד
בהמשך מוסבר על האינטראקציה של מפתחים ומשתמשים עם ה-Link API.
קישור תהליך העבודה של מפתחי API
המפתח מכין את תבניות הדוחות, מקורות הנתונים והפורמטים של קישור כתובת ה-URL של ה-API. תהליך העבודה האופייני למפתחים הוא:
- מחליטים אם להשתמש בדוח ריק – תבנית הדוח שמוגדרת כברירת המחדל. של Looker Studio או ליצור דוח של Looker Studio שישמש תבנית. הפעולות האלה כוללות הגדרה של מקורות הנתונים של התבניות.
- עיצוב כתובת URL של Linking API בהתאם לתרחיש הספציפי לדוגמה שלכם. אם רלוונטי, יש לציין תבנית הדוח ופרמטרים אחרים, כולל שם הדוח, הנתונים שם המקור וההגדרות האישיות של מקור הנתונים.
- משתמשים בכתובת ה-URL של ה-API לקישור כדי להפנות משתמשים לדוח.
קישור חוויית המשתמש ב-API
המשתמש עוקב אחר כתובת URL של Linking API, שאם היא מוגדרת כראוי על ידי יפנה אותם לדוח Looker Studio שמאפשר להם להציג וליצור אינטראקציה עם נתונים שיש להם גישה אליהם. חוויית משתמש טיפוסית יכולה להיות ככה:
- בדפדפן, המשתמש מבקר בשירות שמשולב עם הקישור API.
- קריאה לפעולה מזמינה את המשתמש ללחוץ על קישור כדי לצפות בנתונים שלו Looker Studio.
- המשתמש לוחץ על הקישור ומועבר לדוח Looker Studio. נטען והמשתמש יכול להציג את הנתונים שלו ולקיים איתם אינטראקציה.
- המשתמש לוחץ על 'עריכה ושיתוף'. הדוח נשמר ב-Looker Studio חשבון.
- למשתמש יש עכשיו גישה מלאה ושליטה בעותק שלו של הדוח. הם יכולים להציג, לערוך ולשתף בכל שלב.
דרישות
כדי להבטיח שכתובת URL של Linking API תפעל כצפוי, נדרשים:
- דוח שמשמש כתבנית. אם לא סופק, דוח ריק או אפשר להשתמש בדוח ברירת המחדל שסופק על ידי Looker Studio.
- משתמשים בכתובת URL של Linking API חייבים להיות, לכל הפחות, גישת צפייה אל תבנית דוח. בהתאם לסוג מקורות הנתונים שנעשה בהם שימוש בדוח ובתצורה שמסופקת דרך ה-Link API, המשתמשים עשויים לדרוש גם צפייה במקורות נתונים. בקטע הרשאות תבנית יש הסבר על פרטים.
- סוג המחבר של כל מקור נתונים חייב לתמוך בהגדרה דרך ממשק API לקישור. רשימה של מכשירים נתמכים זמינה בחומר העזר בנושא מחברים מחברים אחרים.
- למשתמשים בכתובת ה-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.
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מזהה הדוח של התבנית. אפליקציית Looker Studio תיפתח ויוגדר הדוח שצוין. הוראות למציאת המזהה מפורטות כאן מזהה הדיווח. אם לא צוין דוח ריק או שבתבנית ברירת המחדל של הדוח, ראה שימוש בתבנית ריק או דוח ברירת מחדל לפרטים. | |
זה שינוי אופציונלי. המזהה של הדף הראשון שנטען בדוח. ברירת המחדל היא הדף הראשון של הדוח אם לא צוין אחרת, . | |
זה שינוי אופציונלי. מצב הדיווח הראשוני. אחד מ-
view או
edit אם לא צויין ערך, ערך ברירת המחדל הוא view .
|
|
זה שינוי אופציונלי. הרשאות הגישה לתיבת הדו-שיח למידע או לניפוי באגים. הגדרה לערך
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
פרמטרים של דוח
פרמטרים של דוח מבטלים את מאפייני הדוח.
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מגדיר את שם הדוח. אם לא צוין, ברירת המחדל היא שם הדוח של התבנית. | |
זה שינוי אופציונלי. מגדיר את מזהי המדידה של Google Analytics בתור מדידה דיווח על שימוש. כדי להפריד בין כמה מזהים, צריך להשתמש בפסיק. אם |
|
זה שינוי אופציונלי. כדי להשתמש בדוח התבנית צריך להגדיר את הערך אם |
דוגמה
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
, אפשר לעיין במאמר כינוי של מקור נתונים.
פרמטרים של מקור נתונים
הפרמטרים הבאים משותפים בכל סוגי המחברים:
שם | תיאור |
---|---|
זה שינוי אופציונלי. מגדיר את השם של מקור הנתונים. אם |
|
זה שינוי אופציונלי. כדי להשתמש במקור הנתונים של התבנית צריך להגדיר את הערך אם |
|
זה שינוי אופציונלי.
סוג המחבר של מקור הנתונים. מידע נוסף על סוגי המחברים הנתמכים מפורטים במאמר מחבר . אם המדיניות מוגדרת, כל הנדרש את הפרמטרים של המחבר לסוג המחבר יש לציין הקישור בין כתובת ה-URL של ה-API לבין ההגדרה של מקור הנתונים בתבנית יהיה הוחלף בשלמותו. אם לא צוין, אפס או יותר את הפרמטרים של המחבר לסוג המחבר ניתן לציין כתובת ה-URL של ה-API בקישור. ההגדרה של מקור נתוני התבנית תשמש כדי: לציין פרמטרים שלא סופקו בכתובת ה-URL של ה-API לקישור. לפרטים שמסביר איך לזהות את סוג המחבר של מקור נתוני התבנית, סוג המחבר. למידע נוסף על השפעת הפרמטר |
|
זה שינוי אופציונלי.
צריך להגדיר את הערך כ- כדי לצאת מהשדות של מקור הנתונים צריך להגדיר את הערך אם לא צוין סוג מחבר, ברירות המחדל משתנות לפי סוג המחבר. כדאי לקרוא את מאמרי עזרה על חיבור לנתונים ספציפיים למחבר ברירת מחדל במקרה שרוצים לשנות את התנהגות ברירת המחדל. שיקולים לשימוש במאפיין
refreshFields :
|
|
נדרש. ההגדרה של מקור הנתונים סוג המחבר. לפרטים על זיהוי המחבר ששימש ליצירת מקור נתונים. סוג המחבר. פרטים על הנתונים הזמינים לכל סוג מחבר, חומר עזר בנושא המחבר. |
החלפה לעומת עדכון – הגדרות של מקור נתונים
כשמגדירים פרמטרים של מקור נתונים, נוכחות או השמטה של
בפרמטר ds.connector
בכתובת ה-URL של ה-API לקישור מצוין
מתכוונים להחליף או לעדכן את ההגדרה של מקור הנתונים בתבנית,
בהתאמה.
בטבלה הבאה מפורט האופן שבו הפרמטר ds.connector
משפיע
ההגדרה של מקור הנתונים של התבנית תוחלף במלואה או משמשת לעדכון
פרמטרים שלא צוינו:
האם ds.connector מוגדר? |
ההגדרות ואופן הפעולה הצפויים | שימוש רגיל |
---|---|---|
כן |
החלפה. ההגדרה של מקור נתוני התבנית תוחלף
במלואו, באמצעות הפרמטרים של מקור הנתונים שצוינו בקישור
כתובת ה-URL של ה-API. צריך לציין את כל הפרמטרים הנדרשים עבור
סוג מתקן הטעינה. ראו פרמטרים נדרשים כאשר
ds.connector מוגדר.
|
|
לא | עדכון. ההגדרה של מקור נתוני התבנית תשמש כדי:
לציין פרמטרים שלא סופקו בכתובת ה-URL של ה-API לקישור. כל המחברים
עבור סוג המחבר הם אופציונליים, אלא אם צוין אחרת.
זה מפשט את כתובת ה-URL של Linking API, ולרוב מומלץ להשתמש בה מכירים את ההגדרות של מקור הנתונים של התבנית ורוצים לשנות קבוצת משנה של פרמטרים. |
|
הפרמטרים הנדרשים כאשר 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, אפשר להוסיף מחדש מקור נתונים מ- על ידי הקפדה על עמידה בכל התנאים הבאים בדוח התבנית:
- מקור הנתונים הוא לשימוש חוזר (מידע נוסף זמין במאמר מקורות נתונים מוטמעים לעומת מקורות נתונים לשימוש חוזר)
- כתובת ה-URL לא מפנה למקור הנתונים לפי כינוי
- בכתובת ה-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
באופן כללי, סדר הקדימות של הפרמטרים הוא:
- ניתן פרמטר עם כינוי ספציפי (
ds.ds1.datasetId
) - פרמטר שסופק באמצעות התו הכללי לחיפוש (
ds.*.datasetId
) - ערך שנגזר ממקור הנתונים של התבנית, אם לא צוין ds.connector (מידע נוסף זמין במאמר החלפה לעומת עדכון).
- ערך ברירת המחדל של הפרמטר, אם הוא אופציונלי.
סימוכין למחבר
ה-Link API תומך בהגדרות ובמחברים הבאים. בכל פעם מחבר, רשימת הפרמטרים הזמינים של מקור הנתונים.
BigQuery
מחבר BigQuery תומך בשני סוגי שאילתות, שאילתת TABLE
,
מציינים את מזהה הטבלה של הטבלה ליצירת שאילתה, וגם CUSTOM_QUERY
, שבו
מספקים הצהרת SQL כדי להריץ שאילתה על טבלה.
שאילתות לגבי טבלה
הפרמטרים הבאים רלוונטיים כאשר type
מוגדר ל-TABLE
ואתם
לספק את מזהה הטבלה ליצירת השאילתה.
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-bigQuery עבור
BigQuery
מחבר.אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- שהוגדרה ב-BigQuery. צפייה החלפה לעומת עדכון. |
|
חובה** סוג השאילתה. הגדרה לערך
TABLE |
|
חובה** מזהה הפרויקט של הטבלה ליצירת שאילתה. | |
חובה** מזהה מערך הנתונים של הטבלה כדי שאילתה. | |
חובה** מזהה הטבלה של הטבלה כדי
שאילתה. טבלאות מפוצלות של תאריכים: * (תו כללי לחיפוש) או YYYYMMDD נתמכים
כשמריצים שאילתות על טבלאות מפוצלות של תאריכים.אם טבלה מזוהה בתור Google Analytics , Firebase Analytics או Firebase Crashlytics, שדות ברירת מחדל התבנית תיבחר, אלא אם תצוין תבנית. לצפייה פרמטרים שקשורים לטבלה של fields template. |
|
זה שינוי אופציונלי. מזהה הפרויקט שמשמש לחיוב. אם היא לא מוגדרת,
ייעשה שימוש בprojectId . |
|
זה שינוי אופציונלי. הערך הוא true אם הטבלה מחולקת למחיצות
רוצים להשתמש בעמודה 'חלוקה למחיצות' בתור מאפיין של טווח תאריכים. הדבר
רלוונטי רק לחלוקה למחיצות (partitioning) מבוססת-זמן (למשל,
או את העמודה _PARTITIONTIME
לא פועלת בטבלאות עם טווח של מספרים שלמים שמחולקות למחיצות. ברירת המחדל היא
false אם לא צוין. מידע נוסף זמין במאמר הבא:
מבוא לטבלאות שמחולקות למחיצות (Partitions). |
|
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא true . צפייה
לפרטים נוספים, refreshFields. |
תבנית של שדות ב-Google Analytics, ב-Firebase Analytics וב-Crashlytics
לטבלאות שמזוהות כ-Google Analytics, Firebase Analytics או Firebase Crashlytics, פרמטרים נוספים זמינים להגדרת תבנית השדות. אם המיקום לא צוין, תיבחר תבנית ברירת מחדל.
שם | תיאור |
---|---|
זה שינוי אופציונלי. תבנית השדות ב-Google Analytics שבה צריך להשתמש. רלוונטי בלבד
כשנשלחת שאילתה לגבי ייצוא של BigQuery לטבלה של Google Analytics. אחת
מתוך ALL , SESSION , HITS . ל-Google
טבלאות Analytics. אם לא צויין ערך, ערך ברירת המחדל הוא ALL . |
|
זה שינוי אופציונלי. תבנית השדות של Firebase Analytics שבה צריך להשתמש. רלוונטי
רק כשנשלחת שאילתה לגבי טבלה לייצוא של BigQuery עבור Firebase Analytics.
אפשר להגדיר רק את הערך EVENTS . לגבי טבלאות של Firebase Analytics,
אם לא צויין ערך, ערך ברירת המחדל הוא EVENTS . |
|
תבנית השדות של Firebase Crashlytics שבה צריך להשתמש. ניתן להגדיר רק ל:
DEFAULT רלוונטי רק כאשר מיוצאים ל-BigQuery Export ל-Firebase
יש שאילתה לגבי טבלת Crashlytics. לטבלאות של Firebase Crashlytics:
אם לא צויין ערך, ערך ברירת המחדל הוא DEFAULT . |
שאילתות מותאמות אישית
הפרמטרים הבאים רלוונטיים כאשר type
מוגדר ל-CUSTOM_QUERY
ול-
מספקים הצהרת SQL כדי להריץ שאילתה על טבלה.
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-bigQuery עבור
BigQuery
מחבר.אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- שהוגדרה ב-BigQuery. צפייה החלפה לעומת עדכון. |
|
חובה** סוג השאילתה. הגדרה לערך
CUSTOM_QUERY |
|
חובה** שאילתת ה-SQL להרצה. | |
זה שינוי אופציונלי. מזהה הפרויקט שמשמש לחיוב. אם היא לא מוגדרת,
ייעשה שימוש בprojectId . אם המדיניות projectId לא מוגדרת
אז ייעשה שימוש בפרויקט של הטבלה עם השאילתה. |
|
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של מחרוזות דפוסים ומחרוזות חלופיות
יחולו על שאילתת ה-SQL. החלפת מחרוזות חלה רק אם קיימת
התאמה לדפוס. צריך להשתמש בפסיק כדי להפריד בין הדפוס לבין המחרוזת החלופית
זוגות של מילים. לדוגמה, |
|
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר לערך cloudSpanner עבור
ענן
מחבר Spanner.אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- סופקה של Cloud Spanner. צפייה החלפה לעומת עדכון. |
|
חובה** מזהה הפרויקט. | |
חובה** מזהה המכונה. | |
חובה** מזהה מסד הנתונים. | |
חובה** שאילתת ה-SQL להרצה. | |
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
מחברים קהילתיים
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-community עבור
מחבר הקהילה.אם הוא מוגדר, הוא מחליף את מקור הנתונים במחבר הקהילה שסופק הגדרה אישית. צפייה החלפה לעומת עדכון. |
|
חובה** מחבר הקהילה
connectorId (נקרא גם deploymentId ).
| |
זה שינוי אופציונלי. פרמטרים נוספים שספציפיים למחבר, כפי שהוגדרו על ידי של מחבר הקהילה ההגדרות האישיות של המחבר. | |
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-googleAnalytics עבור
Google
מחבר Analytics.אם ההגדרה מוגדרת, היא מחליפה את מקור הנתונים ב- את ההגדרות האישיות ב-Google Analytics. צפייה החלפה לעומת עדכון. |
|
חובה** מספר החשבון. | |
חובה** מזהה הנכס. | |
מזהה התצוגה המפורטת. חובה** ל-Universal נכסי Analytics. אין להגדיר נכסי Google Analytics 4. |
|
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. הגדרה לערך googleCloudStorage
Google
מחבר Cloud Storage.אם ההגדרה מוגדרת, היא מחליפה את מקור הנתונים עם ההגדרות האישיות של Google Cloud Storage. צפייה החלפה לעומת עדכון. |
|
חובה** סוג הנתיב. כדאי להשתמש
FILE כדי לבחור קובץ יחיד, או FOLDER כדי לבחור
כל הקבצים לנתיב הנתון. |
|
חובה** נתיב הקובץ (למשל
MyBucket/MyData/MyFile.csv) אם pathType הוא
FILE או נתיב התיקייה (למשל *MyBucket/MyData) אם
pathType בתאריך FOLDER . |
|
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-googleSheets עבור
Google
מחבר Sheets.אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- שסופקה ב-Google Sheets. צפייה החלפה לעומת עדכון. |
|
חובה** מזהה הגיליון האלקטרוני. | |
חובה** מזהה גיליון העבודה. | |
זה שינוי אופציונלי. כדי להשתמש בשורה הראשונה ככותרות צריך להגדיר את הערך true .
אם לא צויין ערך, ערך ברירת המחדל הוא true . כותרות העמודות חייבות להיות
ייחודיות. עמודות עם כותרות ריקות לא יתווספו למקור הנתונים.
|
|
זה שינוי אופציונלי. צריך להגדיר את הערך true כדי לכלול תאים מוסתרים.
אם לא צויין ערך, ערך ברירת המחדל הוא true . |
|
זה שינוי אופציונלי. צריך להגדיר את הערך true כדי לכלול תאים מסוננים.
אם לא צויין ערך, ערך ברירת המחדל הוא true . |
|
זה שינוי אופציונלי. טווח, למשל A1:B52. | |
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-looker עבור
מחבר Looker.אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- ההגדרות האישיות של Looker. צפייה החלפה לעומת עדכון. |
|
חובה** כתובת ה-URL של המכונה של Looker. | |
חובה** המודל של Looker. | |
חובה** האפשרויות ב-Looker Explore. | |
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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
שם הפרמטר | תיאור |
---|---|
זה שינוי אופציונלי. מוגדר ל-searchConsole עבור
חיפוש
מחבר המסוף.אם המדיניות מוגדרת, היא מחליפה את מקור הנתונים ב- ההגדרה האישית ב-Search Console. צפייה החלפה לעומת עדכון. |
|
חובה** כתובת האתר. עבור
דומיין
מאפיין, עם קידומת sc-domain\: . |
|
חובה** מגדיר את סוג הטבלה. יכול להיות
אחד מהערכים SITE_IMPRESSION או URL_IMPRESSION . |
|
חובה** מגדיר את סוג החיפוש. יכול להיות
אחד מהערכים WEB , IMAGE , VIDEO או
NEWS |
|
זה שינוי אופציונלי. אם לא צויין ערך, ערך ברירת המחדל הוא 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 |
הגדרת הפרמטרים של מקור הנתונים ( ). |
הערות |
---|---|---|---|
דוח ריק | לא | לא | |
דוח ברירת מחדל | לא | כן | דוח ברירת המחדל מסופק על ידי 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
חיפוש מזהים וכינויים
מזהה דוח
כך מאתרים את מזהה הדוח:
- פותחים את הדוח שבו רוצים להשתמש כתבנית. לבדוק את כתובת ה-URL של
שלנו. החלק בין
reporting/
לבין/page
הוא מזהה הדוח. עבור לדוגמה, בכתובת ה-URL הבאה,0B_U5RNpwhcE6SF85TENURnc4UjA
הוא הדוח מזהה:
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
![סרגל כתובות בדפדפן שבו מוצגת כתובת ה-URL של דוח Looker Studio.
מזהה הדוח מודגש.](https://developers.google.cn/static/looker-studio/integrate/images/reportId-parameter.png?authuser=7&hl=he)
כינוי של מקור נתונים
דוח יכול לכלול כמה מקורות נתונים. צריך להפנות למקור נתונים באמצעות את הכינוי שלו.
כדי למצוא מקור נתונים חלופי:
- עורכים את הדוח.
- בסרגל הכלים, בוחרים באפשרות Resource > ניהול של מקורות נתונים שנוספו
- בודקים בעמודה כינוי כדי למצוא פרטי כינוי לכל מקור נתונים.
ניתן לערוך שמות כינויים כדי להבטיח תאימות לאחור כשמקור הנתונים שנוספו או הוסרו.
![רשימה של מקורות נתונים בדף ניהול המשאבים של מקור הנתונים.
העמודה 'כינוי' מודגשת.](https://developers.google.cn/static/looker-studio/integrate/images/data-source-alias.png?authuser=7&hl=he)
סוג המחבר
דוח יכול לכלול כמה מקורות נתונים, שכל אחד מהם נוצר על ידי הגדרה של למחבר. כדי למצוא את סוג המחבר ששימש ליצירת מקור הנתונים:
- עורכים את הדוח.
- בסרגל הכלים, בוחרים באפשרות Resource > ניהול של מקורות נתונים שנוספו
- בוחנים את העמודה סוג המחבר כדי לזהות את המחבר שבו נעשה שימוש יוצרים מקור נתונים.
![רשימה של מקורות נתונים בדף ניהול המשאבים של מקור הנתונים.
העמודה 'סוג המחבר' מודגשת.](https://developers.google.cn/static/looker-studio/integrate/images/data-source-connector.png?authuser=7&hl=he)
טיפים פתרון בעיות
אם נתקלת בבעיה, אפשר לעיין בפרטים שבהמשך כדי לזהות בעיות אפשריות ותצורות שגויות נפוצות.
תיבת דו-שיח של ניפוי באגים
משתמשים בתיבת הדו-שיח לניפוי באגים כדי לבדוק את הגדרת ה-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
- נוספה תמיכה במחבר Looker.
- נוספה תמיכה במחברים של הקהילה.
2022-11-21
- נוספה האפשרות להשתמש בדוח ריק. צפייה שימוש בדוח ריק או בדוח ברירת מחדל
- נוסף קטע בשם
refreshFields
אל טיפים לפתרון בעיות.
2022-11-14
- ההפניה למחבר של Surveys הוסרה בגלל סגירה של Google Surveys.
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.