本文介紹筆者在 SAP Marketing Cloud 工作專案中使用 Restful API SDK 過程中積累的一些使用經驗。

成功登入 SAP Marketing Cloud 系統之後，可以在選單"快速啟動"->"Manage Contacts"裡找到Marketing Cloud contact管理應用。單擊：

![](https://img-blog.csdnimg.cn/img_convert/311d9a6522a3b86a76cbb2844ef92db1.png)

這裡就能看到該系統裡所有的contact列表了。
左邊的1218377是系統contact總個數，正下方Create就是新建按鈕，可以透過這個按鈕開啟contact建立頁面。右邊的search bar就是一個Google風格的模糊搜尋入口。

![](https://img-blog.csdnimg.cn/img_convert/730d9d7ebe864ae5bab4589480e66694.png)

這個介面第一次使用的話需要注意一些小技巧。

![](https://img-blog.csdnimg.cn/img_convert/05310735eda8b3403bd0dfd5fe715851.png)

上圖高亮的四個控制元件實際上是四個過濾器，例如當前系統裡並不存在狀態為For Review的contact，數字為0，因此單擊這個過濾器後：

![](https://img-blog.csdnimg.cn/img_convert/1c23ce9fbe91689c249d2390f7cd567b.png)

表格會顯示0條資料。這是使用者期望的行為，因此大家如果看到表格是空的，不要覺得奇怪。

![](https://img-blog.csdnimg.cn/img_convert/7f1e5734d4af74eb0624d65dc938ef35.png)

當單擊某條contact資料的超連結後，

![](https://img-blog.csdnimg.cn/img_convert/e6cb19380dbbdeb662d9546d9fd86ca7.png)

會跳轉到contact明細頁面. 下圖url裡高亮的guid就是這條contact在SAP資料庫裡的主鍵值。

![](https://img-blog.csdnimg.cn/img_convert/9185176d17557d3a4194342114424a12.png)

# 使用nodejs對Marketing Cloud的contact主資料進行修改操作

假設在Marketing Cloud有這樣一個contact主資料：

![](https://img-blog.csdnimg.cn/img_convert/82ae3205633960727ff36993a3be9a96.png)

現在需求是使用程式語言比如nodejs修改這個contact例項的高亮屬性。
程式碼如下：

```javascript
var config = require("./mcConfig");
var request = require('request');

var url = config.tokenURL;

console.log("user: " + config.user + " password: " + config.password); 
var getTokenOptions = {
        url: url,
        method: "GET",
        json:true,     
        headers: {
            'Authorization': 'Basic ' + new Buffer(config.user + ":" + config.password).toString('base64'),
            "content-type": "application/json",
            "x-csrf-token" :"fetch"
        }
};

function getToken() {
  return new Promise(function(resolve,reject){
      var requestC = request.defaults({jar: true});
      console.log("Step1: get csrf token via url: " + url );

requestC(getTokenOptions,function(error,response,body){
       var csrfToken = response.headers['x-csrf-token'];
       if(!csrfToken){
          reject({message:"token fetch error: " + error});
          return;
       }
       console.log("Step1: csrf token got: " + csrfToken);
       resolve(csrfToken);
      }); 
     });
}

function updateContact(token){
    return new Promise(function(resolve, reject){
        var sPostData = "--batch_1f7d-bd35-caed" + "\n" + 
  "Content-Type: multipart/mixed; boundary=changeset_8f9e-9a44-9f9e" + "\n" + 
  "\n" + 
  "--changeset_8f9e-9a44-9f9e" + "\n" + 
  "Content-Type: application/http" + "\n" + 
  "Content-Transfer-Encoding: binary" + "\n" + 
  "\n" + 
  "MERGE Consumers('02000A21209F1EE99CDF1A1FC9AA8065')?sap-client=100 HTTP/1.1" + "\n" + 
  "Cache-Control: max-age=360" + "\n" + 
  "sap-contextid-accept: header" + "\n" + 
  "Accept: application/json" + "\n" + 
  "Accept-Language: en" + "\n" + 
  "DataServiceVersion: 2.0" + "\n" + 
  "MaxDataServiceVersion: 2.0" + "\n" + 
  "x-csrf-token: fQ2Pwfmf0K_LVYoKV9QYUw==" + "\n" + 
  "Content-Type: application/json" + "\n" + 
  //"Content-Length: 215" + "\n" + 
  "\n" + 
  "{\"YY1_CustomerType_ENH\":\"Jerry測試1\"}" + "\n" + 
  "--changeset_8f9e-9a44-9f9e--" + "\n" + 
  "\n" + 
  "--batch_1f7d-bd35-caed--";

getToken().then(updateContact).catch((error) =>{
  console.log("error: " + error.message);
});
```

我在nodejs程式碼裡把需要更改的欄位值賦為"Jerry測試1”：
執行之後這個屬性被成功更新了：

![](https://img-blog.csdnimg.cn/img_convert/d505b63edd7d763c200f3c94132e73dd.png)

![](https://img-blog.csdnimg.cn/img_convert/54c4830a58e47bba6e72bba563a6bdc1.png)
# 使用postman修改SAP Marketing Cloud contact主資料

Marketing Cloud裡的contact主資料，建立成功後也不是所有欄位都能夠被修改。在Personal data區域的欄位是可以被修改的。

![](https://img-blog.csdnimg.cn/img_convert/2327bce1d5dc48b924d86bd78d7c969d.png)

比如我在“客戶屬性”欄位裡維護了一些值：

![](https://img-blog.csdnimg.cn/img_convert/9743e56bb08c9c0403378049fed48a8d.png)

然後點儲存：

![](https://img-blog.csdnimg.cn/img_convert/c557e5328f1224411147ad4a0416a649.png)

其中第二個batch操作是透過一個roundtrip讀取contact模型下多個子節點的資料，和我們這個修改的場景沒有關聯。
使用postman進行修改：

![](https://img-blog.csdnimg.cn/img_convert/1d62a74a27c145a376d383893a34647a.png)

body欄位維護以下內容：

```json
--batch_1f7d-bd35-caed
Content-Type: multipart/mixed; boundary=changeset_8f9e-9a44-9f9e
--changeset_8f9e-9a44-9f9e
Content-Type: application/http
Content-Transfer-Encoding: binary
MERGE Consumers('02000A21209F1EE99CDF1A1FC9AA8065')?sap-client=100 HTTP/1.1
Cache-Control: max-age=360
sap-contextid-accept: header
Accept: application/json
Accept-Language: en
DataServiceVersion: 2.0
MaxDataServiceVersion: 2.0
x-csrf-token: fQ2Pwfmf0K_LVYoKV9QYUw==
Content-Type: application/json
Content-Length: 215
{"__metadata":{"uri":"https://jerry.hybris.com/sap/opu/odata/sap/CUAN_CONTACT_SRV/Consumers('02000A21209F1EE99CDF1A1FC9AA8065')","type":"CUAN_CONTACT_SRV.Consumer"},"YY1_CustomerType_ENH":"Jerry測試2"}
--changeset_8f9e-9a44-9f9e--
--batch_1f7d-bd35-caed--
```
我想修改的欄位的新的值為：Jerry測試2

執行postman後，發現值已經更新了，修改成功

![](https://img-blog.csdnimg.cn/img_convert/e37d0a4b0b9e3065dea28065e94d0e8f.png)

# 使用nodejs建立Marketing Cloud的contact資料

原始碼如下：

```javascript
var config = require("./mcConfig");
var request = require('request');

var url = config.tokenURL;

console.log("user: " + config.user + " password: " + config.password); 
var getTokenOptions = {
        url: url,
        method: "GET",
        json:true,     
        headers: {
            'Authorization': 'Basic ' + new Buffer(config.user + ":" + config.password).toString('base64'),
            "content-type": "application/json",
            "x-csrf-token" :"fetch"
        }
};

function getToken() {
  return new Promise(function(resolve,reject){
      var requestC = request.defaults({jar: true});
      console.log("Step1: get csrf token via url: " + url );

requestC(getTokenOptions,function(error,response,body){
       var csrfToken = response.headers['x-csrf-token'];
       if(!csrfToken){
          reject({message:"token fetch error: " + error});
          return;
       }
       console.log("Step1: csrf token got: " + csrfToken);
       resolve(csrfToken);
      }); 
     });
}

getToken().then(createContact).catch((error) =>{
  console.log("error: " + error.message);
});
```

這裡我把建立的contact的名稱欄位硬編碼成Jerry4：

![](https://img-blog.csdnimg.cn/img_convert/c83676219346f88246e062ab706cd908.png)

使用nodejs執行這個js檔案，輸出成功建立的contact guid：

![](https://img-blog.csdnimg.cn/img_convert/fe99c2980c8c0fd187da113064619790.png)

在Marketing Cloud UI上看到這個建立成功的contact：

![](https://img-blog.csdnimg.cn/img_convert/de712733376dd4ab07b20aa1f9ecf7d6.png)

# 總結

本文介紹了 SAP Marketing Cloud 在第一次登陸系統後的初始化方式，以及使用 Node.js 和 Postman 等常用工具，消費 Marketing Cloud Restful API 的具體例子。

SAP Marketing Cloud Restful API SDK 使用案例分享

相關文章