Package google.mybusiness.businesscalls.v1

इंडेक्स

BusinessCallsService

इस एपीआई की मदद से कारोबार, कारोबार से जुड़े कॉल मैनेज कर सकते हैं. साथ ही, कारोबार की जगह पर आए मिस्ड कॉल की संख्या जैसी अहम जानकारी भी इकट्ठा कर सकते हैं. कारोबार से जुड़े कॉल के बारे में ज़्यादा जानकारी https://support.google.com/business/answer/9688285?p=call_history पर मिल सकती है

अगर Google Business Profile को Google Ads खाते से लिंक किया गया है और कॉल इतिहास की सुविधा चालू है, तो किसी तय समय से ज़्यादा समय तक चलने वाले कॉल और विज्ञापन इंटरैक्शन के लिए एट्रिब्यूट किए जा सकने वाले कॉल, जोड़े गए Google Ads खाते में "विज्ञापन से आने वाले कॉल" कन्वर्ज़न के तहत दिखेंगे. अगर ऑप्टिमाइज़ेशन रणनीति में स्मार्ट बिडिंग और कॉल कन्वर्ज़न का इस्तेमाल किया जाता है, तो विज्ञापन पर खर्च में बदलाव हो सकता है. स्मार्ट बिडिंग के बारे में ज़्यादा जानें."

किसी जगह के कॉल देखने और उन पर कार्रवाइयां करने के लिए, आपको उस जगह का OWNER, CO_OWNER या MANAGER होना चाहिए.

GetBusinessCallsSettings

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

दी गई जगह के लिए, कारोबार की कॉल की सेटिंग के संसाधन दिखाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ListBusinessCallsInsights

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

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

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
UpdateBusinessCallsSettings

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

बताई गई जगह के लिए, Business Profile की कॉल सेटिंग अपडेट करता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

AggregateMetrics

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

फ़ील्ड
missed_calls_count

Int32Value

मिस्ड कॉल की कुल संख्या.
answered_calls_count

Int32Value

जवाब दिए गए कॉल की कुल संख्या.
hourly_metrics[]

HourlyMetrics

दिन के घंटे के हिसाब से मेट्रिक की सूची.
weekday_metrics[]

WeekDayMetrics

हफ़्ते के दिन के हिसाब से मेट्रिक की सूची.
start_date

Date

इस मेट्रिक के लिए तारीख. अगर मेट्रिक महीने के हिसाब से है, तो सिर्फ़ साल और महीने का इस्तेमाल किया जाता है.
end_date

Date

इस मेट्रिक के खत्म होने की तारीख.

BusinessCallsInsights

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

फ़ील्ड
name

string

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

MetricType

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

AggregateMetrics

start_date और end_date के आधार पर समयसीमा के लिए मेट्रिक.

BusinessCallsSettings

किसी जगह के लिए कारोबार को कॉल करने की सेटिंग.

फ़ील्ड
name

string

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

CallsState

ज़रूरी है. बिज़नेस कॉल में इस जगह के रजिस्टर किए जाने की स्थिति.
consent_time

Timestamp

सिर्फ़ इनपुट. वह समय जब असली उपयोगकर्ता ने एपीआई के उपयोगकर्ता को कारोबार की कॉल की सुविधा चालू करने के लिए सहमति दी थी.

CallsState

बिज़नेस कॉल में किसी जगह की संभावित स्थितियां. स्थितियों को सिर्फ़ 'चालू है' या 'बंद है' पर अपडेट किया जा सकता है. किसी अन्य डेटा का इस्तेमाल करने पर, PREDATE_FAILED गड़बड़ी दिखेगी.

Enums
CALLS_STATE_UNSPECIFIED नहीं बताया गया है
ENABLED जगह के लिए कारोबार कॉल की सुविधा चालू है.
DISABLED इस जगह के लिए, कारोबार से जुड़े कॉल की सुविधा बंद है.

ErrorCode

अंदरूनी गड़बड़ियों के लिए गड़बड़ी कोड.

Enums
ERROR_CODE_UNSPECIFIED अनजान गड़बड़ी कोड.
ERROR_CODE_UNVERIFIED_LOCATION जगह की पुष्टि नहीं हुई है.
ERROR_CODE_CALLS_NOT_ENABLED जगह के लिए कारोबार के कॉल की स्थिति 'चालू है' पर सेट नहीं है.
ERROR_CODE_NOT_ELIGIBLE_LOCATION इस जगह पर कारोबार से कॉल नहीं किए जा सकते.

GetBusinessCallsSettingsRequest

getBusinessCallsSettings के लिए मैसेज का अनुरोध करें.

फ़ील्ड
name

string

ज़रूरी है. BusinessCallsSettings में जाकर, यह काम करें.

name फ़ील्ड का इस्तेमाल, कारोबार के लिए ऐसी कॉल सेटिंग की पहचान करने के लिए किया जाता है जिन्हें पाना है. फ़ॉर्मैट: locations/{location_id}/businesscallssettings.

HourlyMetrics

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

फ़ील्ड
hour

Int32Value

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

Int32Value

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

ListBusinessCallsInsightsRequest

ListBusinessCallsInsights के लिए मैसेज का अनुरोध करें.

फ़ील्ड
parent

string

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

int32

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

string

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

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

string

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

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

फ़िलहाल, हम इन फ़िल्टर के साथ काम करते हैं. 1. start_date="DATE" जहां तारीख YYYY-MM-DD फ़ॉर्मैट में है. 2. end_date="DATE" जहां तारीख YYYY-MM-DD फ़ॉर्मैट में होती है. 3. metric_type=XYZ में XYZ एक मान्य MetricType है. 4. ऊपर दिए गए सभी हिस्सों(AND) को जोड़ने पर. जैसे, "start_date=2021-08-01 AND end_date=2021-08-10 ANDmetric_type=AGGREGATE_COUNT" AGGREGATE_COUNT मेट्रिक_type, तारीख के DD वाले हिस्से को अनदेखा करता है.

ListBusinessCallsInsightsResponse

ListBusinessCallsInsights के जवाब वाला मैसेज.

फ़ील्ड
business_calls_insights[]

BusinessCallsInsights

किसी जगह के लिए कारोबार कॉल की अहम जानकारी का कलेक्शन.
next_page_token

string

एक टोकन, जिसे अगला पेज पाने के लिए page_token के तौर पर भेजा जा सकता है. अगर यह फ़ील्ड छोड़ दिया जाता है, तो इसके बाद कोई पेज नहीं होगा. कुछ मेट्रिक_टाइप (जैसे, AGGREGATE_COUNT) एक पेज दिखाते हैं. इन मेट्रिक के लिए, Next_page_token खाली होगा.

MetricType

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

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

UpdateBusinessCallsSettingsRequest

UpdateBusinessCallsSettings के अनुरोध का मैसेज.

फ़ील्ड
business_calls_settings

BusinessCallsSettings

ज़रूरी है. अपडेट करने के लिए BusinessCallsSettings.

name फ़ील्ड का इस्तेमाल, कारोबार की कॉल की उन सेटिंग की पहचान करने के लिए किया जाता है जिन्हें अपडेट करना है. फ़ॉर्मैट: locations/{location_id}/businesscallssettings
update_mask

FieldMask

ज़रूरी है. अपडेट किए जाने वाले फ़ील्ड की सूची.

WeekDayMetrics

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

फ़ील्ड
day

DayOfWeek

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

Int32Value

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