Skip to main content
Minori Miyachi
Gainsight Employee ⭐️
Gainsight Employee ⭐️
Nov 14, 2026 3:56 AM UTC

Q.M2M OAuthでPeople APIを使うときのレート制限と、更新元(Modified By)の識別方法

◼️質問

社内のGAS(Google Apps Script)から、M2M OAuth(本用途専用のクライアント)でPeople API(PUT /v1/peoplemgmt/v1.0/people)を呼び出し、Relationship Personを登録・更新する運用を検討しています。次の2点を教えてください。

1. レート制限:M2M OAuth利用時も、People APIの同期呼び出しの上限(100回/分、50,000回/日)は同じですか? また、その上限はAccess Keyや他のM2Mクライアントと共通(組織全体)でカウントされますか?

2. 更新元の識別:M2M OAuthで更新したレコードの「Modified By」が「System Administrator」と記録されました。どのM2Mクライアントによる更新かを、監査ログなどで識別する方法はありますか?

 

◼️回答

1. レート制限について

結論:はい、上限は「組織(テナント)全体」で共通でカウントされます。
Access KeyかM2M OAuthか、どのM2Mクライアントかによって、枠が分かれることはありません。

理由と補足は次のとおりです。

  • 同期呼び出しの標準上限は100回/分で、固定ウィンドウでカウントされます。
  • 日次の上限は、50,000回/日(※essentialプランの場合は100,000回/日)
  • 枠は組織で共有なので、Access Keyや他のM2Mクライアントを使う連携が多いほど、People APIに使える余裕も減ります。上限を超えるとHTTP 429が返ります。
  • 429が返ったときは、すぐ再実行せず、少し待ってからリトライする(待ち時間を徐々に延ばす)作りにしておくと、安定して動きます。更新対象が多い場合は、実行時間を分散させるのもおすすめです。

 


 

2. 更新元(Modified By)の識別について

結論:現状、M2M OAuth経由の更新は「System Administrator」として記録されます。

そのため、運用で更新元をたどれるようにしておく工夫をご紹介します。

  1. 連携ごとにM2Mクライアントを分けて発行する
    M2Mの認証情報は組織あたり最大15個まで作成できます。連携システムごとに分けておくと、管理画面で「どの連携用のクライアントか」「いつ誰が作成したか」を管理しやすくなります。
  2. 呼び出し側(GAS)のログを残す
    実行日時、更新したレコードのキー、使ったクライアント名を、GASの実行ログやスプレッドシートに記録しておくと、Gainsight側の更新日時と突き合わせて更新元を追えます。
  3. 機能のご要望はアイデアとして投稿する
    「API更新と手動更新を区別したい」というご要望は、コミュニティのアイデアにも寄せられています。必要であれば、ぜひ投稿・投票してください。

 


 

参考ドキュメント