Google Tabulas

Detalizētu informāciju par Google Sheets savienošanu un izmantošanu skatiet ŠEIT.

Katra funkcija kā pirmo parametru pieņem tabulas identifikatoru sheet_id. To varat atrast savā Google Sheets URL adresē (daļa, kas izcelta treknrakstā zemāk esošajā piemērā).

https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYlc4/edit#gid=0

Ērtības labad mēs iesakām saglabāt tabulas ID mainīgajā un nodot šo mainīgo funkcijām.

Visas tālāk aprakstītās funkcijas atgriež vārdnīcu, kas satur darbības rezultātu. Šī vārdnīca vienmēr ietver parametru status, kas ir true, ja darbība ir veiksmīga, un false, ja rodas kļūda.

Ja status ir true, atbildē var būt papildu parametri, kurus var iegūt, izmantojot funkciju get().

Ja status ir false, atbildē ir parametrs err ar kļūdas aprakstu.

Ja nepieciešams strādāt ar citu darblapu, nevis pirmo, varat nodot papildu parametru: worksheet_name_or_id_or_index.

Katra funkcija pieņem šo parametru, kas identificē darblapu pēc tās nosaukuma, ID vai indeksa.

Vārdnīca — dažas funkcijas pieņem vārdnīcu, kas satur noteiktu datu kopu. Ir vairāki noteikumi, kas jums jāievēro:

• Visa vārdnīca jāietver vienpēdiņās: '{}'.
• Vārdnīcas atslēgas un vērtības (teksts vai mainīgie) jāietver dubultpēdiņās: '{"key": "value", "key2": "#{email}"}'.

Kā izmantot savu Google kontu

Pēc noklusējuma MaviBot veidotājs izmanto savus pakalpojumu kontus, lai piekļūtu jūsu tabulām. Tāpēc jums ir jāpiešķir rediģēšanas piekļuve savām tabulām, izmantojot saiti.

Labākai drošībai varat izmantot savus autentifikācijas akreditācijas datus un pakalpojumu konta atslēgas.

Google Sheets ir ierobežojumi attiecībā uz pieprasījumu skaitu, ko var veikt noteiktā laika periodā. Lai izvairītos no atkarības no koplietotā pakalpojumu konta ierobežojumiem, varat izmantot savu kontu.

Lai to izdarītu, dodieties uz sava projekta iestatījumiem, atveriet Projekta konstantes un pievienojiet mainīgo ar nosaukumu sheet_json_keys, kas satur jūsu atslēgu masīvu.

Masīvs var saturēt vai nu JSON atslēgas, kas kopētas no failiem, vai URL adreses, kas norāda uz atslēgu failiem.

JSON atslēga no faila: Iegūstiet atslēgas failu (instrukcijas ir sniegtas zemāk), atveriet to jebkurā teksta redaktorā, kopējiet tā saturu un pievienojiet to masīvam.

Atslēgas faila URL: Vienkāršākais veids, kā iegūt šādu URL, ir augšupielādēt failu MaviBot veidotājā.

Lai to izdarītu:

1. Izveidojiet bloku, kas nav stāvokļa bloks.
2. Augšupielādējiet failu, kas satur pakalpojumu konta akreditācijas datus, bloka pielikumos.
3. Ar peles labo pogu noklikšķiniet uz augšupielādētā faila nosaukuma.
4. Atlasiet Kopēt saites adresi.

Četri sheet_json_keys mainīgā piemēri:

1. Masīvs, kas satur divas atslēgu failu URL adreses:

["atslēgas faila URL", "otrā atslēgas faila URL"]

2. Masīvs, kas satur divas URL adreses un divas JSON atslēgas:

["atslēgas faila URL", "otrā atslēgas faila URL", {JSON atslēga no faila}, {JSON atslēga no faila}]

3. Masīvs, kas satur vienu JSON atslēgu:

[{JSON atslēga no faila}]

(Ekrānuzņēmumā redzamā atslēga ir saīsināta. Faktiskā atslēga ir ievērojami garāka.)

4. Masīvs, kas satur vienu atslēgas faila URL:

["atslēgas faila URL"]

Pievienojiet atslēgas Projekta konstantēs.

Jums nav jānodod papildu parametrs, izsaucot kalkulatora funkcijas. Atslēgas tiks ielādētas automātiski.

Ja sheet_json_keys mainīgais satur vairākus pakalpojumu kontus, jums ir jākonfigurē Google Sheets piekļuves atļaujas VISIEM PAKALPOJUMU KONTIEM, kas norādīti mainīgajā.

Plašāku informāciju par sava Google konta izmantošanu ar Google Sheets un pakalpojumu konta atslēgu iegūšanu skatiet attiecīgajā dokumentācijas rakstā.

Kā izveidot jaunu Google izklājlapu no MaviBot

MaviBot atbalsta jaunu Google Sheets izklājlapu izveidi.

Lai izmantotu šo funkciju, jums ir jākonfigurē sheet_json_keys mainīgais. Instrukcijas šī mainīgā izveidei ir pieejamas šeit.

Funkcija izklājlapas izveidei:

sheet_create_spreadsheet(new_worksheet_title, google_email)

Parametri:

• new_worksheet_title — jaunās Google Sheets izklājlapas nosaukums.
• google_email — jūsu Google konta e-pasta adrese.

Parametrs google_email ir nepieciešams, lai piešķirtu redaktora atļaujas norādītajai e-pasta adresei jaunizveidotajai izklājlapai.

Google automātiski piešķir izklājlapas īpašumtiesības Google projektam, kuru jūs iepriekš reģistrējāt.

Diemžēl šī pašlaik ir vienīgā pieejamā metode Google Sheets izklājlapu izveidei, izmantojot API.

Piemērs:

new = sheet_create_spreadsheet('ЧЕМОДАНчик', '[email protected]')

Pēc Google Sheets lapas atsvaidzināšanas savā kontā jūs atradīsiet jaunizveidoto izklājlapu:

Klienta mainīgo sarakstā parādīsies mainīgais ar nosaukumu google_spreadsheet_id. Tas saturēs jaunizveidotās izklājlapas ID.

Ja pieprasījums tiek veiksmīgi pabeigts, funkcija atgriež vārdnīcu, kas satur statusu un paziņojumu:

{'status': True, 'message': "Google worksheet 'ЧЕМОДАНчик' is created"}

• status — darbības rezultāts.
• result — darbības ziņojums.

Ja rodas kļūda, funkcija atgriež false kā statusu kopā ar kļūdas aprakstu.

Kā pievienot jaunu darblapu Google Sheets izklājlapai

Izmantojiet šādu funkciju:

sheet_create_worksheet(sheet_id, list_name, cols=None, rows=None)

Funkcija atgriež vārdnīcu, kas satur jaunizveidotās darblapas ID un statusu true:

{"status":true,"list_id":1063146761}

Ja rodas kļūda, funkcija atgriež statusu false un kļūdas aprakstu:

{"status":false,"err":"Kļūda vai apraksts"}

Piemērs:

result = sheet_create_worksheet('12sSVR3Wk-1kNb9CsjyJ2gjLb_PiRl5DhbF4YcD1VzTl', "Jauns saraksts")

status = get(result, 'status')