Method: locations.verify

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

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

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
फ़ील्ड
method

enum (VerificationMethod)

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

string

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

object (ServiceBusinessContext)

ज़रूरी नहीं. सेवा देने वाले कारोबारों की पुष्टि के लिए, संदर्भ से जुड़ी अतिरिक्त जानकारी. यह केवल उन स्थानों के लिए आवश्यक है जिनका व्यवसाय प्रकार CUSTOMER_LOCATION_ONLY है. ADDRESS पुष्टि के लिए, पते का इस्तेमाल पोस्टकार्ड भेजने के लिए किया जाएगा. अन्य तरीकों के लिए, यह वही होना चाहिए जो GetverificationOptions को भेजा गया है. अगर इसे दूसरी तरह की कारोबार की जगहों के लिए सेट किया जाता है, तो INVALID_UA हटा दिया जाएगा.
यूनियन फ़ील्ड RequestData. डिसप्ले डेटा के अलावा, किसी खास तरीके के लिए उपयोगकर्ता का इनपुट डेटा. डेटा, अनुरोध किए गए तरीके से मेल खाना चाहिए. अगर किसी डेटा की ज़रूरत नहीं है, तो इसे खाली छोड़ दें. RequestData इनमें से सिर्फ़ एक हो सकता है:
emailAddress

string

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

किसी ईमेल पते को सिर्फ़ तब स्वीकार किया जाता है, जब वह locations.fetchverificationOptions के ज़रिए दिए गए पतों में से एक हो. अगर [Email verificationData] [google.mybusiness-verifications.v1.verificationOption.Email verificationData] का isUserNameEditable 'सही' पर सेट है. क्लाइंट, कोई अलग उपयोगकर्ता नाम (स्थानीय-पार्ट) तय कर सकता है, लेकिन उसका डोमेन नेम से मेल खाना चाहिए.
mailerContact

string

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

string

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

object (VerificationToken)

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

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

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

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

JSON के काेड में दिखाना 
{
  "verification": {
    object (Verification)
  }
}
फ़ील्ड
verification

object (Verification)

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

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

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

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

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

VerificationToken

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

JSON के काेड में दिखाना 
{
  "tokenString": string
}
फ़ील्ड
tokenString

string

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