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 Center (أي hasVoiceOfMerchant صحيح).
حقل الاتحاد gain_voice_of_merchant_action. يُنصَح باتخاذ إجراء للموقع الجغرافي للتحكّم في النشاط التجاري على Google. يمكن أن يكون gain_voice_of_merchant_action واحدًا فقط مما يلي:
waitForVoiceOfMerchant

object (WaitForVoiceOfMerchant)

يُرجى الانتظار إلى حين توفّر خدمة Voice of Merchant Center. الموقع الجغرافي قيد المراجعة لأغراض الجودة.
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

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

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