Google Trends

Yhteenveto

Google Trends -liitin tarjoaa ohjelmallisen pääsyn Google Trends -palvelun tietoihin. Se mahdollistaa agenttien ja sovellusten saada tietoa avainsanojen suosiosta, kiinnostuksen maantieteellisestä jakautumisesta, tällä hetkellä trendikkäistä hauista, liittyvistä kysymyksistä ja hakuehdotuksista.

Liitin tukee erityisesti:

• avainsanojen kiinnostuksen historiallista analyysiä,
• useiden avainsanojen vertailua,
• tällä hetkellä trendikkäiden hakujen saamista,
• liittyvien aiheiden ja kysymysten analyysiä,
• hakuehdotuksia (automaattinen täydennys).

Kaikki toiminnot palauttavat rakenteellisia tietoja, jotka on saatu Google Trends API:sta. Trendikkäitä hakuja varten olevissa päätepisteissä on toteutettu varajärjestelmä RSS-lähteelle, jos ensisijainen API palauttaa virheen tai puutteellisia tietoja.

Käyttäjätarina: Kuinka käyttäjä lisää Google Trends -liittimen

1. Käyttäjä avaa Lisää yhteys -dialogin ja valitsee GoogleTrends

1. Hallinnassa siirry osioon Yhteydet / Liitetyt sovellukset.
2. Napsauta Lisää yhteys.
3. Liittimien luettelosta valitse laatikko GoogleTrends.

2. Käyttäjä täyttää liittimen tiedot

Yksityiskohta-lomakkeessa käyttäjä täyttää:

• Nimi: liitännän sisäinen nimi (esim. GoogleTrends).
• Anna ApiKey: API-avain, ei vaadita tässä käyttöönotossa.
• Anna aikavyöhyke: aikavyöhyke (esim. UTC).
• Anna kieli: vastausten kieli (esim. EN, CS).

3. Käyttäjä määrittää yksittäisten toimintojen käyttöoikeudet

Yhteyden luomisen jälkeen käyttäjä määrittää jokaiselle toiminnolle kutsumismoodin:

• Ota käyttöön,
• Ota käyttöön vahvistuksella,
• Poista käytöstä.

Suositus: toiminnot, jotka voivat vaikuttaa automaatioiden toimintaan, määritä vähintään Ota käyttöön vahvistuksella.

4. Käyttäjä tallentaa liittimen ja käyttää sitä

Tallennuksen jälkeen liitin on käytettävissä agenteille ja työnkulkuaskelille, joissa voidaan kutsua tiettyjä Google Trends -toimintoja asetettujen käyttöoikeuksien mukaan.

Liittimen konfiguraatioparametrit

Parametri	Pakollinen	Kuvaus
Nimi	Kyllä	Liittimen sisäinen nimi Siesta AI:ssä
ApiKey	Käytön mukaan	API-avain palveluun pääsyyn
Aikavyöhyke	Kyllä	Aikavyöhyke kyselyille (esim. UTC)
Kieli	Kyllä	Tulosten kieli (esim. EN, en-US)

Tuetut toiminnot

1. GetInterestOverTimeAsync

Palauttaa kiinnostuksen kehityksen yhdelle tai useammalle avainsanalle ajan myötä.

Parametri	Tyyppi	Pakollinen	Kuvaus
keywords	string	Kyllä	Lista 1-5 avainsanasta, erotettuna pilkulla
timeRange	string	Ei	Analysoitava ajanjakso
geo	string	Ei	Maantieteellinen alue (maan ISO-koodi)
category	int	Ei	Google Trends -kategoria

Oletusarvot:

• timeRange: LastThreeMonths
• geo: globaalisti (tyhjät arvot)
• category: 0 (kaikki kategoriat)

2. GetInterestByRegionAsync

Palauttaa kiinnostuksen jakautumisen tietyn avainsanan mukaan alueittain.

Parametri	Tyyppi	Pakollinen	Kuvaus
keyword	string	Kyllä	Yksi avainsana
timeRange	string	Ei	Ajanjakso
resolution	string	Ei	Maantieteellisen erottelun taso
geo	string	Ei	Maan koodi

Oletusarvot:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Vertaa useiden avainsanojen suosiota ajan myötä.

Parametri	Tyyppi	Pakollinen	Kuvaus
keywords	string	Kyllä	Lista 2-5 avainsanasta, erotettuna pilkulla
timeRange	string	Ei	Ajanjakso
geo	string	Ei	Maan koodi

4. GetTrendingSearchesAsync

Palauttaa tällä hetkellä trendikkäät haut.

Parametri	Tyyppi	Pakollinen	Kuvaus
country	string	Ei	Maan nimi

Oletusarvo:

• country: united_states

Käyttäytyminen:

1. Ensimmäinen yritys Google Trends API:n kautta.
2. Jos epäonnistuu, varajärjestelmä RSS-syötteelle.

5. GetTodaySearchesAsync

Palauttaa tänään trendikkäät haut.

Parametri	Tyyppi	Pakollinen	Kuvaus
country	string	Ei	Maan koodi

Oletusarvo:

• country: US

Käyttäytyminen:

• Ensisijaisesti API, epäonnistuessa varajärjestelmä RSS-syötteelle.

6. GetAllTrendingSearchesAsync

Palauttaa globaalisti trendikkäät haut useiden maiden kesken.

Parametri	Tyyppi	Pakollinen	Kuvaus
-	-	-	Toiminto ei vaadi parametreja

Käyttäytyminen:

• yritys saada tietoja API:n kautta,
• varajärjestelmä monimaan RSS-syötteelle.

7. GetRelatedQueriesAsync

Palauttaa kysymyksiä, jotka liittyvät tiettyyn avainsanaan.

Parametri	Tyyppi	Pakollinen	Kuvaus
keyword	string	Kyllä	Avainsana
timeRange	string	Ei	Ajanjakso
geo	string	Ei	Maan koodi

Tuloste sisältää:

• Top queries (yleisimmät liittyvät kysymykset),
• Rising queries (nopeasti kasvavat kysymykset).

8. GetRelatedTopicsAsync

Palauttaa aiheita, jotka liittyvät tiettyyn avainsanaan.

Parametri	Tyyppi	Pakollinen	Kuvaus
keyword	string	Kyllä	Avainsana
timeRange	string	Ei	Ajanjakso
geo	string	Ei	Maan koodi

Tuloste sisältää:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Palauttaa hakuehdotuksia (automaattinen täydennys) annetulle avainsanalle.

Parametri	Tyyppi	Pakollinen	Kuvaus
keyword	string	Kyllä	Osittainen tai kokonainen avainsana

10. GetCategoriesAsync

Palauttaa täydellisen luettelon Google Trends -kategorioista.

Parametri	Tyyppi	Pakollinen	Kuvaus
-	-	-	Toiminto ei vaadi parametreja

Tuetut timeRange -arvot

timeRange on kirjainkooltaan riippumaton ja tukee seuraavia arvoja:

Arvo	Kuvaus
LastHour	viimeinen tunti
LastFourHours	viimeiset 4 tuntia
LastDay	viimeiset 24 tuntia
LastWeek	viimeiset 7 päivää
LastMonth	viimeiset 30 päivää
LastThreeMonths	viimeiset 90 päivää
LastYear	viimeiset 12 kuukautta
LastFiveYears	viimeiset 5 vuotta
FromStart	kaikki saatavilla olevat historialliset tiedot

Jos arvo on virheellinen tai puuttuu, käytetään oletusarvoa LastThreeMonths.

Käyttökonteksti

Liittimen käyttäytymistä voi vaikuttaa suorituskonteksti:

Kenttä	Oletusarvo	Kuvaus
Kieli	en-US	Tulosten kieli
Aikavyöhyke	300	Aikavyöhykkeen siirto minuuteissa

Esimerkki:

Kieli: en-US
Aikavyöhyke: 300

Tietolähteiden strategiat

Trendikkäitä hakuja käsittelevissä päätepisteissä tietojen hankinta tapahtuu kahdessa vaiheessa:

1. Yritys saada tietoja Google Trends API:sta.
2. Jos API ei vastaa tai palauttaa puutteellisia tietoja, järjestelmä käyttää automaattisesti Google Trendsin RSS-syötettä.

Tämä mekanismi varmistaa tietojen paremman saatavuuden.

Rajoitukset

Rajoitus	Arvo
Avainsanojen määrä kyselyssä	1-5
Avainsanojen vertailu	2-5
Oletusaikajakso	LastThreeMonths

Yhteenveto

Google Trends -liitin on sopiva analyyttisiin käyttötapauksiin, aiheiden seurantaan, markkinointityönkulkuun ja trendien vertailuun ajan myötä. Se tarjoaa yhtenäisen rajapinnan Google Trends -tietojen käsittelyyn, mukaan lukien varajärjestelmän trendikkäille hauille.