Package google.factchecking.factchecktools.v1alpha1

ดัชนี

บริการเครื่องมือตรวจสอบข้อเท็จจริง

API เครื่องมือตรวจสอบข้อเท็จจริง

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

API ปัจจุบันที่ใช้ได้มีดังนี้

  • การค้นหาคํากล่าวอ้างที่ตรวจสอบข้อเท็จจริง (ได้มาจากฟรอนท์เอนด์ของโปรแกรมสํารวจข้อเท็จจริง)

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

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

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

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

  • https://www.googleapis.com/auth/userinfo.email
ลบการอ้างสิทธิ์รีวิวมาร์กอัปหน้า

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

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

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

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

  • https://www.googleapis.com/auth/userinfo.email
FactCheckClaimClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

ค้นหาในการอ้างสิทธิ์ที่มีการตรวจสอบข้อเท็จจริง
รับหน้าตรวจสอบมาร์กอัปหน้า

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

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

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

  • https://www.googleapis.com/auth/userinfo.email
แสดงรายการClaimReviewMarkupPages

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

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

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

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

  • https://www.googleapis.com/auth/userinfo.email
อัปเดตการอ้างสิทธิ์ตรวจสอบมาร์กอัปหน้า

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

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

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

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

  • https://www.googleapis.com/auth/userinfo.email

การอ้างสิทธิ์

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

ช่อง
text

string

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

claimant

string

บุคคลหรือองค์กรที่ระบุการอ้างสิทธิ์ เช่น "สมชาย สกุลดี"

claim_date

Timestamp

วันที่ที่มีการอ้างสิทธิ์

claim_review[]

ClaimReview

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

ผู้เขียนการอ้างสิทธิ์

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

ช่อง
name

string

บุคคลหรือองค์กรที่ระบุการอ้างสิทธิ์ เช่น "สมชาย สกุลดี"
ตรงกับ 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

การจัดประเภทการอ้างสิทธิ์

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

ช่อง
textual_rating

string

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

rating_value

Int32Value

คะแนนที่เป็นตัวเลขของคํากล่าวอ้างนี้ ซึ่งอยู่ในช่วงคะแนนwstRating — ที่ดีที่สุดคือคะแนน
ตรงกับ 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"

ตรวจสอบผู้เขียน

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

ช่อง
name

string

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

image_url

string

เป็นไปตาม ClaimReview.author.image

ตรวจสอบมาร์กอัป

ช่องสําหรับองค์ประกอบ 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

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

อ้างสิทธิ์รีวิวมาร์กอัปหน้า

ระงับมาร์กอัป 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}

Factตรวจสอบการอ้างสิทธิ์การค้นหา

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

ช่อง
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 ที่ส่งคืนมาจากคําขอรายการก่อนหน้า (หากมี) เพื่อรับหน้าถัดไป ช่องอื่นๆ ทั้งหมดต้องมีค่าเหมือนกับในคําขอก่อนหน้า

offset

int32

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

FactCheckClaimSearchResponse

คําตอบจากการค้นหาการอ้างสิทธิ์ที่ตรวจสอบข้อเท็จจริงแล้ว

ช่อง
claims[]

Claim

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

next_page_token

string

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

รับการอ้างสิทธิ์รีวิวมาร์กอัปหน้าคําขอ

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

ช่อง
name

string

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

ListClaimReviewMarkupPagesRequest

คําขอการแสดงมาร์กอัป ClaimReview

ช่อง
url

string

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

organization

string

องค์กรที่เราต้องการเรียกมาร์กอัป ตัวอย่างเช่น "site.com" ไม่สามารถระบุร่วมกับ URL

page_size

int32

ขนาดการใส่เลขหน้า และจะให้ผลการค้นหามากขนาดนั้น ค่าเริ่มต้นเป็น 10 หากไม่ได้ตั้งค่าไว้ ไม่มีผลใดๆ หากมีการขอ URL

page_token

string

โทเค็นการใส่เลขหน้า คุณอาจระบุ next_page_token ที่ส่งคืนมาจากคําขอรายการก่อนหน้า (หากมี) เพื่อรับหน้าถัดไป ช่องอื่นๆ ทั้งหมดต้องมีค่าเหมือนกับในคําขอก่อนหน้า

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 ใหม่