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」として記録されます。
そのため、運用で更新元をたどれるようにしておく工夫をご紹介します。
- 連携ごとにM2Mクライアントを分けて発行する
M2Mの認証情報は組織あたり最大15個まで作成できます。連携システムごとに分けておくと、管理画面で「どの連携用のクライアントか」「いつ誰が作成したか」を管理しやすくなります。 - 呼び出し側(GAS)のログを残す
実行日時、更新したレコードのキー、使ったクライアント名を、GASの実行ログやスプレッドシートに記録しておくと、Gainsight側の更新日時と突き合わせて更新元を追えます。 - 機能のご要望はアイデアとして投稿する
「API更新と手動更新を区別したい」というご要望は、コミュニティのアイデアにも寄せられています。必要であれば、ぜひ投稿・投票してください。
参考ドキュメント
- Generate REST API Key(M2M OAuthの上限、組織あたりの作成数)
- People API Documentation(People APIの上限)
- API Documentation Overview(APIの全体の上限)