- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- तारीख
किसी जगह के लिए कारोबार से जुड़े कॉल की अहम जानकारी दिखाता है.
एचटीटीपी अनुरोध
GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. वह पैरंट जगह जिसके लिए कॉल की अहम जानकारी फ़ेच करनी है. फ़ॉर्मैट: जगहें/{locationId} |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
ज़रूरी नहीं. ज़्यादा से ज़्यादा BusinessCallsInsights वापस चाहिए. अगर जानकारी नहीं दी गई है, तो ज़्यादा से ज़्यादा 20 वैल्यू दिखाई जाएंगी. कुछ मेट्रिक_types(उदाहरण के लिए, AGGREGATE_COUNT) सिर्फ़ एक पेज दिखाते हैं. इन मेट्रिक के लिए, pageSize को अनदेखा कर दिया जाता है. |
pageToken |
ज़रूरी नहीं. पिछले पेजों पर नंबर डालते समय, |
filter |
ज़रूरी नहीं. फ़िल्टर, जो नतीजे पाने के लिए कॉल की अहम जानकारी को सीमित करता है. इस जवाब में सिर्फ़ फ़िल्टर से मेल खाने वाली एंट्री शामिल होती हैं. अगर 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 |
एक टोकन, जिसे अगला पेज फिर से पाने के लिए |
अनुमति पाने के लिंक
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/business.manage
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
BusinessCallsInsights
किसी जगह पर किए गए कॉल की अहम जानकारी.
JSON के काेड में दिखाना |
---|
{ "name": string, "metricType": enum ( |
फ़ील्ड | |
---|---|
name |
ज़रूरी है. कॉल इनसाइट के संसाधन का नाम. फ़ॉर्मैट: locations/{location}/businesscallsinsights |
metricType |
वह मेट्रिक जिसके लिए वैल्यू लागू होती है. |
aggregateMetrics |
startDate और endDate के आधार पर समय सीमा की मेट्रिक. |
MetricType
मेट्रिक का टाइप.
Enums | |
---|---|
METRIC_TYPE_UNSPECIFIED |
यह नहीं बताया गया है कि मेट्रिक किस तरह की है. |
AGGREGATE_COUNT |
दी गई मेट्रिक की संख्या, इनपुट time_range के हिसाब से एग्रीगेट की जाती है. |
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
हफ़्ते का कोई दिन दिखाता है.
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 |
तारीख का साल. 1 से 9999 के बीच की संख्या होनी चाहिए, या बिना साल वाली तारीख को बताने के लिए 0 होना चाहिए. |
month |
साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर किसी साल में महीना और दिन नहीं है, तो उस साल की जानकारी देने के लिए यह संख्या 0 होनी चाहिए. |
day |
महीने का दिन. इसमें 1 से 31 तक का अंतर हो सकता है. साथ ही, यह साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, किसी साल के बारे में बताने के लिए, वैल्यू 0 होनी चाहिए या साल और महीने के बीच की कोई खास जानकारी नहीं होनी चाहिए. |