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

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

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

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

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

ลองใช้งาน

URL ที่มีอยู่ในช่อง flagContentUri ประกอบด้วยตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหา การไปยังลิงก์นี้จะเปิดหน้าเว็บที่โฮสต์โดย Google ในรูปแบบต่อไปนี้

หน้าเว็บรายงานปัญหา

จากกล่องโต้ตอบนี้ ผู้ใช้สามารถยื่นรายงานกับ Google สำหรับประเภทปัญหาที่เหมาะสม เช่น รายงานคำหยาบคาย การกลั่นแกล้ง หรือปัญหาทางกฎหมายเกี่ยวกับเนื้อหา

ราคา

ฟีเจอร์นี้อยู่ในช่วงทดลองใช้ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปและไม่มีค่าใช้จ่าย ซึ่งหมายความว่าการเรียกเก็บเงินจะเป็น $0 สำหรับการใช้งานในช่วงทดลองใช้ ดูรายละเอียดเกี่ยวกับราคาที่เสนอได้ที่การใช้งานและการเรียกเก็บเงินของ Places API

แสดงลิงก์การรายงานเนื้อหา

ตัวอย่างรุ่นนี้จะเพิ่มช่อง flagContentUri ใหม่ลงในออบเจ็กต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการตอบกลับจาก Places API อยู่แล้ว

  • Review
  • Photo

  • GenerativeSummary สำหรับ GenerativeSummary เท่านั้น จะมีช่องใหม่ 2 ช่อง ได้แก่

    • overviewFlagContentUri: ลิงก์สำหรับแจ้ง Google เกี่ยวกับเนื้อหาที่ไม่เหมาะสมในภาพรวม
    • descriptionFlagContentUri: ลิงก์สำหรับแจ้งให้ Google ทราบเกี่ยวกับเนื้อหาที่ไม่เหมาะสมในคำอธิบาย

  • AreaSummary

  • ContextualContent

ในระหว่างช่วงทดลองใช้ คุณไม่จำเป็นต้องแสดงลิงก์การรายงานเนื้อหาเมื่อแสดงออบเจ็กต์เหล่านี้ต่อลูกค้า

อย่างไรก็ตาม เมื่อฟีเจอร์นี้พร้อมให้บริการแก่ผู้ใช้ทั่วไป (GA) คุณต้องแสดงลิงก์การรายงานเนื้อหาเมื่อแสดงออบเจ็กต์เหล่านี้เพื่อให้ลูกค้ารายงานปัญหาเกี่ยวกับเนื้อหาได้

เข้าถึงลิงก์การรายงานเนื้อหาในการตอบกลับ

คำขอรายละเอียดสถานที่ต่อไปนี้จะรวมรีวิวสถานที่ในการตอบกลับ

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