Data Studio Service

Data Studio

Ce service permet aux scripts d'accéder aux connecteurs de la communauté Data Studio et de les modifier.

Classes

NomBrève description
AggregationTypeÉnumération qui définit les types d'agrégation pouvant être définis pour un Field.
AuthTypeÉnumération qui définit les types d'authentification pouvant être définis pour un connecteur.
BigQueryConfigObjet de configuration pour un connecteur BigQuery natif.
BigQueryParameterTypeÉnumération qui définit les types de paramètres BigQuery que vous pouvez définir.
CheckboxContient des informations sur les cases à cocher pour la configuration.
CommunityConnectorCommunityConnector permet aux scripts d'accéder aux outils de création et aux utilitaires pour faciliter le développement de connecteurs de communauté pour Data Studio.
ConfigContient les entrées de configuration d'un connecteur.
DataStudioAppDataStudioApp permet aux scripts d'interagir avec les fonctionnalités de Data Studio destinées aux développeurs.
DebugErrorErreur visible uniquement par les administrateurs du connecteur.
FieldContient des données liées aux champs.
FieldTypeÉnumération qui définit les types pouvant être définis pour un Field.
FieldsContient un ensemble de Field pour un connecteur de communauté.
GetAuthTypeResponseCompilateur permettant de créer une réponse getAuthType() pour votre projet de script.
GetDataResponseCompilateur permettant de créer une réponse getData() pour votre projet de script.
GetSchemaResponseCompilateur permettant de créer une réponse getSchema() pour votre projet de script.
InfoContient les données d'informations pour la configuration.
OptionBuilderCompilateur permettant de créer des options pour les SelectSingle et les SelectMultiple.
SelectMultipleContient des informations de sélection multiple pour la configuration.
SelectSingleContient certaines informations uniques pour la configuration.
SetCredentialsResponseCompilateur permettant de créer une réponse setCredentials() pour votre projet de script.
TextAreaContient les informations de la zone de texte pour la configuration.
TextInputContient les informations de saisie de texte pour la configuration.
UserErrorErreur affichée aux utilisateurs du connecteur.

AggregationType

Propriétés

PropriétéTypeDescription
AVGEnumMoyenne.
COUNTEnumNombre.
COUNT_DISTINCTEnumValeurs distinctes.
MAXEnumMax.
MINEnumMin.
SUMEnumSomme.
AUTOEnumAuto

AuthType

Propriétés

PropriétéTypeDescription
NONEEnumAucune autorisation n'est requise.
OAUTH2EnumAutorisation OAuth2 requise.
USER_PASSEnumVous devez fournir un nom d'utilisateur et un mot de passe.
PATH_USER_PASSEnumNom d'utilisateur, chemin d'accès et mot de passe requis.
PATH_KEYEnumVeuillez indiquer le chemin d'accès et la clé.
KEYEnumClé ou jeton API requis.
USER_TOKENEnumNom d'utilisateur et jeton requis.

BigQueryConfig

Méthodes

MéthodeType renvoyéBrève description
addQueryParameter(name, type, value)BigQueryConfigAjoute un paramètre de requête à ce BigQueryConfig.
build()ObjectValide cet objet et le renvoie au format requis par Data Studio.
printJson()StringAffiche la représentation JSON de cet objet.
setAccessToken(accessToken)BigQueryConfigDéfinit le jeton d'accès de ce BigQueryConfig.
setBillingProjectId(billingProjectId)BigQueryConfigDéfinit l'ID du projet de facturation de ce BigQueryConfig.
setQuery(query)BigQueryConfigDéfinit la requête SQL de ce BigQueryConfig.
setUseStandardSql(useStandardSql)BigQueryConfigDétermine si la requête est interprétée comme du SQL standard ou ancien.

BigQueryParameterType

Propriétés

PropriétéTypeDescription
STRINGEnumChaîne.
INT64EnumEntier de 64 bits.
BOOLEnumValeur booléenne.
FLOAT64EnumNombre à virgule flottante de 64 bits.

Checkbox

Méthodes

MéthodeType renvoyéBrève description
setAllowOverride(allowOverride)CheckboxPermet de remplacer cette entrée de configuration.
setHelpText(helpText)CheckboxDéfinit le texte d'aide pour cette entrée de configuration.
setId(id)CheckboxDéfinit l'ID unique de cette entrée de configuration.
setIsDynamic(isDynamic)CheckboxDéfinit l'état dynamique de cette entrée de configuration.
setName(name)CheckboxDéfinit le nom à afficher pour cette entrée de configuration.

CommunityConnector

Propriétés

PropriétéTypeDescription
AggregationTypeAggregationTypeÉnumération AggregationType.
AuthTypeAuthTypeÉnumération AuthType.
BigQueryParameterTypeBigQueryParameterTypeÉnumération BigQueryParameterType.
FieldTypeFieldTypeÉnumération FieldType.

Méthodes

MéthodeType renvoyéBrève description
getConfig()ConfigRenvoie un objet Config.
getFields()FieldsRenvoie un objet Fields.
newAuthTypeResponse()GetAuthTypeResponseRenvoie un nouvel objet GetAuthTypeResponse.
newBigQueryConfig()BigQueryConfigRenvoie un nouvel objet BigQueryConfig.
newDebugError()DebugErrorRenvoie un nouvel objet DebugError.
newGetDataResponse()GetDataResponseRenvoie un nouvel objet GetDataResponse.
newGetSchemaResponse()GetSchemaResponseRenvoie un nouvel objet GetSchemaResponse.
newSetCredentialsResponse()SetCredentialsResponseRenvoie un nouvel objet SetCredentialsResponse.
newUserError()UserErrorRenvoie un nouvel objet UserError.

Config

Méthodes

MéthodeType renvoyéBrève description
build()ObjectValide cet objet et le renvoie au format requis par Data Studio.
newCheckbox()CheckboxRenvoie une nouvelle entrée de configuration de case à cocher.
newInfo()InfoRenvoie une nouvelle entrée de configuration d'informations.
newOptionBuilder()OptionBuilderRenvoie un nouveau compilateur d'options.
newSelectMultiple()SelectMultipleRenvoie une nouvelle entrée de configuration à sélection multiple.
newSelectSingle()SelectSingleRenvoie une nouvelle entrée de configuration à sélection unique.
newTextArea()TextAreaRenvoie une nouvelle entrée de configuration de zone de texte.
newTextInput()TextInputRenvoie une nouvelle entrée de configuration d'entrée de texte.
printJson()StringAffiche la représentation JSON de cet objet.
setDateRangeRequired(dateRangeRequired)ConfigSi la valeur est true, une plage de dates est fournie pour les requêtes getData().
setIsSteppedConfig(isSteppedConfig)ConfigSi true, getConfig() est appelé à nouveau avec la configuration utilisateur actuelle.

DataStudioApp

Méthodes

MéthodeType renvoyéBrève description
createCommunityConnector()CommunityConnectorCrée un connecteur de communauté.

DebugError

Méthodes

MéthodeType renvoyéBrève description
printJson()StringAffiche la représentation JSON de cet objet.
setText(text)DebugErrorDéfinit le texte de l'erreur de débogage, qui n'est affiché qu'aux administrateurs.
throwException()voidDéclenche la génération de cette exception.

Field

Méthodes

MéthodeType renvoyéBrève description
getAggregation()AggregationTypeRenvoie le AggregationType de cette Field.
getDescription()StringRenvoie la description de cet objet Field.
getFormula()StringRenvoie la formule de cet objet Field.
getGroup()StringRenvoie le groupe de cet objet Field.
getId()StringRenvoie l'ID de cet objet Field.
getIsReaggregatable()BooleanRenvoie true si ce champ peut être réagrégé, ou false dans le cas contraire.
getName()StringRenvoie le nom de cet objet Field.
getType()FieldTypeRenvoie le FieldType de cette Field.
isDefault()BooleanRenvoie true si ce Field est la métrique ou la dimension par défaut.
isDimension()BooleanRenvoie true si ce champ est une dimension.
isHidden()BooleanRenvoie true si ce Field est masqué.
isMetric()BooleanRenvoie true si ce champ est une métrique.
setAggregation(aggregation)FieldDéfinit le type d'agrégation de ce Field.
setDescription(description)FieldDéfinit la description de ce Field.
setFormula(formula)FieldDéfinit la formule de cette Field.
setGroup(group)FieldDéfinit le groupe de ce Field.
setId(id)FieldDéfinit l'ID de ce Field.
setIsHidden(isHidden)FieldDéfinit l'état masqué de cet Field.
setIsReaggregatable(isReaggregatable)FieldDéfinit l'état d'agrégation autorisée pour un Field.
setName(name)FieldDéfinit le nom de cet objet Field.
setType(type)FieldDéfinit le FieldType de ce Field.

FieldType

Propriétés

PropriétéTypeDescription
YEAREnumAnnée au format AAAA, par exemple 2017.
YEAR_QUARTEREnumAnnée et trimestre au format AAAAT (par exemple, 20171).
YEAR_MONTHEnumAnnée et mois au format AAAAMM, par exemple 201703.
YEAR_WEEKEnumAnnée et semaine au format AAAAww, par exemple 201707.
YEAR_MONTH_DAYEnumAnnée, mois et jour au format AAAAMMJJ, par exemple 20170317.
YEAR_MONTH_DAY_HOUREnumAnnée, mois, jour et heure au format AAAAMMJJHH, par exemple 2017031703.
YEAR_MONTH_DAY_MINUTEEnumAnnée, mois, jour, heure et minute au format AAAAMMJJHHmm, par exemple 201703170230.
YEAR_MONTH_DAY_SECONDEnumAnnée, mois, jour, heure, minute et seconde au format AAAAMMJJHHmmss, par exemple 20170317023017.
QUARTEREnumTrimestre au format 1, 2, 3 ou 4.
MONTHEnumMois au format MM, par exemple "03".
WEEKEnumSemaine au format "ww", par exemple "07".
MONTH_DAYEnumMois et jour au format MMJJ, par exemple 0317.
DAY_OF_WEEKEnumNombre compris entre 0 et 6,où 0 correspond au dimanche.
DAYEnumJour au format JJ, par exemple "17".
HOUREnumHeure au format HH, par exemple 13.
MINUTEEnumMinute au format mm, par exemple "12".
DURATIONEnumDurée en secondes.
COUNTRYEnumUn pays, comme les États-Unis.
COUNTRY_CODEEnumCode pays, tel que "US".
CONTINENTEnumUn continent, comme les Amériques.
CONTINENT_CODEEnumUn code de continent, tel que 019.
SUB_CONTINENTEnumUn sous-continent tel que l'Amérique du Nord.
SUB_CONTINENT_CODEEnumCode de sous-continent, par exemple "003".
REGIONEnumUne région telle que la Californie.
REGION_CODEEnumUn code de région, tel que CA.
CITYEnumUne ville comme Mountain View.
CITY_CODEEnumUn code de ville, tel que 1014044.
METROEnumUne zone métropolitaine, comme San Francisco-Oakland-San Jose CA.
METRO_CODEEnumUn code d'agglomération, par exemple 200807.
LATITUDE_LONGITUDEEnumPaire de latitude et de longitude, par exemple 51.5074, -0.1278.
NUMBEREnumNombre décimal.
PERCENTEnumPourcentage décimal (peut être supérieur à 1,0).
TEXTEnumTexte au format libre.
BOOLEANEnumValeur booléenne true ou false.
URLEnumURL sous forme de texte, par exemple https://google.com.
HYPERLINKEnumUn lien hypertexte.
IMAGEEnumImage.
IMAGE_LINKEnumUn lien image.
CURRENCY_AEDEnumDevise : AED
CURRENCY_ALLEnumDevise de ALL.
CURRENCY_ARSEnumDevise : ARS
CURRENCY_AUDEnumDevise : AUD
CURRENCY_BDTEnumDevise : BDT
CURRENCY_BGNEnumDevise : BGN
CURRENCY_BOBEnumDevise de BOB.
CURRENCY_BRLEnumDevise autre que le réal brésilien
CURRENCY_CADEnumDevise à partir du CAD.
CURRENCY_CDFEnumDevise du CDF.
CURRENCY_CHFEnumDevise : CHF
CURRENCY_CLPEnumDevise : CLP
CURRENCY_CNYEnumDevise à partir du CNY.
CURRENCY_COPEnumDevise à partir de COP.
CURRENCY_CRCEnumDevise du compte CRC.
CURRENCY_CZKEnumDevise à partir de CZK.
CURRENCY_DKKEnumDevise : DKK.
CURRENCY_DOPEnumDevise du DOP.
CURRENCY_EGPEnumDevise : EGP
CURRENCY_ETBEnumDevise : ETB.
CURRENCY_EUREnumDevise à partir de l'EUR.
CURRENCY_GBPEnumDevise : GBP
CURRENCY_HKDEnumDevise à partir de HKD.
CURRENCY_HRKEnumDevise à partir de HRK.
CURRENCY_HUFEnumDevise à partir de HUF.
CURRENCY_IDREnumDevise à partir de l'IDR.
CURRENCY_ILSEnumDevise à partir de ILS.
CURRENCY_INREnumDevise à partir de l'INR.
CURRENCY_IRREnumDevise du revenu annuel récurrent.
CURRENCY_ISKEnumDevise : ISK
CURRENCY_JMDEnumDevise de JMD.
CURRENCY_JPYEnumDevise à partir de JPY.
CURRENCY_KRWEnumDevise : KRW.
CURRENCY_LKREnumDevise : LKR
CURRENCY_LTLEnumDevise de LTL.
CURRENCY_MNTEnumDevise de MNT.
CURRENCY_MVREnumDevise de la MVR.
CURRENCY_MXNEnumDevise : MXN.
CURRENCY_MYREnumDevise : MYR
CURRENCY_NGNEnumDevise : NGN
CURRENCY_NOKEnumDevise NOK.
CURRENCY_NZDEnumDevise : NZD
CURRENCY_PABEnumDevise de PAB.
CURRENCY_PENEnumDevise : PEN
CURRENCY_PHPEnumDevise de PHP.
CURRENCY_PKREnumDevise : PKR
CURRENCY_PLNEnumDevise : PLN
CURRENCY_RONEnumDevise : RON
CURRENCY_RSDEnumDevise : RSD
CURRENCY_RUBEnumDevise : RUB
CURRENCY_SAREnumDevise : SAR
CURRENCY_SEKEnumDevise : SEK
CURRENCY_SGDEnumDevise à partir de SGD.
CURRENCY_THBEnumDevise : THB
CURRENCY_TRYEnumDevise à partir de TRY.
CURRENCY_TWDEnumDevise : TWD
CURRENCY_TZSEnumDevise : TZS
CURRENCY_UAHEnumDevise : UAH
CURRENCY_USDEnumDevise autre que l'USD.
CURRENCY_UYUEnumDevise : UYU
CURRENCY_VEFEnumDevise de la VEF.
CURRENCY_VNDEnumDevise : VND
CURRENCY_YEREnumDevise : YER
CURRENCY_ZAREnumDevise : ZAR

Fields

Méthodes

MéthodeType renvoyéBrève description
asArray()Field[]Renvoie une vue de cet objet sous forme de tableau.
build()Object[]Valide cet objet et le renvoie au format requis par Data Studio.
forIds(ids)FieldsRenvoie un nouvel objet Fields filtré sur les Field dont l'ID figure dans ids.
getDefaultDimension()FieldRenvoie la dimension par défaut à utiliser pour l'ensemble des champs.
getDefaultMetric()FieldRenvoie la métrique par défaut à utiliser pour l'ensemble des champs.
getFieldById(fieldId)FieldRenvoie un champ avec un ID donné, ou null si aucun champ avec cet ID ne se trouve dans cet objet Fields.
newDimension()FieldRenvoie une nouvelle dimension Field.
newMetric()FieldRenvoie une nouvelle métrique Field.
setDefaultDimension(fieldId)voidDéfinit la dimension par défaut à utiliser pour l'ensemble de champs.
setDefaultMetric(fieldId)voidDéfinit la métrique par défaut à utiliser pour l'ensemble de champs.

GetAuthTypeResponse

Méthodes

MéthodeType renvoyéBrève description
build()ObjectValide cet objet et le renvoie au format requis par Data Studio.
printJson()StringAffiche la représentation JSON de cet objet.
setAuthType(authType)GetAuthTypeResponseDéfinit le AuthType du compilateur.
setHelpUrl(helpUrl)GetAuthTypeResponseDéfinit l'URL d'aide du compilateur.

GetDataResponse

Méthodes

MéthodeType renvoyéBrève description
addAllRows(rows)GetDataResponseAjoute plusieurs lignes de données à ce GetDataResponse.
addRow(row)GetDataResponseAjoute une ligne de données à ce GetDataResponse.
build()ObjectValide cet objet et le renvoie au format requis par Data Studio.
setFields(fields)GetDataResponseDéfinit le Fields du compilateur.
setFiltersApplied(filtersApplied)GetDataResponseDéfinit l'état des filtres appliqués pour ce générateur.

GetSchemaResponse

Méthodes

MéthodeType renvoyéBrève description
build()ObjectValide cet objet et le renvoie au format requis par Data Studio.
printJson()StringAffiche la représentation JSON de cet objet.
setFields(fields)GetSchemaResponseDéfinit le Fields du compilateur.

Info

Méthodes

MéthodeType renvoyéBrève description
setId(id)InfoDéfinit l'ID unique de cette entrée de configuration.
setText(text)InfoDéfinit le texte de cette entrée de configuration.

OptionBuilder

Méthodes

MéthodeType renvoyéBrève description
setLabel(label)OptionBuilderDéfinit le libellé de ce générateur d'options.
setValue(value)OptionBuilderDéfinit la valeur de ce générateur d'options.

SelectMultiple

Méthodes

MéthodeType renvoyéBrève description
addOption(optionBuilder)SelectMultipleAjoute une option de sélection.
setAllowOverride(allowOverride)SelectMultiplePermet de remplacer cette entrée de configuration.
setHelpText(helpText)SelectMultipleDéfinit le texte d'aide pour cette entrée de configuration.
setId(id)SelectMultipleDéfinit l'ID unique de cette entrée de configuration.
setIsDynamic(isDynamic)SelectMultipleDéfinit l'état dynamique de cette entrée de configuration.
setName(name)SelectMultipleDéfinit le nom à afficher pour cette entrée de configuration.

SelectSingle

Méthodes

MéthodeType renvoyéBrève description
addOption(optionBuilder)SelectSingleAjoute une option de sélection.
setAllowOverride(allowOverride)SelectSinglePermet de remplacer cette entrée de configuration.
setHelpText(helpText)SelectSingleDéfinit le texte d'aide pour cette entrée de configuration.
setId(id)SelectSingleDéfinit l'ID unique de cette entrée de configuration.
setIsDynamic(isDynamic)SelectSingleDéfinit l'état dynamique de cette entrée de configuration.
setName(name)SelectSingleDéfinit le nom à afficher pour cette entrée de configuration.

SetCredentialsResponse

Méthodes

MéthodeType renvoyéBrève description
build()ObjectValide cet objet et le renvoie au format requis par Data Studio.
printJson()StringAffiche la représentation JSON de cet objet.
setIsValid(isValid)SetCredentialsResponseDéfinit l'état valide de cet objet SetCredentialsResponse.

TextArea

Méthodes

MéthodeType renvoyéBrève description
setAllowOverride(allowOverride)TextAreaPermet de remplacer cette entrée de configuration.
setHelpText(helpText)TextAreaDéfinit le texte d'aide pour cette entrée de configuration.
setId(id)TextAreaDéfinit l'ID unique de cette entrée de configuration.
setIsDynamic(isDynamic)TextAreaDéfinit l'état dynamique de cette entrée de configuration.
setName(name)TextAreaDéfinit le nom à afficher pour cette entrée de configuration.
setPlaceholder(placeholder)TextAreaDéfinit le texte d'espace réservé pour cette entrée de configuration.

TextInput

Méthodes

MéthodeType renvoyéBrève description
setAllowOverride(allowOverride)TextInputPermet de remplacer cette entrée de configuration.
setHelpText(helpText)TextInputDéfinit le texte d'aide pour cette entrée de configuration.
setId(id)TextInputDéfinit l'ID unique de cette entrée de configuration.
setIsDynamic(isDynamic)TextInputDéfinit l'état dynamique de cette entrée de configuration.
setName(name)TextInputDéfinit le nom à afficher pour cette entrée de configuration.
setPlaceholder(placeholder)TextInputDéfinit le texte d'espace réservé pour cette entrée de configuration.

UserError

Méthodes

MéthodeType renvoyéBrève description
printJson()StringAffiche la représentation JSON de cet objet.
setDebugText(text)UserErrorDéfinit le texte de l'erreur de débogage, qui n'est affiché qu'aux administrateurs.
setText(text)UserErrorDéfinit le texte de l'erreur utilisateur.
throwException()voidDéclenche la génération de cette exception.