색인
AccountIssueService
(인터페이스)AccountsService
(인터페이스)BusinessIdentityService
(인터페이스)BusinessInfoService
(인터페이스)EmailPreferencesService
(인터페이스)HomepageService
(인터페이스)OnlineReturnPolicyService
(인터페이스)ProgramsService
(인터페이스)RegionsService
(인터페이스)ShippingSettingsService
(인터페이스)TermsOfServiceAgreementStateService
(인터페이스)TermsOfServiceService
(인터페이스)UserService
(인터페이스)AcceptTermsOfServiceRequest
(메시지)Accepted
(메시지)AccessRight
(열거형)Account
(메시지)AccountIssue
(메시지)AccountIssue.ImpactedDestination
(메시지)AccountIssue.ImpactedDestination.Impact
(메시지)AccountIssue.Severity
(열거형)Address
(메시지)BusinessDayConfig
(메시지)BusinessDayConfig.Weekday
(열거형)BusinessIdentity
(메시지)BusinessIdentity.IdentityAttribute
(메시지)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(열거형)BusinessIdentity.PromotionsConsent
(열거형)BusinessInfo
(메시지)CarrierRate
(메시지)ClaimHomepageRequest
(메시지)CreateAndConfigureAccountRequest
(메시지)CreateAndConfigureAccountRequest.AcceptTermsOfService
(메시지)CreateAndConfigureAccountRequest.AddAccountService
(메시지)CreateRegionRequest
(메시지)CreateUserRequest
(메시지)CustomerService
(메시지)CutoffTime
(메시지)DeleteAccountRequest
(메시지)DeleteRegionRequest
(메시지)DeleteUserRequest
(메시지)DeliveryTime
(메시지)DisableProgramRequest
(메시지)Distance
(메시지)Distance.Unit
(열거형)EmailPreferences
(메시지)EmailPreferences.OptInState
(열거형)EnableProgramRequest
(메시지)GetAccountRequest
(메시지)GetBusinessIdentityRequest
(메시지)GetBusinessInfoRequest
(메시지)GetEmailPreferencesRequest
(메시지)GetHomepageRequest
(메시지)GetOnlineReturnPolicyRequest
(메시지)GetProgramRequest
(메시지)GetRegionRequest
(메시지)GetShippingSettingsRequest
(메시지)GetTermsOfServiceAgreementStateRequest
(메시지)GetTermsOfServiceRequest
(메시지)GetUserRequest
(메시지)Headers
(메시지)Homepage
(메시지)InsertShippingSettingsRequest
(메시지)ListAccountIssuesRequest
(메시지)ListAccountIssuesResponse
(메시지)ListAccountsRequest
(메시지)ListAccountsResponse
(메시지)ListOnlineReturnPoliciesRequest
(메시지)ListOnlineReturnPoliciesResponse
(메시지)ListProgramsRequest
(메시지)ListProgramsResponse
(메시지)ListRegionsRequest
(메시지)ListRegionsResponse
(메시지)ListSubAccountsRequest
(메시지)ListSubAccountsResponse
(메시지)ListUsersRequest
(메시지)ListUsersResponse
(메시지)LocationIdSet
(메시지)MinimumOrderValueTable
(메시지)MinimumOrderValueTable.StoreCodeSetWithMov
(메시지)OnlineReturnPolicy
(메시지)OnlineReturnPolicy.ItemCondition
(열거형)OnlineReturnPolicy.Policy
(메시지)OnlineReturnPolicy.Policy.Type
(열거형)OnlineReturnPolicy.RestockingFee
(메시지)OnlineReturnPolicy.ReturnMethod
(열거형)OnlineReturnPolicy.ReturnShippingFee
(메시지)OnlineReturnPolicy.ReturnShippingFee.Type
(열거형)PhoneVerificationState
(열거형)Program
(메시지)Program.Requirement
(메시지)Program.State
(열거형)RateGroup
(메시지)Region
(메시지)Region.GeoTargetArea
(메시지)Region.PostalCodeArea
(메시지)Region.PostalCodeArea.PostalCodeRange
(메시지)Required
(메시지)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(메시지)RetrieveLatestTermsOfServiceRequest
(메시지)Row
(메시지)Service
(메시지)Service.LoyaltyProgram
(메시지)Service.LoyaltyProgram.LoyaltyProgramTiers
(메시지)Service.ShipmentType
(열거형)Service.StoreConfig
(메시지)Service.StoreConfig.CutoffConfig
(메시지)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(메시지)Service.StoreConfig.StoreServiceType
(열거형)ShippingSettings
(메시지)Table
(메시지)TermsOfService
(메시지)TermsOfServiceAgreementState
(메시지)TermsOfServiceKind
(열거형)TransitTable
(메시지)TransitTable.TransitTimeRow
(메시지)TransitTable.TransitTimeRow.TransitTimeValue
(메시지)UnclaimHomepageRequest
(메시지)UpdateAccountRequest
(메시지)UpdateBusinessIdentityRequest
(메시지)UpdateBusinessInfoRequest
(메시지)UpdateEmailPreferencesRequest
(메시지)UpdateHomepageRequest
(메시지)UpdateRegionRequest
(메시지)UpdateUserRequest
(메시지)User
(메시지)User.State
(열거형)Value
(메시지)Warehouse
(메시지)WarehouseBasedDeliveryTime
(메시지)WarehouseCutoffTime
(메시지)
AccountIssueService
AccountIssueService
API를 지원하는 서비스입니다.
ListAccountIssues |
---|
판매자 센터 계정의 모든 계정 문제를 나열합니다.
|
AccountsService
계정 API를 지원하는 서비스입니다.
CreateAndConfigureAccount |
---|
추가 구성이 있는 독립형 판매자 센터 계정을 만듭니다. 요청을 하는 사용자를 새 계정의 관리자로 추가합니다.
|
DeleteAccount |
---|
독립형, MCA, 하위 계정 중 유형에 관계없이 지정된 계정을 삭제합니다. MCA를 삭제하면 모든 하위 계정이 삭제됩니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
GetAccount |
---|
판매자 센터 계정에서 계정을 검색합니다. 계정을 삽입, 업데이트 또는 삭제한 후 변경사항이 적용되기까지 몇 분 정도 걸릴 수 있습니다.
|
ListAccounts |
---|
호출하는 사용자가 액세스할 수 있고 페이지 크기 또는 필터와 같은 요청의 제약 조건과 일치하는 계정을 나열합니다. 여기에는 MCA의 하위 계정만 나열되는 것이 아니라 호출하는 사용자가 다른 MCA, 연결된 계정, 독립형 계정 등을 포함하여 액세스할 수 있는 모든 계정이 표시됩니다.
|
ListSubAccounts |
---|
특정 멀티 클라이언트 계정의 모든 하위 계정을 나열합니다. 이는 더 강력한
|
UpdateAccount |
---|
독립형, MCA, 하위 계정 등 유형과 관계없이 계정을 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
BusinessIdentityService
비즈니스 ID API를 지원하는 서비스
GetBusinessIdentity |
---|
계정의 비즈니스 ID를 검색합니다.
|
UpdateBusinessIdentity |
---|
계정의 비즈니스 식별 정보를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
BusinessInfoService
비즈니스 정보 API를 지원하는 서비스입니다.
GetBusinessInfo |
---|
계정의 비즈니스 정보를 검색합니다.
|
UpdateBusinessInfo |
---|
계정의 비즈니스 정보를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
EmailPreferencesService
EmailPreferences
API를 지원하는 서비스
이 서비스는 인증된 사용자의 이메일 환경설정 검색 및 업데이트만 허용합니다.
GetEmailPreferences |
---|
판매자 센터 계정 사용자의 이메일 환경설정을 반환합니다. name=accounts/*/users/me/emailPreferences 별칭을 사용하여 인증된 사용자의 환경설정을 가져옵니다.
|
UpdateEmailPreferences |
---|
판매자 센터 계정 사용자의 이메일 환경설정을 업데이트합니다. MCA 사용자는 MCA의 하위 계정이 아닌 MCA 계정을 지정해야 합니다. 업데이트 마스크에서 명시적으로 선택되지 않은 환경설정은 업데이트되지 않습니다. 업데이트에 UNCONFIRMED 선택 상태 값을 지정하는 것은 유효하지 않습니다. name=accounts/*/users/me/emailPreferences 별칭을 사용하여 인증된 사용자의 환경설정을 업데이트합니다.
|
HomepageService
매장 홈페이지에 대한 API를 지원하는 서비스입니다.
ClaimHomepage |
---|
상점 홈페이지의 소유권을 주장합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다. 홈페이지의 소유권을 이미 주장한 경우 인증을 다시 확인하고 (판매자가 소유권 주장에서 제외되어 인증에서도 제외되는 경우는 제외) 성공적인 응답을 반환합니다. 소유권을 더 이상 확인할 수 없는 경우 오류가 반환되지만 소유권 주장이 삭제되지는 않습니다. 실패하면 다음과 같은 표준 오류 메시지가 반환됩니다. * PERMISSION_DENIED: 사용자에게 이 MC 계정에 대한 필요한 권한이 없습니다. * FAILED_PRECONDITION: - 계정이 판매자 센터 계정이 아닙니다. - MC 계정에 홈페이지가 없음 - 클레임에 실패했습니다 (이 경우 오류 메시지에 자세한 내용이 포함됩니다).
|
GetHomepage |
---|
매장의 홈페이지를 검색합니다.
|
UnclaimHomepage |
---|
매장 홈페이지의 소유권 주장을 취소합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
UpdateHomepage |
---|
매장의 홈페이지를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
OnlineReturnPolicyService
이 서비스는 광고와 무료 등록정보 모두에 적용되는 반품 정책을 포괄하는 판매자의 변심에 의한 반품 정책 구성을 쉽게 관리할 수 있도록 지원합니다.
있습니다. 이 API는 다음 리소스 모델을 정의합니다.
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
기존 반품 정책을 가져옵니다.
|
ListOnlineReturnPolicies |
---|
모든 기존 반품 정책을 나열합니다.
|
ProgramsService
프로그램 관리를 위한 서비스
프로그램은 판매자 계정에 기능을 추가하는 메커니즘을 제공합니다. 대표적인 예로 판매자 매장의 제품을 Google 서비스 전반에 무료로 표시할 수 있는 무료 제품 등록정보 프로그램이 있습니다.
이 서비스는 각 프로그램에 대한 참여를 명시적으로 활성화하거나 비활성화하는 메서드 외에 사용 가능한 모든 프로그램에 대한 판매자의 참여를 가져오는 메서드를 노출합니다.
DisableProgram |
---|
계정에 대해 지정된 프로그램에 대한 참여를 중지합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
EnableProgram |
---|
계정에 대해 지정된 프로그램에 참여할 수 있도록 설정합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
GetProgram |
---|
계정에 지정된 프로그램을 검색합니다.
|
ListPrograms |
---|
계정의 모든 프로그램을 검색합니다.
|
RegionsService
리전 구성을 관리합니다.
이 API는 다음 리소스 모델을 정의합니다.
Region
CreateRegion |
---|
판매자 센터 계정에 지역 정의를 만듭니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
DeleteRegion |
---|
판매자 센터 계정에서 지역 정의를 삭제합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
GetRegion |
---|
판매자 센터 계정에 정의된 지역을 검색합니다.
|
ListRegions |
---|
판매자 센터 계정의 지역을 나열합니다.
|
UpdateRegion |
---|
판매자 센터 계정에서 지역 정의를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
ShippingSettingsService
판매자 API 메서드별로 메서드 호출 배송 설정 정보를 가져오는 서비스입니다.
GetShippingSettings |
---|
배송 설정 정보를 가져옵니다.
|
InsertShippingSettings |
---|
판매자의 배송 설정을 배송 요청 설정으로 바꿉니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
TermsOfServiceAgreementStateService
TermsOfServiceAgreementState
API를 지원하는 서비스
GetTermsOfServiceAgreementState |
---|
서비스 약관의 상태를 반환합니다.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
애플리케이션 서비스 약관의 계약 상태를 검색합니다.
|
TermsOfServiceService
TermsOfService
API를 지원하는 서비스
AcceptTermsOfService |
---|
|
GetTermsOfService |
---|
제공된 버전과 연결된
|
RetrieveLatestTermsOfService |
---|
지정된
|
UserService
사용자 API를 지원하는 서비스입니다.
CreateUser |
---|
판매자 센터 계정 사용자를 만듭니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
DeleteUser |
---|
판매자 센터 계정 사용자를 삭제합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
GetUser |
---|
판매자 센터 계정 사용자를 검색합니다.
|
ListUsers |
---|
판매자 센터 계정의 모든 사용자를 나열합니다.
|
UpdateUser |
---|
판매자 센터 계정 사용자를 업데이트합니다. 이 방법을 실행하려면 관리 액세스 권한이 필요합니다.
|
AcceptTermsOfServiceRequest
AcceptTermsOfService
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. 형식: |
account |
필수 항목입니다. 서비스 약관을 수락할 계정입니다. |
region_code |
필수 항목입니다. CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 전 세계에 적용되는 경우 001입니다. |
수락됨
동의한 서비스 약관을 설명합니다.
필드 | |
---|---|
terms_of_service |
동의한 termsOfService입니다. |
accepted_by |
수락이 기록된 계정입니다. 계정 자체일 수도 있고, 하위 계정의 경우 MCA 계정일 수도 있습니다. |
valid_until |
설정된 경우 수락된 TermsOfService가 이 날짜가 끝날 때까지만 유효함을 명시합니다 (UTC 기준). 그 전에 새 계정을 수락해야 합니다. 필수 TermsOfService에 대한 정보는 필수 메시지에 있습니다. |
AccessRight
액세스 권한
열거형 | |
---|---|
ACCESS_RIGHT_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
STANDARD |
일반 액세스 권한 |
ADMIN |
관리자 액세스 권한 |
PERFORMANCE_REPORTING |
이 권한을 가진 사용자는 실적 및 통계에 액세스할 수 있습니다. |
계정
계정
필드 | |
---|---|
name |
식별자. 계정의 리소스 이름입니다. 형식: |
account_id |
출력 전용입니다. 계정의 ID입니다. |
account_name |
필수 항목입니다. 사람이 읽을 수 있는 계정 이름입니다. 자세한 내용은 매장 이름과 업체 이름을 참고하세요. |
adult_content |
이 계정에 성인용 콘텐츠가 포함되어 있는지 여부입니다. |
test_account |
출력 전용입니다. 테스트 계정인지 여부입니다. |
time_zone |
필수 항목입니다. 계정의 시간대입니다. 쓰기 시 읽기의 경우 |
language_code |
필수 항목입니다. 계정의 BCP-47 언어 코드(예: |
AccountIssue
필드 | |
---|---|
name |
식별자. 계정 문제의 리소스 이름입니다. 형식: |
title |
문제의 현지화된 제목입니다. |
severity |
문제의 전반적인 심각도입니다. |
impacted_destinations[] |
이 문제가 여러 대상에 미치는 영향 |
detail |
문제에 관해 현지화된 세부정보 |
documentation_uri |
문제에 대한 추가 정보와 해결 방법을 제공하는 판매자 센터 고객센터 링크 |
ImpactedDestination
문제가 대상에 미치는 영향입니다.
필드 | |
---|---|
impacts[] |
지정된 대상의 여러 리전에 미치는 (부정적인) 영향입니다. |
reporting_context |
영향을 받는 보고 컨텍스트입니다. |
영향
문제가 지역에 미치는 영향
필드 | |
---|---|
region_code |
이 문제가 적용되는 CLDR 지역 코드입니다. |
severity |
대상 지역 및 지역에서 발생한 문제의 심각도입니다. |
심각도
가능한 모든 문제의 심각도
열거형 | |
---|---|
SEVERITY_UNSPECIFIED |
심각도를 알 수 없습니다. |
CRITICAL |
이 문제로 인해 제품이 게재되지 않습니다. |
ERROR |
이 문제는 향후 혜택에 영향을 주거나 혜택 관련 문제를 나타낼 수 있습니다. |
SUGGESTION |
이 문제는 개선을 위한 제안입니다. |
주소
창고의 배송지 주소입니다.
필드 | |
---|---|
street_address |
주소의 도로 수준 부분입니다. 예: |
city |
필수 항목입니다. 시/군/구 또는 코뮌 종속 지역 또는 하위 지역 (예: 인근 지역 또는 교외)도 포함될 수 있습니다. |
administrative_area |
필수 항목입니다. 국가의 최상위 행정 구역 단위입니다. 예를 들어 캘리포니아와 같은 주('CA') 또는 퀘벡('QC') 같은 주입니다. |
postal_code |
필수 항목입니다. 우편번호 (예: '94043') |
region_code |
필수 항목입니다. CLDR 국가 코드 (예: 'US') |
BusinessDayConfig
창고의 영업일입니다.
필드 | |
---|---|
business_days[] |
필수 항목입니다. 정규 영업일 비워 둘 수 없습니다. |
평일
열거형 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
BusinessIdentity
비즈니스의 정체성과 관련된 정보 모음입니다.
필드 | |
---|---|
name |
식별자. 비즈니스 ID의 리소스 이름입니다. 형식: |
promotions_consent |
선택사항입니다. ID 속성을 프로모션에 사용할 수 있는지 여부입니다. |
black_owned |
선택사항입니다. 흑인이 소유하거나 운영하는 비즈니스인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 |
women_owned |
선택사항입니다. 비즈니스가 여성이 소유하거나 운영하는 비즈니스인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 |
veteran_owned |
선택사항입니다. 퇴역 군인이 소유하거나 운영하는 비즈니스인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 |
latino_owned |
선택사항입니다. 비즈니스가 라틴계 소유주임을 명시하는지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 |
small_business |
선택사항입니다. 비즈니스가 중소기업인지 여부를 지정합니다. 이 선택사항 입력란은 업체 국가가 |
IdentityAttribute
ID 속성과 관련된 모든 정보입니다.
필드 | |
---|---|
identity_declaration |
필수 항목입니다. 이 속성의 아이덴티티 선언입니다. |
IdentityDeclaration
신원 선언과 관련하여 가능한 모든 설정입니다.
열거형 | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
선택하지 않았음을 나타내는 기본값입니다. |
SELF_IDENTIFIES_AS |
계정이 속성으로 식별됨을 나타냅니다. |
DOES_NOT_SELF_IDENTIFY_AS |
계정이 속성으로 식별되지 않음을 나타냅니다. |
PromotionsConsent
비즈니스 아이덴티티와 관련된 프로모션과 관련하여 가능한 모든 설정입니다.
열거형 | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
선택하지 않았음을 나타내는 기본값입니다. |
PROMOTIONS_CONSENT_GIVEN |
계정이 비즈니스 ID를 프로모션에 사용하는 데 동의했음을 나타냅니다. |
PROMOTIONS_CONSENT_DENIED |
계정이 비즈니스 ID를 프로모션에 사용하는 데 동의하지 않았음을 나타냅니다. |
BusinessInfo
비즈니스와 관련된 정보의 모음입니다.
필드 | |
---|---|
name |
식별자. 비즈니스 정보의 리소스 이름입니다. 형식: |
address |
선택사항입니다. 비즈니스의 주소입니다. |
phone |
출력 전용입니다. 비즈니스의 전화번호입니다. |
phone_verification_state |
출력 전용입니다. 비즈니스의 전화 인증 상태입니다. |
customer_service |
선택사항입니다. 비즈니스의 고객 서비스입니다. |
korean_business_registration_number |
선택사항입니다. XXX-XX-XXXXX 형식의 10자리 대한민국 사업자등록번호(대시로 구분) |
CarrierRate
main_table
또는 single_value
에서 참조할 수 있는 운송업체 요금 목록입니다.
필드 | |
---|---|
name |
필수 항목입니다. 운송업체 배송비의 이름입니다. 요금 그룹마다 고유해야 합니다. |
carrier |
필수 항목입니다. 운송업체 서비스(예: |
carrier_service |
필수 항목입니다. 운송업체 서비스(예: |
origin_postal_code |
필수 항목입니다. 이 운송업체 요금의 배송 출발지입니다. |
percentage_adjustment |
선택사항입니다. 십진수 표기법으로 나타낸 곱셈식 배송비 수정자입니다. 음수일 수 있습니다. 예를 들어 |
flat_adjustment |
선택사항입니다. 배송비 요율 조정을 추가합니다. 음수일 수 있습니다. 예를 들어 |
ClaimHomepageRequest
ClaimHomepage
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 소유권을 주장할 홈페이지의 이름입니다. 형식: |
CreateAndConfigureAccountRequest
CreateAndConfigureAccount
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
account |
필수 항목입니다. 생성할 계정입니다. |
users[] |
선택사항입니다. 계정에 추가될 사용자입니다. |
service[] |
필수 항목입니다. 생성할 계정과 제공업체 계정 간의 계정 서비스는 생성 과정에서 초기화됩니다. 이러한 서비스를 하나 이상 제공해야 합니다. 현재 |
accept_terms_of_service |
선택사항입니다. 계정이 생성되는 즉시 서비스 약관 (ToS)에 동의해야 합니다. |
AcceptTermsOfService
서비스 약관 리소스에 대한 참조입니다.
필드 | |
---|---|
name |
필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. |
region_code |
필수 항목입니다. CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 구체적으로 적용되는 국가이거나 전 세계에 적용되는 경우 |
AddAccountService
계정 생성 중에 계정 서비스를 추가하는 방법에 대한 추가 안내입니다.
필드 | |
---|---|
통합 필드 service_type . 현재 멀티 클라이언트 상위 계정 유형만 지원됩니다. service_type 은 다음 중 하나일 수 있습니다. |
|
account_aggregation |
제공업체는 계정의 애그리게이터입니다. |
provider |
선택사항입니다. 서비스 제공업체입니다. 형식: |
CreateRegionRequest
CreateRegion
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 리전을 만들 계정입니다. 형식: |
region_id |
필수 항목입니다. 지역 식별자로, 동일한 계정의 모든 지역에서 고유합니다. |
region |
필수 항목입니다. 생성할 리전입니다. |
CreateUserRequest
CreateUser
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 사용자가 생성될 계정의 리소스 이름입니다. 형식: |
user_id |
필수 항목입니다. 사용자의 이메일 주소입니다 (예: |
user |
필수 항목입니다. 생성할 사용자입니다. |
CustomerService
고객 서비스 정보
필드 | |
---|---|
uri |
선택사항입니다. 고객 서비스를 찾을 수 있는 URI입니다. |
email |
선택사항입니다. 고객 서비스를 받을 수 있는 이메일 주소입니다. |
phone |
선택사항입니다. 고객 서비스에 연락할 수 있는 전화번호입니다. |
CutoffTime
영업일 마감 시간의 정의입니다.
필드 | |
---|---|
hour |
필수 항목입니다. 당일 주문 처리를 위한 마감 시간(마감 시간)입니다. |
minute |
필수 항목입니다. 당일 처리를 위해 주문이 완료되어야 하는 마감 시간(분)입니다. |
time_zone |
필수 항목입니다. 시간대 식별자(예: '유럽/취리히') |
DeleteAccountRequest
DeleteAccount
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 삭제할 계정의 이름입니다. 형식: |
DeleteRegionRequest
DeleteRegion
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 삭제할 리전의 이름입니다. 형식: |
DeleteUserRequest
DeleteUser
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 삭제할 사용자의 이름입니다. 형식:
|
DeliveryTime
주문부터 제품 배송까지 다양한 측면에서 소요된 시간입니다.
필드 | |
---|---|
warehouse_based_delivery_times[] |
선택사항입니다. 선택한 운송업체의 설정에 따라 창고 (배송지 위치)별로 배송 시간을 계산해야 함을 나타냅니다. 설정되면 [배송 시간][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 에 다른 운송 시간 관련 필드를 설정하면 안 됩니다. |
min_transit_days |
운송에 소비되는 최소 영업일 수입니다. 0은 당일 배송을 의미하고 1은 익일 배송을 의미합니다. |
max_transit_days |
운송에 소비되는 최대 영업일 수입니다. 0은 당일 배송을 의미하고 1은 익일 배송을 의미합니다. |
cutoff_time |
영업일 마감 시간의 정의입니다. 설정되지 않은 경우 마감 시간은 기본적으로 오전 8시(PST)로 설정됩니다. |
min_handling_days |
주문 상품이 발송되기 전에 소요된 최소 영업일 수입니다. 0은 당일 발송을 의미하고 1은 다음 날 발송을 의미합니다. |
max_handling_days |
주문 상품이 발송되기 전에 소요된 영업일 기준 최대 일수입니다. 0은 당일 발송을 의미하고 1은 다음 날 발송을 의미합니다. |
transit_time_table |
행 및 열 측정기준을 기준으로 한 운송 시간 표, 운송에 소요된 영업일 기준의 일수입니다. |
handling_business_day_config |
주문을 처리할 수 있는 영업일입니다. 입력하지 않을 경우 월요일~금요일 영업일로 간주됩니다. |
transit_business_day_config |
주문 상품을 배송할 수 있는 영업일입니다. 입력하지 않을 경우 월요일~금요일 영업일로 간주됩니다. |
DisableProgramRequest
DisableProgram 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 특정 계정에서 참여를 중지할 프로그램의 이름입니다. 형식: |
거리
최대 배송 반경입니다. 이는 지역 배송 배송 유형에만 필요합니다.
필드 | |
---|---|
value |
거리의 정수 값입니다. |
unit |
단위는 국가에 따라 다를 수 있으며 마일과 킬로미터를 포함하도록 매개변수화됩니다. |
단위
단위는 국가에 따라 다를 수 있으며 마일과 킬로미터를 포함하도록 매개변수화됩니다.
열거형 | |
---|---|
UNIT_UNSPECIFIED |
단위 미지정 |
MILES |
단위(마일) |
KILOMETERS |
단위(킬로미터) |
EmailPreferences
사용자가 수신 동의 또는 수신 거부한 알림의 카테고리입니다. 사용자가 수신을 거부할 수 없으므로 이메일 환경설정에는 필수 공지가 포함되지 않습니다.
필드 | |
---|---|
name |
식별자. EmailPreferences의 이름입니다. 엔드포인트는 인증된 사용자에 대해서만 지원됩니다. |
news_and_tips |
선택사항입니다. 새로운 기능, 도움말 및 권장사항에 관한 업데이트입니다. |
OptInState
이메일 환경설정의 수신 동의 상태입니다.
열거형 | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
선택 상태가 지정되지 않았습니다. |
OPTED_OUT |
사용자가 이 유형의 이메일을 수신하지 않도록 선택했습니다. |
OPTED_IN |
사용자가 이러한 유형의 이메일을 수신하도록 선택했습니다. |
UNCONFIRMED |
사용자가 이러한 유형의 이메일을 수신하도록 설정했으며 확인 이메일이 전송되었으나 사용자가 아직 수신 동의를 확인하지 않았습니다 (일부 국가에만 해당). |
EnableProgramRequest
EnableProgram 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 특정 계정에 참여할 수 있도록 설정할 프로그램의 이름입니다. 형식: |
GetAccountRequest
GetAccount
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 계정의 이름입니다. 형식: |
GetBusinessIdentityRequest
GetBusinessIdentity
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 비즈니스 ID의 리소스 이름입니다. 형식: |
GetBusinessInfoRequest
GetBusinessInfo
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 비즈니스 정보의 리소스 이름입니다. 형식: |
GetEmailPreferencesRequest
GetEmailPreferences 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. |
GetHomepageRequest
GetHomepage
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 홈페이지의 이름입니다. 형식: |
GetOnlineReturnPolicyRequest
GetOnlineReturnPolicy
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 반품 정책의 이름입니다. 형식: |
GetProgramRequest
GetProgram 메서드의 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 프로그램의 이름입니다. 형식: |
GetRegionRequest
GetRegion
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 리전의 이름입니다. 형식: |
GetShippingSettingsRequest
GetShippingSetting
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 배송 설정의 이름입니다. 형식: |
GetTermsOfServiceAgreementStateRequest
GetTermsOfServiceAgreementState
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. 형식: |
GetTermsOfServiceRequest
GetTermsOfService
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 서비스 약관 버전의 리소스 이름입니다. 형식: |
GetUserRequest
GetUser
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 검색할 사용자의 이름입니다. 형식:
|
헤더
테이블의 행 또는 열 헤더로 구성된 비어 있지 않은 목록입니다. prices
, weights
, num_items
, postal_code_group_names
또는 location
중 정확히 하나를 설정해야 합니다.
필드 | |
---|---|
prices[] |
필수 항목입니다. 포괄적인 주문 가격 상한의 목록입니다. price amount_micros = -1로 설정하여 마지막 가격의 값을 무한대로 설정할 수 있습니다. 예를 들어 |
weights[] |
필수 항목입니다. 포함 주문 가중치 상한의 목록입니다. price amount_micros = -1로 설정하여 마지막 가중치의 값을 무한대로 설정할 수 있습니다. 예를 들어 |
number_of_items[] |
필수 항목입니다. 포괄적인 수의 항목 상한값 목록입니다. 마지막 값은 |
postal_code_group_names[] |
필수 항목입니다. 우편 그룹 이름의 목록입니다. 마지막 값은 |
locations[] |
필수 항목입니다. 위치 ID 집합의 목록입니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
홈페이지
매장의 홈페이지
필드 | |
---|---|
name |
식별자. 상점 홈페이지의 리소스 이름입니다. 형식: |
claimed |
출력 전용입니다. 홈페이지의 소유권 주장 여부입니다. https://support.google.com/merchants/answer/176793을 참고하세요. |
uri |
필수 항목입니다. 매장 홈페이지의 URI (일반적으로 URL)입니다. |
InsertShippingSettingsRequest
InsertShippingSetting
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 이 제품이 삽입될 계정입니다. 형식: accounts/{account} |
shipping_setting |
필수 항목입니다. 계정의 새 버전입니다. |
ListAccountIssuesRequest
ListAccountIssues
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 이 문제 모음을 소유한 상위 항목입니다. 형식: |
page_size |
선택사항입니다. 반환할 최대 문제 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50명의 사용자가 반환됩니다. 최댓값은 100입니다. 100을 초과하는 값은 100으로 강제 변환됩니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
language_code |
선택사항입니다. 응답의 문제에는 지정된 언어로 사람이 읽을 수 있는 필드가 있습니다. 형식은 BCP-47(예: |
time_zone |
선택사항입니다. 사람이 읽을 수 있는 필드의 시간을 현지화하는 데 사용되는 IANA 시간대입니다. 예: 'America/Los_Angeles' 설정하지 않으면 'America/Los_Angeles' 사용됩니다. |
ListAccountIssuesResponse
ListAccountIssues
메서드에 대한 응답 메시지입니다.
필드 | |
---|---|
account_issues[] |
지정된 계정의 문제 |
next_page_token |
다음 페이지를 검색하기 위해 |
ListAccountsRequest
ListAccounts
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
page_size |
선택사항입니다. 반환할 최대 계정 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 250개의 계정이 반환됩니다. 최댓값은 500입니다. 500 이상의 값은 500으로 강제 변환됩니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
filter |
|
ListAccountsResponse
ListAccounts
메서드에 대한 응답 메시지입니다.
필드 | |
---|---|
accounts[] |
|
next_page_token |
다음 페이지를 검색하기 위해 |
ListOnlineReturnPoliciesRequest
ListOnlineReturnPolicies
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 반품 정책을 나열할 판매자 계정입니다. 형식: |
page_size |
선택사항입니다. 반환할 |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
ListOnlineReturnPoliciesResponse
ListOnlineReturnPolicies
메서드에 대한 응답 메시지입니다.
필드 | |
---|---|
online_return_policies[] |
가져온 반품 정책입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
ListProgramsRequest
ListPrograms 메서드의 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 모든 프로그램을 검색할 계정의 이름입니다. 형식: |
page_size |
선택사항입니다. 단일 응답에서 반환할 프로그램의 최대 개수입니다. 지정하지 않으면 (또는 0) 기본 크기 1,000이 사용됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. |
page_token |
선택사항입니다. 이전 |
ListProgramsResponse
ListPrograms 메서드의 응답 메시지입니다.
필드 | |
---|---|
programs[] |
특정 계정의 프로그램입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
ListRegionsRequest
ListRegions
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 지역을 나열할 계정입니다. 형식: |
page_size |
선택사항입니다. 반환할 리전의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 리전이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
ListRegionsResponse
ListRegions
메서드에 대한 응답 메시지입니다.
필드 | |
---|---|
regions[] |
지정된 판매자의 지역입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
ListSubAccountsRequest
ListSubAccounts
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
provider |
필수 항목입니다. 상위 계정. 형식: |
page_size |
선택사항입니다. 반환할 최대 계정 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 250개의 계정이 반환됩니다. 최댓값은 500입니다. 500 이상의 값은 500으로 강제 변환됩니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
ListSubAccountsResponse
ListSubAccounts
메서드에 대한 응답 메시지입니다.
필드 | |
---|---|
accounts[] |
특정 상위 계정이 애그리게이터인 계정입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
ListUsersRequest
ListUsers
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. 이 사용자 컬렉션을 소유한 상위 요소입니다. 형식: |
page_size |
선택사항입니다. 반환할 최대 사용자 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50명의 사용자가 반환됩니다. 최댓값은 100입니다. 100을 초과하는 값은 100으로 강제 변환됩니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
ListUsersResponse
ListUsers
메서드에 대한 응답 메시지입니다.
필드 | |
---|---|
users[] |
지정된 계정의 사용자입니다. |
next_page_token |
다음 페이지를 검색하기 위해 |
LocationIdSet
위치 ID 집합의 목록입니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.
필드 | |
---|---|
location_ids[] |
필수 항목입니다. 비어 있지 않은 위치 ID 목록입니다. 모두 동일한 위치 유형 (예: 주)이어야 합니다. |
MinimumOrderValueTable
수령 처리 유형의 매장별 최소 주문 금액 표
필드 | |
---|---|
store_code_set_with_movs[] |
필수 항목입니다. 동일한 최소 주문값 (MOV)을 공유하는 판매점 코드 세트의 목록입니다. 두 개 이상의 세트가 필요하며 마지막 세트는 비어 있어야 합니다. 이는 '다른 모든 스토어의 MOV'를 의미합니다. 각 판매점 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다. |
StoreCodeSetWithMov
최소 주문 금액이 동일한 판매점 코드 세트의 목록입니다. 두 개 이상의 세트가 필요하며 마지막 세트는 비어 있어야 합니다. 이는 '다른 모든 스토어의 MOV'를 의미합니다. 각 판매점 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다.
필드 | |
---|---|
store_codes[] |
선택사항입니다. 고유한 상점 코드의 목록이거나 catch-all의 경우 비어 있습니다. |
value |
특정 매장의 최소 주문 금액입니다. |
OnlineReturnPolicy
온라인 반품 정책 객체입니다. 현재 광고 및 무료 등록정보 프로그램의 반품 정책을 나타내는 데 사용됩니다.
필드 | |
---|---|
name |
식별자. |
return_policy_id |
출력 전용입니다. Google에서 생성한 반품 정책 ID입니다. |
label |
이 필드는 반품 정책의 고유한 사용자 정의 라벨을 나타냅니다. 동일한 라벨을 같은 국가의 여러 반품 정책에 사용할 수 없다는 점에 유의해야 합니다. 제품에서 특정 라벨 속성을 지정하지 않는 한 정책에 자동으로 '기본' 라벨이 지정됩니다. 특정 제품 그룹에 맞춤 반품 정책을 할당하려면 반품 정책 라벨에 제공된 안내를 따르세요. 라벨은 최대 50자(영문 기준)까지 포함할 수 있습니다. |
countries[] |
반품 정책이 적용되는 판매 국가입니다. 값은 유효한 2문자 ISO 3166 코드여야 합니다. |
policy |
반품 정책 |
restocking_fee |
모든 반품 사유 카테고리에 적용되는 재입고 수수료입니다. 값이 설정되지 않은 경우 무료 재입고 수수료로 처리됩니다. |
return_methods[] |
고객이 상품을 반품할 수 있는 방법의 반품 방법입니다. 반품 정책 유형이 noReturns가 아닌 경우 이 값은 비워 둘 수 없습니다. |
item_conditions[] |
반품 정책 유형이 'noReturns'가 아닌 이상 반품에 허용되는 상품 조건을 비워 둘 수 없습니다. |
return_shipping_fee |
반품 배송비입니다. 고객이 반품 라벨을 다운로드하여 인쇄해야 하는 경우에만 설정해야 합니다. |
return_policy_uri |
반품 정책 URI입니다. Google에서 정책의 상태 검사를 수행하는 데 사용할 수 있습니다. 유효한 URL이어야 합니다. |
accept_defective_only |
이 필드는 판매자가 결함이 있는 제품만 반품을 허용하는지 지정합니다. 이 필드는 필수입니다. |
process_refund_days |
이 필드는 판매자가 환불을 처리하는 데 걸리는 기간(일)을 지정합니다. 필드는 선택사항입니다. |
accept_exchange |
이 필드는 판매자가 고객이 제품을 교환할 수 있도록 허용하는지 지정합니다. 이 필드는 필수입니다. |
ItemCondition
사용 가능한 항목 조건입니다.
열거형 | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
NEW |
새로 만들기를 클릭합니다. |
USED |
사용됨. |
정책
사용 가능한 정책입니다.
필드 | |
---|---|
type |
정책 유형입니다. |
days |
배송 후 상품을 반품할 수 있는 일수이며, 1일은 배송 타임스탬프로부터 24시간 후로 정의됩니다. |
유형
반품 정책 유형입니다.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
NUMBER_OF_DAYS_AFTER_DELIVERY |
배송 후 반품이 유효한 기간(일)입니다. |
NO_RETURNS |
반품 불가 |
LIFETIME_RETURNS |
평생 반품이 가능합니다. |
RestockingFee
재입고 수수료입니다. 정액 요금 또는 마이크로 퍼센트를 사용할 수 있습니다.
필드 | |
---|---|
통합 필드
|
|
fixed_fee |
고정 재입고 수수료입니다. |
micro_percent |
총 가격의 마이크로 비율(%)입니다. 15,000,000은 총가격의 15% 가 청구됨을 의미합니다. |
ReturnMethod
사용 가능한 반환 메서드입니다.
열거형 | |
---|---|
RETURN_METHOD_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
BY_MAIL |
우편으로 반품하세요. |
IN_STORE |
매장에 반품하세요. |
AT_A_KIOSK |
키오스크에서 반품하세요. |
ReturnShippingFee
반품 배송비입니다. 이는 정액 요금이거나 고객이 실제 배송비를 지불함을 나타내는 부울일 수 있습니다.
필드 | |
---|---|
type |
반품 배송비의 유형입니다. |
fixed_fee |
고정 반품 배송비 금액입니다. 이 값은 유형이 |
유형
반품 배송비 유형입니다.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
FIXED |
반품 배송비는 고정 금액입니다. |
CUSTOMER_PAYING_ACTUAL_FEE |
고객이 실제 반품 배송비를 지불합니다. |
PhoneVerificationState
전화 인증 상태입니다.
열거형 | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
PHONE_VERIFICATION_STATE_VERIFIED |
전화번호가 인증되었습니다. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
휴대전화가 인증되지 않았습니다. |
프로그램
지정된 계정의 특정 프로그램 참여를 정의합니다.
프로그램은 판매자 계정에 기능을 추가하는 메커니즘을 제공합니다. 대표적인 예로 판매자 매장의 제품을 Google 서비스 전반에 무료로 표시할 수 있는 무료 제품 등록정보 프로그램이 있습니다.
필드 | |
---|---|
name |
식별자. 프로그램의 리소스 이름입니다. 형식: |
documentation_uri |
출력 전용입니다. 프로그램을 설명하는 판매자 센터 도움말 페이지의 URL입니다. |
state |
출력 전용입니다. 프로그램에 대한 계정의 참여 상태입니다. |
active_region_codes[] |
출력 전용입니다. 계정이 프로그램에 활발하게 참여하고 있는 지역입니다. 활성 지역은 지역에 영향을 주는 모든 프로그램 요구사항이 충족된 지역으로 정의됩니다. 리전 코드는 CLDR에 의해 정의됩니다. 프로그램이 해당 국가에 특별히 적용되는 국가이거나 프로그램이 전 세계에 적용되는 경우 |
unmet_requirements[] |
출력 전용입니다. 계정이 아직 충족되지 않아 프로그램 참여에 영향을 주는 요건입니다. |
요구사항
프로그램 참여에 지정된 요구사항을 정의합니다.
필드 | |
---|---|
title |
출력 전용입니다. 요구사항의 이름입니다. |
documentation_uri |
출력 전용입니다. 요구사항을 설명하는 도움말 페이지의 URL입니다. |
affected_region_codes[] |
출력 전용입니다. 현재 이 요구사항의 영향을 받는 지역이 충족되지 않고 있습니다. 리전 코드는 CLDR에 의해 정의됩니다. 프로그램이 해당 국가에 특별히 적용되는 국가이거나 프로그램이 전 세계에 적용되는 경우 |
주
계정의 가능한 프로그램 참여 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
NOT_ELIGIBLE |
프로그램에 참여할 수 없는 계정입니다. |
ELIGIBLE |
프로그램에 참여할 수 있는 계정입니다. |
ENABLED |
계정에 프로그램이 사용 설정되어 있어야 합니다. |
RateGroup
배송비 요율 그룹 정의입니다. 마지막 행에만 '기타'를 의미하는 빈 applicable_shipping_labels
가 있을 수 있습니다. 다른 applicable_shipping_labels
는 겹치지 않아야 합니다.
필드 | |
---|---|
applicable_shipping_labels[] |
필수 항목입니다. 이 배송비 그룹이 적용되는 제품을 정의하는 배송물 라벨 목록입니다. 이는 분리입니다. 라벨 중 하나만 일치하면 요금 그룹이 적용됩니다. 서비스의 마지막 요금 그룹만 비워 둘 수 있습니다. |
subtables[] |
선택사항입니다. |
carrier_rates[] |
선택사항입니다. |
single_value |
요금 그룹의 값입니다 (예: 고정 요금 $10). |
main_table |
요금 그룹을 정의하는 표( |
name |
선택사항입니다. 요금 그룹의 이름입니다. 설정된 경우 배송 서비스 내에서 고유해야 합니다. |
지역
RegionalInventory
및 ShippingSettings
서비스 모두에서 타겟으로 사용할 수 있는 지역을 나타냅니다. 지역을 우편번호 모음으로 정의하거나 일부 국가의 경우 사전 정의된 지역 타겟을 사용하여 정의할 수 있습니다. 자세한 내용은 지역 설정 을 참조하세요.
필드 | |
---|---|
name |
식별자. 리전의 리소스 이름입니다. 형식: |
postal_code_area |
선택사항입니다. 지역 영역을 정의하는 우편번호 목록입니다. |
geotarget_area |
선택사항입니다. 지역 영역을 정의하는 지역 타겟팅 목록입니다. |
regional_inventory_eligible |
출력 전용입니다. 지역을 지역 인벤토리 구성에서 사용할 수 있는지 여부를 나타냅니다. |
shipping_eligible |
출력 전용입니다. 배송 서비스 구성에 지역을 사용할 수 있는지 여부를 나타냅니다. |
display_name |
선택사항입니다. 지역의 표시 이름입니다. |
GeoTargetArea
지역 영역을 정의하는 지역 타겟팅 목록입니다.
필드 | |
---|---|
geotarget_criteria_ids[] |
필수 항목입니다. 비어 있지 않은 위치 ID 목록입니다. 모두 동일한 위치 유형 (예: 주)이어야 합니다. |
PostalCodeArea
지역 영역을 정의하는 우편번호 목록입니다. 참고: 우편번호를 사용하여 정의된 모든 지역은 계정의 ShippingSettings.postalCodeGroups
리소스를 통해 액세스할 수 있습니다.
필드 | |
---|---|
region_code |
필수 항목입니다. CLDR 지역 코드 또는 우편번호 그룹이 적용되는 국가입니다. |
postal_codes[] |
필수 항목입니다. 우편번호 범위입니다. |
PostalCodeRange
지역 영역을 정의하는 우편번호 범위
필드 | |
---|---|
begin |
필수 항목입니다. 영역을 정의하는 범위의 포괄적인 하한을 나타내는 양식 접두사* 의 우편번호 또는 패턴입니다. 예시 값: |
end |
선택사항입니다. 영역을 정의하는 범위의 포괄적인 상한선을 나타내는 |
필수
동의해야 하는 서비스 약관을 설명합니다.
필드 | |
---|---|
terms_of_service |
수락해야 하는 termsOfService입니다. |
tos_file_uri |
서비스 약관 파일의 전체 URL입니다. 이 필드는 TermsOfService.file_uri와 동일하며 편의를 위해 여기에 추가되었습니다. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
RetrieveForApplicationTermsOfServiceAgreementState
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
parent |
필수 항목입니다. termsOfServiceAgreementState 형식을 가져올 계정: |
RetrieveLatestTermsOfServiceRequest
RetrieveLatestTermsOfService
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
region_code |
CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 전 세계에 적용되는 경우 001입니다. |
kind |
이 서비스 약관 버전이 적용되는 종류입니다. |
행
셀 목록을 포함합니다.
필드 | |
---|---|
cells[] |
필수 항목입니다. 행을 구성하는 셀 목록입니다. 2차원 표의 경우 길이는 |
서비스
배송 서비스
필드 | |
---|---|
delivery_countries[] |
필수 항목입니다. 서비스가 적용되는 국가의 CLDR 지역 코드입니다. |
rate_groups[] |
선택사항입니다. 배송비 요율 그룹 정의입니다. 마지막 행에만 '기타'를 의미하는 빈 |
loyalty_programs[] |
선택사항입니다. 이 배송 서비스로 제한된 포인트 제도입니다. |
service_name |
필수 항목입니다. 자유 형식의 서비스 이름입니다. 대상 계정 내에서 고유해야 합니다. |
active |
필수 항목입니다. 배송 서비스의 활성 상태를 노출하는 불리언입니다. |
currency_code |
이 서비스가 적용되는 통화의 CLDR 코드입니다. 요금 그룹의 요금과 일치해야 합니다. |
delivery_time |
필수 항목입니다. 주문부터 제품 배송까지 다양한 측면에서 소요된 시간입니다. |
shipment_type |
이 서비스가 주문 상품을 배송하는 위치의 유형입니다. |
minimum_order_value |
이 서비스의 최소 주문 금액입니다. 설정된 경우 고객이 이 금액 이상을 지출해야 함을 나타냅니다. 한 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다. minimum_order_value_table과 함께 설정할 수 없습니다. |
minimum_order_value_table |
수령 처리 유형의 매장별 최소 주문 금액 표 minimum_order_value와 함께 설정할 수 없습니다. |
store_config |
제품을 배송하는 매장 목록입니다. 지역 배송 배송 유형에만 적용됩니다. |
LoyaltyProgram
판매자가 제공하는 포인트 제도
필드 | |
---|---|
loyalty_program_tiers[] |
선택사항입니다. 이 배송 서비스의 포인트 제도 등급입니다. |
program_label |
판매자 센터의 포인트 제도 설정에 설정된 포인트 제도 라벨입니다. 이 하위 속성을 사용하면 Google에서 요건을 충족하는 제품에 포인트 제도를 매핑할 수 있습니다. |
LoyaltyProgramTiers
판매자 포인트 제도의 하위 집합입니다.
필드 | |
---|---|
tier_label |
등급 라벨[tier_label] 하위 속성은 제품 수준 혜택을 각 등급별로 구분합니다. 이 값도 판매자 센터의 포인트 제도 설정에서 설정되며 포인트 제도에 등급이 1개만 있는 경우에도 데이터 소스를 변경하는 데 필요합니다. |
ShipmentType
배송 서비스의 배송 유형입니다.
열거형 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
이 서비스에 배송 유형이 지정되지 않았습니다. |
DELIVERY |
이 서비스는 고객이 선택한 주소로 주문 상품을 배송합니다. |
LOCAL_DELIVERY |
이 서비스는 고객이 선택한 주소로 주문 상품을 배송합니다. 주문 상품이 근처에 있는 오프라인 매장에서 배송됩니다. |
COLLECTION_POINT |
이 서비스는 고객이 선택한 주소로 주문 상품을 배송합니다. 주문 상품이 화물 취급소에서 발송됩니다. |
StoreConfig
제품을 배송하는 매장 목록입니다. 지역 배송 배송 유형에만 적용됩니다.
필드 | |
---|---|
store_codes[] |
선택사항입니다. 지역 배송을 제공하는 판매점 코드 목록입니다. 비어 있으면 |
store_service_type |
이 판매자가 등록하는 모든 매장 또는 일부 매장에서 지역 배송을 제공하는지 여부를 나타냅니다. |
cutoff_config |
지역 배송과 관련된 구성이 당일 종료됩니다. |
service_radius |
최대 배송 반경입니다. 이는 지역 배송 배송 유형에만 필요합니다. |
CutoffConfig
지역 배송과 관련된 구성이 당일 종료됩니다.
필드 | |
---|---|
local_cutoff_time |
현지 배송이 종료되는 시간입니다. |
store_close_offset_hours |
지역 배송 처리에서만 유효합니다. 매장 폐점 전 몇 시간으로 마감 시간을 표시합니다. |
no_delivery_post_cutoff |
n일 지역 배송으로 구성된 배송 서비스를 이용하는 경우 판매자는 n+1일 지역 배송 표시를 선택 해제할 수 있습니다. 예를 들어 배송 서비스에서 당일 배송을 정의하고 마감 시간이 지난 경우 이 필드를 |
LocalCutoffTime
현지 배송이 종료되는 시간입니다.
필드 | |
---|---|
hour |
당일 배송을 처리하려면 시간별 지역 배송 주문을 완료해야 합니다. |
minute |
당일 배송 주문을 처리하려면 분 단위로 주문해야 합니다. |
StoreServiceType
판매자가 등록하는 모든 매장 또는 일부 매장에서 지역 배송을 제공하는지 여부를 나타냅니다.
열거형 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
매장 서비스 유형을 지정하지 않았습니다. |
ALL_STORES |
이 판매자가 등록하는 현재 및 미래의 모든 매장에서 지역 배송을 제공하는지 여부를 나타냅니다. |
SELECTED_STORES |
store_codes 에 등록된 매장만 지역 배송이 가능함을 나타냅니다. |
ShippingSettings
판매자 계정의 [배송 설정](https://support.google.com/merchants/answer/6069284)
필드 | |
---|---|
name |
식별자. 배송 설정의 리소스 이름입니다. 형식: |
services[] |
선택사항입니다. 대상 계정의 서비스 목록입니다. |
warehouses[] |
선택사항입니다. |
etag |
필수 항목입니다. 이 필드는 비동기 문제를 방지하는 데 사용됩니다. 통화 수신과 통화 삽입 사이에 배송 설정 데이터가 변경되지 않았는지 확인합니다. 사용자는 다음 단계를 수행해야 합니다.
|
표
요금 그룹을 정의하는 표(single_value
가 충분히 표현되지 않는 경우)
필드 | |
---|---|
rows[] |
필수 항목입니다. 테이블을 구성하는 행 목록입니다. 길이는 |
name |
테이블의 이름입니다. 하위 테이블에는 필수이며 기본 테이블에서는 무시됩니다. |
row_headers |
필수 항목입니다. 테이블 행의 헤더입니다. |
column_headers |
테이블 열의 헤더입니다. 선택사항: 설정하지 않으면 테이블에 하나의 측정기준만 포함됩니다. |
TermsOfService
TermsOfService
-
필드 | |
---|---|
name |
식별자. 서비스 약관 버전의 리소스 이름입니다. 형식: |
region_code |
CLDR에 의해 정의된 리전 코드입니다. 서비스 약관이 해당 국가에 특별히 적용되는 국가이거나 어느 국가에서든 동일한 |
kind |
이 서비스 약관 버전이 적용되는 종류입니다. |
external |
이 서비스 약관 버전이 외부 버전인지 여부입니다. 외부 서비스 약관 버전은 외부 프로세스를 통해서만 동의할 수 있으며 UI 또는 API를 통해 판매자가 직접 동의할 수 없습니다. |
file_uri |
서명 사용자에게 표시해야 하는 서비스 약관 파일의 URI입니다. |
TermsOfServiceAgreementState
이 리소스는 지정된 계정 및 서비스 약관 종류의 계약 상태를 나타냅니다. 상태는 다음과 같습니다.
- 판매자가 서비스 약관에 동의한 경우 수락됨이 표시되고 그렇지 않으면 비어 있습니다.
- 판매자가 서비스 약관에 서명해야 하는 경우 required라고 입력되어 있고 그렇지 않으면 비어 있습니다.
필수 및 허용이 모두 있을 수 있습니다. 이 경우 accepted
서비스 약관의 valid_until 필드에 만료일이 설정됩니다. 계정에서 유효한 계약을 계속 유지하려면 valid_until
전에 required
서비스 약관에 동의해야 합니다. 새로운 서비스 약관에 동의할 때 서드 파티는 해당 서비스 약관과 관련된 텍스트를 표시해야 합니다 (텍스트가 포함된 파일의 URL이 아래의 필수 메시지에 tos_file_uri로 추가됨). 서비스 약관에 실제로 동의하려면 TermsOfService 리소스에 대해 accept를 호출해야 합니다.
필드 | |
---|---|
name |
식별자. 서비스 약관 버전의 리소스 이름입니다. 형식: |
region_code |
https://cldr.unicode.org/에 정의된 리전 코드입니다. 현재 주가 적용되는 국가입니다. |
terms_of_service_kind |
특정 버전과 연결된 서비스 약관 종류입니다. |
accepted |
이 유형 및 연결된 region_code에 대해 승인된 서비스 약관 |
required |
필수 서비스 약관 |
TermsOfServiceKind
약관 종류입니다.
열거형 | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
MERCHANT_CENTER |
판매자 센터 애플리케이션 |
TransitTable
행 및 열 측정기준을 기준으로 한 운송 시간 표, 운송에 소요된 영업일 기준의 일수입니다. min_transit_days
, max_transit_days
또는 transit_time_table
중 하나를 설정할 수 있지만 둘 다 설정할 수는 없습니다.
필드 | |
---|---|
postal_code_group_names[] |
필수 항목입니다. 리전 이름 목록 |
transit_time_labels[] |
필수 항목입니다. 운송 시간 라벨의 목록입니다. 마지막 값은 |
rows[] |
필수 항목입니다. |
TransitTimeRow
postal_code_group_names
또는 transit_time_labels
의 측정기준 모음이 하나만 있는 경우, 해당 측정기준의 값이 각각 하나씩 포함된 행이 여러 개 있습니다. 측정기준이 두 개인 경우 각 행은 postal_code_group_names
에, 열 (값)은 transit_time_labels
에 해당합니다.
필드 | |
---|---|
values[] |
필수 항목입니다. 영업일 기준 운송 기간 (최소~최대)입니다. |
TransitTimeValue
영업일 기준 운송 기간 (최소~최대)입니다.
필드 | |
---|---|
min_transit_days |
영업일 기준 최소 운송 기간입니다. 0은 당일 배송을 의미하고 1은 익일 배송을 의미합니다. |
max_transit_days |
|
UnclaimHomepageRequest
UnclaimHomepage
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
name |
필수 항목입니다. 소유권을 주장하지 않을 홈페이지의 이름입니다. 형식: |
UpdateAccountRequest
UpdateAccount
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
account |
필수 항목입니다. 계정의 새 버전입니다. |
update_mask |
필수 항목입니다. 업데이트 중인 필드 목록입니다. |
UpdateBusinessIdentityRequest
UpdateBusinessIdentity
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
business_identity |
필수 항목입니다. 새로운 버전의 비즈니스 아이덴티티입니다. |
update_mask |
필수 항목입니다. 업데이트 중인 필드 목록입니다. |
UpdateBusinessInfoRequest
UpdateBusinessInfo
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
business_info |
필수 항목입니다. 새로운 버전의 비즈니스 정보입니다. |
update_mask |
필수 항목입니다. 업데이트 중인 필드 목록입니다. |
UpdateEmailPreferencesRequest
UpdateEmailPreferences 메서드의 요청 메시지입니다.
필드 | |
---|---|
email_preferences |
필수 항목입니다. 이메일 환경설정을 업데이트할 예정입니다. |
update_mask |
필수 항목입니다. 업데이트 중인 필드 목록입니다. |
UpdateHomepageRequest
UpdateHomepage
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
homepage |
필수 항목입니다. 홈페이지의 새 버전입니다. |
update_mask |
필수 항목입니다. 업데이트 중인 필드 목록입니다. |
UpdateRegionRequest
UpdateRegion
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
region |
필수 항목입니다. 업데이트된 리전입니다. |
update_mask |
선택사항입니다. 업데이트할 필드를 나타내는 쉼표로 구분된 필드 마스크입니다. 예: |
UpdateUserRequest
UpdateUser
메서드에 대한 요청 메시지입니다.
필드 | |
---|---|
user |
필수 항목입니다. 사용자의 새 버전입니다.
|
update_mask |
필수 항목입니다. 업데이트 중인 필드 목록입니다. |
사용자
필드 | |
---|---|
name |
식별자. 사용자의 리소스 이름입니다. 형식:
|
state |
출력 전용입니다. 사용자의 상태입니다. |
access_rights[] |
선택사항입니다. 사용자의 액세스 권한 |
주
사용자의 가능한 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
PENDING |
사용자가 확인 대기 중입니다. 이 상태에서 사용자는 다른 작업을 수행하기 전에 먼저 초대를 수락해야 합니다. |
VERIFIED |
사용자가 확인되었습니다. |
값
요금 그룹의 단일 값 또는 요금 그룹 표의 셀 값입니다. no_shipping
, flat_rate
, price_percentage
, carrier_rateName
, subtable_name
중 정확히 하나를 설정해야 합니다.
필드 | |
---|---|
no_shipping |
true인 경우 제품을 배송할 수 없습니다. 설정할 때는 true여야 하며, 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
flat_rate |
고정 요금 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
price_percentage |
십진수 표기법 (예: |
carrier_rate |
동일한 배송비 그룹에서 정의된 운송업체 배송비를 참조하는 운송업체 배송비의 이름입니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
subtable |
하위 표의 이름입니다. 표 셀에서만 설정할 수 있으며 (예: 단일 값이 아닌 경우) 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
창고
재고를 저장하고 처리하는 주문 처리 창고 다음 태그: 7
필드 | |
---|---|
name |
필수 항목입니다. 웨어하우스의 이름입니다. 계정 내에서 고유해야 합니다. |
shipping_address |
필수 항목입니다. 창고의 배송지 주소입니다. |
cutoff_time |
필수 항목입니다. 주문을 수락하고 처리를 시작할 수 있는 가장 늦은 시간입니다. 그 이후의 주문은 다음 날 처리됩니다. 시간은 창고 우편번호를 기준으로 합니다. |
handling_days |
필수 항목입니다. 이 창고에서 상품을 포장하고 배송하는 데 걸리는 기간(일)입니다. 창고 수준이지만 상품의 속성에 따라 상품 수준에서 재정의할 수 있습니다. |
business_day_config |
창고의 영업일입니다. 설정하지 않으면 기본적으로 월요일~금요일입니다. |
WarehouseBasedDeliveryTime
선택한 운송업체의 설정에 따라 창고 (배송지 위치)별로 배송 시간을 계산해야 함을 나타냅니다. 설정되면 delivery_time
에 다른 운송 시간 관련 필드를 설정하면 안 됩니다.
필드 | |
---|---|
carrier |
필수 항목입니다. 이동통신사(예: |
carrier_service |
필수 항목입니다. 운송업체 서비스(예: |
warehouse |
필수 항목입니다. 웨어하우스 이름입니다. [warehouse][ShippingSetting.warehouses.name]과 일치해야 합니다. |
WarehouseCutoffTime
주문을 수락하고 처리를 시작할 수 있는 가장 늦은 시간입니다. 그 이후의 주문은 다음 날 처리됩니다. 시간은 창고 우편번호를 기준으로 합니다.
필드 | |
---|---|
hour |
필수 항목입니다. 창고에서 같은 날에 주문을 처리해야 하는 마감 시간의 시간입니다. 시간은 창고의 시간대를 기준으로 합니다. |
minute |
필수 항목입니다. 창고에서 당일에 주문을 처리하기 위해 주문해야 하는 마감 시간(분)입니다. 분은 창고의 시간대를 기준으로 합니다. |