Method: customers.searchAds360.searchStream

検索ストリーム クエリに一致するすべての行を返します。

スローされるエラーのリスト: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

HTTP リクエスト

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:searchStream

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。クエリ対象の顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "query": string,
  "batchSize": integer,
  "summaryRowSetting": enum (SummaryRowSetting)
}
フィールド
query

string

必須。クエリ文字列。

batchSize

integer

各ストリーム レスポンス バッチで返される行数。過度に大きいバッチがリクエストされた場合、サーバーは、返される行数をさらに制限することを決定することがあります。

summaryRowSetting

enum (SummaryRowSetting)

概要行を返すかどうかを決定します。デフォルトでは、概要行は返されません。リクエストされた場合、他のすべてのクエリ結果が返された後、概要行が単独でレスポンスで送信されます。

レスポンスの本文

SearchAds360Service.SearchStream に対するレスポンス メッセージです。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ],
  "requestId": string
}
フィールド
results[]

object (SearchAds360Row)

クエリに一致した行のリスト。

fieldMask

string (FieldMask format)

ユーザーがリクエストしたフィールドを表す FieldMask。

これは、フィールドの完全修飾名のカンマ区切りリストです。(例: "user.displayName,photo")。

summaryRow

object (SearchAds360Row)

結果の指標の概要を含む概要行。指標の概要とは、すべての結果についての指標の集計を意味します。集計とは、合計、平均、レートなどを指します。

customColumnHeaders[]

object (CustomColumnHeader)

結果のカスタム列のヘッダー。

conversionCustomMetricHeaders[]

object (ConversionCustomMetricHeader)

結果に含まれるコンバージョン カスタム指標のヘッダー。

conversionCustomDimensionHeaders[]

object (ConversionCustomDimensionHeader)

結果のコンバージョン カスタム ディメンションのヘッダー。

rawEventConversionMetricHeaders[]

object (RawEventConversionMetricHeader)

結果に含まれる未加工のイベント コンバージョン指標のヘッダー。

rawEventConversionDimensionHeaders[]

object (RawEventConversionDimensionHeader)

結果に含まれる未加工のイベント コンバージョン ディメンションのヘッダー。

requestId

string

デバッグ目的で使用されるリクエストの一意の ID。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/doubleclicksearch