Package google.factchecking.factchecktools.v1alpha1

الفهرس

خدمة التحقق من صحة الأخبار

واجهة برمجة التطبيقات لأدوات التحقق من صحة الأخبار

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

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

  • التحقق من صحة الأخبار التي تم التحقق منها (تم توفيره من خلال الواجهة الأمامية لأداة التحقق من صحة الأخبار)

  • واجهة CRUD لترميز ClaimReview على الصفحة (يتم تقديمه من خلال الواجهة الأمامية لأداة ترميز "التحقق من صحة الأخبار").

إنشاء ClaimReviewMarkupPage

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
التحقّق من صحة مطالبة المطالبة

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
تعديل ClaimClaimMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

تعديل كل ترميز ClaimReview في الصفحة

ملاحظة: هذا تحديث كامل. للحفاظ على ترميز ClaimReview الحالي على صفحة، يجب أولاً إجراء عملية "الحصول على النص"، ثم تعديل الترميز المعروض، وأخيرًا طلب "التحديث" باستخدام ترميز ClaimReview بالكامل باعتباره النص الأساسي.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

الطلب

معلومات حول المطالبة

الحقول
text

string

نص المطالبة. على سبيل المثال، تضاعفت قيمة "Crime;Crime" في العامين الماضيين&.

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

تمثّل هذه السمة التقييم الرقمي لهذا الادعاء في النطاق 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

التقييم النصي. على سبيل المثال، ""الخطأ&&quot.

language_code

string

اللغة التي تمت كتابة هذه المراجعة بها. على سبيل المثال، "en" أو "de".

ClaimReviewAuthor

معلومات حول مؤلف مراجعة المطالبة

الحقول
name

string

اسم المؤسسة التي تنشر التحقق من صحة الأخبار
تتطابق مع ClaimReview.author.name.

image_url

string

يتطابق مع ClaimReview.author.image.

ترميز ClaimReview

الحقول لعنصر ClaimReview فردي. باستثناء الرسائل الفرعية التي تجمع الحقول معًا، يتوافق كل حقل من هذه الحقول مع الحقول الواردة في https://schema.org/ClaimReview. ونحن ندرج عملية الربط الدقيقة لكل حقل.

الحقول
url

string

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

حذفClaimReviewReviewupPageRequest

طلب حذف كل ترميز ClaimReview في الصفحة.

الحقول
name

string

تمثّل هذه الخاصية اسم المورد المراد حذفه، بالصيغة pages/{page_id}.

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 للعرض من النتيجة الحادية عشر.

التحقّق من صحة مطالبة البحث

ردّ من إجراء بحث عن مطالبات تمّ التحقق من صحتها

الحقول
claims[]

Claim

قائمة المطالبات وكل المعلومات المرتبطة بها

next_page_token

string

الرمز المميّز التالي للتقسيم على صفحات في استجابة "بحث Google" يجب استخدامه كقيمة 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

الرمز المميّز التالي للتقسيم على صفحات في استجابة "بحث Google" يجب استخدامه كقيمة page_token للطلب التالي. تعني القيمة الفارغة أنه لا تتوفر المزيد من النتائج.

الناشر

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

الحقول
name

string

اسم هذا الناشر. على سبيل المثال، "Awesome Fact Checks".

site

string

اسم الموقع الإلكتروني على مستوى المضيف، بدون البروتوكول أو البادئة "www" على سبيل المثال، "awesomefactchecks.com". تستند قيمة هذا الحقل فقط إلى عنوان URL لمراجعة المطالبة.

تعديلClaimClaimReviewMarkupPageRequest

طلب تعديل الترميز ClaimReview على إحدى الصفحات.

الحقول
claim_review_markup_page

ClaimReviewMarkupPage

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