Method: locations.verify

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
फ़ील्ड
method

enum (VerificationMethod)

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

string

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

object (ServiceBusinessContext)

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

string

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

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

string

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

string

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

object (VerificationToken)

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

string

TRUSTED_PARTNER तरीके के लिए इनपुट. पुष्टि करने वाला टोकन, जो जगह की जानकारी से जुड़ा है.
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

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

Verifications.VerifyLocation के लिए जवाब वाला मैसेज.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "verification": {
    object (Verification)
  }
}
फ़ील्ड
verification

object (Verification)

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

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

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

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

VerificationToken

टोकन को किसी जांचे-परखे पार्टनर ने जनरेट किया हो.

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

string

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