- 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/v15/customers/{customerId}:generateKeywordIdeas
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
提供建議的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "geoTargetConstants": [ string ], "includeAdultKeywords": boolean, "pageToken": string, "pageSize": integer, "keywordPlanNetwork": enum ( |
欄位 | |
---|---|
geoTargetConstants[] |
目標位置的資源名稱。上限為 10。空白清單「或許」可用來指定所有指定地理區域。 |
includeAdultKeywords |
若為 true,則會在回應中加入成人關鍵字。預設值為 false。 |
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 總覽。
KeywordPlanKeywordAnnotation
列舉可要求的關鍵字企劃書註解。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本中的值不明。 |
KEYWORD_CONCEPT |
傳回關鍵字概念和概念群組資料。 |
KeywordAndUrlSeed
關鍵字和網址種子
JSON 表示法 |
---|
{ "keywords": [ string ], "url": string } |
欄位 | |
---|---|
keywords[] |
需要至少一個關鍵字。 |
url |
為產生關鍵字提案而要檢索的網址。 |
KeywordSeed
關鍵字種子值
JSON 表示法 |
---|
{ "keywords": [ string ] } |
欄位 | |
---|---|
keywords[] |
需要至少一個關鍵字。 |
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 中的 KeywordPlanKeywordHistoryMetrics 訊息。 |
KeywordAnnotations
關鍵字企劃書關鍵字的註解。
JSON 表示法 |
---|
{
"concepts": [
{
object ( |
欄位 | |
---|---|
concepts[] |
關鍵字的概念清單。 |
KeywordConcept
關鍵字概念。
JSON 表示法 |
---|
{
"name": string,
"conceptGroup": {
object ( |
欄位 | |
---|---|
name |
ConceptGroup 中關鍵字的概念名稱。 |
conceptGroup |
概念詳細資料的概念群組。 |
ConceptGroup
關鍵字概念的概念群組。
JSON 表示法 |
---|
{
"name": string,
"type": enum ( |
欄位 | |
---|---|
name |
概念群組名稱。 |
type |
概念群組類型。 |
KeywordPlanConceptGroupType
列舉關鍵字企劃書概念群組類型。
列舉 | |
---|---|
UNSPECIFIED |
概念群組分類與品牌/非品牌不同。這是擷取所有分類的全部值區,不含以下類別的所有分類。 |
UNKNOWN |
這個版本中的值不明。 |
BRAND |
概念群組分類是以 BRAND 為基礎。 |
OTHER_BRANDS |
根據 BRAND 進行的概念群組分類,不適合使用 BRAND 分類。這些類別通常是離群值,而且這類分類的關鍵字很少。 |
NON_BRAND |
這些概念群組分類並非根據 BRAND。無品牌關聯的一般關鍵字會傳回這個結果。 |