Method: locations.verify

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
name

string

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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 की पुष्टि के लिए, पोस्टकार्ड भेजने के लिए पते का इस्तेमाल किया जाएगा. अन्य विधियों के लिए, यह वही होना चाहिए जिसे getValidateOptions को भेजा गया है. अगर INVALID_IDENTIFIER को कारोबार की दूसरी तरह की जगहों के लिए सेट किया गया है, तो इसे फेंक दिया जाएगा.

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

string

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

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

mailerContact

string

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

phoneNumber

string

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

token

object (VerificationToken)

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

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

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

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

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

object (Verification)

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

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

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

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

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

VerificationToken

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

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

string

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