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

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

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

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

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

BadRecommendationReason

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

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

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

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

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

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