Method: customers.generateKeywordIdeas

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

รายการข้อผิดพลาดที่มีการเชื่อมโยง: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v14/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
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 Seed

การแสดง 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

Seed ของเว็บไซต์

การแสดง 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 ของคีย์เวิร์ดหลายรายการ ดูที่ข้อความ 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 ซึ่งจะแสดงผลสำหรับคีย์เวิร์ดทั่วไปที่ไม่มีความเกี่ยวข้องกับแบรนด์