On this page
APIでチケットを取得する際の制限(バージョン5.51以降)
LiveAgentアカウントのバージョンが不明な場合は、このガイドを参照してバージョン番号を確認してください。
APIリクエストのパフォーマンスと安定性を確保するため、バージョン5.51.x.x以降、API v1およびv3経由で取得できるチケットの最大件数に制限が導入されました。v1の/conversations APIは最大1,000件、v3の/tickets APIは最大10,000件のレコードを取得できます。
必要な対応
APIを使用してチケットの一覧を取得している場合、特定のフィルターを指定せずに数万件のチケットを取得することはできなくなりました。各フィルターで返されるチケット数は、システム内でフィルター条件に一致するチケットの総数に関わらず、v1 APIでは最大1,000件、v3 APIでは最大10,000件となります。APIコールが返すチケット数を絞り込むために、より具体的なフィルターを使用する必要があります。たとえば、システムからすべてのチケットをダウンロードする場合、2000年1月1日から現在までのすべてのチケットを一度に取得するフィルターを使用するのではなく、週単位または月単位でフィルタリングする必要があります。
APIコールを繰り返し実行する際に使用できるパラメーターの詳細については、v1ドキュメント、v3ドキュメント、およびv3フィルタリングガイドを参照してください。
APIについてサポートチームに相談したい場合は、APIの説明と使用例を記載のうえ、お問い合わせフォームよりお問い合わせください。