報告された呼び出しを呼び出さない (独立した発行元) (プレビュー)
Do Not Call (DNC) Reported Calls Data API エンドポイントは、連邦取引委員会に報告された Do Not Call および robocall の苦情に関するデータを平日ごとに提供します。 このデータは、不要な通話を発信した電話番号、苦情が作成された日付、通話が行われた時刻、報告された消費者の市区町村と州の場所、通話の件名、通話がロボコールであったかどうかなど、消費者が報告した情報で構成されます。 報告された呼び出しは検証されません。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | トロイ・テイラー |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | トロイ・テイラー、日立ソリューションズ |
| Website | https://www.ftc.gov/developer/api/v0/endpoints/do-not-call-dnc-reported-calls-data-api |
| プライバシー ポリシー | https://www.ftc.gov/site-information/privacy-policy |
| カテゴリ | データ;通信 |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | この API の API キー | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| DNC のすべての苦情を一覧表示する |
フィルター パラメーターに基づいて未確認の苦情の一覧を返します。 |
| 単一の DNC 苦情を受け取る |
1 つの未確認の苦情を ID で返します。 |
DNC のすべての苦情を一覧表示する
フィルター パラメーターに基づいて未確認の苦情の一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
作成日
|
created_date | string |
苦情が作成された特定の日付でレコードをフィルター処理します。 たとえば、2020 年 2 月 26 日に作成されたすべての苦情を表示します。2020-02-26 |
|
|
作成日の開始日
|
created_date_from | string |
苦情が作成された日付/時刻の範囲でレコードをフィルター処理します。 これらのフィルターは一緒に使用する必要があります。 State、Area Code、Is Robocall のいずれか 1 つのフィルターと組み合わせることができます。 状態フィルターと組み合わせると、オプションの市区町村フィルターを追加できます。 |
|
|
作成日
|
created_date_to | string |
苦情が作成された日付/時刻の範囲でレコードをフィルター処理します。 これらのフィルターは一緒に使用する必要があります。 State、Area Code、Is Robocall のいずれか 1 つのフィルターと組み合わせることができます。 状態フィルターと組み合わせると、オプションの市区町村フィルターを追加できます。 |
|
|
違反日
|
violation_date | string |
不要な呼び出しが受信された特定の日付でレコードをフィルター処理します。 たとえば、2020 年 2 月 26 日に受信したすべての不要な通話を表示します。2020-02-26 |
|
|
違反の開始日
|
violation_date_from | string |
違反が作成された日付/時刻の範囲でレコードをフィルター処理します。 これらのフィルターは一緒に使用する必要があります。 State、Area Code、Is Robocall のいずれか 1 つのフィルターと組み合わせることができます。 状態フィルターと組み合わせると、オプションの市区町村フィルターを追加できます。 |
|
|
違反の終了日
|
violation_date_to | string |
違反が作成された日付/時刻の範囲でレコードをフィルター処理します。 これらのフィルターは一緒に使用する必要があります。 State、Area Code、Is Robocall のいずれか 1 つのフィルターと組み合わせることができます。 状態フィルターと組み合わせると、オプションの市区町村フィルターを追加できます。 |
|
|
State
|
state | string |
苦情の発生元の状態でレコードをフィルター処理します。 市区町村と作成日/作成日のフィルターと組み合わせることができます。 |
|
|
市区町村
|
city | string |
苦情の発生元の市区町村でレコードをフィルター処理します。 このフィルターは、状態フィルターと共に使用する必要があります。 [作成日] フィルターと [作成日] フィルターを組み合わせることができます。 |
|
|
市外局番
|
area_code | integer |
苦情の発生元のエリア コードでレコードをフィルター処理します。 [作成日] フィルターと [作成日] フィルターを組み合わせることができます。 |
|
|
Is Robocall
|
is_robocall | boolean |
不要な呼び出しが記録されたメッセージ/robocall であったかどうかをフィルター処理します。 値は "true" または "false" である必要があります。 [作成日] フィルターと [作成日] フィルターを組み合わせることができます。 |
|
|
並べ替え順序
|
sort_order | string |
sort_by パラメーターで使用する並べ替えの方向。 |
|
|
ページあたりのアイテム数
|
items_per_page | integer |
応答に含めるレコードの最大数。 既定では、エンドポイントには要求ごとに最大 50 個のレコードが表示されます。 これは、許容される最大値でもあります。 |
|
|
オフセット
|
offset | integer |
多数のレコードによってオフセットされ、ページ分割された結果の特定のセクションを要求できます ([ページごとのアイテム] パラメーターで使用します)。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
データ
|
data | array of object | |
|
タイプ
|
data.type | string |
レコードの種類は "dnc_complaint" です。 |
|
ID
|
data.id | string |
レコードの一意識別子。 |
|
会社の電話番号
|
data.attributes.company-phone-number | string |
不要な通話の発信元の電話番号。 |
|
作成日
|
data.attributes.created-date | string |
苦情が作成された日付/時刻。 タイムスタンプ形式は ISO 8601 です。 例: 1997-07-16T19:20:30+01:00 |
|
違反日
|
data.attributes.violation-date | string |
不要な呼び出しが受信された日付/時刻。 タイムスタンプ形式は ISO 8601 です。 |
|
コンシューマーシティ
|
data.attributes.consumer-city | string |
苦情を作成した消費者によって報告された市。 |
|
コンシューマーの状態
|
data.attributes.consumer-state | string | |
|
コンシューマーエリアコード
|
data.attributes.consumer-area-code | string |
苦情を作成したコンシューマーの面番号。 |
|
サブジェクト
|
data.attributes.subject | string |
不要な呼び出しの件名。 |
|
記録されたメッセージまたは Robocall
|
data.attributes.recorded-message-or-robocall | string |
不要な呼び出しが記録されたメッセージ/robocall ("Y") であったかどうかを示します("N")。 |
|
Link
|
data.links.self | string |
このレコードに関連するリンク。 |
|
このページを記録する
|
meta.records-this-page | integer |
この応答に含まれるレコードの数。 |
|
レコードの合計
|
meta.record-total | integer |
要求で検出されたレコードの合計数。 |
|
Link
|
links.self | string |
このレコードに関連するリンク。 |
単一の DNC 苦情を受け取る
1 つの未確認の苦情を ID で返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
苦情の一意識別子。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
データ
|
data | array of object | |
|
タイプ
|
data.type | string |
レコードの種類は "dnc_complaint" です。 |
|
ID
|
data.id | string |
レコードの一意識別子。 |
|
会社の電話番号
|
data.attributes.company-phone-number | string |
不要な通話の発信元の電話番号。 |
|
作成日
|
data.attributes.created-date | string |
苦情が作成された日付/時刻。 タイムスタンプ形式は ISO 8601 です。 例: 1997-07-16T19:20:30+01:00 |
|
違反日
|
data.attributes.violation-date | string |
不要な呼び出しが受信された日付/時刻。 タイムスタンプ形式は ISO 8601 です。 |
|
コンシューマーシティ
|
data.attributes.consumer-city | string |
苦情を作成した消費者によって報告された市。 |
|
コンシューマーの状態
|
data.attributes.consumer-state | string | |
|
コンシューマーエリアコード
|
data.attributes.consumer-area-code | string |
苦情を作成したコンシューマーの面番号。 |
|
サブジェクト
|
data.attributes.subject | string |
不要な呼び出しの件名。 |
|
記録されたメッセージまたは Robocall
|
data.attributes.recorded-message-or-robocall | string |
不要な呼び出しが記録されたメッセージ/robocall ("Y") であったかどうかを示します("N")。 |
|
Link
|
data.links.self | string |
このレコードに関連するリンク。 |
|
このページを記録する
|
meta.records-this-page | integer |
この応答に含まれるレコードの数。 |
|
レコードの合計
|
meta.record-total | integer |
要求で検出されたレコードの合計数。 |
|
Link
|
links.self | string |
このレコードに関連するリンク。 |