Method: accounts.homepage.claim

매장의 홈페이지 소유권을 주장합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

홈페이지가 이미 소유권 주장이 제기된 경우 판매자가 소유권 주장 및 인증 면제 대상이 아닌 한 인증을 다시 확인하고 성공 응답을 반환합니다. 소유권을 더 이상 확인할 수 없는 경우 오류가 반환되지만 소유권 주장은 삭제되지 않습니다. 실패하면 표준 오류 메시지가 반환됩니다. * PERMISSION_DENIED: 사용자에게 이 MC 계정에 대한 필요한 권한이 없습니다. * FAILED_PRECONDITION: - 계정이 판매자 센터 계정이 아닙니다. - MC 계정에 홈페이지가 없습니다. - 소유권 주장에 실패했습니다 (이 경우 오류 메시지에 자세한 내용이 포함됨).

HTTP 요청

POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 소유권을 주장할 홈페이지의 이름입니다. 형식: accounts/{account}/homepage

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "overwrite": boolean
}
필드
overwrite

boolean

선택사항입니다. 이 옵션을 true로 설정하면 요청된 웹사이트의 기존 소유권 주장이 삭제되고 요청을 한 계정의 소유권 주장으로 대체됩니다.

응답 본문

성공한 경우 응답 본문에 Homepage의 인스턴스가 포함됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.