프로모션 관리 이전

판매자 프로모션 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에서 가격
은 문자열 형식의 10진수였습니다.

이제 가격 금액이 마이크로(
)로 기록되며, 여기서 100만 마이크로는 통화의
표준 단위에 해당합니다.

amount 필드 이름이 값에서
amountMicros.

currency 필드 이름이
currencyCode로 변경되었습니다. 형식은
ISO 4217로 유지됩니다. (위키피디아)

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,
    ]
    }
  ]
}