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

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

string

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

integer

จํานวนผลลัพธ์ที่จะดึงข้อมูลในหน้าเดียว อาจส่งคืนผลลัพธ์ได้สูงสุด 10,000 รายการ หากขนาดหน้าเกินขนาดนี้จะถูกละเว้น หากไม่ระบุ ระบบจะแสดงผลลัพธ์สูงสุด 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

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

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

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

string

ต้องมีคีย์เวิร์ดอย่างน้อย 1 รายการ
url

string

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

KeywordSeed

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

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

string

ต้องมีคีย์เวิร์ดอย่างน้อย 1 รายการ

UrlSeed

เมล็ดพันธุ์ 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

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