이 가이드에서는 accounts.products.regionalInventories 리소스와 관련된 서비스 타겟으로 사용할 수 있는 지리적 리전을 나타냅니다. 지역을 우편번호 모음으로 정의하거나 일부 국가에서는 사전 정의된 지역 타겟을 사용하여 정의할 수 있습니다. 자세한 내용은 리전 설정을 참고하세요.
리전을 만들고 업데이트하려면 다음 방법을 사용하면 됩니다.
지역 검색
판매자 센터 계정에 정의된 지역을 검색하려면 accounts.regions.get 메서드를 사용하세요.
다음은 샘플 요청입니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/125222396/regions/234567?key=[YOUR_API_KEY]
다음은 호출에 성공했을 때의 샘플 응답입니다.
HTTP/1.1 200
{
"name": "accounts/125222396/regions/234567",
"displayName": "Canada",
"postalCodeArea": {
"regionCode": "CA",
"postalCodes": [
{
"begin": "L6A"
}
]
}
모든 지역 나열
판매자 센터 계정의 지역을 나열하려면 accounts.regions.list 메서드를 사용하세요.
다음은 샘플 요청입니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/125222396/regions?pageSize=100&key=[YOUR_API_KEY]
다음은 호출에 성공했을 때의 샘플 응답입니다.
HTTP/1.1 200
{
"regions": [
{
"name": "accounts/125222396/regions/234567",
"displayName": "Canada",
"postalCodeArea": {
"regionCode": "CA",
"postalCodes": [
{
"begin": "L6A"
}
]
},
"regionalInventoryEligible": true,
"shippingEligible": true
},
{
"name": "accounts/125222396/regions/Inline region",
"displayName": "Inline region",
"postalCodeArea": {
"regionCode": "CA",
"postalCodes": [
{
"begin": "M7B"
}
]
},
"regionalInventoryEligible": false,
"shippingEligible": true
},
]
}
지역 삽입
판매자 센터 계정에 지역 정의를 삽입하려면 accounts.regions.create 메서드를 사용하세요. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.
다음은 샘플 요청입니다.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions?regionId=987654&key=[YOUR_API_KEY]
{
"displayName": "TestRegion",
"name": "987654",
"postalCodeArea": {
"postalCodes": [
{
"begin": "98109"
}
],
"regionCode": "US"
}
}
다음은 호출에 성공했을 때의 샘플 응답입니다.
{
"name": "accounts/102959835/regions/987654",
"displayName": "TestRegion",
"postalCodeArea": {
"regionCode": "US",
"postalCodes": [
{
"begin": "98109"
}
]
},
"regionalInventoryEligible": true,
"shippingEligible": true
}
AreaCode로 새 리전을 만드는 방법은 다음과 같습니다.
다음은 샘플 요청입니다.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions?regionId=168888&key=[YOUR_API_KEY] HTTP/1.1
{
"displayName": "WA_test",
"name": "168888",
"geotargetArea": {
"geotargetCriteriaIds": [
20101
]
}
}
다음은 호출에 성공했을 때의 샘플 응답입니다.
{
"name": "accounts/102959835/regions/168888",
"displayName": "WA_test",
"geotargetArea": {
"geotargetCriteriaIds": [
"20101"
]
},
"regionalInventoryEligible": true,
"shippingEligible": false
}
생성된 리전의 displayName 및 GeoTargetCriteriaIds를 업데이트하려면 다음을 실행합니다.
다음은 샘플 요청입니다.
PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions/168888?updateMask=displayName%2CgeotargetArea&key=[YOUR_API_KEY] HTTP/1.1
{
"displayName": "BR_test",
"geotargetArea": {
"geotargetCriteriaIds": [
20100
]
}
}
다음은 호출에 성공했을 때의 샘플 응답입니다.
HTTP/1.1 200
{
"name": "accounts/102959835/regions/168888",
"displayName": "BR_test",
"geotargetArea": {
"geotargetCriteriaIds": [
"20100"
]
},
"regionalInventoryEligible": true,
"shippingEligible": false
}
지역 업데이트
판매자 센터 계정에서 지역 정의를 업데이트하려면 accounts.regions.patch 메서드를 사용하세요. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.
다음은 샘플 요청입니다.
PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions/987654?updateMask=displayName%2CpostalCodeArea&key=[YOUR_API_KEY] HTTP/1.1
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Accept: application/json
Content-Type: application/json
{
"displayName": "Test",
"postalCodeArea": {
"postalCodes": [
{
"begin": "98108"
}
],
"regionCode": "US"
}
}
다음은 호출에 성공했을 때의 샘플 응답입니다.
{
"name": "accounts/102959835/regions/987654",
"displayName": "Test",
"postalCodeArea": {
"regionCode": "US",
"postalCodes": [
{
"begin": "98108"
}
]
},
"regionalInventoryEligible": true,
"shippingEligible": true
}
지역 삭제
판매자 센터 계정에서 지역 정의를 삭제하려면 accounts.regions.delete 메서드를 사용하세요. 이 메서드를 실행하려면 관리자 액세스 권한이 필요합니다.
다음은 샘플 요청입니다.
DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/102959835/regions/987654?key=[YOUR_API_KEY] HTTP/1.1
다음은 호출에 성공했을 때의 샘플 응답입니다.
HTTP/1.1 200
{}