オブジェクトの取得

GoogleAdsService は統合オブジェクトです。 Google Ads API の取得とレポート作成 サービスですこのサービスには、次のメソッドがあります。

  • オブジェクトの特定の属性を取得します。
  • 期間に基づいてオブジェクトのパフォーマンス指標を取得します。
  • オブジェクトを属性に基づいて並べ替えます。
  • 条件を使用して、レスポンスで返すオブジェクトを指定します。
  • 返されるオブジェクトの数を制限する。

GoogleAdsService は、 次の 2 つの方法があります。

  • GoogleAdsService.SearchStream 単一のストリーミング レスポンスですべての行を返すため、次のような場合に効率的です。 大規模（10,000 行超）の結果セットに対して、こちらの方が適している場合があります 大量のデータを高速にダウンロードしたい場合に 考えています
  • GoogleAdsService.Search が分割されました 結果の管理しやすいページに分けることができます。ここのほうが インタラクティブ アプリケーションで検索結果ページを表示する場合に適しています。 あります。

詳しくは、ページングとストリーミングをご覧ください。

リクエストを作成する

search メソッドには SearchGoogleAdsRequest: 次の属性の

  • A: customer_id
  • クエリ対象のリソースや属性を示す Google 広告クエリ言語の query セグメント、取得する指標、制限する条件 どのオブジェクトに対して
  • （GoogleAdsService.Search のみ）A page_size: 次の場合に 1 つのレスポンスで返すオブジェクトの数を示します。 ページングを使用する。
  • （GoogleAdsService.Search のみ） オプションの page_token を使用すると、 ページング。

Google 広告クエリ言語について詳しくは、Google 広告クエリ言語（英語）をご確認ください。 ガイドをご覧ください。

レスポンスを処理する

GoogleAdsService は、指定したサービス アカウントが GoogleAdsRow オブジェクト。

各 GoogleAdsRow はクエリによって返されるオブジェクトを表し、 リクエストされたフィールドに基づいて設定される属性のセットです。 SELECT 句。SELECT 句に含まれていない属性は、 レスポンスの GoogleAdsRow オブジェクトに入力されます。

たとえば、ad_group_criterion には status 属性がありますが、 行の ad_group_criterion 属性の status フィールドが SELECT 句に ad_group_criterion.status。同様に、行の campaign 属性は次のようになります。 SELECT 句に campaign リソース。

各 GoogleAdsRow には、別の行とは異なる属性と指標を指定できます。 同じ結果セットで行はオブジェクトではなくオブジェクトとして 固定行の数を表します。

UNKNOWN 列挙型

タイプ UNKNOWN で返されるリソースは、 確認します。これらのリソースは、他の VM で作成されたことも インターフェース（Google 広告 UI など）リソースに特定のリソースがある場合に UNKNOWN 型ですが、API を使用してリソースを変更することはできません。「 例として UI に導入される新しいキャンペーンや広告がありますが、 クエリ対象の API バージョンではサポートされていません。

次の点に注意してください。

  • UNKNOWN タイプのリソースは、後でサポートすることも、UNKNOWN のままにしておくこともできます。 制限はありません
  • UNKNOWN タイプの新しいオブジェクトはいつでも表示できます。これらのオブジェクトは、 下位互換性があります。列挙値はすでに利用できるからです。リソース 今回の変更により アカウントを正確に把握できます。UNKNOWN リソースが表示される理由 他のインターフェースで新たに行った操作や、リソースの割り当てが サポートされなくなりました
  • UNKNOWN リソースには、詳細な指標を関連付けることができます。 なります。
  • UNKNOWN リソースは通常、Google 広告の UI に完全に表示されます。
  • 通常、UNKNOWN リソースは変更できません。

セグメンテーション

レスポンスには、次の要素の組み合わせごとに 1 つの GoogleAdsRow が含まれます。 次のとおりです。

  • FROM 句で指定されたメインリソースのインスタンス
  • 選択した各 segment フィールドの値

たとえば、FROM campaign を選択し、次を含むクエリのレスポンスは次のようになります。 SELECT 句の segments.ad_network_type と segments.date は次のようになります。 次の組み合わせごとに 1 行が表示されます。

  • campaign
  • segments.ad_network_type
  • segments.date

結果は、メインリソースのインスタンスごとに暗黙的にセグメント化され、 選択した個々のフィールドの値が表示されます。次に例を示します。

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

キャンペーンの個々の値ごとに 1 行ではなく、キャンペーンごとに 1 行が表示される campaign.status フィールド。

前へ
オブジェクトの変更と検査
次へ
リソース メタデータ