프로모션 관리 이전

판매자 프로모션 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는 다음과 같은 프로모션 메서드를 지원합니다.

  • 프로모션 삽입
  • 프로모션 받기
  • 프로모션 나열

다음은 쇼핑 및 판매자 API:

메서드 Content API for Shopping 판매자 API
insert 예 예
get 예 예
list 예 예
customBatch 아니요 아니요
삭제 아니요 (추후 결정)

리소스 이름

표에는 판매자 프로모션 API의 프로모션에 적용된 변경사항이 표시됩니다.

참조 예제를 보려면 로컬 인벤토리.

Content API for Shopping 판매자 API 설명
(지원되지 않음) 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에서 가격 <ph type="x-smartling-placeholder">
</ph> 문자열 형식의 십진수였습니다.

이제 Price(가격) 금액이 마이크로(micro)로 기록되며, <ph type="x-smartling-placeholder">
</ph> 100만 마이크로는 자국 통화의 <ph type="x-smartling-placeholder">
</ph> 표시됩니다.

amount 필드 이름이 값에서 <ph type="x-smartling-placeholder">
</ph> amountMicros.

currency 필드 이름이 <ph type="x-smartling-placeholder">
</ph> currencyCode를 설정합니다. 형식은
ISO 4217. (위키피디아)

order_limit (지원되지 않음) order_limit 속성은 지원되지 않습니다.
shippingServiceNames[] (지원되지 않음) shippingServiceNames[]는 지원되지 않습니다.
money_budget (지원되지 않음) money_budget은 지원되지 않습니다.
promotion_destination_ids promotion_destinations promotionDestinationIds의 이름이 변경됩니다.
프로모션 상태 <ph type="x-smartling-placeholder">
</ph> 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
<ph type="x-smartling-placeholder"></ph> 프로모션 상태가 변경되었습니다.
보다 세부적인 수준 세부정보는 문제에서 확인할 수 있습니다. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}