Référence du manifeste des offres

La création d’offres Snowflake de manière programmatique nécessite un manifeste, écrit au format YAML (https://yaml.org/spec/). Utilisez les informations fournies ici pour en savoir plus sur les paramètres disponibles dans le manifeste des offres.

Manifeste des offres

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

Paramètres des offres

Les paramètres du manifeste des offres vous permettent de créer des offres qui répondent à vos besoins commerciaux spécifiques. Les paramètres obligatoires et facultatifs sont identifiés.

access_start_date_preference

Requis. Chaîne. Date de début de l’offre préférée. Les valeurs acceptées sont SPECIFIC_DATE ou OFFER_ACCEPTED_DATE.

comment

En option. Chaîne. Commentaires sur l’offre qui ne sont visibles que par les fournisseurs.

contract_type

Requis. Chaîne. Type du contrat. Les valeurs acceptées sont SUBSCRIPTION ou LIMITED_TIME.

contract_duration_months

Requis. Long. Durée du contrat en mois.

invoice_end_time

Requis. Long. Date et heure de fin de la facturation en millisecondes depuis l’époque Unix.

invoice_start_date_preference

Required. String. The preferred invoice start date. Accepted values include the following:

  • OFFER_ACCEPTED_DATE : À utiliser avec des plans à frais fixes.

  • SPECIFIC_DATE : À utiliser avec des plans à prix fixe ou (moins fréquemment) avec des plans basés sur l’utilisation.

  • FIRST_DAY_NEXT_MONTH : À utiliser avec des plans à frais fixes ou avec de nouveaux plans basés sur l’utilisation.

  • TWO_DAYS_AFTER_OFFER_ACCEPTED_DATE : À utiliser lorsque vous autorisez un consommateur à accepter un nouveau plan basé sur l’utilisation qui remplace un plan basé sur l’utilisation existant. Dans ce cas, l’entrée en vigueur du nouveau plan tarifaire basé sur l’utilisation peut prendre jusqu’à 2 jours.

invoice_start_time

Requis. Long. Heure de création de la facture.

is_default

Requis. Booléen. Lorsque ce paramètre est défini sur TRUE, spécifie qu’une offre par défaut est incluse dans le plan tarifaire. La valeur par défaut est FALSE.

offer_display_name

En option. Chaîne. Nom de l’offre visible par les consommateurs.

offer_expiration_time

En option. Long. Heure d’expiration de l’offre.

payment_terms

Requis. Fournit des paramètres supplémentaires pour le plan tarifaire. Vous pouvez spécifier les paramètres suivants :

Chaîne. Types de paiement du plan tarifaire. Les valeurs acceptées sont INVOICE et CREDIT_CARD.

pricing_plan_name

Requis. Chaîne. Nom du plan tarifaire.

access_end_time

Requis. Long. Moment où le consommateur perd l’accès à une annonce d’essai.

access_start_time

Requis. Long. Moment où le consommateur peut accéder à une annonce.

discount

En option. Double. Remise de l’offre.

target_consumer

En option. Chaîne. Consommateur cible de l’offre. Le format est organization_name.account_name.

terms_of_service

Requis. Fournit des conditions de service supplémentaires pour le plan tarifaire. Vous pouvez spécifier les paramètres suivants :

Chaîne. Type des conditions de service. Les valeurs acceptées sont CUSTOM, DEFAULT et OFFLINE.

additional_information

En option. Informations supplémentaires sur l’offre.

Exemples

L’exemple suivant définit une offre à durée limitée liée à un plan tarifaire 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
Copy