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 Overview를 참고하세요.

AccountsService

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

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

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

승인 범위

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

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

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

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

독립형, MCA, 하위 계정 등 유형과 관계없이 지정된 계정을 삭제합니다. MCA를 삭제하면 모든 하위 계정이 삭제됩니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다. 계정이 다른 계정에 서비스를 제공하지 않고 처리된 제품이 없는 경우에만 삭제가 완료됩니다. force 매개변수를 사용하여 이를 재정의할 수 있습니다.

승인 범위

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

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

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

rpc GetAccount(GetAccountRequest) returns (Account)

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

승인 범위

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

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

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

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

호출 사용자가 액세스할 수 있고 페이지 크기 또는 필터와 같은 요청의 제약 조건과 일치하는 계정을 나열합니다. 여기에는 MCA의 하위 계정뿐만 아니라 호출 사용자가 액세스할 수 있는 다른 MCA, 연결된 계정, 독립형 계정 등의 모든 계정이 나열됩니다. 필터를 제공하지 않으면 사용자가 직접 추가된 계정이 반환됩니다. 이 메서드는 궁극적으로 일관성이 있으므로 계정 생성, 업데이트 또는 계정 간의 관계 변경과 같은 변경사항이 결과에 즉시 표시되지 않을 수 있습니다. 대신 이러한 변경사항은 짧은 기간에 걸쳐 전파되며, 그 후 업데이트된 정보가 연결된 조건자와 일치할 수 있습니다. 즉, 계정 이름으로 검색하면 최근에 변경된 계정이 조건자를 충족하더라도 반환되지 않을 수 있습니다.

승인 범위

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

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

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

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

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

승인 범위

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

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

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

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

독립형, MCA 또는 하위 계정 등 계정 유형과 관계없이 계정을 업데이트합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

승인 범위

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

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

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

AutofeedSettingsService

자동 피드 설정을 지원하는 서비스입니다.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

계정의 자동 피드 설정을 가져옵니다.

승인 범위

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

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

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

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

계정의 자동 피드 설정을 업데이트합니다.

승인 범위

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

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

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

BusinessIdentityService

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

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

계정의 비즈니스 ID를 가져옵니다.

승인 범위

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

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

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

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

계정의 비즈니스 ID를 업데이트합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

승인 범위

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

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

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

BusinessInfoService

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

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

계정의 비즈니스 정보를 가져옵니다.

승인 범위

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

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

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

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

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

승인 범위

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

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

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

EmailPreferencesService

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

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

판매자 센터 계정 사용자의 이메일 환경설정을 반환합니다. 이 서비스는 인증된 사용자의 이메일 환경설정만 가져오고 업데이트할 수 있습니다. name=accounts/*/users/me/emailPreferences 별칭을 사용하여 인증된 사용자의 환경설정을 가져옵니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 Overview를 참고하세요.
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 Overview를 참고하세요.

HomepageService

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

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

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

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

승인 범위

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

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

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

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

매장의 홈페이지를 가져옵니다.

승인 범위

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

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

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

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

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

승인 범위

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

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

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

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

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

승인 범위

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

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

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

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 Overview를 참고하세요.
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

지정된 판매자의 기존 반품 정책을 모두 나열합니다.

승인 범위

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

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

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

ProgramsService

프로그램 관리를 위한 서비스입니다.

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

이 서비스는 사용 가능한 모든 프로그램에 대한 판매자의 참여를 검색하는 메서드와 각 프로그램의 참여를 명시적으로 사용 설정하거나 사용 중지하는 메서드를 노출합니다.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

계정의 지정된 프로그램 참여를 사용 중지합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

승인 범위

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

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

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

rpc EnableProgram(EnableProgramRequest) returns (Program)

계정에 대해 지정된 프로그램 참여를 사용 설정합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

승인 범위

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

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

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

rpc GetProgram(GetProgramRequest) returns (Program)

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

승인 범위

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

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

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

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

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

승인 범위

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

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

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

RegionsService

지역 구성을 관리합니다.

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

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

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

승인 범위

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

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

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

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

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

승인 범위

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

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

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

rpc GetRegion(GetRegionRequest) returns (Region)

판매자 센터 계정에 정의된 지역을 가져옵니다.

승인 범위

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

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

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

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

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

승인 범위

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

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

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

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

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

승인 범위

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

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

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

ShippingSettingsService

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

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

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

승인 범위

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

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

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

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

판매자의 배송 설정을 배송 요청 설정으로 대체합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

승인 범위

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

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

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

TermsOfServiceAgreementStateService

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

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

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

승인 범위

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

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

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

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

애플리케이션 서비스 약관에 대한 동의 상태를 가져옵니다.

승인 범위

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

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

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

TermsOfServiceService

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

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

TermsOfService를 허용합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.

승인 범위

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

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

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

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

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

승인 범위

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

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

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

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

지정된 kind 및 region_code에 대해 TermsOfService의 최신 버전을 검색합니다.

승인 범위

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

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

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

UserService

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

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

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

승인 범위

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

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

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

rpc DeleteUser(DeleteUserRequest) returns (Empty)

판매자 센터 계정 사용자를 삭제합니다. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다. 삭제할 사용자는 해당 계정의 마지막 관리자 사용자가 될 수 없습니다. 또한 비즈니스 관리자가 관리하는 경우 사용자는 삭제되지 않습니다."

승인 범위

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

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

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

rpc GetUser(GetUserRequest) returns (User)

판매자 센터 계정 사용자를 가져옵니다.

승인 범위

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

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

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

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

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

승인 범위

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

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

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

rpc UpdateUser(UpdateUserRequest) returns (User)

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

승인 범위

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

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

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

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 이 권한이 있는 사용자는 실적 및 통계에 액세스할 수 있습니다.

계정

Account 메시지는 쇼핑 광고 내 판매자의 계정을 나타냅니다. 제품 데이터, 설정, Google 서비스 및 외부 제공업체와의 상호작용을 관리하는 기본 항목입니다.

계정은 독립된 항목으로 운영되거나 멀티 클라이언트 계정 (MCA) 구조의 일부가 될 수 있습니다. MCA 설정에서 상위 계정은 여러 하위 계정을 관리합니다.

계정을 설정하려면 계정 이름, 시간대, 언어 환경설정과 같은 속성을 구성해야 합니다.

Account 메시지는 AccountRelationship, Homepage, BusinessInfo 등 다른 많은 리소스의 상위 항목입니다.

필드
name

string

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

int64

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

string

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

bool

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

bool

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

TimeZone

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

쓰기 작업에서 time_zone는 reporting_time_zone와 display_time_zone를 모두 설정합니다.

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

string

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

AccountAggregation

이 유형에는 필드가 없습니다.

AccountAggregation 페이로드

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 개선을 위한 제안사항입니다.

주소

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

필드
street_address

string

주소의 상세 주소입니다. 예: 111w 31st Street
city

string

필수 항목입니다. 시, 마을 또는 코뮌 종속 지역 또는 하위 지역 (예: 동네 또는 교외)도 포함될 수 있습니다.
administrative_area

string

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

string

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

string

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

AutofeedSettings

자동 피드 설정과 관련된 정보 수집

필드
name

string

식별자. 자동 피드 설정의 리소스 이름입니다. 형식: accounts/{account}/autofeedSettings
enable_products

bool

필수 항목입니다. 지정된 계정의 자동 피드를 통한 제품 크롤링을 사용 설정 또는 중지합니다. 자동 피드 계정은 eligible 필드를 통해 확인할 수 있는 특정 조건을 충족해야 합니다. 계정이 마켓플레이스가 아닌 경우 자동 피드가 처음으로 사용 설정되면 일반적으로 제품이 즉시 표시됩니다. 재사용 설정 시 제품이 표시되는 데 최대 24시간이 걸릴 수 있습니다.
eligible

bool

출력 전용입니다. 판매자가 자동 피드에 등록될 자격이 있는지 확인합니다.

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

필수 항목입니다. 이 속성의 ID 선언입니다.

IdentityDeclaration

ID 선언과 관련된 모든 설정입니다.

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

PromotionsConsent

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

열거형

BusinessInfo

BusinessInfo 메시지에는 판매자의 비즈니스에 관한 필수 정보가 포함되어 있습니다.

이 메시지에는 실제 주소, 고객 서비스 담당자, 지역별 식별자와 같은 주요 비즈니스 세부정보가 포함됩니다.

필드
name

string

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

PostalAddress

선택사항입니다. 비즈니스 주소입니다. region_code, address_lines, postal_code, administrative_area, locality 필드만 지원됩니다. 다른 모든 필드는 무시됩니다.
phone

PhoneNumber

출력 전용입니다. 비즈니스의 전화번호
phone_verification_state

PhoneVerificationState

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

CustomerService

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

string

선택사항입니다. XXX-XX-XXXXX 형식의 대시로 구분된 10자리 대한민국 사업자등록번호입니다.

CarrierRate

main_table 또는 single_value에서 참조할 수 있는 이동통신사 요금 목록입니다. 지원되는 운송업체 서비스는 https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only에 정의되어 있습니다.

필드
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
overwrite

bool

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

CreateAndConfigureAccountRequest

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

필드
account

Account

필수 항목입니다. 생성할 계정입니다.
users[]
(deprecated)

CreateUserRequest

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

이 필드는 지원 중단되었으며 API가 베타 버전에서 진화한 후에는 존재하지 않습니다. 대신 user 필드를 사용하세요.
user[]

AddUser

선택사항입니다. 계정에 추가할 사용자입니다.
service[]

AddAccountService

필수 항목입니다. 생성할 계정과 제공업체 계정 간의 계정 서비스가 생성의 일부로 초기화됩니다. 이러한 서비스가 하나 이상 제공되어야 합니다. 현재 이 중 하나는 정확히 account_aggregation여야 합니다. 즉, 이 메서드를 통해 독립형 계정이 아닌 하위 계정만 만들 수 있습니다. 추가 account_management 또는 product_management 서비스가 제공될 수 있습니다.

AddAccountService

계정 생성 중에 계정 서비스를 추가하는 방법에 관한 추가 안내

필드
통합 필드 service_type. 추가할 서비스 유형입니다. service_type은 다음 중 하나여야 합니다.
account_aggregation

AccountAggregation

제공업체는 계정의 애그리게이터입니다. 서비스 유형 계정 집계의 페이로드입니다.
provider

string

필수 항목입니다. 서비스 제공업체입니다. providers/123와 같은 계정 참조 또는 잘 알려진 서비스 제공업체 (providers/GOOGLE_ADS 또는 providers/GOOGLE_BUSINESS_PROFILE 중 하나)입니다.

AddUser

계정 생성 중에 계정에 사용자를 추가하는 방법 안내

필드
user_id

string

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

User

선택사항입니다. 추가할 사용자에 관한 세부정보입니다. 현재는 액세스 권한만 지정할 수 있습니다.

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

필수 항목입니다. 시간대 식별자 예: 'Europe/Zurich'

DeleteAccountRequest

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

필드
name

string

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

bool

선택사항입니다. true로 설정하면 다른 계정에 서비스를 제공하거나 제품을 처리한 계정이라도 삭제됩니다.

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은 다음날 배송을 의미합니다. 'min_handling_days'와 'max_handling_days'는 동시에 설정하거나 설정하지 않아야 합니다.
max_handling_days

int32

주문 제품이 발송되기까지 걸리는 최대 영업일 수입니다. 0은 당일 배송을, 1은 다음날 배송을 의미합니다. min_handling_days 이상이어야 합니다. 'min_handling_days'와 'max_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

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

필드
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}

GetAutofeedSettingsRequest

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

필드
name

string

필수 항목입니다. 자동 피드 설정의 리소스 이름입니다. 형식: accounts/{account}/autofeedSettings

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} 식별자 형식은 {TermsOfServiceKind}-{country}입니다.

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개 이하', '항목 50개 이하', '항목 50개 초과' 헤더를 나타냅니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.
postal_code_group_names[]

string

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

LocationIdSet

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

홈페이지

Homepage 메시지는 시스템 내 판매자의 스토어 홈페이지를 나타냅니다.

판매자의 홈페이지는 고객이 매장과 상호작용하는 기본 도메인입니다.

홈페이지는 소유권 증빙 자료로 소유권을 주장하고 인증할 수 있으며, 판매자는 인증된 웹사이트가 필요한 기능을 사용할 수 있습니다. 자세한 내용은 온라인 상점 URL 인증 이해하기를 참고하세요.

필드
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

string

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

ListAccountIssuesResponse

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

필드
account_issues[]

AccountIssue

지정된 계정의 문제입니다.
next_page_token

string

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

ListAccountsRequest

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

필드
page_size

int32

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

string

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

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

string

선택사항입니다. 필터와 일치하는 계정만 반환합니다. 자세한 내용은 필터 문법 참조를 참고하세요.

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

필수 항목입니다. 집계 서비스 제공업체입니다. 형식: providers/{providerId}
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)을 공유하는 매장 코드 세트 목록입니다. 세트는 2개 이상 필요하며 마지막 세트는 비워야 합니다. 이는 '다른 모든 저장소의 MOV'를 나타냅니다. 각 매장 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다.

StoreCodeSetWithMov

동일한 최소 주문 금액을 공유하는 매장 코드 세트 목록입니다. 세트는 2개 이상 필요하며 마지막 세트는 비워야 합니다. 이는 '다른 모든 저장소의 MOV'를 나타냅니다. 각 매장 코드는 모든 세트에 한 번만 표시될 수 있습니다. 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다.

필드
store_codes[]

string

선택사항입니다. 고유한 상점 코드 목록 또는 포괄을 위한 빈 목록입니다.
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

반품 정책
seasonal_overrides[]

SeasonalOverride

선택사항입니다. 특정 시간 간격 동안 이루어진 주문에 대한 일반 정책을 재정의합니다.
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

총 가격의 비율(단위: 1백만 분의 1)입니다. 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 고객이 실제 반품 배송비를 지불합니다.

SeasonalOverride

다음: 5

필드
label

string

필수 항목입니다. 판매자 센터에 표시되는 이 시즌별 재정의의 표시 이름입니다.
begin

Date

필수 항목입니다. 이 시즌 예외가 적용되는 기간을 정의합니다. 시작일과 종료일 모두 양 끝값을 포함하며 날짜 소수점 형식(예: 20250115)이어야 합니다. 시즌 예외의 날짜가 겹쳐서는 안 됩니다.
end

Date

필수사항입니다. 시즌 예외 종료일 (해당 날짜 포함)입니다.
policy

Policy

필수 항목입니다. 지정된 기간의 반품 정책입니다.

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_table 및 subtables가 설정되지 않은 경우에만 설정할 수 있습니다.
main_table

Table

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

string

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

지역

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

필드
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로 설정하면 계산된 배송 시간이 1일로 표시됩니다. 이 기능은 오프라인 배송에만 사용할 수 있습니다.

LocalCutoffTime

당일 오프라인 배송이 종료되는 시간입니다.

필드
hour

int64

당일 처리를 위해 오프라인 배송 주문을 몇 시까지 해야 하는지 지정합니다.
minute

int64

당일 처리하려면 몇 분 이내에 오프라인 배송 주문을 해야 합니다.

StoreServiceType

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

열거형
STORE_SERVICE_TYPE_UNSPECIFIED 스토어 서비스 유형을 지정하지 않았습니다.
ALL_STORES 이 판매자가 등록한 현재 및 향후의 모든 매장에서 오프라인 배송을 제공하는지 여부를 나타냅니다.
SELECTED_STORES store_codes에 등록된 매장만 오프라인 배송이 가능하다는 것을 나타냅니다.

ShippingSettings

판매자 계정의 배송 설정

필드
name

string

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

Service

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

Warehouse

선택사항입니다. services에서 참조할 수 있는 창고 목록입니다.
etag

string

필수 항목입니다. 이 필드는 비동기 문제를 방지하는 데 사용됩니다. get 호출과 insert 호출 간에 배송 설정 데이터가 변경되지 않았는지 확인합니다. 사용자는 다음 단계를 따라야 합니다.

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

  2. 처음 만들고 나서 get 메서드를 호출하여 etag 및 현재 배송 설정 데이터를 가져온 후 insert를 호출합니다.

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

  4. 2단계에서 가져온 etag를 사용하여 원하는 배송 설정 정보로 삽입 메서드를 호출합니다.

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

표

single_value가 충분히 표현적이지 않은 경우 요금 그룹을 정의하는 테이블입니다.

필드
rows[]

Row

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

string

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

Headers

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

Headers

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

TermsOfService

TermsOfService 메시지는 판매자가 특정 기능 또는 서비스에 액세스하기 위해 동의해야 하는 서비스 약관의 특정 버전을 나타냅니다 (https://support.google.com/merchants/answer/160173) 참고).

이 메시지는 판매자가 서비스 사용에 필요한 법적 계약에 동의하도록 하여 온보딩 프로세스에 중요한 역할을 합니다. 판매자는 RetrieveLatestTermsOfService를 통해 특정 kind 및 region의 최신 서비스 약관을 가져오고 필요에 따라 AcceptTermsOfService를 통해 이를 수락할 수 있습니다.

필드
name

string

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

string

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

TermsOfServiceKind

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

bool

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

string

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

TermsOfServiceAgreementState

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

  • 판매자가 서비스 약관에 동의한 경우 동의함이 채워지고 그렇지 않은 경우 비워집니다.
  • 판매자가 서비스 약관에 서명해야 하는 경우 required가 채워지고 그렇지 않으면 비어 있습니다.

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

필드
name

string

식별자. 서비스 약관 버전의 리소스 이름입니다. 형식: accounts/{account}/termsOfServiceAgreementState/{identifier} 식별자 형식은 {TermsOfServiceKind}-{country}입니다. 예를 들어 식별자는 MERCHANT_CENTER-US일 수 있습니다.
region_code

string

https://cldr.unicode.org/에 정의된 지역 코드입니다. 현재 상태가 적용되는 국가입니다.
terms_of_service_kind

TermsOfServiceKind

특정 버전과 연결된 서비스 약관 유형입니다.
accepted

Accepted

이 유형의 서비스 약관 및 연결된 region_code에 동의한 경우
required

Required

필수 서비스 약관

TermsOfServiceKind

TermsOfService 종류입니다.

열거형
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

선택사항입니다. 업데이트되는 필드 목록입니다.

다음 필드는 snake_case 및 lowerCamelCase에서 모두 지원됩니다.

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

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

필드
autofeed_settings

AutofeedSettings

필수 항목입니다. 자동 피드 설정의 새 버전입니다.
update_mask

FieldMask

필수 항목입니다. 업데이트되는 필드 목록입니다.

UpdateBusinessIdentityRequest

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

필드
business_identity

BusinessIdentity

필수 항목입니다. 비즈니스 ID의 새 버전입니다.
update_mask

FieldMask

선택사항입니다. 업데이트되는 필드 목록입니다.

다음 필드는 snake_case 및 lowerCamelCase에서 모두 지원됩니다.

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

UpdateBusinessInfoRequest

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

필드
business_info

BusinessInfo

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

FieldMask

선택사항입니다. 업데이트되는 필드 목록입니다.

다음 필드는 snake_case 및 lowerCamelCase에서 모두 지원됩니다.

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

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

필드
email_preferences

EmailPreferences

필수 항목입니다. 이메일 환경설정이 업데이트됩니다.
update_mask

FieldMask

필수 항목입니다. 업데이트되는 필드 목록입니다.

다음 필드는 snake_case 및 lowerCamelCase에서 모두 지원됩니다.

  • news_and_tips

UpdateHomepageRequest

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

필드
homepage

Homepage

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

FieldMask

선택사항입니다. 업데이트되는 필드 목록입니다.

다음 필드는 snake_case 및 lowerCamelCase에서 모두 지원됩니다.

  • uri

UpdateRegionRequest

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

필드
region

Region

필수 항목입니다. 업데이트된 지역입니다.
update_mask

FieldMask

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

UpdateUserRequest

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

필드
user

User

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

me를 사용하여 자신의 이메일 주소를 참조합니다(예: accounts/{account}/users/me).
update_mask

FieldMask

선택사항입니다. 업데이트되는 필드 목록입니다.

다음 필드는 snake_case 및 lowerCamelCase에서 모두 지원됩니다.

  • access_rights

사용자

User 메시지는 판매자 센터 계정과 연결된 사용자를 나타냅니다. 계정 내에서 사용자 권한과 액세스 권한을 관리하는 데 사용됩니다. 자세한 내용은 사용자 및 액세스 수준에 관한 자주 묻는 질문(FAQ)을 참고하세요.

필드
name

string

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

me를 사용하여 자신의 이메일 주소를 참조합니다(예: accounts/{account}/users/me).
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

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

창고

재고를 저장하고 처리하는 처리 창고입니다.

필드
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

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