Method: customers.generateInsightsFinderReport

Insights Finder ツールで表示できる保存済みレポートを作成します。

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

HTTP リクエスト

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateInsightsFinderReport

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

パスパラメータ

パラメータ
customerId

string

必須。顧客の ID。

リクエスト本文

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

JSON 表現 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
フィールド
baselineAudience

object (BasicInsightsAudience)

必須。このレポートのベースライン オーディエンス。通常は、ある地域にいるすべてのユーザーです。
specificAudience

object (BasicInsightsAudience)

必須。このレポートで関心のある特定のオーディエンス。レポートの分析情報は、レポートのベースライン オーディエンスよりもこのオーディエンスに広く見られる属性に基づいています。
customerInsightsGroup

string

計画しているお客様の名前。これはユーザー定義の値です。

レスポンスの本文

AudienceInsightsService.GenerateInsightsFinderReport に対するレスポンス メッセージ。レポートの共有可能な URL が含まれます。

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

JSON 表現 
{
  "savedReportUrl": string
}
フィールド
savedReportUrl

string

Insights Finder UI へのディープリンクを提供する HTTPS URL。リクエストに応じてレポートの入力内容が入力されます。

承認スコープ

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

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

詳細については、OAuth 2.0 の概要をご覧ください。

BasicInsightsAudience

分析情報のリクエストに使用するオーディエンスの説明。

JSON 表現 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
フィールド
countryLocation[]

object (LocationInfo)

必須。このオーディエンスの国。
subCountryLocations[]

object (LocationInfo)

地方の地理的位置属性。これらが存在する場合は、それぞれがこのオーディエンスのいずれかの国に含まれている必要があります。
gender

object (GenderInfo)

オーディエンスの性別。指定されていない場合、オーディエンスは性別による制限を受けません。
ageRanges[]

object (AgeRangeInfo)

オーディエンスの年齢層。指定されていない場合、オーディエンスは他の属性に一致する 18 歳以上のすべてのユーザーを表します。
userInterests[]

object (UserInterestInfo)

このオーディエンスを定義するユーザーの興味 / 関心。アフィニティ カテゴリと購買意向の強いオーディエンスがサポートされています。
topics[]

object (AudienceInsightsTopic)

このオーディエンスが関心を持っているトピック。ナレッジグラフ エンティティや、商品やサービスのカテゴリで表されます。

AudienceInsightsTopic

オーディエンスを定義するトピックを表すエンティティまたはカテゴリ。

JSON 表現 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
フィールド
共用体フィールド topic。エンティティまたはカテゴリの属性。topic は次のいずれかになります。
entity

object (AudienceInsightsEntity)

ナレッジグラフ エンティティ
category

object (AudienceInsightsCategory)

商品とサービスのカテゴリ