Package google.factchecking.factchecktools.v1alpha1

شاخص

FactCheckToolsService

Fact Check Tools API

Fact Check Tools API دسترسی برنامه‌ریزی شده به عملکرد ارائه شده از طریق Google Fact Check Tools در https://g.co/factchecktools را فراهم می‌کند.

APIهای فعلی موجود عبارتند از:

  • جستجوی ادعای بررسی شده با واقعیت (از طریق قسمت جلویی Fact Check Explorer ارائه می شود).
  • جستجوی ادعای بررسی شده بر اساس تصویر (ارائه شده از طریق قسمت جلویی Fact Check Explorer).

  • رابط CRUD برای نشانه‌گذاری ClaimReview در یک صفحه (ارائه شده از طریق ابزار Fact Check Markup Tool).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage( CreateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

علامت گذاری ClaimReview را در یک صفحه ایجاد کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/factchecktools
حذفClaimReviewMarkupPage

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

شخص یا سازمانی که ادعا را بیان می کند. به عنوان مثال، "جان دو".

claim_date

Timestamp

تاریخی که ادعا شده است.

claim_review[]

ClaimReview

یک یا چند بررسی درباره این ادعا (یعنی یک مقاله راستی‌آزمایی).

ClaimAuthor

اطلاعات مربوط به نویسنده ادعا

فیلدها
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 است.

ClaimRating

اطلاعات در مورد رتبه ادعا.

فیلدها
textual_rating

string

درجه صداقت به عنوان یک کلمه یا عبارت کوتاه قابل خواندن برای انسان.
مربوط به ClaimReview.reviewRating.alternateName است.

rating_value

Int32Value

رتبه بندی عددی این ادعا، در محدوده بدترین رتبه - شامل بهترین رتبه.
مربوط به 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

نشانی وب این بررسی ادعا.

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

این فیلد اختیاری است و به طور پیش فرض به آدرس صفحه خواهد بود. ما این فیلد را ارائه می‌کنیم تا به شما اجازه لغو مقدار پیش‌فرض را بدهیم، اما تنها لغو مجاز، نشانی وب صفحه به‌علاوه یک پیوند لنگر اختیاری ("پرش صفحه") است.
مربوط به 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} .

FactCheckedClaimImageSearch Request

درخواست جستجوی ادعاهای بررسی شده با تصویر.

فیلدها
image_uri

string

مورد نیاز. URI تصویر منبع. این باید یک نشانی وب HTTP/HTTPS تصویر برای دسترسی عموم باشد.

هنگام واکشی تصاویر از نشانی‌های وب HTTP/HTTPS، Google نمی‌تواند تضمین کند که درخواست تکمیل می‌شود. اگر میزبان مشخص شده درخواست را رد کند (مثلاً به دلیل کاهش فشار یا جلوگیری از DOS)، یا اگر Google درخواست‌های سایت را برای جلوگیری از سوء استفاده کند، ممکن است درخواست شما با شکست مواجه شود. برای برنامه های تولیدی نباید به تصاویر میزبان خارجی وابسته باشید.

language_code

string

اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". می تواند برای محدود کردن نتایج بر اساس زبان استفاده شود، اگرچه ما در حال حاضر منطقه را در نظر نمی گیریم.

page_size

int32

اختیاری. اندازه صفحه بندی ما به این تعداد از نتایج باز خواهیم گشت. در صورت تنظیم نشدن، 10 پیش‌فرض است.

page_token

string

اختیاری. نشانه صفحه بندی. شما می توانید next_page_token را که از درخواست لیست قبلی بازگردانده شده است، در صورت وجود، برای دریافت صفحه بعدی ارائه دهید. تمام فیلدهای دیگر باید همان مقادیر درخواست قبلی را داشته باشند.

offset

int32

اختیاری. یک عدد صحیح که افست فعلی (یعنی محل شروع نتیجه) را در نتایج جستجو مشخص می کند. این فیلد فقط در صورتی در نظر گرفته می شود که page_token تنظیم نشده باشد. به عنوان مثال، 0 به معنای بازگشت نتایج از اولین نتیجه منطبق و 10 به معنای بازگشت از نتیجه یازدهم است.

FactCheckedClaimImageSearch Response

پاسخ از جستجوی ادعاهای واقعی بررسی شده با تصویر.

فیلدها
results[]

Result

فهرست ادعاها و تمام اطلاعات مرتبط با آنها.

next_page_token

string

نشانه صفحه بندی بعدی در پاسخ جستجو. باید به عنوان page_token برای درخواست زیر استفاده شود. مقدار خالی به معنای عدم نتیجه بیشتر است.

نتیجه

ادعا و اطلاعات مرتبط با آن

فیلدها
claim

Claim

ادعایی که با درخواست مطابقت داشت.

FactCheckedClaimSearch Request

درخواست جستجو از طریق ادعاهای بررسی شده واقعی.

فیلدها
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 به معنای بازگشت از نتیجه یازدهم است.

FactCheckedClaimSearch Response

پاسخ از جستجوی ادعاهای واقعی بررسی شده.

فیلدها
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 به معنای بازگشت از نتیجه یازدهم است.

ListClaimReviewMarkupPagesResponse

پاسخ از فهرست نشانه گذاری ClaimReview .

فیلدها
claim_review_markup_pages[]

ClaimReviewMarkupPage

لیست نتایج صفحات نشانه گذاری ClaimReview .

next_page_token

string

نشانه صفحه بندی بعدی در پاسخ جستجو. باید به عنوان page_token برای درخواست زیر استفاده شود. مقدار خالی به معنای عدم نتیجه بیشتر است.

ناشر

اطلاعات در مورد ناشر.

فیلدها
name

string

نام این ناشر. به عنوان مثال، "بررسی واقعیت های شگفت انگیز".

site

string

نام سایت در سطح میزبان، بدون پروتکل یا پیشوند «www». به عنوان مثال، "wesomefactchecks.com". این مقدار این فیلد صرفاً بر اساس URL بررسی ادعا است.

UpdateClaimReviewMarkupPageRequest

درخواست به‌روزرسانی تمام نشانه‌گذاری ClaimReview در یک صفحه.

فیلدها
claim_review_markup_page

ClaimReviewMarkupPage

نشانه گذاری ClaimReview به روز شده برای این صفحه. درخواست‌های به‌روزرسانی باید هم نام منبع و هم شناسه نسخه منبع را برای به‌روزرسانی مشخص کنند. اگر شناسه نسخه مشخص‌شده با شناسه نسخه آخرین نشانه‌گذاری مطابقت نداشته باشد (که ممکن است در صورتی رخ دهد که نشانه‌گذاری از آخرین بار خوانده شده اصلاح شده باشد)، این درخواست با شکست مواجه خواهد شد. همچنین به‌روزرسانی‌ها نباید URL صفحه را تغییر دهند. برای تغییر URL نشانه گذاری، نشانه گذاری قدیمی را حذف کرده و با URL جدید دوباره ایجاد کنید.