エクスポートを構築する
1
必要なデータを選択する
公開されている API リソースまたは
レポートレシピから始めます。
送信先に必要なフィールドとフィルターを選択し、レポート要件に適した更新間隔を設定します。
2
インテグレーションを認証する
エクスポート用のサービスアカウントを作成し、必要な権限のみを付与します。API クイックスタートに従って、API キーを使用した最初のリクエストを実行してください。セキュリティポリシーで OAuth アクセストークンが必要な場合は、認証を参照してください。
3
すべてのページを読み取る
ページネーションガイドに従って、完全な結果セットを取得します。カーソルをたどる間はフィルターを一貫させ、カーソルの有効期限切れに対処し、読み取り中にレコードが変更される可能性も考慮してください。
4
更新のスケジュールと監視を行う
インテグレーションでリクエストをスケジュールし、
レート制限とリトライに関するガイダンスに従います。
失敗したエクスポートや不完全なエクスポートを調査できるように、更新の成果とリクエスト ID を記録してください。認証情報とエクスポートした個人データはログに含めないでください。
エクスポートしたデータを保護する
組織に対応するリージョン別 API ホストを使用してください。個人データを送信する前に、送信先のアクセス制御と保持ポリシーを確認してください。API 認証情報はシークレットマネージャーに保管し、インテグレーションが変更された場合はローテーションまたは失効させてください。 エクスポートに関するサポートを依頼する際は、操作内容、HTTP ステータス、およびRequest-Idを含めてください。API キー、アクセストークン、エクスポートした個人データは含めないでください。