Package google.factchecking.factchecktools.v1alpha1

אינדקס

FactCheckToolsService

Fact Check Tools API

ממשק Fact Check Tools API מספק גישה פרוגרמטית לפונקציונליות שזמינה דרך ממשק הקצה של Google Fact Check Tools בכתובת https://g.co/factchecktools.

ממשקי ה-API שזמינים כרגע הם:

  • חיפוש טענות שנבדקו (מופיע בחלק הקדמי של הכלי לבדיקת עובדות).
  • חיפוש טענות שעברו בדיקת עובדות באמצעות תמונה (מופיע בחלק הקדמי של הכלי לבדיקת עובדות).

  • ממשק 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 האחרונות".
claimant

string

אדם או ארגון שמגישים את התלונה. לדוגמה, "John Doe".
claim_date

Timestamp

התאריך שבו נשלחה התלונה.
claim_review[]

ClaimReview

אחת או יותר מהבדיקות של התלונה הזו (כלומר, מאמר לבדיקת עובדות).

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 של הדף בתוספת קישור אופציונלי לעוגן (מעבר מהיר לדף).‫
תואם ל-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 לדף אינטרנט.

שדות
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 אחד.
version_id

string

מזהה הגרסה של התג הזה. השדה הזה הוא שדה פלט בלבד, והמשתמש לא צריך להגדיר אותו, למעט במקרים של בקשות עדכון.

CreateClaimReviewMarkupPageRequest

בקשה ליצירת תגי עיצוב ClaimReview בדף.

שדות
claim_review_markup_page

ClaimReviewMarkupPage

תגי העיצוב ClaimReview שצריך ליצור לדף הזה. אם יש גרסה קנונית יותר של כתובת ה-URL של הדף שצוינה, נשתמש בה במקום זאת.

DeleteClaimReviewMarkupPageRequest

בקשה למחיקה של כל תגי העיצוב ClaimReview בדף.

שדות
name

string

שם המשאב שרוצים למחוק, בפורמט pages/{page_id}.

FactCheckedClaimImageSearchRequest

בקשה לחיפוש טענות שנבדקו על ידי בדיקת עובדות באמצעות תמונה.

שדות
image_uri

string

חובה. ה-URI של תמונת המקור. זו חייבת להיות כתובת URL מסוג HTTP או HTTPS של תמונה שזמינה לכולם.

כשמאחזרים תמונות מכתובות URL של HTTP/HTTPS, ‏ Google לא יכולה להבטיח שהבקשה תושלם. יכול להיות שהבקשה תיכשל אם המארח שצוין דוחה את הבקשה (לדוגמה, בגלל הגבלת קצב הבקשות או מניעת התקפות מניעת שירות), או אם Google מגבילה את קצב הבקשות לאתר כדי למנוע ניצול לרעה. לא מומלץ להסתמך על תמונות שמתארחות מחוץ ל-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. תופיע תוצאה אחת לכל היותר. אם התגיות משויכות לגרסה קנונית יותר של כתובת ה-URL שצוינה, נחזיר את כתובת ה-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 החדשה.