Package google.mybusiness.verifications.v1

इंडेक्स

पुष्टि से जुड़े दस्तावेज़

यह एपीआई, Google पर जगह की जानकारी की पुष्टि को मैनेज करने की अनुमति देता है. इसकी मदद से, [पुष्टि] [google.mybusiness.v1.verification] संसाधनों को मैनेज किया जा सकता है.

हर [जगह] [google.mybusiness.businessinformation.locations.v1.Location] के पास, [पुष्टि करने वाले] [google.mybusiness.verifications] संसाधनों का एक कलेक्शन है. इनका नाम locations/*/verifications/* है.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

PENDING की मदद से खाते की पुष्टि की जाती है.

यह सिर्फ़ गैर AUTO पुष्टि के तरीकों के लिए ज़रूरी है. पुष्टि करने का AUTO अनुरोध तुरंत VERIFIED हो जाता है.

अनुमति देने के दायरे

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

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

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

FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

किसी खास भाषा में, जगह की पुष्टि करने के सभी ज़रूरी विकल्पों के बारे में रिपोर्ट करता है.

अनुमति देने के दायरे

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

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

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

ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

बनाने के समय के हिसाब से क्रम में, किसी जगह की पुष्टि की सूची बनाएं.

अनुमति देने के दायरे

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

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

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

VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

किसी जगह की पुष्टि करने की प्रोसेस शुरू करता है.

अनुमति देने के दायरे

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

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

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

VoiceOfMerchant

इस सेवा की मदद से, 3P (तीसरे पक्ष का) इस्तेमाल करने वाले लोग, व्यापारी/कंपनी/कारोबारी की स्थिति के बारे में जानकारी पाने का अनुरोध कर सकते हैं.

GetVoiceOfMerchantState

rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState)

VoiceOfMerchant के स्टेटस की जानकारी देता है.

अनुमति देने के दायरे

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

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

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

CompleteVerificationRequest

पुष्टि करने के लिए अनुरोध का मैसेज.Complete VerificationAction.

फ़ील्ड
name

string

ज़रूरी है. पुष्टि करने के लिए संसाधन का नाम.

pin

string

ज़रूरी है. पुष्टि के लिए, कारोबारी को मिला पिन कोड.

CompleteVerificationResponse

पुष्टि करने के लिए जवाब देने वाला मैसेज.completeverificationAction.

फ़ील्ड
verification

Verification

पुष्टि की प्रोसेस पूरी हो चुकी है.

ComplyWithGuidelines

इससे पता चलता है कि कोई जगह हमारे दिशा-निर्देशों का पालन नहीं कर रही.

फ़ील्ड
recommendation_reason

RecommendationReason

दिशा-निर्देशों का पालन करने के लिए, जगह की जानकारी का सुझाव देने की वजह.

RecommendationReason

इससे पता चलता है कि उस जगह की जानकारी को ComplyWithGuidelines के साथ क्यों सुझाया गया था.

Enums
RECOMMENDATION_REASON_UNSPECIFIED जानकारी नहीं दी गई.
BUSINESS_LOCATION_SUSPENDED कारोबार की जगह की जानकारी निलंबित कर दी गई है. इस समस्या को ठीक करने के लिए, सहायता केंद्र का लेख पढ़ें.
BUSINESS_LOCATION_DISABLED कारोबार की जगह की जानकारी बंद है. इस समस्या को ठीक करने के लिए, सहायता केंद्र का लेख पढ़ें.

FetchVerificationOptionsRequest

पुष्टि करने के लिए अनुरोध का मैसेज.

फ़ील्ड
location

string

ज़रूरी है. पुष्टि की जाने वाली जगह.

language_code

string

ज़रूरी है. BCP 47 भाषा कोड, उस भाषा को दिखाता है जिसका इस्तेमाल पुष्टि की प्रक्रिया के लिए किया जाना है. भाषा के हिसाब से, उपलब्ध विकल्प अलग-अलग हो सकते हैं.

context

ServiceBusinessContext

ज़रूरी नहीं. सेवा देने वाले कारोबारों की पुष्टि के लिए, ज़्यादा जानकारी. केवल उन स्थानों पर लागू किया जा सकता है जिनका व्यवसाय प्रकार CUSTOMER_LOCATION_ONLY है. सटीक पता डालने से, ज़्यादा विकल्प चालू किए जा सकते हैं. अगर INVALID_IDENTIFIER को कारोबार के अन्य टाइप की जगहों के लिए सेट किया गया है, तो इसे फेंक दिया जाएगा.

FetchVerificationOptionsResponse

पुष्टि करने के लिए जवाब मैसेज.

फ़ील्ड
options[]

VerificationOption

पुष्टि करने के लिए उपलब्ध विकल्प.

GetVoiceOfMerchantStateRequest

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

फ़ील्ड
name

string

ज़रूरी है. जगह के संसाधन का नाम.

ListVerificationsRequest

पुष्टि करने के लिए अनुरोध का मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. उस जगह के संसाधन का नाम जिससे पुष्टि का अनुरोध किया जाता है.

page_size

int32

हर पेज पर, पुष्टि करने की संख्या की कितनी जानकारी शामिल करनी है. यह संख्या कम से कम 1 हो सकती है. इसके अलावा, डिफ़ॉल्ट और ज़्यादा से ज़्यादा पेज का साइज़ 100 से ज़्यादा नहीं होना चाहिए.

page_token

string

अगर तय किया गया है, तो पुष्टि का अगला पेज दिखाता है.

ListVerificationsResponse

पुष्टि करने के लिए जवाब का मैसेज.

फ़ील्ड
verifications[]

Verification

पुष्टि की सूची.

next_page_token

string

अगर पुष्टि की संख्या, अनुरोध किए गए पेज के साइज़ से ज़्यादा हो जाती है, तो इस फ़ील्ड को एक टोकन से भर दिया जाएगा. ऐसा, बाद के कॉल में पुष्टि के अगले पेज को फ़ेच करने के लिए किया जाएगा. अगर कोई एट्रिब्यूट नहीं है, तो जवाब में यह फ़ील्ड मौजूद नहीं होगा.

ResolveOwnershipConflict

इस टाइप के लिए कोई फ़ील्ड नहीं है.

यह बताता है कि जगह अच्छी स्थिति में मौजूद किसी दूसरे जगह का डुप्लीकेट है.

ServiceBusinessContext

सेवा कारोबार की पुष्टि के लिए अतिरिक्त डेटा.

फ़ील्ड
address

PostalAddress

कारोबार की जगह की पुष्टि करने का पता. इसका इस्तेमाल, पुष्टि करने के ज़्यादा विकल्प चालू करने या पोस्टकार्ड भेजने के लिए किया जाता है.

पुष्टि करने का तरीका

पुष्टि, किसी जगह पर पुष्टि करने की कोशिश को दिखाती है.

फ़ील्ड
name

string

पुष्टि करने के लिए इस्तेमाल किए जाने वाले संसाधन का नाम.

method

VerificationMethod

पुष्टि करने का तरीका.

state

State

पुष्टि की स्थिति.

create_time

Timestamp

पुष्टि का अनुरोध करने का टाइमस्टैंप.

announcement

string

ज़रूरी नहीं. जवाब का एलान सिर्फ़ तब सेट किया जाता है, जब तरीका VETTED_PARTNER है.

स्थिति

पुष्टि की सभी संभावित स्थितियां.

Enums
STATE_UNSPECIFIED डिफ़ॉल्ट वैल्यू सेट करने पर गड़बड़ियां होंगी.
PENDING पुष्टि होनी बाकी है.
COMPLETED पुष्टि की प्रक्रिया पूरी हो गई है.
FAILED पुष्टि नहीं हो सकी.

VerificationMethod

उन प्रक्रियाओं के बारे में बताता है जिनका इस्तेमाल Google किसी जगह की पुष्टि करने के लिए करता है.

Enums
VERIFICATION_METHOD_UNSPECIFIED डिफ़ॉल्ट वैल्यू सेट करने पर गड़बड़ियां होंगी.
ADDRESS किसी खास डाक पते पर पुष्टि पिन वाला पोस्टकार्ड भेजें. पिन का इस्तेमाल, Google पर अपनी पहचान की पुष्टि करने के लिए किया जाता है.
EMAIL किसी खास ईमेल पते पर, पुष्टि करने के लिए पिन वाला ईमेल भेजें. पिन का इस्तेमाल, Google पर अपनी पहचान की पुष्टि करने के लिए किया जाता है.
PHONE_CALL पुष्टि करने के लिए पिन का इस्तेमाल करके, किसी खास फ़ोन नंबर पर कॉल करें. पिन का इस्तेमाल, Google पर अपनी पहचान की पुष्टि करने के लिए किया जाता है.
SMS किसी खास फ़ोन नंबर पर पुष्टि करने के लिए पिन के साथ एसएमएस भेजें. पिन का इस्तेमाल, Google पर अपनी पहचान की पुष्टि करने के लिए किया जाता है.
AUTO अतिरिक्त उपयोगकर्ता कार्रवाई के बिना ही, जगह की पुष्टि करें. ऐसा हो सकता है कि यह विकल्प सभी जगहों के लिए उपलब्ध न हो.
VETTED_PARTNER ऐसा हो सकता है कि यह विकल्प सभी जगहों के लिए उपलब्ध न हो.

VerificationOption

पुष्टि करने के विकल्प से यह पता चलता है कि जगह की पुष्टि कैसे करनी है (पुष्टि करने के तरीके में बताया गया है) और पुष्टि कहां भेजी जाएगी (जो डिसप्ले डेटा से दिखाया जाता है).

फ़ील्ड
verification_method

VerificationMethod

जगह की पुष्टि करने का तरीका.

यूनियन फ़ील्ड DisplayData. डिसप्ले डेटा में से कोई एक. डेटा इस तरीके से मेल खाना चाहिए. अगर संबंधित तरीके में कोई डिसप्ले डेटा नहीं है, तो यह फ़ील्ड खाली होता है. DisplayData इनमें से सिर्फ़ एक हो सकता है:
phone_number

string

सिर्फ़ तब सेट करें, जब तरीका PHONE_CALL या एसएमएस हो. वह फ़ोन नंबर जिस पर पिन भेजा जाएगा.

address_data

AddressVerificationData

सिर्फ़ तभी सेट करें, जब तरीका mail हो.

email_data

EmailVerificationData

सिर्फ़ तब सेट करें, जब तरीका EMAIL हो.

announcement

string

सिर्फ़ तब सेट करें, जब तरीका VETTED_PARTNER हो.

AddressVerificationData

पोस्टकार्ड की मदद से, पुष्टि करने से जुड़ा डेटा दिखाएं.

फ़ील्ड
business

string

व्यापारी/कंपनी के कारोबार का नाम.

address

PostalAddress

वह पता जिस पर पोस्टकार्ड भेजा जा सकता है.

expected_delivery_days_region

int32

पते के इलाके में पोस्टकार्ड डिलीवर करने में लगने वाले दिनों की संख्या.

EmailVerificationData

ईमेल से पुष्टि करने के लिए डेटा दिखाएं.

फ़ील्ड
domain

string

ईमेल पते में दिया गया डोमेन नेम. जैसे, foo@gmail.com में "gmail.com"

user

string

ईमेल पते में उपयोगकर्ता का नाम. जैसे कि foo@gmail.com में "foo"

is_user_name_editable

bool

क्लाइंट को कोई दूसरा उपयोगकर्ता नाम देने की अनुमति है या नहीं.

VerificationToken

जांच किए गए पार्टनर ने जनरेट किया है.

फ़ील्ड
token_string

string

टोकन स्ट्रिंग.

पुष्टि करें

इससे पता चलता है कि जगह की जानकारी की पुष्टि करना ज़रूरी है. इसमें किसी जगह पर पुष्टि की मौजूदा कार्रवाइयों के बारे में जानकारी होती है.

फ़ील्ड
has_pending_verification

bool

इससे पता चलता है कि क्या पुष्टि की प्रक्रिया शुरू हो गई है और जगह के हिसाब से उसे पूरा किया जा सकता है.

VerifyLocationRequest

पुष्टि करने की जगह की जानकारी की पुष्टि करने के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

ज़रूरी है. पुष्टि करने के लिए, जगह के संसाधन का नाम.

method

VerificationMethod

ज़रूरी है. पुष्टि का तरीका.

language_code

string

ज़रूरी नहीं. BCP 47 भाषा कोड, उस भाषा को दिखाता है जिसका इस्तेमाल पुष्टि की प्रक्रिया के लिए किया जाना है.

context

ServiceBusinessContext

ज़रूरी नहीं. सेवा देने वाले कारोबारों की पुष्टि के लिए, ज़्यादा जानकारी. यह सिर्फ़ उन जगहों के लिए ज़रूरी है जिनका कारोबार CUSTOMER_LOCATION_ONLY है. ADDRESS की पुष्टि के लिए, पोस्टकार्ड भेजने के लिए पते का इस्तेमाल किया जाएगा. अन्य विधियों के लिए, यह वही होना चाहिए जिसे getValidateOptions को भेजा गया है. अगर INVALID_IDENTIFIER को कारोबार की दूसरी तरह की जगहों के लिए सेट किया गया है, तो इसे फेंक दिया जाएगा.

यूनियन फ़ील्ड RequestData. डिसप्ले डेटा के अलावा, किसी खास तरीके के लिए उपयोगकर्ता का इनपुट डेटा. डेटा, अनुरोध किए गए तरीके से मेल खाना चाहिए. अगर डेटा की ज़रूरत नहीं है, तो इसे खाली छोड़ दें. RequestData इनमें से सिर्फ़ एक हो सकता है:
email_address

string

ज़रूरी नहीं. EMAIL तरीके का इनपुट. वह ईमेल पता जिस पर पिन भेजा जाना चाहिए.

ईमेल पता सिर्फ़ तभी स्वीकार किया जाता है, जब वह फ़ीड पुष्टि विकल्प से मिले पते में से कोई एक हो. अगर [Email [

mailer_contact

string

ज़रूरी नहीं. ADDRESS तरीके का इनपुट. वह संपर्क नाम जिस पर मेल भेजा जाना चाहिए.

phone_number

string

ज़रूरी नहीं. PHONE_CALL/SMS विधि के लिए इनपुट वह फ़ोन नंबर जिस पर कॉल किया जाना चाहिए या जिस पर SMS भेजा जाना चाहिए. यह ज़रूरी शर्तें पूरी करने वाले विकल्पों में से एक फ़ोन नंबर होना चाहिए.

token

VerificationToken

ज़रूरी नहीं. चुनिंदा partners. के लिए उपलब्ध VETTED_PARTNER तरीके का इनपुट. जांचे गए खाते के लिए इनपुट की ज़रूरत नहीं है. जगह से जुड़ा टोकन. जगह से जुड़ा टोकन.

VerifyLocationResponse

पुष्टि करने की जगह की जानकारी की पुष्टि करने के लिए जवाब का मैसेज.

फ़ील्ड
verification

Verification

पुष्टि करने के लिए किया गया अनुरोध.

VoiceOfMerchantState

VoiceOfMerchant.GetVoiceOfMerchantState के लिए रिस्पॉन्स मैसेज.

फ़ील्ड
has_voice_of_merchant

bool

इससे पता चलता है कि जगह की जानकारी अच्छी स्थिति में है या नहीं. साथ ही, यह भी पता चलता है कि उसका Google पर कारोबार को कंट्रोल किया जा रहा है या नहीं. समीक्षा के चरण में पास होने के बाद, जगह की जानकारी में किया गया कोई भी बदलाव Maps पर भी लागू हो जाएगा.

has_business_authority

bool

इससे पता चलता है कि Google पर मौजूद कारोबार पर, जगह का अधिकार (मालिकाना हक) है या नहीं. अगर यह सही है, तो कोई दूसरी जगह उसे कैप्चर नहीं कर सकती और Maps पर उसकी मुख्य लिस्टिंग नहीं बन सकती. हालांकि, बदलाव तब तक लाइव नहीं होंगे, जब तक कि वॉइस ऑफ़ व्यापारी या कंपनी की आवाज़ नहीं सुनाई देती (जैसे,has_voice_of_merchant' सही हो).

यूनियन फ़ील्ड gain_voice_of_merchant_action. Google पर कारोबार को कंट्रोल करने के लिए, कारोबार की जगह के लिए कार्रवाई का सुझाव दिया जाता है. gain_voice_of_merchant_action इनमें से सिर्फ़ एक हो सकता है:
wait_for_voice_of_merchant

WaitForVoiceOfMerchant

'व्यापारी/कंपनी की आवाज़' का इंतज़ार करें. क्वालिटी के लिए, जगह की समीक्षा की जा रही है.

verify

Verify

पुष्टि की प्रक्रिया शुरू करें या जारी रखें.

resolve_ownership_conflict

ResolveOwnershipConflict

यह जगह अच्छी स्थिति में मौजूद किसी दूसरी जगह का डुप्लीकेट है. अगर आपके पास उस जगह का ऐक्सेस अच्छी स्थिति में है, तो कार्रवाइयां करने के लिए उस जगह के आईडी का इस्तेमाल करें. अगर ऐसा नहीं है, तो मौजूदा मालिक से ऐक्सेस मांगें.

comply_with_guidelines

ComplyWithGuidelines

जगह की जानकारी हमारे दिशा-निर्देशों के मुताबिक नहीं है. प्रोफ़ाइल को बहाल करने के लिए, कुछ और कार्रवाइयां करनी होंगी. इस समस्या को ठीक करने के लिए, सहायता केंद्र का लेख पढ़ें.

WaitForVoiceOfMerchant

इस टाइप के लिए कोई फ़ील्ड नहीं है.

इससे पता चलता है कि समीक्षा पास करने पर, कारोबार की जगह की जानकारी को कारोबारी का सुझाव मिलेगा.