Data Studio Service

Data Studio

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

Classes

NomeBreve descrição
AggregationTypeUm tipo enumerado que define os tipos de agregação que podem ser definidos para um Field.
AuthTypeUm tipo enumerado que define os tipos de autenticação que podem ser definidos para um conector.
BigQueryConfigUm objeto de configuração para um conector nativo do BigQuery.
BigQueryParameterTypeUm tipo enumerado que define os tipos de parâmetro do BigQuery que podem ser definidos.
CheckboxContém informações de caixa de seleção para a configuração.
CommunityConnectorO conectorda comunidade permite que scripts acessem builders 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 aplicativo DataStudio permite que scripts interajam com recursos voltados a desenvolvedores do Data Studio.
DebugErrorUm erro que só é visível para os administradores do conector.
FieldContém dados relacionados ao campo.
FieldTypeUm tipo enumerado que define os tipos que podem ser definidos para um Field.
FieldsContém um conjunto de Fields para um conector da comunidade.
GetAuthTypeResponseBuilder para criar uma resposta getAuthType() para o projeto do script.
GetDataResponseBuilder para criar uma resposta getData() para o projeto do script.
GetSchemaResponseBuilder para criar uma resposta getSchema() para o projeto do 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 o projeto do script.
TextAreaContém informações da área de texto para a configuração.
TextInputContém informações de entrada de texto para a configuração.
UserErrorUm erro que aparece para os usuários do conector.

AggregationType

Propriedades

PropriedadeTipoDescrição
AVGEnumMédia.
COUNTEnumContagem.
COUNT_DISTINCTEnumCount Distinct.
MAXEnumMáx.
MINEnumMín.
SUMEnumSoma.
AUTOEnumAutomático.

AuthType

Propriedades

PropriedadeTipoDescrição
NONEEnumNão é necessária autorização.
OAUTH2EnumAutorização OAuth2 necessária.
USER_PASSEnumÉ necessário ter credenciais de nome de usuário e senha.
PATH_USER_PASSEnumNome de usuário, caminho e senha necessários.
PATH_KEYEnumCaminho e chave necessários.
KEYEnumÉ necessário ter uma chave ou um token da API.
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 BigQueryConfig.
build()ObjectValida e retorna o objeto no formato necessário para o 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 desse 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.
INT64EnumInteiro de 64-bit.
BOOLEnumBooleano.
FLOAT64EnumNúmero de ponto flutuante de 64 bits.

Checkbox

Métodos

MétodoTipo de retornoBreve descrição
setAllowOverride(allowOverride)CheckboxPermite substituir esta entrada de configuração.
setHelpText(helpText)CheckboxDefine o texto de ajuda para essa entrada de configuração.
setId(id)CheckboxDefine o ID exclusivo para essa entrada de configuração.
setIsDynamic(isDynamic)CheckboxDefine o status dinâmico para esta entrada de configuração.
setName(name)CheckboxDefine o nome de exibição para essa 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 e retorna o objeto no formato necessário para o Data Studio.
newCheckbox()CheckboxRetorna uma nova entrada de configuração de caixa de seleção.
newInfo()InfoRetorna uma nova entrada de configuração de informações.
newOptionBuilder()OptionBuilderRetorna um novo builder de opções.
newSelectMultiple()SelectMultipleRetorna uma nova entrada de seleção de várias configurações.
newSelectSingle()SelectSingleRetorna uma nova entrada de configuração única selecionada.
newTextArea()TextAreaRetorna uma nova entrada de configuração da á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 true, um período será fornecido para solicitações getData().
setIsSteppedConfig(isSteppedConfig)ConfigSe true, getConfig() é 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 só é mostrado para administradores.
throwException()voidAciona essa 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 dessa Field.
getId()StringRetorna o ID dessa Field.
getIsReaggregatable()BooleanRetorna true se esse campo puder ser reagrupado. Caso contrário, retorna false.
getName()StringRetorna o nome deste Field.
getType()FieldTypeRetorna o FieldType desse Field.
isDefault()BooleanRetorna true se Field for a métrica ou dimensão padrão.
isDimension()BooleanRetorna true se esse campo for uma dimensão.
isHidden()BooleanRetorna true se Field estiver oculto.
isMetric()BooleanRetorna true se esse campo for uma métrica.
setAggregation(aggregation)FieldDefine o tipo de agregação desse Field.
setDescription(description)FieldDefine a descrição desse Field.
setFormula(formula)FieldDefine a fórmula desse Field.
setGroup(group)FieldDefine o grupo dessa Field.
setId(id)FieldDefine o ID desse Field.
setIsHidden(isHidden)FieldDefine o status oculto desta Field.
setIsReaggregatable(isReaggregatable)FieldDefine o status permitido para reagregação de um Field.
setName(name)FieldDefine o nome deste Field.
setType(type)FieldDefine o FieldType deste Field.

FieldType

Propriedades

PropriedadeTipoDescrição
YEAREnumAno no formato AAAA, como 2017.
YEAR_QUARTEREnumAno e trimestre no formato AAAAT, como 20171.
YEAR_MONTHEnumAno e mês no formato AAAAMM, como 201703.
YEAR_WEEKEnumAno e semana no formato AAAAww, como 201707.
YEAR_MONTH_DAYEnumAno, mês e dia no formato AAAAMMDD, por exemplo, 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, por exemplo, 20170317023017.
QUARTEREnumTrimestre no formato 1, 2, 3 ou 4.
MONTHEnumMês no formato MM, como 03.
WEEKEnumSemana no formato de ww, como 07.
MONTH_DAYEnumMês e dia no formato AAAA-MM-DD, como 0317.
DAY_OF_WEEKEnumUm número no intervalo [0,6], em que 0 representa domingo.
DAYEnumDia no formato DD, como 17.
HOUREnumHora no formato HH, como 13.
MINUTEEnumMinuto no formato mm, por exemplo, 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 San Francisco-Oakland-San Jose CA.
METRO_CODEEnumUm código de área metropolitana, como 200807.
LATITUDE_LONGITUDEEnumUm par de latitude e longitude, como 51.5074, -0.1278.
NUMBEREnumUm número decimal.
PERCENTEnumPercentual decimal (pode ser superior a 1,0).
TEXTEnumTexto de forma livre.
BOOLEANEnumUm valor booleano true ou false.
URLEnumUm URL como texto, por exemplo, https://google.com.
HYPERLINKEnumUm hiperlink.
IMAGEEnumUma imagem.
IMAGE_LINKEnumUm link de imagem.
CURRENCY_AEDEnumMoeda de AED.
CURRENCY_ALLEnumMoeda de TODOS.
CURRENCY_ARSEnumMoeda de ARS.
CURRENCY_AUDEnumMoeda de AUD.
CURRENCY_BDTEnumMoeda do BDT.
CURRENCY_BGNEnumMoeda de BGN.
CURRENCY_BOBEnumMoeda do BOB.
CURRENCY_BRLEnumMoeda de BRL.
CURRENCY_CADEnumMoeda em CAD.
CURRENCY_CDFEnumMoeda do CDF.
CURRENCY_CHFEnumMoeda de CHF.
CURRENCY_CLPEnumMoeda de CLP.
CURRENCY_CNYEnumMoeda de CNY.
CURRENCY_COPEnumMoeda de COP.
CURRENCY_CRCEnumMoeda do CRC.
CURRENCY_CZKEnumMoeda de CZK.
CURRENCY_DKKEnumMoeda de DKK.
CURRENCY_DOPEnumMoeda de DOP.
CURRENCY_EGPEnumMoeda do EGP.
CURRENCY_ETBEnumMoeda do ETB.
CURRENCY_EUREnumMoeda de EUR.
CURRENCY_GBPEnumMoeda de 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 do IRR.
CURRENCY_ISKEnumMoeda de ISK.
CURRENCY_JMDEnumMoeda de JMD.
CURRENCY_JPYEnumMoeda de JPY.
CURRENCY_KRWEnumMoeda de KRW.
CURRENCY_LKREnumMoeda de LKR.
CURRENCY_LTLEnumMoeda de LTL.
CURRENCY_MNTEnumMoeda de MNT.
CURRENCY_MVREnumMoeda da MVR.
CURRENCY_MXNEnumMoeda de MXN.
CURRENCY_MYREnumMoeda de MYR.
CURRENCY_NGNEnumMoeda de NGN.
CURRENCY_NOKEnumMoeda de NOK.
CURRENCY_NZDEnumMoeda de NZD.
CURRENCY_PABEnumMoeda de PAB.
CURRENCY_PENEnumMoeda de PEN.
CURRENCY_PHPEnumMoeda do PHP.
CURRENCY_PKREnumMoeda de PKR.
CURRENCY_PLNEnumMoeda de PLN.
CURRENCY_RONEnumMoeda de RON.
CURRENCY_RSDEnumMoeda de RSD.
CURRENCY_RUBEnumMoeda de RUB.
CURRENCY_SAREnumMoeda da Arábia Saudita.
CURRENCY_SEKEnumMoeda de SEK.
CURRENCY_SGDEnumMoeda de SGD.
CURRENCY_THBEnumMoeda de THB.
CURRENCY_TRYEnumMoeda de TRY.
CURRENCY_TWDEnumMoeda de TWD.
CURRENCY_TZSEnumMoeda de TZS.
CURRENCY_UAHEnumMoeda de UAH.
CURRENCY_USDEnumMoeda em USD.
CURRENCY_UYUEnumMoeda de UYU.
CURRENCY_VEFEnumMoeda do 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 desse objeto como uma matriz.
build()Object[]Valida e retorna o objeto no formato necessário para o 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 neste 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 e retorna o objeto no formato necessário para o 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 este GetDataResponse.
addRow(row)GetDataResponseAdiciona uma linha de dados a GetDataResponse.
build()ObjectValida e retorna o objeto no formato necessário para o Data Studio.
setFields(fields)GetDataResponseDefine o Fields do builder.
setFiltersApplied(filtersApplied)GetDataResponseDefine o status dos filtros aplicados para esse criador.

GetSchemaResponse

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida e retorna o objeto no formato necessário para o 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 para essa 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 builder de opções.
setValue(value)OptionBuilderDefine o valor desse builder de opções.

SelectMultiple

Métodos

MétodoTipo de retornoBreve descrição
addOption(optionBuilder)SelectMultipleAdiciona uma nova opção de seleção.
setAllowOverride(allowOverride)SelectMultiplePermite substituir esta entrada de configuração.
setHelpText(helpText)SelectMultipleDefine o texto de ajuda para essa entrada de configuração.
setId(id)SelectMultipleDefine o ID exclusivo para essa entrada de configuração.
setIsDynamic(isDynamic)SelectMultipleDefine o status dinâmico para esta entrada de configuração.
setName(name)SelectMultipleDefine o nome de exibição para essa 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)SelectSinglePermite substituir esta entrada de configuração.
setHelpText(helpText)SelectSingleDefine o texto de ajuda para essa entrada de configuração.
setId(id)SelectSingleDefine o ID exclusivo para essa entrada de configuração.
setIsDynamic(isDynamic)SelectSingleDefine o status dinâmico para esta entrada de configuração.
setName(name)SelectSingleDefine o nome de exibição para essa entrada de configuração.

SetCredentialsResponse

Métodos

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

TextArea

Métodos

MétodoTipo de retornoBreve descrição
setAllowOverride(allowOverride)TextAreaPermite substituir esta entrada de configuração.
setHelpText(helpText)TextAreaDefine o texto de ajuda para essa entrada de configuração.
setId(id)TextAreaDefine o ID exclusivo para essa entrada de configuração.
setIsDynamic(isDynamic)TextAreaDefine o status dinâmico para esta entrada de configuração.
setName(name)TextAreaDefine o nome de exibição para essa entrada de configuração.
setPlaceholder(placeholder)TextAreaDefine o texto do marcador de posição para esta entrada de configuração.

TextInput

Métodos

MétodoTipo de retornoBreve descrição
setAllowOverride(allowOverride)TextInputPermite substituir esta entrada de configuração.
setHelpText(helpText)TextInputDefine o texto de ajuda para essa entrada de configuração.
setId(id)TextInputDefine o ID exclusivo para essa entrada de configuração.
setIsDynamic(isDynamic)TextInputDefine o status dinâmico para esta entrada de configuração.
setName(name)TextInputDefine o nome de exibição para essa entrada de configuração.
setPlaceholder(placeholder)TextInputDefine o texto do marcador de posição 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 só é mostrado para administradores.
setText(text)UserErrorDefine o texto do erro do usuário.
throwException()voidAciona essa exceção.