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

ב-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.

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

במהדורת ה-Preview הזו נוסף השדה החדש 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. לוחצים על הלחצן Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

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