דיווח על תוכן בלתי הולם

ב-Places API (חדש) מוחזר מידע על מקום בתשובה. בנוסף לתוכן עובדתי, כמו כתובת ומספר טלפון, התשובה יכולה להכיל גם תוכן שמשתמשים הוסיפו במפות Google, כמו ביקורות ותמונות. בנוסף, כשמשתמשים ביכולות של מודל Gemini ב-Places API (חדש), התשובה יכולה לכלול נתונים גנרטיביים שמסוכמים ומצטברים מ-LLM.

‫Google הטמיעה סדרה של אמצעים לזיהוי תוכן בעייתי לפני שהוא מוחזר על ידי Places API (חדש), אבל אנחנו גם מספקים למשתמשים דרך לסמן תוכן לא הולם כדי ש-Google תוכל להסיר אותו. בגרסה הזו, Places API (חדש) כולל את השדה החדש flagContentUri בכל הביקורות, התמונות והסיכומים הגנרטיביים שנכללים בתשובה של Places API (חדש). השדה הזה מכיל קישור, כולל מזהה תוכן ייחודי, שמאפשר למשתמשים להודיע ל-Google על תוכן לא הולם.

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

‫API Explorer מאפשר לכם לשלוח בקשות בזמן אמת כדי להכיר את האפשרויות החדשות האלה:

כדאי לנסות!

כתובת ה-URL שמופיעה בשדה flagContentUri כוללת מזהה ייחודי של התוכן. כשלוחצים על הקישור הזה, נפתח דף אינטרנט שמתארח ב-Google, בפורמט הבא:

דף האינטרנט 'דיווח על בעיה'.

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

הצגת הקישור לדיווח על תוכן

השדה flagContentUri זמין באובייקטים הבאים שכבר כלולים בתגובה של Places API (חדש):

כשמציגים את האובייקטים האלה, צריך להציג גם את הקישור לדיווח על תוכן, כדי שהלקוחות יוכלו לדווח על בעיות בתוכן.

גישה לקישור לדיווח על תוכן בתשובה

הבקשה הבאה לפרטי מקום (חדש) כוללת ביקורות על המקום בתגובה:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,reviews" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

התשובה תהיה בפורמט הבא:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB",
      "relativePublishTimeDescription": "7 months ago",
      "rating": 3,
      "text": {
        "text": "Came here for a tour and honestly,...",
        "languageCode": "en"
      },
      "originalText": {
        "text": "Came here for a tour and honestly,...",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "John Smith",
        "uri": "https://www.google.com/maps/contrib/10198693/reviews",
        "photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6"
      },
      "publishTime": "2024-02-24T19:26:18.091264Z",
      "flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1",
      "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
    },
    …
  ]
}

כל רשומה במערך reviews מכילה את השדה flagContentUri, כולל מזהה ייחודי של הביקורת הספציפית. אם הלקוחות שלכם ילחצו על הקישור הזה, הם יוכלו לדווח על תוכן בלתי הולם בביקורת הספציפית הזו.

אם כוללים את photos במסכת השדות:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,reviews,photos" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

התשובה כוללת גם את המערך photos, שבו כל רכיב מכיל את השדה flagContentUri:

  ...
  "photos": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo",
      "widthPx": 4032,
      "heightPx": 3024,
      "authorAttributions": [
        {
          "displayName": "Jane Smith",
          "uri": "https://maps.google.com/maps/contrib/107007354",
          "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo"
        }
      ],
      "flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr",
      "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
    },
    ...
  ]

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

רוצה לנסות?

ה-API Explorer מאפשר לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שלו.

  1. בצד שמאל של הדף, לוחצים על סמל ה-API, ‏ מרחיבים את API Explorer..

  2. אופציונלי: מרחיבים את האפשרות הצגת פרמטרים רגילים ומגדירים את הפרמטר fields לfield mask.

  3. אם רוצים, עורכים את גוף הבקשה.

  4. לוחצים על הלחצן Execute (הפעלה). בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

  5. בחלונית API Explorer, לוחצים על סמל ההרחבה, מרחיבים את API Explorer., כדי להרחיב את חלון API Explorer.