Method: locations.businesscallsinsights.list

किसी जगह के लिए कारोबार से जुड़े कॉल की अहम जानकारी दिखाता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

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

पैरामीटर
pageSize

integer

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

pageToken

string

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

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

filter

string

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

अगर MetricType नहीं दिया गया है, तो AGGREGATE_COUNT लौटाया जाता है. अगर खत्म होने की तारीख नहीं दी गई है, तो उस आखिरी तारीख का इस्तेमाल किया जाता है जिसके लिए डेटा उपलब्ध था. अगर startDate नहीं दी जाती है, तो हम डिफ़ॉल्ट रूप से डेटा उपलब्ध होने की पहली तारीख पर सेट कर देंगे, जो कि फ़िलहाल छह महीने की है. अगर StartDate, डेटा उपलब्ध होने की तारीख से पहले की है, तो डेटा उपलब्ध होने की तारीख से ही दिखाया जाता है.

फ़िलहाल, इन फ़िल्टर का इस्तेमाल किया जा सकता है. 1. startDate="DATE" जहां तारीख YYYY-MM-DD फ़ॉर्मैट में हो. 2. endDate="DATE" जहां तारीख YYYY-MM-DD फ़ॉर्मैट में हो. 3. metricType=XYZ, जहां XYZ एक मान्य MetricType है. 4. ऊपर दिए गए सभी उदाहरणों के समुच्चय(AND). उदाहरण, "startDate=08-01-2021 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 के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को हटा दिया जाता है, तो इसके बाद कोई पेज नहीं होता. कुछ मेट्रिक_type (जैसे, 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

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

metricType

enum (MetricType)

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

aggregateMetrics

object (AggregateMetrics)

startDate और endDate के आधार पर समय सीमा की मेट्रिक.

MetricType

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

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

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

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

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

तारीख

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

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

मिलते-जुलते टाइप: * 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 होनी चाहिए या साल और महीने के बीच की कोई खास जानकारी नहीं होनी चाहिए.