本文档介绍了如何查看和了解 Google 员工在 Google Workspace 资源中访问客户数据时生成的 Access Transparency 日志。Google Workspace 中的客户数据包括您在 Gmail、Google 文档、Google 表格、Google 幻灯片和其他 Google Workspace 应用中输入的文本。
准备工作
确保您拥有 Logs Viewer (roles/logging.viewer) Identity and Access Management (IAM) 角色。如需了解如何授予 IAM 角色,请参阅授予单个角色。
如需将 Access Transparency 与 Google Workspace 搭配使用,您必须启用与 Google Cloud共享 Google Workspace 内容的功能。如需了解如何与 Google Cloud共享 Google Workspace 内容,请参阅与Google Cloud共享数据。
查看 Google Workspace 的 Access Transparency 日志
您可以使用 Google Cloud 控制台中的日志浏览器检索、查看和分析 Access Transparency 日志。如需了解如何使用日志浏览器,请参阅使用日志浏览器。
如需使用日志浏览器查看 Google Workspace 的 Access Transparency 日志,请执行以下操作:
以下示例是 Google Workspace 的 Access Transparency 日志示例。
{"insertId":"-6x8cuqc3rk","jsonPayload":{"activityId":{"uniqQualifier":"1720950322606095479","timeUsec":"1621441673703908"},"@type":"type.googleapis.com/ccc_hosted_reporting.ActivityProto","event":[{"status":{"success":true},"eventType":"GSUITE_RESOURCE","parameter":[{"multiStrValue":["GMAIL"],"name":"GSUITE_PRODUCT_NAME",},{"name":"RESOURCE_NAME","multiStrValue":["//googleapis.com/gmail/users/owner@example.com"],},{"name":"LOG_ID","value":"Qt8v90c0fAEy_SyaOplDvJc",},{"multiStrValue":["Google Initiated Service - For details, please refer to the documentation."],"name":"JUSTIFICATIONS",},{"name":"ACTOR_HOME_OFFICE","value":"US",},{"value":"owner@example.net","name":"OWNER_EMAIL",}],"eventName":"ACCESS"}]},"resource":{"type":"organization","labels":{"organization_id":"12345"}},"timestamp":"2021-05-19T16:27:53.703908Z","severity":"NOTICE","logName":"organizations/12345/logs/cloudaudit.googleapis.com%2Faccess_transparency","receiveTimestamp":"2021-05-19T16:28:52.867650088Z"}
如需了解在 Google 员工访问 Google Workspace 资源时生成的 Access Transparency 日志的 jsonPayload 字段中可能会显示的事件和参数,请参阅 Access Transparency 活动事件。
如需了解 Google Workspace 的 Access Transparency 日志中的所有其他字段,请参阅 LogEntry。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-04。"],[[["\u003cp\u003eThis document details how to view Access Transparency logs, which are generated when Google personnel access customer content within Google Workspace applications like Gmail, Docs, Sheets, and Slides.\u003c/p\u003e\n"],["\u003cp\u003eTo access these logs, you must possess the Logs Viewer IAM role and enable sharing of Google Workspace content with Google Cloud.\u003c/p\u003e\n"],["\u003cp\u003eThe Logs Explorer in the Google Cloud console allows you to retrieve, view, and analyze these logs by using a specific query string that includes your organization's unique ID.\u003c/p\u003e\n"],["\u003cp\u003eAccess Transparency logs provide information about the events and parameters when Google personnel access resources in Google Workspace.\u003c/p\u003e\n"],["\u003cp\u003eAn example of a generated log is included, which includes details on the activity, such as the GSuite product name, the owner's email and other important information.\u003c/p\u003e\n"]]],[],null,["# Viewing Access Transparency logs for Google Workspace\n=====================================================\n\nThis document explains how you can view and understand the Access Transparency logs\ngenerated when Google personnel access Customer Data in Google Workspace\nresources. Customer Data in Google Workspace includes text that you\nhave entered into Gmail, Google Docs, Google Sheets, Google Slides, and other\nGoogle Workspace apps.\n\nBefore you begin\n----------------\n\n- Make sure that you have the Logs Viewer (`roles/logging.viewer`) Identity and Access Management\n (IAM) role. For information about granting an IAM\n role, see [Grant a single role](/iam/docs/granting-changing-revoking-access#grant-single-role).\n\n- To use Access Transparency with Google Workspace, you must enable sharing of\n Google Workspace content with Google Cloud. For information about sharing\n Google Workspace content with Google Cloud, see [Sharing data with\n Google Cloud](https://support.google.com/a/answer/9320190).\n\nView Access Transparency logs for Google Workspace\n--------------------------------------------------\n\nYou can use the [Logs Explorer](/logging/docs/view/logs-explorer-summary) in the Google Cloud console to\nretrieve, view, and analyze Access Transparency logs. For information about using\nthe Logs Explorer, see [Using the\nLogs Explorer](/logging/docs/view/logs-explorer-interface).\n\nTo view Access Transparency logs for Google Workspace using the Logs Explorer,\ndo the following:\n\n1. Go to the **Logs Explorer** page in the Google Cloud console.\n\n [Go to Logs Explorer](https://console.cloud.google.com/logs/query)\n2. Enter the following query in the Logs Explorer:\n\n logName=\"organizations/\u003cvar translate=\"no\"\u003eORG_ID\u003c/var\u003e/logs/cloudaudit.googleapis.com%2Faccess_transparency\"\n jsonPayload.@type=\"type.googleapis.com/ccc_hosted_reporting.ActivityProto\"\n\n Replace \u003cvar translate=\"no\"\u003eORG_ID\u003c/var\u003e with the unique identifier of your\n Google Cloud organization.\n3. Click **Run query** to execute the query.\n\n\nSample Access Transparency log for Google Workspace\n---------------------------------------------------\n\nThe following sample is an example of the Access Transparency log for\nGoogle Workspace. \n\n {\n \"insertId\": \"-6x8cuqc3rk\",\n \"jsonPayload\": {\n \"activityId\": {\n \"uniqQualifier\": \"1720950322606095479\",\n \"timeUsec\": \"1621441673703908\"\n },\n \"@type\": \"type.googleapis.com/ccc_hosted_reporting.ActivityProto\",\n \"event\": [\n {\n \"status\": {\n \"success\": true\n },\n \"eventType\": \"GSUITE_RESOURCE\",\n \"parameter\": [\n {\n \"multiStrValue\": [\n \"GMAIL\"\n ],\n \"name\": \"GSUITE_PRODUCT_NAME\",\n },\n {\n \"name\": \"RESOURCE_NAME\",\n \"multiStrValue\": [\n \"//googleapis.com/gmail/users/owner@example.com\"\n ],\n },\n {\n \"name\": \"LOG_ID\",\n \"value\": \"Qt8v90c0fAEy_SyaOplDvJc\",\n },\n {\n \"multiStrValue\": [\n \"Google Initiated Service - For details, please refer to the documentation.\"\n ],\n \"name\": \"JUSTIFICATIONS\",\n },\n {\n \"name\": \"ACTOR_HOME_OFFICE\",\n \"value\": \"US\",\n },\n {\n \"value\": \"owner@example.net\",\n \"name\": \"OWNER_EMAIL\",\n }\n ],\n \"eventName\": \"ACCESS\"\n }\n ]\n },\n \"resource\": {\n \"type\": \"organization\",\n \"labels\": {\n \"organization_id\": \"12345\"\n }\n },\n \"timestamp\": \"2021-05-19T16:27:53.703908Z\",\n \"severity\": \"NOTICE\",\n \"logName\": \"organizations/12345/logs/cloudaudit.googleapis.com%2Faccess_transparency\",\n \"receiveTimestamp\": \"2021-05-19T16:28:52.867650088Z\"\n }\n\nFor information about the event and parameters that can appear in the\n`jsonPayload` field of the Access Transparency logs generated when Google personnel\naccess Google Workspace resources, see [Access Transparency Activity Events](https://developers.google.com/admin-sdk/reports/v1/appendix/activity/access-transparency).\n\nFor information about all the other fields in the Access Transparency logs for\nGoogle Workspace, see [LogEntry](/logging/docs/reference/v2/rest/v2/LogEntry).\n\nWhat's next\n-----------\n\n- Learn more about [Access Transparency audit logs](https://support.google.com/a/answer/9230979).\n- Learn more about [Google Workspace audit logs](/logging/docs/audit/gsuite-audit-logging)."]]