รายงานเนื้อหาที่ไม่เหมาะสม

Places API (ใหม่) จะแสดงข้อมูลเกี่ยวกับสถานที่ในคำตอบ นอกจากเนื้อหาที่เป็นข้อเท็จจริง เช่น ที่อยู่และหมายเลขโทรศัพท์แล้ว คำตอบ ยังอาจมีเนื้อหาที่ผู้ใช้มีส่วนร่วมใน Google Maps เช่น รีวิวและรูปภาพ นอกจากนี้ เมื่อใช้ความสามารถของโมเดล Gemini สำหรับ Places API (ใหม่) การตอบกลับอาจมีข้อมูลที่สร้างขึ้นซึ่งรวบรวมและสรุปจาก LLM

แม้ว่า Google จะใช้มาตรการหลายอย่างเพื่อระบุเนื้อหาที่มีปัญหา ก่อนที่ Places API (ใหม่) จะแสดงผล แต่เราก็มี วิธีให้ผู้ใช้แจ้งเนื้อหาไม่เหมาะสมเพื่อให้ Google นำออกได้ ในรุ่นนี้ Places API (ใหม่) จะมีช่อง flagContentUri ใหม่ในรีวิว รูปภาพ และข้อมูลสรุปแบบ Generative ทั้งหมดที่รวมอยู่ในการตอบกลับของ Places API (ใหม่) ฟิลด์นี้มีลิงก์ รวมถึงตัวระบุเนื้อหาที่ไม่ซ้ำกัน ซึ่งช่วยให้ผู้ใช้แจ้ง Google เกี่ยวกับเนื้อหาที่ไม่เหมาะสมได้

เช่น คุณส่งคำขอที่แสดงรีวิวเดี่ยว 5 รายการสำหรับสถานที่ รีวิวแต่ละรายการจะมีฟิลด์ flagContentUri ใหม่พร้อมตัวระบุที่ไม่ซ้ำกันสำหรับรีวิวนั้น เพื่อให้ผู้ใช้รายงานปัญหาเกี่ยวกับรีวิวใดรีวิวหนึ่งหรือทั้งหมดได้

โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบสดเพื่อให้คุ้นเคยกับตัวเลือกใหม่ต่อไปนี้

ลองใช้งาน

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 ช่วยให้คุณส่งคำขอตัวอย่างเพื่อให้คุ้นเคยกับ API และตัวเลือก API ได้

  1. เลือกไอคอน API ขยายโปรแกรมสำรวจ API ทางด้านขวาของหน้า

  2. ขยายแสดงพารามิเตอร์มาตรฐาน (ไม่บังคับ) แล้วตั้งค่าfields พารามิเตอร์เป็นมาสก์ ฟิลด์

  3. แก้ไขเนื้อหาคำขอ (ไม่บังคับ)

  4. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้เพื่อส่งคำขอ

  5. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย ขยายโปรแกรมสำรวจ API เพื่อขยายหน้าต่างโปรแกรมสำรวจ API