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

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

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

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

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

רוצים לנסות?

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

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

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

תמחור

התכונה הזו נמצאת בשלב תצוגה מקדימה לפני GA, והיא לא כרוכה בתשלום, כלומר החיוב הוא 0 $על השימוש במהלך התצוגה המקדימה. פרטים על התמחור המוצע מופיעים במאמר שימוש בחיוב ב-Places API.

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

גרסת התצוגה המקדימה הזו מוסיפה את השדה flagContentUri החדש לאובייקטים הבאים שכבר נמצאים חלק מהתגובה של Places API:

  • Review
  • Photo

  • GenerativeSummary ב-GenerativeSummary בלבד יש שני שדות חדשים:

    • overviewFlagContentUri: הקישור לדיווח ל-Google על תוכן בלתי הולם בסקירה הכללית.
    • descriptionFlagContentUri: הקישור לדיווח ל-Google על תוכן בלתי הולם בתיאור.

  • AreaSummary

  • ContextualContent

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

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

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

הבקשה הבאה לפרטי מקום כוללת ביקורות על מקומות בתשובה:

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 ואת אפשרויות ה-API.

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

  2. אפשר להרחיב את הקטע Show default parameters (הצגת פרמטרים סטנדרטיים) ולהגדיר את הפרמטר fields למסכת השדות.

  3. אפשר לערוך את גוף הבקשה.

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

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