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

‫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. אם רוצים, מרחיבים את Show standard parameters ומגדירים את הפרמטר fields למסכת השדה.

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

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

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