Package google.shopping.merchant.accounts.v1beta

색인

AccountIssueService

AccountIssueService API를 지원하는 서비스

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

판매자 센터 계정의 모든 계정 문제를 나열합니다.

승인 범위

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

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

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

AccountTaxService

계정 수준의 세금 설정 데이터를 관리합니다.

이 API는 다음 리소스 모델을 정의합니다.

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

GetAccountTaxRequest의 조건과 일치하는 세금 규칙을 반환합니다.

승인 범위

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

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

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

ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

판매자 센터 계정에만 하위 계정의 세금 설정을 나열합니다. 이 메서드는 멀티 클라이언트 계정에서만 호출할 수 있으며, 그렇지 않으면 오류를 반환합니다.

승인 범위

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

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

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

UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

계정의 세금 설정을 업데이트합니다.

승인 범위

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

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

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

AccountsService

계정 API를 지원하는 서비스입니다.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

추가 구성이 있는 독립형 판매자 센터 계정을 만듭니다. 요청을 하는 사용자를 새 계정의 관리자로 추가합니다.

승인 범위

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

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

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

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

독립형, MCA, 하위 계정 중 유형에 관계없이 지정된 계정을 삭제합니다. MCA를 삭제하면 모든 하위 계정이 삭제됩니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

판매자 센터 계정에서 계정을 검색합니다. 계정을 삽입, 업데이트 또는 삭제한 후 변경사항이 적용되기까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

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

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

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

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

호출하는 사용자가 액세스할 수 있고 페이지 크기 또는 필터와 같은 요청의 제약 조건과 일치하는 계정을 나열합니다. 여기에는 MCA의 하위 계정만 나열되는 것이 아니라 호출하는 사용자가 다른 MCA, 연결된 계정, 독립형 계정 등을 포함하여 액세스할 수 있는 모든 계정이 표시됩니다.

승인 범위

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

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

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

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

특정 멀티 클라이언트 계정의 모든 하위 계정을 나열합니다. 이는 더 강력한 ListAccounts 메서드를 위한 편의 래퍼입니다. 이 메서드는 relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION")) 필터를 사용하여 ListsAccounts를 호출하는 것과 동일한 결과를 생성합니다.

승인 범위

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

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

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

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

독립형, MCA, 하위 계정 등 유형과 관계없이 계정을 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

BusinessIdentityService

비즈니스 ID API를 지원하는 서비스

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

계정의 비즈니스 ID를 검색합니다.

승인 범위

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

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

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

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

계정의 비즈니스 식별 정보를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

BusinessInfoService

비즈니스 정보 API를 지원하는 서비스입니다.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

계정의 비즈니스 정보를 검색합니다.

승인 범위

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

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

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

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

계정의 비즈니스 정보를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

EmailPreferencesService

EmailPreferences API를 지원하는 서비스

이 서비스는 인증된 사용자의 이메일 환경설정 검색 및 업데이트만 허용합니다.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

판매자 센터 계정 사용자의 이메일 환경설정을 반환합니다.

name=accounts/*/users/me/emailPreferences 별칭을 사용하여 인증된 사용자의 환경설정을 가져옵니다.

승인 범위

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

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

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

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

판매자 센터 계정 사용자의 이메일 환경설정을 업데이트합니다. MCA 사용자는 MCA의 하위 계정이 아닌 MCA 계정을 지정해야 합니다.

업데이트 마스크에서 명시적으로 선택되지 않은 환경설정은 업데이트되지 않습니다.

업데이트에 UNCONFIRMED 선택 상태 값을 지정하는 것은 유효하지 않습니다.

name=accounts/*/users/me/emailPreferences 별칭을 사용하여 인증된 사용자의 환경설정을 업데이트합니다.

승인 범위

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

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

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

HomepageService

매장 홈페이지에 대한 API를 지원하는 서비스입니다.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

매장의 홈페이지에 대한 소유권을 주장합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

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

승인 범위

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

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

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

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

매장의 홈페이지를 검색합니다.

승인 범위

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

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

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

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

매장 홈페이지의 소유권 주장을 취소합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

매장의 홈페이지를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

OnlineReturnPolicyService

이 서비스는 광고와 무료 등록정보 모두에 적용되는 반품 정책을 포괄하는 판매자의 변심에 의한 반품 정책 구성을 쉽게 관리할 수 있도록 지원합니다.

있습니다. 이 API는 다음 리소스 모델을 정의합니다.

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

기존 반품 정책을 가져옵니다.

승인 범위

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

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

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

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

모든 기존 반품 정책을 나열합니다.

승인 범위

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

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

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

ProgramsService

프로그램 관리를 위한 서비스

프로그램은 판매자 계정에 기능을 추가하는 메커니즘을 제공합니다. 대표적인 예로 판매자 매장의 제품을 Google 서비스 전반에 무료로 표시할 수 있는 무료 제품 등록정보 프로그램이 있습니다.

이 서비스는 각 프로그램에 대한 참여를 명시적으로 활성화하거나 비활성화하는 메서드 외에 사용 가능한 모든 프로그램에 대한 판매자의 참여를 가져오는 메서드를 노출합니다.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

계정에 대해 지정된 프로그램에 대한 참여를 중지합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

계정에 대해 지정된 프로그램에 참여할 수 있도록 설정합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

계정에 지정된 프로그램을 검색합니다.

승인 범위

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

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

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

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

계정의 모든 프로그램을 검색합니다.

승인 범위

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

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

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

RegionsService

리전 구성을 관리합니다.

이 API는 다음 리소스 모델을 정의합니다.

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

판매자 센터 계정에 지역 정의를 만듭니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

판매자 센터 계정에서 지역 정의를 삭제합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

판매자 센터 계정에 정의된 지역을 검색합니다.

승인 범위

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

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

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

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

판매자 센터 계정의 지역을 나열합니다.

승인 범위

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

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

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

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

판매자 센터 계정에서 지역 정의를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

ShippingSettingsService

판매자 API 메서드별로 메서드 호출 배송 설정 정보를 가져오는 서비스입니다.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

배송 설정 정보를 가져옵니다.

승인 범위

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

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

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

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

판매자의 배송 설정을 배송 요청 설정으로 바꿉니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

TermsOfServiceAgreementStateService

TermsOfServiceAgreementState API를 지원하는 서비스

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

서비스 약관의 상태를 반환합니다.

승인 범위

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

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

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

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

애플리케이션 서비스 약관의 계약 상태를 검색합니다.

승인 범위

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

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

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

TermsOfServiceService

TermsOfService API를 지원하는 서비스

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

TermsOfService을 허용합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

제공된 버전과 연결된 TermsOfService를 검색합니다.

승인 범위

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

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

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

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

지정된 kindregion_code의 최신 TermsOfService 버전을 검색합니다.

승인 범위

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

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

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

UserService

사용자 API를 지원하는 서비스입니다.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

판매자 센터 계정 사용자를 만듭니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

판매자 센터 계정 사용자를 삭제합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

GetUser

rpc GetUser(GetUserRequest) returns (User)

판매자 센터 계정 사용자를 검색합니다.

승인 범위

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

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

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

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

판매자 센터 계정의 모든 사용자를 나열합니다.

승인 범위

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

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

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

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

판매자 센터 계정 사용자를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.

승인 범위

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

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

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

AcceptTermsOfServiceRequest

AcceptTermsOfService 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. 형식: termsOfService/{version}

account

string

필수 항목입니다. 서비스 약관을 수락할 계정입니다.

region_code

string

필수 항목입니다. CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 전 세계에 적용되는 경우 001입니다.

수락됨

동의한 서비스 약관을 설명합니다.

입력란
terms_of_service

string

동의한 termsOfService입니다.

accepted_by

string

수락이 기록된 계정입니다. 계정 자체일 수도 있고, 하위 계정의 경우 MCA 계정일 수도 있습니다.

valid_until

Date

설정되면 동의한 TermsOfService가 이 날짜가 끝날 때까지만 유효함을 명시합니다 (UTC 기준). 그 전에 새 계정을 수락해야 합니다. 필수 TermsOfService에 대한 정보는 필수 메시지에 있습니다.

AccessRight

액세스 권한

열거형
ACCESS_RIGHT_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
STANDARD 일반 액세스 권한
ADMIN 관리자 액세스 권한
PERFORMANCE_REPORTING 이 권한을 가진 사용자는 실적 및 통계에 액세스할 수 있습니다.

계정

계정

입력란
name

string

식별자. 계정의 리소스 이름입니다. 형식: accounts/{account}

account_id

int64

출력 전용입니다. 계정의 ID입니다.

account_name

string

필수 항목입니다. 사람이 읽을 수 있는 계정 이름입니다. 자세한 내용은 매장 이름업체 이름을 참고하세요.

adult_content

bool

이 계정에 성인용 콘텐츠가 포함되어 있는지 여부입니다.

test_account

bool

출력 전용입니다. 테스트 계정인지 여부입니다.

time_zone

TimeZone

필수 항목입니다. 계정의 시간대입니다.

쓰기 시 time_zonereporting_time_zonedisplay_time_zone를 모두 설정합니다.

읽기의 경우 time_zone는 항상 display_time_zone를 반환합니다. 계정에 display_time_zone가 없는 경우 time_zone는 비어 있습니다.

language_code

string

필수 항목입니다. 계정의 BCP-47 언어 코드(예: en-US 또는 sr-Latn)입니다.

AccountIssue

AccountIssue

입력란
name

string

식별자. 계정 문제의 리소스 이름입니다. 형식: accounts/{account}/issues/{id}

title

string

문제의 현지화된 제목입니다.

severity

Severity

문제의 전반적인 심각도입니다.

impacted_destinations[]

ImpactedDestination

이 문제가 여러 대상에 미치는 영향

detail

string

문제에 관해 현지화된 세부정보

documentation_uri

string

문제에 대한 추가 정보와 해결 방법을 제공하는 판매자 센터 고객센터 링크

ImpactedDestination

문제가 대상에 미치는 영향입니다.

입력란
impacts[]

Impact

지정된 대상의 여러 리전에 미치는 (부정적인) 영향입니다.

reporting_context

ReportingContextEnum

영향을 받는 보고 컨텍스트입니다.

영향

문제가 지역에 미치는 영향

입력란
region_code

string

이 문제가 적용되는 CLDR 지역 코드입니다.

severity

Severity

대상 지역 및 지역에서 발생한 문제의 심각도입니다.

심각도

가능한 모든 문제의 심각도

열거형
SEVERITY_UNSPECIFIED 심각도를 알 수 없습니다.
CRITICAL 이 문제로 인해 제품이 게재되지 않습니다.
ERROR 이 문제는 향후 혜택에 영향을 주거나 혜택 관련 문제를 나타낼 수 있습니다.
SUGGESTION 이 문제는 개선을 위한 제안입니다.

AccountTax

판매자 계정의 세금 설정입니다. 모든 메서드에는 관리자 역할이 필요합니다.

입력란
name

string

식별자. 세금 설정의 이름입니다. 형식: "{account_tax.name=accounts/{account}}"

account

int64

출력 전용입니다. 계정 세금 설정이 속한 계정의 ID입니다.

tax_rules[]

TaxRule

세금 규정 "각 지역의 세금 규칙을 정의하세요. 규칙이 없는 지역에는 세금이 부과되지 않습니다."

주소

창고의 배송지 주소입니다.

입력란
street_address

string

주소의 도로 수준 부분입니다. 예를 들면 111w 31st Street입니다.

city

string

필수 항목입니다. 시/군/구 또는 코뮌 종속 지역 또는 하위 지역 (예: 인근 지역 또는 교외)도 포함될 수 있습니다.

administrative_area

string

필수 항목입니다. 국가의 최상위 행정 구역 단위입니다. 예를 들어 캘리포니아와 같은 주 ('CA') 또는 퀘벡 ('QC') 같은 주입니다.

postal_code

string

필수 항목입니다. 우편번호 (예: '94043')

region_code

string

필수 항목입니다. CLDR 국가 코드 (예: 'US')

BusinessDayConfig

창고의 영업일입니다.

입력란
business_days[]

Weekday

필수 항목입니다. 정규 영업일 비워 둘 수 없습니다.

요일

열거형
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

비즈니스의 정체성과 관련된 정보 모음입니다.

입력란
name

string

식별자. 비즈니스 ID의 리소스 이름입니다. 형식: accounts/{account}/businessIdentity

black_owned

IdentityAttribute

선택사항입니다. 흑인이 소유하거나 운영하는 비즈니스인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 US로 설정된 판매자만 사용할 수 있습니다. 마켓 또는 마켓 판매자에게도 적용되지 않습니다.

women_owned

IdentityAttribute

선택사항입니다. 비즈니스가 여성이 소유하거나 운영하는 비즈니스인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 US로 설정된 판매자만 사용할 수 있습니다. 마켓 또는 마켓 판매자에게도 적용되지 않습니다.

veteran_owned

IdentityAttribute

선택사항입니다. 퇴역 군인이 소유하거나 운영하는 비즈니스인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 US로 설정된 판매자만 사용할 수 있습니다. 마켓 또는 마켓 판매자에게도 적용되지 않습니다.

latino_owned

IdentityAttribute

선택사항입니다. 비즈니스가 라틴계 소유주임을 명시하는지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 US로 설정된 판매자만 사용할 수 있습니다. 마켓 또는 마켓 판매자에게도 적용되지 않습니다.

small_business

IdentityAttribute

선택사항입니다. 비즈니스가 중소기업인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 US로 설정된 판매자만 사용할 수 있습니다. 마켓에도 적용되지 않습니다.

IdentityAttribute

ID 속성과 관련된 모든 정보입니다.

입력란
identity_declaration

IdentityDeclaration

필수 항목입니다. 이 속성의 아이덴티티 선언입니다.

IdentityDeclaration

신원 선언과 관련하여 가능한 모든 설정입니다.

열거형
IDENTITY_DECLARATION_UNSPECIFIED 선택하지 않았음을 나타내는 기본값입니다.
SELF_IDENTIFIES_AS 계정이 속성으로 식별됨을 나타냅니다.
DOES_NOT_SELF_IDENTIFY_AS 계정이 속성으로 식별되지 않음을 나타냅니다.

PromotionsConsent

비즈니스 아이덴티티와 관련된 프로모션과 관련하여 가능한 모든 설정입니다.

열거형

BusinessInfo

비즈니스와 관련된 정보의 모음입니다.

입력란
name

string

식별자. 비즈니스 정보의 리소스 이름입니다. 형식: accounts/{account}/businessInfo

address

PostalAddress

선택사항입니다. 비즈니스의 주소입니다.

phone

PhoneNumber

선택사항입니다. 비즈니스의 전화번호입니다.

phone_verification_state

PhoneVerificationState

출력 전용입니다. 비즈니스의 전화 인증 상태입니다.

customer_service

CustomerService

선택사항입니다. 비즈니스의 고객 서비스입니다.

CarrierRate

main_table 또는 single_value에서 참조할 수 있는 운송업체 요금 목록입니다.

입력란
name

string

필수 항목입니다. 운송업체 배송비의 이름입니다. 요금 그룹마다 고유해야 합니다.

carrier

string

필수 항목입니다. 운송업체 서비스(예: "UPS" 또는 "Fedex")

carrier_service

string

필수 항목입니다. 운송업체 서비스(예: "ground" 또는 "2 days")

origin_postal_code

string

필수 항목입니다. 이 운송업체 요금의 배송 출발지입니다.

percentage_adjustment

string

선택사항입니다. 십진수 표기법으로 나타낸 곱셈식 배송비 수정자입니다. 음수일 수 있습니다. 예를 들어 "5.4"은 비율을 5.4% 높이고 "-3"은 비율을 3% 낮춥니다.

flat_adjustment

Price

선택사항입니다. 배송비 요율 조정을 추가합니다. 음수일 수 있습니다. 예를 들어 { "amount_micros": 1, "currency_code" : "USD" }는 요금에 $1를 더하고 { "amount_micros": -3, "currency_code" : "USD" }는 요금에서 $3를 삭제합니다.

ClaimHomepageRequest

ClaimHomepage 메서드에 대한 요청 메시지입니다.

입력란
name

string

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

CreateAndConfigureAccountRequest

CreateAndConfigureAccount 메서드에 대한 요청 메시지입니다.

입력란
account

Account

필수 항목입니다. 생성할 계정입니다.

users[]

CreateUserRequest

선택사항입니다. 계정에 추가될 사용자입니다.

service[]

AddAccountService

선택사항입니다. 이 플래그를 지정하면 생성할 계정과 제공업체 계정 사이의 계정 서비스가 생성 과정에서 초기화됩니다.

accept_terms_of_service

AcceptTermsOfService

선택사항입니다. 계정이 생성되는 즉시 서비스 약관 (ToS)에 동의해야 합니다.

AcceptTermsOfService

서비스 약관 리소스에 대한 참조입니다.

입력란
name

string

필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다.

region_code

string

필수 항목입니다. CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 전 세계에 적용되는 경우 001입니다.

AddAccountService

계정 생성 중에 계정 서비스를 추가하는 방법에 대한 추가 안내입니다.

입력란
통합 필드 service_type. 현재 멀티 클라이언트 상위 계정 유형만 지원됩니다. service_type은 다음 중 하나일 수 있습니다.
account_aggregation

Empty

제공업체는 계정의 애그리게이터입니다.

provider

string

선택사항입니다. 서비스 제공업체입니다. 형식: accounts/{account}

CreateRegionRequest

CreateRegion 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 리전을 만들 계정입니다. 형식: accounts/{account}

region_id

string

필수 항목입니다. 지역 식별자로, 동일한 계정의 모든 지역에서 고유합니다.

region

Region

필수 항목입니다. 생성할 리전입니다.

CreateUserRequest

CreateUser 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 사용자가 생성될 계정의 리소스 이름입니다. 형식: accounts/{account}

user_id

string

필수 항목입니다. 사용자의 이메일 주소입니다 (예: john.doe@gmail.com).

user

User

필수 항목입니다. 생성할 사용자입니다.

CustomerService

고객 서비스 정보

입력란
uri

string

선택사항입니다. 고객 서비스를 찾을 수 있는 URI입니다.

email

string

선택사항입니다. 고객 서비스를 받을 수 있는 이메일 주소입니다.

phone

PhoneNumber

선택사항입니다. 고객 서비스에 연락할 수 있는 전화번호입니다.

CutoffTime

영업일 마감 시간의 정의입니다.

입력란
hour

int32

필수 항목입니다. 당일 주문 처리를 위한 마감 시간(마감 시간)입니다.

minute

int32

필수 항목입니다. 당일 처리를 위해 주문이 완료되어야 하는 마감 시간(분)입니다.

time_zone

string

필수 항목입니다. 시간대 식별자(예: '유럽/취리히')

DeleteAccountRequest

DeleteAccount 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 계정의 이름입니다. 형식: accounts/{account}

DeleteRegionRequest

DeleteRegion 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 리전의 이름입니다. 형식: accounts/{account}/regions/{region}

DeleteUserRequest

DeleteUser 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 사용자의 이름입니다. 형식: accounts/{account}/users/{email}

accounts/{account}/users/me에서와 같이 이메일 주소가 아닌 me를 사용하여 호출자에 해당하는 사용자를 삭제할 수도 있습니다.

DeliveryTime

주문부터 제품 배송까지 다양한 측면에서 소요된 시간입니다.

입력란
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

선택사항입니다. 선택한 운송업체의 설정에 따라 창고 (배송지 위치)별로 배송 시간을 계산해야 함을 나타냅니다. 설정되면 [배송 시간][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 에 다른 운송 시간 관련 필드를 설정하면 안 됩니다.

min_transit_days

int32

운송에 소비되는 최소 영업일 수입니다. 0은 당일 배송을 의미하고 1은 익일 배송을 의미합니다. min_transit_days, max_transit_days 또는 transit_time_table 중 하나만 설정해야 합니다.

max_transit_days

int32

운송에 소비되는 최대 영업일 수입니다. 0은 당일 배송을 의미하고 1은 익일 배송을 의미합니다. min_transit_days 이상이어야 합니다.

cutoff_time

CutoffTime

영업일 마감 시간의 정의입니다. 설정되지 않은 경우 마감 시간은 기본적으로 오전 8시(PST)로 설정됩니다.

min_handling_days

int32

주문 상품이 발송되기 전에 소요된 최소 영업일 수입니다. 0은 당일 발송을 의미하고 1은 다음 날 발송을 의미합니다.

max_handling_days

int32

주문 상품이 발송되기 전에 소요된 영업일 기준 최대 일수입니다. 0은 당일 발송을 의미하고 1은 다음 날 발송을 의미합니다. min_handling_days 이상이어야 합니다.

transit_time_table

TransitTable

행 및 열 측정기준을 기준으로 한 운송 시간 표, 운송에 소요된 영업일 기준의 일수입니다. min_transit_days, max_transit_days 또는 transit_time_table 중 하나를 설정할 수 있지만 둘 다 설정할 수는 없습니다.

handling_business_day_config

BusinessDayConfig

주문을 처리할 수 있는 영업일입니다. 입력하지 않을 경우 월요일~금요일 영업일로 간주됩니다.

transit_business_day_config

BusinessDayConfig

주문 상품을 배송할 수 있는 영업일입니다. 입력하지 않을 경우 월요일~금요일 영업일로 간주됩니다.

DisableProgramRequest

EnableProgram 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 특정 계정에서 참여를 중지할 프로그램의 이름입니다. 형식: accounts/{account}/programs/{program}

거리

최대 배송 반경입니다. 이는 지역 배송 배송 유형에만 필요합니다.

입력란
value

int64

거리의 정수 값입니다.

unit

Unit

단위는 국가에 따라 다를 수 있으며 마일과 킬로미터를 포함하도록 매개변수화됩니다.

단위

단위는 국가에 따라 다를 수 있으며 마일과 킬로미터를 포함하도록 매개변수화됩니다.

열거형
UNIT_UNSPECIFIED 단위 미지정
MILES 단위(마일)
KILOMETERS 단위(킬로미터)

EmailPreferences

사용자가 수신 동의 또는 수신 거부한 알림의 카테고리입니다. 사용자가 수신을 거부할 수 없으므로 이메일 환경설정에는 필수 공지가 포함되지 않습니다.

입력란
name

string

식별자. EmailPreferences의 이름입니다. 엔드포인트는 인증된 사용자에 대해서만 지원됩니다.

news_and_tips

OptInState

선택사항입니다. 새로운 기능, 도움말 및 권장사항에 관한 업데이트입니다.

OptInState

이메일 환경설정의 수신 동의 상태입니다.

열거형
OPT_IN_STATE_UNSPECIFIED 선택 상태가 지정되지 않았습니다.
OPTED_OUT 사용자가 이 유형의 이메일을 수신하지 않도록 선택했습니다.
OPTED_IN 사용자가 이 유형의 이메일을 수신하도록 선택했습니다.
UNCONFIRMED 사용자가 이 유형의 이메일을 수신하도록 설정했으며 확인 이메일이 전송되었으나 사용자가 아직 수신 동의를 확인하지 않았습니다 (일부 국가에만 해당).

EnableProgramRequest

EnableProgram 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 특정 계정에 참여할 수 있도록 설정할 프로그램의 이름입니다. 형식: accounts/{account}/programs/{program}

GetAccountRequest

GetAccount 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 계정의 이름입니다. 형식: accounts/{account}

GetAccountTaxRequest

세금 설정 가져오기 요청

입력란
name

string

필수 항목입니다. 세금 설정을 가져올 이름입니다.

GetBusinessIdentityRequest

GetBusinessIdentity 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 비즈니스 ID의 리소스 이름입니다. 형식: accounts/{account}/businessIdentity

GetBusinessInfoRequest

GetBusinessInfo 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 비즈니스 정보의 리소스 이름입니다. 형식: accounts/{account}/businessInfo

GetEmailPreferencesRequest

GetEmailPreferences 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. EmailPreferences 리소스 이름입니다. 형식: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

GetHomepage 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 홈페이지의 이름입니다. 형식: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

GetOnlineReturnPolicy 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 반품 정책의 이름입니다. 형식: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

GetProgram 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 프로그램의 이름입니다. 형식: accounts/{account}/programs/{program}

GetRegionRequest

GetRegion 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 리전의 이름입니다. 형식: accounts/{account}/regions/{region}

GetShippingSettingsRequest

GetShippingSetting 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 배송 설정의 이름입니다. 형식: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

GetTermsOfServiceAgreementState 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. 형식: accounts/{account}/termsOfServiceAgreementState/{identifier}

GetTermsOfServiceRequest

GetTermsOfService 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. 형식: termsOfService/{version}

GetUserRequest

GetUser 메서드에 대한 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 사용자의 이름입니다. 형식: accounts/{account}/users/{email}

accounts/{account}/users/me에서와 같이 이메일 주소가 아닌 me를 사용하여 호출자에 해당하는 사용자를 검색할 수도 있습니다.

헤더

테이블의 행 또는 열 헤더로 구성된 비어 있지 않은 목록입니다. prices, weights, num_items, postal_code_group_names 또는 location 중 정확히 하나를 설정해야 합니다.

입력란
prices[]

Price

필수 항목입니다. 포괄적인 주문 가격 상한의 목록입니다. price amount_micros = -1로 설정하여 마지막 가격의 값을 무한대로 설정할 수 있습니다. 예를 들어 [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}]는 '<= $10', '<= $500', "> $500' 헤더를 나타냅니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다. 비어 있지 않아야 합니다. -1을 제외하고 양수여야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

weights[]

Weight

필수 항목입니다. 포함 주문 가중치 상한의 목록입니다. price amount_micros = -1로 설정하여 마지막 가중치의 값을 무한대로 설정할 수 있습니다. 예를 들어 [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}]는 헤더 '<= 10kg', '<= 50kg', '> 50kg'을 나타냅니다. 서비스 내의 모든 가중치는 단위가 동일해야 합니다. 비어 있지 않아야 합니다. -1을 제외하고 양수여야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

number_of_items[]

string

필수 항목입니다. 포괄적인 수의 항목 상한값 목록입니다. 마지막 값은 "infinity"일 수 있습니다. 예를 들어 ["10", "50", "infinity"]는 '<= 10 items', '<= 50 items', "> 50 items' 헤더를 나타냅니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

postal_code_group_names[]

string

필수 항목입니다. 우편 그룹 이름의 목록입니다. 마지막 값은 "all other locations"일 수 있습니다. 예: ["zone 1", "zone 2", "all other locations"] 참조된 우편번호 그룹은 서비스 배송 국가와 일치해야 합니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

locations[]

LocationIdSet

필수 항목입니다. 위치 ID 집합의 목록입니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

홈페이지

매장의 홈페이지

입력란
name

string

식별자. 상점 홈페이지의 리소스 이름입니다. 형식: accounts/{account}/homepage

claimed

bool

출력 전용입니다. 홈페이지의 소유권 주장 여부입니다. https://support.google.com/merchants/answer/176793을 참고하세요.

uri

string

필수 항목입니다. 매장 홈페이지의 URI (일반적으로 URL)입니다.

InsertShippingSettingsRequest

InsertShippingSetting 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 제품이 삽입될 계정입니다. 형식: accounts/{account}

shipping_setting

ShippingSettings

필수 항목입니다. 계정의 새 버전입니다.

ListAccountIssuesRequest

ListAccountIssues 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 문제 모음을 소유한 상위 항목입니다. 형식: accounts/{account}

page_size

int32

선택사항입니다. 반환할 최대 문제 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50명의 사용자가 반환됩니다. 최댓값은 100입니다. 100을 초과하는 값은 100으로 강제 변환됩니다.

page_token

string

선택사항입니다. 이전 ListAccountIssues 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListAccountIssues에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

language_code

string

선택사항입니다. 응답의 문제에는 지정된 언어로 사람이 읽을 수 있는 필드가 있습니다. 형식은 BCP-47(예: en-US 또는 sr-Latn)입니다. 값을 제공하지 않으면 en-US이 사용됩니다.

time_zone

TimeZone

선택사항입니다. 사람이 읽을 수 있는 필드의 시간을 현지화하는 데 사용되는 IANA 시간대입니다. 예: 'America/Los_Angeles' 설정하지 않으면 'America/Los_Angeles'가 사용됩니다.

ListAccountIssuesResponse

ListAccountIssues 메서드에 대한 응답 메시지입니다.

입력란
account_issues[]

AccountIssue

지정된 계정의 문제

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListAccountTaxRequest

요청하는 판매자에 대해서만 모든 하위 계정 세금 설정을 나열하도록 요청합니다. 이 메서드는 멀티 클라이언트 계정에서만 호출할 수 있으며, 그렇지 않으면 오류가 반환됩니다.

입력란
parent

string

필수 항목입니다. 이 계정 세금 모음을 소유한 상위 항목입니다. 형식: accounts/{account}

page_size

int32

페이징에 사용되고 응답에서 반환할 세금 설정의 최대 개수입니다.

page_token

string

이전 요청에서 반환된 토큰입니다.

ListAccountTaxResponse

계정 세금 목록 요청에 대한 응답입니다. 이 메서드는 멀티 클라이언트 계정에서만 호출할 수 있으며, 그렇지 않으면 오류를 반환합니다.

입력란
account_taxes[]

AccountTax

계정 세금 설정 페이지

next_page_token

string

계정 세금 설정의 다음 페이지를 가져오기 위한 토큰입니다.

ListAccountsRequest

ListAccounts 메서드에 대한 요청 메시지입니다.

입력란
page_size

int32

선택사항입니다. 반환할 최대 계정 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 250개의 계정이 반환됩니다. 최댓값은 500이며, 500을 초과하는 값은 500으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListAccounts 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListAccounts에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

선택사항입니다. 필터와 일치하는 계정만 표시하는 선택적 필터입니다.

다음은 유효한 필터의 몇 가지 예입니다.

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

계정 수준의 필터에서 사용되는 의미는 다음과 같습니다.

  • accountName 계정의 accountName 필드를 나타냅니다.
  • relationship(...) 다른 계정과의 관계를 나타냅니다. 함수 내에서 이 관계를 추가로 지정할 수 있습니다.

관계 수준의 필터에는 다음과 같은 의미가 있습니다.

  • providerId 관계의 다른 구성원인 계정의 숫자 ID를 나타냅니다. 예를 들어 필터를 accounts/name/123 계정과 관계가 있는 계정으로 제한해야 하는 경우 providerId을(를) providerId = 123(으)로 필터링해야 합니다.
  • callerHasAccessToProvider() 이렇게 하면 호출하는 사용자가 관계의 다른 구성원 (또는 공급자)에 액세스할 수 있는 다른 계정과 관계가 있는 계정으로 결과 계정이 제한됩니다.
  • externalAccountId 이는 관계에 구성된 외부 계정 ID를 나타냅니다.
  • accountIdAlias 관계에 구성된 계정 ID 별칭을 나타냅니다.
  • service(...) 이는 관계의 일부로 제공되는 서비스를 나타냅니다. 참고: 두 계정 간의 관계에 여러 서비스가 포함될 수 있습니다.

서비스 수준의 필터에는 다음과 같은 의미가 있습니다.

  • handshakeState 서비스의 핸드셰이크 상태를 나타냅니다. 서비스가 설정되면 관계의 다른 구성원 또는 두 구성원 모두가 먼저 승인해야 하는 경우가 있습니다. 따라서 서비스는 PENDING 또는 APPROVED 상태일 수 있습니다.
  • type 서비스의 유형을 나타냅니다. 가능한 값은 다음과 같습니다.
    • ACCOUNT_MANAGEMENT 제공업체가 계정을 관리합니다.
    • ACCOUNT_AGGREGATION 제공업체가 계정의 애그리게이터입니다.

필터는 AIP 필터 사양의 하위 집합 및 공식 EBNF 문법을 따릅니다. 이 필터의 문법은 더 제한적이고 구체적입니다.

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

또한 다음 사항이 적용됩니다.

  • 접속사의 각 필드는 한 번만 표시될 수 있습니다. 예를 들어 계정 수준에서 accountName을 한 번만 필터링할 수 있거나 각 관계 수준에서 providerId을 한 번만 필터링할 수 있습니다.
  • 문자열 필드 (예: accountName 또는 accountIdAlias)의 경우 쿼리를 *로 묶어 CONTAINS 연산자를 표현할 수 있습니다. 예를 들어 accountName = "*foo*"foo가 포함된 accountName가 있는 모든 계정을 반환합니다. 직교로 !=를 사용하여 NOT_CONTAINS 연산자를 표현할 수 있습니다. 예를 들어 accountName != "*foo*"foo가 포함되지 않은 accountName을 가진 모든 계정을 반환합니다. 참고: ***를 사용하여 별표 문자 *를 포함하는 accountName이 있는 계정을 검색할 수 있습니다.
  • 추가 공백은 무시됩니다.
  • 숫자만 포함하는 값을 제외한 모든 값은 큰따옴표로 묶어야 합니다.
  • 분리가 사용되는 경우 각 변의 접속사는 괄호를 사용해야 합니다. 괄호는 함수 호출을 제외하고 다른 어떤 곳에도 허용되지 않습니다 (예: relationship 또는 service). 이는 결합이 논리적으로 분리보다 더 강력한 결합을 명확하게 표현하기 위함입니다.

ListAccountsResponse

ListAccounts 메서드에 대한 응답 메시지입니다.

입력란
accounts[]

Account

ListAccountsRequest와 일치하는 계정

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListOnlineReturnPoliciesRequest

ListOnlineReturnPolicies 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 반품 정책을 나열할 판매자 계정입니다. 형식: accounts/{account}

page_size

int32

선택사항입니다. 반환할 OnlineReturnPolicy 리소스의 최대 개수입니다. 특정 판매자의 반품 정책 수가 pageSize보다 적으면 서비스는 이 값보다 적은 값을 반환합니다. 기본값은 10입니다. 최댓값은 100입니다. 최댓값보다 큰 값을 지정하면 pageSize의 기본값이 최댓값으로 설정됩니다.

page_token

string

선택사항입니다. 이전 ListOnlineReturnPolicies 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 페이지 토큰을 제공하세요.

페이지를 매길 때 ListOnlineReturnPolicies에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 이전 요청에 대한 응답에서 nextPageToken로 반환된 토큰입니다.

ListOnlineReturnPoliciesResponse

ListOnlineReturnPolicies 메서드에 대한 응답 메시지입니다.

입력란
online_return_policies[]

OnlineReturnPolicy

가져온 반품 정책입니다.

next_page_token

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListProgramsRequest

ListPrograms 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 모든 프로그램을 검색할 계정의 이름입니다. 형식: accounts/{account}

page_size

int32

선택사항입니다. 단일 응답에서 반환할 프로그램의 최대 개수입니다. 지정하지 않으면 (또는 0) 기본 크기 1,000이 사용됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListPrograms 호출에서 수신된 연속 토큰입니다. 다음 페이지를 검색하려면 이 토큰을 제공합니다.

ListProgramsResponse

ListPrograms 메서드의 응답 메시지입니다.

입력란
programs[]

Program

특정 계정의 프로그램입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListRegionsRequest

ListRegions 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 지역을 나열할 계정입니다. 형식: accounts/{account}

page_size

int32

선택사항입니다. 반환할 리전의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리전이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListRegions 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListRegions에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListRegionsResponse

ListRegions 메서드에 대한 응답 메시지입니다.

입력란
regions[]

Region

지정된 판매자의 지역입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListSubAccountsRequest

ListSubAccounts 메서드에 대한 요청 메시지입니다.

입력란
provider

string

필수 항목입니다. 상위 계정. 형식: accounts/{account}

page_size

int32

선택사항입니다. 반환할 최대 계정 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 250개의 계정이 반환됩니다. 최댓값은 500이며, 500을 초과하는 값은 500으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListAccounts 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListAccounts에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListSubAccountsResponse

ListSubAccounts 메서드에 대한 응답 메시지입니다.

입력란
accounts[]

Account

특정 상위 계정이 애그리게이터인 계정입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListUsersRequest

ListUsers 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 사용자 컬렉션을 소유한 상위 항목입니다. 형식: `accounts/{account}

page_size

int32

선택사항입니다. 반환할 최대 사용자 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50명의 사용자가 반환됩니다. 최댓값은 100입니다. 100을 초과하는 값은 100으로 강제 변환됩니다.

page_token

string

선택사항입니다. 이전 ListUsers 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListUsers에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListUsersResponse

ListUsers 메서드에 대한 응답 메시지입니다.

입력란
users[]

User

지정된 계정의 사용자입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

LocationIdSet

위치 ID 집합의 목록입니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

입력란
location_ids[]

string

필수 항목입니다. 비어 있지 않은 위치 ID 목록입니다. 모두 동일한 위치 유형 (예: 주)이어야 합니다.

MinimumOrderValueTable

수령 처리 유형의 매장별 최소 주문 금액 표

입력란
store_code_set_with_movs[]

StoreCodeSetWithMov

필수 항목입니다. 동일한 최소 주문값 (MOV)을 공유하는 판매점 코드 세트의 목록입니다. 최소 두 개의 세트가 필요하며 마지막 세트는 비어 있어야 합니다. 이는 '다른 모든 스토어의 MOV'를 의미합니다. 각 판매점 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다.

StoreCodeSetWithMov

최소 주문 금액이 동일한 판매점 코드 세트의 목록입니다. 최소 두 개의 세트가 필요하며 마지막 세트는 비어 있어야 합니다. 이는 '다른 모든 스토어의 MOV'를 의미합니다. 각 판매점 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다.

입력란
store_codes[]

string

선택사항입니다. 고유한 상점 코드의 목록이거나 catch-all의 경우 비어 있습니다.

value

Price

특정 매장의 최소 주문 금액입니다.

OnlineReturnPolicy

온라인 반품 정책 객체입니다. 현재 광고 및 무료 등록정보 프로그램의 반품 정책을 나타내는 데 사용됩니다.

입력란
name

string

식별자. OnlineReturnPolicy 리소스 이름입니다. 형식: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

출력 전용입니다. Google에서 생성한 반품 정책 ID입니다.

label

string

이 필드는 반품 정책의 고유한 사용자 정의 라벨을 나타냅니다. 동일한 라벨을 같은 국가의 여러 반품 정책에 사용할 수 없다는 점에 유의해야 합니다. 제품에서 특정 라벨 속성을 지정하지 않는 한 정책에 자동으로 '기본' 라벨이 지정됩니다. 특정 제품 그룹에 맞춤 반품 정책을 할당하려면 반품 정책 라벨에 제공된 안내를 따르세요. 라벨은 최대 50자(영문 기준)까지 포함할 수 있습니다.

countries[]

string

반품 정책이 적용되는 판매 국가입니다. 값은 유효한 2문자 ISO 3166 코드여야 합니다.

policy

Policy

반품 정책

restocking_fee

RestockingFee

모든 반품 사유 카테고리에 적용되는 재입고 수수료입니다. 값이 설정되지 않은 경우 무료 재입고 수수료로 처리됩니다.

return_methods[]

ReturnMethod

고객이 상품을 반품할 수 있는 방법의 반품 방법입니다. 반품 정책 유형이 noReturns가 아닌 경우 이 값은 비워 둘 수 없습니다.

item_conditions[]

ItemCondition

반품 정책 유형이 'noReturns'가 아닌 이상 반품에 허용되는 상품 조건을 비워 둘 수 없습니다.

return_shipping_fee

ReturnShippingFee

반품 배송비입니다. 고객이 반품 라벨을 다운로드하여 인쇄해야 하는 경우에만 설정해야 합니다.

return_policy_uri

string

반품 정책 URI입니다. Google에서 정책의 상태 검사를 수행하는 데 사용할 수 있습니다. 유효한 URL이어야 합니다.

accept_defective_only

bool

이 필드는 판매자가 결함이 있는 제품만 반품을 허용하는지 지정합니다. 이 필드는 필수입니다.

process_refund_days

int32

이 필드는 판매자가 환불을 처리하는 데 걸리는 기간(일)을 지정합니다. 필드는 선택사항입니다.

accept_exchange

bool

이 필드는 판매자가 고객이 제품을 교환할 수 있도록 허용하는지 지정합니다. 이 필드는 필수입니다.

ItemCondition

사용 가능한 항목 조건입니다.

열거형
ITEM_CONDITION_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
NEW 새로 만들기를 클릭합니다.
USED 사용됨.

정책

사용 가능한 정책입니다.

입력란
type

Type

정책 유형입니다.

days

int64

배송 후 상품을 반품할 수 있는 일수이며, 1일은 배송 타임스탬프로부터 24시간 후로 정의됩니다. NUMBER_OF_DAYS_AFTER_DELIVERY 반품에 필요합니다.

유형

반품 정책 유형입니다.

열거형
TYPE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
NUMBER_OF_DAYS_AFTER_DELIVERY 배송 후 반품이 유효한 기간(일)입니다.
NO_RETURNS 반품 불가
LIFETIME_RETURNS 평생 반품이 가능합니다.

RestockingFee

재입고 수수료입니다. 정액 요금 또는 마이크로 퍼센트를 사용할 수 있습니다.

입력란

통합 필드 type입니다.

type는 다음 중 하나여야 합니다.

fixed_fee

Price

고정 재입고 수수료입니다.

micro_percent

int32

총 가격의 마이크로 비율(%)입니다. 15,000,000은 총가격의 15% 가 청구됨을 의미합니다.

ReturnMethod

사용 가능한 반환 메서드입니다.

열거형
RETURN_METHOD_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
BY_MAIL 우편으로 반품하세요.
IN_STORE 매장에 반품하세요.
AT_A_KIOSK 키오스크에서 반품하세요.

ReturnShippingFee

반품 배송비입니다. 정액 요금이거나 고객이 실제 배송비를 지불함을 나타내는 부울일 수 있습니다.

입력란
type

Type

반품 배송비의 유형입니다.

fixed_fee

Price

고정 반품 배송비 금액입니다. 이 값은 유형이 FIXED인 경우에만 적용됩니다. 유형이 FIXED이고 이 값이 설정되지 않은 경우 반품 배송비가 무료로 처리됩니다.

유형

반품 배송비 유형입니다.

열거형
TYPE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
FIXED 반품 배송비는 고정 금액입니다.
CUSTOMER_PAYING_ACTUAL_FEE 고객이 실제 반품 배송비를 지불합니다.

PhoneVerificationState

전화 인증 상태입니다.

열거형
PHONE_VERIFICATION_STATE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
PHONE_VERIFICATION_STATE_VERIFIED 전화번호가 인증되었습니다.
PHONE_VERIFICATION_STATE_UNVERIFIED 휴대전화가 인증되지 않음

프로그램

지정된 계정의 특정 프로그램 참여를 정의합니다.

프로그램은 판매자 계정에 기능을 추가하는 메커니즘을 제공합니다. 대표적인 예로 판매자 매장의 제품을 Google 서비스 전반에 무료로 표시할 수 있는 무료 제품 등록정보 프로그램이 있습니다.

입력란
name

string

식별자. 프로그램의 리소스 이름입니다. 형식: accounts/{account}/programs/{program}

documentation_uri

string

출력 전용입니다. 프로그램을 설명하는 판매자 센터 도움말 페이지의 URL입니다.

state

State

출력 전용입니다. 프로그램에 대한 계정의 참여 상태입니다.

active_region_codes[]

string

출력 전용입니다. 계정이 프로그램에 활발하게 참여하고 있는 지역입니다. 활성 지역은 지역에 영향을 주는 모든 프로그램 요구사항이 충족된 지역으로 정의됩니다.

리전 코드는 CLDR에 의해 정의됩니다. 프로그램이 해당 국가에 특별히 적용되는 국가이거나 프로그램이 전 세계에 적용되는 경우 001입니다.

unmet_requirements[]

Requirement

출력 전용입니다. 계정이 아직 충족되지 않아 프로그램 참여에 영향을 주는 요건입니다.

요구사항

프로그램 참여에 지정된 요구사항을 정의합니다.

입력란
title

string

출력 전용입니다. 요구사항의 이름입니다.

documentation_uri

string

출력 전용입니다. 요구사항을 설명하는 도움말 페이지의 URL입니다.

affected_region_codes[]

string

출력 전용입니다. 현재 이 요구사항의 영향을 받는 지역이 충족되지 않고 있습니다.

리전 코드는 CLDR에 의해 정의됩니다. 프로그램이 해당 국가에 특별히 적용되는 국가이거나 프로그램이 전 세계에 적용되는 경우 001입니다.

상태

계정의 가능한 프로그램 참여 상태입니다.

열거형
STATE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
NOT_ELIGIBLE 프로그램에 참여할 수 없는 계정입니다.
ELIGIBLE 프로그램에 참여할 수 있는 계정입니다.
ENABLED 계정에 프로그램이 사용 설정되어 있어야 합니다.

RateGroup

배송비 요율 그룹 정의입니다. 마지막 행에만 '기타'를 의미하는 빈 applicable_shipping_labels가 있을 수 있습니다. 다른 applicable_shipping_labels는 겹치지 않아야 합니다.

입력란
applicable_shipping_labels[]

string

필수 항목입니다. 이 배송비 그룹이 적용되는 제품을 정의하는 배송물 라벨 목록입니다. 이는 분리입니다. 라벨 중 하나만 일치하면 요금 그룹이 적용됩니다. 서비스의 마지막 요금 그룹만 비워 둘 수 있습니다.

subtables[]

Table

선택사항입니다. main_table에서 참조하는 하위 표의 목록입니다. main_table가 설정된 경우에만 설정할 수 있습니다.

carrier_rates[]

CarrierRate

선택사항입니다. main_table 또는 single_value에서 참조할 수 있는 운송업체 요금 목록입니다.

single_value

Value

요금 그룹의 값입니다 (예: 고정 요금 $10). main_tablesubtables가 설정되지 않은 경우에만 설정할 수 있습니다.

main_table

Table

요금 그룹을 정의하는 표(single_value가 충분히 표현되지 않는 경우) single_value가 설정되지 않은 경우에만 설정할 수 있습니다.

name

string

선택사항입니다. 요금 그룹의 이름입니다. 설정된 경우 배송 서비스 내에서 고유해야 합니다.

지역

RegionalInventoryShippingSettings 서비스 모두에서 타겟으로 사용할 수 있는 지역을 나타냅니다. 지역을 우편번호 모음으로 정의하거나 일부 국가의 경우 사전 정의된 지역 타겟을 사용하여 정의할 수 있습니다. 자세한 내용은 지역 설정 을 참조하세요.

입력란
name

string

식별자. 리전의 리소스 이름입니다. 형식: accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

선택사항입니다. 지역 영역을 정의하는 우편번호 목록입니다.

geotarget_area

GeoTargetArea

선택사항입니다. 지역 영역을 정의하는 지역 타겟팅 목록입니다.

regional_inventory_eligible

BoolValue

출력 전용입니다. 지역을 지역 인벤토리 구성에서 사용할 수 있는지 여부를 나타냅니다.

shipping_eligible

BoolValue

출력 전용입니다. 배송 서비스 구성에 지역을 사용할 수 있는지 여부를 나타냅니다.

display_name

string

선택사항입니다. 지역의 표시 이름입니다.

GeoTargetArea

지역 영역을 정의하는 지역 타겟팅 목록입니다.

입력란
geotarget_criteria_ids[]

int64

필수 항목입니다. 비어 있지 않은 위치 ID 목록입니다. 모두 동일한 위치 유형 (예: 주)이어야 합니다.

PostalCodeArea

지역 영역을 정의하는 우편번호 목록입니다. 참고: 우편번호를 사용하여 정의된 모든 지역은 계정의 ShippingSettings.postalCodeGroups 리소스를 통해 액세스할 수 있습니다.

입력란
region_code

string

필수 항목입니다. CLDR 지역 코드 또는 우편번호 그룹이 적용되는 국가입니다.

postal_codes[]

PostalCodeRange

필수 항목입니다. 우편번호 범위입니다.

PostalCodeRange

지역 영역을 정의하는 우편번호 범위

입력란
begin

string

필수 항목입니다. 영역을 정의하는 범위의 포괄적인 하한을 나타내는 양식 접두사* 의 우편번호 또는 패턴입니다. 예시 값: 94108, 9410*, 9*.

end

string

선택사항입니다. 영역을 정의하는 범위의 포괄적인 상한선을 나타내는 prefix* 형식의 우편번호 또는 패턴. postalCodeRangeBegin과 길이가 같아야 합니다. postalCodeRangeBegin이 우편번호인 경우 postalCodeRangeEnd도 우편번호여야 합니다. postalCodeRangeBegin이 패턴인 경우 postalCodeRangeEnd는 프리픽스 길이가 동일한 패턴이어야 합니다. 선택사항: 설정하지 않으면 지역이 postalCodeRangeBegin과 일치하는 모든 우편번호로 정의됩니다.

필수

동의해야 하는 서비스 약관을 설명합니다.

입력란
terms_of_service

string

수락해야 하는 termsOfService입니다.

tos_file_uri

string

서비스 약관 파일의 전체 URL입니다. 이 필드는 TermsOfService.file_uri와 동일하며 편의를 위해 여기에 추가되었습니다.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

RetrieveForApplicationTermsOfServiceAgreementState 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. termsOfServiceAgreementState 형식을 가져올 계정: accounts/{account}

RetrieveLatestTermsOfServiceRequest

RetrieveLatestTermsOfService 메서드에 대한 요청 메시지입니다.

입력란
region_code

string

CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 전 세계에 적용되는 경우 001입니다.

kind

TermsOfServiceKind

이 서비스 약관 버전이 적용되는 종류입니다.

셀 목록을 포함합니다.

입력란
cells[]

Value

필수 항목입니다. 행을 구성하는 셀 목록입니다. 2차원 표의 경우 길이는 columnHeaders과 같고, 1차원 표의 경우 길이는 1이어야 합니다.

서비스

배송 서비스

입력란
delivery_countries[]

string

필수 항목입니다. 서비스가 적용되는 국가의 CLDR 지역 코드입니다.

rate_groups[]

RateGroup

선택사항입니다. 배송비 요율 그룹 정의입니다. 마지막 행에만 '기타'를 의미하는 빈 applicable_shipping_labels가 있을 수 있습니다. 다른 applicable_shipping_labels는 겹치지 않아야 합니다.

loyalty_programs[]

LoyaltyProgram

선택사항입니다. 이 배송 서비스로 제한된 포인트 제도입니다.

service_name

string

필수 항목입니다. 자유 형식의 서비스 이름입니다. 대상 계정 내에서 고유해야 합니다.

active

bool

필수 항목입니다. 배송 서비스의 활성 상태를 노출하는 불리언입니다.

currency_code

string

이 서비스가 적용되는 통화의 CLDR 코드입니다. 요금 그룹의 요금과 일치해야 합니다.

delivery_time

DeliveryTime

필수 항목입니다. 주문부터 제품 배송까지 다양한 측면에서 소요된 시간입니다.

shipment_type

ShipmentType

이 서비스가 주문 상품을 배송하는 위치의 유형입니다.

minimum_order_value

Price

이 서비스의 최소 주문 금액입니다. 설정된 경우 고객이 이 금액 이상을 지출해야 함을 나타냅니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다. minimum_order_value_table과 함께 설정할 수 없습니다.

minimum_order_value_table

MinimumOrderValueTable

수령 처리 유형의 매장별 최소 주문 금액 표 minimum_order_value와 함께 설정할 수 없습니다.

store_config

StoreConfig

제품을 배송하는 매장 목록입니다. 지역 배송 배송 유형에만 적용됩니다.

LoyaltyProgram

판매자가 제공하는 포인트 제도

입력란
loyalty_program_tiers[]

LoyaltyProgramTiers

선택사항입니다. 이 배송 서비스의 포인트 제도 등급입니다.

program_label

string

판매자 센터의 포인트 제도 설정에 설정된 포인트 제도 라벨입니다. 이 하위 속성을 사용하면 Google에서 요건을 충족하는 제품에 포인트 제도를 매핑할 수 있습니다.

LoyaltyProgramTiers

판매자 포인트 제도의 하위 집합입니다.

입력란
tier_label

string

등급 라벨[tier_label] 하위 속성은 제품 수준 혜택을 각 등급별로 구분합니다. 이 값도 판매자 센터의 포인트 제도 설정에서 설정되며 포인트 제도에 등급이 1개만 있는 경우에도 데이터 소스를 변경하는 데 필요합니다.

ShipmentType

배송 서비스의 배송 유형입니다.

열거형
SHIPMENT_TYPE_UNSPECIFIED 이 서비스에 배송 유형이 지정되지 않았습니다.
DELIVERY 이 서비스는 고객이 선택한 주소로 주문 상품을 배송합니다.
LOCAL_DELIVERY 이 서비스는 고객이 선택한 주소로 주문 상품을 배송합니다. 주문 상품이 근처에 있는 오프라인 매장에서 배송됩니다.
COLLECTION_POINT 이 서비스는 고객이 선택한 주소로 주문 상품을 배송합니다. 주문 상품이 화물 취급소에서 발송됩니다.

StoreConfig

제품을 배송하는 매장 목록입니다. 지역 배송 배송 유형에만 적용됩니다.

입력란
store_codes[]

string

선택사항입니다. 지역 배송을 제공하는 판매점 코드 목록입니다. 비어 있으면 all_stores이 true여야 합니다.

store_service_type

StoreServiceType

이 판매자가 등록하는 모든 매장 또는 일부 매장에서 지역 배송을 제공하는지 여부를 나타냅니다.

cutoff_config

CutoffConfig

지역 배송과 관련된 구성이 당일 종료됩니다.

service_radius

Distance

최대 배송 반경입니다. 이는 지역 배송 배송 유형에만 필요합니다.

CutoffConfig

지역 배송과 관련된 구성이 당일 종료됩니다.

입력란
local_cutoff_time

LocalCutoffTime

현지 배송이 종료되는 시간입니다.

store_close_offset_hours

int64

지역 배송 처리에서만 유효합니다. 매장 폐점 전 몇 시간으로 마감 시간을 표시합니다. local_cutoff_time와 상호 배타적입니다.

no_delivery_post_cutoff

bool

n일 현지 배송으로 구성된 배송 서비스를 이용하는 경우 판매자는 n+1일 지역 배송 표시를 선택 해제할 수 있습니다. 예를 들어 배송 서비스에서 당일 배송을 정의하고 마감 시간이 지난 경우 이 필드를 true로 설정하면 계산된 배송 서비스 요금이 NO_DELIVERY_POST_CUTOFF로 반환됩니다. 같은 예에서 이 필드를 false로 설정하면 계산된 배송 시간이 하루가 됩니다. 지역 배송에만 해당됩니다.

LocalCutoffTime

현지 배송이 종료되는 시간입니다.

입력란
hour

int64

당일 배송을 처리하려면 시간별 지역 배송 주문을 완료해야 합니다.

minute

int64

당일 배송 주문을 처리하려면 분 단위로 주문해야 합니다.

StoreServiceType

판매자가 등록하는 모든 매장 또는 일부 매장에서 지역 배송을 제공하는지 여부를 나타냅니다.

열거형
STORE_SERVICE_TYPE_UNSPECIFIED 매장 서비스 유형을 지정하지 않았습니다.
ALL_STORES 이 판매자가 등록하는 현재 및 미래의 모든 매장에서 지역 배송을 제공하는지 여부를 나타냅니다.
SELECTED_STORES store_codes에 등록된 매장만 지역 배송이 가능함을 나타냅니다.

ShippingSettings

판매자 계정의 [배송 설정](https://support.google.com/merchants/answer/6069284)

입력란
name

string

식별자. 배송 설정의 리소스 이름입니다. 형식: accounts/{account}/shippingSetting

services[]

Service

선택사항입니다. 대상 계정의 서비스 목록입니다.

warehouses[]

Warehouse

선택사항입니다. services에서 참조할 수 있는 웨어하우스 목록입니다.

etag

string

필수 항목입니다. 이 필드는 비동기 문제를 방지하는 데 사용됩니다. 통화 수신과 통화 삽입 사이에 배송 설정 데이터가 변경되지 않았는지 확인합니다. 사용자는 다음 단계를 수행해야 합니다.

  1. 최초 배송 설정을 만들 때 etag 필드를 빈 문자열로 설정합니다.

  2. 처음 생성 후 호출 삽입 전에 get 메서드를 호출하여 etag와 현재 배송 설정 데이터를 가져옵니다.

  3. 원하는 배송 설정 정보로 수정합니다.

  4. 2단계에서 얻은 etag를 사용하여 원하는 배송 설정 정보와 함께 삽입 메서드를 호출합니다.

  5. 2단계와 4단계 사이에 배송 설정 데이터가 변경된 경우 배송 설정 데이터가 변경될 때마다 etag가 변경되므로 삽입 요청이 실패합니다. 사용자는 새 etag로 2~4단계를 반복해야 합니다.

테이블

요금 그룹을 정의하는 표(single_value가 충분히 표현되지 않는 경우)

입력란
rows[]

Row

필수 항목입니다. 테이블을 구성하는 행 목록입니다. 길이는 row_headers와 같아야 합니다.

name

string

테이블의 이름입니다. 하위 테이블에는 필수이며 기본 테이블에서는 무시됩니다.

row_headers

Headers

필수 항목입니다. 테이블 행의 헤더입니다.

column_headers

Headers

테이블 열의 헤더입니다. 선택사항: 설정하지 않으면 테이블에 하나의 측정기준만 포함됩니다.

TaxRule

기본 유형 합의

비율 마이크로 : 100% = 1 000 000 및 1% = 10 000은 음수가 될 수 없습니다.

단일 세금 관리자가 담당하는 지역으로 배송되는 주문에 적용되는 세금 연관성 및 관련 매개변수에 관한 정보입니다. Nexus는 세무 관리자가 관리하는 지역에서 판매자가 비즈니스를 수행할 때 생성됩니다 (미국 주에서만 연결성 구성이 지원됨). 미국 주에서 연관성이 있는 판매자의 경우 판매자는 배송지와 관련된 모든 세무 당국에 세금을 납부해야 합니다. 다음 ID : 8

입력란
region_code

string

이 규칙이 적용되는 리전 코드입니다.

shipping_taxed

bool

설정하면 이 관리자의 지역으로 배송할 때 배송비에 제품과 동일한 세율이 적용됩니다. 카테고리가 없는 미국 주에서만 설정할 수 있습니다.

effective_time_period

Interval

필수 항목입니다. 이 규칙이 적용되는 기간입니다. 나열된 유효_시간에서 기간이 누락된 경우 미래 시점으로 무기한됩니다. 이 기간의 시작과 종료 시간은 배타적입니다.

통합 필드 location. 우편번호 범위 또는 기준 ID를 사용하여 위치를 설명하세요. location는 다음 중 하나여야 합니다.
location_id

int64

이 규칙이 적용되는 지역의 admin_id 또는 criteria_id입니다.

post_code_range

TaxPostalCodeRange

이 규칙이 적용되는 우편번호 범위입니다.

통합 필드 rate_calculation. 이 관리자의 지역으로 배송되는 상품에 적용되는 세율을 계산하는 방법은 무엇인가요? 미국 주에만 설정할 수 있습니다. rate_calculation는 다음 중 하나여야 합니다.
use_google_rate

bool

배송 위치에 따른 세율: 판매자가 해당 미국 주에 연관성이 있는 경우 배송 지역 관할권이 있는 당국의 요금이 합산됩니다.

self_specified_rate_micros

int64

마이크로 단위로 지정된 고정 요율로, 100% = 1_000_000입니다. 판매지 기반 주에 적합합니다.

TaxPostalCodeRange

지역을 정의하는 우편번호 범위입니다.

입력란
start

string

필수 항목입니다. 우편번호 범위의 시작으로, 범위에서 가장 작은 값입니다.

end

string

우편번호 범위의 끝입니다. 지정하지 않으면 시작과 동일합니다.

TermsOfService

TermsOfService -

입력란
name

string

식별자. 서비스 약관 버전의 리소스 이름입니다. 형식: termsOfService/{version}

region_code

string

CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 어느 국가에서든 동일한 TermsOfService에 로그인할 수 있는 경우 001입니다. 하지만 전 세계에 적용되는 서비스 약관에 서명할 때도 특정 국가 (판매자 비즈니스 국가 또는 프로그램 참여 국가)를 제공해야 합니다.

kind

TermsOfServiceKind

이 서비스 약관 버전이 적용되는 종류입니다.

external

bool

이 서비스 약관 버전이 외부 버전인지 여부입니다. 외부 서비스 약관 버전은 외부 프로세스를 통해서만 동의할 수 있으며 UI 또는 API를 통해 판매자가 직접 동의할 수 없습니다.

file_uri

string

서명 사용자에게 표시해야 하는 서비스 약관 파일의 URI입니다.

TermsOfServiceAgreementState

이 리소스는 지정된 계정 및 서비스 약관 종류의 계약 상태를 나타냅니다. 상태는 다음과 같습니다.

  • 판매자가 서비스 약관에 동의한 경우 수락됨이 표시되고 그렇지 않으면 비어 있습니다.
  • 판매자가 서비스 약관에 서명해야 하는 경우 required라고 입력되어 있고 그렇지 않으면 비어 있습니다.

필수허용이 모두 있을 수 있습니다. 이 경우 accepted 서비스 약관의 valid_until 필드에 만료일이 설정됩니다. 계정에서 유효한 계약을 계속 유지하려면 valid_until 전에 required 서비스 약관에 동의해야 합니다. 새로운 서비스 약관에 동의할 때 서드 파티는 해당 서비스 약관과 관련된 텍스트를 표시해야 합니다 (텍스트가 포함된 파일의 URL이 아래의 필수 메시지에 tos_file_uri로 추가됨). 서비스 약관에 실제로 동의하려면 TermsOfService 리소스에 대해 accept를 호출해야 합니다.

입력란
name

string

식별자. 서비스 약관 버전의 리소스 이름입니다. 형식: accounts/{account}/termsOfServiceAgreementState/{identifier}

region_code

string

https://cldr.unicode.org/에 정의된 리전 코드입니다. 현재 주가 적용되는 국가입니다.

terms_of_service_kind

TermsOfServiceKind

특정 버전과 연결된 서비스 약관 종류입니다.

accepted

Accepted

이 유형 및 연결된 region_code에 대해 승인된 서비스 약관

required

Required

필수 서비스 약관

TermsOfServiceKind

약관 종류입니다.

열거형
TERMS_OF_SERVICE_KIND_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
MERCHANT_CENTER 판매자 센터 애플리케이션

TransitTable

행 및 열 측정기준을 기준으로 한 운송 시간 표, 운송에 소요된 영업일 기준의 일수입니다. min_transit_days, max_transit_days 또는 transit_time_table 중 하나를 설정할 수 있지만 둘 다 설정할 수는 없습니다.

입력란
postal_code_group_names[]

string

필수 항목입니다. 리전 이름 목록 Region.name . 마지막 값은 "all other locations"일 수 있습니다. 예를 들면 ["zone 1", "zone 2", "all other locations"]입니다. 참조된 우편번호 그룹은 서비스 배송 국가와 일치해야 합니다.

transit_time_labels[]

string

필수 항목입니다. 운송 시간 라벨의 목록입니다. 마지막 값은 "all other labels"일 수 있습니다. 예: ["food", "electronics", "all other labels"]

rows[]

TransitTimeRow

필수 항목입니다. postal_code_group_names 또는 transit_time_labels의 측정기준 모음이 하나만 있는 경우, 해당 측정기준의 값이 각각 하나씩 포함된 행이 여러 개 있습니다. 측정기준이 두 개인 경우 각 행은 postal_code_group_names에, 열 (값)은 transit_time_labels에 해당합니다.

TransitTimeRow

postal_code_group_names 또는 transit_time_labels의 측정기준 모음이 하나만 있는 경우, 해당 측정기준의 값이 각각 하나씩 포함된 행이 여러 개 있습니다. 측정기준이 두 개인 경우 각 행은 postal_code_group_names에, 열 (값)은 transit_time_labels에 해당합니다.

입력란
values[]

TransitTimeValue

필수 항목입니다. 영업일 기준 운송 기간 (최소~최대)입니다.

TransitTimeValue

영업일 기준 운송 기간 (최소~최대)입니다.

입력란
min_transit_days

int32

영업일 기준 최소 운송 기간입니다. 0은 당일 배송을 의미하고 1은 익일 배송을 의미합니다.

max_transit_days

int32

min_transit_days 이상이어야 합니다.

UnclaimHomepageRequest

UnclaimHomepage 메서드에 대한 요청 메시지입니다.

입력란
name

string

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

UpdateAccountRequest

UpdateAccount 메서드에 대한 요청 메시지입니다.

입력란
account

Account

필수 항목입니다. 계정의 새 버전입니다.

update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.

UpdateAccountTaxRequest

세금 설정 업데이트 요청

입력란
account_tax

AccountTax

필수 항목입니다. 업데이트될 세금 설정

update_mask

FieldMask

업데이트할 필드 목록입니다.

UpdateBusinessIdentityRequest

UpdateBusinessIdentity 메서드에 대한 요청 메시지입니다.

입력란
business_identity

BusinessIdentity

필수 항목입니다. 새로운 버전의 비즈니스 아이덴티티입니다.

update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.

UpdateBusinessInfoRequest

UpdateBusinessInfo 메서드에 대한 요청 메시지입니다.

입력란
business_info

BusinessInfo

필수 항목입니다. 새로운 버전의 비즈니스 정보입니다.

update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.

UpdateEmailPreferencesRequest

UpdateEmailPreferences 메서드의 요청 메시지입니다.

입력란
email_preferences

EmailPreferences

필수 항목입니다. 이메일 환경설정을 업데이트할 예정입니다.

update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.

UpdateHomepageRequest

UpdateHomepage 메서드에 대한 요청 메시지입니다.

입력란
homepage

Homepage

필수 항목입니다. 홈페이지의 새 버전입니다.

update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.

UpdateRegionRequest

UpdateRegion 메서드에 대한 요청 메시지입니다.

입력란
region

Region

필수 항목입니다. 업데이트된 리전입니다.

update_mask

FieldMask

선택사항입니다. 업데이트할 필드를 나타내는 쉼표로 구분된 필드 마스크입니다. 예: "displayName,postalCodeArea.regionCode"

UpdateUserRequest

UpdateUser 메서드에 대한 요청 메시지입니다.

입력란
user

User

필수 항목입니다. 사용자의 새 버전입니다.

accounts/{account}/users/me에서와 같이 이름 필드에 이메일 주소가 아닌 me를 사용하여 발신자에 해당하는 사용자를 업데이트할 수도 있습니다.

update_mask

FieldMask

필수 항목입니다. 업데이트 중인 필드 목록입니다.

사용자

사용자입니다.

입력란
name

string

식별자. 사용자의 리소스 이름입니다. 형식: accounts/{account}/user/{user}

state

State

출력 전용입니다. 사용자의 상태입니다.

access_rights[]

AccessRight

선택사항입니다. 사용자의 액세스 권한

상태

사용자의 가능한 상태입니다.

열거형
STATE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
PENDING 사용자가 확인 대기 중입니다. 이 상태에서 사용자는 다른 작업을 수행하기 전에 먼저 초대를 수락해야 합니다.
VERIFIED 사용자가 확인되었습니다.

가치

요금 그룹의 단일 값 또는 요금 그룹 표의 셀 값입니다. no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name 중 정확히 하나를 설정해야 합니다.

입력란
no_shipping

bool

true인 경우 제품을 배송할 수 없습니다. 설정할 때는 true여야 하며, 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

flat_rate

Price

고정 요금 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

price_percentage

string

십진수 표기법 (예: "5.4")으로 표시된 가격의 비율입니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

carrier_rate

string

동일한 배송비 그룹에서 정의된 운송업체 배송비를 참조하는 운송업체 배송비의 이름입니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

subtable

string

하위 표의 이름입니다. 표 셀에서만 설정할 수 있으며 (예: 단일 값이 아닌 경우) 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.

창고

재고를 저장하고 처리하는 주문 처리 창고 다음 태그: 7

입력란
name

string

필수 항목입니다. 웨어하우스의 이름입니다. 계정 내에서 고유해야 합니다.

shipping_address

Address

필수 항목입니다. 창고의 배송지 주소입니다.

cutoff_time

WarehouseCutoffTime

필수 항목입니다. 주문을 수락하고 처리를 시작할 수 있는 가장 늦은 시간입니다. 이후 주문은 다음 날 처리됩니다. 시간은 창고 우편번호를 기준으로 합니다.

handling_days

int64

필수 항목입니다. 이 창고에서 상품을 포장하고 배송하는 데 걸리는 기간(일)입니다. 창고 수준이지만 상품의 속성에 따라 상품 수준에서 재정의할 수 있습니다.

business_day_config

BusinessDayConfig

창고의 영업일입니다. 설정하지 않으면 기본적으로 월요일부터 금요일까지입니다.

WarehouseBasedDeliveryTime

선택한 운송업체의 설정에 따라 창고 (배송지 위치)별로 배송 시간을 계산해야 함을 나타냅니다. 설정되면 delivery_time에 다른 운송 시간 관련 필드를 설정하면 안 됩니다.

입력란
carrier

string

필수 항목입니다. 이동통신사(예: "UPS" 또는 "Fedex")

carrier_service

string

필수 항목입니다. 운송업체 서비스(예: "ground" 또는 "2 days") 서비스 이름이 eddSupportedServices 목록에 있어야 합니다.

warehouse

string

필수 항목입니다. 웨어하우스 이름입니다. [warehouse][ShippingSetting.warehouses.name]과 일치해야 합니다.

WarehouseCutoffTime

주문을 수락하고 처리를 시작할 수 있는 가장 늦은 시간입니다. 이후 주문은 다음 날 처리됩니다. 시간은 창고 우편번호를 기준으로 합니다.

입력란
hour

int32

필수 항목입니다. 창고에서 당일에 주문을 처리하기 위해 주문해야 하는 마감 시간의 시간입니다. 시간은 창고의 시간대를 기준으로 합니다.

minute

int32

필수 항목입니다. 창고에서 당일에 주문을 처리하기 위해 주문해야 하는 마감 시간(분)입니다. 분은 창고의 시간대를 기준으로 합니다.