Method: locations.getVoiceOfMerchantState

الحصول على حالة VoiceOfMerchant

طلب HTTP

GET https://mybusinessverifications.googleapis.com/v1/{name=locations/*}/VoiceOfMerchantState

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
name

string

مطلوبة. اسم المورد للموقع الجغرافي

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة ردّ لـ VoiceOfMerchant.GetVoiceOfMerchantState

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "hasVoiceOfMerchant": boolean,
  "hasBusinessAuthority": boolean,

  // Union field gain_voice_of_merchant_action can be only one of the following:
  "waitForVoiceOfMerchant": {
    object (WaitForVoiceOfMerchant)
  },
  "verify": {
    object (Verify)
  },
  "resolveOwnershipConflict": {
    object (ResolveOwnershipConflict)
  },
  "complyWithGuidelines": {
    object (ComplyWithGuidelines)
  }
  // End of list of possible types for union field gain_voice_of_merchant_action.
}
الحقول
hasVoiceOfMerchant

boolean

يشير إلى ما إذا كان الموقع الجغرافي في وضع جيد ويتحكّم في النشاط التجاري على Google. سيتم نشر أي تعديلات يتم إجراؤها على الموقع الجغرافي على "خرائط Google" بعد اجتياز مرحلة المراجعة.
hasBusinessAuthority

boolean

يشير إلى ما إذا كان الموقع الجغرافي يمتلك السلطة (الملكية) على النشاط التجاري على Google. في حال صحة ذلك، لا يمكن أن يحتل موقع جغرافي آخر مكانة بارزة في "خرائط Google". ومع ذلك، لن يتم نشر التعديلات ما لم يتم اكتساب Voice of Merchant (مثلاً، تكون hasVoiceOfMerchant true).
حقل الاتحاد gain_voice_of_merchant_action الإجراء الموصى به للموقع الجغرافي للتحكّم في النشاط التجاري على Google. يمكن أن تكون السمة "gain_voice_of_merchant_action" واحدة فقط مما يلي:
waitForVoiceOfMerchant

object (WaitForVoiceOfMerchant)

انتظِر للاطّلاع على خدمة Voice of Merchant. الموقع الجغرافي قيد المراجعة لأغراض الجودة.
verify

object (Verify)

ابدأ عملية إثبات الملكية أو تابعها.
resolveOwnershipConflict

object (ResolveOwnershipConflict)

هذا الموقع يكرر موقعًا آخر في وضع جيد. إذا كان بإمكانك الوصول إلى الموقع الجغرافي في وضع جيد، استخدِم معرّف هذا الموقع الجغرافي لتنفيذ عمليات معيّنة. بخلاف ذلك، يمكنك طلب الوصول من المالك الحالي.
complyWithGuidelines

object (ComplyWithGuidelines)

لا يلتزم الموقع الجغرافي بما ورد في إرشاداتنا ويتطلب خطوات إضافية لاستعادته. لحلّ هذه المشكلة، يُرجى الاطّلاع على مقالة "مركز المساعدة".

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

WaitForVoiceOfMerchant

لا يحتوي هذا النوع على أي حقول.

تشير هذه السمة إلى أنّ الموقع الجغرافي سيحصل على صوت التاجر بعد اجتياز المراجعة.

إثبات الهوية

يشير إلى أن الموقع يتطلب إثبات الملكية. يحتوي على معلومات عن إجراءات إثبات الملكية الحالية التي يتم تنفيذها في الموقع الجغرافي.

تمثيل JSON 
{
  "hasPendingVerification": boolean
}
الحقول
hasPendingVerification

boolean

تشير هذه السمة إلى ما إذا كانت عملية إثبات الهوية قد بدأت، ويمكن إكمالها حسب الموقع الجغرافي.

ResolveOwnershipConflict

لا يحتوي هذا النوع على أي حقول.

يشير إلى أن الموقع يكرر موقعًا آخر في وضع جيد.

ComplyWithGuidelines

يشير إلى عدم التزام الموقع بما ورد في إرشاداتنا.

تمثيل JSON 
{
  "recommendationReason": enum (RecommendationReason)
}
الحقول
recommendationReason

enum (RecommendationReason)

سبب اقتراح الموقع الجغرافي للالتزام بالإرشادات.

RecommendationReason

يشير إلى سبب اقتراح الموقع الجغرافي من أجل الالتزام بالإرشادات.

عمليات التعداد
RECOMMENDATION_REASON_UNSPECIFIED غير محدَّد.
BUSINESS_LOCATION_SUSPENDED تم تعليق الموقع الجغرافي للنشاط التجاري. لحلّ هذه المشكلة، يمكنك الاطّلاع على مقالة مركز المساعدة.
BUSINESS_LOCATION_DISABLED الموقع الجغرافي للنشاط التجاري غير مفعّل. لحلّ هذه المشكلة، يمكنك الاطّلاع على مقالة مركز المساعدة.