Package google.factchecking.factchecktools.v1alpha1

אינדקס

• FactCheckToolsService (ממשק)
• Claim (הודעה)
• ClaimAuthor (הודעה)
• ClaimRating (הודעה)
• ClaimReview (הודעה)
• ClaimReviewAuthor (הודעה)
• ClaimReviewMarkup (הודעה)
• ClaimReviewMarkupPage (הודעה)
• CreateClaimReviewMarkupPageRequest (הודעה)
• DeleteClaimReviewMarkupPageRequest (הודעה)
• FactCheckedClaimSearchRequest (הודעה)
• FactCheckedClaimSearchResponse (הודעה)
• GetClaimReviewMarkupPageRequest (הודעה)
• ListClaimReviewMarkupPagesRequest (הודעה)
• ListClaimReviewMarkupPagesResponse (הודעה)
• Publisher (הודעה)
• UpdateClaimReviewMarkupPageRequest (הודעה)

שירות FactCheckTools

ממשק 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

DeleteClaimReviewMarkupPage
rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty) מחיקה של כל תגי העיצוב של ClaimReview בדף. היקפי הרשאה נדרשת רמת OAuth הבאה: https://www.googleapis.com/auth/userinfo.email

בדיקת עובדות על הצהרת בעלות בחיפוש
rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse) לחפש בין הטענות שנבדקו.

GetClaimReviewMarkupPage
rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage) הוספת כל תגי העיצוב של ClaimReview לדף. היקפי הרשאה נדרשת רמת OAuth הבאה: https://www.googleapis.com/auth/userinfo.email

ListClaimReviewMarkupPages
rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse) יש לרשום את ClaimReview דפי הסימון של כתובת URL ספציפית או של ארגון. היקפי הרשאה נדרשת רמת OAuth הבאה: https://www.googleapis.com/auth/userinfo.email

עדכון{ClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage) עדכון לגבי כל תגי העיצוב של ClaimReview בדף לידיעתך, זהו עדכון מלא. כדי לשמור על תגי העיצוב הקיימים של ClaimReview בדף, קודם צריך לבצע פעולת 'הורדה', ואז לשנות את תגי העיצוב שהוחזרו, ולבסוף להפעיל את 'עדכון' עם כל הסימון של ClaimReview בתור גוף הטקסט. היקפי הרשאה נדרשת רמת OAuth הבאה: https://www.googleapis.com/auth/userinfo.email

הצהרה

מידע על התלונה.

שדות
text	string הטקסט של התלונה. לדוגמה, "פשע הכפיל את עצמו בשנתיים האחרונות."
claimant	string אדם או ארגון שהצהירו על זכויות יוצרים בסרטון. למשל, "ישראל כהן".
claim_date	Timestamp התאריך שבו הוגשה התלונה.
claim_review[]	ClaimReview לפחות תלונה אחת על התלונה הזו (כלומר, מאמר לבדיקת עובדות).

בעלות על מחבר

מידע על המחבר של התלונה.

שדות
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 דירוג מספרי של התלונה הזו, בקטגוריה worsRating – כולל 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.

בדיקת תלונה

מידע על בדיקת תלונות על הפרת זכויות יוצרים.

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

PageReviewMarkupPage

מכיל מופע אחד או יותר של תגי העיצוב 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}.

בדיקת עובדות על הצהרת בעלות בחיפוש

בקשה לחיפוש בתלונות עם בדיקת עובדות.

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

בדיקת עובדות עם תלונות לגבי חיפוש

תגובה מחיפוש תלונות על עובדות שנבדקו.

שדות
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 שהוחזר מבקשה קודמת לרשימה. בכל השדות האחרים צריכים להיות ערכים זהים לאלה שבבקשה הקודמת.
offset	int32 מספר שלם שמציין את ההיסט הנוכחי (כלומר, מיקום התוצאה הראשונית) בתוצאות החיפוש. השדה הזה נחשב רק אם המדיניות page_token לא מוגדרת ואם הבקשה לא עוסקת בכתובת URL ספציפית. לדוגמה, אם 0 מחזירה תוצאות החל מתוצאת ההתאמה הראשונה, ו-10 מחזירה תוצאה מהתוצאה ה-11.

רשימה של תלונות על מוצרים שסומנו

תגובה מרישום ClaimReview.

שדות
claim_review_markup_pages[]	ClaimReviewMarkupPage רשימת התוצאות של תגי עיצוב של ClaimReview.
next_page_token	string אסימון העימוד הבא בתגובת החיפוש. צריך להשתמש בערך page_token בתור הבקשה הבאה. ערך ריק פירושו שלא יתקבלו יותר תוצאות.

בעל אתר

מידע על המוציא לאור.

שדות
name	string שם המוציא לאור הזה. לדוגמה, "בדיקות של עובדות מדהימות".
site	string שם אתר ברמת המארח, ללא הפרוטוקול או הקידומת 'www'. לדוגמה, "awesomefactchecks.com". הערך של השדה הזה מבוסס אך ורק על כתובת האתר לבדיקת התלונה.

עדכוןתלונה

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

שדות

claim_review_markup_page

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