Method: customers.generateKeywordIdeas

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

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

คำขอ HTTP

POST https://googleads.googleapis.com/v16/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 ที่ใช้สร้างแนวคิดคีย์เวิร์ด 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

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

คีย์เวิร์ดและ Seed URL

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

string

ต้องใช้คีย์เวิร์ดอย่างน้อยหนึ่งคำ
url

string

URL ที่จะรวบรวมข้อมูลเพื่อสร้างแนวคิดคีย์เวิร์ด

KeywordSeed

คีย์เวิร์ดตั้งต้น

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

string

ต้องใช้คีย์เวิร์ดอย่างน้อยหนึ่งคำ

UrlSeed

Seed Url

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

string

URL ที่จะรวบรวมข้อมูลเพื่อสร้างแนวคิดคีย์เวิร์ด

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

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

string

ข้อความของแนวคิดคีย์เวิร์ด เช่นเดียวกับในเมตริกที่ผ่านมาของแผนคีย์เวิร์ด ข้อความนี้อาจไม่ใช่คีย์เวิร์ดจริง แต่เป็นรูปแบบ Canonical ของคีย์เวิร์ดหลายรายการ ดูข้อความ KeywordPlanKeywordHistoryMetrics ใน 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 การจัดประเภทกลุ่มแนวคิดจะอิงตาม BRAND
OTHER_BRANDS การจัดประเภทกลุ่มแนวคิดตาม BRAND ซึ่งไม่สอดคล้องกับการจัดประเภท BRAND โดยทั่วไปแล้ว ค่าเหล่านี้เป็นค่าที่ผิดปกติและอาจมีคีย์เวิร์ดน้อยมากในการจัดประเภทประเภทนี้
NON_BRAND การจัดประเภทกลุ่มแนวคิดเหล่านี้ไม่ได้อิงตาม BRAND ซึ่งจะแสดงผลสำหรับคีย์เวิร์ดทั่วไปที่ไม่มีการเชื่อมโยงแบรนด์