リソース メタデータ

SearchAds360FieldService を使用できます。 リソース、リソースのフィールド、リソースのカタログを動的にリクエストできます。 SearchAds360Service で使用可能なセグメンテーション キーと指標 Search メソッドと SearchStream メソッド。カタログには、Google Cloud の Search Ads 360 Reporting API クライアントが検索広告 360 の検証と構築に使用する クエリ言語のステートメント。

HTTP リクエストとレスポンスのサンプル

リクエストは、次の場所にある Search Ads 360 Reporting API サーバーへの HTTP GET で構成されます。 できます。

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

以下は、リクエストとそれに続くレスポンスの例です。 ad_group リソースの SearchAds360FieldService:

リクエスト

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

レスポンス

{
  "resourceName": "searchAds360Fields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device",
    ...
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],

  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks",
    ...
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device",
    ...
  ]
}

このサンプルでは、重要な配列は次のとおりです。

attributeResources

FROM 内のリソースに暗黙的に結合できるリソース 句。

metrics

FROM のリソースで選択できる指標 句を使用します。category が RESOURCE のフィールドにのみ入力されます。

segments

FROM 句のリソースで選択できるセグメントキー。 これらは、クエリで指定された指標をセグメント化します。フィールドにのみ入力される ここで、category は RESOURCE です。

selectableWith

FROM にない場合に、特定のフィールドとともに選択できるフィールド 句を使用します。この属性は、リソースまたはセグメントを識別する場合にのみ使用します。 クエリで選択可能なオブジェクトのうち、 FROM 句でリソースを宣言します。たとえば、ad_group.id を選択した場合、 ad_group の segments.date と、次の属性を含めるには campaign の場合、segments.date が キャンペーンの selectableWith 属性。この属性は 既存の segments.date フィールドを使用します。

メタデータの詳細

SearchAds360FieldService を使用してカタログをリクエストできます。 レベル:

リソース

例: searchAds360Fields/campaign

リソースのフィールド

例: searchAds360Fields/campaign.name

セグメント フィールド

例: searchAds360Fields/segments.ad_network_type

指標

例: searchAds360Fields/metrics.clicks

クエリを使用してフィールドの詳細を取得する

クエリを次の宛先に送信して、フィールドの詳細を取得できます。

https://searchads360.googleapis.com/v0/searchAds360Fields:search

例 1: 正規表現を使用する

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

例 2: 特定のフィールド、指標、セグメントのクエリ

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )