Method: customers.generateInsightsFinderReport

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

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

HTTP 要求

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

產品與服務類別