Method: customers.generateKeywordIdeas

แสดงรายการแนวคิดคีย์เวิร์ด

รายการข้อผิดพลาดที่แสดง: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordIdeas

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

รหัสของลูกค้าที่มีคําแนะนํา

เนื้อหาของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
ช่อง
geoTargetConstants[]

string

ชื่อทรัพยากรของสถานที่ที่จะกําหนดเป้าหมาย สูงสุด 10 รายการ คุณอาจใช้รายการว่างเพื่อระบุภูมิศาสตร์การกําหนดเป้าหมายทั้งหมดได้
includeAdultKeywords

boolean

หากเป็น "จริง" คีย์เวิร์ดสำหรับผู้ใหญ่จะรวมอยู่ในคำตอบ ค่าเริ่มต้นคือ False
pageToken

string

โทเค็นของหน้าที่จะดึงข้อมูล หากไม่ระบุ ระบบจะแสดงหน้าแรกของผลการค้นหา หากต้องการขอหน้าถัดไปของผลการค้นหา ให้ใช้ค่าที่ได้รับจาก nextPageToken ในการตอบกลับก่อนหน้า ช่องคำขอต้องตรงกันในทุกหน้า
pageSize

integer

จํานวนผลลัพธ์ที่จะดึงข้อมูลในหน้าเดียว ระบบจะแสดงผลลัพธ์สูงสุด 10,000 รายการ หาก pageSize มากกว่านี้ ระบบจะไม่สนใจ หากไม่ระบุ ระบบจะแสดงผลลัพธ์สูงสุด 10,000 รายการ เซิร์ฟเวอร์อาจตัดสินใจจำกัดจำนวนทรัพยากรที่แสดงผลเพิ่มเติม หากการตอบกลับมีผลการค้นหาน้อยกว่า 10,000 รายการ ระบบอาจไม่ถือว่าหน้านั้นเป็นหน้าสุดท้ายของผลการค้นหา
keywordPlanNetwork

enum (KeywordPlanNetwork)

เครือข่ายที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่าไว้ ระบบจะใช้เครือข่าย Google Search และพาร์ทเนอร์
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

คําอธิบายประกอบคีย์เวิร์ดที่จะรวมในการตอบกลับ
aggregateMetrics

object (KeywordPlanAggregateMetrics)

ฟิลด์รวมที่จะรวมในการตอบกลับ
historicalMetricsOptions

object (HistoricalMetricsOptions)

ตัวเลือกสำหรับข้อมูลเมตริกย้อนหลัง
language

string

ชื่อทรัพยากรของภาษาที่จะกําหนดเป้าหมาย คีย์เวิร์ดแต่ละรายการจะอยู่ในชุดภาษาบางชุด คีย์เวิร์ดจะรวมอยู่ด้วยหากภาษานั้นเป็นหนึ่งในภาษาของคีย์เวิร์ด หากไม่ได้ตั้งค่า ระบบจะรวมคีย์เวิร์ดทั้งหมด
ฟิลด์สหภาพ seed ประเภทของข้อมูลเริ่มต้นที่จะสร้างแนวคิดคีย์เวิร์ด seed ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keywordAndUrlSeed

object (KeywordAndUrlSeed)

คีย์เวิร์ดและ URL ที่เฉพาะเจาะจงเพื่อสร้างแนวคิด เช่น รถยนต์, www.example.com/cars
keywordSeed

object (KeywordSeed)

คีย์เวิร์ดหรือวลีที่จะสร้างแนวคิด เช่น รถยนต์
urlSeed

object (UrlSeed)

URL ที่เฉพาะเจาะจงเพื่อสร้างแนวคิด เช่น www.example.com/cars
siteSeed

object (SiteSeed)

เว็บไซต์ที่จะสร้างแนวคิด เช่น www.example.com

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ KeywordPlanIdeaService.GenerateKeywordIdeas

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
ช่อง
results[]

object (GenerateKeywordIdeaResult)

ผลลัพธ์ของการสร้างแนวคิดคีย์เวิร์ด
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

เมตริกรวมของแนวคิดคีย์เวิร์ดทั้งหมด
nextPageToken

string

โทเค็นการแบ่งหน้าเว็บที่ใช้ดึงข้อมูลหน้าถัดไปของผลการค้นหา ส่งเนื้อหาของสตริงนี้เป็นแอตทริบิวต์ pageToken ของคำขอถัดไป ระบบจะไม่แสดง nextPageToken สำหรับหน้าสุดท้าย
totalSize

string (int64 format)

จํานวนผลการค้นหาทั้งหมด

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

KeywordPlanKeywordAnnotation

แสดงรายการคําอธิบายประกอบของแผนที่คีย์เวิร์ดซึ่งขอได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
KEYWORD_CONCEPT แสดงผลแนวคิดคีย์เวิร์ดและข้อมูลกลุ่มแนวคิด

KeywordAndUrlSeed

คีย์เวิร์ดและ URL เริ่มต้น

การแสดง JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
ช่อง
keywords[]

string

ต้องมีคีย์เวิร์ดอย่างน้อย 1 คำและไม่เกิน 20 คํา
url

string

URL ที่จะทำการ Crawl เพื่อสร้างแนวคิดคีย์เวิร์ด

KeywordSeed

คีย์เวิร์ดเริ่มต้น

การแสดง JSON 
{
  "keywords": [
    string
  ]
}
ช่อง
keywords[]

string

ต้องมีคีย์เวิร์ดอย่างน้อย 1 คำและไม่เกิน 20 คํา

UrlSeed

เมล็ดพันธุ์ URL

การแสดง JSON 
{
  "url": string
}
ช่อง
url

string

URL ที่จะทำการ Crawl เพื่อสร้างแนวคิดคีย์เวิร์ด

SiteSeed

รายการเริ่มต้นของเว็บไซต์

การแสดง JSON 
{
  "site": string
}
ช่อง
site

string

ชื่อโดเมนของเว็บไซต์ หากลูกค้าขอไอเดียไม่ได้เป็นเจ้าของเว็บไซต์ที่ระบุ ระบบจะแสดงเฉพาะข้อมูลสาธารณะ

GenerateKeywordIdeaResult

ผลลัพธ์ของการสร้างแนวคิดคีย์เวิร์ด

การแสดง JSON 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
ช่อง
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

เมตริกที่ผ่านมาของคีย์เวิร์ด
keywordAnnotations

object (KeywordAnnotations)

คําอธิบายประกอบของคีย์เวิร์ด ระบบจะระบุข้อมูลคําอธิบายประกอบก็ต่อเมื่อมีการขอเท่านั้น
closeVariants[]

string

รายการรูปแบบที่ใกล้เคียงจากคีย์เวิร์ดที่คุณขอซึ่งรวมอยู่ใน GenerateKeywordIdeaResult นี้ ดูคําจํากัดความของ "ตัวแปรที่คล้ายกัน" ได้ที่ https://support.google.com/google-ads/answer/9342105
text

string

ข้อความของแนวคิดคีย์เวิร์ด เช่นเดียวกับเมตริกที่ผ่านมาของแผนคีย์เวิร์ด ข้อความนี้อาจไม่ใช่คีย์เวิร์ดจริง แต่เป็นรูปแบบ Canonical ของคีย์เวิร์ดหลายรายการ ดูข้อความ KeywordPlanKeywordHistoricalMetrics ใน KeywordPlanService

KeywordAnnotations

คําอธิบายประกอบสําหรับคีย์เวิร์ดในแผนคีย์เวิร์ด

การแสดง JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
ช่อง
concepts[]

object (KeywordConcept)

รายการแนวคิดสําหรับคีย์เวิร์ด

KeywordConcept

แนวคิดสําหรับคีย์เวิร์ด

การแสดง JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
ช่อง
name

string

ชื่อแนวคิดสําหรับคีย์เวิร์ดใน conceptGroup
conceptGroup

object (ConceptGroup)

กลุ่มแนวคิดของรายละเอียดแนวคิด

ConceptGroup

กลุ่มแนวคิดสําหรับแนวคิดคีย์เวิร์ด

การแสดง JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
ช่อง
name

string

ชื่อกลุ่มแนวคิด
type

enum (KeywordPlanConceptGroupType)

ประเภทกลุ่มแนวคิด

KeywordPlanConceptGroupType

แสดงรายการประเภทกลุ่มแนวคิดของแผนคีย์เวิร์ด

Enum
UNSPECIFIED การจัดประเภทกลุ่มแนวคิดแตกต่างจากแบรนด์/ไม่ใช่แบรนด์ นี่เป็นกลุ่มที่รวมการจัดประเภททั้งหมดที่ไม่ใช่ประเภทด้านล่าง
UNKNOWN ค่านี้ไม่รู้จักในเวอร์ชันนี้
BRAND การจัดประเภทกลุ่มแนวคิดจะอิงตามแบรนด์
OTHER_BRANDS การแยกกลุ่มแนวคิดตามแบรนด์ ซึ่งไม่เหมาะกับการจัดประเภทแบรนด์ โดยทั่วไปแล้วคีย์เวิร์ดเหล่านี้จะเป็นค่าผิดปกติและอาจมีคีย์เวิร์ดเพียงไม่กี่รายการในการจัดประเภทประเภทนี้
NON_BRAND การแยกประเภทกลุ่มแนวคิดเหล่านี้ไม่ได้อิงตามแบรนด์ ผลลัพธ์นี้แสดงสําหรับคีย์เวิร์ดทั่วไปที่ไม่มีความเชื่อมโยงกับแบรนด์