Package google.factchecking.factchecktools.v1alpha1

सूची

फ़ैक्ट चेकटूल सर्विस

फ़ैक्ट चेक टूल एपीआई

तथ्यों की जांच करने वाले टूल का एपीआई, https://g.co/factchecktools पर जाकर, Google तथ्यों की जांच करने वाले टूल से मिलने वाली सुविधाओं को प्रोग्राम के हिसाब से ऐक्सेस करता है.

मौजूदा एपीआई उपलब्ध हैं:

  • फ़ैक्ट चेक्ड दावा खोज (तथ्यों की जांच एक्सप्लोरर फ़्रंटएंड के ज़रिए दी जाती है).

  • किसी पेज पर ClaimReview मार्कअप के लिए सीआरयूडी इंटरफ़ेस (तथ्यों की जांच मार्कअप टूल फ़्रंटएंड के ज़रिए दिया गया).

{/8}मार्कअप पेज बनाएं

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

किसी पेज पर ClaimReview मार्कअप बनाएं.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/userinfo.email
{/8}मार्कअप पेज मिटाएं

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

किसी पेज पर दिए गए सभी ClaimReview मार्कअप मिटाएं.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/userinfo.email
फ़ैक्ट चेक किए गए दावे की खोज

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

तथ्यों की जांच वाले दावों में खोजें.

{/8}मार्कअप पेज पाएं

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

किसी पेज पर सभी ClaimReview मार्कअप पाएं.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/userinfo.email
{/8}मार्कअप पेजों की सूची बनाएं

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

किसी खास यूआरएल या किसी संगठन के लिए, ClaimReview मार्कअप पेज की सूची बनाएं.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/userinfo.email
{/8}मार्कअप पेज अपडेट करें

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

इस दावे की अंकों में रेटिंग, सबसे खराब रेटिंग के दायरे में — सबसे अच्छी रेटिंग शामिल है.
, 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

इस दावे की समीक्षा का यूआरएल.

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 से मेल खाता है.

ClaimReviewमार्कअप

किसी एक ClaimReview एलिमेंट के लिए फ़ील्ड. फ़ील्ड मैसेज को एक साथ ग्रुप करने वाले सब-मैसेज को छोड़कर, इनमें से हर फ़ील्ड https://schema.org/ClaimReview में मौजूद फ़ील्ड से मेल खाता है. हम हर फ़ील्ड के लिए सटीक मैपिंग बताते हैं.

फ़ील्ड
url

string

यह फ़ील्ड वैकल्पिक है और पेज के यूआरएल के लिए डिफ़ॉल्ट रूप से सेट होगा. डिफ़ॉल्ट वैल्यू को ओवरराइड करने के लिए, हम यह फ़ील्ड उपलब्ध कराते हैं. हालांकि, पेज के यूआरएल के साथ-साथ एक वैकल्पिक ऐंकर लिंक ("page Jump") ही डाला जा सकता है.
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

इस दावे की समीक्षा की रेटिंग के बारे में जानकारी.

ClaimReviewमार्कअप पेज

किसी वेबपेज के लिए, ClaimReview मार्कअप में एक या उससे ज़्यादा इंस्टेंस शामिल होते हैं.

फ़ील्ड
name

string

इस ClaimReview मार्कअप पेज रिसॉर्स का नाम, pages/{page_id} के रूप में. अपडेट करने के अनुरोधों को छोड़कर, यह फ़ील्ड सिर्फ़ आउटपुट के तौर पर काम करता है. इसे उपयोगकर्ता को सेट नहीं करना चाहिए.

page_url

string

इस ClaimReview मार्कअप से जुड़े पेज का यूआरएल. हर ClaimReview का अपना यूआरएल फ़ील्ड होता है. हालांकि, हर पेज के लिए यह पेज-लेवल का फ़ील्ड होता है. इस पेज पर मौजूद हर ClaimReview का इस्तेमाल तब तक किया जाएगा, जब तक इसे अलग से नहीं बदला जाता.
ClaimReview.url के अनुरूप है

publish_date

string

तथ्यों की जांच प्रकाशित करने की तारीख. यूआरएल की तरह ही, यह पेज के लेवल का फ़ील्ड भी होता है. इस पेज पर मौजूद हर ClaimReview की वैल्यू एक जैसी होगी.
ClaimReview.datePublished के अनुरूप है

claim_review_author

ClaimReviewAuthor

इस दावे की समीक्षा करने वाले व्यक्ति की जानकारी. ऊपर दिए गए तरीके की तरह, ये पेज लेवल के फ़ील्ड भी होते हैं. इस पेज पर मौजूद हर ClaimReview की वैल्यू एक जैसी होंगी.

claim_review_markups[]

ClaimReviewMarkup

इस पेज के लिए, दावे से जुड़ी अलग-अलग समीक्षाओं की एक सूची. सूची का हर आइटम एक ClaimReview एलिमेंट से जुड़ा है.

version_id

string

इस मार्कअप का वर्शन आईडी. अपडेट करने के अनुरोधों को छोड़कर, यह फ़ील्ड सिर्फ़ आउटपुट के तौर पर काम करता है. इसे उपयोगकर्ता को सेट नहीं करना चाहिए.

{/8}मार्कअप पेज अनुरोध बनाएं

किसी पेज पर ClaimReview मार्कअप बनाने का अनुरोध करें.

फ़ील्ड
claim_review_markup_page

ClaimReviewMarkupPage

इस पेज के लिए बनाया जाने वाला ClaimReview मार्कअप. अगर पेज के यूआरएल का ज़्यादा कैननिकल वर्शन दिया गया है, तो हम यूआरएल के बजाय कैननिकल पेज का इस्तेमाल करेंगे.

ClaimReviewमार्कअप पेज अनुरोध मिटाएं

किसी पेज पर मौजूद सभी 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 का मतलब 11वें नतीजे से आना चाहिए.

FactCheckedClaimSearchResponse

तथ्यों की जांच से जुड़े दावों की खोज करने पर मिला जवाब.

फ़ील्ड
claims[]

Claim

दावों की सूची और उनसे जुड़ी जानकारी.

next_page_token

string

Search के जवाब में, पेजों का क्रम तय करने का अगला टोकन. इसे इस अनुरोध के लिए page_token के तौर पर इस्तेमाल किया जाना चाहिए. खाली वैल्यू का मतलब है कि कोई और नतीजा नहीं.

{/8}मार्कअप पेज के अनुरोध पाना

किसी पेज पर ClaimReview मार्कअप पाने का अनुरोध करें.

फ़ील्ड
name

string

पाने वाले संसाधन का नाम, pages/{page_id} के रूप में.

करंसीमार्कअप पेजों के अनुरोध की सूची बनाएं

ClaimReview मार्कअप की लिस्टिंग करने के लिए अनुरोध.

फ़ील्ड
url

string

वह यूआरएल जिससे ClaimReview मार्कअप मिलेगा. ज़्यादा से ज़्यादा एक नतीजा मिलेगा. अगर मार्कअप किसी यूआरएल के कैननिकल वर्शन से जुड़ा हुआ है, तो हम उसके बजाय वह यूआरएल दिखाएंगे. किसी संगठन के साथ नहीं दिया जा सकता.

organization

string

वह संगठन जिसके लिए हम मार्कअप लाना चाहते हैं. उदाहरण के लिए, "site.com". URL के साथ दिया नहीं जा सकता.

page_size

int32

पेज पर नंबर डालने का साइज़. हम आपको उतने ही नतीजे दिखाएंगे. अगर नीति सेट नहीं है, तो डिफ़ॉल्ट वैल्यू 10 होती है. अगर यूआरएल के लिए अनुरोध किया जाता है, तो कोई असर नहीं पड़ेगा.

page_token

string

पेज पर नंबर डालने वाला टोकन. अगले पेज का अनुरोध करने के लिए, आप सूची में मौजूद पिछले अनुरोध (अगर कोई हो) से मिला next_page_token दे सकते हैं. अन्य सभी फ़ील्ड के मान पिछले अनुरोध के समान होने चाहिए.

offset

int32

एक पूर्णांक जो खोज नतीजों में मौजूदा ऑफ़सेट (यानी नतीजे की जगह) को बताता है. यह फ़ील्ड तभी माना जाता है, जब page_token सेट न हो. साथ ही, यह अनुरोध किसी खास यूआरएल के लिए नहीं किया गया हो. उदाहरण के लिए, 0 का मतलब है कि पहले मेल खाने वाले नतीजे से शुरू होने वाले नतीजे दिखाए जाएंगे और 10 का मतलब 11वें नतीजे से आना चाहिए.

रिकॉर्डिंग की सूची के लिए {/8}मार्कअप पेज का जवाब

ClaimReview मार्कअप की सूची से जवाब.

फ़ील्ड
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview मार्कअप के पेजों की नतीजे की सूची.

next_page_token

string

Search के जवाब में, पेजों का क्रम तय करने का अगला टोकन. इसे इस अनुरोध के लिए page_token के तौर पर इस्तेमाल किया जाना चाहिए. खाली वैल्यू का मतलब है कि कोई और नतीजा नहीं.

पब्लिशर

पब्लिशर के बारे में जानकारी.

फ़ील्ड
name

string

इस पब्लिशर का नाम. उदाहरण के लिए, &Awesome Fact Checks".

site

string

प्रोटोकॉल या "www" प्रीफ़िक्स के बिना होस्ट-लेवल साइट का नाम. उदाहरण के लिए, "awesomefactchecks.com". इस फ़ील्ड का यह मान पूरी तरह से दावे की समीक्षा वाले यूआरएल पर आधारित है.

{/8}मार्कअप पेज के अनुरोध को अपडेट करना

किसी पेज पर सभी ClaimReview मार्कअप को अपडेट करने का अनुरोध करें.

फ़ील्ड
claim_review_markup_page

ClaimReviewMarkupPage

इस पेज के लिए, अपडेट किया गया ClaimReview मार्कअप. अपडेट के अनुरोधों के लिए, संसाधन का नाम और संसाधन का वर्शन आईडी, दोनों अपडेट होने चाहिए. अगर बताया गया वर्शन आईडी, नए मार्कअप के वर्शन आईडी से मेल नहीं खाता है, तो यह अनुरोध स्वीकार नहीं किया जाएगा. ऐसा तब हो सकता है, जब मार्कअप को पिछली बार पढ़े जाने के बाद बदला गया हो. बदलावों से पेज का यूआरएल भी नहीं बदलना चाहिए. मार्कअप का यूआरएल बदलने के लिए, पुराने मार्कअप को मिटाएं और उसे नए यूआरएल के साथ फिर से बनाएं.