傳回關鍵字歷來指標清單。
擲回錯誤清單:AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordHistoricalMetrics
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
建議項目的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "keywords": [ string ], "includeAdultKeywords": boolean, "geoTargetConstants": [ string ], "keywordPlanNetwork": enum ( |
欄位 | |
---|---|
keywords[] |
一組關鍵字,用於取得歷來指標。系統可能不會傳回部分輸入內容的結果,是近乎精確的簡化結果。舉例來說,如果請求了「汽車」和「汽車」的統計資料,則系統只會傳回「汽車」。最多只能使用 10,000 個關鍵字。 |
includeAdultKeywords |
若為 true,則會納入成人關鍵字。預設值為否。 |
geoTargetConstants[] |
指定位置的資源名稱。上限為 10 個。「可能」使用空白名單來指定所有指定地理區域。 |
keywordPlanNetwork |
指定聯播網。如果未設定,系統將使用 Google 搜尋夥伴聯播網。 |
aggregateMetrics |
要納入回應的匯總欄位。 |
historicalMetricsOptions |
歷來指標資料的選項。 |
language |
要指定語言的資源名稱。每個關鍵字都屬於部分語言;如果語言是其語言之一,也會納入關鍵字。如未設定,系統會納入所有關鍵字。 |
回應主體
「KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
」的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "results": [ { object ( |
欄位 | |
---|---|
results[] |
關鍵字清單及其歷來指標。 |
aggregateMetricResults |
所有關鍵字的匯總指標。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
GenerateKeywordHistoricalMetricsResult
產生關鍵字歷來指標的結果。
JSON 表示法 |
---|
{
"closeVariants": [
string
],
"keywordMetrics": {
object ( |
欄位 | |
---|---|
closeVariants[] |
針對請求的關鍵字,列出其統計資料已合併至此 GenerateKeywordHistoryMetricsResult 的近似變體。 |
keywordMetrics |
文字和近似變體的歷來指標 |
text |
與一或多個關鍵字相關的查詢文字。請注意,我們會移除重複關鍵字清單,先移除近似變體,再以文字形式傳回關鍵字。舉例來說,如果您的請求原本含有「car」和「cars」關鍵字,則傳回的搜尋查詢只會包含「cars」。「closeVariants」欄位會包含排除重複查詢的清單。 |