Method: locations.businesscallsinsights.list

इससे आपको किसी जगह के कारोबार से जुड़े कॉल की अहम जानकारी मिलती है.

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. पैरंट की जगह, जिसके लिए कॉल की अहम जानकारी फ़ेच करनी है. फ़ॉर्मैट: locations/{locationId}

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

ज़रूरी नहीं. लौटाने के लिए BusinessCallsInsights की ज़्यादा से ज़्यादा संख्या. अगर कोई जानकारी नहीं दी गई है, तो ज़्यादा से ज़्यादा 20 पेज दिखाए जाएंगे. कुछ मेट्रिक_टाइप(जैसे, AGGREGATE_COUNT) एक पेज दिखाते हैं. इन मेट्रिक के लिए, pageSize को अनदेखा कर दिया जाता है.
pageToken

string

ज़रूरी नहीं. पिछले businesscallsinsights.list कॉल से मिला पेज टोकन. अगला पेज वापस पाने के लिए यह विकल्प दें.

पेजों को पेजों में जोड़ते समय, businesscallsinsights.list को दिए गए अन्य सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जिससे पेज टोकन दिया गया था. कुछ मेट्रिक_टाइप (जैसे, AGGREGATE_COUNT) एक पेज दिखाते हैं. इन मेट्रिक के लिए, pake_token को अनदेखा कर दिया जाता है.
filter

string

ज़रूरी नहीं. एक फ़िल्टर, जो वापस आने के लिए कॉल इनसाइट को सीमित करता है. जवाब में सिर्फ़ फ़िल्टर से मेल खाने वाली एंट्री शामिल होती हैं.

अगर मेट्रिक टाइप नहीं दिया गया है, तो AGGREGATE_COUNT दिखाया जाता है. अगर कोई endDate नहीं दिया गया है, तो उपलब्ध होने की आखिरी तारीख का इस्तेमाल किया जाता है. अगर शुरू होने की तारीख नहीं दी गई है, तो हम डेटा उपलब्ध होने की पहली तारीख को डिफ़ॉल्ट रूप से सेट कर देंगे. फ़िलहाल, यह छह महीने की तारीख है. अगर 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 AND MetricsType=AGGREGATE_COUNT" AGGREGATE_COUNT मेट्रिक टाइप, तारीख के DD वाले हिस्से को अनदेखा करता है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

businesscallsinsights.list के लिए जवाब वाला मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "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

किसी जगह पर किए गए कॉल की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
फ़ील्ड
name

string

ज़रूरी है. कॉल की अहम जानकारी के संसाधन का नाम. फ़ॉर्मैट: locations/{location}/businesscallsinsights
metricType

enum (MetricType)

वह मेट्रिक जिसके लिए वैल्यू लागू होती है.
aggregateMetrics

object (AggregateMetrics)

शुरू होने की तारीख और खत्म होने की तारीख के आधार पर समय सीमा के लिए मेट्रिक.

MetricType

मेट्रिक का टाइप.

Enums
METRIC_TYPE_UNSPECIFIED मेट्रिक किस तरह की है, इसकी जानकारी नहीं है.
AGGREGATE_COUNT दी गई मेट्रिक, इनपुट टाइम_रेंज के हिसाब से एग्रीगेट की गई गिनती हैं.

AggregateMetrics

इनपुट की समयसीमा के दौरान एग्रीगेट की गई मेट्रिक.

जेएसओएन के काेड में दिखाना 
{
  "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

एक घंटे के लिए मेट्रिक.

जेएसओएन के काेड में दिखाना 
{
  "hour": integer,
  "missedCallsCount": integer
}
फ़ील्ड
hour

integer

दिन का समय. वैल्यू, 0 से 23 के बीच की होनी चाहिए.
missedCallsCount

integer

इस घंटे में मिले मिस्ड कॉल की कुल संख्या.

WeekDayMetrics

एक हफ़्ते के लिए मेट्रिक.

जेएसओएन के काेड में दिखाना 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
फ़ील्ड
day

enum (DayOfWeek)

हफ़्ते का दिन. रविवार से शनिवार के लिए वैल्यू सेट की जा सकती हैं.
missedCallsCount

integer

इस घंटे में मिले मिस्ड कॉल की कुल संख्या.

DayOfWeek

हफ़्ते का कोई दिन दिखाता है.

Enums
DAY_OF_WEEK_UNSPECIFIED हफ़्ते का दिन नहीं बताया गया है.
MONDAY सोमवार
TUESDAY मंगलवार
WEDNESDAY बुधवार
THURSDAY गुरुवार
FRIDAY शुक्रवार
SATURDAY शनिवार
SUNDAY रविवार

तारीख

कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन या तो किसी दूसरी जगह पर बताया गया है या बहुत कम है. तारीख ग्रिगॉरियन कैलेंडर के हिसाब से है. यह इनमें से किसी एक चीज़ को दिखा सकता है:

  • साल, महीने, और दिन की वैल्यू के साथ पूरी तारीख डालें
  • बिना साल वाला महीना और दिन (जैसे, सालगिरह)
  • अपने दम पर एक साल, जिसमें शून्य महीना और शून्य दिन है
  • साल और महीना, जिसमें कोई दिन न हो (उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख)

मिलते-जुलते टाइप: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

जेएसओएन के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. 1 से 9999 के बीच होना चाहिए या बिना साल वाली तारीख बताने के लिए 0 होना चाहिए.
month

integer

साल का महीना. बिना महीना और दिन के किसी साल के बारे में बताने के लिए, यह 1 से 12 के बीच होना चाहिए या 0 होना चाहिए.
day

integer

महीने का दिन. 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए या खुद में किसी साल या किसी साल और महीने के बारे में बताने के लिए 0 मान्य होना चाहिए, जिसमें दिन अहम नहीं होता है.