- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- วันที่
แสดงข้อมูลเชิงลึกสําหรับการโทรจากธุรกิจสําหรับสถานที่ตั้งหนึ่งๆ
คำขอ HTTP
GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ ตำแหน่งหลักที่จะดึงข้อมูลเชิงลึกเกี่ยวกับการโทร รูปแบบ: สถานที่ตั้ง/{locationId} |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
pageSize |
ไม่บังคับ จำนวนสูงสุดของ BusinessCallsInsights ที่จะแสดงผล หากไม่ระบุ ระบบจะส่งคืนสูงสุด 20 รายการ บางเมตริก_ประเภท(เช่น AGGREGATE_COUNT) แสดงผลหน้าเว็บเดียว สำหรับเมตริกเหล่านี้ ระบบจะไม่สนใจ pageSize |
pageToken |
ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการโทร ขณะใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้ |
filter |
ไม่บังคับ ตัวกรองที่จํากัดข้อมูลเชิงลึกเกี่ยวกับการโทรที่จะแสดง การตอบกลับจะมีเฉพาะรายการที่ตรงกับตัวกรอง หากไม่ได้ระบุ 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 |
โทเค็นที่ส่งเป็น |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/business.manage
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
BusinessCallsInsights
ข้อมูลเชิงลึกสำหรับการโทรไปยังสถานที่
การแสดง JSON |
---|
{ "name": string, "metricType": enum ( |
ช่อง | |
---|---|
name |
ต้องระบุ ชื่อทรัพยากรของข้อมูลเชิงลึกเกี่ยวกับการโทร รูปแบบ: สถานที่/{location}/businesscallsinsights |
metricType |
เมตริกที่ใช้ค่านี้ |
aggregateMetrics |
เมตริกสำหรับช่วงเวลาตาม startDate และ endDate |
MetricType
ประเภทของเมตริก
Enum | |
---|---|
METRIC_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทของเมตริก |
AGGREGATE_COUNT |
เมตริกที่ระบุเป็นจำนวนรวมในช่วงเวลาของอินพุต |
AggregateMetrics
เมตริกที่รวบรวมในช่วงเวลาที่ป้อน
การแสดง JSON |
---|
{ "missedCallsCount": integer, "answeredCallsCount": integer, "hourlyMetrics": [ { object ( |
ช่อง | |
---|---|
missedCallsCount |
จำนวนสายที่ไม่ได้รับทั้งหมด |
answeredCallsCount |
จำนวนสายที่รับทั้งหมด |
hourlyMetrics[] |
รายการเมตริกตามชั่วโมงของวัน |
weekdayMetrics[] |
รายการเมตริกตามวันในสัปดาห์ |
startDate |
วันที่ของเมตริกนี้ หากเป็นเมตริกรายเดือน จะใช้เพียงปีและเดือนเท่านั้น |
endDate |
วันที่สิ้นสุดของเมตริกนี้ |
HourlyMetrics
เมตริกของชั่วโมง
การแสดง JSON |
---|
{ "hour": integer, "missedCallsCount": integer } |
ช่อง | |
---|---|
hour |
ชั่วโมงของวัน ค่าที่ใช้ได้คือ 0-23 |
missedCallsCount |
จำนวนสายที่ไม่ได้รับทั้งหมดในชั่วโมงนี้ |
WeekDayMetrics
เมตริกสำหรับวันธรรมดา
การแสดง JSON |
---|
{
"day": enum ( |
ช่อง | |
---|---|
day |
วันของสัปดาห์ ค่าที่ใช้ได้คือวันอาทิตย์ - วันเสาร์ |
missedCallsCount |
จำนวนสายที่ไม่ได้รับทั้งหมดในชั่วโมงนี้ |
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 |
ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่ต้องใส่ปี |
month |
เดือนของปี ค่านี้ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน |
day |
วันของเดือน ค่านี้ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ |