Method: accounts.locations.verify

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

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

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

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

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

  // Union field RequestData can be only one of the following:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
फ़ील्ड
method

enum (VerificationMethod)

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

string

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

object (ServiceBusinessContext)

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

object (EmailInput)

EMAIL तरीके का इनपुट.
addressInput

object (AddressInput)

ADDRESS तरीके का इनपुट.
phoneInput

object (PhoneInput)

PHONE_CALL/SMS तरीके के लिए इनपुट

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

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

Verifications.VerifyLocation के लिए रिस्पॉन्स मैसेज.

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

object (Verification)

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

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

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

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

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

EmailInput

ईमेल पते की पुष्टि के लिए इनपुट.

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

string

वह ईमेल पता जिस पर पिन भेजा जाना है.

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

AddressInput

पते की पुष्टि के लिए इनपुट.

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

string

उस संपर्क का नाम जिसे ईमेल भेजना है.

PhoneInput

PHONE_CALL/एसएमएस से पुष्टि करने के लिए इनपुट.

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

string

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