検索と SearchStream

動画: レポート

Google Ads API は、統合された属性の取得と指標のレポートを備えています。 メカニズム Google 広告クエリ 言語。 これにより、 個別の Google 広告アカウント

クエリは、Search メソッドか SearchStream メソッドのいずれかを使用して作成できます。 どちらのメソッドも同じクエリをサポートし、同等の結果を返します。「 Search メソッドは、10,000 行の固定サイズのページでデータを返すため、次のことができます。 ページ分けを使用して結果セットを反復処理できます。これは、低帯域幅の環境で たとえば、大規模なネットワーク トラフィックをセグメント化するために、 小さなレスポンスに分割し、接続が確立された場合に わかります一方、SearchStream メソッドは結果全体をストリーミングします。 一括データにはより効率的であり、 使用します。

Search と SearchStream はどちらも同じベース URL を使用します。

    https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds

POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}

結果の行が 10,000 行を超える場合、nextPageToken は 次のレスポンスで返されます。

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

同じクエリを繰り返し、pageToken に 前のリクエストは結果の次のページをフェッチします。

POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}

単一のストリーミング データですべての結果を返す SearchStream メソッドを使用する。 レスポンスの場合は、URL のサービス メソッドを searchStream に変更します。 （SearchStream では pageSize と pageToken は不要です）。

POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

{
    "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}
前へ
概要
次へ
Mutate