Method: locations.businesscallsinsights.list

แสดงข้อมูลเชิงลึกสําหรับการโทรจากธุรกิจสําหรับสถานที่ตั้งหนึ่งๆ

คำขอ HTTP

GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights

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

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

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

string

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

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

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

integer

ไม่บังคับ จำนวนสูงสุดของ BusinessCallsInsights ที่จะแสดงผล หากไม่ระบุ ระบบจะส่งคืนสูงสุด 20 รายการ บางเมตริก_ประเภท(เช่น AGGREGATE_COUNT) แสดงผลหน้าเว็บเดียว สำหรับเมตริกเหล่านี้ ระบบจะไม่สนใจ pageSize
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการโทร businesscallsinsights.list ครั้งก่อน ระบุสิ่งนี้เพื่อเรียกหน้าถัดไป

ขณะใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้ businesscallsinsights.list ต้องตรงกับการเรียกที่ระบุโทเค็นของหน้า ประเภทเมตริกบางรายการ (เช่น AGGREGATE_COUNT) แสดงผลหน้าเว็บเดียว สำหรับเมตริกเหล่านี้ ระบบจะไม่สนใจ pake_token
filter

string

ไม่บังคับ ตัวกรองที่จํากัดข้อมูลเชิงลึกเกี่ยวกับการโทรที่จะแสดง การตอบกลับจะมีเฉพาะรายการที่ตรงกับตัวกรอง

หากไม่ได้ระบุ MetricType ระบบจะแสดงผล AGGREGATE_COUNT หากไม่ได้ระบุ endDate จะเป็นวันสุดท้ายที่ข้อมูลใช้งานได้ หากไม่ได้ระบุ startDate เราจะใช้ค่าเริ่มต้นเป็นวันที่แรกที่มีข้อมูล ซึ่งปัจจุบันคือ 6 เดือน หาก startDate อยู่ก่อนวันที่ที่มีข้อมูล ระบบจะส่งคืนข้อมูลโดยเริ่มตั้งแต่วันที่ที่มีข้อมูล

ปัจจุบันเรารองรับตัวกรองต่อไปนี้ 1. startDate="DATE" โดยวันที่อยู่ในรูปแบบ YYYY-MM-DD 2. endDate="DATE" โดยที่วันที่อยู่ในรูปแบบ YYYY-MM-DD 3.MetricType=XYZ โดยที่ XYZ เป็น MetricType ที่ถูกต้อง 4. คำสันธาน(AND) ของทุกข้อข้างต้น เช่น "startDate=2021-08-01 AND endDate=2021-08-10 ANDMetricType=AGGREGATE_COUNT" และ AGGREGATE_COUNTMetricType จะไม่สนใจส่วน DD ของวันที่ดังกล่าว

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

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

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

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

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

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

object (BusinessCallsInsights)

คอลเล็กชันข้อมูลเชิงลึกเกี่ยวกับการโทรจากธุรกิจในสถานที่ตั้งนั้นๆ
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken เพื่อเรียกดูหน้าถัดไป หากเว้นช่องนี้ไว้ จะไม่มีหน้าต่อมา ประเภทเมตริกบางรายการ (เช่น AGGREGATE_COUNT) แสดงผลหน้าเว็บเดียว สำหรับเมตริกเหล่านี้ nextPageToken จะว่างเปล่า

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

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

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

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

BusinessCallsInsights

ข้อมูลเชิงลึกสำหรับการโทรไปยังสถานที่

การแสดง JSON 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
ช่อง
name

string

ต้องระบุ ชื่อทรัพยากรของข้อมูลเชิงลึกเกี่ยวกับการโทร รูปแบบ: สถานที่/{location}/businesscallsinsights
metricType

enum (MetricType)

เมตริกที่ใช้ค่านี้
aggregateMetrics

object (AggregateMetrics)

เมตริกสำหรับช่วงเวลาตาม startDate และ endDate

MetricType

ประเภทของเมตริก

Enum
METRIC_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทของเมตริก
AGGREGATE_COUNT เมตริกที่ระบุเป็นจำนวนรวมในช่วงเวลาของอินพุต

AggregateMetrics

เมตริกที่รวบรวมในช่วงเวลาที่ป้อน

การแสดง JSON 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
ช่อง
missedCallsCount

integer

จำนวนสายที่ไม่ได้รับทั้งหมด
answeredCallsCount

integer

จำนวนสายที่รับทั้งหมด
hourlyMetrics[]

object (HourlyMetrics)

รายการเมตริกตามชั่วโมงของวัน
weekdayMetrics[]

object (WeekDayMetrics)

รายการเมตริกตามวันในสัปดาห์
startDate

object (Date)

วันที่ของเมตริกนี้ หากเป็นเมตริกรายเดือน จะใช้เพียงปีและเดือนเท่านั้น
endDate

object (Date)

วันที่สิ้นสุดของเมตริกนี้

HourlyMetrics

เมตริกของชั่วโมง

การแสดง JSON 
{
  "hour": integer,
  "missedCallsCount": integer
}
ช่อง
hour

integer

ชั่วโมงของวัน ค่าที่ใช้ได้คือ 0-23
missedCallsCount

integer

จำนวนสายที่ไม่ได้รับทั้งหมดในชั่วโมงนี้

WeekDayMetrics

เมตริกสำหรับวันธรรมดา

การแสดง JSON 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
ช่อง
day

enum (DayOfWeek)

วันของสัปดาห์ ค่าที่ใช้ได้คือวันอาทิตย์ - วันเสาร์
missedCallsCount

integer

จำนวนสายที่ไม่ได้รับทั้งหมดในชั่วโมงนี้

DayOfWeek

แสดงวันของสัปดาห์

Enum
DAY_OF_WEEK_UNSPECIFIED ไม่ได้ระบุวันของสัปดาห์
MONDAY วันจันทร์
TUESDAY วันอังคาร
WEDNESDAY วันพุธ
THURSDAY พฤหัสบดี
FRIDAY วันศุกร์
SATURDAY เสาร์
SUNDAY วันอาทิตย์

วันที่

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

  • วันที่แบบเต็มพร้อมค่าปี เดือน และวันที่ไม่ใช่ 0
  • 1 เดือนและวัน 1 ปี (เช่น วันครบรอบ)
  • 1 ปีเท่านั้น โดยมี 0 เดือนกับ 0 วัน
  • 1 ปีและเดือนที่มีศูนย์วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่ต้องใส่ปี
month

integer

เดือนของปี ค่านี้ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ค่านี้ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ