Package google.factchecking.factchecktools.v1alpha1

الفهرس

FactCheckToolsService

Fact Check Tools API

توفّر واجهة برمجة التطبيقات Fact Check Tools API إمكانية الوصول الآلي إلى الوظائف المتاحة من خلال الواجهة الأمامية لأدوات التحقّق من صحة الأخبار من Google على https://g.co/factchecktools.

في ما يلي واجهات برمجة التطبيقات المتاحة حاليًا:

  • أداة البحث عن معلومات تم التحقّق من صحتها (يتم توفيرها من خلال الواجهة الأمامية لأداة Fact Check Explorer)
  • البحث عن ادعاء تم التحقّق من صحته باستخدام صورة (يتم توفير هذه الميزة من خلال الواجهة الأمامية لأداة Fact Check Explorer)

  • واجهة 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

نص المطالبة على سبيل المثال، "تضاعفت الجريمة في العامَين الأخيرَين".
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

تمثّل هذه السمة التقييم الرقمي لهذا الادّعاء في نطاق يتراوح بين 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 للصفحة. نوفّر هذا الحقل للسماح لك بتجاهل القيمة التلقائية، ولكنّ التجاوز الوحيد المسموح به هو عنوان 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 من عدد الطلبات إلى الموقع الإلكتروني لمنع إساءة الاستخدام. يجب عدم الاعتماد على الصور المستضافة خارجيًا في تطبيقات الإنتاج.
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 عرض النتائج بدءًا من النتيجة الحادية عشرة.

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 تم إرجاعه من طلب "القائمة" السابق، إذا كان ذلك منطبقًا، للحصول على الصفحة التالية. يجب أن تتضمّن جميع الحقول الأخرى القيم نفسها الواردة في الطلب السابق.
offset

int32

عدد صحيح يحدّد الإزاحة الحالية (أي موقع النتيجة الأولى) في نتائج البحث. لا يتم أخذ هذا الحقل في الاعتبار إلا إذا لم يتم ضبط page_token. على سبيل المثال، يعني الرقم 0 عرض النتائج بدءًا من النتيجة الأولى المطابقة، ويعني الرقم 10 عرض النتائج بدءًا من النتيجة الحادية عشرة.

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 تم إرجاعه من طلب "القائمة" السابق، إذا كان ذلك منطبقًا، للحصول على الصفحة التالية. يجب أن تتضمّن جميع الحقول الأخرى القيم نفسها الواردة في الطلب السابق.
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" على سبيل المثال، "awesomefactchecks.com". تستند قيمة هذا الحقل إلى عنوان URL الخاص بمراجعة الادعاء فقط.

UpdateClaimReviewMarkupPageRequest

طلب تعديل كل ترميز ClaimReview على صفحة

الحقول
claim_review_markup_page

ClaimReviewMarkupPage

تم تعديل ترميز ClaimReview لهذه الصفحة. يجب أن تحدّد طلبات التعديل اسم المورد ورقم تعريف الإصدار المطلوب تعديله. إذا كان رقم تعريف الإصدار المحدّد لا يتطابق مع رقم تعريف الإصدار الخاص بأحدث ترميز (وهو ما قد يحدث إذا تم تعديل الترميز منذ آخر قراءة)، سيتعذّر تنفيذ هذا الطلب. يجب أيضًا ألا تؤدي التعديلات إلى تغيير عنوان URL للصفحة. لتغيير عنوان URL الخاص بالترميز، احذف الترميز القديم وأعِد إنشائه باستخدام عنوان URL الجديد.