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.
Ví dụ: giả sử nhà phát triển X có một ứng dụng web cho khách hàng của họ.
Khách hàng đăng nhập vào ứng dụng bằng thông tin đăng nhập của riêng họ và có thể xem dữ liệu bán hàng
cho các cửa hàng khác nhau. Mỗi khách hàng có quyền truy cập vào một danh sách cửa hàng khác nhau. Chiến lược phát hành đĩa đơn
nhà phát triển muốn nhúng trang tổng quan Looker Studio vào ứng dụng của họ để
khi đăng nhập, khách hàng chỉ thấy dữ liệu bán hàng của cửa hàng
mà họ có quyền truy cập. Khách hàng không cần phải đăng nhập vào Tài khoản Google
để quy trình này hoạt động.
Giải pháp được đề xuất sẽ cần nhà phát triển tạo Trình kết nối cộng đồng,
truyền mã thông báo thông qua URL được nhúng, sau đó lọc dữ liệu dựa trên mã thông báo.
Yêu cầu
Người xem trang tổng quan sẽ đăng nhập vào ứng dụng bên thứ ba.
Ứng dụng phải truyền một mã thông báo duy nhất đến trang tổng quan Looker Studio
thông qua URL nhúng. Mã thông báo có thể được dùng để tra cứu thông tin bộ lọc
hoặc đã mã hoá thông tin bộ lọc.
Trình kết nối cộng đồng có thể chuyển đổi mã thông báo thành bộ lọc
giá trị.
Các điểm hạn chế
Nếu bạn là khách hàng G Suite và quản trị viên của bạn đã tắt tính năng chia sẻ
Drive cho “Bất kỳ ai có liên kết”, bạn sẽ không thể chia sẻ
báo cáo với người dùng bên ngoài tổ chức của bạn.
Giải pháp
Hãy hoàn tất tất cả các bước sau để triển khai giải pháp này.
Tạo mã thông báo người dùng trong ứng dụng web
Tạo mã thông báo duy nhất cho mỗi người dùng đã đăng nhập trong ứng dụng web của bạn.Bạn sẽ
chuyển mã thông báo này đến trang tổng quan được nhúng ở bước sau.
Bạn nên sử dụng mã thông báo này để lọc dữ liệu có liên quan. Các lựa chọn bao gồm:
Tạo điểm cuối API trả về dữ liệu đã lọc hoặc thông tin người dùng
cho một mã thông báo cụ thể.
Mã hoá thông tin người dùng trong mã thông báo để có thể giải mã sau
trong trình kết nối.
getConfig() cần trả về ít nhất một mục cấu hình. Thông tin này sẽ được dùng để
thu thập mã thông báo từ các tham số của URL được nhúng.
functiongetConfig(request){varcc=DataStudioApp.createCommunityConnector();varconfig=cc.getConfig();config.newTextInput().setId('token').setName('Enter user token');// TODO: Add additional config values if applicable for your connectorconfig.setDateRangeRequired(false);config.setIsSteppedConfig(false);returnconfig.build();}
getData() sẽ có quyền truy cập vào mã thông báo này thông qua
Đối tượng request.configParams. Sử dụng mã thông báo này để tìm nạp dữ liệu đã lọc hoặc
lọc dữ liệu đã tìm nạp hiện có.
Theo ví dụ trên, mã thông báo sẽ là
request.configParams.token Trong getData(), mã thông báo được chuyển đến REST
Điểm cuối của API để lấy danh sách Mã cửa hàng. Sau đó, các Mã cửa hàng này sẽ được sử dụng
để tạo truy vấn SQL nhằm tìm nạp dữ liệu doanh số bán hàng.
varSTORE_ID_API='https://www.example.com/api/storeid';varQUERY_STRING_PREFIX="SELECT StoreName, Sales from stores"functiongetData(request){vartoken=request.configParams.token;varstoreIds=getStoreIdList(token);varqueryString=constructQueryString(storeIds);varfetchedData=fetchData(queryString);// rest of getData() implementation}functiongetStoreIdList(token){varurl=STORE_ID_API;varresponse=UrlFetchApp.fetch(url);varparsedResponse=JSON.parse(response);returnparsedResponse.storeIds;}functionconstructQueryString(storeIds){varstoreIdString=storeIds.join(',');varqueryString=QUERY_STRING_PREFIX+' WHERE storeId in ('+storeIdString+')';returnqueryString;}
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eEmbed Looker Studio dashboards in third-party applications, allowing clients to view relevant data without Google logins.\u003c/p\u003e\n"],["\u003cp\u003eSecurely filter data using unique, short-lived tokens passed through the embed URL, fetched by a custom Community Connector.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need to create a Community Connector, handle token generation and data filtering, and configure Looker Studio sharing settings for embedding.\u003c/p\u003e\n"],["\u003cp\u003eTokens can either directly contain encrypted filter information or be used to retrieve it from an API endpoint, enhancing data security.\u003c/p\u003e\n"],["\u003cp\u003eG Suite users need to ensure Drive sharing is enabled for "Anyone with a Link" for external access to the embedded dashboard.\u003c/p\u003e\n"]]],[],null,["# Row-level security for embedded viewers\n\n| **Objective:** A viewer of an embedded dashboard on a third-party platform will see only the data relevant for them, without the user logging into their Google account.\n\nFor example, let's assume developer X has a web application for their clients.\nClients log in to the app using their own credentials and can view sales data\nfor different stores. Each client has access to a different list of stores. The\ndeveloper would like to embed a Looker Studio dashboard in their application so\nthat when a client logs in, the client sees only the sales data for the stores\nthey have access to. Clients should not have to log into their Google account\nfor this process to work.\n\nThe proposed solution will need the developer to create a Community Connector,\npass a token through the embed URL, and then filter data based on the token.\n\nRequirements\n------------\n\n- Dashboard viewers will log in to the third-party application.\n- The application should pass a unique token to the Looker Studio dashboard through embed URL. The token can either be used to lookup filter information or have the filter information encrypted within.\n- The Community Connector should be able to convert the token into the filter values.\n\nLimitations\n-----------\n\n- If you are a G Suite customer and your administrator has disabled sharing Drive files to \"Anyone with a Link\", you will not be able to share the report with users outside your organization.\n\nSolution\n--------\n\nComplete all the following steps to implement the solution.\n\n### Generate user token in web app\n\nGenerate a unique token for each logged-in user in your web application.You will\nbe passing this token to the embedded dashboard in a later step.\n\nYou should use the token to filter relevant data. Options include:\n\n- Create an API endpoint which return filtered data or the user information for a specific token.\n- Encrypt the user information in the token so that it can be decrypted later in the connector.\n\n### Create a new Community Connector\n\nReview [How Community Connectors Work](https://youtu.be/1u1wOD3RjSA?list=PLIivdWyY5sqLNJttHVnNtjKVgt2PGF4Js&t=15) and complete the\n[Community Connector Codelab](/looker-studio/connector/get-started) to get started. Use the\n[Local development tooling for creating connectors](/looker-studio/connector/local-development) for a faster and easier\ndevelopment process.\n\n### Write the connector code\n\n1. [`getConfig()`](/looker-studio/connector/reference#getconfig) should return at least one config item. This will be used to\n capture a token from embed URL's parameters.\n\n **Caution:** You should not pass user credentials via this method. \n\n function getConfig(request) {\n var cc = DataStudioApp.createCommunityConnector();\n var config = cc.getConfig();\n\n config\n .newTextInput()\n .setId('token')\n .setName('Enter user token');\n\n // TODO: Add additional config values if applicable for your connector\n\n config.setDateRangeRequired(false);\n config.setIsSteppedConfig(false);\n\n return config.build();\n }\n\n2. [`getData()`](/looker-studio/connector/reference#getData) will have access to the token through the\n `request.configParams` object. Use the token to fetch filtered data or\n filter existing fetched data. \n\n Following the above example, the token would be\n `request.configParams.token`. In `getData()`, the token is passed to a REST\n API end-point to get a list of *Store Ids* . These *Store Ids* are then used\n to construct the SQL query to fetch sales data.\n\n var STORE_ID_API = 'https://www.example.com/api/storeid';\n var QUERY_STRING_PREFIX = \"SELECT StoreName, Sales from stores\"\n\n function getData(request) {\n var token = request.configParams.token;\n\n var storeIds = getStoreIdList(token);\n var queryString = constructQueryString(storeIds);\n var fetchedData = fetchData(queryString);\n\n // rest of getData() implementation\n }\n\n function getStoreIdList(token) {\n var url = STORE_ID_API;\n var response = UrlFetchApp.fetch(url);\n var parsedResponse = JSON.parse(response);\n return parsedResponse.storeIds;\n }\n\n function constructQueryString(storeIds) {\n var storeIdString = storeIds.join(',');\n var queryString = QUERY_STRING_PREFIX\n + ' WHERE storeId in ('\n + storeIdString\n + ')';\n return queryString;\n }\n\n### Create the dashboard\n\n1. Understand how [deployments and versions](/looker-studio/connector/deploy) work for connectors.\n2. [Create a production deployment](/looker-studio/connector/deploy) for the connector.\n3. Use the Production deployment link to create a data source and a report in Looker Studio.\n4. For the `token` config parameter, [Allow report viewers to modify parameter values](/looker-studio/connector/data-source-parameters#allow_report_viewers_to_modify_parameters_values).\n5. [Share the dashboard](/looker-studio/connector/View%20only) with selected users or with \"Anyone with link\".\n6. [Enable embedding](https://support.google.com/looker-studio/answer/7450249) for the report.\n\n### Embed the dashboard in your platform\n\n1. Understand how [Report URL parameters](/looker-studio/connector/data-source-parameters#set_url_parameters) work.\n2. Pass the dynamically generated token value using URL parameters to the embedded Looker Studio report. \n Your embed url will look similar to this: \n\n ```scdoc\n `https://lookerstudio.google.com/embed/reporting/REPORT_ID/page/PAGE_ID?config=%7B%22ds0%22%3A%7B%22token%22%3A%22TOKEN_VALUE%22%7D%7D\n ```\n\nRecommendations\n---------------\n\n- You should create a **short-lived** token.\n- Ensure the dashboard does not leak any information with viewed with an invalid token."]]
