프로모션 관리 이전

Merchant Promotions API를 사용하여 Google에서 프로모션을 만들고 관리할 수 있습니다. accounts.promotions 리소스를 사용하면 Google에서 판매하는 제품의 특별 혜택을 보여줄 수 있습니다. 자세한 내용은 Merchant Promotions API 개요를 참고하세요.

Content API for Shopping에서 Merchant API로의 변경사항 개요

Content API for Shopping은 첫 번째 프로모션 삽입 시 데이터 소스를 자동으로 생성하지만 Merchant API에서는 데이터 소스가 생성되지 않는다는 점이 가장 큰 차이점입니다. Merchant API를 사용하여 프로모션을 삽입하려면 먼저 프로모션 데이터 소스를 만들어야 합니다. accounts.dataSources 리소스의 promotionDataSource 객체에 있는 필드에 대한 자세한 내용은 PromotionDataSource를 참고하세요.

요청

요청하려면 다음 URL을 사용하세요.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Content API for Shopping에서 이전

다음은 프로모션 관련 요청에 대해 Content API for Shopping과 Merchant Promotions API를 비교한 것입니다.

URL

Content API for Shopping에서:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

Merchant API에서 다음과 같이 변경됩니다.

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

식별자

Content API for Shopping에서:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

Merchant API에서 다음과 같이 변경됩니다.

{NAME}

메서드

Merchant API는 프로모션에 대해 다음 메서드를 지원합니다.

• 프로모션 삽입
• 프로모션 가져오기
• 프로모션 나열

다음은 Content API for Shopping과 Merchant API에서 사용할 수 있는 프로모션 메서드를 비교한 것입니다.

필드 변경사항

다음 표는 Merchant Promotions API의 프로모션에 어떤 변경사항이 있는지 보여줍니다.

참고용 예시를 보려면 오프라인 재고를 참고하세요.

{
  "name": "size type", "value": "regular"
}

price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }

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