Google 服务账号设置
创建 Google 服务账号，启用 Search Console 和 Analytics API，并将 JSON 密钥连接到 1MarketingTool。
当你希望 1MarketingTool 读取 Search Console 和 GA4 数据而无需通过个人 Google 账号登录时，请使用 Google 服务账号。
你可以选择快速的 Cloud Shell 流程，也可以按照手动的 Google Cloud Console 步骤操作。
使用 Cloud Shell 快速设置
Cloud Shell 在浏览器中运行，已登录你的 Google 账号。打开 Cloud Shell，粘贴脚本，按回车，完成后 key.json 会自动下载。然后在 1MarketingTool 中使用"导入 JSON"加载下载的密钥并保存。
set -e
PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
if [ -z "$PROJECT_ID" ]; then
PROJECT_ID="marketing-tool-$RANDOM$RANDOM"
gcloud projects create "$PROJECT_ID" --set-as-default
fi
gcloud services enable iam.googleapis.com searchconsole.googleapis.com analyticsadmin.googleapis.com \
analyticsdata.googleapis.com indexing.googleapis.com --project "$PROJECT_ID"
SA_EMAIL="marketing-tool@$PROJECT_ID.iam.gserviceaccount.com"
gcloud iam service-accounts create marketing-tool --display-name "1MarketingTool" --project "$PROJECT_ID" || true
echo "Waiting for the service account to be ready..."
for i in $(seq 1 30); do
gcloud iam service-accounts describe "$SA_EMAIL" --project "$PROJECT_ID" >/dev/null 2>&1 && break
sleep 2
done
rm -f key.json
gcloud iam service-accounts keys create key.json --iam-account "$SA_EMAIL" --project "$PROJECT_ID"
cloudshell download key.json
echo "Grant read access in Search Console and GA4 to: $SA_EMAIL"1. 创建 Google Cloud 项目
打开 Google Cloud Console，使用顶部栏的项目下拉菜单，然后选择新建项目。如果你已有用于此工作空间的项目，也可以复用。
为项目起一个易于识别的名称，例如 marketing-tool，然后点击创建。
在继续之前，确保顶部栏中已选择新项目。
2. 创建服务账号
进入 API 和服务 -> 凭据，然后选择创建凭据 -> 服务账号。
输入名称，例如 marketing-tool-reader。Google 会根据该名称生成服务账号 ID 和电子邮件地址。点击创建并继续。
你可以跳过授予 Google Cloud 项目角色。Search Console 和 GA4 的访问权限稍后在这些产品中授予。点击完成。
复制服务账号电子邮件。格式类似 [email protected]。你将在授予 Search Console 和 Analytics 访问权限时使用此邮箱。
3. 下载 JSON 密钥
打开服务账号，切换到密钥标签页，然后选择添加密钥 -> 创建新密钥。
选择 JSON，然后点击创建。一个 .json 文件会下载到你的电脑。请妥善保管此文件，因为它是凭据。
4. 启用所需的 API
在 Google Cloud Console 中，打开 API 和服务 -> 库，搜索 Google Search Console API。
选择 Google Search Console API。
为所选项目点击启用。
返回 API 库，搜索 Google Analytics Data API，然后启用它。此 API 是 GA4 报告所必需的。
你也可以选择启用 Google Analytics Admin API。这使应用能够在连接的工作流支持时列出 GA4 媒体资源。
5. 在 Search Console 中授予访问权限
打开 Google Search Console，选择你要连接的媒体资源，然后进入设置 -> 用户和权限 -> 添加用户。
粘贴第 2 步中的服务账号电子邮件。选择完全或受限权限，然后点击添加。
6. 在 Google Analytics 中授予访问权限
打开 Google Analytics，点击管理，然后选择正确的 GA4 媒体资源。
进入媒体资源访问管理，点击 +，添加服务账号电子邮件。使用查看者或分析师权限，然后点击添加。
7. 在 1MarketingTool 中连接
在 1MarketingTool 中，打开 Google 提供商或集成设置，导入你之前下载的 JSON 密钥文件。
保存后，在应用中将 Search Console 或 GA4 媒体资源映射到正确的项目。
注意事项
- 如果 Search Console 或 GA4 数据没有立即显示，请稍等片刻后重试。Google 权限可能需要几分钟才能生效。
- 一个服务账号可以添加到任意数量的 Search Console 和 GA4 媒体资源中，然后在 1MarketingTool 中按项目映射。
- 如果你在 Google Cloud 中轮换或删除了 JSON 密钥，请在应用中导入新密钥。
- 请安全存储 JSON 密钥，不要将其提交到版本控制系统。