Skip to main content
Question

Activity Timelineオブジェクトの更新方法

  • June 10, 2026
  • 4 replies
  • 54 views

既存のActivity Timelineオブジェクトのデータ(対象約15000件弱)の「論理削除フラグ」項目を一括更新したいです。

 

現状対象データのGSIDは抽出済みですが、該当データはルールエンジンで更新ができないため困っており。

サポートに相談した時に、このURLを見て対応することを進められたのですが、具体的にどんな風に実装したらいいのか記事から読み取れずこちらでご質問しました。

タイムラインAPI - Gainsight社

 

データが多いこともありどのやり方が良いのか分からず(確かExternal APIは件数上限があるのでデータが多いと一部エラーになってしまう認識)、GSID紐づけで既存データのUpdateを行う方法の手順を教えてほしいです。

4 replies

arashi_CCC
  • Helper ⭐️⭐️⭐️
  • June 10, 2026

  • Author
  • Contributor ⭐️⭐️
  • June 11, 2026

@arashi_CCC 
ありがとうございます!

記事を読んだのですが、完全に理解できたとは言い切れずの状態で。もし分かりそうだったら下記お伺いしてもいいでしょうか?もし記載のある内容についての質問になっていたらすみません。

 

エンジニアがおらずPhython書くのが難しそうなので、そうなると残るはルールエンジン→External Actionsという順番で呼び出す選択肢になりますよね。

 

External ActionsのPayloadの部分がいまいち理解しきれておらず。

記事はアクティビティの登録の書き方は記事を真似すれば行けるのかなとは思いつつだと思うのですが、どのあたりを変更すればこれがUpdateになるのでしょうか?
(もしくは、Update, Insertとかの違いはない...?)

 

また、External Actionsだとこのデータ件数だと量的にエラーになる可能性もあるのかと思い。
回避方法はAPIを少しずつ叩く、などになるでしょうか...?


aiken
  • Helper ⭐️
  • June 13, 2026

@Haruno Oi san,

@arashi_CCC sanが紹介してくれている記事ですと、「大量のアクティビティを新規登録する(INSERT)」にはどうすればいいか?が書かれています。
そのために、サポートが紹介してくれたURLのページ(Timeline APIs)に紹介されている「Bulk Activity Save API」(Endpoint:/v1/ant/es/activity/bulk)を利用しています。
@Haruno Oi さんがされたいことは「大量のアクティビティを更新する(UPDATE)」かと思いますので、同じくサポートからのページに書かれている「Bulk Update API」(Endpoint:v1/ant/es/activity/bulk?identifier=<identifier>)に置き換えたPythonコードとCSVファイルを用意して実行すればよい、となると思います。
 

Pythonでやってることは、①CSV→JSONへの変換(Timeline APIはデータをJSONで受け取るため要変換)と②APIコール(Pythonの90,91行目)の2つですので、手動でJSONフォーマットのデータファイルを作成し、CURLコマンドかPostmanでAPI呼び出ししてあげればPythonを書かなくても叩き込めるはずですが、エンジニアがいない環境だとちょっとしんどいかもですね。。

Gainsightの機能で、CSVアップロード→一括アクティビティ更新、のような機能が搭載されればエンジニア無でも処理できるようになると思います。。。Salesforceにあるデータローダーのようなツールが整備されるとよいですね。。。


arashi_CCC
  • Helper ⭐️⭐️⭐️
  • June 15, 2026

@Haruno Oi 

ありがとうございます!

ご認識の通り、External Actionsだと量的にエラーになる可能性もがあるため、夜間に分割してAPIを叩く、になるかと思います。

以下の記事もご参考になるかと思います。

ルールエンジンのCall External APIアクションでGainsightのTimelineAPIを呼び出してアクティビティを登録する

Single Update API

 

また、Timeline API では、POST は作成、PUT は更新になるようなので、

External Action作成時に、Method(Basic Information)でPUTを選択し、

以下のペイロードを参考にお試しいただけますでしょうか。

Delete__cの部分は該当のフィールド名を入れていただければと思います!

※数が少ないのでご参考にならないかもしれませんが、私のデモ環境だと更新されました・・!

{
"records": [
{
"Gsid": "{{ActivityId}}",
"Delete__c": true
}
]
}