Method: locations.searchkeywords.impressions.monthly.list

แสดงคีย์เวิร์ดในการค้นหาที่ใช้ค้นหาธุรกิจในการค้นหาหรือแผนที่ คีย์เวิร์ดในการค้นหาแต่ละคำมาพร้อมกับการแสดงผลซึ่งรวบรวมเป็นรายเดือน

ตัวอย่างคำขอ: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3

คำขอ HTTP

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

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

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

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

string

ต้องระบุ ตำแหน่งที่ควรดึงข้อมูลอนุกรมเวลา รูปแบบ: locations/{locationId} โดยที่ locationId เป็นรหัสรายชื่อที่ไม่สร้างความสับสน

พารามิเตอร์การค้นหา

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

object (MonthlyRange)

ต้องระบุ ช่วงในหน่วยเดือนที่จะรวบรวมการแสดงผลของคีย์เวิร์ดในการค้นหา
pageSize

integer

ไม่บังคับ จำนวนผลลัพธ์ที่ขอ ขนาดหน้าเริ่มต้นคือ 100 สามารถกำหนดขนาดหน้าเว็บได้สูงสุด 100
pageToken

string (bytes format)

ไม่บังคับ โทเค็นที่ระบุผลลัพธ์ที่ใส่เลขหน้าถัดไปซึ่งจะส่งคืน

สตริงที่เข้ารหัสฐาน 64

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

เนื้อหาของคำขอต้องว่างเปล่า

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

แสดงการตอบกลับสำหรับ monthly.list

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

การแสดง JSON 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
ช่อง
searchKeywordsCounts[]

object (SearchKeywordCount)

ข้อความค้นหาที่ใช้ค้นหาธุรกิจ
nextPageToken

string (bytes format)

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

สตริงที่เข้ารหัสฐาน 64

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

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

  • https://www.googleapis.com/auth/business.manage

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

MonthlyRange

ช่วงเวลาที่ระบุช่วงเดือน (รวมทั้ง 2 ช่วง)

การแสดง JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
ช่อง
startMonth

object (Date)

ต้องระบุ รวม - จะมีการพิจารณาเฉพาะช่องปีและเดือนเท่านั้น
endMonth

object (Date)

ต้องระบุ รวม - จะมีการพิจารณาเฉพาะช่องปีและเดือนเท่านั้น

SearchKeywordCount

แสดงคีย์เวิร์ดในการค้นหาคำเดียวและค่าของคีย์เวิร์ด

การแสดง JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
ช่อง
searchKeyword

string

สตริงตัวพิมพ์เล็กที่ผู้ใช้ป้อน
insightsValue

object (InsightsValue)

อันใดอันหนึ่ง: 1) ผลรวมของจำนวนผู้ใช้ที่ไม่ซ้ำที่ใช้คีย์เวิร์ดในเดือนนั้น ซึ่งรวบรวมสำหรับแต่ละเดือนที่มีคำขอ 2) เกณฑ์ที่ระบุว่าค่าจริงต่ำกว่าเกณฑ์นี้

InsightsValue

แสดงค่าข้อมูลเชิงลึก

การแสดง JSON 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
ช่อง
ช่องการรวม InsightsValue ระบุว่าต้องมีช่อง Proto เพียงช่องเดียวต่อไปนี้ InsightsValue ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
value

string (int64 format)

แสดงค่าจริง
threshold

string (int64 format)

แสดงเกณฑ์ที่ต่ำกว่าค่าจริง