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ả |
---|---|
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. | |
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. | |
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.
|
|
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ả |
---|---|
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. | |
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 |
|
Không bắt buộc. Hãy đặt thành Nếu bạn chưa 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ả |
---|---|
Không bắt buộc. Đặt tên cho nguồn dữ liệu. Nếu không chỉ định |
|
Không bắt buộc. Đặt thành Nếu không chỉ định |
|
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ố |
|
Không bắt buộc.
Đặt thành Đặt thành 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 :
|
|
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 .
|
|
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ố. |
|
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ả |
---|---|
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. |
|
Bắt buộc** Loại truy vấn. Đặt thành TABLE . |
|
Bắt buộc** Mã dự án của bảng để truy vấn. | |
Bắt buộc** Mã tập dữ liệu của bảng để truy vấn. | |
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. |
|
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. |
|
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. |
|
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ả |
---|---|
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. |
|
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. |
|
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ả |
---|---|
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. |
|
Bắt buộc** Loại truy vấn. Đặt thành CUSTOM_QUERY . |
|
Bắt buộc** Truy vấn SQL để chạy. | |
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. |
|
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ụ: |
|
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ả |
---|---|
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. |
|
Bắt buộc** Mã dự án. | |
Bắt buộc** Mã thực thể. | |
Bắt buộc** Mã cơ sở dữ liệu. | |
Bắt buộc** Truy vấn SQL để chạy. | |
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ả |
---|---|
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. |
|
Bắt buộc** Trình kết nối cộng đồng connectorId (còn gọi là deploymentId ).
| |
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. | |
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ả |
---|---|
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. |
|
Bắt buộc** Mã tài khoản. | |
Bắt buộc** Mã tài sản. | |
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. |
|
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ả |
---|---|
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. |
|
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. |
|
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 . |
|
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ả |
---|---|
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. |
|
Bắt buộc** Mã bảng tính. | |
Bắt buộc** Mã trang tính. | |
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.
|
|
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. |
|
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. |
|
Không bắt buộc. Dải ô, ví dụ: A1:B52. | |
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ả |
---|---|
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. |
|
Bắt buộc** URL thực thể Looker. | |
Bắt buộc** Mô hình Looker. | |
Bắt buộc** Looker Explore. | |
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ả |
---|---|
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. |
|
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\: . |
|
Bắt buộc** Đặt loại bảng. Có thể là một trong hai giá trị SITE_IMPRESSION hoặc URL_IMPRESSION . |
|
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 . |
|
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 ( ). |
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. |
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.](https://developers.google.cn/static/looker-studio/integrate/images/reportId-parameter.png?authuser=5&hl=vi)
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.](https://developers.google.cn/static/looker-studio/integrate/images/data-source-alias.png?authuser=5&hl=vi)
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.](https://developers.google.cn/static/looker-studio/integrate/images/data-source-connector.png?authuser=5&hl=vi)
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.
- Đã thêm
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 đặttype
thànhCUSTOM_QUERY
. - Khi bạn không đặt
billingProjectId
, thì dự án thanh toán sẽ dự phòng thànhprojectId
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ànhtrue
để 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.
- Không bắt buộc phải có
- 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ànhincludeHiddenCells
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ànhsearchType
.
- Đổi tên thông số
- 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.