Referência do manifesto da oferta¶

A criação de ofertas do Snowflake de maneira programática requer um manifesto, escrito em YAML (https://yaml.org/spec/). Use as informações fornecidas aqui para saber mais sobre os parâmetros disponíveis no manifesto da oferta.

Manifesto da oferta¶

#
# 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>

Parâmetros da oferta¶

Os parâmetros dentro do manifesto da oferta permitem criar ofertas que atendam às suas exigências comerciais específicas. Os parâmetros obrigatórios e opcionais são identificados.

access_start_date_preference

Obrigatório. Cadeia de caracteres. A data de início da oferta preferencial. Os valores aceitos são SPECIFIC_DATE ou OFFER_ACCEPTED_DATE.

comment

Opcional. Cadeia de caracteres. Comentários sobre a oferta visíveis apenas aos provedores.

contract_type

Obrigatório. Cadeia de caracteres. O tipo de contrato. Os valores aceitos são SUBSCRIPTION ou LIMITED_TIME.

contract_duration_months

Obrigatório. Longo. A duração do contrato em meses.

invoice_end_time

Obrigatório. Longo. Data e hora finais da fatura em milissegundos desde a época Unix.

invoice_start_date_preference

Obrigatório. Cadeia de caracteres. A data de início preferencial da fatura. Os valores aceitos incluem:

OFFER_ACCEPTED_DATE: Use com planos de taxa fixa.
SPECIFIC_DATE: Use com planos de taxa fixa ou (menos comum) com planos conforme o uso.
FIRST_DAY_NEXT_MONTH: Use com planos de taxa fixa ou com novos planos conforme o uso.
TWO_DAYS_AFTER_OFFER_ACCEPTED_DATE: Use quando permitir que um consumidor aceite um novo plano conforme o uso que substitui um existente. Nesse caso, pode levar até 2 dias para que o novo plano de preços conforme o uso entre em vigor.

invoice_start_time

Obrigatório. Longo. A hora em que a fatura foi criada.

is_default

Obrigatório. Booleano. Quando é TRUE, especifica que uma oferta padrão é incluída no plano de preços. O padrão é FALSE.

offer_display_name

Opcional. Cadeia de caracteres. O nome da oferta visível para os consumidores.

offer_expiration_time

Opcional. Longo. O tempo de expiração da oferta.

payment_terms

Obrigatório. Fornece parâmetros adicionais do plano de preços. Você pode especificar os seguintes parâmetros:

Cadeia de caracteres. Os tipos de pagamento do plano de preços. Os valores aceitos são INVOICE e CREDIT_CARD.

pricing_plan_name

Obrigatório. Cadeia de caracteres. O nome do plano de preços.

access_end_time

Obrigatório. Longo. A hora em que o consumidor perde o acesso à versão de avaliação de uma listagem.

access_start_time

Obrigatório. Longo. A hora em que um consumidor pode acessar uma listagem.

discount

Opcional. Duplo. O desconto da oferta.

target_consumer

Opcional. Cadeia de caracteres. O consumidor de destino da oferta. O formato é organization_name.account_name.

terms_of_service

Obrigatório. Fornece termos de serviço adicionais do plano de preços. Você pode especificar os seguintes parâmetros:

Cadeia de caracteres. Os termos do tipo de serviço. Os valores aceitos são CUSTOM, DEFAULT e OFFLINE.

additional_information

Opcional. Informações adicionais da oferta.

Exemplos¶

O exemplo a seguir define uma oferta por tempo limitado vinculada a um plano de preços 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