概要
このページでは、GoogleAdsService.SearchStream や GoogleAdsService.Search を使用して Google Ads API へのクエリに使用できるリソースの一覧を示します。リソース名は自身のページにリンクされます。各ページには、次のリストが表示されます。
- リソースと同じ SELECT 句で使用できるアーティファクト（リソース、セグメント、または指標）
- フィールドが指標をセグメント化しない属性付きリソース（これらのリソース フィールドの同じ SELECT 句と WHERE 句に含まれている場合）
これらのリストの後に表示されるのは、FROM_ 句でこのリソースが指定されているときに、検索クエリに含めることができるリソース フィールド、セグメント、指標の名前で構成されるテーブルです。それぞれの名前はメタデータを含むテーブルにリンクされています。
categorydata typetype URLfilterableselectablesortablerepeated
- 可
- この行は、GAQL クエリの
WHERE句の条件でフィールドを使用できるかどうかを示します。 - 選択可能
- この行は、GAQL クエリの
SELECT句でフィールドを指定できるかどうかを示します。 - Sortable
- この行は、GAQL クエリの
ORDER BY句でフィールドの並べ替えと使用が可能かどうかを示します。 - 繰り返し
- この行は、フィールドが繰り返し、リストとして処理されるかどうかを示します。
レポートの例
すべてのリソースのリスト
| リソースタイプ | |
|---|---|
| Accessibility_bidding_strategy | お客様が所有する、またはお客様と共有している BiddingStrategies のビューを表します。BiddingStrategy とは異なり、このリソースには、お客様が所有する戦略に加えて、お客様のマネージャーが所有し、お客様と共有している戦略が含まれています。このリソースは指標を提供せず、BiddingStrategy 属性の一部のみを公開します。 |
| account_budget | アカウント単位の予算です。これには、予算自体に関する情報のほか、予算に対して最近承認された変更や、承認待ちのプロポーザルの変更が含まれます。承認待ちのプロポーザルの変更がある場合は、'保留中のプロポーザル'に表示されます。予算の有効な詳細は、接頭辞 #'approved_'、'adjusted_' および接頭辞なしのフィールドにあります。一部の有効な詳細情報は、ユーザーが最初にリクエストした内容とは異なる場合があるため（例: 費用の上限）、「提案済み」、「承認済み」、そして場合によっては「調整済み」の項目によって並べて示されます。{0}{/0}39;このリソースは AccountBudgetProposal を使用して変更されるため、直接変更することはできません。1 つの予算で同時に保留中のプロポーザルは 1 つまでです。pending_suggested によって読み取られます。承認された予算は、クレジット調整額などの調整の対象となります。調整を行うと、「承認済み」と「調整済み」の間に差異が生じるため、これらの調整は同じになります。 |
| account_budget_プロポーザル | アカウント単位の予算の提案。「&prod」（提案）の接頭辞が付いたすべてのフィールドは、必ずしも直接適用されるとは限りません。たとえば、申請する前に費用の上限が調整されることがあります。これは、「提案済み」の項目に、対応する上限（費用上限など）がある場合に当てはまります。なお、プロポーザル タイプ（プロポーザル タイプ）は、必須項目と空欄のままにしておく項目です。 |
| account_link [アカウント リンク] | Google 広告アカウントと別のアカウント間のデータ共有接続を表します。 |
| ad_group [広告グループ] | 広告グループ |
| ad_group_ad | 広告グループの広告です。 |
| ad_group_ad_asset_combination_view | 広告グループの広告アセットの組み合わせの使用状況を確認できます。現在、レスポンシブ検索広告の AdGroupAdAssetCombinationView のみがサポートされています。今後対象となる広告の種類は増えされる予定です。 |
| ad_group_ad_asset_view | AdGroupAd とアセット間のリンクです。現在サポートされているのは、AppAds の AdGroupAdAssetView のみです。 |
| ad_group_ad_label | 広告グループの広告とラベルの関連性。 |
| ad_group_asset | 広告グループとアセット間のリンクです。 |
| ad_group_audience_view | 広告グループのオーディエンス ビューです。ディスプレイ ネットワークおよび YouTube ネットワークの広告のインタレスト カテゴリとリマーケティング リスト、およびオーディエンス レベルで集計された検索広告のリマーケティング リスト（RLSA）の掲載結果データが表示されます。 |
| ad_group_bid_modifier | 広告グループの入札単価調整比を表します。 |
| ad_group_criterion | 広告グループの条件。 |
| ad_group_criterion_Customizer とします。 | Velostrata レベルで、該当するカスタマイザ属性のカスタマイザ値。 |
| ad_group_criterion_label | 広告グループの条件とラベルの関係です。 |
| ad_group_criterion_simulation | 広告グループの条件のシミュレーション。サポートされている広告チャネルタイプ、条件タイプ、シミュレーション タイプ、シミュレーション変更方法の組み合わせは次のとおりです。V5 から始まるホテル Velostrata シミュレーションのオペレーション。1. Display - KEYWORD - CPC_BID - ユニフォーム 2. SEARCH - KEYWORD - CPC_BID - ユニフォーム 3. ショッピング - LISTING_GROUP - CPC_BID - ユニフォーム 4. ホテル - LISTING_GROUP - CPC_BID - ユニフォーム 5. ホテル - LISTING_GROUP - PERCENT_CPC_BID - ユニフォーム |
| ad_group_Customizer | 広告グループのレベルで、該当するカスタマイザ属性のカスタマイザ値を指定します。 |
| ad_group_extension_setting | 広告グループの広告表示オプションの設定です。 |
| ad_group_feed | 広告グループ フィードです。 |
| ad_group_label | 広告グループとラベルとの関係性です。 |
| ad_group_simulation | 広告グループのシミュレーションサポートされている広告チャネルタイプ、シミュレーション タイプ、シミュレーション変更方法の組み合わせは次のとおりです。1. SEARCH - CPC_BID - デフォルト 2. SEARCH - CPC_BID - ユニフォーム 3. 検索 - 目標コンバージョン単価 - 統一 4. 検索 - 目標広告費用対効果 - 統一 5. Display - CPC_BID - デフォルト 6. Display - CPC_BID - ユニフォーム 7. ディスプレイ - 目標コンバージョン単価 - 均一 |
| ad_parameter | 広告のテキスト行（URL を含む）に含まれる数値（価格や在庫レベルなど）を更新するために使用される広告パラメータ。1 つの広告グループの条件に含めることができる AdParameters は 2 つまでです。（1 つは parameter_index = 1、もう 1 つは parameter_index = 2）。広告では、パラメータは「{param#:value}」というプレースホルダで参照されます。例: "{param1:$17}" |
| ad_schedule_view | 広告のスケジュール ビューでは、AdSchedule 条件別にキャンペーンの掲載結果を確認できます。 |
| age_range_view [年齢層の表示] | 年齢層のビュー。 |
| asset | アセットは広告の一部であり、複数の広告で共有できます。画像（ImageAsset）、動画（YouTubeVideoAsset）などを指定できます。アセットは不変で削除できません。アセットの配信を停止するには、そのアセットを使用しているエンティティから削除します。 |
| asset_field_type_view | アセット フィールド タイプのビュー。このビューでは、アセットが広告表示オプションとして使用されている場合に、アセット フィールド タイプごとにカウントされない指標が表示されます。 |
| asset_group | アセット グループ。AssetGroupAsset は、アセットをアセット グループにリンクするために使用されます。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。 |
| asset_group_asset | AssetGroupAsset はアセットとアセット グループの間のリンクです。AssetGroupAsset を追加すると、アセットがアセット グループにリンクされます。 |
| asset_group_listing_group_filter | AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループのフィルタ ツリー ノードを表します。 |
| asset_group_product_group_view | アセット グループの商品グループビュー。 |
| asset_group_signal | AssetGroupSignal は、アセット グループ内のシグナルを表します。シグナルが存在すると、コンバージョンを期待できる P-MAX キャンペーンを把握できます。P-MAX ではこのシグナルに基づいて、検索、ディスプレイ、動画などのさまざまなネットワークにおけるコンバージョンを把握できる、購買意向が強い、あるいはより強い新規ユーザーが見つかります。 |
| asset_set | アセットのコレクションを表すアセットセット。AssetSetAsset を使用してアセットをアセットセットにリンクします。 |
| asset_set_asset | AssetSetAsset は、アセットとアセットセットのリンクです。AssetSetAsset を追加すると、アセットがアセットセットにリンクされます。 |
| 読者 | オーディエンスは、詳細なユーザー属性やアフィニティなど、さまざまなセグメント属性を組み合わせ、ターゲット セグメントのセクションを表すオーディエンスを作成できる効果的なターゲティング オプションです。 |
| batch_job | 非同期で処理されるミューテーションのリスト。ユーザーがミューテーションをアップロードします。ミューテーション自体は読み取りができず、ジョブの結果は BatchJobService.ListBatchJobResults を使用してのみ読み取ることができます。 |
| bidding_data_exclusion | 入札データの除外を表します。「データの除外について」（https://support.google.com/google-ads/answer/10370710）をご覧ください。 |
| bidding_seasonality_adjustment | 入札単価による季節性の調整を表します。「季節性の調整について」（https://support.google.com/google-ads/answer/10369906）をご覧ください。 |
| bidding_strategy | 入札戦略。 |
| bidding_strategy_simulation | 入札戦略のシミュレーション。サポートされているシミュレーション タイプとシミュレーション変更方法の組み合わせは以下のとおりです。1. 目標コンバージョン単価 - ユニフォーム 2. 目標広告費用対効果 - 均一 |
| billing_setup | お支払いアカウントと広告主を関連付けるお支払い情報の設定。お支払い情報の設定は広告主ごとに行う必要があります。 |
| call_view | 電話専用広告や電話番号表示オプションの通話トラッキング データを含む通話ビュー。 |
| campaign | キャンペーン |
| campaign_asset | キャンペーンとアセット間のリンク。 |
| campaign_asset_set | CampaignAssetSet は、キャンペーンとアセット セットの間のリンクです。CampaignAssetSet を追加すると、アセット セットとキャンペーンがリンクされます。 |
| campaign_audience_view | キャンペーンのオーディエンス ビュー。これには、ディスプレイ ネットワークと YouTube ネットワークの広告のインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト（RLSA）が、キャンペーンとオーディエンスの条件ごとに集計された掲載結果データが含まれます。このビューに含まれるのは、キャンペーン単位のオーディエンスのみです。 |
| campaign_bid_modifier | キャンペーン単位で入札単価のみを変更できる条件を表します。 |
| campaign_budget | キャンペーンの予算です。 |
| campaign_conversion_goal | 指定したキャンペーンの入札単価設定では、カテゴリと生成元が一致するすべてのコンバージョン アクションのみが対象となります。 |
| campaign_criterion | キャンペーンの条件。 |
| campaign_criterion_simulation | キャンペーン条件シミュレーション。サポートされている広告チャネルタイプ、条件 ID、シミュレーション タイプ、シミュレーション変更方法の組み合わせは次のとおりです。1. SEARCH - 30000,30001,30002 - BID_MODIFIER - ユニフォーム 2. Display - 30001 - BID_MODIFIER - ユニフォーム |
| campaign_Customizer | キャンペーン レベルのカスタマイザのカスタマイザの値。 |
| campaign_draft | キャンペーンの下書き |
| campaign_experiment | ベース キャンペーン（コントロール）とテスト キャンペーンのパターンを比較する A/B テストです。 |
| campaign_extension_setting | キャンペーンの広告表示オプションの設定です。 |
| campaign_feed | キャンペーン フィード |
| campaign_group [キャンペーン グループ] | キャンペーン グループ |
| campaign_label [キャンペーン ラベル] | キャンペーンとラベルの関係を表します。 |
| campaign_shared_set | CampaignSharedSets は、キャンペーンに関連付けられた共有設定を管理するために使用します。 |
| campaign_simulation | キャンペーンのシミュレーションサポートされている広告チャネルタイプ、シミュレーション タイプ、シミュレーション変更方法の組み合わせは次のとおりです。174 |
| carrier_constant | キャンペーンのターゲット設定で使用できる携帯通信会社の条件。 |
| change_event | 特定のリソースタイプについて、返されるリソースの細かい変更を記述します。過去 30 日間に、UI、API、エディタの新しいバージョン（外部ユーザーと外部ユーザーに表示できる内部ユーザー）によるエディタの変更内容が表示されます。変更には、変更前の古い値と変更直後の新しい値が表示されます。新しい変更が反映されるまでに、ChangeEvent に最大 3 分ほどかかることがあります。 |
| change_status [変更ステータス] | 返されたリソースのステータスを記述します。新しい変更が反映されるまでに、ChangeStatus に最大 3 分の遅延が生じる場合があります。 |
| click_view | クリック数と指標（有効なクリックと無効なクリックの両方を含む）ごとに集計されたクリックビュー。検索キャンペーン以外の場合、metrics.clicks は有効なインタラクションと無効なインタラクションの数です。ClickView を含むクエリでは、結果を 1 日に制限するフィルタを使用し、リクエストから 90 日前までのクエリを実行できます。 |
| combined_audience | 異なるオーディエンスを含む組み合わせオーディエンスのリソースを説明する。 |
| conversion_action | コンバージョン アクション。 |
| conversion_custom_variable | コンバージョン カスタム変数: https://support.google.com/google-ads/answer/9964350 で「コンバージョンのカスタム変数について」をご確認ください。 |
| conversion_goal_campaign_config | キャンペーンのコンバージョン目標の設定。 |
| コンバージョン値のルール | コンバージョン値のルール |
| conversion_value_rule_set | コンバージョン値のルールセット |
| currency_constant | 通貨の定数です。 |
| custom_audience | カスタム オーディエンス。こちらはユーザーのインタレスト カテゴリです。 |
| custom_conversion_goal | 任意のコンバージョン アクションを入札対象にできるカスタム コンバージョン目標。 |
| custom_interest [カスタム関心] | カスタム インタレスト。こちらはユーザーのインタレスト カテゴリです。 |
| お客様 | お客様 |
| customer_asset | お客様とアセットのリンク。 |
| customer_client | 特定の顧客とクライアント顧客の間のリンク。CustomerClients は、マネージャーのお客様にのみ表示されます。直接的および間接的なすべてのクライアントとマネージャー自身が含まれます。 |
| customer_client_link | 顧客のクライアント リンクの関係を表します。 |
| customer_conversion_goal | カテゴリとオリジンが一致するコンバージョン アクションの入札単価設定の管理。 |
| customer_Customizer | お客様レベルでの CustomizerAttribute のカスタマイザ値。 |
| customer_extension_setting | 顧客拡張機能の設定。 |
| customer_feed | 顧客フィード。 |
| customer_label [お客様ラベル] | 顧客とラベルの関係を表します。このユーザーは、添付されているラベルの一部にアクセスできない可能性があります。login-customer-id で権限を増やすと、その他の CustomerLabels が返されることがあります。 |
| customer_manager_link [顧客管理リンク] | お客様と MCC 間のリンク関係を表します。 |
| customer_negative_criterion | 顧客レベルでの除外の除外キーワード。 |
| customer_user_access | 1 人のユーザーに対する 1 人のユーザーの権限を表します。 |
| customer_user_access_invitation | お客様アカウントの新しいお客様に対する招待状を提示する。 |
| カスタマイズ属性 | カスタマイザの属性。CustomerCustomizer、CampaignCustomizer、AdGroupCustomizer、または protobufCustomizer を使用して、カスタマイザ属性を関連付け、顧客、キャンペーン、広告グループ、または広告グループの条件レベルで値を設定します。 |
| detail_placement_view | 広告グループと URL または YouTube 動画別に集計された指標を含むビュー。 |
| detailed_demographic | 詳しいユーザー属性: 長年の生活習慣に基づいてユーザーにリーチする、特定のインタレスト ベースのカテゴリ。 |
| display_keyword_view | ディスプレイ ネットワークのキーワード ビュー。 |
| distance_view | 広告主と住所表示オプションとの距離を集計した距離ビュー。各 DistanceBucket は、その距離内にあるすべてのインプレッションを含み、1 回のインプレッションは、ユーザーの距離を含むすべての DistanceBucket の指標に反映されます。 |
| domain_category | ドメインをクロールすることで自動的に生成されるカテゴリです。キャンペーンで DynamicSearchAdsSetting を使用すると、ドメインのドメイン カテゴリが生成されます。WebpageConditionInfo を使用してカテゴリをターゲットに設定できます。https://support.google.com/google-ads/answer/2471185 をご覧ください。 |
| dynamic_search_ads_search_term_view | 動的検索広告の検索語句ビュー。 |
| expanded_landing_page_view | 展開された最終ページ URL レベルで指標が集計されたランディング ページ。 |
| テスト | Google 広告のテストです。複数のキャンペーンで変更をテストし、掲載結果を比較し、効果的な変更を適用します。 |
| experiment_arm | Google 広告のテストです。複数のキャンペーンで変更をテストし、掲載結果を比較し、効果的な変更を適用します。 |
| extension_feed_item | 広告表示オプションのフィード アイテム。 |
| フィード | フィード。 |
| feed_item | フィード アイテム。 |
| feed_item_set | フィード アイテムのセットを表します。このセットは、特定のフィード アイテム機能の間で使用したり共有したりできます。たとえば、このセットは CustomerFeed、CampaignFeed、AdGroupFeed のマッチング関数で参照できます。 |
| feed_item_set_link | FeedItem と FeedItemSet 間のリンクを表します。 |
| feed_item_target | フィード アイテム ターゲット。 |
| feed_mapping | フィード マッピング。 |
| feed_placeholder_view | フィードのプレースホルダ ビュー。 |
| gender_view | 性別ビュー。 |
| geo_target_constant | 地域ターゲットの定数です。 |
| geographic_view | 地理的ビュー。地域ビューには、国別に集計されたすべての指標（国ごとに 1 行）が含まれます。レポートでは、ユーザーの実際の所在地または関心のある地域が対象となります。他のセグメント フィールドを使用している場合は、国ごとに複数の行が表示されることがあります。 |
| group_placement_view | グループ プレースメント ビュー。 |
| hotel_group_view | ホテルグループのビュー。 |
| hotel_performance_view | ホテルの掲載結果の表示。 |
| hotel_reconcile | ホテルの調整。ホテルの予約に関するコンバージョン情報が含まれ、広告主の記録と照合されます。これらの行は、一括アップロードによる請求の前に更新またはキャンセルできます。 |
| income_range_view | 収入の範囲ビュー。 |
| キーワード プラン | キーワード プランナーのプラン保存したキーワード プランの最大数: 10,000。上限に達した場合、プランを削除できます。 |
| keyword_plan_ad_group | キーワード プランナーの広告グループです。プランあたりのキーワード プラン広告グループの最大数: 200。 |
| keyword_plan_ad_group_keyword | キーワード プランの広告グループ キーワード。プランあたりのキーワード プランのキーワードの最大数: 10,000。 |
| keyword_plan_campaign | キーワード プランのキャンペーンプランあたりのキーワード プラン キャンペーンの最大数: 1 |
| keyword_plan_campaign_keyword | キーワード プランのキャンペーン キーワードです。キャンペーン キーワードでサポートされるのは除外キーワードのみです。 |
| keyword_theme_constant | スマート アシスト キャンペーンのキーワードのテーマの定数です。 |
| keyword_view | キーワード ビュー。 |
| label | ラベル。 |
| landing_page_view | 展開されていない最終ページ URL 単位で集計されたランディング ページ ビュー。 |
| language_constant | 言語。 |
| lead_form_submission_data | リードフォームの送信内容からのデータ。 |
| ライフイベント | ライフイベント: 人生の大きな節目を迎えているユーザーにリーチする特定のインタレスト カテゴリです。 |
| location_view | 地域ビューでは、キャンペーンの掲載結果を地域条件ごとにまとめます。 |
| managed_placement_view（マネージド プレースメント ビュー） | 手動プレースメントの表示。 |
| media_file | メディア ファイル。 |
| mobile_app_category_constant | モバイルアプリ カテゴリの定数。 |
| mobile_device_constant | モバイル デバイスの定数。 |
| offline_user_data_job | 来店者またはユーザーリスト メンバーのオフライン ユーザーデータを含むジョブで、非同期に処理されます。アップロードされたデータは読み取り可能ではなく、ジョブの処理結果は GoogleAdsService.Search/SearchStream によってのみ読み取ることができます。 |
| operating_system_version_constant | operator_type に応じて、モバイル オペレーティング システムのバージョンまたはバージョンの範囲。利用可能なモバイル プラットフォームのリスト: https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms |
| paid_organic_search_term_view | 有料のオーガニック検索の画面では、広告グループ単位の検索語句ごとに集計された、広告およびオーガニック リスティング全体の検索データを確認できます。 |
| parental_status_view | 子供の有無に関する設定です。 |
| product_bidding_category_constant | 商品入札カテゴリです。 |
| product_group_view [商品グループ ID] | 商品グループのビューです。 |
| recommendation | 推奨事項。 |
| リマーケティング アクション | リマーケティング アクション。広告主のウェブサイトで商品 ID とユーザーがアクセスしたページの種類（商品ページ、ショッピング カート ページ、購入ページ、一般的なサイトへのアクセス）を収集する JavaScript コードのスニペット。 |
| search_term_view | 広告グループ単位で検索キーワードごとに集計された指標を含む検索語句ビュー。 |
| shared_criterion | 共有設定に属する条件です。 |
| shared_set | SharedSets は、複数のキャンペーンで条件の除外を共有するために使用します。 |
| shopping_performance_view | ショッピングの掲載結果。ショッピング キャンペーンの統計情報を、複数の商品ディメンション単位で集計します。ブランド、カテゴリ、カスタム属性、商品の状態、商品カテゴリなど、Merchant Center の商品ディメンション値には、対応するイベントが記録されたときの時点での各ディメンションの状態が反映されます。 |
| smart_campaign_search_term_view | スマート アシスト キャンペーンの検索語句です。 |
| smart_campaign_setting | スマート アシスト キャンペーンの設定に関する設定。 |
| third_party_app_analytics_link | データ共有接続。サードパーティのアプリ分析を Google 広告のお客様にインポートできます。 |
| topic_constant | トピックを使用して、プレースメントが属するカテゴリ（例: 「ペット、動物、ペット、犬」）に基づいて Google ディスプレイ ネットワークのプレースメントをターゲティングまたは除外します。 |
| topic_view | トピックビュー。 |
| user_interest | ユーザーの興味や関心: ターゲットに設定された特定のインタレスト カテゴリ。 |
| user_list | ユーザーリスト。このリストは、ターゲットに設定できるユーザーのリストです。 |
| user_location_view | ユーザーの現在地ビュー。ユーザーの位置情報ビューには、国別に集計されたすべての指標（国ごとに 1 行）が表示されます。レポートでは、ユーザーの実際の所在地での地域を、ターゲットに設定した場所や指定しなかった地域ごとに報告します。他のセグメント フィールドを使用している場合は、国ごとに複数の行が表示されることがあります。 |
| 動画 | 動画 |
| webpage_view（ウェブページ表示） | ウェブページ ビュー。 |