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

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

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

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

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

רוצים לנסות?

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

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

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

תמחור

התכונה הזו נמצאת בשלב תצוגה מקדימה לפני השקה, והיא לא כרוכה בתשלום. כלומר, החיוב הוא 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 ואת האפשרויות שלו.

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

  2. אפשר גם להרחיב את האפשרות Show standard parameters ולהגדיר את הפרמטר fields למסכת השדה.

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

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

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