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

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

แม้ว่า Google จะใช้มาตรการต่างๆ เพื่อระบุเนื้อหาที่มีปัญหาแล้วก่อนที่ Places API (ใหม่) จะแสดงเนื้อหาดังกล่าว แต่เราก็มีวิธีให้ผู้ใช้แจ้งเนื้อหาไม่เหมาะสมเพื่อให้ Google นำออกได้ ในการเปิดตัวครั้งนี้ Places API (ใหม่) จะมีช่อง flagContentUri ใหม่ในรีวิว รูปภาพ และข้อมูลสรุปที่สร้างขึ้นทั้งหมดซึ่งรวมอยู่ในคำตอบของ 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