이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Package google.shopping.merchant.promotions.v1beta

색인

PromotionsService(인터페이스)
Attributes(메시지)
CouponValueType(열거형)
GetPromotionRequest(메시지)
InsertPromotionRequest(메시지)
ListPromotionsRequest(메시지)
ListPromotionsResponse(메시지)
OfferType(열거형)
ProductApplicability(열거형)
Promotion(메시지)
PromotionStatus(메시지)
PromotionStatus.DestinationStatus(메시지)
PromotionStatus.DestinationStatus.State(열거형)
PromotionStatus.ItemLevelIssue(메시지)
PromotionStatus.ItemLevelIssue.Severity(열거형)
RedemptionChannel(열거형)
StoreApplicability(열거형)

PromotionsService

제품 프로모션을 관리하는 서비스입니다.

GetPromotion

GetPromotion
`rpc GetPromotion(GetPromotionRequest) returns (Promotion)` 판매자 센터 계정에서 프로모션을 검색합니다. 프로모션 입력을 삽입하거나 업데이트한 후 업데이트된 프로모션을 가져올 때까지 몇 분 정도 걸릴 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc GetPromotion(GetPromotionRequest) returns (Promotion)

판매자 센터 계정에서 프로모션을 검색합니다.

프로모션 입력을 삽입하거나 업데이트한 후 업데이트된 프로모션을 가져올 때까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

InsertPromotion

InsertPromotion
`rpc InsertPromotion(InsertPromotionRequest) returns (Promotion)` 판매자 센터 계정에 프로모션을 삽입합니다. 프로모션이 이미 있는 경우 프로모션을 대신 업데이트합니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc InsertPromotion(InsertPromotionRequest) returns (Promotion)

판매자 센터 계정에 프로모션을 삽입합니다. 프로모션이 이미 있는 경우 프로모션을 대신 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListPromotions

ListPromotions
`rpc ListPromotions(ListPromotionsRequest) returns (ListPromotionsResponse)` 판매자 센터 계정에서 프로모션을 나열합니다. 응답에 `pageSize`에서 지정한 것보다 적은 수의 항목이 포함될 수 있습니다. `pageToken`를 사용하여 추가로 요청할 항목이 있는지 확인합니다. 프로모션을 삽입하거나 업데이트한 후 업데이트된 처리된 프로모션을 가져올 수 있을 때까지 몇 분 정도 걸릴 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/content` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ListPromotions(ListPromotionsRequest) returns (ListPromotionsResponse)

판매자 센터 계정에서 프로모션을 나열합니다. 응답에 pageSize에서 지정한 것보다 적은 수의 항목이 포함될 수 있습니다. pageToken를 사용하여 추가로 요청할 항목이 있는지 확인합니다.

프로모션을 삽입하거나 업데이트한 후 업데이트된 처리된 프로모션을 가져올 수 있을 때까지 몇 분 정도 걸릴 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

특성

속성.

입력란
`product_applicability`	`ProductApplicability` 필수 항목입니다. 모든 제품 또는 특정 제품에만 프로모션이 적용되는지 여부입니다.
`offer_type`	`OfferType` 필수 항목입니다. 프로모션 유형입니다. 이 속성을 사용하여 고객이 프로모션을 사용하는 데 쿠폰 코드가 필요한지 여부를 표시합니다.
`generic_redemption_code`	`string` 선택사항입니다. 프로모션의 일반 쿠폰 사용 코드입니다. `offerType` 필드와 함께 사용되며 최소 요구사항을 충족해야 합니다.
`long_title`	`string` 필수 항목입니다. 프로모션의 긴 제목입니다.
`coupon_value_type`	`CouponValueType` 필수 항목입니다. 쿠폰 값 유형 속성으로 진행 중인 프로모션의 유형을 알립니다. 선택한 쿠폰 값의 유형에 따라 일부 속성이 필요합니다.
`promotion_destinations[]`	`DestinationEnum` 필수 항목입니다. 프로모션이 적용되는 대상 유형 목록입니다. 데이터 소스에 지원 값을 포함하여 대상 유형을 지정하지 않으면 프로모션이 쇼핑 광고와 무료 등록정보에 기본적으로 표시됩니다. 이전에는 Shopping Actions, Google 플랫폼, Google 지역 플랫폼 값을 제품의 대상 유형으로 제출했을 수 있습니다. 이러한 값을 나타내려면 `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`를 사용합니다. 자세한 내용은 프로모션 도착 페이지를 참고하세요.
`item_id_inclusion[]`	`string` 선택사항입니다. 프로모션에서 상품 ID를 기준으로 한 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 specific_products로 설정된 경우에만 적용됩니다.
`brand_inclusion[]`	`string` 선택사항입니다. 프로모션을 위한 브랜드별 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 specific_products로 설정된 경우에만 적용됩니다.
`item_group_id_inclusion[]`	`string` 선택사항입니다. 프로모션의 상품 그룹 ID를 기준으로 한 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부[product_applicability] 속성이 specific_products로 설정된 경우에만 적용됩니다.
`product_type_inclusion[]`	`string` 선택사항입니다. 프로모션의 제품 유형별로 제품 필터입니다. 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 specific_products로 설정된 경우에만 적용됩니다.
`item_id_exclusion[]`	`string` 선택사항입니다. 프로모션에서 상품 ID 제외를 기준으로 제품을 필터링합니다. 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 specific_products로 설정된 경우에만 적용됩니다.
`brand_exclusion[]`	`string` 선택사항입니다. 프로모션에 대해 브랜드 제외를 기준으로 제품을 필터링합니다. 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 specific_products로 설정된 경우에만 적용됩니다.
`item_group_id_exclusion[]`	`string` 선택사항입니다. 상품 그룹 ID를 기준으로 제품 필터 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 프로모션의 specific_products 제외로 설정된 경우에만 적용됩니다.
`product_type_exclusion[]`	`string` 선택사항입니다. 프로모션에서 제품 유형 제외를 기준으로 제품을 필터링합니다. 제품 필터 속성은 프로모션 적용 여부 `product_applicability` 속성이 specific_products로 설정된 경우에만 적용됩니다.
`minimum_purchase_amount`	`Price` 선택사항입니다. 프로모션 최소 구매액
`minimum_purchase_quantity`	`int64` 선택사항입니다. 프로모션의 최소 구매 수량입니다.
`limit_quantity`	`int64` 선택사항입니다. 프로모션의 최대 구매 수량입니다.
`limit_value`	`Price` 선택사항입니다. 프로모션 최대 제품 가격.
`percent_off`	`int64` 선택사항입니다. 프로모션에서 제공하는 비율 할인입니다.
`money_off_amount`	`Price` 선택사항입니다. 프로모션에서 제공하는 할인 금액입니다.
`get_this_quantity_discounted`	`int64` 선택사항입니다. 프로모션에서 할인되는 상품의 수입니다. 이 속성은 `couponValueType`이 `buy_m_get_n_money_off` 또는 `buy_m_get_n_percent_off`과 같을 때 설정됩니다.
`free_gift_value`	`Price` 선택사항입니다. 프로모션의 사은품 가치입니다.
`free_gift_description`	`string` 선택사항입니다. 프로모션에 대한 사은품 설명입니다.
`free_gift_item_id`	`string` 선택사항입니다. 프로모션의 사은품 상품 ID입니다.
`promotion_effective_time_period`	`Interval` 필수 항목입니다. 프로모션 시행일의 `TimePeriod` 표현. 이 속성은 이 기간 동안 온라인 상점에서 프로모션을 테스트할 수 있음을 지정합니다.
`promotion_display_time_period`	`Interval` 선택사항입니다. 프로모션 표시 날짜의 `TimePeriod` 표현. 이 속성은 프로모션이 Google.com 및 쇼핑 광고에 게재되는 날짜와 시간을 지정합니다. 프로모션 표시 기간`promotion_display_time_period` 속성을 지정하지 않으면 프로모션 적용 기간`promotion_effective_time_period`에 따라 프로모션이 Google.com 및 쇼핑 광고에 게재되는 날짜와 기간이 결정됩니다.
`store_applicability`	`StoreApplicability` 선택사항입니다. 프로모션이 모든 매장 또는 지정된 매장에만 적용되는지 여부 매장 적용 여부가 포함되지 않은 오프라인 판매점 인벤토리 광고 프로모션에서 오류가 발생합니다. `store_applicability`이 `ALL_STORES`로 설정되고 `store_codes_inclusion` 또는 `score_code_exclusion`가 값으로 설정되면 `INVALID_ARGUMENT` 오류가 발생합니다.
`store_codes_inclusion[]`	`string` 선택사항입니다. 프로모션에 포함할 판매점 코드입니다. 매장 필터 속성은 `store_applicability` 속성이 specific_stores로 설정된 경우에만 적용됩니다. 제품이 판매되는 오프라인 상점의 판매점 코드 (비즈니스 프로필의 판매점 ID)입니다. 자세한 내용은 오프라인 제품 인벤토리 데이터 사양을 참조하세요.
`store_codes_exclusion[]`	`string` 선택사항입니다. 프로모션에서 제외할 판매점 코드입니다. 매장 필터 속성은 `store_applicability` 속성이 specific_stores로 설정된 경우에만 적용됩니다.
`promotion_url`	`string` 선택사항입니다. 프로모션이 표시되는 판매자 사이트 페이지의 URL입니다. `promotion_url`이 포함되지 않은 경우 오프라인 판매점 인벤토리 광고 프로모션에서 오류가 발생합니다. URL은 프로모션이 유효하며 사용할 수 있는지 확인하는 데 사용됩니다.

CouponValueType

프로모션의 쿠폰 값 유형입니다.

열거형
`COUPON_VALUE_TYPE_UNSPECIFIED`	쿠폰 값 유형이 지정되지 않았음을 나타냅니다.
`MONEY_OFF`	할인 쿠폰 값 유형입니다.
`PERCENT_OFF`	할인율 쿠폰 값 유형입니다.
`BUY_M_GET_N_MONEY_OFF`	M개 수량 구매 시 쿠폰 금액 유형 N개 할인. `minimum_purchase_quantity` 및 `get_this_quantity_discounted`가 있어야 합니다. `money_off_amount`도 있어야 합니다.
`BUY_M_GET_N_PERCENT_OFF`	M개 수량 구매 시 쿠폰 값 유형 N% 할인 `minimum_purchase_quantity` 및 `get_this_quantity_discounted`가 있어야 합니다. `percent_off_percentage`도 있어야 합니다.
`BUY_M_GET_MONEY_OFF`	M개 수량 이상 구매 시 할인 혜택을 드립니다. `minimum_purchase_quantity` 및 `money_off_amount`이(가) 있어야 합니다.
`BUY_M_GET_PERCENT_OFF`	M개 수량 이상 구매 시 할인 혜택을 드립니다. `minimum_purchase_quantity` 및 `percent_off_percentage`이(가) 있어야 합니다.
`FREE_GIFT`	설명이 포함된 사은품.
`FREE_GIFT_WITH_VALUE`	금전적 가치가 있는 사은품
`FREE_GIFT_WITH_ITEM_ID`	상품 ID가 포함된 사은품입니다.
`FREE_SHIPPING_STANDARD`	표준 무료 배송 쿠폰 값 유형입니다.
`FREE_SHIPPING_OVERNIGHT`	익일 무료 배송 쿠폰 값 유형입니다.
`FREE_SHIPPING_TWO_DAY`	2일 무료 배송 쿠폰 값 유형입니다.

GetPromotionRequest

GetPromotion 메서드에 대한 요청 메시지입니다.

입력란

입력란
`name`	`string` 필수 항목입니다. 검색할 프로모션의 이름입니다. 형식: `accounts/{account}/promotions/{promotions}`

name

string

필수 항목입니다. 검색할 프로모션의 이름입니다. 형식: accounts/{account}/promotions/{promotions}

InsertPromotionRequest

InsertPromotion 메서드에 대한 요청 메시지입니다.

입력란

입력란
`parent`	`string` 필수 항목입니다. 프로모션이 삽입될 계정입니다. 형식: accounts/{account}
`promotion`	`Promotion` 필수 항목입니다. 삽입할 프로모션입니다.
`data_source`	`string` 필수 항목입니다. 프로모션 형식의 데이터 소스: `accounts/{account}/dataSources/{datasource}`.

parent

string

필수 항목입니다. 프로모션이 삽입될 계정입니다. 형식: accounts/{account}

promotion

Promotion

필수 항목입니다. 삽입할 프로모션입니다.

data_source

string

필수 항목입니다. 프로모션 형식의 데이터 소스: accounts/{account}/dataSources/{datasource}.

ListPromotionsRequest

ListPromotions 메서드에 대한 요청 메시지입니다.

입력란

입력란
`parent`	`string` 필수 항목입니다. 처리된 프로모션을 나열할 계정입니다. 형식: `accounts/{account}`
`page_size`	`int32` 출력 전용입니다. 반환할 프로모션의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 지정하지 않으면 최대 프로모션 수가 반환됩니다.
`page_token`	`string` 출력 전용입니다. 이전 `ListPromotions` 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 `ListPromotions`에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

parent

string

필수 항목입니다. 처리된 프로모션을 나열할 계정입니다. 형식: accounts/{account}

page_size

int32

출력 전용입니다. 반환할 프로모션의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 지정하지 않으면 최대 프로모션 수가 반환됩니다.

page_token

string

출력 전용입니다. 이전 ListPromotions 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListPromotions에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListPromotionsResponse

ListPromotions 메서드에 대한 응답 메시지입니다.

입력란

입력란
`promotions[]`	`Promotion` 지정된 계정에서 처리된 프로모션입니다.
`next_page_token`	`string` 다음 페이지를 검색하기 위해 `page_token`으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

promotions[]

Promotion

지정된 계정에서 처리된 프로모션입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

OfferType

프로모션의 혜택 유형입니다.

열거형
`OFFER_TYPE_UNSPECIFIED`	알 수 없는 혜택 유형입니다.
`NO_CODE`	코드가 없는 혜택 유형입니다.
`GENERIC_CODE`	코드가 포함된 혜택 유형입니다. `offerType` = `GENERIC_CODE`인 경우 프로모션의 일반 쿠폰 사용 코드가 필요합니다.

ProductApplicability

프로모션이 적용되는 제품 또는 제품 목록

열거형
`PRODUCT_APPLICABILITY_UNSPECIFIED`	프로모션이 적용되는 제품을 알 수 없습니다.
`ALL_PRODUCTS`	모든 제품에 적용할 수 있습니다.
`SPECIFIC_PRODUCTS`	단일 제품 또는 제품 목록에만 적용할 수 있습니다.

프로모션

프로모션을 나타냅니다. 자세한 내용은 다음 도움말을 참고하세요.

데이터 유효성 검사를 통과하는 데 필요한 프로모션 입력 속성은 주로 아래에 정의되어 있습니다.

프로모션 입력을 삽입하고 업데이트한 후 최종 프로모션을 검색할 수 있을 때까지 몇 분 정도 걸릴 수 있습니다.

입력란
`name`	`string` 식별자. 프로모션의 이름입니다. 형식: `accounts/{account}/promotions/{promotion}`
`promotion_id`	`string` 필수 항목입니다. 사용자가 프로모션을 고유하게 식별하기 위해 프로모션 ID를 제공했습니다. 프로모션 비승인을 방지하려면 최소 요구사항을 따르세요.
`content_language`	`string` 필수 항목입니다. 프로모션의 두 글자 ISO 639-1 언어 코드입니다. 프로모션은 일부 언어에만 제공됩니다.
`target_country`	`string` 필수 항목입니다. 고유 식별자의 일부로 사용되는 대상 국가입니다. CLDR 지역 코드로 표시됩니다. 프로모션은 일부 국가에서만 사용할 수 있습니다. 무료 등록정보 및 쇼핑 광고 오프라인 판매점 인벤토리 광고
`redemption_channel[]`	`RedemptionChannel` 필수 항목입니다. 프로모션의 사용 채널입니다. 채널이 하나 이상 필요합니다.
`data_source`	`string` 출력 전용입니다. 프로모션의 기본 데이터 소스입니다.
`attributes`	`Attributes` 선택사항입니다. 프로모션 속성 목록입니다.
`custom_attributes[]`	`CustomAttribute` 선택사항입니다. 맞춤 (판매자 제공) 속성의 목록입니다. 데이터 사양의 속성을 일반 형식으로 제출하는 데에도 사용할 수 있습니다 (예: `{ "name": "size type", "value": "regular" }`). API에 의해 명시적으로 노출되지 않은 속성을 제출하는 데 유용합니다.
`promotion_status`	`PromotionStatus` 출력 전용입니다. 프로모션 상태, 데이터 유효성 검사 문제, 즉 비동기적으로 계산된 프로모션에 대한 정보입니다.
`version_number`	`int64` 선택사항입니다. 프로모션의 기존 버전 (최신성)을 나타내며, 여러 업데이트가 동시에 완료될 때 올바른 순서를 유지하는 데 사용할 수 있습니다. 설정하면 버전 번호가 기존 프로모션의 현재 버전 번호보다 낮을 때 삽입이 차단됩니다. 현재 `version_number`를 사용하여 다시 게재 (예: 30일 후 프로모션 새로고침)할 수 있습니다. 작업이 방지되면 취소된 예외가 발생합니다.

PromotionStatus

프로모션의 상태입니다.

입력란
`destination_statuses[]`	`DestinationStatus` 출력 전용입니다. 프로모션의 대상 도착 페이지입니다.
`item_level_issues[]`	`ItemLevelIssue` 출력 전용입니다. 프로모션과 관련된 문제 목록입니다.
`creation_date`	`Timestamp` 출력 전용입니다. 프로모션이 생성된 날짜(ISO 8601 형식): 날짜, 시간, 오프셋(예: `2020-01-02T09:00:00+01:00` 또는 `2020-01-02T09:00:00Z`)
`last_update_date`	`Timestamp` 출력 전용입니다. 프로모션 상태가 ISO 8601 형식으로 마지막으로 업데이트된 날짜입니다. 날짜, 시간, 오프셋(예: `2020-01-02T09:00:00+01:00` 또는 `2020-01-02T09:00:00Z`)입니다.

DestinationStatus

지정된 대상의 상태입니다.

입력란

입력란
`reporting_context`	`ReportingContextEnum` 출력 전용입니다. 프로모션 대상 유형의 이름입니다.
`status`	`State` 출력 전용입니다. 지정된 대상의 상태입니다.

reporting_context

ReportingContextEnum

출력 전용입니다. 프로모션 대상 유형의 이름입니다.

status

State

출력 전용입니다. 지정된 대상의 상태입니다.

상태

프로모션의 현재 상태입니다.

열거형
`STATE_UNSPECIFIED`	알 수 없는 프로모션 상태입니다.
`IN_REVIEW`	프로모션을 검토 중입니다.
`REJECTED`	프로모션이 비승인되었습니다.
`LIVE`	프로모션이 승인되어 활성 상태입니다.
`STOPPED`	판매자가 프로모션을 중지했습니다.
`EXPIRED`	프로모션이 더 이상 활성 상태가 아닙니다.
`PENDING`	프로모션이 중지되지 않고 모든 리뷰가 승인되었지만 활성 날짜는 미래 날짜입니다.

ItemLevelIssue

프로모션과 관련된 문제입니다.

입력란
`code`	`string` 출력 전용입니다. 문제의 오류 코드입니다.
`severity`	`Severity` 출력 전용입니다. 이 문제가 프로모션 게재에 미치는 영향
`resolution`	`string` 출력 전용입니다. 판매자가 문제를 해결할 수 있는지 여부입니다.
`attribute`	`string` 출력 전용입니다. 문제가 단일 속성으로 인해 발생한 경우 속성의 이름입니다.
`reporting_context`	`ReportingContextEnum` 출력 전용입니다. 문제가 적용되는 대상 위치입니다.
`description`	`string` 출력 전용입니다. 간단한 문제 설명(영어)
`detail`	`string` 출력 전용입니다. 자세한 문제 설명(영어)
`documentation`	`string` 출력 전용입니다. 이 문제를 해결하는 데 도움이 되는 웹페이지의 URL입니다.
`applicable_countries[]`	`string` 출력 전용입니다. 문제가 혜택에 적용되는 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.

심각도

문제의 심각도입니다.

열거형
`SEVERITY_UNSPECIFIED`	지정되지 않았습니다.
`NOT_IMPACTED`	이 문제는 경고를 나타내며 프로모션에 직접적인 영향을 미치지 않습니다.
`DEMOTED`	프로모션 순위가 낮아졌으며 검색결과에서 실적이 제한될 가능성이 높습니다.
`DISAPPROVED`	문제로 인해 프로모션이 비승인됩니다.

RedemptionChannel

프로모션 채널입니다.

열거형
`REDEMPTION_CHANNEL_UNSPECIFIED`	채널이 지정되지 않았음을 나타냅니다.
`IN_STORE`	채널이 스토어에 추가되었음을 나타냅니다. `products`에 사용된 `local` 채널과 동일합니다.
`ONLINE`	채널이 온라인 상태임을 나타냅니다.

StoreApplicability

프로모션이 적용되는 판매점 코드 또는 판매점 코드 목록입니다. 오프라인 판매점 인벤토리 광고 프로모션에만 적용됩니다.

열거형
`STORE_APPLICABILITY_UNSPECIFIED`	프로모션이 적용되는 판매점 코드를 알 수 없습니다.
`ALL_STORES`	모든 매장에 프로모션이 적용됩니다.
`SPECIFIC_STORES`	프로모션은 지정된 매장에만 적용됩니다.