メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Reposrts リソース

The Report resource (and it's subresources) represent account-level reporting on call quality data. You can create reports globally for your account, or focus on specific aspects of call quality. Data is available for calls over the last 30 days. At this time only Client Insights information is accessible via the API.

アクション

Reportリソースについては、下記の操作がサポートされています。

アカウント・レポートの取得

GET /Calls/Report
        
        
        
        
        名前 概要
        account_sid

        Sid of the account for which this report is generated. (not PII)

        call_stats

        Call Stats object contains call level statistics for the account. See Call Stats Properties below. (not PII)

        end_time

        Ending time stamp for viewing the data. (not PII)

        feedback_score_counts

        This object contains counts of the feedback scores reported by your users for client calls made using this account. See Feedback Score Counts properties below. (not PII)

        issue_type_counts

        This object contains counts of the issues reported by your users for client calls made using this account. See Issue Type Counts properties below. (not PII)

        start_time

        Starting time stamp selected to view the data. (not PII)

        warning_counts

        This object contains counts for warnings of each type recorded across all calls. See Warning Counts properties below. (not PII)

        側面ごとにレポートを取得する

        GET /Calls/Report/Aspects/{Aspect}
              
              
              
              
              側面 概要
              Clients Twilioクライアント経由で接続されたクライアントごとのレポート
              IPアドレス IPアドレスごとのレポート
              Browsers ブラウザーの種類ごとのレポート
              OperatingSystems オペレーティング・システムごとのレポート
              リージョン 地域ごとのレポート
              Direction 通話の方向(inbound / outbound)ごとのレポート

              クエリーパラメーター

              名前 概要
              Browser

              Optional. Query by browser type (not PII)

              Client

              Optional. Query by client (not PII)

              Direction

              Optional. Query by call direction (inbound/outbound) (not PII)

              EndDateTime

              Optional. Date to scope query end (not PII)

              IP アドレス

              Optional. Query by IP Address (not PII)

              OperatingSystem

              Optional. Query by operating system of client (not PII)

              region

              Optional. Query by region (not PII)

              StartDateTime

              Optional. Date to scope query start (not PII)

              名前 概要
              account_sid

              Sid of the account for which this report is generated. (not PII)

              call_status

              Call Stats object contains call level statistics for the account. See Call Stats Properties below. (not PII)

              end_date_time

              Ending time stamp for viewing the data. (not PII)

              feedback_score_counts

              This object contains counts of the feedback scores reported by your users for client calls made using this account. See Feedback Score Counts properties below. (not PII)

              issue_type_counts

              This object contains counts of the issues reported by your users for client calls made using this account. See Issue Type Counts properties below. (not PII)

              start_date_time

              Starting time stamp selected to view the data. (not PII)

              warning_counts

              This object contains counts for warnings of each type recorded across all calls. See Warning Counts properties below. (not PII)

              入れ子にされたプロパティー・オブジェクト

              レポートによって返されたデータには、レスポンスとして受信するJSON内に入れ子にされたオブジェクトがいくつか含まれます。 下記はそのようなオブジェクトと、そのプロパティーの一覧です。

              Call Stats プロパティー

              プロパティ 概要
              total_calls このアカウントを使用して作成された通話の総数です。

              Warning Counts プロパティー

              プロパティ 概要
              high_packet_loss 指定された日時の範囲内において、このアカウント上で行われたクライアント通話で発生した高パケットロス警告の総数です。 高パケットロス警告は5秒中3秒を超えて1%を超えるパケットロスが発生した際に記録されます。
              constant_audio_input_level 指定された日時の範囲内において、このアカウント上で行われたクライアント通話で発生した一定オーディオ入力レベル警告の総数です。  一定オーディオ入力レベル警告は、アクティブな通話において記録された入力レベルが10秒を超えて変化しなかった場合に発生します。  これらの警告は発信者がマイクをミュートした際に発生する可能性があります。
              high_jitter 指定された日時の範囲内において、このアカウント上で行われたすべてのクライアント通話で発生した高ジッター警告の総数です。 高ジッター警告は5秒中3秒を超えて、30ミリ秒を超えるジッターが発生した際に記録されます。
              low_mos 平均オピニオン評点 (MOS = Mean Opinion Score) とは、ネットワーク品質の基準のことです。 値の範囲は1から4で、これは指定された日時の範囲内において、このアカウント上で行われたすべてのクライアント通話で発生した低MOS値警告の総数です。 低MOS値警告は5秒中3秒を超えてMOS値が3を下回ると発生します。
              constant_audio_output_level 指定された日時の範囲内において、このアカウント上で行われたクライアント通話で発生した一定オーディオ出力レベル警告の総数です。  一定オーディオ入力レベル警告は、アクティブな通話において記録された出力レベルが10秒を超えて変化しなかった場合に発生します。  これらの警告は発信者がマイクをミュートしたり保留をした際に発生する可能性があります。
              high_rtt ラウンド・トリップ・タイム (RTT = Round Trip Time) とは、オーディオ・パケットの受信における遅延(レイテンシー)の基準のことです。 これは通話を通じて発生した高RTT警告の総数です。 RTT警告は5秒中3秒を超えて、RTT値が200ミリ秒を超えた場合に発生します。

              Issue Type Counts プロパティー

              プロパティ 概要
              dropped_call このアカウントを使用して作成されたクライアント通話において、ユーザーが通話の欠落を報告した回数です。
              audio_latency このアカウントを使用して作成されたクライアント通話において、ユーザーがオーディオの遅延を報告した回数です。
              one_way_audio このアカウントを使用して作成されたクライアント通話において、ユーザーが一方通行のオーディオを報告した回数です。
              noisy_call このアカウントを使用して作成されたクライアント通話において、ユーザーが雑音の多い通話を報告した回数です。
              choppy_audio このアカウントを使用して作成されたクライアント通話において、ユーザーがぶつ切りのオーディオを報告した回数です。

              Feedback Score Counts プロパティー

              各通話のフィードバック・スコアは1から5の5段階評価です。 1が最悪の通話品質を、5は完璧な通話品質を示唆します。

              プロパティ 概要
              1 ユーザーが通話品質スコアを 1 と評価した回数です。
              2 ユーザーが通話品質スコアを 2 と評価した回数です。
              3 ユーザーが通話品質スコアを 3 と評価した回数です。
              4 ユーザーが通話品質スコアを 4 と評価した回数です。
              5 ユーザーが通話品質スコアを 5 と評価した回数です。
              Rate this page:

              ヘルプが必要ですか?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.