Method: customers.generateInsightsFinderReport

建立已儲存的報表，可在 Insights Finder 工具中查看。

擲回錯誤清單：AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。客戶的 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
欄位
baselineAudience

object (BasicInsightsAudience)

必要欄位。這份報表的基準目標對象，通常位於地區內的所有使用者。
specificAudience

object (BasicInsightsAudience)

必要欄位。希望此報表的特定目標對象。報表會根據這個目標對像中較常見屬性 (與報表基準目標對象相比) 的洞察資料進行深入分析。
customerInsightsGroup

string

要投放的客戶名稱。這是使用者定義的值。

回應主體

AudienceInsightsService.GenerateInsightsFinderReport 的回應訊息，包含報表可分享的網址。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "savedReportUrl": string
}
欄位
savedReportUrl

string

提供 Insights Finder 使用者介面深層連結的 HTTPS 網址，系統會根據要求填入報表輸入內容。

授權範圍

需要下列 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)

產品與服務類別