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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "waitForVoiceOfMerchant": {
    object (WaitForVoiceOfMerchant)
  },
  "verify": {
    object (Verify)
  },
  "resolveOwnershipConflict": {
    object (ResolveOwnershipConflict)
  },
  "complyWithGuidelines": {
    object (ComplyWithGuidelines)
  }
  // End of mutually exclusive fields.
}
الحقول
hasVoiceOfMerchant

boolean

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

boolean

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

object (WaitForVoiceOfMerchant)

انتظِر حتى تحصل على ميزة "آراء التجّار". يخضع الموقع الجغرافي للمراجعة لأغراض الجودة.
verify

object (Verify)

ابدأ عملية التحقّق من المعلنين أو واصِلها.
resolveOwnershipConflict

object (ResolveOwnershipConflict)

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

object (ComplyWithGuidelines)

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

نطاقات الأذونات

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

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 الموقع الجغرافي للمؤسسة غير مفعّل. لحلّ هذه المشكلة، يُرجى الرجوع إلى مقالة "مركز المساعدة".