Data Studio Service

Data Studio

Esse serviço permite que os scripts acessem e modifiquem os conectores da comunidade do Data Studio.

Aulas

NomeBreve descrição
AggregationTypeUm tipo enumerado que define os tipos de agregação que podem ser definidos para uma Field.
AuthTypeUm enum que define os tipos de autenticação que podem ser configurados para um conector.
BigQueryConfigUm objeto de configuração para um conector nativo do BigQuery.
BigQueryParameterTypeUm enum que define os tipos de parâmetro do BigQuery que você pode definir.
CheckboxContém informações da caixa de seleção para a configuração.
CommunityConnectorO CommunityConnector permite que os scripts acessem criadores e utilitários para ajudar no desenvolvimento de conectores da comunidade para o Data Studio.
ConfigContém as entradas de configuração de um conector.
DataStudioAppO DataStudioApp permite que os scripts interajam com recursos voltados para desenvolvedores do Data Studio.
DebugErrorUm erro que é visível apenas para os administradores do conector.
FieldContém dados relacionados ao campo.
FieldTypeUm tipo enumerado que define os tipos que podem ser definidos para uma Field.
FieldsContém um conjunto de Fields para um conector da comunidade.
GetAuthTypeResponseBuilder para criar uma resposta getAuthType() para seu projeto de script.
GetDataResponseBuilder para criar uma resposta getData() para seu projeto de script.
GetSchemaResponseBuilder para criar uma resposta getSchema() para seu projeto de script.
InfoContém dados de informações para a configuração.
OptionBuilderUm builder para criar opções para SelectSingles e SelectMultiples.
SelectMultipleContém várias informações selecionadas para a configuração.
SelectSingleContém informações únicas selecionadas para a configuração.
SetCredentialsResponseBuilder para criar uma resposta setCredentials() para seu projeto de script.
TextAreaContém informações sobre a área de texto para a configuração.
TextInputContém informações de entrada de texto para a configuração.
UserErrorErro exibido aos usuários do conector.

AggregationType

Propriedades

PropriedadeTipoDescrição
AVGEnumNa média.
COUNTEnumContagem.
COUNT_DISTINCTEnumContar diferentes.
MAXEnum% máx.
MINEnumMín.
SUMEnumSoma.
AUTOEnumAutomático.

AuthType

Propriedades

PropriedadeTipoDescrição
NONEEnumNenhuma autorização é necessária.
OAUTH2EnumAutorização do OAuth2 necessária.
USER_PASSEnumAs credenciais de nome de usuário e senha são necessárias.
PATH_USER_PASSEnumNome de usuário, caminho e senha necessários.
PATH_KEYEnumO caminho e a chave são necessários.
KEYEnumToken de API ou chave de API necessário.
USER_TOKENEnumNome de usuário e token necessários.

BigQueryConfig

Métodos

MétodoTipo de retornoBreve descrição
addQueryParameter(name, type, value)BigQueryConfigAdiciona um parâmetro de consulta a essa BigQueryConfig.
build()ObjectValida esse objeto e o retorna no formato exigido pelo Data Studio.
printJson()StringMostra a representação JSON desse objeto.
setAccessToken(accessToken)BigQueryConfigDefine o token de acesso desse BigQueryConfig.
setBillingProjectId(billingProjectId)BigQueryConfigDefine o ID do projeto de faturamento deste BigQueryConfig.
setQuery(query)BigQueryConfigDefine a consulta SQL desse BigQueryConfig.
setUseStandardSql(useStandardSql)BigQueryConfigDetermina se a consulta é interpretada como SQL padrão ou legado.

BigQueryParameterType

Propriedades

PropriedadeTipoDescrição
STRINGEnumString.
INT64EnumNúmero inteiro de 64 bits.
BOOLEnumBooleano.
FLOAT64EnumNúmero de ponto flutuante de 64 bits.

Checkbox

Métodos

MétodoTipo de retornoBreve descrição
setAllowOverride(allowOverride)CheckboxAtiva a substituição dessa entrada de configuração.
setHelpText(helpText)CheckboxDefine o texto de ajuda para essa entrada de configuração.
setId(id)CheckboxDefine o ID exclusivo dessa entrada de configuração.
setIsDynamic(isDynamic)CheckboxDefine o status dinâmico dessa entrada de configuração.
setName(name)CheckboxDefine o nome de exibição desta entrada de configuração.

CommunityConnector

Propriedades

PropriedadeTipoDescrição
AggregationTypeAggregationTypeA enumeração AggregationType.
AuthTypeAuthTypeA enumeração AuthType.
BigQueryParameterTypeBigQueryParameterTypeA enumeração BigQueryParameterType.
FieldTypeFieldTypeA enumeração FieldType.

Métodos

MétodoTipo de retornoBreve descrição
getConfig()ConfigRetorna um objeto Config.
getFields()FieldsRetorna um objeto Fields.
newAuthTypeResponse()GetAuthTypeResponseRetorna um novo objeto GetAuthTypeResponse.
newBigQueryConfig()BigQueryConfigRetorna um novo objeto BigQueryConfig.
newDebugError()DebugErrorRetorna um novo objeto DebugError.
newGetDataResponse()GetDataResponseRetorna um novo objeto GetDataResponse.
newGetSchemaResponse()GetSchemaResponseRetorna um novo objeto GetSchemaResponse.
newSetCredentialsResponse()SetCredentialsResponseRetorna um novo objeto SetCredentialsResponse.
newUserError()UserErrorRetorna um novo objeto UserError.

Config

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida esse objeto e o retorna no formato exigido pelo Data Studio.
newCheckbox()CheckboxRetorna uma nova entrada de configuração da caixa de seleção.
newInfo()InfoRetorna uma nova entrada de configuração de informações.
newOptionBuilder()OptionBuilderRetorna um novo criador de opções.
newSelectMultiple()SelectMultipleRetorna uma nova entrada para selecionar várias configurações.
newSelectSingle()SelectSingleRetorna uma nova entrada de configuração única selecionada.
newTextArea()TextAreaRetorna uma nova entrada de configuração de área de texto.
newTextInput()TextInputRetorna uma nova entrada de configuração de entrada de texto.
printJson()StringMostra a representação JSON desse objeto.
setDateRangeRequired(dateRangeRequired)ConfigSe for true, um período será fornecido para solicitações getData().
setIsSteppedConfig(isSteppedConfig)ConfigSe true, getConfig() será chamado novamente com a configuração atual do usuário.

DataStudioApp

Métodos

MétodoTipo de retornoBreve descrição
createCommunityConnector()CommunityConnectorCria um novo conector da comunidade.

DebugError

Métodos

MétodoTipo de retornoBreve descrição
printJson()StringMostra a representação JSON desse objeto.
setText(text)DebugErrorDefine o texto do erro de depuração, que é mostrado apenas aos administradores.
throwException()voidAciona o lançamento dessa exceção.

Field

Métodos

MétodoTipo de retornoBreve descrição
getAggregation()AggregationTypeRetorna o AggregationType desse Field.
getDescription()StringRetorna a descrição desse Field.
getFormula()StringRetorna a fórmula desse Field.
getGroup()StringRetorna o grupo desse Field.
getId()StringRetorna o ID desse Field.
getIsReaggregatable()BooleanRetornará true se o campo puder ser reagregado. Caso contrário, retornará false.
getName()StringRetorna o nome deste Field.
getType()FieldTypeRetorna o FieldType desse Field.
isDefault()BooleanRetorna true se esse Field for a métrica ou dimensão padrão.
isDimension()BooleanRetorna true se esse campo for uma dimensão.
isHidden()BooleanRetorna true se esse Field estiver oculto.
isMetric()BooleanRetorna true se esse campo for uma métrica.
setAggregation(aggregation)FieldDefine o tipo de agregação dessa Field.
setDescription(description)FieldDefine a descrição desse Field.
setFormula(formula)FieldDefine a fórmula desse Field.
setGroup(group)FieldDefine o grupo desse Field.
setId(id)FieldDefine o ID desse Field.
setIsHidden(isHidden)FieldDefine o status oculto desse Field.
setIsReaggregatable(isReaggregatable)FieldDefine o status permitido de reagregação para um Field.
setName(name)FieldDefine o nome desse Field.
setType(type)FieldDefine o FieldType desse Field.

FieldType

Propriedades

PropriedadeTipoDescrição
YEAREnumAno no formato AAAA, como 2017.
YEAR_QUARTEREnumAno e trimestre no formato AAAAQ, como 20171.
YEAR_MONTHEnumAno e mês no formato AAAAMM, como 201703.
YEAR_WEEKEnumAno e semana no formato de AAAAss, como 201707.
YEAR_MONTH_DAYEnumAno, mês e dia no formato de AAAAMMDD, como 20170317.
YEAR_MONTH_DAY_HOUREnumAno, mês, dia e hora no formato AAAAMMDDHH, como 2017031703.
YEAR_MONTH_DAY_MINUTEEnumAno, mês, dia, hora e minuto no formato AAAAMMDDHHmm, como 201703170230.
YEAR_MONTH_DAY_SECONDEnumAno, mês, dia, hora, minuto e segundo no formato AAAAMMDDHHmmss, como 20170317023017.
QUARTEREnumtrimestre no formato 1, 2, 3 ou 4).
MONTHEnumMês no formato de MM, como 03.
WEEKEnumSemana no formato de WW, como 07.
MONTH_DAYEnumMês e dia no formato MMDD, como 0317.
DAY_OF_WEEKEnumUm número no intervalo de [0,6], com 0 representando domingo.
DAYEnumDia no formato DD, como 17.
HOUREnumHora no formato HH, como 13.
MINUTEEnumMinuto no formato de mm, como 12.
DURATIONEnumUma duração em segundos.
COUNTRYEnumUm país como os Estados Unidos.
COUNTRY_CODEEnumUm código de país, como US.
CONTINENTEnumUm continente como as Américas.
CONTINENT_CODEEnumUm código de continente, como 019.
SUB_CONTINENTEnumUm subcontinente, como a América do Norte.
SUB_CONTINENT_CODEEnumUm código de subcontinente, como 003.
REGIONEnumUma região como a Califórnia.
REGION_CODEEnumUm código de região, como CA.
CITYEnumUma cidade como Mountain View.
CITY_CODEEnumUm código de cidade, como 1014044.
METROEnumUm metrô, como São Francisco-Oakland-San José, CA.
METRO_CODEEnumUm código de área metropolitana, por exemplo, 200807.
LATITUDE_LONGITUDEEnumUm par de latitude e longitude, como 51.5074, -0.1278.
NUMBEREnumUm número decimal.
PERCENTEnumPorcentagem decimal (pode ser maior que 1,0).
TEXTEnumTexto em formato livre.
BOOLEANEnumUm valor booleano true ou false.
URLEnumUm URL, como um texto, como https://google.com.
HYPERLINKEnumUm hiperlink.
IMAGEEnumUma imagem.
IMAGE_LINKEnumUm link de imagem.
CURRENCY_AEDEnumMoeda de AED.
CURRENCY_ALLEnumMoeda de ALL.
CURRENCY_ARSEnumMoeda do ARS.
CURRENCY_AUDEnumMoeda de AUD.
CURRENCY_BDTEnumMoeda de BDT.
CURRENCY_BGNEnumMoeda de BGN.
CURRENCY_BOBEnumMoeda de BOB.
CURRENCY_BRLEnumMoeda de BRL.
CURRENCY_CADEnumMoeda de CAD.
CURRENCY_CDFEnumMoeda da CDF.
CURRENCY_CHFEnumMoeda de CHF.
CURRENCY_CLPEnumMoeda de CLP.
CURRENCY_CNYEnumMoeda de CNY.
CURRENCY_COPEnumMoeda de COP.
CURRENCY_CRCEnumMoeda de CRC.
CURRENCY_CZKEnumMoeda de CZK.
CURRENCY_DKKEnumMoeda de DKK.
CURRENCY_DOPEnumMoeda do DOP.
CURRENCY_EGPEnumMoeda de EGP.
CURRENCY_ETBEnumMoeda do ETB.
CURRENCY_EUREnumMoeda de EUR.
CURRENCY_GBPEnumMoeda em GBP.
CURRENCY_HKDEnumMoeda de HKD.
CURRENCY_HRKEnumMoeda de HRK.
CURRENCY_HUFEnumMoeda de HUF.
CURRENCY_IDREnumMoeda de IDR.
CURRENCY_ILSEnumMoeda de ILS.
CURRENCY_INREnumMoeda de INR.
CURRENCY_IRREnumMoeda da IRR.
CURRENCY_ISKEnumMoeda de ISK.
CURRENCY_JMDEnumMoeda do JMD.
CURRENCY_JPYEnumMoeda de JPY.
CURRENCY_KRWEnumMoeda de KRW.
CURRENCY_LKREnumMoeda de LKR.
CURRENCY_LTLEnumMoeda de LTL.
CURRENCY_MNTEnumMoeda da MNT.
CURRENCY_MVREnumMoeda da MVR.
CURRENCY_MXNEnumMoeda de MXN.
CURRENCY_MYREnumMoeda de MYR.
CURRENCY_NGNEnumMoeda da NGN.
CURRENCY_NOKEnumMoeda de NOK.
CURRENCY_NZDEnumMoeda de NZD.
CURRENCY_PABEnumMoeda do PAB.
CURRENCY_PENEnumMoeda de PEN.
CURRENCY_PHPEnumMoeda de PHP.
CURRENCY_PKREnumMoeda de PKR.
CURRENCY_PLNEnumMoeda de PLN.
CURRENCY_RONEnumMoeda de RON.
CURRENCY_RSDEnumMoeda de RSD.
CURRENCY_RUBEnumMoeda de RUB.
CURRENCY_SAREnumMoeda da SAR.
CURRENCY_SEKEnumMoeda de SEK.
CURRENCY_SGDEnumMoeda em SGD.
CURRENCY_THBEnumMoeda de THB.
CURRENCY_TRYEnumMoeda de TRY.
CURRENCY_TWDEnumMoeda de TWD.
CURRENCY_TZSEnumMoeda de TZS.
CURRENCY_UAHEnumMoeda de UAH.
CURRENCY_USDEnumMoeda de USD.
CURRENCY_UYUEnumMoeda de UYU.
CURRENCY_VEFEnumMoeda de VEF.
CURRENCY_VNDEnumMoeda de VND.
CURRENCY_YEREnumMoeda de YER.
CURRENCY_ZAREnumMoeda de ZAR.

Fields

Métodos

MétodoTipo de retornoBreve descrição
asArray()Field[]Retorna uma visualização do objeto como uma matriz.
build()Object[]Valida esse objeto e o retorna no formato exigido pelo Data Studio.
forIds(ids)FieldsRetorna um novo objeto Fields filtrado para Fields com um ID em ids.
getDefaultDimension()FieldRetorna a dimensão padrão a ser usada para o conjunto de campos.
getDefaultMetric()FieldRetorna a métrica padrão a ser usada para o conjunto de campos.
getFieldById(fieldId)FieldRetorna um campo com um determinado ID ou null se nenhum campo com esse ID estiver nesse objeto Fields.
newDimension()FieldRetorna uma nova dimensão Field.
newMetric()FieldRetorna uma nova métrica Field.
setDefaultDimension(fieldId)voidDefine a dimensão padrão a ser usada para o conjunto de campos.
setDefaultMetric(fieldId)voidDefine a métrica padrão a ser usada para o conjunto de campos.

GetAuthTypeResponse

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida esse objeto e o retorna no formato exigido pelo Data Studio.
printJson()StringMostra a representação JSON desse objeto.
setAuthType(authType)GetAuthTypeResponseDefine o AuthType do builder.
setHelpUrl(helpUrl)GetAuthTypeResponseDefine o URL de ajuda do builder.

GetDataResponse

Métodos

MétodoTipo de retornoBreve descrição
addAllRows(rows)GetDataResponseAdiciona várias linhas de dados a esse GetDataResponse.
addRow(row)GetDataResponseAdiciona uma linha de dados a esse GetDataResponse.
build()ObjectValida esse objeto e o retorna no formato exigido pelo Data Studio.
setFields(fields)GetDataResponseDefine o Fields do builder.
setFiltersApplied(filtersApplied)GetDataResponseDefine o status de aplicação dos filtros para este builder.

GetSchemaResponse

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida esse objeto e o retorna no formato exigido pelo Data Studio.
printJson()StringMostra a representação JSON desse objeto.
setFields(fields)GetSchemaResponseDefine o Fields do builder.

Info

Métodos

MétodoTipo de retornoBreve descrição
setId(id)InfoDefine o ID exclusivo dessa entrada de configuração.
setText(text)InfoDefine o texto para esta entrada de configuração.

OptionBuilder

Métodos

MétodoTipo de retornoBreve descrição
setLabel(label)OptionBuilderDefine o rótulo desse criador de opções.
setValue(value)OptionBuilderDefine o valor desse criador de opções.

SelectMultiple

Métodos

MétodoTipo de retornoBreve descrição
addOption(optionBuilder)SelectMultipleAdiciona uma nova opção de seleção.
setAllowOverride(allowOverride)SelectMultipleAtiva a substituição dessa entrada de configuração.
setHelpText(helpText)SelectMultipleDefine o texto de ajuda para essa entrada de configuração.
setId(id)SelectMultipleDefine o ID exclusivo dessa entrada de configuração.
setIsDynamic(isDynamic)SelectMultipleDefine o status dinâmico dessa entrada de configuração.
setName(name)SelectMultipleDefine o nome de exibição desta entrada de configuração.

SelectSingle

Métodos

MétodoTipo de retornoBreve descrição
addOption(optionBuilder)SelectSingleAdiciona uma nova opção de seleção.
setAllowOverride(allowOverride)SelectSingleAtiva a substituição dessa entrada de configuração.
setHelpText(helpText)SelectSingleDefine o texto de ajuda para essa entrada de configuração.
setId(id)SelectSingleDefine o ID exclusivo dessa entrada de configuração.
setIsDynamic(isDynamic)SelectSingleDefine o status dinâmico dessa entrada de configuração.
setName(name)SelectSingleDefine o nome de exibição desta entrada de configuração.

SetCredentialsResponse

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida esse objeto e o retorna no formato exigido pelo Data Studio.
printJson()StringMostra a representação JSON desse objeto.
setIsValid(isValid)SetCredentialsResponseDefine o status válido desse SetCredentialsResponse.

TextArea

Métodos

MétodoTipo de retornoBreve descrição
setAllowOverride(allowOverride)TextAreaAtiva a substituição dessa entrada de configuração.
setHelpText(helpText)TextAreaDefine o texto de ajuda para essa entrada de configuração.
setId(id)TextAreaDefine o ID exclusivo dessa entrada de configuração.
setIsDynamic(isDynamic)TextAreaDefine o status dinâmico dessa entrada de configuração.
setName(name)TextAreaDefine o nome de exibição desta entrada de configuração.
setPlaceholder(placeholder)TextAreaDefine o texto do espaço reservado para esta entrada de configuração.

TextInput

Métodos

MétodoTipo de retornoBreve descrição
setAllowOverride(allowOverride)TextInputAtiva a substituição dessa entrada de configuração.
setHelpText(helpText)TextInputDefine o texto de ajuda para essa entrada de configuração.
setId(id)TextInputDefine o ID exclusivo dessa entrada de configuração.
setIsDynamic(isDynamic)TextInputDefine o status dinâmico dessa entrada de configuração.
setName(name)TextInputDefine o nome de exibição desta entrada de configuração.
setPlaceholder(placeholder)TextInputDefine o texto do espaço reservado para esta entrada de configuração.

UserError

Métodos

MétodoTipo de retornoBreve descrição
printJson()StringMostra a representação JSON desse objeto.
setDebugText(text)UserErrorDefine o texto do erro de depuração, que é mostrado apenas aos administradores.
setText(text)UserErrorDefine o texto do erro do usuário.
throwException()voidAciona o lançamento dessa exceção.