Method: customers.generateKeywordHistoricalMetrics

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

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

คำขอ HTTP

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