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).

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

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage( CreateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

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

محدوده مجوز

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

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

rpc DeleteClaimReviewMarkupPage( DeleteClaimReviewMarkupPageRequest ) returns ( Empty )

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

محدوده مجوز

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

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

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
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage( UpdateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

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

توجه داشته باشید که این یک به روز رسانی کامل است. برای حفظ نشانه گذاری موجود در ClaimReview در یک صفحه، ابتدا یک عملیات Get انجام دهید، سپس نشانه گذاری برگشتی را تغییر دهید و در نهایت Update را با کل نشانه گذاری ClaimReview به عنوان بدنه فراخوانی کنید.

محدوده مجوز

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

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

مطالبه

اطلاعات در مورد ادعا

زمینه های
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} .

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 جدید دوباره ایجاد کنید.