Trang này được dịch bởi Cloud Translation API.

API liên kết

Giới thiệu

API Liên kết 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 báo cáo của Looker Studio thông qua một URL. Khi người dùng nhấp vào một URL của API Liên kết, họ sẽ có một trải nghiệm đơn giản để xem và tương tác với dữ liệu của họ một cách nhanh chóng.

Tài liệu này mô tả định dạng bắt buộc của URL API liên kết 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 API Liên kết để cung cấp báo cáo được định cấu hình trước để khách hàng xem và tương tác với dữ liệu của họ. Sau đây là các lợi ích chính của API Liên kết:

Trải nghiệm tạo báo cáo bằng một lần nhấp cho khách hàng.
- Cấu hình dữ liệu được cung cấp trong URL để người dùng không cần thiết lập 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 lần nhấp và truy cập lại vào báo cáo đó bất cứ lúc nào.
Tạo báo cáo ở quy mô lớn. API Liên kết giúp giảm thời gian cần thiết để sao chép hoặc tạo báo cáo mới.
Cho phép 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 công việc của sản phẩm.

Cách thức hoạt động

Phần sau đây mô tả cách nhà phát triển và người dùng tương tác với API Liên kết.

Quy trình làm việc của nhà phát triển API liên kết

Nhà phát triển chuẩn bị báo cáo mẫu, nguồn dữ liệu và định dạng URL của API liên kết. Quy trình làm việc điển hình dành cho các nhà phát triển như sau:

Quyết định xem bạn 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 để dùng làm mẫu. Điều này bao gồm việc định cấu hình nguồn dữ liệu mẫu.
Định dạng URL của API Liên kết 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 thông số khác, bao gồm cả tên báo cáo, tên nguồn dữ liệu và cấu hình nguồn dữ liệu.
Hãy sử dụng URL của API liên kết để chuyển hướng người dùng đến báo cáo.

Trải nghiệm người dùng khi liên kết API

Người dùng truy cập một URL của API Liên kết. Nếu được nhà phát triển định cấu hình đúng cách, họ sẽ được chuyển đến một báo cáo của Looker Studio để xem và tương tác với dữ liệu mà họ có quyền truy cập. Sau đây là một số trải nghiệm người dùng điển hình:

Trong trình duyệt, người dùng sẽ truy cập vào một dịch vụ đã tích hợp với API Liên kết.
Lời kêu gọi hành động mời người dùng nhấp vào đường liên kết để xem dữ liệu của họ trong Looker Studio.
Người dùng truy cập vào đường liên kết và được chuyển đến báo cáo của 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 một URL của API liên kết hoạt động như mong đợi, bạn phải đáp ứng những yêu cầu sau:

Báo cáo để phân phát dưới dạng mẫu. Nếu không được 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 của một URL API liên kết tối thiểu phải có quyền xem báo cáo mẫu. Tuỳ thuộc vào loại nguồn dữ liệu được sử dụng trong báo cáo và cấu hình được cung cấp qua API Liên kết, người dùng cũng có thể yêu cầu quyền xem nguồn dữ liệu. 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 API liên kết. 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 của URL API liên kết phải có quyền truy cập vào dữ liệu được định cấu hình trong URL API liên kết. Nếu người dùng không có quyền truy cập vào dữ liệu cơ bản, thì mọi thành phần trong báo cáo phụ thuộc sẽ hiển thị lỗi.

Tham số URL

URL của API liên kết phải có dạng như sau:

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

URL được dự kiến sẽ được sử 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 báo cáo này để Nhúng báo cáo.

URL mẫu

Sau đây là ví dụ về URL API liên kết. Tên báo cáo đã được đặt và một nguồn dữ liệu BigQuery đượ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 nhất định là bắt buộc, trong khi một số tham số là không bắt buộc. Sau đây là danh sách các tham số dùng để xác định URL của API Liên kết:

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 qua URL của API Liên kết.

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 được chỉ định. Để biết thông tin chi tiết về cách tìm mã, hãy xem phần Mã báo cáo. Nếu bạn không chỉ định, thì 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 mặc định để biết thông tin chi tiết.
`c.pageId`	Không bắt buộc. Mã của trang ban đầu cần tải trong báo cáo. Giá trị mặc định sẽ là trang đầu tiên của báo cáo nếu không chỉ định.
`c.mode`	Không bắt buộc. Chế độ báo cáo ban đầu. Một trong `view` hoặc `edit`. Giá trị mặc định là `view` nếu không chỉ định.
`c.explain`	Không bắt buộc. Mức độ hiển thị của hộp thoại thông tin/gỡ lỗi. Đặt thành `true` để hiển thị nút hộp thoại. Giá trị mặc định là `false` nếu không chỉ định. 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

Thông số báo cáo

Các thông số báo cáo sẽ ghi đè 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 không chỉ định, thì tên mặc định sẽ 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 sử dụng dấu phẩy để phân tách nhiều mã. Nếu bạn chưa 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 không được đặ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. Hãy đặt thành `true` để sử dụng báo cáo mẫu Mã đo lường Google Analytics. Giá trị mặc định là `false` nếu không chỉ định. Nếu bạn chưa 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 không được đặ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 không chỉ định, thì tên mặc định sẽ 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 sử dụng dấu phẩy để phân tách nhiều mã.

Nếu bạn chưa 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 không được đặ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. Hãy đặt thành true để sử dụng báo cáo mẫu Mã đo lường Google Analytics. Giá trị mặc định là false nếu 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

Thông số nguồn dữ liệu

Thông 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 nguồn dữ liệu trong báo cáo mẫu.

alias được dùng để tham chiếu một nguồn dữ liệu trong báo cáo hiện có. Việc sử dụng bí danh 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 bài viết Bí danh của nguồn dữ liệu.

Thông số nguồn dữ liệu

Các tham số sau đây phổ biến trên 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 không chỉ định `ds.datasourceName` và `ds.keepDatasourceName`, thì 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, 10:53 CH). 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. Giá trị mặc định là `false` nếu không chỉ định. Nếu không chỉ định `ds.datasourceName` và `ds.keepDatasourceName`, thì 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, 10:53 CH). 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, bạn phải chỉ định tất cả thông số trình kết nối bắt buộc cho loại trình kết nối trong URL liên kết của 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 chỉ định, thì bạn có thể chỉ định không hoặc nhiều tham số trình kết nối cho loại trình kết 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 tham số không được cung cấp trong URL của API Liên kết. Để 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ề mức độ ảnh hưởng của thông số `ds.connector` đến việc cấu hình nguồn dữ liệu của mẫu có được thay thế toàn bộ hay được dùng để cập nhật các tham số không chỉ định hay không, 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 API liên kết nhằm 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 các 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 loại trình kết nối mà trong đó việc thay đổi cấu hình sẽ dẫn đến các trường khác nhau (ví dụ: các trường cho nguồn dữ liệu BigQuery thường thay đổi với 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 so với 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 giữ nguyên mọi thay đổi đối với trường mà bạn đã thực hiện đối với nguồn dữ liệu của mẫu. Nếu không chỉ định, giá trị mặc định sẽ thay đổi theo loại trình kết nối. Hãy xem lại Tài liệu tham khảo về trình kết nối để biết các chế độ mặc định dành riêng cho 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 bạn đặt `refreshFields` thành `false` và cấu hình nguồn dữ liệu được chỉ định thông qua API Liên kết tạo ra các trường khác với nội dung đượ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 bị ảnh hưởng. Các thay đổi đối với các trường trong nguồn dữ liệu mẫu (ví dụ: tên, loại, dữ liệu tổng hợp, v.v.) không được chuyển sang nguồn dữ liệu mới khi bạn đặt `refreshFields` thành `true`. Đặt `refreshFields` thành `false` để duy trì cấu hình trường từ nguồn dữ liệu mẫu. Các trường đã tính và Tham số xác định trong các nguồn dữ liệu mẫu sẽ luôn được sao chép vào các nguồn dữ liệu mới tạo và không chịu ảnh hưởng của 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 Loại trình kết nối. Để biết thông tin chi tiết về các thông số nguồn dữ liệu có sẵn cho mỗi 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ế so với cập nhật – Cấu hình nguồn dữ liệu

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

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

Bạn đã đặt `ds.connector` chưa?	Cấu hình và hành vi dự kiến	Cách sử dụng thông thường
Có	Thay thế. Cấu hình nguồn dữ liệu mẫu được thay thế toàn bộ bằng cách sử dụng các tham số nguồn dữ liệu được chỉ định trong URL của API Liên kết. Bạn phải chỉ định tất cả các tham số bắt buộc cho loại trình kết nối. Xem Tham số bắt buộc khi đặt `ds.connector`.	Khi thay đổi loại trình kết nối của 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 trên Trang tính thông qua API Liên kết. Điều này sẽ yêu cầu bạn phải 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ể đang được sử 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 tham số không được cung cấp trong URL của API Liên kết. Bạn không bắt buộc phải sử dụng tất cả các tham số trình kết nối cho loại trình kết nối, trừ khi có quy định khác. Điều này giúp đơn giản hoá URL của API liên kết. Bạn nên chọn cách này khi đã quen với cấu hình nguồn dữ liệu của mẫu và chỉ muốn ghi đè một nhóm nhỏ tham số.	Khi bạn chỉ muốn cung cấp các giá trị thông số khác với nguồn dữ liệu mẫu và đồng ý dựa vào nguồn dữ liệu mẫu cho mọi thông số trình kết nối chưa 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 đặt `ds.connector`

Nếu bạn chỉ định tham số ds.connector của nguồn dữ liệu, thì bạn phải chỉ định tất cả thông 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 xác định, thì tất cả thông số của trình kết nối, ngay cả những thông 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 chỉ có 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 có một nguồn dữ liệu duy nhất. 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 có một nguồn dữ liệu BigQuery duy nhất (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 báo cáo có hai nguồn dữ liệu, nguồn dữ liệu BigQuery (ds0) và nguồn dữ liệu Google Analytics (ds1). Cấu hình nguồn dữ liệu BigQuery được thay thế toàn bộ, trong khi cấu hình Google Analytics 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 chưa đượ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, việc có cùng một nguồn dữ liệu trong nhiều báo cáo có thể hữu ích. Vì vậy, việc cập nhật nguồn dữ liệu sẽ ảnh hưởng đến tất cả báo cáo cùng nhau. Khi tạo báo cáo bằng API Liên kết, bạn có thể thêm lại 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 được (xem 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 đến nguồn dữ liệu theo bí danh
Url không sử dụng bí danh đại diện (xem Ký tự đại diện của nguồn dữ liệu)

Khi một nguồn dữ liệu mới được tạo bằng API Liên kết, nguồn dữ liệu đó sẽ sử dụng thông tin xác thực 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ơ sở, nếu không, 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 tạo, bạn có thể giữ lại thông tin xác thực của nguồn đó để người dùng có thể tiếp tục truy cập vào dữ liệu trong các báo cáo mới của họ.

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

Để áp dụng tham số API Liên kết cho nhiều nguồn dữ liệu, bạn có thể sử dụng bí danh ký tự đại diện ds.* thay cho bí danh của nguồn dữ liệu.

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

  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 sử dụng ký tự đại diện ds.*, bạn có thể 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 tham số được cung cấp cho API Liên kết không sử dụng ký tự đại diện ds.* sẽ được ưu tiên hơn các tham số có 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 của 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 thông số là:

Một tham số được cung cấp cùng 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 ds.connector không được cung cấp (xem phần Thay thế so với cập nhật)
Giá trị mặc định cho tham số, nếu không bắt buộc.

Thông tin tham khảo về trình kết nối

API Liên kết 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, bạn sẽ được cung cấp danh sách các thông số nguồn dữ liệu có sẵn.

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ã nhận dạng bảng của bảng để truy vấn và CUSTOM_QUERY (trong đó bạn cung cấp câu lệnh SQL để truy vấn bảng).

Truy vấn TABLE

Các tham số sau đây có thể á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. Hãy đặt thành `bigQuery` cho trình kết nối BigQuery. Nếu bạn đặt chính sách này, thì nguồn dữ liệu này sẽ được thay thế bằng cấu hình BigQuery được cung cấp. Hãy xem phần Thay thế so với 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 để truy vấn.
`ds.alias.datasetId`	Bắt buộc** Mã tập dữ liệu của bảng để truy vấn.
`ds.alias.tableId`	Bắt buộc** Mã bảng của bảng để truy vấn. Bảng phân đoạn ngày: Hệ thống hỗ trợ hậu tố * (ký tự ký tự đại diện) hoặc `YYYYMMDD` khi truy vấn bảng phân đoạn ngày. Nếu một bảng được xác định là Google Analytics, Firebase Analytics hoặc Firebase Crashlytics, thì hệ thống sẽ chọn mẫu trường mặc định trừ phi bạn chỉ định mẫu trường đó. Xem các tham số liên quan đến bảng mẫu trường.
`ds.alias.billingProjectId`	Không bắt buộc. Mã dự án để thanh toán. Nếu bạn không đặt chính sách này, `projectId` sẽ được sử 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. Cách này chỉ áp dụng cho cách 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 áp dụng cho các bảng được phân vùng theo phạm vi số nguyên. Giá trị mặc định là `false` nếu không chỉ định. Để tìm hiểu thêm, hãy xem bài viết Giới thiệu về bảng được phân vùng.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `true` nếu không chỉ định. 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ể sử dụng các thông số bổ sung để đặt mẫu trường. Nếu 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 để sử dụng. Chỉ áp dụng khi dữ liệu xuất của BigQuery Export cho bảng Google Analytics đang được truy vấn. Một trong số `ALL`, `SESSION`, `HITS`. Đối với bảng Google Analytics, giá trị mặc định sẽ là `ALL` nếu không chỉ định.
`ds.alias.firebaseTemplateLevel`	Không bắt buộc. Mẫu trường Firebase Analytics để sử dụng. Chỉ áp dụng khi bảng BigQuery Export cho Firebase Analytics đang được truy vấn. Chỉ có thể đặt thành `EVENTS`. Đối với bảng trong Firebase Analytics, giá trị mặc định sẽ là `EVENTS` nếu không chỉ định.
`ds.alias.crashlyticsTemplateLevel`	Mẫu trường Firebase Crashlytics mà bạn có thể sử dụng. Chỉ có thể đặt thành `DEFAULT`. Chỉ áp dụng khi bảng BigQuery Export cho Firebase Crashlytics đang được truy vấn. Đối với bảng Firebase Crashlytics, giá trị mặc định sẽ là `DEFAULT` nếu không chỉ định.

Truy vấn CUSTOM

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

Tên thông số	Mô tả
`ds.alias.connector`	Không bắt buộc. Hãy đặt thành `bigQuery` cho trình kết nối BigQuery. Nếu bạn đặt chính sách này, thì nguồn dữ liệu này sẽ được thay thế bằng cấu hình BigQuery được cung cấp. Hãy xem phần Thay thế so với 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 để chạy.
`ds.alias.billingProjectId`	Không bắt buộc. Mã dự án để thanh toán. Nếu bạn không đặt chính sách này, `projectId` sẽ được sử dụng. Nếu bạn không đặt `projectId`, thì hệ thống sẽ sử dụng dự án của bảng được truy vấn.
`ds.alias.sqlReplace`	Không bắt buộc. Danh sách các 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 thay thế chuỗi nếu có mẫu khớp. Hãy dùng dấu phẩy để phân tách các cặp mẫu và chuỗi thay thế. Ví dụ: `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `true` nếu không chỉ định. 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 một bảng phân đoạn 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 một bảng phân đoạn 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 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 phân vùng thời gian nhập 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

Cấu hình loại CUSTOM_QUERY mà trong đó truy vấn được xác định bằng 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ó 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 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, nguồn dữ liệu này sẽ được thay thế bằng cấu hình Cloud Spanner được cung cấp. Hãy xem phần Thay thế so với cập nhật.
`ds.alias.projectId`	Bắt buộc** Mã dự án.
`ds.alias.instanceId`	Bắt buộc** Mã thực thể.
`ds.alias.databaseId`	Bắt buộc** Mã cơ sở dữ liệu.
`ds.alias.sql`	Bắt buộc** Truy vấn SQL để chạy.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `true` nếu không chỉ định. Xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Cloud Spanner với 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, nguồn dữ liệu này sẽ được thay thế bằng cấu hình Trình kết nối cộng đồng được cung cấp. Hãy xem phần Thay thế so với cập nhật.
`ds.alias.connectorId`	Bắt buộc** Trình kết nối cộng đồng `connectorId` (còn gọi là `deploymentId`).
`ds.alias.parameters`	Không bắt buộc. Các thông số bổ sung dành riêng cho trình kết nối, như được xác định bằng cấu hình trình kết nối của trình kết nối cộng đồng.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `true` nếu không chỉ định. Xem refreshFields để biết thông tin chi tiết.

Ví dụ

Kết nối với trình kết nối cộng đồng có 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, nguồn dữ liệu này sẽ được thay thế bằng cấu hình Google Analytics được cung cấp. Hãy xem phần Thay thế so với 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ã chế độ xem. Bắt buộc** đối với các tài sản Universal Analytics. Đừng đặt cho tài sản Google Analytics 4.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `false` nếu không chỉ định. Xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình Google Analytics cho 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 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, nguồn dữ liệu này sẽ được thay thế bằng cấu hình Google Cloud Storage được cung cấp. Hãy xem phần Thay thế so với 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 duy nhất hoặc sử dụng `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. Giá trị mặc định là `true` nếu không chỉ định. Xem refreshFields để biết thông tin chi tiết.

Ví dụ

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

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, hãy thay thế nguồn dữ liệu bằng cấu hình Google Trang tính được cung cấp. Hãy xem phần Thay thế so với cập nhật.
`ds.alias.spreadsheetId`	Bắt buộc** Mã bảng tính.
`ds.alias.worksheetId`	Bắt buộc** Mã 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 đề. Giá trị mặc định là `true` nếu không chỉ định. Các tiêu đề cột phải là duy nhấ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. Giá trị mặc định là `true` nếu không chỉ định.
`ds.alias.includeFilteredCell`	Không bắt buộc. Đặt thành `true` để bao gồm các ô đã lọc. Giá trị mặc định là `true` nếu 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. Giá trị mặc định là `true` nếu không chỉ định. 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à bao gồm các ô bị ẩn và đã 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ó 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, nguồn dữ liệu này sẽ được thay thế bằng cấu hình Looker được cung cấp. Hãy xem phần Thay thế so với cập nhật.
`ds.alias.instanceUrl`	Bắt buộc** URL thực thể Looker.
`ds.alias.model`	Bắt buộc** Mô hình Looker.
`ds.alias.explore`	Bắt buộc** Looker Explore.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `false` nếu không chỉ định. Xem refreshFields để biết thông tin chi tiết.

Ví dụ

Kết nối với Dữ liệu khám phá của 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, nguồn dữ liệu này sẽ được thay thế bằng cấu hình Search Console được cung cấp. Hãy xem phần Thay thế so với 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 trạng thái `WEB`, `IMAGE`, `VIDEO` hoặc `NEWS`.
`ds.alias.refreshFields`	Không bắt buộc. Giá trị mặc định là `false` nếu không chỉ định. Xem refreshFields để biết thông tin chi tiết.

Ví dụ

Cấu hình trong 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 trong 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 truy cập mẫu

Để đảm bảo trải nghiệm người dùng tốt nhất, 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 quan. Các quyền cần thiết phụ thuộc vào việc mẫu báo cáo sử dụng nguồn dữ liệu được nhúng hay có thể sử dụng lại, cũng như việc cấu hình API Liên kết có được thiết lập để 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 người dùng tối ưu dựa trên các nguồn dữ liệu của mẫu và cấu hình API liên kết:

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ú
Ngày nhúng	Thay thế	Không áp dụng – Quyền xem sẽ được kế thừa từ báo cáo.	Nếu người dùng có quyền xem báo cáo mẫu, thì họ sẽ tự động có quyền xem mọi nguồn dữ liệu được nhúng.
Ngày 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 người dùng có quyền xem báo cáo mẫu, thì họ sẽ tự động có quyền xem mọi nguồn dữ liệu được nhúng.
Có thể dùng nhiều lần	Thay thế	Người dùng không cần quyền xem.	Vì cấu hình nguồn dữ liệu sẽ được thay thế toàn bộ thông qua API Liên kết, nên bạn không cần phải có quyền xem.
Có thể dùng nhiều lần	Cập nhật	Người dùng cần có quyền xem.	Để có thể đọc và sử dụng cấu hình từ nguồn dữ liệu mẫu, bạn phải có quyền xem nguồn dữ liệu. Nếu người dùng không có quyền xem thì họ sẽ gặp lỗi khi tải báo cáo.

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

Để sử dụng một báo cáo trống hoặc báo cáo mặc định, hãy định cấu hình API liên kết như sau:

Loại báo cáo Đặt thông số kiểm soát reportId Đặt 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 thông số kiểm soát `reportId`	Đặt 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 tham số nguồn dữ liệu cho báo cáo mặc định, vì báo cáo mặc định chỉ có một nguồn dữ liệu được nhúng.

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 tham số nguồn dữ liệu cho báo cáo mặc định, vì báo cáo mặc định chỉ có một nguồn dữ liệu được nhúng.

Ví dụ sau đây minh hoạ nhiều URL API liên kết sử dụng báo cáo trống hoặc mặc định.

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

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

Bắt đầu quy trình tạo báo cáo với 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 API Liên kết, hãy đặt tham số URL và thêm đường dẫn /embed/. URL nhúng API liên kết phải có dạng sau:

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

Tìm ID và bí danh

Mã báo cáo

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

Mở báo cáo bạn muốn sử dụng làm mẫu. Kiểm tra URL của báo cáo. Phần từ reporting/ đến /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 hiển thị URL của báo cáo Looker Studio.
Mã báo cáo được đánh dấu. — Tìm mã báo cáo trong URL 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. Nguồn dữ liệu phải được tham chiếu theo bí danh của nguồn đó.

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 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 thêm hoặc xoá Nguồn dữ liệu.

Danh sách Nguồn dữ liệu trong trang quản lý tài nguyên Nguồn dữ liệu.
Cột Bí danh đượ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 được tạo bằng cách định cấu hình trình kết nối. Cách tìm loại trình kết nối 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 dùng để tạo nguồn dữ liệu.

Danh sách Nguồn dữ liệu trong trang quản lý tài nguyên Nguồn dữ liệu.
Cột Connector Type (Loại trình kết nối) được làm nổi bật. — Tìm loại trình kết nối nguồn dữ liệu trên 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 đang gặp vấn đề, hãy xem thông tin chi tiết ở bên dưới để xác định các vấn đề tiềm ẩn và các lỗi cấu hình sai thường gặp.

Hộp thoại gỡ lỗi

Hãy sử dụng hộp thoại gỡ lỗi để xem lại cấu hình API Liên kết theo cách mà Looker Studio diễn giải. Việc này có thể giúp khắc phục các sự cố xảy ra với API.

Nếu 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 hiển thị 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 hiển thị, 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êm thông tin gỡ lỗi.
Nếu nút không có 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 API liên kết nào.

Quyền

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

Cập nhật và thay thế

Nếu bạn 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 lại cấu hình nguồn dữ liệu của mẫu và cấu hình API liên kết để đả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 cập nhật so với 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. Xem phần Thay thế so với cập nhật để biết 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 dữ liệu tổng hợp cho một nguồn dữ liệu mẫu, thì những thay đổi này sẽ chỉ chuyển sang nguồn dữ liệu đã định cấu hình API Liên kết nếu tham số ds.refreshFields được đặt thành false.

Xem lại tham số nguồn dữ liệu ds.refreshFields của URL API liên kết. Nếu bỏ qua, hãy xác nhận rằng giá trị mặc định của tham số cho từng 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 qua API liên kết 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 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 đã chỉnh sửa sẽ cần đến một Năm và nếu biểu đồ theo thời gian thì có thể sẽ không hiển thị. Nếu bạn dùng API Liên kết để 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 bạn đặt thành true, cấu hình trường từ nguồn dữ liệu mẫu sẽ không được chuyển 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à 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ẽ chuyển sang nguồn dữ liệu mới và các biểu đồ báo cáo sẽ nhận được cùng các trường có cùng cấu hình và tải thành công.

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

Hãy sử dụng Công cụ theo dõi lỗi để báo cáo vấn đề về API liên kết 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 yêu cầu trợ giúp và đặt câu hỏi.

Nhật ký thay đổi

2023-06-06

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 của 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.

2022-11-21

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

2022-11-14

Tệp tham chiếu đến trình kết nối Surveys đã bị xóa do Google Surveys sắp ngừng hoạt động.

2022-06-15

Kết thúc giai đoạn beta
- API Tích hợp được đổi tên thành API Liên kết.
- API Liên kết đã 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 thông số điều khiển mode để đặt trạng thái báo cáo thành chế độ Xem hoặc Chỉnh sửa khi tải.
Hiện tại, cấu hình của nguồn dữ liệu có thể được cập nhật một phần hoặc toàn bộ. Hành vi này được xác định dựa trên việc tham số ds.connector có được đặt hay không. Xem phần Thay thế so với cập nhật để biết thông tin chi tiết.
Mẫu báo cáo mặc định hiện được sử dụng nếu mẫu báo cáo không được cung cấp 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 xem các trường nguồn dữ liệu có được làm mới khi tải cấu hình nguồn dữ liệu hay không.
Trình kết nối BigQuery
- Không bắt buộc phải có projectId khi đặt type thành CUSTOM_QUERY.
- Khi bạn không đặt billingProjectId, thì dự án thanh toán sẽ dự phòng thành projectId hoặc dự án của bảng được truy vấn.
- Thêm tính năng hỗ trợ 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ợ cho việc truy vấn bảng Google Analytics, Firebase Analytics hoặc Crashlytics và chọn mẫu trường.
Google Trang tính
- hasHeader mặc định là true, phù hợp với mặc định giao diện người dùng web.
- includeHiddenAndFilteredCell đã tách thành includeHiddenCells và
- includeFilteredCells. Hiện tại, cả hai giá trị được đặt mặc định là true, phù hợp với chế độ mặc định của giao diện người dùng web.
Trình kết nối Search Console
- Đổi tên thông số propertyType thành searchType.
Trình kết nối Surveys
- surveyId hiện chấp nhận một mã khảo sát duy nhất hoặc một danh sách các mã 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ợ 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 Surveys, Search Console.

API liên kết

Giới thiệu

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

Cách thức hoạt động

Quy trình làm việc của nhà phát triển API liên kết

Trải nghiệm người dùng khi liên kết API

Yêu cầu

Tham số URL

Tham số kiểm soát

Thông số báo cáo

Thông số nguồn dữ liệu

Thông số nguồn dữ liệu

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

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

Ví dụ

Tạo so với Thêm

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

Thông tin tham khảo về trình kết nối

BigQuery

Truy vấn TABLE

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

Truy vấn CUSTOM

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 truy cập mẫu

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

Nhúng báo cáo

Tìm ID và bí danh

Mã báo cá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 và thay thế

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

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

Nhật ký thay đổi

2023-06-06

2023-05-22

2022-11-21

2022-11-14

2022-06-15

2021-12-16

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