Method: customers.generateInsightsFinderReport

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

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

HTTP リクエスト

POST https://googleads.googleapis.com/v15/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

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

レスポンスの本文

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

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

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)

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