- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- MonthlyRange
- SearchKeywordCount
- InsightsValue
แสดงคีย์เวิร์ดที่ใช้ค้นหาธุรกิจในการค้นหาหรือแผนที่ คีย์เวิร์ดที่ใช้ค้นหาแต่ละคำมาพร้อมกับการแสดงผล ซึ่งรวบรวมเป็นรายเดือน
ตัวอย่างคำขอ: 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 |
ต้องระบุ ตำแหน่งที่ควรดึงข้อมูลอนุกรมเวลา รูปแบบ: สถานที่ตั้ง/{locationId} โดยที่ locationId เป็นรหัสข้อมูลที่ไม่สร้างความสับสน |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
monthlyRange |
ต้องระบุ ช่วงเดือนที่จะรวมการแสดงผลคีย์เวิร์ดในการค้นหา |
pageSize |
ไม่บังคับ จำนวนผลลัพธ์ที่ขอ ขนาดหน้าเริ่มต้นคือ 100 สามารถกำหนดขนาดหน้าเว็บได้สูงสุด 100 หน้า |
pageToken |
ไม่บังคับ โทเค็นที่ระบุผลลัพธ์ที่ใส่เลขหน้าถัดไปซึ่งจะแสดงขึ้นมา สตริงที่เข้ารหัสแบบ Base64 |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
แสดงการตอบกลับสำหรับ monthly.list
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"searchKeywordsCounts": [
{
object ( |
ช่อง | |
---|---|
searchKeywordsCounts[] |
ข้อความค้นหาที่ใช้ค้นหาธุรกิจ |
nextPageToken |
โทเค็นที่ระบุผลลัพธ์ที่ใส่เลขหน้าล่าสุดที่แสดงผล ซึ่งสามารถใช้เมื่อคำขอประสบความสำเร็จเพื่อไปยัง "หน้า" ถัดไปของคีย์เวิร์ด และจะแสดงเมื่อมีผลลัพธ์เพิ่มเติมเท่านั้น สตริงที่เข้ารหัสแบบ Base64 |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/business.manage
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
MonthlyRange
ช่วงเวลาที่ระบุช่วงเดือน (รวมทั้งสองแบบ)
การแสดง JSON |
---|
{ "startMonth": { object ( |
ช่อง | |
---|---|
startMonth |
ต้องระบุ รวม - พิจารณาเฉพาะช่องปีและเดือน |
endMonth |
ต้องระบุ รวม - พิจารณาเฉพาะช่องปีและเดือน |
SearchKeywordCount
แสดงคีย์เวิร์ดสำหรับโฆษณา Search คำเดียวและค่าของคีย์เวิร์ดนั้น
การแสดง JSON |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
ช่อง | |
---|---|
searchKeyword |
สตริงตัวพิมพ์เล็กที่ผู้ใช้ป้อน |
insightsValue |
หนึ่งในค่าใดค่าหนึ่งต่อไปนี้ 1) ผลรวมของจำนวนผู้ใช้ที่ไม่ซ้ำที่ใช้คีย์เวิร์ดในหนึ่งเดือน ผลรวมสำหรับแต่ละเดือนที่ขอ 2) เกณฑ์ที่แสดงว่าค่าจริงต่ำกว่าเกณฑ์นี้ |
InsightsValue
แสดงค่าข้อมูลเชิงลึก
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม InsightsValue แสดงว่าคุณต้องมีช่อง Proto เพียง 1 ช่องต่อไปนี้เท่านั้น InsightsValue ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
value |
แสดงค่าจริง |
threshold |
แสดงเกณฑ์ที่ต่ำกว่าค่าจริง |