Method: accounts.locations.reportInsights

แสดงรายงานที่มีข้อมูลเชิงลึกของเมตริกอย่างน้อย 1 รายการตามสถานที่ตั้ง

คำขอ HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

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

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

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

string

ชื่อทรัพยากรของบัญชี

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

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
ช่อง
locationNames[]

string

คอลเล็กชันของสถานที่ที่จะดึงข้อมูลข้อมูลเชิงลึก ซึ่งระบุตามชื่อ

basicRequest

object (BasicMetricsRequest)

คำขอที่จะรวมข้อมูลเชิงลึกเกี่ยวกับเมตริกพื้นฐานในรายงาน

drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

คำขอที่ใส่ข้อมูลเชิงลึกเกี่ยวกับคำขอเส้นทางขับขี่ในรายงาน

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

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

ข้อความตอบกลับสำหรับ Insights.ReportLocationInsights

การแสดง JSON
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
ช่อง
locationMetrics[]

object (LocationMetrics)

การรวบรวมค่าเมตริกตามสถานที่ตั้ง

locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

คอลเล็กชันของค่าต่างๆ สำหรับเมตริกที่เกี่ยวข้องกับเส้นทางการขับขี่

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

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

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

DrivingDirectionMetricsRequest

คําขอข้อมูลเชิงลึกเกี่ยวกับเส้นทางการขับขี่

การแสดง JSON
{
  "numDays": enum (NumDays),
  "languageCode": string
}
ช่อง
numDays

enum (NumDays)

จำนวนวันที่จะรวมข้อมูล ผลลัพธ์ที่แสดงจะมีข้อมูลในช่วงจำนวนวันที่ขอล่าสุด ค่าที่ใช้ได้คือ 7, 30 และ 90

languageCode

string

รหัส BCP 47 สำหรับภาษา หากไม่ได้ระบุรหัสภาษา จะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น

NumDays

จำนวนวันที่คำขอนี้รองรับได้

Enum
SEVEN 7 วัน นี่คือค่าเริ่มต้น
THIRTY 30 วัน
NINETY 90 วัน

LocationMetrics

ชุดเมตริกและ BreakdownMetrics ที่เชื่อมโยงกับตำแหน่งในช่วงเวลาหนึ่ง

การแสดง JSON
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
ช่อง
locationName

string

ชื่อทรัพยากรสถานที่ของค่าเหล่านี้

timeZone

string

เขตเวลา IANA สำหรับตำแหน่ง

metricValues[]

object (MetricValue)

รายการค่าของเมตริกที่ขอ

LocationDrivingDirectionMetrics

ตำแหน่งที่มีการจัดทําดัชนีตามภูมิภาคที่ผู้เข้าชมมักอาศัยอยู่ ข้อมูลนี้จะได้จากการนับจำนวนคำขอเส้นทางการขับขี่ไปยังสถานที่ตั้งนี้ที่มาจากแต่ละภูมิภาค

การแสดง JSON
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
ช่อง
locationName

string

ชื่อทรัพยากรสถานที่ตั้งซึ่งอยู่ในค่าเมตริกนี้

topDirectionSources[]

object (TopDirectionSources)

คำขอเส้นทางการขับขี่ตามภูมิภาคต้นทาง โดยทั่วไป รายการเหล่านี้มีการจัดเรียงตามจำนวนโดยมีผลลัพธ์ไม่เกิน 10 รายการ

timeZone

string

เขตเวลา (รหัสเขตเวลาของ IANA เช่น "ยุโรป/ลอนดอน") ของสถานที่ตั้ง

TopDirectionSources

ภูมิภาคยอดนิยมที่เป็นแหล่งที่มาของคำขอเส้นทางการขับขี่

การแสดง JSON
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
ช่อง
dayCount

integer

จํานวนวันที่รวบรวมข้อมูล

regionCounts[]

object (RegionCount)

ภูมิภาคจัดเรียงตามจำนวนจากมากไปหาน้อย

RegionCount

ภูมิภาคที่มีจำนวนคำขอที่เกี่ยวข้อง

การแสดง JSON
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
ช่อง
latlng

object (LatLng)

ศูนย์กลางของภูมิภาค

label

string

ป้ายกำกับที่มนุษย์อ่านได้สำหรับภูมิภาค

count

string (int64 format)

จำนวนคำขอเส้นทางขับขี่จากภูมิภาคนี้