Créer un plan planifié

Version 3.1.23.2

Créer un plan planifié

Créez un plan planifié pour afficher un look ou un tableau de bord selon un calendrier récurrent.

Pour créer un plan planifié, vous DEVEZ fournir des valeurs pour les champs suivants : name et look_id, dashboard_id, lookml_dashboard_id, query_id et cron_tab ou datagroup, et au moins un élément planifié_plan_destination

Au moins un élément "schedule_plan_destination" doit être défini pour un plan planifié.

Lorsque look_id est défini, require_no_results, require_results et require_change sont tous obligatoires.

Si create_scheduled_plan échoue avec une erreur 422, consultez les messages d'erreur dans la réponse pour savoir exactement quels champs sont manquants ou quelles valeurs sont incompatibles.

Les requêtes qui fournissent les données concernant l'apparence ou le tableau de bord sont exécutées dans le contexte du compte utilisateur qui détient le plan planifié.

Lorsque run_as_recipient est défini sur false ou n'est pas spécifié, les requêtes qui fournissent les données pour le style ou le tableau de bord sont exécutées dans le contexte du compte utilisateur qui possède le plan planifié.

Lorsque run_as_recipient est défini sur true et que tous les destinataires des e-mails sont des comptes utilisateur Looker, les requêtes sont exécutées dans le contexte de chaque destinataire. Par conséquent, différents destinataires peuvent voir des données différentes du même rendu planifié d'un look ou d'un tableau de bord. Pour en savoir plus, consultez Exécuter en tant que destinataire.

Les administrateurs peuvent créer et modifier des plans planifiés pour le compte d'autres utilisateurs en spécifiant un ID utilisateur. Les utilisateurs non administrateurs ne peuvent pas créer ni modifier des plans planifiés par ou pour d'autres utilisateurs.

Autorisations de messagerie:

Pour en savoir plus sur les autorisations requises pour planifier l'envoi d'e-mails et les mesures de protection proposées par Looker pour empêcher l'envoi vers des destinations de messagerie non autorisées, consultez la liste d'autorisation des domaines d'e-mail pour les styles programmés.

Formats de destination du plan planifié

Les destinations du plan planifié doivent spécifier le format de données à produire et à envoyer à la destination.

Formats :

format Description
json Un objet JSON contenant une propriété data contenant un tableau d'objets JSON (un par ligne) Aucune métadonnée.
détail_json Données de ligne et métadonnées décrivant les champs, les tableaux croisés dynamiques, les valeurs de calcul de tableau et d'autres aspects de la requête
inline_json Identique au format JSON, sauf que la propriété data est une chaîne contenant des données de ligne avec échappement JSON. D'autres propriétés décrivent l'opération des données. Ce format est principalement utilisé pour envoyer des données aux webhooks afin que le webhook ne doive pas réencoder les données de ligne JSON pour les transmettre à sa destination finale.
csv Valeurs séparées par une virgule avec un en-tête
txt Valeurs séparées par des tabulations, avec un en-tête
html HTML simple
xlsx Feuille de calcul MS Excel
wysiwyg_pdf Tableau de bord rendu sous forme de tuile pour produire un document PDF
PDF assemblé Tableau de bord avec une seule colonne pour produire un document PDF
wysiwyg Tableau de bord mis en page en mosaïque pour générer une image PNG

Les formats valides varient selon le type de destination et l'objet source. wysiwyg_pdf n'est valide que pour les tableaux de bord, par exemple.

Demande

POST /schedule_plans
Type de données
Description
Demande
HTTPRequest
body
Corps HTTP
Développer la définition HTTPBody...
body
Forfait planifié
Développer la définition du planning planifié...
name
string
Nom de ce plan planifié
user_id
integer
ID utilisateur auquel appartient ce forfait planifié
exécution en tant que destinataire
booléen
Si la planification est exécutée en tant que destinataire (s'applique uniquement aux destinataires de l'e-mail)
activé
booléen
Si l'option "Plan planifié" est activée
id_look
integer
ID d'un style
id_tableau_de_bord
integer
ID d'un tableau de bord
id_tableaudetableau_de_lookml
string
ID d'un tableau de bord LookML
chaîne_filtres
string
Chaîne de requête avec laquelle exécuter l'apparence ou le tableau de bord
tableaux_de_filtres
string
(OBSOLÈTE) Alias du champ "filter_string"
nécessite_résultats
booléen
La diffusion doit avoir lieu si l'exécution du tableau de bord ou l'apparence renvoie des résultats
nécessite_aucun_résultats
booléen
La diffusion doit avoir lieu si le tableau de bord ne renvoie pas de résultats
Exiger_modifier
booléen
La diffusion devrait avoir lieu si les données ont changé depuis la dernière exécution
envoyer_tous_résultats
booléen
Exécute une requête illimitée et envoie tous les résultats.
Croncrontab
string
Spécification crontab de style Vixie lors de l'exécution
groupe de données
string
Nom d'un groupe de données ; s'il est spécifié, il s'exécute lorsque le groupe de données est déclenché (il ne peut pas être utilisé avec une chaîne Cron).
fuseau horaire
string
Fuseau horaire pour l'interprétation du crontab spécifié (par défaut, le fuseau horaire de l'instance Looker).
id_requête
string
ID de la requête
destination_plan_planifié
course à pied une fois
booléen
Indique si le plan en question ne doit être exécuté qu'une seule fois (généralement pour les tests).
Inclure les liens
booléen
Indique si les liens vers Looker doivent être inclus dans ce plan planifié
base_url_personnalisée
string
Domaine d'URL personnalisée pour l'entité programmée
custom_url_params (paramètres d'URL personnalisés)
string
Chemin de l'URL personnalisée et paramètres pour l'entité programmée
libellé_url_personnalisée
string
Libellé d'URL personnalisée pour l'entité programmée
afficher_url_personnalisée
booléen
Indique s'il faut afficher le lien personnalisé en lieu et place du lien standard
Taille du papier au format PDF
string
Format de papier du PDF. Les valeurs valides sont "letter", "legal", "tabloid", "a0", "a1", "a2", "a3", "a4" et "a5".
paysage PDF
booléen
Indique si le PDF doit être au format paysage
incorporation
booléen
Indique si cette programmation est intégrée ou non
thème_couleur
string
Jeu de couleurs du tableau de bord, le cas échéant
tables_longues
booléen
Indique si la table doit être affichée en entier
inline_table_width
integer
Largeur de pixel à laquelle les visualisations du tableau intégré sont affichées
id
integer
Identifiant unique
créé le
string
Date et heure de création de SchedulePlan
mis à jour le
string
Date et heure de la dernière mise à jour de SchedulingPlan.
title
string
Titre
user
Utilisateur propriétaire de ce plan planifié
Prochaine course
string
Date d'exécution du plan planifié (null s'il s'exécute une fois)
Dernière exécution
string
Date de la dernière exécution du plan planifié
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet

Réponse

200: Plan planifié

Type de données
Description
(objet)
name
string
Nom de ce plan planifié
user_id
integer
ID utilisateur auquel appartient ce forfait planifié
exécution en tant que destinataire
booléen
Si la planification est exécutée en tant que destinataire (s'applique uniquement aux destinataires de l'e-mail)
activé
booléen
Si l'option "Plan planifié" est activée
id_look
integer
ID d'un style
id_tableau_de_bord
integer
ID d'un tableau de bord
id_tableaudetableau_de_lookml
string
ID d'un tableau de bord LookML
chaîne_filtres
string
Chaîne de requête avec laquelle exécuter l'apparence ou le tableau de bord
tableaux_de_filtres
string
(OBSOLÈTE) Alias du champ "filter_string"
nécessite_résultats
booléen
La diffusion doit avoir lieu si l'exécution du tableau de bord ou l'apparence renvoie des résultats
nécessite_aucun_résultats
booléen
La diffusion doit avoir lieu si le tableau de bord ne renvoie pas de résultats
Exiger_modifier
booléen
La diffusion devrait avoir lieu si les données ont changé depuis la dernière exécution
envoyer_tous_résultats
booléen
Exécute une requête illimitée et envoie tous les résultats.
Croncrontab
string
Spécification crontab de style Vixie lors de l'exécution
groupe de données
string
Nom d'un groupe de données ; s'il est spécifié, il s'exécute lorsque le groupe de données est déclenché (il ne peut pas être utilisé avec une chaîne Cron).
fuseau horaire
string
Fuseau horaire pour l'interprétation du crontab spécifié (par défaut, le fuseau horaire de l'instance Looker).
id_requête
string
ID de la requête
destination_plan_planifié
Développer la définition de SchedulingPlanDestination...
id
integer
Identifiant unique
id_plan_planifié
integer
ID d'un forfait planifié que vous possédez
format
string
Format de données à envoyer à la destination donnée. Les formats acceptés varient selon la destination, mais incluent les éléments suivants: "txt", "csv", "inline_json", "json", "json_detail", "xlsx", "html", "wysiwyg_pdf", "assemblyd_pdf" et "wysiwyg_png"
Appliquer le format
booléen
Les valeurs sont-elles formatées ? (contenant des symboles de devise, des séparateurs numériques, etc.)
appliquer_vis
booléen
Indique si les options de visualisation sont appliquées aux résultats.
address
string
Adresse du destinataire. Pour les e-mails, par exemple "utilisateur@example.com". Pour les webhooks, par exemple "https://examle.domain/path". Pour Amazon S3, par exemple "s3://nom-bucket/chemin/". Pour SFTP (par exemple, "sftp://nom-hôte/chemin/").
looker_recipient
booléen
Indique si le destinataire est un utilisateur Looker sur l'instance actuelle (applicable uniquement aux destinataires de l'e-mail)
type
string
Type d'adresse ("email", "webhook", "s3" ou "sftp")
paramètres
string
Objet JSON contenant des paramètres de planification externe. Pour Amazon S3, cela nécessite des clés et des valeurs pour access_key_id et region. Pour SFTP, vous devez saisir une clé et une valeur pour le nom d'utilisateur.
paramètres_secrets
string
(Écriture seule) Objet JSON contenant des paramètres secrets pour la planification externe. Pour Amazon S3, cela nécessite une clé et une valeur pour secret_access_key. Pour SFTP, vous devez saisir une clé et une valeur pour le mot de passe.
Message
string
Message facultatif à inclure dans les e-mails planifiés
course à pied une fois
booléen
Indique si le plan en question ne doit être exécuté qu'une seule fois (généralement pour les tests).
Inclure les liens
booléen
Indique si les liens vers Looker doivent être inclus dans ce plan planifié
base_url_personnalisée
string
Domaine d'URL personnalisée pour l'entité programmée
custom_url_params (paramètres d'URL personnalisés)
string
Chemin de l'URL personnalisée et paramètres pour l'entité programmée
libellé_url_personnalisée
string
Libellé d'URL personnalisée pour l'entité programmée
afficher_url_personnalisée
booléen
Indique s'il faut afficher le lien personnalisé en lieu et place du lien standard
Taille du papier au format PDF
string
Format de papier du PDF. Les valeurs valides sont "letter", "legal", "tabloid", "a0", "a1", "a2", "a3", "a4" et "a5".
paysage PDF
booléen
Indique si le PDF doit être au format paysage
incorporation
booléen
Indique si cette programmation est intégrée ou non
thème_couleur
string
Jeu de couleurs du tableau de bord, le cas échéant
tables_longues
booléen
Indique si la table doit être affichée en entier
inline_table_width
integer
Largeur de pixel à laquelle les visualisations du tableau intégré sont affichées
id
integer
Identifiant unique
créé le
string
Date et heure de création de SchedulePlan
mis à jour le
string
Date et heure de la dernière mise à jour de SchedulingPlan.
title
string
Titre
user
Utilisateur propriétaire de ce plan planifié
Développer la définition UserPublic...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
integer
Identifiant unique
first_name
string
Prénom
last_name
string
Nom
display_name
string
Nom complet à afficher (disponible uniquement si prénom et nom)
avatar
string
URL de l'avatar (peut être générique)
url
string
Lien pour obtenir cet élément
Prochaine course
string
Date d'exécution du plan planifié (null s'il s'exécute une fois)
Dernière exécution
string
Date de la dernière exécution du plan planifié
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet

400 Bad Request

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

404: introuvable

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

409: La ressource existe déjà

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

422: Erreur de validation

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
Développer la définition de ValidationErrorDetail...
champ
string
Champ comportant une erreur
code
string
Code d'erreur
Message
string
Message d'information sur l'erreur
documentation_url
string
Lien vers la documentation
documentation_url
string
Lien vers la documentation

429 : Too Many Requests

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

Examples