Method: googleLocations.report

דיווח על GoogleLocation.

בקשת HTTP

POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
name

string

שם משאב של [GoogleLocation] בפורמט googleLocations/{googleLocationId}.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "locationGroupName": string,
  "reportReasonElaboration": string,
  "reportReasonLanguageCode": string,

  // Union field report_reason can be only one of the following:
  "reportReasonBadLocation": enum (BadLocationReason),
  "reportReasonBadRecommendation": enum (BadRecommendationReason)
  // End of list of possible types for union field report_reason.
}
שדות
locationGroupName

string

אפשרות. שם המשאב של קבוצת המיקומים שעבורה נשלח דיווח על המיקום הזה ב-Google, בפורמט accounts/{accountId}.
reportReasonElaboration

string

אפשרות. רשומת טקסט שמפרטת את הסיבה שבגללה המשתמש מדווח על המיקום הזה. האורך המקסימלי הוא 512 תווים.
reportReasonLanguageCode

string

אפשרות. קוד השפה BCP 47 שכתוב בשפה reportReasonElaboration.
שדה איחוד report_reason. הסיבה לדיווח על המיקום הזה. יש לציין סיבה. הערך של report_reason יכול להיות רק אחת מהאפשרויות הבאות:
reportReasonBadLocation

enum (BadLocationReason)

הסיבה שבגללה המשתמש מדווח על המיקום הזה כאשר הבעיה היא במיקום עצמו.
reportReasonBadRecommendation

enum (BadRecommendationReason)

הסיבה שבגללה המשתמש מדווח על המיקום הזה כאשר הבעיה קשורה להמלצה. הדוח הזה שימושי אם החשבון ב'פרופיל העסק ב-Google' קיבל המלצה על המיקום.

גוף התגובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

BadLocationReason

קבוצת סיבות אפשריות לדיווח על מיקום כשיש בעיה באיכות הנתונים במיקום עצמו.

טיפוסים בני מנייה (enums)
BAD_LOCATION_REASON_UNSPECIFIED לא צוין.
NOT_A_LOCATION המיקום המומלץ הוא לא מיקום בפועל.
PERMANENTLY_CLOSED המיקום המומלץ סגור לצמיתות.
DOES_NOT_EXIST המיקום המומלץ לא קיים.
SPAM המיקום המומלץ הוא ספאם, מזויף או פוגעני.
NOT_A_BUSINESS המיקום המומלץ הוא מקום פרטי או בית פרטי.
MOVED

המיקום המומלץ עבר למיקום חדש.

יש לציין יחד עם reportReasonElaboration את הכתובת החדשה.
DUPLICATE המיקום המומלץ הוא כפילות של מיקום אחר.

BadRecommendationReason

קבוצת סיבות אפשריות לדיווח על מיקום כשיש בעיה באיכות של ההמלצה (כשהמיקום הזה מומלץ למשתמש).

טיפוסים בני מנייה (enums)
BAD_RECOMMENDATION_REASON_UNSPECIFIED לא צוין.
NOT_A_STORE_FRONT המיקום המומלץ הוא לא חזית חנות.
NOT_PART_OF_SUGGESTED_CHAIN

המיקום המומלץ לא שייך לרשת שהוצעה ב-chainDisplayName במיקום שהוחזר.

יש לציין יחד עם הסימן reportReasonElaboration שמציין את שם הרשת הנכונה.
IRRELEVANT

המיקום המומלץ לא רלוונטי למשתמש.

צריך לצרף לאישור reportReasonElaboration למה ההמלצה לא רלוונטית.