- Izvorni korak je pošiljanje spletnega kavlja.
- URL je fiksen; spremenljivke se lahko dodajo v telo.
- Odgovor ostaja na voljo za nadaljnje korake.
- Funkcija zahteva skrbniško dovoljenje.
Delovni tok Google Workspace Studia lahko potrebuje podatke zunaj Gmaila, Drivea ali Chata: stanje naročila, številko iz baze podatkov ali odgovor iz internega orodja. Če želite pridobiti te podatke ali poslati informacije drugi storitvi, lahko dodate korak Pošlji spletni kaveljTo pošlje zahtevo HTTP na naslov API-ja, ki ste ga določili.
Za to zahtevo vam ni treba konfigurirati klica funkcije Gemini. V programu Workspace Studio potek izvede korak spletnega kavlja in prejme odgovor. Nato lahko ta odgovor, če se vam zdi uporaben, posredujete drugemu koraku, da ga povzamete, izvlečete podatke ali sporočite rezultat.
Kaj potrebujete pred povezavo z API-jem
Prvi korak je preveriti, ali vaša organizacija lahko uporablja spletne kavlje. Funkcija se nahaja v omejen predogled in je privzeto onemogočeno. Prijaviti se mora skrbnik. Aplikacije > Google Workspace > Workspace Studio > Nastavitve spletnega kavlja in ga omogočite za ustrezno organizacijsko enoto.
V nekaterih izdajah lahko skrbnik omeji povezave tudi na eno seznam dovoljenih domen in URL-jevČe se korak prikaže v Studiu, vendar ne uspe komunicirati z vašim API-jem, preverite, ali je ciljni naslov pooblaščen. Prav tako dejanja, ki vključujejo spletne kavlje, privzeto zahtevajo, da uporabnik pred izvedbo pregleda in potrdi korak.
Od zunanje storitve morate poznati njen URL, metode HTTP, ki jih podpira, in obliko podatkov, ki jo pričakuje. Preverite tudi, kako preverja pristnost: javni API samo za branje ima drugačne zahteve kot zasebni API, ki zahteva žetone ali posebne glave.
Kako korak za korakom poklicati API iz programa Workspace Studio
Vnesite studio.workspace.google.com in ustvarite potek dela s sprožilcem, ki ga potrebujete. Zaženete ga lahko na primer, ko prejmete e-pošto, ki izpolnjuje določene pogoje. Nato sledite tem korakom:
- Pritisnite Dodaj korak in izberite Pošlji spletni kavelj.
- Vnesite Celoten URL API-ja, vključno s predpono
https://Naslov mora biti fiksen: to polje ne podpira spremenljivk pretoka. - Izberite metodo HTTP. PRIDOBITE Uporablja se za poizvedovanje podatkov; OBJAVAda jih pošljete ali ustvarite zapis. Na voljo so tudi VSTAVI, POPRAVI in IZBRIŠI.
- Če API zahteva telo, ga napišite v polje z vsebino ali koristni tovorGoogle priporoča uporabo JSON-a, kadar ga prejemna storitev pričakuje.
- Naredite izvedba testaPreverite rezultat in aktivirajte tok, ko se prepričate, da deluje.
Upoštevajte, da test izvesti dejanjeČe konfigurirate POST za ustvarjanje zapisa ali DELETE za njegovo brisanje, najprej uporabite testno okolje ali podatke, ki jih lahko brez težav spremenite.
Primer: pošiljanje obvestila zunanjemu orodju
Predstavljajte si, da ima vaša ekipa API, ki ustvarja opozorila v https://api.ejemplo.com/v1/avisosTa naslov je ilustrativnoZamenjati ga boste morali s tistim iz vaše storitve. Če je v dokumentaciji navedeno, da sprejema POST in telo JSON, lahko korak konfigurirate z vsebino, kot je {"tipo":"nuevo_correo","origen":"Workspace Studio"}.
Vstavite lahko tudi spremenljivka pretoka V telesu, na primer, da vključite zadevo e-poštnega sporočila, ki ga je sprožilo. To storite v izbirniku spremenljivk v Studiu in preverite rezultat: če vstavljeno besedilo vsebuje narekovaje ali druge posebne znake, lahko JSON ostane popačen. Spremenljivke se lahko uporabljajo v vsebini, vendar ni v polju URL.
Če morate pridobiti podatke, izberite GET in vnesite fiksni URL, ki že vsebuje potrebne parametre. Workspace Studio bo prezrl vso vsebino, ki ste jo napisali v telesu zahteve GET.
Kaj storiti z odgovorom API-ja
Korak spletnega kavlja zapusti odgovor storitve kot besedilo v spremenljivki, ki je na voljo za nadaljnje korake. Uporabite jo lahko za pošiljanje obvestila, pisanje povzetka ali pa od koraka umetne inteligence zahtevate, da izvleče določene podatke.
Če na primer API vrne stanje naročila, lahko naslednji korak to stanje sporoči ekipi. Izrecno izberite spremenljivko, ki vsebuje odgovor: naslednji koraki ne prejmejo samodejno vsega, kar se je zgodilo prej v poteku. Priporočljivo je, da vrnjeno vsebino preizkusite, preden napišete navodila, ki so od nje odvisna.
Če API zahteva preverjanje pristnosti ali bolj zapleteno logiko
Dokumentirana osnovna konfiguracija za Pošlji spletni kavelj Vključuje URL, metodo in neobvezno telo. Če mora vaša integracija pred nadaljevanjem pridobiti žeton OAuth, sestaviti URL s spremenljivimi parametri, dodati posebne glave ali preoblikovati odgovor, preverite, ali ta korak zajema te zahteve.
Ko to ne zadostuje, je ena od možnosti razvoj Korak po meri za Workspace Studio prek vtičnika. V implementaciji skripta Google Apps storitev UrlFetchApp Omogoča vam pošiljanje zahtev zunanjim API-jem in obdelavo odgovorov JSON. Ta rešitev zahteva razvoj in ustrezno konfiguracijo dovoljenj; ni potrebna za preproste zahteve, ki jih lahko že obdela izvorni korak.
Izogibajte se lepljenju zasebnih ključev v vidna polja poteka ali njihovemu vdelovanju v skupni URL. Preden pošljete podatke iz Gmaila, Klepeta ali Koledarja, preverite, katere podatke bo zunanja storitev prejela in ali je pooblaščena za njihovo obdelavo.
Kako najti napake v spletnem kavljarju
Če povezava ne uspe, odprite zavihek Dejavnost poteka. Tam si lahko ogledate celotno napako in odgovor, ki ga je poslal ciljni strežnik. Te informacije pomagajo razlikovati med težavo s konfiguracijo programa Studio in zahtevo, ki jo je API zavrnil.
- Korak se ne prikaže: Pri skrbniku preverite, ali so za vašo organizacijsko enoto omogočeni spletni kavlji.
- URL je blokiran: Preverite seznam dovoljenih naslovov, če vaša izdaja uporablja to omejitev.
- Napaka 400: Preverite obliko telesa in polja, ki jih zahteva API.
- Napaka 401 ali 403: Preglejte dovoljenja in način preverjanja pristnosti, ki jih zahteva storitev.
- Napaka 429: Preverite, ali ste presegli omejitev zahtev za ciljni API.
- Napaka 500: Preverite status in zapise storitve, ki prejme zahtevo.
Upoštevajte tudi splošne omejitve programa Workspace Studio: trenutno podpira do 25 tokov na uporabnika y 20 korakov na tokPoleg tega obstaja skupna omejitev izvajanja, ki se ponastavi vsakih 24 ur. Če se več tokov ustavi, preglejte njihovo aktivnost, preden napako pripišete API-ju.
Za večino preprostih povezav HTTP je postopek preprost: omogočite spletni kavelj, konfigurirajte fiksni URL in pravilno metodo, preizkusite zahtevo in uporabite odgovor v naslednjih korakih. Če integracija zahteva napredno preverjanje pristnosti ali preoblikovanje podatkov s kodo, je smiselno pripraviti korak po meri.
Sem tehnološki navdušenec, ki je svoja "geek" zanimanja spremenil v poklic. Več kot 10 let svojega življenja sem porabil za uporabo vrhunske tehnologije in premleval najrazličnejše programe iz čiste radovednosti. Zdaj sem se specializiral za računalniško tehnologijo in video igre. To je zato, ker že več kot 5 let pišem za različna spletna mesta o tehnologiji in video igrah ter ustvarjam članke, ki vam želijo dati informacije, ki jih potrebujete, v jeziku, ki je razumljiv vsem.
Če imate kakršna koli vprašanja, moje znanje sega od vsega v zvezi z operacijskim sistemom Windows kot tudi Androidom za mobilne telefone. In moja zaveza je vam, vedno sem pripravljen porabiti nekaj minut in vam pomagati razrešiti kakršna koli vprašanja, ki jih morda imate v tem internetnem svetu.