如何执行数据传输 API？答案

【问题标题】：How to execute Data Transfer API?如何执行数据传输 API？
【发布时间】：2020-12-10 02:37:56
【问题描述】：

我有几个帐户需要将所有权转移到另一个帐户。我在谷歌表格中列出了所有电子邮件地址的列表。我正在使用下面的代码来执行它，但我不确定使用什么来执行代码。

function dataTransfer() {
      var ss = SpreadsheetApp.openById("SHEETID")
      var sheet = ss.getSheetByName("SHEETNAME");
      var start = 2;
      var end = sheet.getLastRow();
      
      var range = sheet.getRange(start,1,end,sheet.getLastColumn());
      var values = range.getValues();
      
      for (var i = 0; i < values.length-1; i++) {
        
        /* transfer the data ownership to */
        var A = "aUser@company1.com";
        var B = "bUser@company1.com";
        var C = "cUser@company1.com";
       
        var email = values[i][0];
        var company = values[i][1];
        var status = values[i][3];
        
        if (status === "Complete") {continue;}
        
        if (company == "A") {
            /* transfer of the ownership of user data between users. */
          var transferObject = {
            "kind": "admin#datatransfer#DataTransfer",
            "oldOwnerUserId": email,
            "newOwnerUserId": A,
            "applicationDataTransfers": [
              {
                "applicationId": XXXXXX,
                "applicationTransferParams": [{
                  "key": "PRIVACY_LEVEL",
                  "value": [
                    "PRIVATE",
                    "SHARED"
                  ]
                }],     
              "applicationId": XXXXX,
                "applicationTransferParams": [{
                  "key": "RELEASE_RESOURCES",
                  "value": true
                }],
              }],
          }
          **admin.datatransfer....** /* what do I use here to execute the above code */
          sheet.getRange(start+i,4,1,1).setValue("Complete");      
        }
    }
  }
}

【问题讨论】：

标签： google-apps-script google-admin-sdk google-data-api

【解决方案1】：

答案：

使用UrlFetchApp，您需要向https://admin.googleapis.com/admin/datatransfer/v1/transfers 发出POST 请求。您必须设置 GCP 项目并启用数据传输 API 才能执行此操作。

代码：

首先，作为快速代码修复，applicationDataTransfers/applicationTransferParams/value 必须是 array of strings，因此应该是：

"applicationId": XXXXX,
  "applicationTransferParams": [
    {
      "key": "RELEASE_RESOURCES",
      "value": [
        "TRUE"
      ]
    }
  ],
// ...

除此之外，oldOwnerUserId 和 newOwnerUserId 值必须是从 users.list 端点获取的用户 ID 值。 Google 电子邮件地址无法替代。完整的示例请求如下：

var payload = {
  "kind": "admin#datatransfer#DataTransfer",
  "oldOwnerUserId": "113412843513541354193",
  "newOwnerUserId": "118387348413214353832",
  "applicationDataTransfers": [
    {
      "applicationId": "14186345432",
      "applicationTransferParams": [
        {
          "key": "PRIVACY_LEVEL",
          "value": [
            "PRIVATE",
            "SHARED"
          ]
        }
      ]
    },
    {
      "applicationId": "546343454353",
      "applicationTransferParams": [
        {
          "key": "RELEASE_RESOURCES",
          "value": [
            "TRUE"
          ]
        }
      ]
    }
  ]
}

至于提出HTTP请求：

const url = "https://admin.googleapis.com/admin/datatransfer/v1/transfers"; 
  
var headers ={
  "Authorization": 'Bearer ' + ScriptApp.getOAuthToken(),
};
    
var options = {
  "method": "POST",
  "headers": headers,
  "contentType": "application/json",
  "payload": JSON.stringify(payload)
};

重要提示：由于您将 API 直接使用脚本的令牌作为 OAuth 令牌，因此您需要使用所需的范围更新 Apps 脚本清单。

按照View > Show manifest file 菜单项，将您的范围添加到项目中。完整的清单文件应如下所示：

{
  "timeZone": "Europe/Paris",
  "dependencies": {
  },
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/admin.datatransfer"
  ]
}

script.external_request 是必需的，因此您可以调用 UrlFetchApp，admin.datatransfer 是调用目录插入端点所需的范围。

参考资料：

【讨论】：

如何执行数据传输 API？

答案：

更多信息：

HTTP 请求

请求正文

代码：

参考资料：