Package google.mybusiness.verifications.v1

Dizin

Doğrulamalar

Bu API, Google'da Konum doğrulamalarının yönetilmesine olanak tanır. [Doğrulama] [google.isletme.v1.Doğrulama] kaynaklarını yönetmenize olanak tanır.

Her [Konum] [google.mybusiness.businessinformation.locations.v1.Location], locations/*/verifications/* adlı [Doğrulama] [google.mybusiness.verifications] kaynakları koleksiyonuna sahiptir.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

PENDING doğrulama işlemini tamamlar.

Yalnızca AUTO dışı doğrulama yöntemleri için gereklidir. AUTO doğrulama isteği, oluşturulduktan hemen sonra VERIFIED olur.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

Belirli bir dildeki bir konum için uygun olan tüm doğrulama seçeneklerini bildirir.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

Konum doğrulamalarını, oluşturulma zamanına göre sıralanmış şekilde listeleyin.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

Bir konum için doğrulama işlemini başlatır.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

VoiceOfMerchant

Bu hizmet, üçüncü taraf kullanıcılarının satıcı durumu hakkındaki ayrıntıları istemesine olanak tanır.

GetVoiceOfMerchantState

rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState)

VoiceOfMerchant durumunu alır.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

CompleteVerificationRequest

Doğrulamas.CompleteDoğrulamaİşlemi için istek iletisi.

Alanlar
name

string

Zorunlu. Tamamlanacak doğrulamanın kaynak adı.
pin

string

Zorunlu. Satıcının aldığı PIN kodu (doğrulamayı tamamlamak için).

CompleteVerificationResponse

Doğrulamas.CompleteDoğrulamaİşlemi için yanıt iletisi.

Alanlar
verification

Verification

Doğrulama tamamlandı.

ComplyWithGuidelines

Konumun yönergelerimize uygun olmadığını belirtir.

Alanlar
recommendation_reason

RecommendationReason

Konumun kurallara uygun olması için önerilmesinin nedeni.

RecommendationReason

Konumun Kurallara Uygunluk'a neden önerildiğini belirtir.

Sıralamalar
RECOMMENDATION_REASON_UNSPECIFIED Belirtilmedi.
BUSINESS_LOCATION_SUSPENDED İşletmenin bulunduğu konum askıya alınmışsa. Bu sorunu düzeltmek için Yardım Merkezi makalesini inceleyin.
BUSINESS_LOCATION_DISABLED İşletmenin bulunduğu konum devre dışı. Bu sorunu düzeltmek için Yardım Merkezi makalesini inceleyin.

FetchVerificationOptionsRequest

Doğrulamas.FetchDoğrulamaOptions için gönderilen ileti.

Alanlar
location

string

Zorunlu. Doğrulanacak konum.
language_code

string

Zorunlu. Doğrulama işlemi için kullanılacak dili temsil eden BCP 47 dil kodu. Kullanılabilir seçenekler dile göre değişir.
context

ServiceBusinessContext

İsteğe bağlı. Hizmet işletmelerini doğrulamak için ek bağlam bilgileri. Yalnızca işletme türü CUSTOMER_LOCATION_ONLY olan konumlara uygulanabilir. Doğru bir adres belirtirseniz daha fazla seçenekten yararlanabilirsiniz. Diğer işletme türleri için ayarlanırsa INVALID_ARGUMENT atılır.

FetchVerificationOptionsResponse

Doğrulamas.FetchDoğrulamaOptions için yanıt iletisi.

Alanlar
options[]

VerificationOption

Mevcut doğrulama seçenekleri.

GetVoiceOfMerchantStateRequest

VoiceOfMerchant.GetVoiceOfMerchantState için mesaj isteyin.

Alanlar
name

string

Zorunlu. Konumun kaynak adı.

ListVerificationsRequest

Doğrulamas.List Verifications için istek iletisi.

Alanlar
parent

string

Zorunlu. Doğrulama isteklerinin ait olduğu konumun kaynak adı.
page_size

int32

Sayfa başına dahil edilecek doğrulama sayısı. Minimum sayfa boyutu 1, varsayılan ve maksimum sayfa boyutu ise 100'dür.
page_token

string

Belirtilmişse sonraki doğrulama sayfasını döndürür.

ListVerificationsResponse

Doğrulamas.ListDoğrulamas için yanıt mesajı.

Alanlar
verifications[]

Verification

Doğrulama listesi.
next_page_token

string

Doğrulama sayısı istenen sayfa boyutunu aşıyorsa bu alan, sonraki bir aramada bir sonraki doğrulama sayfasını getirmek için bir jetonla doldurulur. Başka özellik yoksa bu alan yanıtta yer almaz.

ResolveOwnershipConflict

Bu türde alan yok.

Konumun iyi durumdaki başka bir konumun kopyasını içerdiğini belirtir.

ServiceBusinessContext

Hizmet işletmesi doğrulaması için ek veriler.

Alanlar
address

PostalAddress

Konumun doğrulama adresi. Daha fazla doğrulama seçeneğini etkinleştirmek veya posta kartı göndermek için kullanılır.

Doğrulama

Doğrulama, bir konumdaki doğrulama denemesini temsil eder.

Alanlar
name

string

Doğrulamanın kaynak adı.
method

VerificationMethod

Doğrulama yöntemi.
state

State

Doğrulamanın durumu.
create_time

Timestamp

Doğrulamanın istendiği zaman damgası.
announcement

string

İsteğe bağlı. Yanıt duyurusu, yalnızca yöntem VETTED_PARTNER ise ayarlanır.

Eyalet

Olası tüm doğrulama durumları.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer hatalarla sonuçlanır.
PENDING Doğrulama beklemede.
COMPLETED Doğrulama tamamlandı.
FAILED Doğrulama başarısız oldu.

VerificationMethod

Google'ın bir konumu doğrulamak için kullandığı işlemleri belirtir.

Sıralamalar
VERIFICATION_METHOD_UNSPECIFIED Varsayılan değer hatalarla sonuçlanır.
ADDRESS Belirli bir posta adresine, doğrulama PIN'i içeren bir posta kartı gönderin. PIN, Google ile doğrulamayı tamamlamak için kullanılır.
EMAIL Belirli bir e-posta adresine doğrulama PIN'i içeren bir e-posta gönderin. PIN, Google ile doğrulamayı tamamlamak için kullanılır.
PHONE_CALL Doğrulama PIN'i ile belirli bir telefon numarasına sesli arama yapın. PIN, Google ile doğrulamayı tamamlamak için kullanılır.
SMS Belirli bir telefon numarasına doğrulama PIN'i içeren bir SMS gönderin. PIN, Google ile doğrulamayı tamamlamak için kullanılır.
AUTO Başka bir kullanıcı işlemi yapmadan konumu doğrulayın. Bu seçenek tüm konumlarda kullanılamayabilir.
VETTED_PARTNER Bu seçenek tüm konumlarda kullanılamayabilir.

VerificationOption

Doğrulama seçeneği, konumun nasıl doğrulanacağını (doğrulama yöntemiyle belirtilir) ve doğrulamanın nereye gönderileceğini (gösterilen verilerle belirtilir) belirtir.

Alanlar
verification_method

VerificationMethod

Konumu doğrulama yöntemi.
DisplayData alanı. Görünen verilerden biri. Veriler yöntemle eşleşmelidir. İlgili yöntemde görüntülü reklam verisi yoksa boş bırakılır. DisplayData şunlardan yalnızca biri olabilir:
phone_number

string

Yalnızca yöntem PHONE_CALL veya SMS ise ayarlayın. PIN'in gönderileceği telefon numarası.
address_data

AddressVerificationData

Yalnızca yöntem MAIL ise ayarlayın.
email_data

EmailVerificationData

Yalnızca yöntem EMAIL ise ayarlayın.
announcement

string

Yalnızca yöntem VETTED_PARTNER ise ayarlayın.

AddressVerificationData

Doğrulama verilerini posta kartı aracılığıyla görüntüleyin.

Alanlar
business

string

Satıcının işletme adı.
address

PostalAddress

Posta kartının gönderilebileceği adres.
expected_delivery_days_region

int32

Posta kartının adres bölgesine teslim edilmesi için gereken tahmini gün sayısı.

EmailVerificationData

E-posta ile doğrulama verileri gösterilir.

Alanlar
domain

string

E-posta adresindeki alan adı. Örneğin, foo@gmail.com'daki "gmail.com".
user

string

E-posta adresindeki kullanıcı adı. Örneğin, foo@gmail.com içindeki "foo"
is_user_name_editable

bool

İstemcinin farklı bir kullanıcı adı sağlamasına izin verilip verilmediği.

VerificationToken

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

Alanlar
token_string

string

Jeton dizesi.

Doğrula

Konumun doğrulama gerektirdiğini belirtir. Konumda gerçekleştirilen mevcut doğrulama işlemleriyle ilgili bilgiler içerir.

Alanlar
has_pending_verification

bool

Bir doğrulama işleminin başlamış olup olmadığını ve ilgili konumda tamamlanıp tamamlanmadığını belirtir.

VerifyLocationRequest

Doğrulamas.VerifyLocation için istek iletisi.

Alanlar
name

string

Zorunlu. Doğrulanacak konumun kaynak adı.
method

VerificationMethod

Zorunlu. Doğrulama yöntemi.
language_code

string

İsteğe bağlı. Doğrulama işlemi için kullanılacak dili temsil eden BCP 47 dil kodu.
context

ServiceBusinessContext

İsteğe bağlı. Hizmet işletmelerini doğrulamak için ek bağlam bilgileri. Yalnızca işletme türü CUSTOMER_LOCATION_ONLY olan konumlar için gereklidir. ADDRESS doğrulamasında, bu adres, posta kartı göndermek için kullanılacak. Diğer yöntemler için, GetDoğrulamaOptions'a aktarılanla aynı olmalıdır. Diğer işletme konumu türleri için ayarlanırsa INVALID_ARGUMENT yayınlanır.
RequestData alanı. Ekran verilerine ek olarak belirli bir yöntem için kullanıcı giriş verileri. Verilerin istenen yöntemle eşleşmesi gerekir. Veri gerekmiyorsa boş bırakın. RequestData şunlardan yalnızca biri olabilir:
email_address

string

İsteğe bağlı. EMAIL yönteminin girişi. PIN'in gönderilmesi gereken e-posta adresi.

Bir e-posta adresi, yalnızca FetchDoğrulamaOptions tarafından sağlanan adreslerden biri olması durumunda kabul edilir. [Email VerificationData] [google.mybusiness-verifications.v1.VerificationOption.Email VerificationData] öğesindeki is_user_name_editable parametresi true (doğru) değerine ayarlanırsa istemci farklı bir kullanıcı adı (yerel-bölüm) belirtebilir ancak alan adıyla eşleşmelidir.
mailer_contact

string

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

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

VerificationToken

İsteğe bağlı. VETTED_PARTNER yöntemi için giriş, belirli partners. tarafından kullanılabilir. Doğrulanmış bir hesap için giriş gerekli değildir. Konumla ilişkilendirilen jeton. Konumla ilişkilendirilen jeton.

VerifyLocationResponse

Doğrulamas.VerifyLocation için yanıt mesajı.

Alanlar
verification

Verification

Oluşturulan doğrulama isteği.

VoiceOfMerchantState

VoiceOfMerchant.GetVoiceOfMerchantState için yanıt mesajı.

Alanlar
has_voice_of_merchant

bool

Konumun iyi durumda olup olmadığını ve Google'daki işletme üzerinde kontrol sahibi olup olmadığını belirtir. Konumda yapılan düzenlemeler, inceleme aşaması tamamlandıktan sonra Haritalar'a uygulanır.
has_business_authority

bool

Konumun Google'daki işletme üzerinde yetkiye (sahiplik) sahip olup olmadığını belirtir. Doğru ise, başka bir konum devralamaz ve Haritalar'da baskın giriş olamaz. Ancak, Satıcının Sesi kazanılmadığı sürece düzenlemeler yayınlanmaz (ör. has_voice_of_merchant doğru değerine sahip olmalıdır).
gain_voice_of_merchant_action alanı. Google'da işletme üzerinde kontrol sahibi olmak için konuma önerilen işlem. gain_voice_of_merchant_action şunlardan yalnızca biri olabilir:
wait_for_voice_of_merchant

WaitForVoiceOfMerchant

Voice of Merchant'ı edinmek için bekleyin. Konum, kalite amacıyla inceleniyor.
verify

Verify

Doğrulama işlemini başlatın veya devam edin.
resolve_ownership_conflict

ResolveOwnershipConflict

Bu konum, iyi durumdaki başka bir konumun kopyasını oluşturuyor. İyi durumdaki bir konuma erişebiliyorsanız işlemleri gerçekleştirmek için söz konusu konumun kimliğini kullanın. Aksi halde mevcut sahipten erişim izni isteyin.
comply_with_guidelines

ComplyWithGuidelines

Konum, yönergelerimize uymuyor ve yeniden etkinleştirme için ek adımlar gerektiriyor. Bu sorunu düzeltmek için Yardım Merkezi makalesini inceleyin.

WaitForVoiceOfMerchant

Bu türde alan yok.

Konumun, incelemeyi geçtikten sonra satıcının sesini kazanacağını belirtir.