Slik bruker du Google APIs Explorer med CSS3

Google tilbyr et vell av APIer for CSS3 som dekker alt fra å jobbe med Ad Exchange for å presentere kjøreinstruksjoner med Google Maps. Faktisk er det så mange APIer at de fleste utviklere ikke har noen ide om hvor mange av dem som finnes. Det er derfor Google APIs Explorer er viktig. Det hjelper deg å finne og få tilgang til alle APIene som Google støtter.

Slik registrerer du deg for en Google-konto

Du kan få tilgang til mange Google API-funksjoner uten en Google-konto. Imidlertid krever mange av funksjonene en konto, og det er vanligvis lettere å registrere seg for en i begynnelsen. For eksempel, når du bruker Google Maps, må du oppnå et token for å stille forespørsler fra webtjenesten.

For å starte prosessen er alt du trenger å gjøre, gå til Google-kontoer og klikk på Registrer deg. Du går til denne siden.

Når du har svar på en rekke spørsmål, klikker du på Neste trinn og følger de resterende retningene. Det tar ikke lang tid å skaffe kontoen og bekrefte det via din e-postkonto. Selv om du ikke bruker kontoen for andre elementer, trenger du det for utviklingsformål.

I noen tilfeller vil dokumentasjonen for en bestemt API anbefale at du får to kontoer: en for utvikling og en annen for testing. Årsaken til dette forslaget er at du muligens kan miste data ved å jobbe med API.

Hvis du bruker data på testkontoen din, er det vanligvis ikke et problem. Imidlertid kan tap av data på din utviklingskonto sette tilbake søknadsutviklingsarbeidet. Å lage to kontoer når det er nødvendig, er alltid en god ide.

Slik får du tak i en utvikler nøkkel

For å jobbe med mange av APIene må du skaffe en utvikler nøkkel. Google tilbyr to typer nøkler: Betalt og gratis. Du trenger bare den frie nøkkelen for eksperimenteringsformål. Den betalte nøkkelen gir betydelig mer fleksibilitet, og du vil sannsynligvis trenge det for et fullverdig program du lager. Men for eksperimentelle formål fungerer den frie nøkkelen helt fint.

Google API-en du bruker, vil fortelle deg om utviklernøkkelkravet som en del av dokumentasjonen. (Selv om det ikke forteller deg, vil du oppdage kravet første gang du prøver å gjøre en forespørsel). For eksempel får du en utvikler nøkkel for Google Maps hos Google Developers. Sørg for at du forstår vilkårene for bruk fullt før du begynner å jobbe med Google API.

Slik jobber du med Google APIs Explorer

Når du går til Google API Explorer-hovedsiden, ser du en liste over APIene.I tillegg får du en kort beskrivelse av API, API-versjonen, og om du har full tilgang til det. Enkelte APIer har betalt støtte for full tilgang eller har andre krav til deres bruk. Dessverre vil denne siden ikke fortelle hvilke funksjoner som mangler, eller hvorfor støtten er begrenset.

Når du klikker en kobling for en bestemt API, ser du en side som gir en kort beskrivelse av API-en, en lenke til dokumentasjonen og en oppføring av samtalene for den APIen. Anropslisten inneholder en kort beskrivelse av hvert API-anrop. Oppføringen er der for å hjelpe jogget ditt når du har glemt et anrop.

Pass på at du leser dokumentasjonen for en API grundig før du prøver å gjøre noe med det.

Når du klikker på et bestemt API-anrop, vises en side som inneholder tilleggsinformasjon om det aktuelle anropet. I tillegg ser du en testside for å faktisk utføre samtalen for å se hva den gjør. Alt du trenger å gjøre er å fylle ut feltene og klikk Utfør.

Dokumentasjonssiden gir tilgang til et vell av ressurser for å jobbe med APIen du har valgt. Hver API starter med en introduksjon som forteller deg alt om API. Du finner koblinger for å komme i gang, jobbe med klientbiblioteker og samhandle med fellesskapet som bruker API.

I tillegg gir hver API tilgang til en veiledning som beskriver hvordan du bruker API, en referanse som inneholder API-spesifikasjoner, og en forbindelse til eventuelle ressurser som API-en støtter.

En av de viktigste (og sannsynligvis oversett) koblingene på dokumentasjonssiden er imidlertid vilkårslinken. Pass på at du forstår betingelsene for bruk av API. Dessverre løper noen utviklere av de juridiske kravene og finner seg selv med en ikke-fungerende søknad som et resultat.