API การเชื่อมโยง

ข้อมูลเบื้องต้น

การเชื่อมโยง API มีอินเทอร์เฟซที่เชื่อถือได้สำหรับการกำหนดค่าและส่งต่อผู้ใช้ไปยังรายงาน Looker Studio โดยตรงผ่าน URL เมื่อผู้ใช้ติดตาม URL ของ API การลิงก์ ผู้ใช้จะได้รับประสบการณ์การใช้งานที่มีประสิทธิภาพมากขึ้นในการดูและโต้ตอบกับข้อมูลของตน

เอกสารนี้อธิบายรูปแบบที่จำเป็นของการลิงก์ URL ของ API และพารามิเตอร์ที่ใช้ได้

กรณีการใช้งานและประโยชน์

คุณสามารถใช้ API การเชื่อมโยงเพื่อแสดงรายงานที่กำหนดค่าไว้ล่วงหน้าสำหรับลูกค้าของคุณเพื่อดูและโต้ตอบกับข้อมูลของตน ประโยชน์หลักๆ ของการเชื่อมโยง API มีดังนี้

  • ประสบการณ์การสร้างรายงานในคลิกเดียวสำหรับลูกค้า
    • การกำหนดค่าข้อมูลจะอยู่ใน URL ผู้ใช้จึงไม่ต้องกำหนดค่ารายงานสำหรับข้อมูลของตนเอง
    • ผู้ใช้สามารถบันทึกรายงานด้วยคลิกเดียวและดูรายงานอีกครั้งได้ทุกเมื่อ
  • สร้างรายงานตามระดับที่เหมาะสม Link API จะช่วยลดเวลาในการทำซ้ำหรือสร้างรายงานใหม่
  • เปิดใช้การผสานรวมผลิตภัณฑ์ อินเทอร์เฟซที่เสถียรช่วยให้คุณผสานรวม Looker Studio เข้ากับเวิร์กโฟลว์ของผลิตภัณฑ์ได้

วิธีการทำงาน

ข้อมูลต่อไปนี้จะอธิบายวิธีที่นักพัฒนาแอปและผู้ใช้ทํางานร่วมกับ API การลิงก์

เวิร์กโฟลว์การลิงก์ API สำหรับนักพัฒนาซอฟต์แวร์

นักพัฒนาซอฟต์แวร์จัดเตรียมรายงานเทมเพลต แหล่งข้อมูล และรูปแบบของ URL ที่ลิงก์กับ API ขั้นตอนทั่วไปสำหรับนักพัฒนาซอฟต์แวร์มีดังนี้

  1. เลือกว่าจะใช้รายงานว่าง ซึ่งเป็นเทมเพลตรายงานเริ่มต้นที่ Looker Studio มีให้ หรือสร้างรายงาน Looker Studio ที่จะใช้เป็นเทมเพลต ซึ่งรวมถึงการกําหนดค่าแหล่งข้อมูลเทมเพลต
  2. จัดรูปแบบ URL ของ API การลิงก์สำหรับ Use Case ของคุณ ระบุเทมเพลตรายงานและพารามิเตอร์อื่นๆ (หากมี) รวมถึงชื่อรายงาน ชื่อแหล่งข้อมูล และการกําหนดค่าแหล่งข้อมูล
  3. ใช้ URL ของ API การลิงก์เพื่อนำผู้ใช้ไปยังรายงาน

การลิงก์ประสบการณ์ของผู้ใช้ API

ผู้ใช้ติดตาม URL ของ API การลิงก์ซึ่งหากนักพัฒนาแอปกำหนดค่าไว้อย่างถูกต้อง ระบบจะนำผู้ใช้ไปที่รายงาน Looker Studio ที่ให้ดูและโต้ตอบกับข้อมูลที่มีสิทธิ์เข้าถึง ประสบการณ์ของผู้ใช้โดยทั่วไปอาจเป็นดังนี้

  1. ในเบราว์เซอร์ ผู้ใช้ไปที่บริการที่ผสานรวมกับ API การลิงก์
  2. คำกระตุ้นให้ดำเนินการ (Call-To-Action) กระตุ้นให้ผู้ใช้คลิกลิงก์เพื่อดูข้อมูลใน Looker Studio
  3. ผู้ใช้จะไปตามลิงก์และถูกนำไปยังรายงาน Looker Studio จากนั้นรายงานจะโหลดขึ้น และผู้ใช้จะดูและโต้ตอบกับข้อมูลได้
  4. ผู้ใช้คลิก "แก้ไขและแชร์" ระบบจะบันทึกรายงานไว้ในบัญชี Looker Studio
  5. ขณะนี้ผู้ใช้มีสิทธิ์เข้าถึงและควบคุมสำเนารายงานของตนเองได้อย่างเต็มรูปแบบ ผู้ใช้สามารถดู แก้ไข และแชร์ได้ตลอดเวลา

ข้อกำหนด

คุณต้องดำเนินการต่อไปนี้เพื่อให้ URL ของการเชื่อมโยง API ทำงานตามที่คาดไว้

  1. รายงานที่จะใช้เป็นเทมเพลต หากไม่ระบุ คุณจะใช้รายงานว่างหรือรายงานเริ่มต้นจาก Looker Studio ได้
  2. ผู้ใช้ของ URL ของ API การลิงก์ต้องมีสิทธิ์ดูรายงานเทมเพลตเป็นอย่างน้อย ผู้ใช้อาจต้องการสิทธิ์เข้าถึงแหล่งข้อมูลด้วย ทั้งนี้ขึ้นอยู่กับประเภทของแหล่งข้อมูลที่ใช้ในรายงานและการกำหนดค่าที่ให้ไว้ผ่าน API การเชื่อมโยง ดูสิทธิ์ของเทมเพลตสำหรับรายละเอียด
  3. ประเภทเครื่องมือเชื่อมต่อของแหล่งข้อมูลแต่ละแหล่งต้องรองรับการกำหนดค่าผ่าน API การเชื่อมโยง โปรดดูข้อมูลอ้างอิงเครื่องมือเชื่อมต่อสำหรับรายการเครื่องมือเชื่อมต่อที่รองรับ
  4. ผู้ใช้ 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 การลิงก์

ชื่อพารามิเตอร์ คำอธิบาย
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 การลิงก์ และระบบจะแทนที่การกำหนดค่าแหล่งข้อมูลเทมเพลตทั้งหมด

หากไม่ระบุ คุณจะระบุ พารามิเตอร์เครื่องมือเชื่อมต่อ 0 หรือมากกว่านั้นสำหรับประเภทเครื่องมือเชื่อมต่อใน URL ของ API การลิงก์ได้ การกําหนดค่าแหล่งข้อมูลเทมเพลตจะใช้เพื่อระบุพารามิเตอร์ใดๆ ที่ไม่ได้ระบุไว้ใน URL ของ Link 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 ของ Link API จะเป็นการแทนที่หรืออัปเดตการกำหนดค่าแหล่งข้อมูลเทมเพลตตามลำดับ

ตารางต่อไปนี้แสดงรายละเอียดผลกระทบของพารามิเตอร์ ds.connector ว่าจะมีการแทนที่การกำหนดค่าแหล่งข้อมูลเทมเพลตทั้งหมดหรือใช้เพื่ออัปเดตพารามิเตอร์ที่ไม่ระบุ

ตั้งค่า ds.connector ไว้ไหม การกำหนดค่าและลักษณะการทำงานที่คาดไว้ การใช้งานทั่วไป
มี แทนที่ ระบบจะแทนที่การกำหนดค่าแหล่งข้อมูลเทมเพลตทั้งหมด โดยใช้พารามิเตอร์แหล่งข้อมูลที่ระบุไว้ใน URL ของ Link API คุณต้องระบุพารามิเตอร์ที่จำเป็นทั้งหมดสำหรับประเภทเครื่องมือเชื่อมต่อ ดูพารามิเตอร์ที่จำเป็นเมื่อตั้งค่า ds.connector
  • เมื่อเปลี่ยนประเภทเครื่องมือเชื่อมต่อของแหล่งข้อมูล เช่น หากคุณกำหนดค่าแหล่งข้อมูล BigQuery ในรายงานเทมเพลต แต่ต้องการกำหนดค่าแหล่งข้อมูลของชีตผ่าน Link API การดำเนินการนี้จะต้องมีการกำหนดการกำหนดค่าเครื่องมือเชื่อมต่อใหม่อย่างครบถ้วน
  • เมื่อคุณต้องการรับประกันการกําหนดค่าแหล่งข้อมูล การแทนที่การกำหนดค่าจะช่วยเลี่ยงการใช้ค่าที่ไม่รู้จักจากแหล่งข้อมูลเทมเพลต
ไม่ได้ อัปเดต การกําหนดค่าแหล่งข้อมูลเทมเพลตจะใช้เพื่อระบุพารามิเตอร์ใดๆ ที่ไม่ได้ระบุไว้ใน URL ของ Link API พารามิเตอร์เครื่องมือเชื่อมต่อทั้งหมดสำหรับประเภทเครื่องมือเชื่อมต่อนั้นไม่บังคับ ยกเว้นจะระบุไว้เป็นอย่างอื่น

การดำเนินการนี้จะช่วยลดความซับซ้อนของ URL การลิงก์ 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

กำหนดค่ารายงานด้วยแหล่งข้อมูล 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 คุณจะเพิ่มแหล่งข้อมูลอีกครั้งจากรายงานเทมเพลตได้โดยตรวจสอบให้เป็นไปตามเงื่อนไขทั้งหมดต่อไปนี้

  1. แหล่งข้อมูลเป็นแบบนำมาใช้ใหม่ได้ (ดูแหล่งข้อมูลที่ฝังอยู่เทียบกับแหล่งข้อมูลที่ใช้ซ้ำได้)
  2. URL ไม่ได้อ้างอิงแหล่งข้อมูลตามชื่อแทน
  3. 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

โดยทั่วไป ลําดับความสําคัญของพารามิเตอร์คือ

  1. พารามิเตอร์ที่กำหนดให้กับชื่อแทนเฉพาะ (ds.ds1.datasetId)
  2. พารามิเตอร์ที่ให้โดยใช้ไวลด์การ์ด (ds.*.datasetId)
  3. ค่าที่ได้จากแหล่งข้อมูลเทมเพลต หากไม่ได้ระบุ ds.connector ไว้ (ดูแทนที่เทียบกับอัปเดต)
  4. ค่าเริ่มต้นสำหรับพารามิเตอร์ หากพารามิเตอร์นี้ไม่บังคับ

ข้อมูลอ้างอิงของตัวเชื่อมต่อ

การเชื่อมโยง API สนับสนุนเครื่องมือเชื่อมต่อและการกำหนดค่าต่อไปนี้ สําหรับเครื่องมือเชื่อมต่อแต่ละรายการ จะมีการระบุรายการพารามิเตอร์แหล่งข้อมูลที่ใช้ได้

BigQuery

เครื่องมือเชื่อมต่อ BigQuery รองรับการค้นหา 2 ประเภท ได้แก่ การค้นหา TABLE ซึ่งคุณจะระบุรหัสตารางของตารางที่จะสืบค้น และ CUSTOM_QUERY ซึ่งใช้ระบุคำสั่ง SQL เพื่อค้นหาตาราง

การค้นหาใน TABLE

พารามิเตอร์ต่อไปนี้จะใช้ได้เมื่อตั้งค่า 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 ระบบจะเลือกเทมเพลตช่องเริ่มต้น เว้นแต่จะระบุไว้เป็นอย่างอื่น ดูพารามิเตอร์ที่เกี่ยวข้องกับตารางเทมเพลตช่อง
ds.alias.billingProjectId
ไม่บังคับ รหัสของโครงการที่จะใช้สำหรับการเรียกเก็บเงิน หากไม่ได้ตั้งค่า ระบบจะใช้ projectId
ds.alias.isPartitioned
ไม่บังคับ ตั้งค่าเป็น true หากตารางมีการแบ่งพาร์ติชันและคุณต้องการใช้คอลัมน์การแบ่งพาร์ติชันเป็นมิติข้อมูลช่วงวันที่ ตัวเลือกนี้ใช้ได้เฉพาะกับการแบ่งพาร์ติชันตามเวลา (เช่น การใช้คอลัมน์การแบ่งพาร์ติชันตามเวลาหรือคอลัมน์เทียม _PARTITIONTIME) และใช้ไม่ได้กับตารางที่แบ่งพาร์ติชันช่วงจำนวนเต็ม ค่าเริ่มต้นจะเป็น false หากไม่ได้ระบุไว้ ดูข้อมูลเพิ่มเติมได้ที่ ข้อมูลเบื้องต้นเกี่ยวกับตารางที่แบ่งพาร์ติชันแล้ว
ds.alias.refreshFields
ไม่บังคับ ค่าเริ่มต้นจะเป็น true หากไม่ได้ระบุไว้ ดูรายละเอียดได้ที่ refreshFields
เทมเพลตช่องสำหรับ Google Analytics, Firebase Analytics และ Crashlytics

สำหรับตารางที่ระบุว่าเป็น Google Analytics, Firebase Analytics หรือ Firebase Crashlytics จะมีพารามิเตอร์เพิ่มเติมให้ตั้งค่าเทมเพลตช่อง หากไม่ระบุ ระบบจะเลือกเทมเพลตเริ่มต้น

ชื่อ คำอธิบาย
ds.alias.gaTemplateLevel
ไม่บังคับ เทมเพลตช่อง Google Analytics ที่จะใช้ ใช้ได้เมื่อมีการค้นหาตาราง BigQuery Export สำหรับ Google Analytics เท่านั้น หนึ่งใน ALL, SESSION, HITS สําหรับตาราง Google Analytics ค่าเริ่มต้นจะเป็น ALL หากไม่ได้ระบุ
ds.alias.firebaseTemplateLevel
ไม่บังคับ เทมเพลตช่อง Firebase Analytics ที่จะใช้ ใช้ได้เมื่อมีการค้นหาตาราง BigQuery Export สำหรับ Firebase Analytics เท่านั้น ตั้งค่าเป็น EVENTS ได้เท่านั้น สําหรับตาราง Firebase Analytics จะมีค่าเริ่มต้นเป็น EVENTS หากไม่ได้ระบุ
ds.alias.crashlyticsTemplateLevel
เทมเพลตช่อง Firebase Crashlytics ที่จะใช้ ตั้งค่าเป็น DEFAULT ได้เท่านั้น ใช้ได้เมื่อมีการค้นหาตาราง BigQuery Export สำหรับ Firebase Crashlytics เท่านั้น ในตาราง Firebase Crashlytics ค่าเริ่มต้นจะเป็น DEFAULT หากไม่ได้ระบุไว้

การค้นหา CUSTOM รายการ

พารามิเตอร์ต่อไปนี้จะใช้ได้เมื่อตั้งค่า 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 เพื่อค้นหาตารางที่แบ่งพาร์ติชันตามเวลาการนำเข้า และใช้คอลัมน์การแบ่งพาร์ติชันเป็นมิติข้อมูลช่วงวันที่ ดังนี้

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 สำหรับเครื่องมือเชื่อมต่อ Cloud 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 สำหรับ Community Connector

หากตั้งค่าไว้ ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่าปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูล ดูแทนที่เทียบกับการอัปเดต
ds.alias.connectorId
ต้องระบุ** Community Connector 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 ชีต

ชื่อพารามิเตอร์ คำอธิบาย
ds.alias.connector
ไม่บังคับ ตั้งค่าเป็น googleSheets สำหรับเครื่องมือเชื่อมต่อ Google ชีต

หากตั้งค่าแล้ว ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่า Google ชีตที่ระบุไว้ ดูแทนที่เทียบกับการอัปเดต
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 ชีต

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

ชื่อพารามิเตอร์ คำอธิบาย
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

หากตั้งค่าแล้ว ระบบจะแทนที่แหล่งข้อมูลด้วยการกำหนดค่า Search Console ที่ระบุไว้ ดูแทนที่เทียบกับการอัปเดต
ds.alias.siteUrl
ต้องระบุ** URL ของเว็บไซต์ สำหรับพร็อพเพอร์ตี้โดเมน ให้ขึ้นต้นด้วย 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

สิทธิ์ของเทมเพลต

เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุด คุณควรตั้งค่าสิทธิ์การเข้าถึงรายงานสำหรับรายงานเทมเพลตและแหล่งข้อมูลที่เกี่ยวข้องให้ถูกต้อง สิทธิ์ที่ต้องใช้จะขึ้นอยู่กับว่าเทมเพลตรายงานใช้แหล่งข้อมูลที่ฝังอยู่เทียบกับที่ใช้ซ้ำได้หรือไม่ และมีการตั้งค่าการกำหนดค่า Link API เพื่อแทนที่หรืออัปเดตการกำหนดค่าแหล่งข้อมูลหรือไม่

ตารางต่อไปนี้แสดงแหล่งข้อมูลที่แนะนำสำหรับการเข้าถึงแหล่งข้อมูลเพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุดโดยอิงตามแหล่งข้อมูลเทมเพลตและการกำหนดค่า Link API

ประเภทแหล่งข้อมูล การลิงก์การกำหนดค่า API สำหรับแหล่งข้อมูล คําแนะนําเกี่ยวกับสิทธิ์ของแหล่งข้อมูล หมายเหตุ
ฝังเมื่อ แทนที่ ไม่มี - สิทธิ์ในการดูจะรับช่วงมาจากรายงาน หากผู้ใช้มีสิทธิ์ดูรายงานเทมเพลต ก็จะมีสิทธิ์ดูแหล่งข้อมูลที่ฝังอยู่โดยอัตโนมัติ
ฝังเมื่อ อัปเดต ไม่มี - สิทธิ์ในการดูจะรับช่วงมาจากรายงาน หากผู้ใช้มีสิทธิ์ดูรายงานเทมเพลต ก็จะมีสิทธิ์ดูแหล่งข้อมูลที่ฝังอยู่โดยอัตโนมัติ
นำกลับมาใช้ใหม่ได้ แทนที่ ผู้ใช้ไม่ต้องมีสิทธิ์ดู ระบบไม่จําเป็นต้องมีสิทธิ์ดู เนื่องจากระบบจะแทนที่การกําหนดค่าแหล่งข้อมูลทั้งหมดผ่าน Link API
นำกลับมาใช้ใหม่ได้ อัปเดต ผู้ใช้ต้องมีสิทธิ์ดู ต้องใช้สิทธิ์ดูแหล่งข้อมูลเพื่อให้ลิงก์ API อ่านและใช้การกำหนดค่าจากแหล่งข้อมูลเทมเพลตได้ หากผู้ใช้ไม่มีสิทธิ์เข้าถึงการดู ผู้ใช้จะได้รับข้อผิดพลาดเมื่อโหลดรายงาน

ใช้รายงานว่างหรือรายงานเริ่มต้น

หากต้องการใช้รายงานเปล่าหรือรายงานเริ่มต้น ให้กำหนดค่า Link API ดังนี้

ประเภทรายงาน ตั้งค่าพารามิเตอร์ควบคุมของ reportId ตั้งค่าพารามิเตอร์แหล่งข้อมูล (ds) หมายเหตุ
รายงานว่างเปล่า ไม่ได้ ไม่ได้
รายงานเริ่มต้น ไม่ได้ มี

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

ค้นหารหัสและชื่อแทน

รหัสรายงาน

วิธีดูรหัสรายงาน

  1. เปิดรายงานที่ต้องการใช้เป็นเทมเพลต ตรวจสอบ URL ของรายงาน ส่วนระหว่าง reporting/ และ /page คือรหัสรายงาน ตัวอย่างเช่น ใน URL ต่อไปนี้ 0B_U5RNpwhcE6SF85TENURnc4UjA คือรหัสรายงาน
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
แถบที่อยู่ของเบราว์เซอร์ที่แสดง URL ของรายงาน Looker Studio รหัสรายงานคือส่วนที่ไฮไลต์ไว้
ค้นหารหัสรายงานใน URL ของรายงาน

ชื่อแทนแหล่งข้อมูล

รายงานหนึ่งๆ อาจมีแหล่งข้อมูลได้หลายแหล่ง แหล่งข้อมูลควรอ้างอิง ด้วยชื่อแทน

วิธีค้นหาชื่อแทนแหล่งข้อมูล

  1. แก้ไขรายงาน
  2. จากแถบเครื่องมือ ให้เลือกทรัพยากร > จัดการแหล่งข้อมูลที่เพิ่ม
  3. ตรวจสอบคอลัมน์ชื่อแทนเพื่อค้นหาข้อมูลชื่อแทนสำหรับแหล่งข้อมูลแต่ละแหล่ง

คุณสามารถแก้ไขชื่อชื่อแทนเพื่อให้แน่ใจว่ามีความเข้ากันได้แบบย้อนหลังเมื่อมีการเพิ่มหรือนำแหล่งข้อมูลออก

รายการแหล่งข้อมูลในหน้าการจัดการทรัพยากรของแหล่งข้อมูล คอลัมน์ "Alias" ที่ไฮไลต์
ค้นหาชื่อแทนแหล่งข้อมูลในหน้าการจัดการแหล่งข้อมูล

ประเภทหัวชาร์จไฟฟ้า

รายงานจะมีแหล่งข้อมูลได้หลายแหล่ง โดยแต่ละแหล่งสร้างขึ้นด้วยการกำหนดค่าเครื่องมือเชื่อมต่อ วิธีค้นหาประเภทเครื่องมือเชื่อมต่อที่ใช้สร้างแหล่งข้อมูล

  1. แก้ไขรายงาน
  2. จากแถบเครื่องมือ ให้เลือกทรัพยากร > จัดการแหล่งข้อมูลที่เพิ่ม
  3. ตรวจสอบคอลัมน์ประเภทเครื่องมือเชื่อมต่อเพื่อระบุเครื่องมือเชื่อมต่อที่ใช้สร้างแหล่งข้อมูล
รายการแหล่งข้อมูลในหน้าการจัดการทรัพยากรของแหล่งข้อมูล คอลัมน์ประเภทเครื่องมือเชื่อมต่อจะไฮไลต์ไว้
ค้นหาประเภทเครื่องมือเชื่อมต่อแหล่งข้อมูลในหน้าการจัดการแหล่งข้อมูล

เคล็ดลับและการแก้ปัญหา

หากพบปัญหา โปรดตรวจสอบรายละเอียดด้านล่างเพื่อระบุปัญหาที่อาจเกิดขึ้นและการกำหนดค่าที่ผิดพลาดที่พบบ่อย

กล่องโต้ตอบการแก้ไขข้อบกพร่อง

ใช้กล่องโต้ตอบการแก้ไขข้อบกพร่องเพื่อตรวจสอบการกำหนดค่าการเชื่อมโยง 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

2022-11-21

2022-11-14

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