Embedded Files
02-04 URL parameters
Probleemstelling
Probleemstelling
Dikwijls wil je in een site documenten, slides of andere zaken inbinden, maar de toegang of het gebruik beperken of sturen.
Voorbeelden zijn legio:
Downloaden van een PDF versie van een Google doc.
Editeerbaar maken van een Googles sheet, in de site, zodat je dit als een rekentool kan gebruiken.
In een loop afspelen van slides met een bepaalde tijdssetting
Hiervoor kan je de URL aanpassen van de link die je plaatst in de website, door achteraan de "parameters/argumenten" die meegegeven worden te veranderen.
Wanneer je gebruik maakt van den <embed> functie in Sites wordt dit in een apart frame afgespeeld.
Het geheel dient dan tussen gevoegd te worden in een IFRAME tag
<iframe width=100% height=1000px src="......""></iframe>
We tonen hier een aantal voorbeelden en gegevens:
Documenten
Documenten
Instellingen delen
Instellingen delen
Om een document in een website zichtbaar te maken, die je het te delen.
Dit omdat de toegansrechten tot een document via een link enkel op deze wijze in te stellen zijn.
Eens deze deling actief kan je van het document een link maken en aanpassen
URL naar een document Gdocs
URL naar een document Gdocs
Wanneer je een document deelt en de link kopieert krijg je een link die er als volgt uit ziet, ongeacht of deze beperkt toegankelijk is of niet:
https://docs.google.com/document/d/1ddjwYygreo1UELgAsdfNEypSf4JkYgpFAI63kqf_Q34/edit?usp=sharing
De link bestaat uit 3 onderdelen:
De verwijzing naar de server, waar het document staat:
Voor documenten is dit normaal: https://docs.google.com/document/d/De ID van het document.
Ieder document heeft een unieke ID, die doorheen Google gebruikt wordt, ongeacht waar dit staat.
1ddjwYygreo1UELgAsdfNEypSf4JkYgpFAI63kqf_Q34Parameters en methodes die kunnen gebruikt worden bij de benadering van dit document.
/edit?usp=sharing
Het is dit laatste gedeelte dat bepalend is voor de weergave en de vorm van het aangeboden document.
Aanpassen URL
Aanpassen URL
Bekijken we onderstaan document, wat een cursus is, gemaakt in het Google Docs formaat.
We geven hierbij de standaard link naar een recent document wat gemaakt is in Gdocs
Werkboek (Basic) frequentieregelaar Siemens Sinamics G120 21092021
https://docs.google.com/document/d/1wcCPPvU6S0SK37n4zzfbQA1q7fsz9h8MPYWrVl3x_UE/edit?usp=sharing
Deze standaard link eindigt op:
/edit?usp=sharing
waarmee wordt aangegeven dat de sharing wordt toegestaan en je de Gdocs viewer opent.
Hieronder een aantal voorbeelden van andere vormen, verwijzend naar hetzelfde document.
Rechtstreekse verwijzing binnen het document naar een andere pagina:
/edit#heading=h.1t3h5sf
/view#heading=h.gjdgxsOpen Gdocs editor met embedded menus:
/edit?rm=embeddedOpen Gdocs editor zonder menus:
/edit?rm=minimalHet bekijken van een document zonder de Google docs editor te openen:
/previewHet downloaden van het document in PDF formaat:
/export?format=pdfHet downloaden van het document in txt formaat:
/export?format=txtJe forceren om van het document een kopie te maken, zodat het oorspronkelijke als template blijft bestaan:
/copyLink enkel naar het gepubliceerde document maken.
Zo kan je off site verder werken aan een document met een groep en enkel opnieuw publiceren als iedereen tevreden is.
Wanneer het document niet openbaar gepubliceerd is, zoals in dit voorbeeld.
/pub?
Zoals je kan zien zijn er heel wat mogelijkheden om aan de hand van parameters en argumenten aan te passen en heel wat van deze zal je niet terug vinden in de officiële Google pages voor het grote publiek.
Parameters
Parameters
/copy
/export
/edit
/view
/preview
/create
/pub?
/fm?id=
/tq?tqx=out:html
Argumenten
Argumenten
&key=[ID]
&gid=[#]
&single=[true|false]
&range=[CellAddress|CellAddress1:CellAddress2]
&embedded=[true|false]
&widget=[true|false]
&output=[html|txt|csv|pdf]
&gridlines=[false]
&rm=[minimal|embedded|full|demo|?]
&ui=2 (interface version)
&chrome=[false] (full screen mode)
&width=[width]
&height=[height]
&frameborder=[size of border]
&q=[Search Query]
&viewer? &start=
&channel=
&ibd=
&client=
&fmcmd=12
&size=0
&fzr=[true]
&portrait=[false]
&fitw=[true]
&printtitle=[true]
&sheetnames=[true]
&pagenum=[CENTER]
&attachment=[true]
&alt=[rss]
&tq=[query params here]
©Destination=[Drive FolderID]
URL naar Slides
URL naar Slides
Ook voor slides zijn er heel wat parameters.
Het voorbeeld hieronder laat een slideshow automatisch starten in een website en in een loop draaien, zonder menus en dit met tassenpauzes van 2000ms, blijkbaar voor variabele aankondigingen, waarbij de toegang tot het editeren van de slides door verschillende personen kan en de aanpassing direct wordt weerspiegeld in de website.
(nieuws bulletins etc)
URL naar sheets
URL naar sheets
De standaard link naar het document ziet er als volgt uit, waarbij gid=0 aangeeft naar welke sheet je verwijst.
https://docs.google.com/spreadsheets/d/1TUdBz4h35tUjherLGKWQFiP3wWPxN52FC7_pog-8f8Q/edit#gid=0
De #gid=0 is uniek voor een tabblad en kan je behouden om een viewer rechtstreeks te openen in dit tabblad.
Ook hier zijn heel wat mogelijkheden.
Daar Sheets gekoppeld is aan Apps Script en je toe laat om heel wat automatisatie te doen, zal je ook bij het volgende commando een "dubbele download" bekomen.
https://docs.google.com/spreadsheets/d/1TUdBz4h35tUjherLGKWQFiP3wWPxN52FC7_pog-8f8Q/copy
Wil je de sheet zien zonder enige menu's en te standaard met een bepaald tabblad, dan kan dit met de volgende link:
https://docs.google.com/spreadsheets/d/1TUdBz4h35tUjherLGKWQFiP3wWPxN52FC7_pog-8f8Q/preview#gid=0
Wil je je sheet als "dashboard" laten zien, waarbij je in de achtergrond de berekening laat gaan, dan kan je de volgende link gebruiken waarbij alle menu's onzichtbaar worden.
https://docs.google.com/spreadsheets/d/1TUdBz4h35tUjherLGKWQFiP3wWPxN52FC7_pog-8f8Q/edit?rm=minimal
<iframe width=100% height=1000px src="https://docs.google.com/spreadsheets/d/1TUdBz4h35tUjherLGKWQFiP3wWPxN52FC7_pog-8f8Q/edit?usp=sharing&rm=minimal&single=true&widget=true&headers=false"></iframe>
Google Vizualization API
Google Vizualization API
Een gviz functie met parameter geeft je een HTML view van een sheet:
https://docs.google.com/spreadsheets/d/1xM060Kw-nWvo6JA8K90f7F-JmY-Y8iZVT4AC_RwsikM/gviz/tq?tqx=out:html.
Meer uitleg van de Google Vizualization API kan je vinden op:
https://ai2.metricrat.co.uk/guides/use-gviz-to-get-and-query-google-sheet-data
Wil je een selectie uit de tabel gebruiken dan kan je de parameter tq=[query string] toevopegen.
Hoe je de query string formateert vindt je op https://developers.google.com/chart/interactive/docs/querylanguage .
Een voorbeeld van de tabel waarbij enkel kolom A getoond wordt (* A is de eerste kolom) met query "Select A".
https://docs.google.com/spreadsheets/d/1chFDkz5Fqus1ODgtdEGNt4Mq2nxnkKnuqbEB4LaZF6o/gviz/tq?tqx=out:html&tq=select%20A
gviz html view
Embedding in een website
Embedding in een website
Met de bovenstaande linken kan je rechtstreeks knoppen en embed URL's opgeven, echter sommige zaken werken uitsluiten goed in een IFRAME.
In onderstaand voorbeeld vind je de IFRAME variant van de uitleg op 02-03 Editeerbare Sheet op web , maar dan als dashboard, doordat alle menu's verdwenen zijn.
Op deze wijze kan je met sheets rekenbladen en toepassingen maken op websites, waarbij het " ingeven van gegevens" lijkt op een web-app.
De HTML code die we gebruiken in de Embed functie (dus niet als url) is Code insluiten
<iframe width=100% height=1000px src="https://docs.google.com/spreadsheets/d/1TUdBz4h35tUjherLGKWQFiP3wWPxN52FC7_pog-8f8Q/edit?usp=sharing&rm=minimal&single=true&widget=true&headers=false"></iframe>
Hierbij wordt het IFRAME gedefinieerd in pixels en de breedte op 100% en wordt de data die er in dit iframe moet getoond worden, als src doorgegeven tussen quotes.
Op identieke wijze kan je zo bannes een aankondigingen automatisch laten lopen op een website.
Volgende frame bevat de code van de slides maar aangevuld met de rm=minimal parameter en kan zo draaien op de site als aankondiging.
<iframe width=100% height=300px src="https://docs.google.com/presentation/d/15t-EnxPp3pGV70asUqPQr-YjoKPwhaf5qLCmITtHIu0/embed?loop=true&delayms=2000&start=true&rm=minimal"></iframe>
Page updated
Report abuse