如何使用 Google Apps 脚本从 Google Search Console API 请求特定数据？

Question

我正在尝试通过其 API 从 Google Search Console 中恢复 Google Discover 数据并将其显示在 Google Sheet 中。

我正在学习一个教程，该教程引导我在 Google Cloud 平台中设置所需的身份验证，并向我展示了如何设置一个基本请求，以检索我在 Search Console 中可以访问的网站列表。

我不明白的是如何修改下面的代码，以便 API 检索 Google Discover 数据而不是我有权访问的网站列表。

Google Apps 脚本代码获取提到的网站并填充两列，一列包含网站链接，另一列包含我对该网站的访问级别。

 function listAccountSites() {
  var service = getService();
  if (service.hasAccess()) {
  
    var apiURL = "https://www.googleapis.com/webmasters/v3/sites";
    
    var headers = {
      "Authorization": "Bearer " + getService().getAccessToken()
    };
    
    var options = {
      "headers": headers,
      "method" : "GET",
      "muteHttpExceptions": true
    };
    
    var response = UrlFetchApp.fetch(apiURL, options);
    
    var json = JSON.parse(response.getContentText());
    Logger.log(json)
    
    var URLs = []
    for (var i in json.siteEntry) {
      URLs.push([json.siteEntry[i].siteUrl, json.siteEntry[i].permissionLevel]); 
    }
    s_sites.getRange(2,1,URLs.length,2).setValues(URLs);
    
  } else {
    var authorizationUrl = service.getAuthorizationUrl();
    Logger.log('Open the following URL and re-run the script: %s', authorizationUrl);
    Browser.msgBox('Open the following URL and re-run the script: ' + authorizationUrl)
  }
}

使用this Google 文档页面，我能够构建一个 API 请求来获取我需要的 Google Discover 数据，但正如我所说，我无法弄清楚如何做到这一点。提到的请求获取我需要的数据如下：

{
  "startDate": "2021-11-01",
  "endDate": "2021-11-05",
  "dimensions": [
    "PAGE"
  ],
  "type": "DISCOVER"
}

Answer 1

我相信你的目标如下。

• 您希望使用 Google Apps 脚本实现以下请求。 Ref

    POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
    {
      "startDate": "2015-04-01",
      "endDate": "2015-05-01",
      "dimensions": ["country","device"]
    }
  

• 在您的情况下，您希望使用以下请求正文。

    {
      "startDate": "2021-11-01",
      "endDate": "2021-11-05",
      "dimensions": [
        "PAGE"
      ],
      "type": "DISCOVER"
    }
  

如果我的理解是正确的，下面的示例脚本怎么样？

示例脚本：

此示例脚本假设您的访问令牌可以使用，并且您已经能够使用 API。请注意这一点。

var siteUrl = "https://www.example.com/"; // Please set the site URL.

var apiURL = `https://www.googleapis.com/webmasters/v3/sites/${encodeURIComponent(siteUrl)}/searchAnalytics/query`;
var headers = { "Authorization": "Bearer " + getService().getAccessToken() };
var payload = {
  "startDate": "2021-11-01",
  "endDate": "2021-11-05",
  "dimensions": ["PAGE"],
  "type": "DISCOVER"
};
var options = {
  "headers": headers,
  "method": "POST",
  "muteHttpExceptions": true,
  "contentType": "application/json",
  "payload": JSON.stringify(payload),
};
var response = UrlFetchApp.fetch(apiURL, options);

参考资料：

• Search Analytics: query
• fetch(url, params)