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

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

Google הטמיעה סדרה של אמצעים כדי לזהות תוכן בעייתי לפני שהוא מוחזר על ידי Places API (חדש), אבל אנחנו גם מספקים למשתמשים דרך לסמן תוכן בלתי הולם כדי ש-Google תוכל להסיר אותו. במהדורה הזו, השדה החדש flagContentUri נכלל ב-Places API (חדש) בכל הביקורות, התמונות והסיכומים הגנרטיביים שכלולים בתשובה של 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. לוחצים על הלחצן Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

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