Package google.factchecking.factchecktools.v1alpha1

ดัชนี

FactCheckToolsService

Fact Check Tools API

API ของเครื่องมือตรวจสอบข้อเท็จจริงให้สิทธิ์เข้าถึงแบบเป็นโปรแกรมไปยังฟังก์ชันการทำงานที่ให้บริการผ่านส่วนหน้าของเครื่องมือตรวจสอบข้อเท็จจริงของ Google ที่ https://g.co/factchecktools

API ที่พร้อมใช้งานในปัจจุบันมีดังนี้

  • การค้นหาคำกล่าวอ้างที่ตรวจสอบข้อเท็จจริงแล้ว (ให้บริการผ่านส่วนหน้าของ Fact Check Explorer)
  • การค้นหาคำกล่าวอ้างที่ได้รับการตรวจสอบข้อเท็จจริงโดยใช้รูปภาพ (ให้บริการผ่านส่วนหน้าของเครื่องมือตรวจสอบข้อเท็จจริง)

  • อินเทอร์เฟซ CRUD สำหรับClaimReviewมาร์กอัปในหน้าเว็บ (ให้บริการผ่านส่วนหน้าของเครื่องมือมาร์กอัปการตรวจสอบข้อเท็จจริง)

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

สร้างมาร์กอัป ClaimReview ในหน้าเว็บ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/factchecktools
DeleteClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

ลบมาร์กอัป ClaimReview ทั้งหมดในหน้าเว็บ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/factchecktools
FactCheckedClaimImageSearch

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

ค้นหาคำกล่าวอ้างที่ได้รับการตรวจสอบข้อเท็จจริงโดยใช้รูปภาพเป็นคำค้นหา
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

ค้นหาการกล่าวอ้างที่ได้รับการตรวจสอบข้อเท็จจริง
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

รับมาร์กอัป ClaimReview ทั้งหมดในหน้า

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/factchecktools
ListClaimReviewMarkupPages

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

แสดงรายการหน้ามาร์กอัป ClaimReview สำหรับ URL หรือองค์กรที่เฉพาะเจาะจง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/factchecktools
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

อัปเดตมาร์กอัป ClaimReview ทั้งหมดในหน้า

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/factchecktools

อ้างสิทธิ์

ข้อมูลเกี่ยวกับการอ้างสิทธิ์

ช่อง
text

string

ข้อความการอ้างสิทธิ์ เช่น "อาชญากรรมเพิ่มขึ้นเป็น 2 เท่าในช่วง 2 ปีที่ผ่านมา"
claimant

string

บุคคลหรือองค์กรที่กล่าวอ้าง เช่น "John Doe"
claim_date

Timestamp

วันที่ที่เกิดการอ้างสิทธิ์
claim_review[]

ClaimReview

รีวิวการกล่าวอ้างนี้อย่างน้อย 1 รายการ (กล่าวคือ บทความตรวจสอบข้อเท็จจริง)

ClaimAuthor

ข้อมูลเกี่ยวกับผู้เขียนคำกล่าวอ้าง

ช่อง
name

string

บุคคลหรือองค์กรที่กล่าวอ้าง เช่น "John Doe"
สอดคล้องกับ ClaimReview.itemReviewed.author.name
job_title

string

สอดคล้องกับ ClaimReview.itemReviewed.author.jobTitle
image_url

string

สอดคล้องกับ ClaimReview.itemReviewed.author.image
same_as

string

สอดคล้องกับ ClaimReview.itemReviewed.author.sameAs

ClaimRating

ข้อมูลเกี่ยวกับการให้คะแนนการอ้างสิทธิ์

ช่อง
textual_rating

string

การให้คะแนนระดับความเป็นจริงเป็นคำหรือวลีสั้นๆ ที่ผู้ใช้อ่านได้
สอดคล้องกับ ClaimReview.reviewRating.alternateName
rating_value

Int32Value

คะแนนที่เป็นตัวเลขของคำกล่าวอ้างนี้ ซึ่งอยู่ในช่วง worstRating - bestRating (รวมค่าแรกและค่าสุดท้าย)
สอดคล้องกับ ClaimReview.reviewRating.ratingValue
worst_rating

Int32Value

สำหรับการให้คะแนนที่เป็นตัวเลข ค่าที่แย่ที่สุดที่เป็นไปได้ในสเกลจากแย่ที่สุดไปจนถึงดีที่สุด
สอดคล้องกับ ClaimReview.reviewRating.worstRating
best_rating

Int32Value

สำหรับการให้คะแนนที่เป็นตัวเลข ค่าที่ดีที่สุดที่เป็นไปได้ในสเกลจากแย่ที่สุดไปจนถึงดีที่สุด
สอดคล้องกับ ClaimReview.reviewRating.bestRating
rating_explanation

string

สอดคล้องกับ ClaimReview.reviewRating.ratingExplanation
image_url

string

สอดคล้องกับ ClaimReview.reviewRating.image

ClaimReview

ข้อมูลเกี่ยวกับการตรวจสอบการอ้างสิทธิ์

ช่อง
publisher

Publisher

ผู้เผยแพร่เนื้อหาของรีวิวการกล่าวอ้างนี้
url

string

URL ของการตรวจสอบการกล่าวอ้างนี้
title

string

ชื่อของการตรวจสอบการกล่าวอ้างนี้ หากระบุได้
review_date

Timestamp

วันที่ที่ตรวจสอบการอ้างสิทธิ์
textual_rating

string

การจัดประเภทข้อความ เช่น "ส่วนใหญ่ไม่เป็นความจริง"
language_code

string

ภาษาที่ใช้เขียนรีวิวนี้ เช่น "en" หรือ "de"

ClaimReviewAuthor

ข้อมูลเกี่ยวกับผู้เขียนการตรวจสอบข้อกล่าวอ้าง

ช่อง
name

string

ชื่อองค์กรที่เผยแพร่การตรวจสอบข้อเท็จจริงนี้
สอดคล้องกับ ClaimReview.author.name
image_url

string

สอดคล้องกับ ClaimReview.author.image

ClaimReviewMarkup

ฟิลด์สำหรับองค์ประกอบ ClaimReview แต่ละรายการ ยกเว้นข้อความย่อยที่จัดกลุ่มฟิลด์เข้าด้วยกัน ฟิลด์แต่ละรายการเหล่านี้จะสอดคล้องกับฟิลด์ใน https://schema.org/ClaimReview เราแสดงการแมปที่แน่นอนสำหรับแต่ละฟิลด์

ช่อง
url

string

ช่องนี้เป็นข้อมูลที่ไม่บังคับ และจะมีค่าเริ่มต้นเป็น URL ของหน้าเว็บ เรามีช่องนี้เพื่อให้คุณลบล้างค่าเริ่มต้นได้ แต่การลบล้างที่อนุญาตมีเพียง URL ของหน้าเว็บและลิงก์ Anchor ที่ไม่บังคับ ("การข้ามไปยังหน้าเว็บ")
ตรงกับ ClaimReview.url
claim_reviewed

string

สรุปสั้นๆ เกี่ยวกับคำกล่าวอ้างที่ได้รับการประเมิน
สอดคล้องกับ ClaimReview.claimReviewed
claim_date

string

วันที่กล่าวอ้างหรือเริ่มมีการพูดถึงแบบสาธารณะ
สอดคล้องกับ ClaimReview.itemReviewed.datePublished
claim_location

string

สถานที่ที่ทำการอ้างสิทธิ์นี้
สอดคล้องกับ ClaimReview.itemReviewed.name
claim_first_appearance

string

ลิงก์ไปยังผลงานที่คำกล่าวอ้างนี้ปรากฏขึ้นเป็นครั้งแรก
สอดคล้องกับ ClaimReview.itemReviewed[@type=Claim].firstAppearance.url
claim_appearances[]

string

รายการลิงก์ไปยังผลงานที่คำกล่าวอ้างนี้ปรากฏขึ้น นอกเหนือจากลิงก์ที่ระบุไว้ใน claim_first_appearance
สอดคล้องกับ ClaimReview.itemReviewed[@type=Claim].appearance.url
claim_author

ClaimAuthor

ข้อมูลเกี่ยวกับผู้เขียนการอ้างสิทธิ์นี้
rating

ClaimRating

ข้อมูลเกี่ยวกับการให้คะแนนการตรวจสอบการกล่าวอ้างนี้

ClaimReviewMarkupPage

มีอินสแตนซ์ของมาร์กอัป ClaimReview อย่างน้อย 1 รายการสำหรับหน้าเว็บ

ช่อง
name

string

ชื่อของทรัพยากรหน้ามาร์กอัป ClaimReview นี้ในรูปแบบ pages/{page_id} ฟิลด์นี้เป็นเอาต์พุตเท่านั้นและผู้ใช้ไม่ควรตั้งค่า ยกเว้นคำขออัปเดต
page_url

string

URL ของหน้าที่เชื่อมโยงกับมาร์กอัป ClaimReview นี้ แม้ว่าClaimReviewแต่ละรายการจะมีช่อง URL ของตัวเอง แต่ในเชิงความหมายแล้ว นี่คือช่องระดับหน้าเว็บ และClaimReviewแต่ละรายการในหน้านี้จะใช้ค่านี้เว้นแต่จะมีการลบล้างค่าดังกล่าวทีละรายการ
ตรงกับ ClaimReview.url
publish_date

string

วันที่เผยแพร่การตรวจสอบข้อเท็จจริง ฟิลด์นี้เป็นฟิลด์ระดับหน้าเว็บในเชิงความหมายเช่นเดียวกับ URL และ ClaimReview แต่ละรายการในหน้านี้จะมีค่าเดียวกัน
ตรงกับ ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

ข้อมูลเกี่ยวกับผู้เขียนการตรวจสอบการกล่าวอ้างนี้ ฟิลด์เหล่านี้เป็นฟิลด์ระดับหน้าเว็บในเชิงความหมายเช่นเดียวกับฟิลด์ด้านบน และแต่ละ ClaimReview ในหน้านี้จะมีค่าเดียวกัน
claim_review_markups[]

ClaimReviewMarkup

รายการการตรวจสอบการกล่าวอ้างแต่ละรายการสำหรับหน้านี้ แต่ละรายการในลิสต์จะสอดคล้องกับองค์ประกอบ ClaimReview 1 รายการ
version_id

string

รหัสเวอร์ชันของการมาร์กอัปนี้ ฟิลด์นี้เป็นเอาต์พุตเท่านั้นและผู้ใช้ไม่ควรตั้งค่า ยกเว้นคำขออัปเดต

CreateClaimReviewMarkupPageRequest

ขอสร้างมาร์กอัป ClaimReview ในหน้าเว็บ

ช่อง
claim_review_markup_page

ClaimReviewMarkupPage

ClaimReview มาร์กอัปที่จะสร้างสำหรับหน้านี้ หากมี URL ของหน้าเว็บเวอร์ชันที่ Canonical มากกว่าที่ระบุไว้ เราจะใช้ URL นั้นแทน

DeleteClaimReviewMarkupPageRequest

คำขอให้ลบมาร์กอัป ClaimReview ทั้งหมดในหน้า

ช่อง
name

string

ชื่อของทรัพยากรที่จะลบในรูปแบบ pages/{page_id}

FactCheckedClaimImageSearchRequest

คำขอค้นหาการกล่าวอ้างที่ได้รับการตรวจสอบข้อเท็จจริงตามรูปภาพ

ช่อง
image_uri

string

ต้องระบุ URI ของรูปภาพต้นฉบับ ซึ่งต้องเป็น URL แบบ HTTP/HTTPS ของรูปภาพที่เข้าถึงได้แบบสาธารณะ

เมื่อดึงรูปภาพจาก URL ของ HTTP/HTTPS Google ไม่สามารถรับประกันได้ว่าจะดำเนินการตามคำขอได้สำเร็จ คำขออาจไม่สำเร็จหากโฮสต์ที่ระบุปฏิเสธคำขอ (เช่น เนื่องจากการควบคุมอัตราคำขอหรือการป้องกัน DOS) หรือหาก Google ควบคุมอัตราคำขอไปยังเว็บไซต์เพื่อป้องกันการละเมิด คุณไม่ควรใช้รูปภาพที่โฮสต์ภายนอกสำหรับแอปพลิเคชันเวอร์ชันที่ใช้งานจริง
language_code

string

ไม่บังคับ รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ใช้เพื่อจำกัดผลการค้นหาตามภาษาได้ แต่ปัจจุบันเรายังไม่พิจารณาภูมิภาค
page_size

int32

ไม่บังคับ ขนาดการแบ่งหน้า เราจะแสดงผลการค้นหาให้มากที่สุดเท่าที่ระบุ ค่าเริ่มต้นคือ 10 หากไม่ได้กำหนดไว้
page_token

string

ไม่บังคับ โทเค็นการแบ่งหน้า คุณระบุ next_page_token ที่ได้จากคำขอ List ก่อนหน้า (หากมี) เพื่อไปยังหน้าถัดไปได้ ฟิลด์อื่นๆ ทั้งหมดต้องมีค่าเดียวกับในคำขอก่อนหน้า
offset

int32

ไม่บังคับ จำนวนเต็มที่ระบุออฟเซ็ตปัจจุบัน (นั่นคือตำแหน่งผลการค้นหาเริ่มต้น) ในผลการค้นหา ระบบจะพิจารณาช่องนี้ก็ต่อเมื่อไม่ได้ตั้งค่า page_token เช่น 0 หมายถึงการแสดงผลลัพธ์โดยเริ่มจากผลลัพธ์แรกที่ตรงกัน และ 10 หมายถึงการแสดงผลลัพธ์จากผลลัพธ์ที่ 11

FactCheckedClaimImageSearchResponse

คำตอบจากการค้นหาการกล่าวอ้างที่ได้รับการตรวจสอบข้อเท็จจริงด้วยรูปภาพ

ช่อง
results[]

Result

รายการการอ้างสิทธิ์และข้อมูลที่เกี่ยวข้องทั้งหมด
next_page_token

string

โทเค็นการแบ่งหน้าถัดไปในการตอบกลับการค้นหา โดยควรใช้เป็น page_token สำหรับคำขอต่อไปนี้ ค่าว่างหมายถึงไม่มีผลลัพธ์เพิ่มเติม

ผลลัพธ์

การอ้างสิทธิ์และข้อมูลที่เกี่ยวข้อง

ช่อง
claim

Claim

การอ้างสิทธิ์ที่ตรงกับคำค้นหา

FactCheckedClaimSearchRequest

คำขอค้นหาการกล่าวอ้างที่ได้รับการตรวจสอบข้อเท็จจริง

ช่อง
query

string

สตริงข้อความค้นหา ต้องระบุเว้นแต่จะมีการระบุ review_publisher_site_filter
language_code

string

รหัสภาษา BCP-47 เช่น "en-US" หรือ "sr-Latn" ใช้เพื่อจำกัดผลการค้นหาตามภาษาได้ แต่ปัจจุบันเรายังไม่พิจารณาภูมิภาค
review_publisher_site_filter

string

เว็บไซต์ผู้เผยแพร่รีวิวเพื่อกรองผลลัพธ์ เช่น nytimes.com
max_age_days

int32

อายุสูงสุดของผลการค้นหาที่แสดงเป็นวัน ระบบจะพิจารณาอายุตามวันที่อ้างสิทธิ์หรือวันที่ตรวจสอบ แล้วแต่ว่าวันที่ใดใหม่กว่า
page_size

int32

ขนาดการแบ่งหน้า เราจะแสดงผลการค้นหาให้มากที่สุดเท่าที่ระบุ ค่าเริ่มต้นคือ 10 หากไม่ได้กำหนดไว้
page_token

string

โทเค็นการแบ่งหน้า คุณระบุ next_page_token ที่ได้จากคำขอ List ก่อนหน้า (หากมี) เพื่อไปยังหน้าถัดไปได้ ฟิลด์อื่นๆ ทั้งหมดต้องมีค่าเดียวกับในคำขอก่อนหน้า
offset

int32

จำนวนเต็มที่ระบุออฟเซ็ตปัจจุบัน (นั่นคือตำแหน่งผลการค้นหาเริ่มต้น) ในผลการค้นหา ระบบจะพิจารณาช่องนี้ก็ต่อเมื่อไม่ได้ตั้งค่า page_token เช่น 0 หมายถึงการแสดงผลลัพธ์โดยเริ่มจากผลลัพธ์แรกที่ตรงกัน และ 10 หมายถึงการแสดงผลลัพธ์จากผลลัพธ์ที่ 11

FactCheckedClaimSearchResponse

คำตอบจากการค้นหาการกล่าวอ้างที่ผ่านการตรวจสอบข้อเท็จจริง

ช่อง
claims[]

Claim

รายการการอ้างสิทธิ์และข้อมูลที่เกี่ยวข้องทั้งหมด
next_page_token

string

โทเค็นการแบ่งหน้าถัดไปในการตอบกลับการค้นหา โดยควรใช้เป็น page_token สำหรับคำขอต่อไปนี้ ค่าว่างหมายถึงไม่มีผลลัพธ์เพิ่มเติม

GetClaimReviewMarkupPageRequest

คำขอรับมาร์กอัป ClaimReview ในหน้าเว็บ

ช่อง
name

string

ชื่อของทรัพยากรที่จะรับในรูปแบบ pages/{page_id}

ListClaimReviewMarkupPagesRequest

ขอให้แสดงมาร์กอัป ClaimReview

ช่อง
url

string

URL ที่จะรับมาร์กอัป ClaimReview โดยจะมีผลลัพธ์อย่างมาก 1 รายการ หากมาร์กอัปเชื่อมโยงกับ URL เวอร์ชัน Canonical มากกว่าที่ระบุไว้ เราจะแสดง URL นั้นแทน ระบุพร้อมกับองค์กรไม่ได้
organization

string

องค์กรที่เราต้องการดึงข้อมูลมาร์กอัป เช่น "site.com" ระบุพร้อมกับ URL ไม่ได้
page_size

int32

ขนาดการแบ่งหน้า เราจะแสดงผลการค้นหาให้มากที่สุดเท่าที่ระบุ ค่าเริ่มต้นคือ 10 หากไม่ได้กำหนดไว้ จะไม่มีผลหากมีการขอ URL
page_token

string

โทเค็นการแบ่งหน้า คุณระบุ next_page_token ที่ได้จากคำขอ List ก่อนหน้า (หากมี) เพื่อไปยังหน้าถัดไปได้ ฟิลด์อื่นๆ ทั้งหมดต้องมีค่าเดียวกับในคำขอก่อนหน้า
offset

int32

จำนวนเต็มที่ระบุออฟเซ็ตปัจจุบัน (นั่นคือตำแหน่งผลการค้นหาเริ่มต้น) ในผลการค้นหา ระบบจะพิจารณาช่องนี้เฉพาะในกรณีที่ไม่ได้ตั้งค่า page_token และหากคำขอไม่ได้มีไว้สำหรับ URL ที่เฉพาะเจาะจง เช่น 0 หมายถึงการแสดงผลลัพธ์โดยเริ่มจากผลลัพธ์แรกที่ตรงกัน และ 10 หมายถึงการแสดงผลลัพธ์จากผลลัพธ์ที่ 11

ListClaimReviewMarkupPagesResponse

การตอบกลับจากมาร์กอัปของข้อมูล ClaimReview

ช่อง
claim_review_markup_pages[]

ClaimReviewMarkupPage

รายการผลลัพธ์ของหน้าที่มีมาร์กอัป ClaimReview
next_page_token

string

โทเค็นการแบ่งหน้าถัดไปในการตอบกลับการค้นหา โดยควรใช้เป็น page_token สำหรับคำขอต่อไปนี้ ค่าว่างหมายถึงไม่มีผลลัพธ์เพิ่มเติม

ผู้เผยแพร่

ข้อมูลเกี่ยวกับผู้เผยแพร่โฆษณา

ช่อง
name

string

ชื่อผู้เผยแพร่เนื้อหานี้ เช่น "ข้อเท็จจริงที่น่าทึ่ง"
site

string

ชื่อเว็บไซต์ระดับโฮสต์โดยไม่มีโปรโตคอลหรือคำนำหน้า "www" เช่น "awesomefactchecks.com" ค่าของฟิลด์นี้อิงตาม URL การตรวจสอบการอ้างสิทธิ์เท่านั้น

UpdateClaimReviewMarkupPageRequest

ขอให้อัปเดตมาร์กอัป ClaimReview ทั้งหมดในหน้า

ช่อง
claim_review_markup_page

ClaimReviewMarkupPage

มาร์กอัป ClaimReview ที่อัปเดตแล้วสำหรับหน้านี้ คำขออัปเดตต้องระบุทั้งชื่อทรัพยากรและรหัสเวอร์ชันของทรัพยากรที่จะอัปเดต หากรหัสเวอร์ชันที่ระบุไม่ตรงกับรหัสเวอร์ชันของมาร์กอัปล่าสุด (ซึ่งอาจเกิดขึ้นหากมีการแก้ไขมาร์กอัปตั้งแต่ครั้งล่าสุดที่อ่าน) คำขอนี้จะไม่สำเร็จ นอกจากนี้ การอัปเดตต้องไม่เปลี่ยน URL ของหน้าเว็บด้วย หากต้องการเปลี่ยน URL ของมาร์กอัป ให้ลบมาร์กอัปเก่าและสร้างใหม่ด้วย URL ใหม่