Package google.factchecking.factchecktools.v1alpha1

इंडेक्स

FactCheckToolsService

Fact Check Tools API

Fact Check Tools API, https://g.co/factchecktools पर मौजूद Google Fact Check Tools के फ़्रंटएंड के ज़रिए उपलब्ध कराई गई सुविधा को प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के तहत ऐक्सेस करने की सुविधा देता है.

फ़िलहाल, ये एपीआई उपलब्ध हैं:

  • तथ्यों की जांच किए गए दावों को खोजने की सुविधा. यह सुविधा, Fact Check Explorer के फ़्रंटएंड के ज़रिए उपलब्ध कराई जाती है.
  • इमेज के ज़रिए, तथ्यों की जांच किए गए दावे को खोजना. यह सुविधा, Fact Check Explorer के फ़्रंटएंड के ज़रिए उपलब्ध कराई जाती है.

  • किसी पेज पर ClaimReview मार्कअप के लिए CRUD इंटरफ़ेस (यह फ़ैक्ट चेक मार्कअप टूल के फ़्रंटएंड के ज़रिए उपलब्ध कराया जाता है).

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 मार्कअप वाले पेजों की सूची बनाएं.

अनुमति के स्कोप

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

  • https://www.googleapis.com/auth/factchecktools
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

किसी पेज पर मौजूद सभी ClaimReview मार्कअप के लिए अपडेट

ध्यान दें कि यह पूरा अपडेट है. किसी पेज पर मौजूद ClaimReview मार्कअप को बनाए रखने के लिए, पहले Get ऑपरेशन करें. इसके बाद, मिले हुए मार्कअप में बदलाव करें. आखिर में, पूरे ClaimReview मार्कअप को बॉडी के तौर पर इस्तेमाल करके, Update को कॉल करें.

अनुमति के स्कोप

नीचे दिए गए 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 से मेल खाता है.

दावे की समीक्षा

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

फ़ील्ड
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

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

string

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

ClaimReviewAuthor

दावे की समीक्षा करने वाले व्यक्ति के बारे में जानकारी. ऊपर दिए गए उदाहरण की तरह, सिमैंटिक तौर पर ये पेज लेवल के फ़ील्ड हैं. साथ ही, इस पेज पर मौजूद हर ClaimReview में एक ही वैल्यू होगी.
claim_review_markups[]

ClaimReviewMarkup

इस पेज के लिए, दावे की समीक्षाओं की सूची. सूची में मौजूद हर आइटम, एक ClaimReview एलिमेंट से मेल खाता है.
version_id

string

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

CreateClaimReviewMarkupPageRequest

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

फ़ील्ड
claim_review_markup_page

ClaimReviewMarkupPage

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

DeleteClaimReviewMarkupPageRequest

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

फ़ील्ड
name

string

मिटाए जाने वाले संसाधन का नाम, pages/{page_id} के तौर पर.

FactCheckedClaimImageSearchRequest

तथ्यों की जांच किए गए दावों को इमेज के ज़रिए खोजने का अनुरोध.

फ़ील्ड
image_uri

string

ज़रूरी है. सोर्स इमेज का यूआरआई. यह सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला इमेज एचटीटीपी/एचटीटीपीएस यूआरएल होना चाहिए.

एचटीटीपी/एचटीटीपीएस यूआरएल से इमेज फ़ेच करते समय, Google इस बात की गारंटी नहीं दे सकता कि अनुरोध पूरा हो जाएगा. अगर बताया गया होस्ट, अनुरोध को अस्वीकार करता है, तो हो सकता है कि आपका अनुरोध पूरा न हो. ऐसा इन वजहों से हो सकता है: अनुरोधों को सीमित करना या डीओएस को रोकना. इसके अलावा, अगर Google, साइट पर अनुरोधों को सीमित करता है, तो भी ऐसा हो सकता है. ऐसा इसलिए किया जाता है, ताकि साइट का गलत इस्तेमाल न हो. आपको प्रोडक्शन ऐप्लिकेशन के लिए, Google Play से बाहर होस्ट की गई इमेज पर निर्भर नहीं रहना चाहिए.
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 का मतलब है कि 11वें नतीजे से शुरू करके नतीजे दिखाए जाएं.

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 का मतलब है कि 11वें नतीजे से शुरू करके नतीजे दिखाए जाएं.

FactCheckedClaimSearchResponse

तथ्यों की जांच किए गए दावों को खोजने पर मिला जवाब.

फ़ील्ड
claims[]

Claim

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

string

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

GetClaimReviewMarkupPageRequest

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

फ़ील्ड
name

string

पाए जाने वाले संसाधन का नाम, pages/{page_id} के तौर पर.

ListClaimReviewMarkupPagesRequest

ClaimReview मार्कअप को सूची में शामिल करने का अनुरोध करें.

फ़ील्ड
url

string

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

string

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

int32

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

string

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

int32

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

ListClaimReviewMarkupPagesResponse

लिस्टिंग ClaimReview के मार्कअप से मिला जवाब.

फ़ील्ड
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview मार्कअप वाले पेजों की सूची.
next_page_token

string

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

प्रकाशक

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

फ़ील्ड
name

string

इस पब्लिशर का नाम. उदाहरण के लिए, "तथ्यों की बेहतरीन जांच".
site

string

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

UpdateClaimReviewMarkupPageRequest

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

फ़ील्ड
claim_review_markup_page

ClaimReviewMarkupPage

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