GSA Site Scanning (独立系発行者) (プレビュー)
米国連邦 Web サイトの健全性とコンプライアンスに関する包括的な洞察を探索し、連邦 Web 存在のダイナミクスと基準を知るためのウィンドウを提供します。 このサービスは、自動スキャンを通じて、Web サイトのポリシーへのコンプライアンスとベスト プラクティスに関する詳細なデータを生成し、政府デジタル資産のアクセシビリティと管理を強化します。
このコネクタは、次の製品および地域で利用可能です:
| サービス | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Richard Wilson |
| [URL] | https://www.richardawilson.com/ |
| メール | richard.a.wilson@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| 発行者 | Richard Wilson |
| Web サイト | https://open.gsa.gov/api/site-scanning-api |
| プライバシー ポリシー | https://www.gsa.gov/technology/government-it-initiatives/digital-strategy/terms-of-service-for-developer-resources |
| カテゴリー | IT オペレーション |
接続を作成する
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| GSA API キー | securestring | https://open.gsa.gov/api/site-scanning-api/ から取得できる GSA API キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| URL による Web サイト情報の取得 |
指定された URL に基づいて Web サイトに関する詳細情報を取得します。 |
| Web サイト情報の取得 |
ターゲット URL と最終 URL、所有権、スキャン ステータス、分析検出など、Web サイトに関する詳細を取得します。 |
| ウェブサイト分析を実行する |
ターゲット URL、最終 URL、スキャン状況などのさまざまなパラメータに基づいて Web サイトを包括的に分析します。 |
URL による Web サイト情報の取得
指定された URL に基づいて Web サイトに関する詳細情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Web サイトの URL
|
url | True | string |
情報を取得する Web サイトの URL。 これには、ドメイン名と関連するパス コンポーネントが含まれている必要があります。 |
戻り値
- Body
- WebsiteApiResultDto
Web サイト情報の取得
ターゲット URL と最終 URL、所有権、スキャン ステータス、分析検出など、Web サイトに関する詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ターゲット URL ドメイン
|
target_url_domain | string |
ドメイン名にターゲット URL ドメインのトップレベル ドメイン (TLD) を加えたもの。 ターゲット URL はスキャナーの開始場所であり、最終URLとは対照的に、スキャナーはリダイレクト後に終了します。 |
|
|
最終 URL ドメイン
|
final_url_domain | string |
ドメイン名に最終 URL ドメインのトップレベル ドメイン (TLD) を加えたもの。 最終 URL は、ターゲット URL とは対照的に、スキャナがリダイレクトをたどった後に最終的に到達する場所です。 |
|
|
最終 URL ライブ
|
final_url_live | boolean |
2xx ファミリの HTTP ステータス コードを返すことで、最終 URL がライブであるかどうかを示します。 |
|
|
ターゲット URL リダイレクト
|
target_url_redirects | boolean |
ターゲット URL がリダイレクトしたかどうかを記録します (3xx HTTP ステータス コードが返された場合は true)。 スキャナではキャッシュが無効になっているため、304 状態コードは存在しません。 |
|
|
ターゲット URL 代理店オーナー
|
target_url_agency_owner | string |
ターゲット URL に関連付けられた Web サイトを所有または運営する代理店。 |
|
|
ターゲット URL 局の所有者
|
target_url_bureau_owner | string |
ターゲット URL に関連付けられた Web サイトを所有または運営するビューロ。 |
|
|
スキャンの状態
|
primary_scan_status | string |
スキャンのステータスと失敗の既知の理由をキャプチャします。 unknown_error は、エンコードされていないエラー用に予約されています。 |
|
|
最終 URL で DAP が検出されました
|
dap_detected_final_url | boolean |
デジタル分析プログラム (DAP) が最終URLで検出されたかどうかを示します。 |
|
|
Limit
|
limit | integer |
単一の結果ページで返す項目の数を指定します。 |
|
|
ぺージ
|
page | integer |
取得する結果のページ数を指定します。 |
戻り値
ウェブサイト分析を実行する
ターゲット URL、最終 URL、スキャン状況などのさまざまなパラメータに基づいて Web サイトを包括的に分析します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ターゲット URL ドメイン
|
target_url_domain | string |
ドメイン名にターゲット URL ドメインのトップレベル ドメイン (TLD) を加えたもの。 このパラメータは、リダイレクト後にスキャンが終了する最終 URL ドメインとは対照的に、スキャナの開始点を指定します。 |
|
|
最終 URL ドメイン
|
final_url_domain | string |
ドメイン名に最終 URL ドメインのトップレベル ドメイン (TLD) を加えたもの。 最終 URL ドメインは、ターゲット URL ドメインとは対照的に、スキャナがリダイレクトをたどった後に最終的に到達する場所です。 |
|
|
最終 URL ライブ
|
final_url_live | boolean |
2xx ファミリの HTTP ステータス コードを返すことで、最終 URL がライブであるかどうかを示します。 |
|
|
ターゲット URL リダイレクト
|
target_url_redirects | boolean |
ターゲット URL がリダイレクトするかどうかを示すブール値。これは 3xx HTTP ステータス コードが返されたときに発生します。 スキャナではキャッシュが無効になっているため、304 HTTP ステータス コードは存在しないことに注意してください。 |
|
|
ターゲット URL 代理店オーナー
|
target_url_agency_owner | string |
ターゲット URL に関連付けられた Web サイトを所有または運営する代理店を指定します。 |
|
|
ターゲット URL 局の所有者
|
target_url_bureau_owner | string |
ターゲット URL に関連付けられた Web サイトを所有または運営するビューロを指定します。 |
|
|
スキャンの状態
|
primary_scan_status | string |
Web サイトのスキャンのステータスと失敗の既知の理由をキャプチャします。 値 unknown_error は、システムでまだエンコードされていないエラーのために予約されています。 |
|
|
最終 URL で DAP が検出されました
|
dap_detected_final_url | boolean |
デジタル分析プログラム (DAP) が最終URLで検出されるかどうかを示すブール値。 |
戻り値
- Body
- AnalysisDto
定義
AnalysisDto
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
分析項目の合計
|
total | number |
分析された項目の合計数。 |
|
分析された代理店の総数
|
totalAgencies | number |
Web サイトが分析された代理店の総数。 |
|
最終ページ URL ベース ドメインの合計数
|
totalFinalUrlBaseDomains | number |
分析された一意の最終 URL ベース ドメインの総数。 |
PaginatedWebsiteResponseDto
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Web サイト項目
|
items | array of WebsiteApiResultDto |
Web サイトの結果の配列。 |
|
最初のページのリンク
|
links.first | string |
結果の最初のページへのリンク。 |
|
最後のページのリンク
|
links.last | string |
結果の最後のページへのリンク。 |
|
次ページ リンク
|
links.next | string |
結果の次のページへのリンク。 結果の最後のページでは、これは空の文字列になります。 |
|
前のページのリンク
|
links.previous | string |
結果の前のページへのリンク。 結果の最初のページでは、これは空の文字列になります。 |
|
現在のページ
|
meta.currentPage | number |
現在のページの番号。 |
|
項目数
|
meta.itemCount | number |
PaginationResponseDto.items 配列内の項目の数です。 |
|
ページあたりのアイテム
|
meta.itemsPerPage | number |
ページあたりのアイテム数。 これは、limit クエリ パラメータと同じである必要があります。 |
|
項目合計
|
meta.totalItems | number |
クエリと一致する品目の合計数。 |
|
Total Pages
|
meta.totalPages | number |
ページの合計数。floor(totalItems / itemsPerPageとして計算されます)。 |
WebsiteApiResultDto
| 名前 | パス | 型 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
正規リンク
|
canonical_link | string |
正規リンクタグの存在を示します。 |
||||||||
|
Cloud.gov ページのホスティング
|
cloud_dot_gov_pages | boolean |
最終 URL が Cloud.gov ページを使用してホストされていることを示します。 |
||||||||
|
コンテンツ管理システム (CMS)
|
cms | string |
最終 URL をホストするために使用されるコンテンツ管理システムを示します。 |
||||||||
|
最終 URL で DAP が検出されました
|
dap_detected_final_url | boolean |
最終 URL 上のデジタル分析プログラムの存在を表すブール値。 |
||||||||
|
最終 URL の DAP パラメータ
|
dap_parameters_final_url | object |
最終 URL にある Digital Analytics プログラムのパラメーター キーと値を持つオブジェクト。 |
||||||||
|
DNS ホスト名
|
dns_hostname | string |
基盤となるシステムのドメイン。多くの場合、クラウドまたは CDN プロバイダーの使用を示唆します。 |
||||||||
|
最終 URL
|
final_url | string |
ターゲット URL からのリダイレクト後の URL。 |
||||||||
|
最終 URL の MIME タイプ
|
final_url_MIMEType | string |
Content-Type ヘッダーから抽出された最終 URL の MIME タイプ。 |
||||||||
|
最終 URL ドメイン
|
final_url_domain | string |
ドメイン名 + 最終 URL のトップレベルドメイン。 |
||||||||
|
最終 URL ライブ
|
final_url_live | boolean |
最終 URL が 2xx ファミリ HTTP ステータス コードを返したかどうかを表すブール値。 |
||||||||
|
最終 URL 同一ドメイン
|
final_url_same_domain | boolean |
最終 URL がターゲット URL と同じドメイン内にあるかどうかを表すブール型フィールド。 false の場合、リダイレクトを意味します。 |
||||||||
|
最終 URL 同一 Web サイト
|
final_url_same_website | boolean |
最終 URL がターゲット URL とは異なるパスまたはドメインを持つかどうかを示します。 |
||||||||
|
最終 URL 状態コード
|
final_url_status_code | number |
最終 URL の HTTP 状態コード。 |
||||||||
|
最終 URL Web サイト
|
final_url_website | string |
最終 URL のサブドメインとトップレベル ドメインが含まれます。 |
||||||||
|
最終 URL における主要要素の存在
|
main_element_present_final_url | boolean |
以下を示します 要素は最終 URL に存在するかどうか。 |
||||||||
|
最終 URL でグラフ記事の更新日を開く
|
og_article_modified_final_url | string |
最終 URL で利用可能な場合、Open Graph 記事のタグが変更されました。 |
||||||||
|
最終 URL でグラフ記事の公開日を開く
|
og_article_published_final_url | string |
最終 URL で利用可能な場合、Open Graph 記事公開タグが変更されました。 |
||||||||
|
最終 URL でグラフを開くの説明
|
og_description_final_url | string |
最終 URL で見つかった場合は、グラフを開くの説明タグ。 |
||||||||
|
最終 URL でグラフ タイトルを開く
|
og_title_final_url | string |
最終 URL で見つかった場合は、Open Graph タイトル タグ。 |
||||||||
|
Robots.txt Crawl 遅延期間
|
robots_txt_crawl_delay | integer |
robots.txt ファイルに存在する場合、クロール遅延値 (秒単位)。 |
||||||||
|
検出された Robots.txt
|
robots_txt_detected | boolean |
robots.txt ファイルが検出されたかどうかを示します。 |
||||||||
|
Robots.txt の最終 URL
|
robots_txt_final_url | string |
リダイレクト後の robots.txt ファイルの最終 URL。 |
||||||||
|
Robots.txt 最終 URL MIME タイプ
|
robots_txt_final_url_MIMETYPE | string |
Content-Type ヘッダーから抽出された robots.txt ページの MIME タイプ。 |
||||||||
|
Robots.txt の最終 URL ライブ
|
robots_txt_final_url_live | boolean |
robots.txt 最終 URL HTTP ステータスが 2xx ファミリのにあるかどうかを示します。 |
||||||||
|
Robots.txt の最終 URL サイズ (バイト単位)
|
robots_txt_final_url_size_in_bytes | number |
robots.txt ファイルのファイル サイズ (バイト数)。 |
||||||||
|
Robots.txt 最終 URL 状態コード
|
robots_txt_final_url_status_code | number |
robots.txt 最終 URL の HTTP 状態コード。 |
||||||||
|
Robots.txt ターゲット URL リダイレクト
|
robots_txt_target_url_redirects | boolean |
ターゲット robots.txt URL がリダイレクトされたかどうかを示します。 これは特に robots.txt ファイルを対象としています。 |
||||||||
|
スキャン日付
|
scan_date | string |
スキャンが実行された日時。 |
||||||||
|
スキャンの状態
|
primary_scan_status | string |
コア スキャンの成功ステータス。 |
||||||||
|
Sitemap.xml URL カウント
|
sitemap_xml_count | integer |
sitemap.xml ファイル内で見つかった 要素の数を示します。 |
||||||||
|
検出された Sitemap.xml
|
sitemap_xml_detected | boolean |
sitemap.xml ファイルが見つかったかどうかを示します。 |
||||||||
|
Sitemap.xml 最終 URL
|
sitemap_xml_final_url | string |
リダイレクト後の sitemap.xml ページの最終 URL。 |
||||||||
|
Sitemap.xml 最終 URL MIME タイプ
|
sitemap_xml_final_url_MIMETYPE | string |
Content-Type ヘッダーから抽出された sitemap.xml 最終 URL の MIME タイプ。 |
||||||||
|
Sitemap.xml 最終 URL ファイルサイズ
|
sitemap_xml_final_url_filesize | integer |
sitemap.xml ページのファイルサイズ (バイト単位)。 |
||||||||
|
Sitemap.xml 最終 URL ライブ
|
sitemap_xml_final_url_live | boolean |
sitemap.xml 最終 URL 状態コードが 2xx ファミリにあるかどうかを示します。 |
||||||||
|
Sitemap.xml 最終 URL 状態コード
|
sitemap_xml_final_url_status_code | number |
sitemap.xml ページの HTTP 状態コード。 |
||||||||
|
Sitemap.xml PDF URL カウント
|
sitemap_xml_pdf_count | integer |
sitemap.xml 内に PDF 拡張子を持つ URL の数。 |
||||||||
|
Sitemap.xml ターゲット URL リダイレクト
|
sitemap_xml_target_url_redirects | boolean |
sitemap.xml ページがリダイレクトするかどうかを示します。 これは特に sitemap.xml ファイルを対象としています。 |
||||||||
|
DAP リストのソース
|
source_list_dap | boolean |
デジタル分析プログラムがこの URL をターゲット URL リストに提供したかどうかを示します。 |
||||||||
|
連邦ドメインリストのソース
|
source_list_federal_domains | boolean |
連邦ドメインのリストがこの URL をターゲット URL リストに提供したかどうかを示します。 |
||||||||
|
他のリストのソース
|
source_list_other | boolean |
手動で管理されている追加 Web サイトのリストが、この URL をターゲット URL リストに提供したかどうかを示します。 |
||||||||
|
パルス CIO リストのソース
|
source_list_pulse | boolean |
pulse.cio.gov スナップショットがこの URL をターゲット URL リストに提供したかどうかを示します。 |
||||||||
|
ターゲット URL
|
target_url | string |
スキャナーがスキャンを開始する URL。 |
||||||||
|
ターゲット URL 404 テスト
|
target_url_404_test | boolean |
UUID ベースのパス名を呼び出して、ターゲット URL が 404 を適切に処理するかどうかをテストします。 |
||||||||
|
ターゲット URL 代理店オーナー
|
target_url_agency_owner | string |
ターゲット URL を所有する代理店。 |
||||||||
|
ターゲット URL 政府機関の支店
|
target_url_branch | string |
URL が関連付けられている政府機関の支店。 |
||||||||
|
ターゲット URL 局の所有者
|
target_url_bureau_owner | string |
ターゲット URL を所有するビューロ。 |
||||||||
|
ターゲット URL ドメイン
|
target_url_domain | string |
ターゲット URL のベースのドメイン (ドメイン名 + トップレベル ドメイン)。 |
||||||||
|
ターゲット URL リダイレクト
|
target_url_redirects | boolean |
ターゲット URL がリダイレクトされたかどうかを示します。 |
||||||||
|
サード パーティ サービス数
|
third_party_service_count | number |
見つかったサードパーティ サービスの数。 |
||||||||
|
サード パーティ サービス ドメイン
|
third_party_service_domains | array of string |
最終 URL から発信呼び出しを行うサードパーティ サービスのリスト。 サードパーティは、URL のホスト名と一致しないものとして定義されます。 |
||||||||
|
USWDS 数
|
uswds_count | number |
すべての USWDS 尤度ヒューリスティックの合計。 |
||||||||
|
USWDS ファビコン
|
uswds_favicon | number |
HTML ソース内の USWDS US フラグ ファビコンの存在。 存在すると、USWDS 尤度ヒューリスティックに 20 ポイントが追加されます。 |
||||||||
|
CSS の USWDS ファビコン
|
uswds_favicon_in_css | number |
CSS ソース内の USWDS US フラグ ファビコンの存在。 存在すると、USWDS 尤度ヒューリスティックに 20 ポイントが追加されます。 |
||||||||
|
USWDS インライン CSS
|
uswds_inline_css | number |
インライン HTML ソース内の .usa- CSS classes の出現数。 |
||||||||
|
USWDS 公開スキャン フォント
|
uswds_publicsans_font | number |
CSS ソース内の公開スキャン フォントの存在。 存在すると、USWDS 尤度ヒューリスティックに 20 ポイントが追加されます。 |
||||||||
|
USWDS セマンティック バージョン
|
uswds_semantic_version | string |
USWDS のセマンティック バージョン文字列。 |
||||||||
|
USWDS ソース スキャン フォント
|
uswds_source_sans_font | number |
CSS ソース内のソース スキャン フォントの存在。 存在すると、USWDS 尤度ヒューリスティックに 5 ポイントが追加されます。 |
||||||||
|
USWDS 文字列の出現
|
uswds_string | number |
文字列 uswds が HTML ソース内で出現する回数。 |
||||||||
|
CSS の USWDS 文字列
|
uswds_string_in_css | number |
CSS ソース内の uswds の出現数。 |
||||||||
|
USWDS テーブル
|
uswds_tables | number |
(HTML 要素の 数) * -10 の計算。
|