Package google.factchecking.factchecktools.v1alpha1

색인

FactCheckToolsService

사실확인 도구 API

Fact Check Tools API는 https://g.co/factchecktools에서 Google 팩트 체크 도구 프런트엔드를 통해 제공되는 기능에 대한 프로그래매틱 액세스를 제공합니다.

현재 사용 가능한 API는 다음과 같습니다.

  • 사실확인 주장 검색 (Fact Check Explorer 프런트엔드를 통해 제공됨)

  • 페이지의 ClaimReview 마크업에 대한 CRUD 인터페이스 (사실확인 마크업 도구 프런트엔드를 통해 제공됨)

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

페이지에 ClaimReview 마크업을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/userinfo.email
DeleteClaimReviewMarkupPage 삭제

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)

특정 URL 또는 조직의 ClaimReview 마크업 페이지를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/userinfo.email
UpdateClaimReviewMarkupPage 업데이트

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

페이지의 모든 ClaimReview 마크업 업데이트

이것은 전체 업데이트입니다. 페이지의 기존 ClaimReview 마크업을 유지하려면 먼저 Get 작업을 실행한 후 반환된 마크업을 수정하고 마지막으로 전체 ClaimReview 마크업을 본문으로 사용하여 업데이트를 호출합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

소유권 주장

소유권 주장에 대한 정보

필드
text

string

소유권 주장 텍스트 예를 들어 "Crime은 지난 2년 동안 2배로 증가했습니다."

claimant

string

주장을 언급한 개인 또는 조직 예: "John Doe"

claim_date

Timestamp

소유권 주장이 제기된 날짜

claim_review[]

ClaimReview

이 소유권 주장에 대한 하나 이상의 검토 (즉, 사실확인 기사)입니다.

소유권 주장 작성자

소유권 주장 작성자에 관한 정보

필드
name

string

주장을 언급한 개인 또는 조직 예: "John Doe"
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

텍스트 평점입니다. 예를 들어 '대부분 거짓'입니다.

language_code

string

이 리뷰의 작성 언어입니다. 예를 들어 'ko' 또는 'de'입니다.

ClaimReview작성자

소유권 주장 검토 작성자에 관한 정보

필드
name

string

사실확인을 게시하는 조직의 이름입니다.
ClaimReview.author.name에 해당합니다.

image_url

string

ClaimReview.author.image에 해당합니다.

ClaimReviewMarkup

개별 ClaimReview 요소의 필드입니다. 필드를 그룹화하는 하위 메시지를 제외하고 이러한 각 필드는 https://schema.org/ClaimReview의 메시지에 해당합니다. 각 필드의 정확한 매핑이 나열됩니다.

필드
url

string

이 입력란은 선택사항이며 기본적으로 페이지 URL로 설정됩니다. 기본값을 재정의할 수 있도록 이 필드가 제공되지만 허용되는 유일한 재정의는 페이지 URL과 선택적 앵커 링크 ("페이지 점프&quot)입니다.
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 마크업과 연결된 페이지의 URL입니다. 모든 개별 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

이 마크업의 버전 ID입니다. 업데이트 요청을 제외하고 이 필드는 출력 전용이며 사용자가 설정하면 안 됩니다.

CreateClaimReviewMarkupPageRequest 요청

페이지에 ClaimReview 마크업을 만들도록 요청합니다.

필드
claim_review_markup_page

ClaimReviewMarkupPage

이 페이지에 만들 ClaimReview 마크업입니다. 제공된 페이지 URL의 표준 버전이 있다면 이 버전을 대신 사용합니다.

DeleteClaimReviewMarkupPageRequest 삭제

페이지의 모든 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

페이지로 나누기 토큰입니다. 이전 List 요청에서 반환된 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 마크업을 가져올 URL입니다. 최대 1개의 결과가 표시됩니다. 마크업이 제공된 URL의 표준 버전과 연결된 경우 이 URL을 대신 반환합니다. 조직과 함께 지정할 수 없습니다.

organization

string

마크업을 가져올 조직입니다. 예: "site.com" URL과 함께 지정할 수 없습니다.

page_size

int32

페이지로 나누기 크기입니다. 최대 개수의 결과를 제공하겠습니다. 설정하지 않을 경우 기본값은 10입니다. URL이 요청되면 아무런 영향을 미치지 않습니다.

page_token

string

페이지로 나누기 토큰입니다. 이전 List 요청에서 반환된 next_page_token(있는 경우)를 제공하여 다음 페이지를 가져올 수 있습니다. 다른 모든 필드의 값은 이전 요청과 같아야 합니다.

offset

int32

검색결과에서 현재 오프셋 (즉, 시작 위치)을 지정하는 정수입니다. 이 필드는 page_token가 설정되지 않은 경우 및 특정 URL에 대한 요청이 아닌 경우에만 고려됩니다. 예를 들어 0은 일치하는 첫 번째 결과부터 결과를 반환하고 10은 11번째 결과부터 반환함을 의미합니다.

ListClaimReviewMarkupPagesResponse

ClaimReview 마크업 나열에 대한 응답입니다.

필드
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview 마크업의 결과 목록입니다.

next_page_token

string

검색 응답의 다음 페이지로 나누기 토큰입니다. 다음 요청에는 page_token로 사용되어야 합니다. 값이 비어 있으면 더 이상 결과가 표시되지 않습니다.

게시자

게시자에 관한 정보입니다.

필드
name

string

이 게시자의 이름입니다. 예: "Awesome Fact Checks"

site

string

프로토콜 또는 'www'를 제외한 호스트 수준 사이트 이름입니다. 예: "awesomefactchecks.com" 이 필드의 값은 순전히 소유권 주장 검토 URL만을 기준으로 합니다.

UpdateClaimReviewMarkupPageRequest 요청

페이지의 모든 ClaimReview 마크업 업데이트를 요청합니다.

필드
claim_review_markup_page

ClaimReviewMarkupPage

이 페이지의 업데이트된 ClaimReview 마크업입니다. 업데이트 요청은 업데이트할 리소스의 리소스 이름과 버전 ID를 모두 지정해야 합니다. 지정된 버전 ID가 최신 마크업의 버전 ID와 일치하지 않는 경우 (마지막 마크업 이후 마크업이 수정된 경우 발생할 수 있음) 이 요청은 실패합니다. 업데이트해도 페이지 URL이 변경되면 안 됩니다. 마크업의 URL을 변경하려면 이전 마크업을 삭제하고 새 URL로 다시 만듭니다.