Data Studio Service

Data Studio

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

Classes

NomeBreve descrição
AggregationTypeUma enumeração que define os tipos de agregação que podem ser definidos para um Field.
AuthTypeUma enumeração 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.
BigQueryParameterTypeUma enumeração que define os tipos de parâmetros do BigQuery que podem ser definidos.
CheckboxContém informações de 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 do Data Studio voltados para desenvolvedores.
DebugErrorUm erro visível apenas para administradores do conector.
FieldContém dados relacionados ao campo.
FieldTypeUma enumeração 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 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 de SelectSingles e SelectMultiples.
SelectMultipleContém informações de seleção múltipla para a configuração.
SelectSingleContém informações de seleção única para a configuração.
SetCredentialsResponseBuilder para criar uma resposta setCredentials() para seu projeto de 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 mostrado aos usuários do conector.

AggregationType

Propriedades

PropriedadeTipoDescrição
AVGEnumMédia.
COUNTEnumContagem.
COUNT_DISTINCTEnumContagem distinta.
MAXEnumMáx.
MINEnumMín.
SUMEnumSoma.
AUTOEnumAuto.

AuthType

Propriedades

PropriedadeTipoDescrição
NONEEnumNenhuma autorização necessária.
OAUTH2EnumAutorização OAuth2 necessária.
USER_PASSEnumCredenciais de nome de usuário e senha necessárias.
PATH_USER_PASSEnumNome de usuário, caminho e senha necessários.
PATH_KEYEnumCaminho e chave necessários.
KEYEnumChave ou token de API necessários.
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 este BigQueryConfig.
build()ObjectValida esse objeto e o retorna no formato necessário para o Data Studio.
printJson()StringImprime a representação JSON deste objeto.
setAccessToken(accessToken)BigQueryConfigDefine o token de acesso deste BigQueryConfig.
setBillingProjectId(billingProjectId)BigQueryConfigDefine o ID do projeto de faturamento deste BigQueryConfig.
setQuery(query)BigQueryConfigDefine a consulta SQL deste 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 esta entrada de configuração.
setId(id)CheckboxDefine o ID exclusivo para esta 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 esta 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 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 configuração de seleção múltipla.
newSelectSingle()SelectSingleRetorna uma nova entrada de configuração de seleção única.
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()StringImprime a representação JSON deste objeto.
setDateRangeRequired(dateRangeRequired)ConfigSe o valor for true, um período será fornecido para solicitações getData().
setIsSteppedConfig(isSteppedConfig)ConfigSe true, getConfig() será chamado novamente com a configuração do usuário atual.

DataStudioApp

Métodos

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

DebugError

Métodos

MétodoTipo de retornoBreve descrição
printJson()StringImprime a representação JSON deste objeto.
setText(text)DebugErrorDefine o texto do erro de depuração, que só é mostrado aos administradores.
throwException()voidFaz com que essa exceção seja gerada.

Field

Métodos

MétodoTipo de retornoBreve descrição
getAggregation()AggregationTypeRetorna o AggregationType deste Field.
getDescription()StringRetorna a descrição deste Field.
getFormula()StringRetorna a fórmula deste Field.
getGroup()StringRetorna o grupo deste Field.
getId()StringRetorna o ID deste Field.
getIsReaggregatable()BooleanRetorna true se o campo puder ser reagregado. Caso contrário, retorna false.
getName()StringRetorna o nome deste Field.
getType()FieldTypeRetorna o FieldType deste Field.
isDefault()BooleanRetorna true se este Field for a métrica ou dimensão padrão.
isDimension()BooleanRetorna true se este campo for uma dimensão.
isHidden()BooleanRetorna true se este Field estiver oculto.
isMetric()BooleanRetorna true se este campo for uma métrica.
setAggregation(aggregation)FieldDefine o tipo de agregação deste Field.
setDescription(description)FieldDefine a descrição deste Field.
setFormula(formula)FieldDefine a fórmula deste Field.
setGroup(group)FieldDefine o grupo deste Field.
setId(id)FieldDefine o ID deste Field.
setIsHidden(isHidden)FieldDefine o status oculto deste Field.
setIsReaggregatable(isReaggregatable)FieldDefine o status de reagregação permitida para 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, 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 MM, como 03.
WEEKEnumSemana no formato "ww", como 07.
MONTH_DAYEnumMês e dia no formato MMDD, 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, 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 da cidade, como 1014044.
METROEnumUma área metropolitana, como São Francisco-Oakland-San Jose, Califórnia.
METRO_CODEEnumUm código da á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 livre.
BOOLEANEnumUm valor booleano true ou false.
URLEnumUm URL como texto, por exemplo, https://google.com.
HYPERLINKEnumUm hiperlink.
IMAGEEnumUma imagem.
IMAGE_LINKEnumUm link da imagem.
CURRENCY_AEDEnumMoeda de AED.
CURRENCY_ALLEnumMoeda de ALL.
CURRENCY_ARSEnumMoeda da ARS.
CURRENCY_AUDEnumMoeda em AUD.
CURRENCY_BDTEnumMoeda do BDT.
CURRENCY_BGNEnumMoeda de BGN.
CURRENCY_BOBEnumMoeda de BOB.
CURRENCY_BRLEnumMoeda do BRL.
CURRENCY_CADEnumMoeda do CAD.
CURRENCY_CDFEnumMoeda da CDF.
CURRENCY_CHFEnumMoeda em CHF.
CURRENCY_CLPEnumMoeda do CLP.
CURRENCY_CNYEnumMoeda de CNY.
CURRENCY_COPEnumMoeda de COP.
CURRENCY_CRCEnumMoeda do CRC.
CURRENCY_CZKEnumMoeda de CZK.
CURRENCY_DKKEnumMoeda da Dinamarca.
CURRENCY_DOPEnumMoeda da DOP.
CURRENCY_EGPEnumMoeda do EGP.
CURRENCY_ETBEnumMoeda da Etiópia.
CURRENCY_EUREnumMoeda em EUR.
CURRENCY_GBPEnumMoeda em GBP.
CURRENCY_HKDEnumMoeda de HKD.
CURRENCY_HRKEnumMoeda da HRK.
CURRENCY_HUFEnumMoeda da Hungria.
CURRENCY_IDREnumMoeda de IDR.
CURRENCY_ILSEnumMoeda de ILS.
CURRENCY_INREnumMoeda da rupia indiana.
CURRENCY_IRREnumMoeda do IRR.
CURRENCY_ISKEnumMoeda da Islândia.
CURRENCY_JMDEnumMoeda da Jamaica.
CURRENCY_JPYEnumMoeda de JPY.
CURRENCY_KRWEnumMoeda da KRW.
CURRENCY_LKREnumMoeda de LKR.
CURRENCY_LTLEnumMoeda da LTL.
CURRENCY_MNTEnumMoeda do MNT.
CURRENCY_MVREnumMoeda do MVR.
CURRENCY_MXNEnumMoeda do MXN.
CURRENCY_MYREnumMoeda de MYR.
CURRENCY_NGNEnumMoeda de NGN.
CURRENCY_NOKEnumMoeda da Noruega.
CURRENCY_NZDEnumMoeda da Nova Zelândia.
CURRENCY_PABEnumMoeda do PAB.
CURRENCY_PENEnumMoeda do PEN.
CURRENCY_PHPEnumMoeda do PHP.
CURRENCY_PKREnumMoeda do PKR.
CURRENCY_PLNEnumMoeda da Polônia.
CURRENCY_RONEnumMoeda da Romênia.
CURRENCY_RSDEnumMoeda de RSD.
CURRENCY_RUBEnumMoeda de RUB.
CURRENCY_SAREnumMoeda da SAR.
CURRENCY_SEKEnumMoeda da SEK.
CURRENCY_SGDEnumMoeda de SGD.
CURRENCY_THBEnumMoeda da Tailândia.
CURRENCY_TRYEnumMoeda da TRY.
CURRENCY_TWDEnumMoeda de TWD.
CURRENCY_TZSEnumMoeda da Tanzânia.
CURRENCY_UAHEnumMoeda da Ucrânia.
CURRENCY_USDEnumMoeda de USD.
CURRENCY_UYUEnumMoeda de UYU.
CURRENCY_VEFEnumMoeda da Venezuela.
CURRENCY_VNDEnumMoeda de VND.
CURRENCY_YEREnumMoeda do YER.
CURRENCY_ZAREnumMoeda da África do Sul.

Fields

Métodos

MétodoTipo de retornoBreve descrição
asArray()Field[]Retorna uma visualização desse objeto como uma matriz.
build()Object[]Valida esse objeto e o retorna 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 no 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 necessário para o Data Studio.
printJson()StringImprime a representação JSON deste 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 este GetDataResponse.
build()ObjectValida esse objeto e o retorna no formato necessário para o Data Studio.
setFields(fields)GetDataResponseDefine o Fields do builder.
setFiltersApplied(filtersApplied)GetDataResponseDefine o status de filtros aplicados para este criador.

GetSchemaResponse

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida esse objeto e o retorna no formato necessário para o Data Studio.
printJson()StringImprime a representação JSON deste objeto.
setFields(fields)GetSchemaResponseDefine o Fields do builder.

Info

Métodos

MétodoTipo de retornoBreve descrição
setId(id)InfoDefine o ID exclusivo para esta 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 deste builder de opções.
setValue(value)OptionBuilderDefine o valor do 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 esta entrada de configuração.
setId(id)SelectMultipleDefine o ID exclusivo para esta 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 esta 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 esta entrada de configuração.
setId(id)SelectSingleDefine o ID exclusivo para esta 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 esta entrada de configuração.

SetCredentialsResponse

Métodos

MétodoTipo de retornoBreve descrição
build()ObjectValida esse objeto e o retorna no formato necessário para o Data Studio.
printJson()StringImprime a representação JSON deste 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 esta entrada de configuração.
setId(id)TextAreaDefine o ID exclusivo para esta 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 esta 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 esta entrada de configuração.
setId(id)TextInputDefine o ID exclusivo para esta 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 esta 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()StringImprime a representação JSON deste objeto.
setDebugText(text)UserErrorDefine o texto do erro de depuração, que só é mostrado aos administradores.
setText(text)UserErrorDefine o texto do erro do usuário.
throwException()voidFaz com que essa exceção seja gerada.