Method: customers.generateKeywordHistoricalMetrics

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

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

คำขอ HTTP

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

GenerateKeywordHistoricalMetricsResult

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

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

string

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

object (KeywordPlanHistoricalMetrics)

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

string

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