- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- 試試看!
傳回關鍵字提案清單。
擲回的錯誤清單:AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordIdeas
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
有推薦內容的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "geoTargetConstants": [ string ], "includeAdultKeywords": boolean, "pageToken": string, "pageSize": integer, "keywordPlanNetwork": enum ( |
欄位 | |
---|---|
geoTargetConstants[] |
要指定的位置資源名稱。上限為 10。您可以使用空白清單指定所有指定地理區域。 |
includeAdultKeywords |
如果為 true,回應中就會包含成人關鍵字。預設值為否。 |
pageToken |
要擷取的頁面符記。如未指定,系統會傳回第一頁的結果。如要要求下一頁的結果,請使用先前回應中 |
pageSize |
單一頁面中要擷取的結果數量。最多可傳回 10,000 個結果,如果 pageSize 超過這個數字,系統會忽略該值。如未指定,最多將傳回 10,000 個結果。伺服器可能會進一步限制傳回的資源數量。如果回應包含的結果少於 10,000 個,系統可能不會將其視為結果的最後一頁。 |
keywordPlanNetwork |
指定聯播網。如未設定,系統會使用 Google 搜尋和合作夥伴聯播網。 |
keywordAnnotation[] |
要納入回應中的關鍵字註解。 |
aggregateMetrics |
回應中要納入的匯總欄位。 |
historicalMetricsOptions |
歷來指標資料的選項。 |
language |
要指定的語言資源名稱。每個關鍵字都屬於某些語言組合;如果語言是關鍵字的其中一種語言,就會納入關鍵字。如未設定,系統會納入所有關鍵字。 |
聯集欄位 seed 。用來產生關鍵字提案的種子類型。seed 只能是下列其中一項: |
|
keywordAndUrlSeed |
關鍵字和特定網址,用於產生相關主題,例如汽車、www.example.com/cars。 |
keywordSeed |
關鍵字或詞組,用於產生想法,例如汽車。 |
urlSeed |
要產生構想的特定網址,例如 www.example.com/cars。 |
siteSeed |
產生構想的網站,例如 www.example.com。 |
回應主體
KeywordPlanIdeaService.GenerateKeywordIdeas
的回應訊息。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{ "results": [ { object ( |
欄位 | |
---|---|
results[] |
產生關鍵字提案的結果。 |
aggregateMetricResults |
所有關鍵字提案的匯總指標。 |
nextPageToken |
用於擷取下一頁結果的分頁符記。將此字串的內容做為下一個要求的 |
totalSize |
可用的結果總數。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 Overview。
KeywordPlanKeywordAnnotation
列舉可要求的關鍵字企劃書註解。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
這個值在這個版本中未知。 |
KEYWORD_CONCEPT |
傳回關鍵字概念和概念群組資料。 |
KeywordAndUrlSeed
關鍵字和網址種子
JSON 表示法 |
---|
{ "keywords": [ string ], "url": string } |
欄位 | |
---|---|
keywords[] |
至少需要一個關鍵字,最多 20 個關鍵字。 |
url |
要檢索的網址,以產生關鍵字提案。 |
KeywordSeed
關鍵字字根
JSON 表示法 |
---|
{ "keywords": [ string ] } |
欄位 | |
---|---|
keywords[] |
至少需要一個關鍵字,最多 20 個關鍵字。 |
UrlSeed
網址種子
JSON 表示法 |
---|
{ "url": string } |
欄位 | |
---|---|
url |
要檢索的網址,以產生關鍵字提案。 |
SiteSeed
網站種子
JSON 表示法 |
---|
{ "site": string } |
欄位 | |
---|---|
site |
網站的網域名稱。如果提出要求的客戶並非網站擁有者,系統只會傳回公開資訊。 |
GenerateKeywordIdeaResult
產生關鍵字提案的結果。
JSON 表示法 |
---|
{ "keywordIdeaMetrics": { object ( |
欄位 | |
---|---|
keywordIdeaMetrics |
關鍵字的歷來指標。 |
keywordAnnotations |
關鍵字的註解。只有在你要求的情況下,我們才會提供註解資料。 |
closeVariants[] |
要求的關鍵字近似變化版本清單,這些變化版本會合併至這個 GenerateKeywordIdeaResult。如要瞭解「相近變化版本」的定義,請參閱 https://support.google.com/google-ads/answer/9342105。 |
text |
關鍵字提案的文字。如同關鍵字企劃書歷來指標,這段文字可能不是實際關鍵字,而是多個關鍵字的標準形式。請參閱 KeywordPlanService 中的 KeywordPlanKeywordHistoricalMetrics 訊息。 |
KeywordAnnotations
關鍵字企劃書關鍵字的註解。
JSON 表示法 |
---|
{
"concepts": [
{
object ( |
欄位 | |
---|---|
concepts[] |
關鍵字的概念清單。 |
KeywordConcept
關鍵字的概念。
JSON 表示法 |
---|
{
"name": string,
"conceptGroup": {
object ( |
欄位 | |
---|---|
name |
概念群組中關鍵字的概念名稱。 |
conceptGroup |
概念詳細資料的概念群組。 |
ConceptGroup
關鍵字概念的概念群組。
JSON 表示法 |
---|
{
"name": string,
"type": enum ( |
欄位 | |
---|---|
name |
概念群組名稱。 |
type |
概念群組類型。 |
KeywordPlanConceptGroupType
列舉關鍵字企劃書概念群組類型。
列舉 | |
---|---|
UNSPECIFIED |
概念群組分類與品牌/非品牌不同。這是所有不屬於下列類別的萬用分類。 |
UNKNOWN |
這個值在這個版本中未知。 |
BRAND |
概念群組分類依據品牌。 |
OTHER_BRANDS |
概念群組分類是以品牌為依據,但不太符合品牌分類。這些通常是異常值,在這種類型分類中可能只有少數關鍵字。 |
NON_BRAND |
這些概念群組分類並非以品牌為依據。系統會針對沒有品牌關聯的一般關鍵字傳回這項資料。 |