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

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

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

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

object (MonthlyRange)

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

integer

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

string (bytes format)

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

สตริงที่เข้ารหัสแบบ Base64

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

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

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

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

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

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

object (SearchKeywordCount)

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

string (bytes format)

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

สตริงที่เข้ารหัสแบบ Base64

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

MonthlyRange

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

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

object (Date)

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

object (Date)

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

SearchKeywordCount

แสดงคีย์เวิร์ดสำหรับโฆษณา Search คำเดียวและค่าของคีย์เวิร์ดนั้น

การแสดง 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 เพียง 1 ช่องต่อไปนี้เท่านั้น InsightsValue ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
value

string (int64 format)

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

string (int64 format)

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