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 है. ADDRESS पुष्टि के लिए, पते का इस्तेमाल पोस्टकार्ड भेजने के लिए किया जाएगा. अन्य विधियों के लिए, यह उसी के जैसा होना चाहिए जिसे locations.{9/}VerifyOptions में पास किया गया है. अगर इसे दूसरी तरह की कारोबार की जगहों के लिए सेट किया जाता है, तो INVALID_UA हटा दिया जाएगा.
यूनियन फ़ील्ड RequestData. डिसप्ले डेटा के अलावा, किसी खास तरीके के लिए उपयोगकर्ता का इनपुट डेटा. डेटा, अनुरोध किए गए तरीके से मेल खाना चाहिए. अगर किसी डेटा की ज़रूरत नहीं है, तो इसे खाली छोड़ दें. RequestData इनमें से सिर्फ़ एक हो सकता है:
emailInput

object (EmailInput)

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

object (AddressInput)

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

object (PhoneInput)

PHONE_CALL/SMS विधि के लिए इनपुट

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

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

पुष्टि के लिए जवाब का मैसेज.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

EMAIL सत्यापन के लिए इनपुट.

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

string

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

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

AddressInput

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

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

string

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

PhoneInput

PHONE_CALL/SMS पुष्टि के लिए इनपुट.

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

string

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