Package google.factchecking.factchecktools.v1alpha1

색인

FactCheckToolsService

Fact Check Tools API

사실확인 도구 API는 https://g.co/factchecktools의 Google 사실확인 도구 프런트엔드를 통해 제공되는 기능에 프로그래매틱 방식으로 액세스할 수 있도록 지원합니다.

현재 사용할 수 있는 API는 다음과 같습니다.

  • 사실 확인된 주장 검색 (사실확인 탐색기 프런트엔드를 통해 제공됨)
  • 이미지를 통한 사실확인 주장 검색 (사실확인 탐색기 프런트엔드를 통해 제공)

  • 페이지의 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)

특정 URL 또는 조직의 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

주장 텍스트입니다. 예를 들어 '지난 2년 동안 범죄가 두 배로 증가했습니다.'
claimant

string

주장을 제기하는 개인 또는 조직입니다. 예를 들어 'John Doe'입니다.
claim_date

Timestamp

신청이 제출된 날짜입니다.
claim_review[]

ClaimReview

이 주장에 대한 하나 이상의 리뷰 (즉, 사실확인 기사)입니다.

ClaimAuthor

주장 작성자에 관한 정보입니다.

필드
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에 해당합니다.

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

이 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이 제공되면 해당 URL이 대신 사용됩니다.

DeleteClaimReviewMarkupPageRequest

페이지의 모든 ClaimReview 마크업 삭제 요청입니다.

필드
name

string

삭제할 리소스의 이름으로, pages/{page_id} 형식입니다.

FactCheckedClaimImageSearchRequest

이미지로 사실확인된 주장을 검색하는 요청입니다.

필드
image_uri

string

필수입니다. 소스 이미지의 URI입니다. 공개적으로 액세스 가능한 이미지 HTTP/HTTPS URL이어야 합니다.

HTTP/HTTPS URL에서 이미지를 가져올 때 Google은 요청 완료를 보장할 수 없습니다. 지정된 호스트가 요청을 거부하거나 (예: 요청 제한 또는 DOS 예방으로 인해) 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은 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 마크업을 가져올 URL입니다. 결과는 최대 1개입니다. 마크업이 제공된 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은 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로 다시 만드세요.