API liên kết

Giới thiệu

Linking API cung cấp một giao diện đáng tin cậy để định cấu hình và chuyển tiếp người dùng trực tiếp đến một báo cáo Looker Studio thông qua URL. Khi người dùng truy cập vào một URL Linking API, họ sẽ có trải nghiệm liền mạch để nhanh chóng xem và tương tác với dữ liệu của mình.

Tài liệu này mô tả định dạng bắt buộc của URL Linking API và các tham số có sẵn.

Trường hợp sử dụng và lợi ích

Bạn có thể sử dụng Linking API để cung cấp các báo cáo được định cấu hình sẵn cho khách hàng xem và tương tác với dữ liệu của họ. Sau đây là những lợi ích chính của Linking API:

Khách hàng có thể tạo báo cáo chỉ bằng một lần nhấp.
- Cấu hình dữ liệu được cung cấp trong URL để người dùng không cần định cấu hình báo cáo cho dữ liệu của họ.
- Người dùng có thể lưu báo cáo chỉ bằng một cú nhấp chuột và xem lại báo cáo bất cứ lúc nào.
Tạo báo cáo ở quy mô lớn. Linking API giúp giảm thời gian cần thiết để sao chép hoặc tạo báo cáo mới.
Bật tính năng tích hợp sản phẩm. Giao diện ổn định cho phép bạn tích hợp Looker Studio vào quy trình làm việc của sản phẩm.

Cách hoạt động

Sau đây mô tả cách nhà phát triển và người dùng tương tác với Linking API.

Quy trình làm việc của nhà phát triển Linking API

Nhà phát triển chuẩn bị các báo cáo mẫu, nguồn dữ liệu và định dạng URL Linking API. Sau đây là quy trình công việc điển hình dành cho nhà phát triển:

Quyết định xem bạn có nên sử dụng báo cáo trống, mẫu báo cáo mặc định do Looker Studio cung cấp hay tạo một báo cáo Looker Studio sẽ đóng vai trò là mẫu hay không. Trong đó có việc định cấu hình nguồn dữ liệu của mẫu.
Định dạng URL Linking API cho trường hợp sử dụng cụ thể của bạn. Nếu có thể, hãy chỉ định mẫu báo cáo và các tham số khác, bao gồm tên báo cáo, tên nguồn dữ liệu và cấu hình nguồn dữ liệu.
Sử dụng URL Linking API để chuyển hướng người dùng đến báo cáo.

Trải nghiệm người dùng Linking API

Người dùng truy cập vào một URL Linking API. Nếu được nhà phát triển định cấu hình chính xác, URL này sẽ chuyển hướng người dùng đến một báo cáo Looker Studio cho phép họ xem và tương tác với dữ liệu mà họ có quyền truy cập. Trải nghiệm người dùng thông thường có thể như sau:

Trong trình duyệt, người dùng truy cập vào một dịch vụ đã tích hợp với Linking API.
Lời kêu gọi hành động mời người dùng nhấp vào một đường liên kết để xem dữ liệu của họ trong Looker Studio.
Người dùng nhấp vào đường liên kết và được chuyển hướng đến một báo cáo trên Looker Studio. Báo cáo sẽ tải và người dùng có thể xem cũng như tương tác với dữ liệu của họ.
Người dùng nhấp vào "Chỉnh sửa và chia sẻ". Báo cáo sẽ được lưu vào tài khoản Looker Studio của họ.
Giờ đây, người dùng có toàn quyền truy cập và kiểm soát bản sao báo cáo của riêng họ. Họ có thể xem, chỉnh sửa và chia sẻ bất cứ lúc nào.

Yêu cầu

Để đảm bảo URL của Linking API hoạt động như dự kiến, bạn cần phải có những thông tin sau:

Một báo cáo để làm mẫu. Nếu không cung cấp, bạn có thể sử dụng báo cáo trống hoặc báo cáo mặc định do Looker Studio cung cấp.
Người dùng URL của Linking API phải có ít nhất quyền xem đối với báo cáo mẫu. Tuỳ thuộc vào loại nguồn dữ liệu được dùng trong báo cáo và cấu hình được cung cấp thông qua Linking API, người dùng cũng có thể cần có quyền xem đối với các nguồn dữ liệu. Hãy xem phần Quyền đối với mẫu để biết thông tin chi tiết.
Loại trình kết nối của mỗi nguồn dữ liệu phải hỗ trợ cấu hình thông qua Linking API. Hãy tham khảo Tài liệu tham khảo về trình kết nối để biết danh sách các trình kết nối được hỗ trợ.
Người dùng URL Linking API phải có quyền truy cập vào dữ liệu được định cấu hình trong URL Linking API. Nếu người dùng không có quyền truy cập vào dữ liệu cơ sở, thì mọi thành phần báo cáo phụ thuộc sẽ cho thấy lỗi.

Thông số URL

URL của Linking API phải có dạng như sau:

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

URL này dự kiến sẽ được dùng trong ngữ cảnh của một trình duyệt web, thường là khi người dùng nhấp vào một đường liên kết hoặc được chuyển hướng đến URL đó. Bạn cũng có thể dùng tính năng này để Nhúng báo cáo.

URL mẫu

Sau đây là ví dụ về URL của Linking API. Tên báo cáo được đặt và một nguồn dữ liệu BigQuery duy nhất được định cấu hình:

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

Một số tham số URL là bắt buộc, còn một số thì không bắt buộc. Sau đây là danh sách các tham số dùng để xác định một URL của Linking API:

Tham số kiểm soát

Các tham số kiểm soát xác định trạng thái của báo cáo khi được xem thông qua URL Linking API.

Tên thông số	Mô tả
`c.reportId`	Không bắt buộc. Mã báo cáo mẫu. Looker Studio sẽ mở và định cấu hình báo cáo mà bạn chỉ định. Để biết thông tin chi tiết về cách tìm mã này, hãy xem phần Mã báo cáo. Nếu không chỉ định, hệ thống sẽ sử dụng một báo cáo trống hoặc mẫu báo cáo mặc định, hãy xem phần Sử dụng báo cáo trống hoặc báo cáo mặc định để biết thông tin chi tiết.
`c.pageId`	Không bắt buộc. Mã nhận dạng của trang ban đầu cần tải trong báo cáo. Mặc định là trang đầu tiên của báo cáo nếu bạn không chỉ định.
`c.mode`	Không bắt buộc. Chế độ báo cáo ban đầu. Một trong các thuộc tính `view` hoặc `edit`. Mặc định là `view` nếu bạn không chỉ định.
`c.explain`	Không bắt buộc. Chế độ hiển thị của hộp thoại thông tin/gỡ lỗi. Đặt thành `true` để hiện nút hộp thoại. Mặc định là `false` nếu bạn không chỉ định. Hãy xem bài viết Khắc phục sự cố về cấu hình để tìm hiểu thêm.

Ví dụ

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

Các thông số báo cáo

Các thông số báo cáo sẽ ghi đè các thuộc tính báo cáo.

Tên thông số Mô tả

Tên thông số	Mô tả
`r.reportName`	Không bắt buộc. Đặt tên báo cáo. Nếu bạn không chỉ định, tên báo cáo sẽ lấy tên mặc định là tên báo cáo mẫu.
`r.measurementId`	Không bắt buộc. Đặt Mã đo lường Google Analytics thành Đo lường mức sử dụng báo cáo. Hãy dùng dấu phẩy để phân tách nhiều mã nhận dạng. Nếu bạn không chỉ định `r.measurementId` và `r.keepMeasurementId`, thì chế độ cài đặt báo cáo Mã đo lường Google Analytics sẽ mặc định là chưa đặt. Nếu bạn đặt `r.measurementId` và `r.keepMeasurementId`, thì `r.keepMeasurementId` sẽ được ưu tiên để đặt mã nhận dạng.
`r.keepMeasurementId`	Không bắt buộc. Đặt thành `true` để sử dụng báo cáo mẫu Mã đo lường Google Analytics. Mặc định là `false` nếu bạn không chỉ định. Nếu bạn không chỉ định `r.measurementId` và `r.keepMeasurementId`, thì chế độ cài đặt báo cáo Mã đo lường Google Analytics sẽ mặc định là chưa đặt. Nếu bạn đặt `r.measurementId` và `r.keepMeasurementId`, thì `r.keepMeasurementId` sẽ được ưu tiên để đặt mã nhận dạng.

r.reportName

Không bắt buộc. Đặt tên báo cáo. Nếu bạn không chỉ định, tên báo cáo sẽ lấy tên mặc định là tên báo cáo mẫu.

r.measurementId

Không bắt buộc. Đặt Mã đo lường Google Analytics thành Đo lường mức sử dụng báo cáo. Hãy dùng dấu phẩy để phân tách nhiều mã nhận dạng.

Nếu bạn không chỉ định r.measurementId và r.keepMeasurementId, thì chế độ cài đặt báo cáo Mã đo lường Google Analytics sẽ mặc định là chưa đặt. Nếu bạn đặt r.measurementId và r.keepMeasurementId, thì r.keepMeasurementId sẽ được ưu tiên để đặt mã nhận dạng.

r.keepMeasurementId

Không bắt buộc. Đặt thành true để sử dụng báo cáo mẫu Mã đo lường Google Analytics. Mặc định là false nếu bạn không chỉ định.

Ví dụ

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

Tham số nguồn dữ liệu

Các tham số nguồn dữ liệu cho phép bạn xác định cấu hình nguồn dữ liệu và dữ liệu cần truy cập cho các nguồn dữ liệu trong báo cáo mẫu.

alias được dùng để tham chiếu đến một nguồn dữ liệu trong báo cáo hiện có. Việc sử dụng một biệt hiệu cho phép khả năng tương thích ngược nếu một nguồn dữ liệu được thêm/xoá khỏi báo cáo mẫu.

Để biết thông tin chi tiết về cách tìm nguồn dữ liệu alias, hãy xem phần Tên thay thế của nguồn dữ liệu.

Tham số nguồn dữ liệu

Các tham số sau đây là tham số chung cho tất cả các loại trình kết nối:

Tên	Mô tả
`ds.alias.datasourceName`	Không bắt buộc. Đặt tên cho nguồn dữ liệu. Nếu bạn không chỉ định `ds.datasourceName` và `ds.keepDatasourceName`, tên nguồn dữ liệu sẽ mặc định theo quy ước đặt tên bao gồm loại trình kết nối và thời gian tạo (ví dụ: mẫu – 12/12/21, 22:53). Nếu bạn đặt `ds.datasourceName` và `ds.keepDatasourceName`, thì `ds.datasourceName` sẽ được ưu tiên để đặt tên nguồn dữ liệu.
`ds.alias.keepDatasourceName`	Không bắt buộc. Đặt thành `true` để sử dụng tên nguồn dữ liệu mẫu. Mặc định là `false` nếu bạn không chỉ định. Nếu bạn không chỉ định `ds.datasourceName` và `ds.keepDatasourceName`, tên nguồn dữ liệu sẽ mặc định theo quy ước đặt tên bao gồm loại trình kết nối và thời gian tạo (ví dụ: mẫu – 12/12/21, 22:53). Nếu bạn đặt `ds.datasourceName` và `ds.keepDatasourceName`, thì `ds.datasourceName` sẽ được ưu tiên để đặt tên nguồn dữ liệu.
`ds.alias.connector`	Không bắt buộc. Loại trình kết nối của nguồn dữ liệu. Để biết thêm thông tin về các loại trình kết nối được hỗ trợ, hãy xem Tài liệu tham khảo về trình kết nối. Nếu được đặt, thì tất cả các tham số trình kết nối bắt buộc cho loại trình kết nối phải được chỉ định trong URL của Linking API và cấu hình nguồn dữ liệu mẫu sẽ được thay thế hoàn toàn. Nếu không được chỉ định, bạn có thể chỉ định không hoặc nhiều tham số đầu nối cho loại đầu nối trong URL Linking API. Cấu hình nguồn dữ liệu mẫu sẽ được dùng để chỉ định mọi thông số không có trong URL của Linking API. Để biết thông tin chi tiết về cách xác định loại trình kết nối của nguồn dữ liệu mẫu, hãy xem phần Loại trình kết nối. Để tìm hiểu thêm về cách tham số `ds.connector` ảnh hưởng đến việc liệu cấu hình nguồn dữ liệu mẫu có được thay thế hoàn toàn hay được dùng để cập nhật các tham số không xác định, hãy xem bài viết Thay thế so với cập nhật.
`ds.alias.refreshFields`	Không bắt buộc. Đặt thành `true` để sử dụng cấu hình nguồn dữ liệu được chỉ định thông qua Linking API để làm mới các trường nguồn dữ liệu và cập nhật các thành phần báo cáo bằng lựa chọn trường mới. `true` thường được chỉ định khi chuyển đổi loại trình kết nối hoặc đối với các loại trình kết nối mà thay đổi cấu hình sẽ tạo ra các trường khác nhau (ví dụ: các trường cho nguồn dữ liệu BigQuery thường thay đổi theo các cấu hình bảng khác nhau). Đặt thành `false` để giữ nguyên các trường nguồn dữ liệu trong báo cáo mẫu. `false` thường được chỉ định khi cấu hình dữ liệu mới tạo ra các trường giống hệt nhau và bạn muốn duy trì mọi thay đổi về trường mà bạn đã thực hiện đối với nguồn dữ liệu mẫu. Nếu không được chỉ định, giá trị mặc định sẽ thay đổi theo loại trình kết nối. Xem Tài liệu tham khảo về trình kết nối để biết các giá trị mặc định cụ thể của trình kết nối trong trường hợp bạn muốn ghi đè hành vi mặc định. Những điều cần cân nhắc khi sử dụng `refreshFields`: Nếu `refreshFields` được đặt thành `false` và cấu hình nguồn dữ liệu được chỉ định thông qua Linking API tạo ra các trường khác với các trường được dùng trong báo cáo mẫu, thì người dùng có thể sẽ thấy lỗi cấu hình cho các thành phần chịu ảnh hưởng. Những thay đổi đối với các trường trong nguồn dữ liệu mẫu (ví dụ: tên, loại, mức độ tổng hợp, v.v.) sẽ không được chuyển sang các nguồn dữ liệu mới khi `refreshFields` được đặt thành `true`. Đặt `refreshFields` thành `false` để duy trì cấu hình trường từ nguồn dữ liệu mẫu. Trường được tính và Tham số được xác định trong nguồn dữ liệu mẫu sẽ luôn được sao chép vào nguồn dữ liệu mới tạo và không bị ảnh hưởng bởi giá trị của `refreshFields`.
`ds.alias.connectorParameters`	Bắt buộc. Cấu hình nguồn dữ liệu cho loại trình kết nối. Để biết thông tin chi tiết về cách xác định trình kết nối dùng để tạo nguồn dữ liệu, hãy xem phần Loại trình kết nối. Để biết thông tin chi tiết về các tham số nguồn dữ liệu có sẵn cho từng loại trình kết nối, hãy xem Tài liệu tham khảo về trình kết nối.

Thay thế và cập nhật – Cấu hình nguồn dữ liệu

Khi đặt các tham số nguồn dữ liệu, sự xuất hiện hoặc việc bỏ qua tham số ds.connector trong URL của Linking API cho biết ý định thay thế hoặc cập nhật cấu hình nguồn dữ liệu mẫu, tương ứng.

Bảng sau đây trình bày chi tiết cách tham số ds.connector ảnh hưởng đến việc một cấu hình nguồn dữ liệu mẫu được thay thế hoàn toàn hay được dùng để cập nhật các tham số không xác định:

`ds.connector` đã được đặt chưa?	Cấu hình và hành vi dự kiến	Công dụng phổ biến
Có	Thay thế. Cấu hình nguồn dữ liệu mẫu sẽ được thay thế hoàn toàn bằng các tham số nguồn dữ liệu được chỉ định trong URL Linking API. Bạn phải chỉ định tất cả các tham số bắt buộc cho loại giắc cắm. Xem phần Thông số bắt buộc khi bạn đặt `ds.connector`.	Khi thay đổi loại trình kết nối của một nguồn dữ liệu. Ví dụ: Nếu bạn đã định cấu hình một nguồn dữ liệu BigQuery trong báo cáo mẫu nhưng muốn định cấu hình một nguồn dữ liệu Trang tính thông qua Linking API. Thao tác này sẽ yêu cầu bạn xác định toàn bộ cấu hình trình kết nối mới. Khi bạn muốn đảm bảo cấu hình của một nguồn dữ liệu. Việc thay thế cấu hình sẽ tránh mọi giá trị không xác định có thể được dùng từ nguồn dữ liệu mẫu.
Không	Cập nhật. Cấu hình nguồn dữ liệu mẫu sẽ được dùng để chỉ định mọi thông số không có trong URL của Linking API. Tất cả các tham số của giắc cắm cho loại giắc cắm đều không bắt buộc, trừ phi có quy định khác. Điều này giúp đơn giản hoá URL của Linking API và thường được đề xuất khi bạn đã quen với cấu hình nguồn dữ liệu mẫu và chỉ muốn ghi đè một nhóm nhỏ các thông số.	Khi bạn chỉ muốn cung cấp các giá trị tham số khác với nguồn dữ liệu mẫu và chấp nhận dựa vào nguồn dữ liệu mẫu cho mọi tham số trình kết nối không được chỉ định. Ví dụ: Chỉ thay đổi Mã dự án thanh toán của một cấu hình nguồn dữ liệu BigQuery và sử dụng cấu hình mẫu cho tất cả các thông số khác.

Tham số bắt buộc khi bạn đặt `ds.connector`

Nếu bạn chỉ định tham số ds.connector của một nguồn dữ liệu, thì bạn phải chỉ định tất cả các tham số trình kết nối được chỉ định là Bắt buộc cho nguồn dữ liệu. Nếu tham số ds.connector của nguồn dữ liệu không được chỉ định, thì tất cả các tham số của trình kết nối (kể cả những tham số được chỉ định là bắt buộc) đều có thể được coi là không bắt buộc, trừ phi có quy định khác.

Ví dụ

Định cấu hình báo cáo bằng một nguồn dữ liệu BigQuery (ds0) và thay thế toàn bộ cấu hình nguồn dữ liệu:

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

Bạn có thể bỏ qua tên đại diện của nguồn dữ liệu khi báo cáo chỉ có một nguồn dữ liệu. URL ở trên có thể được đơn giản hoá thành URL sau:

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

Định cấu hình báo cáo bằng một nguồn dữ liệu BigQuery (ds0) và chỉ cập nhật mã dự án thanh toán của nguồn dữ liệu:

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

Định cấu hình một báo cáo có hai nguồn dữ liệu, một nguồn dữ liệu BigQuery (ds0) và một nguồn dữ liệu Google Analytics (ds1). Cấu hình nguồn dữ liệu BigQuery sẽ được thay thế hoàn toàn, trong khi cấu hình Google Analytics sẽ cập nhật một thông số duy nhất và dựa vào nguồn dữ liệu mẫu ds1 cho mọi thông số trình kết nối không được chỉ định:

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

Tạo so với Thêm

Đôi khi, bạn nên sử dụng cùng một nguồn dữ liệu trong nhiều báo cáo để các nội dung cập nhật cho nguồn dữ liệu sẽ ảnh hưởng đến tất cả các báo cáo cùng một lúc. Khi tạo báo cáo bằng Linking API, bạn có thể thêm lại một nguồn dữ liệu từ báo cáo mẫu bằng cách đảm bảo đáp ứng tất cả các điều kiện sau:

Nguồn dữ liệu có thể sử dụng lại (xem phần nguồn dữ liệu được nhúng so với nguồn dữ liệu có thể sử dụng lại)
URL không tham chiếu nguồn dữ liệu theo tên đại diện
URL không sử dụng tên thay thế ký tự đại diện (xem Ký tự đại diện tên thay thế nguồn dữ liệu)

Khi một nguồn dữ liệu mới được tạo bằng Linking API, nguồn dữ liệu đó sẽ sử dụng thông tin đăng nhập của người dùng đã nhấp vào URL. Điều đó có nghĩa là người dùng phải có quyền truy cập vào dữ liệu cơ bản, nếu không thì kết nối sẽ không hoạt động. Bằng cách thêm lại nguồn dữ liệu vào báo cáo mới được tạo, bạn có thể giữ lại thông tin xác thực của nguồn dữ liệu đó để người dùng có thể tiếp tục truy cập vào dữ liệu trong báo cáo mới.

Ký tự đại diện cho tên đại diện của nguồn dữ liệu

Để áp dụng một tham số Linking API cho nhiều nguồn dữ liệu, bạn có thể dùng bí danh đại diện ds.* thay cho bí danh nguồn dữ liệu.

Điều này có thể hữu ích khi bạn muốn xoá các tham số lặp lại khỏi URL. Ví dụ: nếu bạn có một mẫu có 3 nguồn dữ liệu BigQuery được đính kèm và bạn muốn thay thế projectId và datasetId trong mỗi nguồn, nhưng vẫn giữ nguyên tableId, thì bạn có thể viết như sau:

  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

Hoặc bạn có thể dùng ký tự đại diện ds.* để sử dụng URL tương đương sau:

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

Các thông số được cung cấp cho Linking API không sử dụng ký tự đại diện ds.* sẽ được ưu tiên hơn các thông số sử dụng ký tự đại diện này. Trong ví dụ trên, bạn có thể thêm một bí danh nguồn dữ liệu cụ thể để ghi đè giá trị từ ký tự đại diện.

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

Nói chung, thứ tự ưu tiên của tham số là:

Một tham số được cung cấp với bí danh cụ thể (ds.ds1.datasetId)
Một tham số được cung cấp bằng ký tự đại diện (ds.*.datasetId)
Giá trị bắt nguồn từ nguồn dữ liệu mẫu, nếu bạn không cung cấp ds.connector (xem phần Thay thế so với cập nhật)
Giá trị mặc định của tham số (nếu tham số đó là không bắt buộc).

Tài liệu tham khảo về trình kết nối

Linking API hỗ trợ các trình kết nối và cấu hình sau. Đối với mỗi trình kết nối, danh sách các thông số nguồn dữ liệu có sẵn sẽ được cung cấp.

BigQuery

Trình kết nối BigQuery hỗ trợ 2 loại truy vấn, truy vấn TABLE, trong đó bạn cung cấp Mã bảng của bảng cần truy vấn và truy vấn CUSTOM_QUERY, trong đó bạn cung cấp một câu lệnh SQL để truy vấn một bảng.

Truy vấn BẢNG

Các tham số sau đây được áp dụng khi type được đặt thành TABLE và bạn cung cấp mã nhận dạng của bảng để truy vấn.

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `bigQuery` cho trình kết nối BigQuery. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình BigQuery được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.type`	Bắt buộc** Loại truy vấn. Đặt thành `TABLE`.
`ds.alias.projectId`	Bắt buộc** Mã dự án của bảng cần truy vấn.
`ds.alias.datasetId`	Bắt buộc** Mã tập dữ liệu của bảng cần truy vấn.
`ds.alias.tableId`	Bắt buộc** Mã nhận dạng bảng của bảng cần truy vấn. Bảng phân mảnh theo ngày: Hậu tố * (ký tự đại diện) hoặc `YYYYMMDD` được hỗ trợ khi truy vấn bảng phân mảnh theo ngày. Nếu một bảng được xác định là Google Analytics, Firebase Analytics hoặc Firebase Crashlytics, thì một mẫu trường mặc định sẽ được chọn, trừ phi bạn chỉ định một mẫu trường. Xem các tham số liên quan trong bảng mẫu trường.
`ds.alias.billingProjectId`	Không bắt buộc. Mã nhận dạng của Dự án dùng để thanh toán. Nếu bạn không đặt chính sách này, `projectId` sẽ được dùng.
`ds.alias.isPartitioned`	Không bắt buộc. Đặt thành `true` nếu bảng được phân vùng và bạn muốn sử dụng cột phân vùng làm phương diện phạm vi ngày. Điều này chỉ áp dụng cho việc phân vùng dựa trên thời gian (ví dụ: sử dụng cột phân vùng dựa trên thời gian hoặc cột giả `_PARTITIONTIME`) và không hoạt động đối với các bảng được phân vùng theo dải số nguyên. Mặc định là `false` nếu bạn không chỉ định. Để tìm hiểu thêm, hãy xem phần Giới thiệu về bảng được phân vùng.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `true` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Mẫu trường cho Google Analytics, Firebase Analytics và Crashlytics

Đối với các bảng được xác định là Google Analytics, Firebase Analytics hoặc Firebase Crashlytics, bạn có thể dùng các thông số bổ sung để đặt mẫu trường. Nếu bạn không chỉ định, hệ thống sẽ chọn một mẫu mặc định.

Tên	Mô tả
`ds.alias.gaTemplateLevel`	Không bắt buộc. Mẫu trường Google Analytics cần sử dụng. Chỉ áp dụng khi bạn đang truy vấn một bảng xuất dữ liệu sang BigQuery của Google Analytics. Một trong các giá trị `ALL`, `SESSION`, `HITS`. Đối với các bảng Google Analytics, giá trị mặc định là `ALL` nếu bạn không chỉ định.
`ds.alias.firebaseTemplateLevel`	Không bắt buộc. Mẫu trường Firebase Analytics cần sử dụng. Chỉ áp dụng khi bạn truy vấn một bảng xuất dữ liệu sang BigQuery cho Firebase Analytics. Chỉ có thể đặt thành `EVENTS`. Đối với các bảng Firebase Analytics, giá trị mặc định là `EVENTS` nếu bạn không chỉ định.
`ds.alias.crashlyticsTemplateLevel`	Mẫu trường Firebase Crashlytics cần sử dụng. Chỉ có thể đặt thành `DEFAULT`. Chỉ áp dụng khi bạn đang truy vấn một bảng BigQuery Export cho Firebase Crashlytics. Đối với các bảng Firebase Crashlytics, giá trị mặc định là `DEFAULT` nếu bạn không chỉ định.

Truy vấn TUỲ CHỈNH

Các tham số sau đây sẽ áp dụng khi bạn đặt type thành CUSTOM_QUERY và cung cấp một câu lệnh SQL để truy vấn một bảng.

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `bigQuery` cho trình kết nối BigQuery. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình BigQuery được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.type`	Bắt buộc** Loại truy vấn. Đặt thành `CUSTOM_QUERY`.
`ds.alias.sql`	Bắt buộc** Truy vấn SQL cần chạy.
`ds.alias.billingProjectId`	Không bắt buộc. Mã nhận dạng của Dự án dùng để thanh toán. Nếu bạn không đặt chính sách này, `projectId` sẽ được dùng. Nếu bạn không đặt `projectId` thì dự án của bảng được truy vấn sẽ được dùng.
`ds.alias.sqlReplace`	Không bắt buộc. Danh sách các chuỗi mẫu và chuỗi thay thế được phân tách bằng dấu phẩy để áp dụng cho truy vấn SQL. Chỉ áp dụng tính năng thay thế chuỗi nếu có mẫu trùng khớp. Dùng dấu phẩy để phân tách các cặp chuỗi thay thế và mẫu. Ví dụ: `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `true` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình loại TABLE, trong đó truy vấn được xác định bằng Mã bảng:

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

Cấu hình loại TABLE để truy vấn bảng được phân mảnh theo ngày bằng hậu tố ký tự đại diện:

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_*

Cấu hình loại TABLE để truy vấn bảng phân đoạn theo ngày bằng hậu tố 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

Cấu hình loại TABLE để truy vấn một bảng BigQuery Export cho Google Analytics, bằng cách sử dụng mẫu trường 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

Cấu hình loại TABLE để truy vấn bảng được phân vùng theo thời gian truyền và sử dụng cột phân vùng làm phương diện phạm vi ngày:

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

Một cấu hình loại CUSTOM_QUERY, trong đó truy vấn được xác định bằng một câu lệnh 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

Cấu hình loại CUSTOM_QUERY, trong đó chỉ câu lệnh SQL được cập nhật và nguồn dữ liệu mẫu được dùng cho phần còn lại của cấu hình:

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

Cấu hình loại CUSTOM_QUERY, trong đó câu lệnh SQL của nguồn dữ liệu mẫu được cập nhật bằng cách sử dụng 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

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `cloudSpanner` cho trình kết nối Cloud Spanner. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Cloud Spanner được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.projectId`	Bắt buộc** Mã dự án.
`ds.alias.instanceId`	Bắt buộc** Mã nhận dạng phiên bản.
`ds.alias.databaseId`	Bắt buộc** Mã cơ sở dữ liệu.
`ds.alias.sql`	Bắt buộc** Truy vấn SQL cần chạy.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `true` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Cloud Spanner có câu lệnh 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

Trình kết nối cộng đồng

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `community` cho Trình kết nối cộng đồng. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Community Connector được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.connectorId`	Bắt buộc** Trình kết nối cộng đồng `connectorId` (còn được gọi là `deploymentId`).
`ds.alias.parameters`	Không bắt buộc. Các tham số bổ sung dành riêng cho trình kết nối, do cấu hình trình kết nối của trình kết nối cộng đồng xác định.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `true` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Kết nối với một trình kết nối cộng đồng bằng các tham số cấu hình state và 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

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `googleAnalytics` cho trình kết nối Google Analytics. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Google Analytics được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.accountId`	Bắt buộc** Mã tài khoản.
`ds.alias.propertyId`	Bắt buộc** Mã tài sản.
`ds.alias.viewId`	Mã nhận dạng chế độ xem. Bắt buộc** đối với tài sản Universal Analytics. Không đặt cho tài sản Google Analytics 4.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `false` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Google Analytics cho một tài sản 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

Cấu hình Google Analytics cho một tài sản 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

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `googleCloudStorage` Trình kết nối Google Cloud Storage. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Google Cloud Storage được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.pathType`	Bắt buộc** Loại đường dẫn. Sử dụng `FILE` để chọn một tệp hoặc `FOLDER` để chọn tất cả các tệp cho đường dẫn đã cho.
`ds.alias.path`	Bắt buộc** Đường dẫn tệp (ví dụ: MyBucket/MyData/MyFile.csv) nếu `pathType` là `FILE` hoặc đường dẫn thư mục (ví dụ: *MyBucket/MyData) nếu `pathType` là `FOLDER`.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `true` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Google Cloud Storage cho một tệp duy nhất:

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

Cấu hình Google Cloud Storage cho tất cả tệp trong đường dẫn:

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

Google Trang tính

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `googleSheets` cho trình kết nối Google Trang tính. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Google Trang tính được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.spreadsheetId`	Bắt buộc** Mã nhận dạng bảng tính.
`ds.alias.worksheetId`	Bắt buộc** Mã nhận dạng trang tính.
`ds.alias.hasHeader`	Không bắt buộc. Đặt thành `true` để sử dụng hàng đầu tiên làm tiêu đề. Mặc định là `true` nếu bạn không chỉ định. Tiêu đề cột phải riêng biệt. Cột có tiêu đề rỗng sẽ không được thêm vào nguồn dữ liệu.
`ds.alias.includeHiddenCells`	Không bắt buộc. Đặt thành `true` để bao gồm các ô bị ẩn. Mặc định là `true` nếu bạn không chỉ định.
`ds.alias.includeFilteredCell`	Không bắt buộc. Đặt thành `true` để bao gồm các ô đã lọc. Mặc định là `true` nếu bạn không chỉ định.
`ds.alias.range`	Không bắt buộc. Dải ô, ví dụ: A1:B52.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `true` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Google Trang tính:

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

Cấu hình Google Trang tính có hàng đầu tiên được dùng làm tiêu đề và các ô bị ẩn và được lọc:

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

Cấu hình Google Trang tính có một dải ô (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

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `looker` cho trình kết nối Looker. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Looker được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.instanceUrl`	Bắt buộc** URL phiên bản Looker.
`ds.alias.model`	Bắt buộc** Mô hình Looker.
`ds.alias.explore`	Bắt buộc** Dữ liệu khám phá của Looker.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `false` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Kết nối với một mục Khám phá trên Looker:

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

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Đặt thành `searchConsole` cho trình kết nối Search Console. Nếu được đặt, sẽ thay thế nguồn dữ liệu bằng cấu hình Search Console được cung cấp. Xem phần Thay thế và cập nhật.
`ds.alias.siteUrl`	Bắt buộc** URL của trang web. Đối với Tài sản miền, hãy thêm tiền tố `sc-domain\:`.
`ds.alias.tableType`	Bắt buộc** Đặt loại bảng. Có thể là một trong hai giá trị `SITE_IMPRESSION` hoặc `URL_IMPRESSION`.
`ds.alias.searchType`	Bắt buộc** Đặt loại tìm kiếm. Có thể là một trong các giá trị `WEB`, `IMAGE`, `VIDEO` hoặc `NEWS`.
`ds.alias.refreshFields`	Không bắt buộc. Mặc định là `false` nếu bạn không chỉ định. Hãy xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Search Console cho một tài sản có tiền tố 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

Cấu hình Search Console cho một Tài sản miền:

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

Quyền đối với mẫu

Để đảm bảo mang lại trải nghiệm tốt nhất cho người dùng, bạn cần phải thiết lập chính xác quyền truy cập vào báo cáo cho báo cáo mẫu và các nguồn dữ liệu liên kết. Các quyền bắt buộc phụ thuộc vào việc mẫu báo cáo có sử dụng nguồn dữ liệu được nhúng so với nguồn dữ liệu có thể sử dụng lại hay không và liệu cấu hình Linking API được đặt thành thay thế hoặc cập nhật cấu hình nguồn dữ liệu hay không.

Bảng sau đây cung cấp quyền truy cập vào nguồn dữ liệu được đề xuất để mang lại trải nghiệm tối ưu cho người dùng dựa trên nguồn dữ liệu mẫu và cấu hình Linking API:

Loại nguồn dữ liệu	Cấu hình API liên kết cho nguồn dữ liệu	Đề xuất về quyền đối với nguồn dữ liệu	Ghi chú
Được nhúng	Thay thế	Không áp dụng – Quyền xem sẽ được kế thừa từ báo cáo.	Nếu có quyền xem báo cáo mẫu, người dùng sẽ tự động có quyền xem mọi nguồn dữ liệu được nhúng.
Được nhúng	Cập nhật	Không áp dụng – Quyền xem sẽ được kế thừa từ báo cáo.	Nếu có quyền xem báo cáo mẫu, người dùng sẽ tự động có quyền xem mọi nguồn dữ liệu được nhúng.
Có thể sử dụng lại	Thay thế	Người dùng không cần có quyền xem.	Vì cấu hình nguồn dữ liệu sẽ được thay thế hoàn toàn thông qua Linking API, nên bạn không cần có quyền truy cập vào chế độ xem.
Có thể sử dụng lại	Cập nhật	Người dùng cần có quyền xem.	Bạn cần có quyền xem nguồn dữ liệu để Linking API có thể đọc và sử dụng cấu hình từ nguồn dữ liệu mẫu. Nếu không có quyền xem, người dùng sẽ nhận được thông báo lỗi khi tải báo cáo.

Sử dụng báo cáo trống hoặc báo cáo mặc định

Để sử dụng báo cáo trống hoặc báo cáo mặc định, hãy định cấu hình Linking API như sau:

Loại báo cáo Đặt tham số điều khiển reportId Đặt các thông số nguồn dữ liệu (ds). Ghi chú

Báo cáo trống Không Không

Báo cáo mặc định

Không

Có

Loại báo cáo	Đặt tham số điều khiển `reportId`	Đặt các thông số nguồn dữ liệu (`ds`).	Ghi chú
Báo cáo trống	Không	Không
Báo cáo mặc định	Không	Có	Báo cáo mặc định do Looker Studio cung cấp. Bạn không bắt buộc phải sử dụng tên đại diện của nguồn dữ liệu khi chỉ định các tham số nguồn dữ liệu cho báo cáo mặc định, vì báo cáo mặc định có một nguồn dữ liệu được nhúng duy nhất.

Báo cáo mặc định do Looker Studio cung cấp.

Bạn không bắt buộc phải sử dụng tên đại diện của nguồn dữ liệu khi chỉ định các tham số nguồn dữ liệu cho báo cáo mặc định, vì báo cáo mặc định có một nguồn dữ liệu được nhúng duy nhất.

Các ví dụ sau đây cho thấy nhiều URL Linking API sử dụng báo cáo trống hoặc báo cáo mặc định.

Bắt đầu quy trình tạo báo cáo bằng một báo cáo trống:

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

Khởi tạo quy trình tạo báo cáo bằng một báo cáo trống và đặt tên báo cáo:

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

Sử dụng mẫu báo cáo mặc định với cấu hình trình kết nối Google Trang tính:

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

Nhúng báo cáo

Để nhúng một báo cáo được tạo bằng Linking API, hãy đặt các thông số URL và thêm đường dẫn /embed/. URL nhúng Linking API phải có dạng như sau:

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

Tìm mã nhận dạng và tên thay thế

Mã báo cáo

Cách tìm mã báo cáo:

Mở báo cáo mà bạn muốn dùng làm mẫu. Kiểm tra URL của báo cáo. Phần giữa reporting/ và /page là mã báo cáo. Ví dụ: trong URL sau, 0B_U5RNpwhcE6SF85TENURnc4UjA là mã báo cáo:

https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M

Thanh địa chỉ của trình duyệt cho thấy URL của một báo cáo Looker Studio.
Mã báo cáo được làm nổi bật. — Tìm mã báo cáo trong URL của báo cáo.

Tên đại diện của nguồn dữ liệu

Một báo cáo có thể có nhiều nguồn dữ liệu. Bạn nên tham chiếu một nguồn dữ liệu theo tên đại diện của nguồn dữ liệu đó.

Cách tìm tên đại diện của nguồn dữ liệu:

Chỉnh sửa báo cáo.
Trên thanh công cụ, hãy chọn Tài nguyên > Quản lý nguồn dữ liệu đã thêm.
Kiểm tra cột Bí danh để tìm thông tin về bí danh cho từng nguồn dữ liệu.

Bạn có thể chỉnh sửa tên bí danh để đảm bảo khả năng tương thích ngược khi một Nguồn dữ liệu được thêm hoặc xoá.

Danh sách Nguồn dữ liệu trên trang quản lý tài nguyên Nguồn dữ liệu.
Cột Tên thay thế được làm nổi bật. — Tìm tên đại diện của nguồn dữ liệu trên trang quản lý *Nguồn dữ liệu*.

Loại giắc cắm

Một báo cáo có thể có nhiều nguồn dữ liệu, mỗi nguồn dữ liệu được tạo bằng cách định cấu hình một trình kết nối. Cách tìm loại trình kết nối được dùng để tạo nguồn dữ liệu:

Chỉnh sửa báo cáo.
Trên thanh công cụ, hãy chọn Tài nguyên > Quản lý nguồn dữ liệu đã thêm.
Kiểm tra cột Loại trình kết nối để xác định trình kết nối được dùng để tạo nguồn dữ liệu.

Danh sách Nguồn dữ liệu trên trang quản lý tài nguyên Nguồn dữ liệu.
Cột Loại giắc cắm được làm nổi bật. — Tìm loại trình kết nối nguồn dữ liệu trong trang quản lý *Nguồn dữ liệu*.

Mẹo hay và cách khắc phục sự cố

Nếu bạn gặp vấn đề, hãy xem xét thông tin chi tiết bên dưới để xác định các vấn đề tiềm ẩn và lỗi cấu hình thường gặp.

Hộp thoại gỡ lỗi

Sử dụng hộp thoại gỡ lỗi để xem lại cấu hình Linking API do Looker Studio diễn giải. Việc này có thể giúp gỡ lỗi các vấn đề với API.

Khi xảy ra lỗi trong quá trình phân tích cú pháp URL Linking API, một hộp thoại sẽ tự động xuất hiện kèm theo thông tin chi tiết về lỗi.
Khi xảy ra lỗi và không có hộp thoại nào tự động xuất hiện, hãy tìm nút thông tin ở phía trên cùng bên phải của báo cáo. Nhấp để xem thông tin gỡ lỗi bổ sung.
Nếu không có nút thông tin, bạn có thể bật nút này bằng cách thêm tham số &c.explain=true vào cuối bất kỳ URL nào của Linking API.

Quyền

Đảm bảo bạn đã thiết lập đúng quyền đối với mẫu cho các loại nguồn dữ liệu và cấu hình Linking API. Hãy xem phần Quyền đối với mẫu để biết thông tin chi tiết.

Cập nhật so với thay thế

Nếu bạn đang cập nhật cấu hình nguồn dữ liệu từ một mẫu nguồn dữ liệu, hãy xem xét cấu hình nguồn dữ liệu mẫu và cấu hình Linking API để đảm bảo chúng tương thích. Xác nhận rằng các trường được tạo từ cấu hình mới tương thích với các thành phần và cấu hình báo cáo.

Khi thực hiện thao tác cập nhật so với thao tác thay thế, bạn có thể đặt một cấu hình không hợp lệ với hành vi không xác định. Hãy xem phần Thay thế so với cập nhật để biết thông tin chi tiết.

Làm mới các trường

Nếu bạn đã định cấu hình tên trường, loại hoặc thông tin tổng hợp cho một nguồn dữ liệu mẫu, thì những thay đổi này sẽ chỉ được chuyển sang nguồn dữ liệu đã định cấu hình Linking API nếu bạn đặt tham số ds.refreshFields thành false.

Xem xét tham số nguồn dữ liệu ds.refreshFields trong URL Linking API. Nếu bạn bỏ qua, hãy xác nhận rằng giá trị mặc định của tham số cho mỗi loại trình kết nối là chính xác cho trường hợp sử dụng của bạn.

Nhìn chung, nếu bạn đã định cấu hình các trường trong nguồn dữ liệu mẫu và chắc chắn rằng các cấu hình nguồn dữ liệu mới thông qua Linking API sẽ luôn tạo ra các trường giống hệt nhau, thì bạn nên đặt refreshFields thành false.

Ví dụ: nếu trong quá trình tạo mẫu báo cáo, Looker Studio xác định một trường nguồn dữ liệu cụ thể là loại Số và bạn thay đổi trường đó thành loại Năm, thì thay đổi về cấu hình trường này hiện là một phần của nguồn dữ liệu mẫu. Mọi biểu đồ trong mẫu báo cáo sử dụng trường đã sửa đều sẽ mong đợi một Năm và nếu biểu đồ dựa trên thời gian, thì biểu đồ đó có thể không hiển thị nếu không có trường này. Nếu Linking API được dùng để cung cấp một cấu hình nguồn dữ liệu mới tạo ra các trường giống hệt nhau, thì sẽ có 2 kết quả dựa trên giá trị của tham số refreshFields:

Nếu được đặt thành true, cấu hình trường từ nguồn dữ liệu mẫu sẽ không được chuyển tiếp và các biểu đồ có thể không tải được nếu chúng phụ thuộc vào cùng một cấu hình trường (tức là một trường thuộc loại Năm).
Nếu bạn đặt thành false, cấu hình trường từ nguồn dữ liệu mẫu sẽ được chuyển sang nguồn dữ liệu mới và biểu đồ báo cáo sẽ nhận được các trường tương tự với cùng cấu hình và tải thành công.

Phản hồi và hỗ trợ

Sử dụng Công cụ theo dõi lỗi để báo cáo các vấn đề về Linking API hoặc để đưa ra ý kiến phản hồi. Hãy xem phần Hỗ trợ để biết các tài nguyên chung về cách nhận trợ giúp và đặt câu hỏi.

Nhật ký thay đổi

06/06/2023

Đã thêm các thông số báo cáo r.measurementId và r.keepMeasurementId để định cấu hình chế độ cài đặt báo cáo Mã đo lường Google Analytics.
Đã thêm ds.keepDatasourceName để kiểm soát việc sử dụng lại tên nguồn dữ liệu mẫu.
Đã thêm mục Nhúng báo cáo.
Trình kết nối BigQuery
- Đã thêm sqlReplace. Cho phép bạn chỉ định mẫu và chuỗi thay thế để cập nhật truy vấn SQL của nguồn dữ liệu mẫu.

2023-05-22

Thêm tính năng hỗ trợ cho trình kết nối Looker.
Thêm tính năng hỗ trợ cho Trình kết nối cộng đồng.

21/11/2022

Thêm khả năng sử dụng báo cáo trống. Xem phần Sử dụng báo cáo trống hoặc báo cáo mặc định
Đã thêm mục refreshFields vào phần Mẹo hay và cách khắc phục sự cố.

14/11/2022

Tài liệu tham khảo về trình kết nối Surveys đã bị xoá do Google Surveys ngừng hoạt động.

2022-06-15

Kết thúc giai đoạn thử nghiệm
- Integration API đã được đổi tên thành Linking API.
- Linking API đã kết thúc giai đoạn thử nghiệm beta.
Thêm tham số kiểm soát pageId để cho phép liên kết đến một trang báo cáo cụ thể.
Đã thêm tham số kiểm soát mode để đặt trạng thái báo cáo thành chế độ Xem hoặc Chỉnh sửa khi tải.
Giờ đây, bạn có thể thay thế hoàn toàn hoặc cập nhật một phần cấu hình nguồn dữ liệu. Hành vi này được xác định bằng cách đặt tham số ds.connector. Hãy xem phần Thay thế so với cập nhật để biết thông tin chi tiết.
Giờ đây, một mẫu mặc định sẽ được dùng nếu bạn không cung cấp mẫu báo cáo bằng tham số c.reportId.
Thêm tham số nguồn dữ liệu ds.refreshFields. Điều này cho phép bạn kiểm soát việc các trường nguồn dữ liệu có được làm mới hay không khi tải cấu hình nguồn dữ liệu.
Trình kết nối BigQuery
- Bạn không bắt buộc phải có projectId khi đặt type thành CUSTOM_QUERY.
- Khi billingProjectId không được đặt, dự án thanh toán sẽ quay lại projectId hoặc dự án của bảng được truy vấn.
- Thêm tính năng hỗ trợ cho các bảng được phân vùng theo ngày. Đặt tham số isPartitioned thành true để sử dụng trường phân vùng làm phương diện phạm vi ngày.
- Thêm tính năng hỗ trợ truy vấn các bảng được phân vùng theo ngày bằng cách sử dụng ký tự đại diện hoặc hậu tố bảng YYYYMMDD.
- Đã thêm tính năng hỗ trợ truy vấn Google Analytics, Firebase Analytics hoặc các bảng Crashlytics và chọn một mẫu trường.
Google Trang tính
- hasHeader mặc định là true, nhất quán với giá trị mặc định của giao diện người dùng trên web.
- includeHiddenAndFilteredCell chia thành includeHiddenCells và
- includeFilteredCells. Cả hai hiện đều mặc định là true, nhất quán với chế độ mặc định của giao diện người dùng trên web.
Trình kết nối Search Console
- Đổi tên tham số propertyType thành searchType.
Trình kết nối khảo sát
- surveyId hiện chấp nhận một mã nhận dạng khảo sát duy nhất hoặc danh sách mã nhận dạng khảo sát được phân tách bằng dấu phẩy.

2021-12-16

Bản phát hành đầu tiên của Integration API.
- Hỗ trợ việc liên kết đến một báo cáo hiện có và đặt tên báo cáo.
- Bạn có thể định cấu hình nhiều nguồn dữ liệu và đặt tên cho từng nguồn dữ liệu.
- Hỗ trợ các loại trình kết nối sau: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google Trang tính, Google Khảo sát, Search Console.

API liên kết Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Giới thiệu

Trường hợp sử dụng và lợi ích

Cách hoạt động

Quy trình làm việc của nhà phát triển Linking API

Trải nghiệm người dùng Linking API

Yêu cầu

Thông số URL

Tham số kiểm soát

Các thông số báo cáo

Tham số nguồn dữ liệu

Tham số nguồn dữ liệu

Thay thế và cập nhật – Cấu hình nguồn dữ liệu

Tham số bắt buộc khi bạn đặt ds.connector

Ví dụ

Tạo so với Thêm

Ký tự đại diện cho tên đại diện của nguồn dữ liệu

Tài liệu tham khảo về trình kết nối

BigQuery

Truy vấn BẢNG

Mẫu trường cho Google Analytics, Firebase Analytics và Crashlytics

Truy vấn TUỲ CHỈNH

Cloud Spanner

Trình kết nối cộng đồng

Google Analytics

Google Cloud Storage

Google Trang tính

Looker

Search Console

Quyền đối với mẫu

Sử dụng báo cáo trống hoặc báo cáo mặc định

Nhúng báo cáo

Tìm mã nhận dạng và tên thay thế

Mã báo cáo

Tên đại diện của nguồn dữ liệu

Loại giắc cắm

Mẹo hay và cách khắc phục sự cố

Hộp thoại gỡ lỗi

Quyền

Cập nhật so với thay thế

Làm mới các trường

Phản hồi và hỗ trợ

Nhật ký thay đổi

06/06/2023

2023-05-22

21/11/2022

14/11/2022

2022-06-15

2021-12-16

API liên kết

Tham số bắt buộc khi bạn đặt `ds.connector`