ข้อมูลเบื้องต้น
การเชื่อมโยง API มีอินเทอร์เฟซที่เชื่อถือได้สำหรับการกำหนดค่าและส่งต่อผู้ใช้ไปยังรายงาน Looker Studio โดยตรงผ่าน URL เมื่อผู้ใช้ติดตาม URL ของ API การลิงก์ ผู้ใช้จะได้รับประสบการณ์การใช้งานที่มีประสิทธิภาพมากขึ้นในการดูและโต้ตอบกับข้อมูลของตน
เอกสารนี้อธิบายรูปแบบที่จำเป็นของการลิงก์ URL ของ API และพารามิเตอร์ที่ใช้ได้
กรณีการใช้งานและประโยชน์
คุณสามารถใช้ API การเชื่อมโยงเพื่อแสดงรายงานที่กำหนดค่าไว้ล่วงหน้าสำหรับลูกค้าของคุณเพื่อดูและโต้ตอบกับข้อมูลของตน ประโยชน์หลักๆ ของการเชื่อมโยง API มีดังนี้
- ประสบการณ์การสร้างรายงานในคลิกเดียวสำหรับลูกค้า
- การกำหนดค่าข้อมูลจะอยู่ใน URL ผู้ใช้จึงไม่ต้องกำหนดค่ารายงานสำหรับข้อมูลของตนเอง
- ผู้ใช้สามารถบันทึกรายงานด้วยคลิกเดียวและดูรายงานอีกครั้งได้ทุกเมื่อ
- สร้างรายงานตามระดับที่เหมาะสม Link API จะช่วยลดเวลาในการทำซ้ำหรือสร้างรายงานใหม่
- เปิดใช้การผสานรวมผลิตภัณฑ์ อินเทอร์เฟซที่เสถียรช่วยให้คุณผสานรวม Looker Studio เข้ากับเวิร์กโฟลว์ของผลิตภัณฑ์ได้
วิธีการทำงาน
ข้อมูลต่อไปนี้จะอธิบายวิธีที่นักพัฒนาแอปและผู้ใช้ทํางานร่วมกับ API การลิงก์
เวิร์กโฟลว์การลิงก์ API สำหรับนักพัฒนาซอฟต์แวร์
นักพัฒนาซอฟต์แวร์จัดเตรียมรายงานเทมเพลต แหล่งข้อมูล และรูปแบบของ URL ที่ลิงก์กับ API ขั้นตอนทั่วไปสำหรับนักพัฒนาซอฟต์แวร์มีดังนี้
- เลือกว่าจะใช้รายงานว่าง ซึ่งเป็นเทมเพลตรายงานเริ่มต้นที่ Looker Studio มีให้ หรือสร้างรายงาน Looker Studio ที่จะใช้เป็นเทมเพลต ซึ่งรวมถึงการกําหนดค่าแหล่งข้อมูลเทมเพลต
- จัดรูปแบบ URL ของ API การลิงก์สำหรับ Use Case ของคุณ ระบุเทมเพลตรายงานและพารามิเตอร์อื่นๆ (หากมี) รวมถึงชื่อรายงาน ชื่อแหล่งข้อมูล และการกําหนดค่าแหล่งข้อมูล
- ใช้ URL ของ API การลิงก์เพื่อนำผู้ใช้ไปยังรายงาน
การลิงก์ประสบการณ์ของผู้ใช้ API
ผู้ใช้ติดตาม URL ของ API การลิงก์ซึ่งหากนักพัฒนาแอปกำหนดค่าไว้อย่างถูกต้อง ระบบจะนำผู้ใช้ไปที่รายงาน Looker Studio ที่ให้ดูและโต้ตอบกับข้อมูลที่มีสิทธิ์เข้าถึง ประสบการณ์ของผู้ใช้โดยทั่วไปอาจเป็นดังนี้
- ในเบราว์เซอร์ ผู้ใช้ไปที่บริการที่ผสานรวมกับ API การลิงก์
- คำกระตุ้นให้ดำเนินการ (Call-To-Action) กระตุ้นให้ผู้ใช้คลิกลิงก์เพื่อดูข้อมูลใน Looker Studio
- ผู้ใช้จะไปตามลิงก์และถูกนำไปยังรายงาน Looker Studio จากนั้นรายงานจะโหลดขึ้น และผู้ใช้จะดูและโต้ตอบกับข้อมูลได้
- ผู้ใช้คลิก "แก้ไขและแชร์" ระบบจะบันทึกรายงานไว้ในบัญชี Looker Studio
- ขณะนี้ผู้ใช้มีสิทธิ์เข้าถึงและควบคุมสำเนารายงานของตนเองได้อย่างเต็มรูปแบบ ผู้ใช้สามารถดู แก้ไข และแชร์ได้ตลอดเวลา
ข้อกำหนด
คุณต้องดำเนินการต่อไปนี้เพื่อให้ URL ของการเชื่อมโยง API ทำงานตามที่คาดไว้
- รายงานที่จะใช้เป็นเทมเพลต หากไม่ระบุ คุณจะใช้รายงานว่างหรือรายงานเริ่มต้นจาก Looker Studio ได้
- ผู้ใช้ของ URL ของ API การลิงก์ต้องมีสิทธิ์ดูรายงานเทมเพลตเป็นอย่างน้อย ผู้ใช้อาจต้องการสิทธิ์เข้าถึงแหล่งข้อมูลด้วย ทั้งนี้ขึ้นอยู่กับประเภทของแหล่งข้อมูลที่ใช้ในรายงานและการกำหนดค่าที่ให้ไว้ผ่าน API การเชื่อมโยง ดูสิทธิ์ของเทมเพลตสำหรับรายละเอียด
- ประเภทเครื่องมือเชื่อมต่อของแหล่งข้อมูลแต่ละแหล่งต้องรองรับการกำหนดค่าผ่าน API การเชื่อมโยง โปรดดูข้อมูลอ้างอิงเครื่องมือเชื่อมต่อสำหรับรายการเครื่องมือเชื่อมต่อที่รองรับ
- ผู้ใช้ URL ของ API การลิงก์ต้องมีสิทธิ์เข้าถึงข้อมูลที่กำหนดค่าไว้ใน URL ของ API การลิงก์ หากผู้ใช้ไม่มีสิทธิ์เข้าถึงข้อมูลที่จำเป็น คอมโพเนนต์รายงานที่เกี่ยวข้องจะแสดงข้อผิดพลาด
พารามิเตอร์ของ URL
URL ของ API การลิงก์ต้องอยู่ในรูปแบบต่อไปนี้
https://lookerstudio.google.com/reporting/create?parameters
URL นี้คาดว่าจะใช้ในบริบทของเว็บเบราว์เซอร์ ซึ่งโดยปกติแล้วจะเกิดจากการที่ผู้ใช้คลิกลิงก์หรือเปลี่ยนเส้นทางไปยัง URL และยังใช้เพื่อฝังรายงานได้ด้วย
URL ตัวอย่าง
ตัวอย่าง URL ของ Link 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 บางตัว ในขณะที่บางพารามิเตอร์เป็นแบบไม่บังคับ ต่อไปนี้คือรายการพารามิเตอร์ที่ใช้กำหนด URL ของ Link 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 การลิงก์ และระบบจะแทนที่การกำหนดค่าแหล่งข้อมูลเทมเพลตทั้งหมด หากไม่ระบุ คุณจะระบุ พารามิเตอร์เครื่องมือเชื่อมต่อ 0 หรือมากกว่านั้นสำหรับประเภทเครื่องมือเชื่อมต่อใน URL ของ API การลิงก์ได้ การกําหนดค่าแหล่งข้อมูลเทมเพลตจะใช้เพื่อระบุพารามิเตอร์ใดๆ ที่ไม่ได้ระบุไว้ใน URL ของ Link API โปรดดูรายละเอียดเกี่ยวกับวิธีระบุประเภทเครื่องมือเชื่อมต่อของแหล่งข้อมูลเทมเพลตที่ประเภทเครื่องมือเชื่อมต่อ ดูข้อมูลเพิ่มเติมเกี่ยวกับผลกระทบที่พารามิเตอร์ |
|
ไม่บังคับ
ตั้งค่าเป็น ตั้งค่าเป็น หากไม่ระบุ ค่าเริ่มต้นจะแตกต่างกันไปตามประเภทเครื่องมือเชื่อมต่อ ตรวจสอบ การอ้างอิงเครื่องมือเชื่อมต่อสำหรับค่าเริ่มต้นของเครื่องมือเชื่อมต่อ ในกรณีที่คุณต้องการลบล้างการทำงานเริ่มต้น ข้อควรพิจารณาเมื่อใช้
refreshFields
|
|
ต้องระบุ การกำหนดค่าแหล่งข้อมูลสำหรับประเภทเครื่องมือเชื่อมต่อ สำหรับรายละเอียดเกี่ยวกับวิธีระบุเครื่องมือเชื่อมต่อที่ใช้ในการสร้างแหล่งข้อมูล โปรดดูประเภทเครื่องมือเชื่อมต่อ โปรดดูรายละเอียดเกี่ยวกับพารามิเตอร์แหล่งข้อมูล ที่ใช้ได้กับเครื่องมือเชื่อมต่อแต่ละประเภทที่ ข้อมูลอ้างอิงเครื่องมือเชื่อมต่อ |
แทนที่เทียบกับการอัปเดต - การกำหนดค่าแหล่งข้อมูล
เมื่อตั้งค่าพารามิเตอร์แหล่งข้อมูล การแสดงหรือการละเว้นพารามิเตอร์ ds.connector
ใน URL ของ Link API จะเป็นการแทนที่หรืออัปเดตการกำหนดค่าแหล่งข้อมูลเทมเพลตตามลำดับ
ตารางต่อไปนี้แสดงรายละเอียดผลกระทบของพารามิเตอร์ ds.connector
ว่าจะมีการแทนที่การกำหนดค่าแหล่งข้อมูลเทมเพลตทั้งหมดหรือใช้เพื่ออัปเดตพารามิเตอร์ที่ไม่ระบุ
ตั้งค่า ds.connector ไว้ไหม |
การกำหนดค่าและลักษณะการทำงานที่คาดไว้ | การใช้งานทั่วไป |
---|---|---|
มี |
แทนที่ ระบบจะแทนที่การกำหนดค่าแหล่งข้อมูลเทมเพลตทั้งหมด โดยใช้พารามิเตอร์แหล่งข้อมูลที่ระบุไว้ใน URL ของ Link API คุณต้องระบุพารามิเตอร์ที่จำเป็นทั้งหมดสำหรับประเภทเครื่องมือเชื่อมต่อ ดูพารามิเตอร์ที่จำเป็นเมื่อตั้งค่า ds.connector
|
|
ไม่ได้ | อัปเดต การกําหนดค่าแหล่งข้อมูลเทมเพลตจะใช้เพื่อระบุพารามิเตอร์ใดๆ ที่ไม่ได้ระบุไว้ใน URL ของ Link API พารามิเตอร์เครื่องมือเชื่อมต่อทั้งหมดสำหรับประเภทเครื่องมือเชื่อมต่อนั้นไม่บังคับ ยกเว้นจะระบุไว้เป็นอย่างอื่น
การดำเนินการนี้จะช่วยลดความซับซ้อนของ URL การลิงก์ 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
กำหนดค่ารายงานด้วยแหล่งข้อมูล 2 แหล่ง ได้แก่ แหล่งข้อมูล 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
สร้างกับเพิ่ม
บางครั้งการมีแหล่งข้อมูลเดียวกันในรายงานหลายฉบับก็อาจมีประโยชน์ ดังนั้นการอัปเดตแหล่งข้อมูลจะส่งผลต่อรายงานทั้งหมดรวมกัน เมื่อสร้างรายงานด้วย Link API คุณจะเพิ่มแหล่งข้อมูลอีกครั้งจากรายงานเทมเพลตได้โดยตรวจสอบให้เป็นไปตามเงื่อนไขทั้งหมดต่อไปนี้
- แหล่งข้อมูลเป็นแบบนำมาใช้ใหม่ได้ (ดูแหล่งข้อมูลที่ฝังอยู่เทียบกับแหล่งข้อมูลที่ใช้ซ้ำได้)
- URL ไม่ได้อ้างอิงแหล่งข้อมูลตามชื่อแทน
- URL ไม่ได้ใช้ชื่อแทนที่เป็นไวลด์การ์ด (ดูไวลด์การ์ดชื่อแทนแหล่งข้อมูล)
เมื่อสร้างแหล่งข้อมูลใหม่ด้วย Linked API แหล่งข้อมูลนั้นจะใช้ข้อมูลเข้าสู่ระบบของผู้ใช้ที่คลิก URL ซึ่งหมายความว่าผู้ใช้ต้องมีสิทธิ์เข้าถึงข้อมูลที่มีอยู่ ไม่เช่นนั้นการเชื่อมต่อจะไม่ทำงาน การเพิ่มแหล่งข้อมูลลงในรายงานที่สร้างขึ้นใหม่อีกครั้งจะช่วยรักษาข้อมูลเข้าสู่ระบบไว้เพื่อให้ผู้ใช้เข้าถึงข้อมูลในรายงานใหม่ได้
ไวลด์การ์ดชื่อแทนแหล่งข้อมูล
หากต้องการใช้พารามิเตอร์ Link API กับแหล่งข้อมูลหลายแหล่ง คุณสามารถใช้ชื่อแทนไวลด์การ์ด ds.*
แทนชื่อแทนแหล่งข้อมูลได้
ซึ่งมีประโยชน์ในการนำพารามิเตอร์ที่ซ้ำกันออกจาก URL ของคุณ ตัวอย่างเช่น หากคุณมีเทมเพลตที่มีแหล่งข้อมูล BigQuery แนบอยู่ 3 แหล่ง และคุณต้องการแทนที่ 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
พารามิเตอร์ที่ระบุกับ Link 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 ไว้ (ดูแทนที่เทียบกับอัปเดต)
- ค่าเริ่มต้นสำหรับพารามิเตอร์ หากพารามิเตอร์นี้ไม่บังคับ
ข้อมูลอ้างอิงของตัวเชื่อมต่อ
การเชื่อมโยง API สนับสนุนเครื่องมือเชื่อมต่อและการกำหนดค่าต่อไปนี้ สําหรับเครื่องมือเชื่อมต่อแต่ละรายการ จะมีการระบุรายการพารามิเตอร์แหล่งข้อมูลที่ใช้ได้
BigQuery
เครื่องมือเชื่อมต่อ BigQuery รองรับการค้นหา 2 ประเภท ได้แก่ การค้นหา TABLE
ซึ่งคุณจะระบุรหัสตารางของตารางที่จะสืบค้น และ CUSTOM_QUERY
ซึ่งใช้ระบุคำสั่ง SQL เพื่อค้นหาตาราง
การค้นหาใน TABLE
พารามิเตอร์ต่อไปนี้จะใช้ได้เมื่อตั้งค่า type
เป็น TABLE
และคุณระบุรหัสของตารางสําหรับการค้นหา
ชื่อพารามิเตอร์ | คำอธิบาย |
---|---|
ไม่บังคับ ตั้งค่าเป็น bigQuery สำหรับเครื่องมือเชื่อมต่อ BigQueryหากตั้งค่าแล้ว ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่า BigQuery ที่ระบุ ดูแทนที่เทียบกับการอัปเดต |
|
ต้องระบุ** ประเภทของคำค้นหา ตั้งค่าเป็น TABLE |
|
ต้องระบุ** รหัสโปรเจ็กต์ของตารางเพื่อค้นหา | |
ต้องระบุ** รหัสชุดข้อมูลของตารางเพื่อค้นหา | |
ต้องระบุ** รหัสตารางของตารางที่จะค้นหา ตารางชาร์ดวันที่: ระบบรองรับ * (อักขระไวลด์การ์ด) หรือ YYYYMMDD เมื่อสืบค้นตารางที่ชาร์ดวันที่หากระบุตารางเป็น Google Analytics, Firebase Analytics หรือ Firebase Crashlytics ระบบจะเลือกเทมเพลตช่องเริ่มต้น เว้นแต่จะระบุไว้เป็นอย่างอื่น ดูพารามิเตอร์ที่เกี่ยวข้องกับตารางเทมเพลตช่อง |
|
ไม่บังคับ รหัสของโครงการที่จะใช้สำหรับการเรียกเก็บเงิน หากไม่ได้ตั้งค่า ระบบจะใช้ projectId |
|
ไม่บังคับ ตั้งค่าเป็น true หากตารางมีการแบ่งพาร์ติชันและคุณต้องการใช้คอลัมน์การแบ่งพาร์ติชันเป็นมิติข้อมูลช่วงวันที่ ตัวเลือกนี้ใช้ได้เฉพาะกับการแบ่งพาร์ติชันตามเวลา (เช่น การใช้คอลัมน์การแบ่งพาร์ติชันตามเวลาหรือคอลัมน์เทียม _PARTITIONTIME ) และใช้ไม่ได้กับตารางที่แบ่งพาร์ติชันช่วงจำนวนเต็ม ค่าเริ่มต้นจะเป็น false หากไม่ได้ระบุไว้ ดูข้อมูลเพิ่มเติมได้ที่
ข้อมูลเบื้องต้นเกี่ยวกับตารางที่แบ่งพาร์ติชันแล้ว |
|
ไม่บังคับ ค่าเริ่มต้นจะเป็น true หากไม่ได้ระบุไว้ ดูรายละเอียดได้ที่ refreshFields |
เทมเพลตช่องสำหรับ Google Analytics, Firebase Analytics และ Crashlytics
สำหรับตารางที่ระบุว่าเป็น Google Analytics, Firebase Analytics หรือ Firebase Crashlytics จะมีพารามิเตอร์เพิ่มเติมให้ตั้งค่าเทมเพลตช่อง หากไม่ระบุ ระบบจะเลือกเทมเพลตเริ่มต้น
ชื่อ | คำอธิบาย |
---|---|
ไม่บังคับ เทมเพลตช่อง Google Analytics ที่จะใช้ ใช้ได้เมื่อมีการค้นหาตาราง BigQuery Export สำหรับ Google Analytics เท่านั้น หนึ่งใน ALL , SESSION , HITS สําหรับตาราง Google Analytics ค่าเริ่มต้นจะเป็น ALL หากไม่ได้ระบุ |
|
ไม่บังคับ เทมเพลตช่อง Firebase Analytics ที่จะใช้ ใช้ได้เมื่อมีการค้นหาตาราง BigQuery Export สำหรับ Firebase Analytics เท่านั้น
ตั้งค่าเป็น EVENTS ได้เท่านั้น สําหรับตาราง Firebase Analytics จะมีค่าเริ่มต้นเป็น EVENTS หากไม่ได้ระบุ |
|
เทมเพลตช่อง Firebase Crashlytics ที่จะใช้ ตั้งค่าเป็น DEFAULT ได้เท่านั้น ใช้ได้เมื่อมีการค้นหาตาราง BigQuery Export สำหรับ Firebase Crashlytics เท่านั้น ในตาราง Firebase Crashlytics ค่าเริ่มต้นจะเป็น DEFAULT หากไม่ได้ระบุไว้ |
การค้นหา CUSTOM รายการ
พารามิเตอร์ต่อไปนี้จะใช้ได้เมื่อตั้งค่า 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
เพื่อค้นหาตารางที่แบ่งพาร์ติชันตามเวลาการนำเข้า และใช้คอลัมน์การแบ่งพาร์ติชันเป็นมิติข้อมูลช่วงวันที่ ดังนี้
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 สำหรับเครื่องมือเชื่อมต่อ Cloud 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 สำหรับ Community Connectorหากตั้งค่าไว้ ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่าปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูล ดูแทนที่เทียบกับการอัปเดต |
|
ต้องระบุ** Community Connector
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 ชีต
ชื่อพารามิเตอร์ | คำอธิบาย |
---|---|
ไม่บังคับ ตั้งค่าเป็น googleSheets สำหรับเครื่องมือเชื่อมต่อ Google ชีตหากตั้งค่าแล้ว ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่า Google ชีตที่ระบุไว้ ดูแทนที่เทียบกับการอัปเดต |
|
ต้องระบุ** รหัสสเปรดชีต | |
ต้องระบุ** รหัสเวิร์กชีต | |
ไม่บังคับ ตั้งค่าเป็น true เพื่อใช้แถวแรกเป็นส่วนหัว
ค่าเริ่มต้นจะเป็น true หากไม่ได้ระบุไว้ ส่วนหัวคอลัมน์ต้องไม่ซ้ำกัน ระบบจะไม่เพิ่มคอลัมน์ที่มีส่วนหัวว่างเปล่าลงในแหล่งข้อมูล
|
|
ไม่บังคับ ตั้งค่าเป็น true เพื่อรวมเซลล์ที่ซ่อน
ค่าเริ่มต้นจะเป็น true หากไม่ได้ระบุไว้ |
|
ไม่บังคับ ตั้งค่าเป็น true เพื่อรวมเซลล์ที่กรอง
ค่าเริ่มต้นจะเป็น true หากไม่ได้ระบุไว้ |
|
ไม่บังคับ ช่วง เช่น A1:B52 | |
ไม่บังคับ ค่าเริ่มต้นจะเป็น true หากไม่ได้ระบุไว้ ดูรายละเอียดได้ที่ refreshFields |
ตัวอย่าง
การกำหนดค่า Google ชีต
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
การกำหนดค่า Google ชีตที่มีแถวแรกใช้เป็นส่วนหัว รวมถึงเซลล์ที่ซ่อนและกรองไว้ดังนี้
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 ชีตที่มีช่วง (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หากตั้งค่าแล้ว ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่า Search Console ที่ระบุไว้ ดูแทนที่เทียบกับการอัปเดต |
|
ต้องระบุ** URL ของเว็บไซต์ สำหรับพร็อพเพอร์ตี้โดเมน ให้ขึ้นต้นด้วย 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
สิทธิ์ของเทมเพลต
เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุด คุณควรตั้งค่าสิทธิ์การเข้าถึงรายงานสำหรับรายงานเทมเพลตและแหล่งข้อมูลที่เกี่ยวข้องให้ถูกต้อง สิทธิ์ที่ต้องใช้จะขึ้นอยู่กับว่าเทมเพลตรายงานใช้แหล่งข้อมูลที่ฝังอยู่เทียบกับที่ใช้ซ้ำได้หรือไม่ และมีการตั้งค่าการกำหนดค่า Link API เพื่อแทนที่หรืออัปเดตการกำหนดค่าแหล่งข้อมูลหรือไม่
ตารางต่อไปนี้แสดงแหล่งข้อมูลที่แนะนำสำหรับการเข้าถึงแหล่งข้อมูลเพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุดโดยอิงตามแหล่งข้อมูลเทมเพลตและการกำหนดค่า Link API
ประเภทแหล่งข้อมูล | การลิงก์การกำหนดค่า API สำหรับแหล่งข้อมูล | คําแนะนําเกี่ยวกับสิทธิ์ของแหล่งข้อมูล | หมายเหตุ |
---|---|---|---|
ฝังเมื่อ | แทนที่ | ไม่มี - สิทธิ์ในการดูจะรับช่วงมาจากรายงาน | หากผู้ใช้มีสิทธิ์ดูรายงานเทมเพลต ก็จะมีสิทธิ์ดูแหล่งข้อมูลที่ฝังอยู่โดยอัตโนมัติ |
ฝังเมื่อ | อัปเดต | ไม่มี - สิทธิ์ในการดูจะรับช่วงมาจากรายงาน | หากผู้ใช้มีสิทธิ์ดูรายงานเทมเพลต ก็จะมีสิทธิ์ดูแหล่งข้อมูลที่ฝังอยู่โดยอัตโนมัติ |
นำกลับมาใช้ใหม่ได้ | แทนที่ | ผู้ใช้ไม่ต้องมีสิทธิ์ดู | ระบบไม่จําเป็นต้องมีสิทธิ์ดู เนื่องจากระบบจะแทนที่การกําหนดค่าแหล่งข้อมูลทั้งหมดผ่าน Link API |
นำกลับมาใช้ใหม่ได้ | อัปเดต | ผู้ใช้ต้องมีสิทธิ์ดู | ต้องใช้สิทธิ์ดูแหล่งข้อมูลเพื่อให้ลิงก์ API อ่านและใช้การกำหนดค่าจากแหล่งข้อมูลเทมเพลตได้ หากผู้ใช้ไม่มีสิทธิ์เข้าถึงการดู ผู้ใช้จะได้รับข้อผิดพลาดเมื่อโหลดรายงาน |
ใช้รายงานว่างหรือรายงานเริ่มต้น
หากต้องการใช้รายงานเปล่าหรือรายงานเริ่มต้น ให้กำหนดค่า Link API ดังนี้
ประเภทรายงาน | ตั้งค่าพารามิเตอร์ควบคุมของ reportId |
ตั้งค่าพารามิเตอร์แหล่งข้อมูล ( ) |
หมายเหตุ |
---|---|---|---|
รายงานว่างเปล่า | ไม่ได้ | ไม่ได้ | |
รายงานเริ่มต้น | ไม่ได้ | มี | Looker Studio เป็นผู้จัดทำรายงานเริ่มต้น ไม่จำเป็นต้องใช้ชื่อแทนแหล่งข้อมูลเมื่อระบุพารามิเตอร์แหล่งข้อมูลสำหรับรายงานเริ่มต้น เนื่องจากรายงานเริ่มต้นมีแหล่งข้อมูลที่ฝังอยู่เพียงแหล่งเดียว |
ตัวอย่างต่อไปนี้แสดง URL ต่างๆ ของ Link API ที่ใช้รายงานว่างหรือรายงานเริ่มต้น
เริ่มต้นเวิร์กโฟลว์การสร้างรายงานด้วยรายงานเปล่า โดยทำดังนี้
https://lookerstudio.google.com/reporting/create
เริ่มต้นเวิร์กโฟลว์การสร้างรายงานด้วยรายงานเปล่าและตั้งชื่อรายงานดังนี้
https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport
ใช้เทมเพลตรายงานเริ่มต้นกับการกำหนดค่าเครื่องมือเชื่อมต่อ Google ชีตโดยทำดังนี้
https://lookerstudio.google.com/reporting/create?
ds.connector=googleSheets
&ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
&ds.worksheetId=0
ฝังรายงาน
หากต้องการฝังรายงานที่สร้างด้วย API การลิงก์ ให้ตั้งค่าพารามิเตอร์ของ URL และรวมเส้นทาง /embed/
URL แบบฝังของ API การลิงก์ต้องอยู่ในรูปแบบต่อไปนี้
https://lookerstudio.google.com/embed/reporting/create?parameters
ค้นหารหัสและชื่อแทน
รหัสรายงาน
วิธีดูรหัสรายงาน
- เปิดรายงานที่ต้องการใช้เป็นเทมเพลต ตรวจสอบ URL ของรายงาน ส่วนระหว่าง
reporting/
และ/page
คือรหัสรายงาน ตัวอย่างเช่น ใน URL ต่อไปนี้0B_U5RNpwhcE6SF85TENURnc4UjA
คือรหัสรายงาน
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
ชื่อแทนแหล่งข้อมูล
รายงานหนึ่งๆ อาจมีแหล่งข้อมูลได้หลายแหล่ง แหล่งข้อมูลควรอ้างอิง ด้วยชื่อแทน
วิธีค้นหาชื่อแทนแหล่งข้อมูล
- แก้ไขรายงาน
- จากแถบเครื่องมือ ให้เลือกทรัพยากร > จัดการแหล่งข้อมูลที่เพิ่ม
- ตรวจสอบคอลัมน์ชื่อแทนเพื่อค้นหาข้อมูลชื่อแทนสำหรับแหล่งข้อมูลแต่ละแหล่ง
คุณสามารถแก้ไขชื่อชื่อแทนเพื่อให้แน่ใจว่ามีความเข้ากันได้แบบย้อนหลังเมื่อมีการเพิ่มหรือนำแหล่งข้อมูลออก
ประเภทหัวชาร์จไฟฟ้า
รายงานจะมีแหล่งข้อมูลได้หลายแหล่ง โดยแต่ละแหล่งสร้างขึ้นด้วยการกำหนดค่าเครื่องมือเชื่อมต่อ วิธีค้นหาประเภทเครื่องมือเชื่อมต่อที่ใช้สร้างแหล่งข้อมูล
- แก้ไขรายงาน
- จากแถบเครื่องมือ ให้เลือกทรัพยากร > จัดการแหล่งข้อมูลที่เพิ่ม
- ตรวจสอบคอลัมน์ประเภทเครื่องมือเชื่อมต่อเพื่อระบุเครื่องมือเชื่อมต่อที่ใช้สร้างแหล่งข้อมูล
เคล็ดลับและการแก้ปัญหา
หากพบปัญหา โปรดตรวจสอบรายละเอียดด้านล่างเพื่อระบุปัญหาที่อาจเกิดขึ้นและการกำหนดค่าที่ผิดพลาดที่พบบ่อย
กล่องโต้ตอบการแก้ไขข้อบกพร่อง
ใช้กล่องโต้ตอบการแก้ไขข้อบกพร่องเพื่อตรวจสอบการกำหนดค่าการเชื่อมโยง API ตามที่ Looker Studio ตีความ ช่วยแก้ปัญหาเกี่ยวกับ API ได้
- เมื่อพบข้อผิดพลาดระหว่างการแยกวิเคราะห์ URL ของ Link API กล่องโต้ตอบจะแสดงขึ้นมาโดยอัตโนมัติพร้อมรายละเอียดเกี่ยวกับข้อผิดพลาด
- เมื่อเกิดข้อผิดพลาดและไม่มีกล่องโต้ตอบแสดงขึ้นโดยอัตโนมัติ ให้มองหาปุ่มข้อมูลที่ด้านขวาบนของรายงาน คลิกเพื่อดูข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม
- หากไม่มีปุ่มข้อมูล คุณเปิดใช้ปุ่มดังกล่าวได้โดยเพิ่มพารามิเตอร์
&c.explain=true
ต่อท้าย URL ของ API การลิงก์
สิทธิ์
ตรวจสอบว่าคุณมีสิทธิ์ของเทมเพลตที่ถูกต้องสำหรับประเภทแหล่งข้อมูลและการกำหนดค่า Link API ดูสิทธิ์ของเทมเพลตสำหรับรายละเอียด
อัปเดตและแทนที่
หากคุณอัปเดตการกำหนดค่าแหล่งข้อมูลจากเทมเพลตแหล่งข้อมูล ให้ตรวจสอบการกำหนดค่าแหล่งข้อมูลเทมเพลตและการกำหนดค่า Link API ว่าใช้งานร่วมกันได้ ยืนยันว่าช่องที่ได้จากการกำหนดค่าใหม่เข้ากันได้กับคอมโพเนนต์และการกำหนดค่าของรายงาน
ระหว่างการอัปเดตกับการแทนที่ คุณสามารถตั้งค่าการกำหนดค่าที่ไม่ถูกต้องด้วยลักษณะการทำงานที่ไม่ได้กำหนดไว้ ดูรายละเอียดที่แทนที่เทียบกับการอัปเดต
รีเฟรชช่อง
หากคุณกำหนดค่าชื่อช่อง ประเภท หรือการรวมสำหรับแหล่งข้อมูลเทมเพลต การเปลี่ยนแปลงเหล่านี้จะมีผลกับแหล่งข้อมูลที่กำหนดค่า API การลิงก์เฉพาะในกรณีที่ตั้งค่าพารามิเตอร์ ds.refreshFields
เป็น false
ตรวจสอบพารามิเตอร์แหล่งข้อมูล ds.refreshFields
ของ URL ของ Linking API หากไม่ระบุ ให้ยืนยันว่าค่าเริ่มต้นของพารามิเตอร์สำหรับเครื่องมือเชื่อมต่อแต่ละประเภทนั้นตรงกับกรณีการใช้งานของคุณ
โดยทั่วไป หากคุณมีช่องที่กำหนดค่าไว้ในแหล่งข้อมูลเทมเพลตและมั่นใจว่าการกำหนดค่าแหล่งข้อมูลใหม่ผ่านการเชื่อมโยง API จะให้ช่องข้อมูลเดียวกันเสมอ ขอแนะนำให้ตั้งค่า refreshFields
เป็น false
เช่น หากในระหว่างการสร้างเทมเพลตรายงาน Looker Studio ระบุช่องแหล่งข้อมูลเป็นประเภทตัวเลข และคุณเปลี่ยนเป็นประเภทปี การเปลี่ยนแปลงการกำหนดค่าช่องนี้จะกลายเป็นส่วนหนึ่งของแหล่งข้อมูลเทมเพลต แผนภูมิในเทมเพลตรายงานที่ใช้ช่องที่แก้ไขแล้วจะเห็นเป็นปี และหากแผนภูมิเป็นแบบอิงตามเวลา ก็อาจไม่แสดงเป็นอย่างอื่น หากมีการใช้ Link API เพื่อมอบการกําหนดค่าแหล่งข้อมูลใหม่ให้ช่องที่เหมือนกันทุกประการจะมีผลลัพธ์ 2 แบบตามค่าของพารามิเตอร์ refreshFields
ดังนี้
หากตั้งค่าเป็น
true
ระบบจะไม่นำการกำหนดค่าของช่องมาจากแหล่งข้อมูลเทมเพลต และแผนภูมิอาจโหลดไม่สำเร็จหากต้องใช้การกำหนดค่าช่องเดียวกัน (เช่น ต้องมีช่องประเภทปี)หากตั้งค่าเป็น
false
การกำหนดค่าช่องจากแหล่งข้อมูลเทมเพลตจะส่งต่อไปยังแหล่งข้อมูลใหม่และแผนภูมิรายงานจะได้รับช่องเดียวกันที่มีการกำหนดค่าเหมือนกันและโหลดได้สำเร็จ
ความคิดเห็นและการสนับสนุน
ใช้เครื่องมือติดตามปัญหาเพื่อรายงานปัญหาในการเชื่อมโยง 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
- ออกจากรุ่นเบต้าแล้ว
- ได้เปลี่ยนชื่อ API การผสานรวมเป็น Linking API แล้ว
- การลิงก์ API ออกจากเวอร์ชันเบต้าแล้ว
- เพิ่มพารามิเตอร์ควบคุม
pageId
เพื่ออนุญาตให้ลิงก์ไปยังหน้ารายงานที่เจาะจงได้ - เพิ่มพารามิเตอร์การควบคุม
mode
เพื่อตั้งค่าสถานะรายงานเป็นโหมดดูหรือแก้ไขขณะโหลด - การกำหนดค่าแหล่งข้อมูลสามารถแทนที่การอัปเดตทั้งหมดหรืออัปเดตบางส่วนได้แล้ว ลักษณะการทำงานนี้จะกำหนดโดยการตั้งค่าพารามิเตอร์
ds.connector
หรือไม่ ดูรายละเอียดที่แทนที่เทียบกับการอัปเดต - ตอนนี้ระบบจะใช้เทมเพลตเริ่มต้นหากไม่ได้ระบุเทมเพลตรายงานโดยใช้พารามิเตอร์
c.reportId
- เพิ่มพารามิเตอร์แหล่งข้อมูล
ds.refreshFields
แล้ว ซึ่งจะช่วยให้คุณควบคุมได้ว่าจะรีเฟรชช่องแหล่งข้อมูลเมื่อโหลดการกำหนดค่าแหล่งข้อมูลหรือไม่ - เครื่องมือเชื่อมต่อ BigQuery
- ไม่จําเป็นต้องใช้
projectId
เมื่อตั้งค่าtype
เป็นCUSTOM_QUERY
- เมื่อไม่ได้ตั้งค่า
billingProjectId
โปรเจ็กต์การเรียกเก็บเงินจะสำรองเป็นprojectId
หรือโปรเจ็กต์ของตารางที่สืบค้น - เพิ่มการรองรับตารางที่แบ่งพาร์ติชันวันที่แล้ว ตั้งค่าพารามิเตอร์
isPartitioned
เป็นtrue
เพื่อใช้ช่องพาร์ติชันเป็นมิติข้อมูลช่วงวันที่ - เพิ่มการรองรับตารางที่แบ่งพาร์ติชันวันที่สืบค้นโดยใช้อักขระไวลด์การ์ดหรือคำต่อท้ายตาราง
YYYYMMDD
- เพิ่มการรองรับการค้นหาตาราง Google Analytics, Firebase Analytics หรือ Crashlytics และการเลือกเทมเพลตช่อง
- ไม่จําเป็นต้องใช้
- Google ชีต
hasHeader
มีค่าเริ่มต้นเป็นtrue
สอดคล้องกับค่าเริ่มต้นของ UI บนเว็บincludeHiddenAndFilteredCell
แยกเป็นincludeHiddenCells
และincludeFilteredCells
ตอนนี้ทั้ง 2 รายการจะมีค่าเริ่มต้นเป็นtrue
ซึ่งสอดคล้องกับค่าเริ่มต้นของ UI บนเว็บ
- เครื่องมือเชื่อมต่อ Search Console
- เปลี่ยนชื่อพารามิเตอร์
propertyType
เป็นsearchType
แล้ว
- เปลี่ยนชื่อพารามิเตอร์
- เครื่องมือเชื่อมต่อ Surveys
- ตอนนี้
surveyId
ยอมรับรหัสแบบสำรวจเดียวหรือรายการรหัสแบบสำรวจที่คั่นด้วยคอมมาแล้ว
- ตอนนี้
2021-12-16
- การเปิดตัว API การผสานรวมครั้งแรก
- รองรับการลิงก์ไปยังรายงานที่มีอยู่และการตั้งชื่อรายงาน
- โดยสามารถกำหนดค่าแหล่งข้อมูลได้หลายแหล่งและตั้งชื่อแหล่งข้อมูลแต่ละแหล่งได้
- รองรับเครื่องมือเชื่อมต่อประเภทต่อไปนี้ BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google ชีต, Google Surveys, Search Console