판매자 프로모션 API를 사용하여 Google에서 프로모션을 만들고 관리할 수 있습니다. accounts.promotions 리소스를 사용하면 Google에서 판매하는 제품의 특별 이벤트를 표시할 수 있습니다. 자세한 내용은 판매자 프로모션 API 개요를 참고하세요.
요청
요청하려면 다음 URL을 사용하세요.
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
Content API for Shopping에서 이전
다음은 프로모션 관련 요청을 위한 Content API for Shopping과 판매자 프로모션 API를 비교한 것입니다.
URL
Content API for Shopping:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
는 다음과 같이 변환됩니다.
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
식별자
Content API for Shopping:
{merchantId}/promotions/{promotionId}
는 다음과 같이 변환됩니다.
{name}
방법
판매자 API는 다음과 같은 프로모션 메서드를 지원합니다.
- 프로모션 삽입
- 프로모션 받기
- 프로모션 나열
다음은 Content API for Shopping과 Merchant API의 프로모션 방법을 비교한 것입니다.
메서드 | Content API for Shopping | 판매자 API |
---|---|---|
insert | 예 | 예 |
get | 예 | 예 |
list | 예 | 예 |
customBatch | 아니요 | 아니요 |
삭제 | 아니요 | (추후 결정) |
리소스 이름
표에는 판매자 프로모션 API의 프로모션에 적용된 변경사항이 표시됩니다.
참조 예시를 보려면 오프라인 인벤토리를 참고하세요.
Content API for Shopping | 판매자 API | 설명 |
---|---|---|
(not supported) | custom_attributes |
맞춤 (판매자 제공) 속성의 목록입니다. 이 속성을 사용하여
피드 사양의 속성을 일반 형식으로 제출할 수도 있습니다. 예: { "name": "size type", "value": "regular" }API에 의해 명시적으로 노출되지 않은 속성을 제출하는 데 유용합니다. |
지원되지 않음 | data_source | 프로모션을 만들려면 기존 데이터 소스가 필요합니다. |
지원되지 않음 | 속성 |
프로모션 관련 속성(예:
long_tile, promotion_effective_timeperiod, 등)은 속성 메시지의 일부입니다. |
item_id | item_id_inclusion |
프로모션이 적용되는 상품 ID 목록의 이름이 변경됩니다. |
store_id | store_id_inclusion |
프로모션이 적용되는 스토어 ID 목록의 이름이 로 바뀝니다. |
prduct_type | product_type_inclusion |
프로모션이 적용되는
제품 유형 목록의 이름이 변경됩니다. |
item_group_id | item_group_id_inclusion |
프로모션이 적용되는 상품 그룹 ID 목록의 이름이 로 변경됩니다. |
brand | brand_inclusion |
프로모션이 적용되는 브랜드 목록의 이름이
변경됩니다. |
store_code | store_codes_inclusion |
프로모션이 적용되는 판매점 코드 목록의 이름이
변경됩니다. |
price: { object (Price) } |
price: { object (Price) } |
Price의 정의가 변경되었습니다.
Content API for Shopping에서 가격
이제 가격 금액이 마이크로(
amount 필드 이름이 값에서
currency 필드 이름이 |
order_limit | (not supported) | order_limit 속성은 지원되지 않습니다. |
shippingServiceNames[] | (not supported) | shippingServiceNames[]는 지원되지 않습니다. |
money_budget | (not supported) | money_budget은 지원되지 않습니다. |
promotion_destination_ids | promotion_destinations | promotionDestinationIds의 이름이 변경됩니다. |
프로모션 상태
{ "destinationStatuses": [ { "destination": string, "status": enum (State) } ], "promotionIssue": [ { "code": string, "detail": string } ], "creationDate": string, "lastUpdateDate": string } |
프로모션 상태가 변경되었습니다.
문제에서 보다 세부적인 수준의 세부정보를 확인할 수 있습니다. promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |