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

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