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 היא 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

מציין מדוע המיקום הומלץ ל-ComplyWithGuidelines.

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