Skip to main content
Solved

カスタム項目の一括更新

  • July 1, 2026
  • 5 replies
  • 42 views

リレーションシップオブジェクトに新規項目を作成し、その項目に対して一括でデータを流し込みたいのですが、どのようにすればよいでしょうか?

特にルールなどはなく、R360ごとに個別に決まった値を入れたいです。csvインポートをイメージしてます。

Best answer by aiken

@森陽花 san,
こちらがこの辺りの情報がまとまっているところかと!
こっちのが参考になるかもですね。

ここに記載のように、いくつかの方法がありまして、S3が使えるならS3経由が良いかと思います!
S3がだめなら、Bulk Import API経由が次の選択肢になるかと(うちはこちらが第1選択肢になっていますが・・・)

5 replies

aiken
  • Helper ⭐️⭐️⭐️
  • July 1, 2026

@森陽花  san,
えーっと、コネクタ2.0のGS Bulk APIでジョブを作るってことですよね。
基本的には、以下かな、と。

⓪Gainsight接続が無ければ新規作成しておく
 ・コネクタ作成時、接続としてGS BULK APIを指定
 ・認証をアクセスキーでやる場合はキーを登録しておく

① 必要項目を並べたCSVファイルを用意する
  ・リレーションシップのGSIDがあればCSVに用意(これをキー項目に指定)
   →無ければ、カンパニーの識別子(GSIDか別のID)とリレーションシップタイプのGSIDを複数キーにしてもいける気がします
  ・新規項目(複数個まとめても可)もCSVに並べておく
  ・1行目は、各項目の名称(カスタムフィールドのAPI名と一致させる必要なし、一意であればなんでもよい)
  ・CSVファイルのエンコードはUTF-8(BOM付きはエラーになるので注意)で保存すること

②コネクタ2.0のジョブを新規作成する
  ・1. Job Detail : Connector→GS Bulk API
  ・2. Target Object : リレーションシップ
    Source File : ①のCSVを選択(→CSVファイルをアップして、1行目の名称を読み取りフィールドマッピングに使用する)
  ・3. Data Load Operation : Upsert or Updateを指定(該当するキーが必ず存在するはずで、あればUpsertはUpdate動作となるのでどちらでも可)

③フィールドマッピング設定
  ・マッピング表中のSource FieldにCSVの1行目のフィールドラベル群が入るので、SourceDataTypeを必要に応じて変更する(このTypeに合わせてTarget Fieldの選択肢が指定される)
  ・Target Fieldにアップロード先のフィールドを選択設定する(マッピング作業)

④ジョブを保存する

ジョブID(ジョブ画面を開き直してアドレスバーから取得)、⓪のアクセスキー、を準備して、PostManかCURLコマンドを作成してリクエスト送信実施。送りこみが成功すればRET200が返って来て、コネクタページのアクティビティタブに取り込みジョブが出てくる。ステータスが成功 or 一部成功 or 失敗になるまで待ち、もし失敗したら、CSVファイルを見直すか、JOB設定を見直して修正しリトライ。

こんな感じでやっています。
もしくはS3経由が利用できるなら、S3(ゲインサイト管理型S3)コネクタを使って取り込み実施もありかもしれないですね。


  • Author
  • July 3, 2026

ご回答ありがとうございます!

私がAPIについて詳しくないのでいただいたご回答は社内で確認させていただきます。

APIの話が出てきたということは、CSVインポートでデータ一括更新する機能はないということですかね…?


aiken
  • Helper ⭐️⭐️⭐️
  • Answer
  • July 3, 2026

@森陽花 san,
こちらがこの辺りの情報がまとまっているところかと!
こっちのが参考になるかもですね。

ここに記載のように、いくつかの方法がありまして、S3が使えるならS3経由が良いかと思います!
S3がだめなら、Bulk Import API経由が次の選択肢になるかと(うちはこちらが第1選択肢になっていますが・・・)


  • Author
  • July 3, 2026

ありがとうございます!!まずS3でやってみます(`・ω・´)ゞ


aiken
  • Helper ⭐️⭐️⭐️
  • July 3, 2026

@森陽花 san,
はい!
ぜひ試していただいて、何か気づいたこととか、こうすればうまく行った!とかあれば共有してください~