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. אם הערך הוא True, מיקום אחר לא יכול להשתלט על העסק ולהפוך אותו לדף העסקי הדומיננטי במפות Google. עם זאת, פעולות העריכה לא יופיעו אלא אם כן יועבר ל-Voice of Merchant (כלומר, hasVoiceOfMerchant נכון).
שדה איחוד 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

מציין למה המיקום הומלץ בהתאם להנחיות בנושא ComplyWithGuidelines.

טיפוסים בני מנייה (enum)
RECOMMENDATION_REASON_UNSPECIFIED לא צוין.
BUSINESS_LOCATION_SUSPENDED מיקום העסק מושעה. כדי לפתור את הבעיה, אפשר לעיין במאמר במרכז העזרה.
BUSINESS_LOCATION_DISABLED מיקום העסק מושבת. כדי לפתור את הבעיה, אפשר לעיין במאמר במרכז העזרה.