Integrando dados do Google sheet usando a API de controle de gráficos

A API de controle de gráficos permite sincronizar dados diretamente de um Google sheet. Além disso, você poderá controlar as transições de overlays em um Output do pacote gráfico.

Para isso, siga os passos abaixo:

1. Faça sua própria cópia do Google sheet

Acesse esta Google sheet e copie-a.

Isso também copiará os botões e o script.

Leve em conta

Ao usar os botões, você deve fornecer todas as permissões solicitadas pelo Google.

2. Crie seus gráficos de Scorebug

Leve em conta que os elementos que você controlará no Google sheet são:

Nomes das equipes - Home e Away
Resultados - Home e Away
Período de jogo - 1º tempo e 2º tempo

Os itens acima devem ser elementos de Texto e não devem ser conectados a um Data Connector ou a uma Lista Dinâmica.

Nota: Todos os elementos que compõem seu scorebug devem estar contidos na mesma overlay.

Sua árvore pode ser algo assim:

3. Gerar o token do seu pacote gráfico

Saiba como gerar seu token aqui.

4. Gerar um identificador de controle

A partir do editor gráfico, você pode gerar um identificador de controle para seus elementos. Para fazer isso basta concluir as etapas 1 e 2 da imagem a seguir:

(1) Selecione o elemento de Texto.

(2) No inspetor, clique no ícone Show on Remote Control para habilitar o campo Control API ID e adicionar um identificador de controle para este elemento.

5. Obtendo o ID de overlay

Para adicionar um ID personalizado a uma Overlay:

(1) Selecione a Overlay.

(2) No inspetor do lado direito, clique em # Sem ID, adicione o ID.

6. Completando o script

Para acessar o script em sua Google sheet vá para Extensions >> Apps Script

Depois precisa substituir:

O token do seu pacote gráfico nas linhas, 29, 60, 84, 113, 140.
Identificador de controle nas linhas, 41, 45, 69, 123, 127, 146.
ID de Overlay nas linhas, 41, 45, 69, 86, 123, 127, 146.

Agora você está pronto para executar o código.

Entendendo o script

KEY	DESCRIÇÃO
API Url	É a variável que contém a URL do endpoint.
SpreadsheetApp.getActiveSpreadsheet() .getSheetByName("Nome da sua planilha" ).getRange(cell1).getValue()	Esta função permite que você leia o valor atribuído a uma célula específica da Google sheet que você declara.
SpreadsheetApp.getActiveSpreadsheet() .getSheetByName("Nome da sua planilha" ).getRange(cell2).setValue()	Esta função permite definir um valor para uma célula específica da Google sheet que você declara.
Data	É a variável que irá ler os valores das células da Google sheet.
Options	É a variável que define as opções usadas pelo comando URLFetchApp.
ContentType	String o tipo de conteúdo (o padrão é 'application/x-www-form-urlencoded').
method	String o método HTTP para a solicitação: get, delete, patch, post ou put.
payload	String a carga útil (ou seja, o corpo POST) para a solicitação. Certos métodos HTTP (por exemplo, GET) não aceitam um payload. Pode ser uma string, uma matriz de bytes, um blob ou um objeto JavaScript
fetch (url, params)	Faz uma solicitação para buscar um URL usando parâmetros avançados opcionais. Isso funciona tanto em HTTP quanto em HTTPS.
Replace Graphics Token	É o identificador do seu pacote gráfico.
Overlay ID	É o identificador da overlay.
Control API ID (Away-Home-Time)	É o identificador que você escolheu para cada elemento.
Your text	O conteúdo que você deseja adicionar a cada elemento.