오퍼 매니페스트 참조

오퍼 매니페스트 참조

Snowflake 오퍼를 프로그래밍 방식으로 만들려면 YAML(https://yaml.org/spec/)로 작성된 매니페스트가 필요해요. 여기 제공된 정보를 사용해 오퍼 매니페스트에서 사용할 수 있는 파라미터에 대해 알아보세요.

출처: Offer manifest reference

본문

오퍼 매니페스트

#
# Offer manifest
#
access_start_date_preference: <preferred_offer_start_date>
comment: <offer_comments>
contract_type: <contract_type>
contract_duration_months: <the_contract_duration_in_months>
invoice_end_time: <invoice_end_date_and_time>
invoice_start_date_preference: <preferred_invoice_start_date>
invoice_start_time: <invoice_start_time>
is_default: <is_a_default_offer_included_with_the_pricing_plane>
offer_display_name: <offer_display_name>
offer_expiration_time: <offer_expiration_time>
payment_terms:
  payment_type: <pricing_plan_payment_method>
  installment_schedule: <pricing_plan_installment_schedule>
  allowed_payment_methods: <allowed_payment_methods>
pricing_plan_name: <the_pricing_plan_name>
access_end_time: <listing_access_end_time>
access_start_time: <listing_access_start_time>
discount: <the_offer_discount>
target_consumer: <offer_target_consumer>
terms_of_service:
  type: <terms_of_service_type>
  custom_link: <link_to_custom_terms_of_service>
additional_information: <additional_offer_information>
attachments:
  - attachment_path: <stage_path_to_pdf>

오퍼 파라미터

오퍼 매니페스트의 파라미터를 사용하면 특정 비즈니스 요구 사항을 충족하는 오퍼를 만들 수 있어요. 필수 및 선택 파라미터가 식별되어 있어요.

  • access_start_date_preference — 필수. 문자열. 선호하는 오퍼 시작 날짜. 허용 값은 SPECIFIC_DATE 또는 OFFER_ACCEPTED_DATE.
  • comment — 선택. 문자열. 제공자에게만 표시되는 오퍼에 대한 주석.
  • contract_type — 필수. 문자열. 계약 유형. 허용 값은 SUBSCRIPTION 또는 LIMITED_TIME.
  • contract_duration_months — 필수. Long. 계약 기간(개월).
  • invoice_end_time — 필수. Long. Unix epoch 이후 밀리초 단위의 청구서 종료 날짜와 시간.
  • invoice_start_date_preference — 필수. 문자열. 선호하는 청구서 시작 날짜. 허용 값은 다음을 포함해요.
    • OFFER_ACCEPTED_DATE: 고정 요금 플랜에 사용.
    • SPECIFIC_DATE: 고정 요금 플랜 또는 (덜 일반적으로) 사용 기반 플랜에 사용.
    • FIRST_DAY_NEXT_MONTH: 고정 요금 플랜 또는 새 사용 기반 플랜에 사용.
    • TWO_DAYS_AFTER_OFFER_ACCEPTED_DATE: 소비자가 기존 사용 기반 플랜을 대체하는 새 사용 기반 플랜을 수락하도록 허용할 때 사용. 이 경우 새 사용 기반 가격 플랜이 적용되는 데 최대 2일이 걸릴 수 있어요.
  • invoice_start_time — 필수. Long. 청구서가 생성된 시간.
  • is_default — 필수. Boolean. TRUE이면 가격 플랜에 기본 오퍼가 포함됨을 지정해요. 기본값은 FALSE.
  • offer_display_name — 선택. 문자열. 소비자에게 표시되는 오퍼 이름.
  • offer_expiration_time — 선택. Long. 오퍼 만료 시간.
  • payment_terms — 필수. 추가 가격 플랜 파라미터를 제공해요. 다음 파라미터를 지정할 수 있어요.
    • payment_type — 문자열. 가격 플랜 결제 유형. 허용 값은 INVOICE와 CREDIT_CARD.
    • installment_schedule — 문자열. 가격 플랜 할부 일정.
    • allowed_payment_methods — 목록. 허용된 가격 플랜 결제 방법. 허용 값은 INVOICE와 CREDIT_CARD.
  • pricing_plan_name — 필수. 문자열. 가격 플랜 이름.
  • access_end_time — 필수. Long. 소비자가 체험 리스팅에 대한 접근을 잃는 시간.
  • access_start_time — 필수. Long. 소비자가 리스팅에 접근할 수 있는 시간.
  • discount — 선택. Double. 오퍼 할인.
  • target_consumer — 선택. 문자열. 오퍼의 대상 소비자. 형식은 organization_name.account_name.
  • terms_of_service — 필수. 추가 가격 플랜 서비스 약관을 제공해요. 다음 파라미터를 지정할 수 있어요.
    • type — 문자열. 서비스 약관 유형. 허용 값은 CUSTOM, DEFAULT, OFFLINE.
    • custom_link — 문자열. 사용자 정의 서비스 약관에 대한 링크.
  • additional_information — 선택. 추가 오퍼 정보.
  • attachments — 선택. 목록. 프라이빗 오퍼에 첨부할 PDF 파일. 소비자는 오퍼를 볼 때 이러한 파일을 다운로드할 수 있어요. 다음 필드를 지정할 수 있어요.
    • attachment_path — 문자열. 리스팅 스테이지의 PDF 파일 경로. offers/<offer_name>/attachments/<filename>.pdf 형식을 따라야 해요. 각 오퍼는 최대 5개의 PDF 첨부 파일을 지원하며 파일당 최대 5 MB예요. 리스팅의 모든 오퍼에 걸친 모든 첨부 파일의 총 크기는 50 MB를 초과할 수 없어요.

예시

다음 예시는 PRICING_PLAN_V2 가격 플랜에 연결된 기간 한정 오퍼를 정의해요.

version: V2
contract_type: LIMITED_TIME
contract_duration_months: 12
display_name: OFFER_V2
is_default: true
payment_terms:
  payment_type: FULL
state: PUBLISHED
sales_motion: SELF_SERVE
pricing_plan_details:
  type: DEFAULT
  name: PRICING_PLAN_V2
metadata:
  description: sample-description
  price: 100
  button_text: button-text
  value_propositions:
    - val 1
    - val 2

더 알아보기