Method: customers.generateKeywordHistoricalMetrics

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

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

คำขอ HTTP

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

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

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

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

string

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

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

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

การแสดง JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
ช่อง
keywords[]

string

รายการคีย์เวิร์ดเพื่อดูเมตริกที่ผ่านมา ระบบอาจไม่แสดงอินพุตบางรายการเนื่องจากมีการกรองข้อมูลที่ซ้ำกันเกือบทั้งหมดออก เช่น หากมีการขอสถิติสําหรับ "รถ" และ "รถยนต์" ระบบจะแสดงเฉพาะ "รถ" ใช้คีย์เวิร์ดได้สูงสุด 10,000 คํา
includeAdultKeywords

boolean

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

string

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

enum (KeywordPlanNetwork)

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

object (KeywordPlanAggregateMetrics)

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

object (HistoricalMetricsOptions)

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

string

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

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

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

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

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

object (GenerateKeywordHistoricalMetricsResult)

รายการคีย์เวิร์ดและเมตริกที่ผ่านมา
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

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

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

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

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

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

GenerateKeywordHistoricalMetricsResult

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

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

string

รายการรูปแบบที่ใกล้เคียงจากคีย์เวิร์ดที่คุณขอซึ่งรวมสถิติไว้ใน GenerateKeywordHistoricalMetricsResult นี้
keywordMetrics

object (KeywordPlanHistoricalMetrics)

เมตริกที่ผ่านมาสําหรับข้อความและข้อความที่คล้ายกัน
text

string

ข้อความของคําค้นหาที่เชื่อมโยงกับคีย์เวิร์ดอย่างน้อย 1 คํา โปรดทราบว่าเราจะกรองรายการคีย์เวิร์ดของคุณเพื่อนำรายการที่ซ้ำกันออก โดยจะนำรูปแบบที่ใกล้เคียงกันออกก่อนแสดงคีย์เวิร์ดเป็นข้อความ ตัวอย่างเช่น หากคำขอเดิมมีคีย์เวิร์ด "รถ" และ "รถยนต์" คำค้นหาที่แสดงผลจะมีเพียง "รถยนต์" เท่านั้น รายการคำค้นหาที่กรองข้อมูลที่ซ้ำกันออกจะรวมอยู่ในช่อง closeVariants