Method: locations.verify

Bir konum için doğrulama sürecini başlatır.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Doğrulanacak konumun kaynak adı.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
method

enum (VerificationMethod)

Zorunlu. Doğrulama yöntemi.
languageCode

string

İsteğe bağlı. Doğrulama sürecinde kullanılacak dili temsil eden BCP 47 dil kodu.
context

object (ServiceBusinessContext)

İsteğe bağlı. Hizmet işletmelerinin doğrulanması için ek bağlam bilgileri. Yalnızca işletme türü CUSTOMER_LOCATION_ONLY olan konumlar için gereklidir. ADRES doğrulaması için adres, kartpostal göndermek amacıyla kullanılır. Diğer yöntemler için GetVerificationOptions'a iletilenle aynı olmalıdır. Diğer işletme konumu türleri için ayarlanırsa INVALID_ARGUMENT hatası verilir.
Görüntüleme verilerine ek olarak belirli bir yöntem için kullanıcı giriş verileri. Veriler, istenen yöntemle eşleşmelidir. Veri gerekmiyorsa boş bırakın. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
emailAddress

string

İsteğe bağlı. EMAIL yöntemi için giriş. PIN'in gönderileceği e-posta adresi.

E-posta adresleri yalnızca locations.fetchVerificationOptions tarafından sağlanan adreslerden biriyse kabul edilir. [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] öğesinde isUserNameEditable değeri "true" olarak ayarlanmışsa istemci farklı bir kullanıcı adı (yerel kısım) belirtebilir ancak alan adı eşleşmelidir.
mailerContact

string

İsteğe bağlı. ADDRESS yöntemi için giriş. Postanın gönderileceği kişinin adı.
phoneNumber

string

İsteğe bağlı. PHONE_CALL/SMS yöntemi için giriş. Aranması veya SMS gönderilmesi gereken telefon numarası. Uygun seçeneklerdeki telefon numaralarından biri olmalıdır.
token

object (VerificationToken)

İsteğe bağlı. VETTED_PARTNER yöntemi için giriş, belirli iş ortakları tarafından kullanılabilir. İncelenen hesaplar için giriş yapılması gerekmez. Konumla ilişkili jeton. Konumla ilişkili jeton.
trustedPartnerToken

string

TRUSTED_PARTNER yöntemi için giriş Konumla ilişkili doğrulama jetonu.
Birbirini hariç tutan alanların sonu.

Yanıt metni

Verifications.VerifyLocation için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "verification": {
    object (Verification)
  }
}
Alanlar
verification

object (Verification)

Oluşturulan doğrulama isteği.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasını inceleyin.

VerificationToken

Onaylanmış bir iş ortağı tarafından oluşturulan jeton.

JSON gösterimi 
{
  "tokenString": string
}
Alanlar
tokenString

string

Jeton dizesi.