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

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