SerpApi (wersja zapoznawcza)

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa	Class	Regions
Copilot Studio	Premium	Wszystkie regiony Power Automate z wyjątkiem następujących:      - Rząd USA (GCC)      - Rząd USA (GCC High)      - China Cloud obsługiwane przez firmę 21Vianet      - Departament Obrony USA (DoD)
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:      — Regiony platformy Azure Government      — Regiony platformy Azure (Chiny)      - Departament Obrony USA (DoD)
Power Apps	Premium	Wszystkie regiony Power Apps z wyjątkiem następujących:      - Rząd USA (GCC)      - Rząd USA (GCC High)      - China Cloud obsługiwane przez firmę 21Vianet      - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów	Premium	Wszystkie regiony Power Automate z wyjątkiem następujących:      - Rząd USA (GCC)      - Rząd USA (GCC High)      - China Cloud obsługiwane przez firmę 21Vianet      - Departament Obrony USA (DoD)

Kontakt biznesowy
Name	SerpApi
adres URL	https://serpapi.com
Email	support@serpapi.com

Metadane łącznika
Publisher	SerpApi
Witryna internetowa	https://serpapi.com
Zasady ochrony prywatności	https://serpapi.com/legal/privacy
Kategorie	Witryna internetowa; Analiza biznesowa

SerpApi

SerpApi to interfejs API wyników aparatu wyszukiwania w czasie rzeczywistym. Obsługuje serwery proxy, CAPTCHA i analizowanie, dzięki czemu przepływy Power Apps i Power Automate odbierają czysty, ustrukturyzowany kod JSON bez zarządzania infrastrukturą złomowania.

Publisher: SerpApi

Wymagania wstępne

• Konto SerpApi. Zarejestruj się w serpapi.com.
• Prawidłowy klucz interfejsu API SerpApi. Bezpłatne plany obejmują 250 wyszukiwań miesięcznie. Plany płatne są dostępne dla większej ilości.

Obsługiwane operacje

Google Search (GoogleSearch)

Pobierz ustrukturyzowane wyniki wyszukiwania Google dla danego zapytania. Zwraca wyniki organiczne, reklamy, wpisy grafu wiedzy, powiązane pytania, wyniki lokalne, najlepsze scenariusze i inne. Zwracane dokładne pola zależą od zapytania i tego, co udostępnia firma Google.

Pobieranie lokalizacji (GetLocations)

Zwraca listę obsługiwanych lokalizacji geograficznych, które można przekazać do location parametru wyszukiwania. Użyj tej funkcji, aby wyszukać dokładny ciąg lokalizacji dla miasta lub regionu przed uruchomieniem wyszukiwania.

Uzyskiwanie informacji o koncie (GetAccount)

Zwraca informacje o koncie SerpApi, w tym bieżący plan, miesięczny limit przydziału wyszukiwania, pozostałe wyszukiwania i statystyki użycia godzinowego.

Uzyskiwanie poświadczeń

1. Zaloguj się do konta usługi SerpApi na serpapi.com.
2. Przejdź do serpapi.com/manage-api-key.
3. Skopiuj klucz interfejsu API.
4. Podczas tworzenia połączenia w Power Apps lub Power Automate wklej klucz interfejsu API w polu Klucz interfejsu API.

Klucz interfejsu API jest bezpiecznie przechowywany przez platformę Power Platform i automatycznie wstrzykiwany do każdego żądania. Po skonfigurowaniu połączenia nie będzie konieczne ponowne podanie go.

Wprowadzenie

Podstawowy sposób użycia

Akcja GoogleSearch przyjmuje jeden wymagany argument (zapytanie wyszukiwania) i opcjonalny rekord dodatkowych parametrów:

Set(varJsonResponse, SerpApi.GoogleSearch("coffee"))

Aby wyświetlić nieprzetworzoną odpowiedź JSON w kontrolce Tekst HTML na potrzeby debugowania:

$"<pre>{JSON(varJsonResponse, JSONFormat.IndentFour)}</pre>"

Przekazywanie parametrów opcjonalnych

Parametry opcjonalne są przekazywane jako rekord (drugi argument). Uwzględnij tylko parametry, które chcesz ustawić — pominięcie klucza nie spowoduje wysłania niczego dla tego parametru, dzięki czemu serpApi użyje własnej wartości domyślnej.

W poniższym przykładzie typy danych wejściowych i nazwy są zaleceniami, a nie obowiązkowymi.

Set(varJsonResponse, SerpApi.GoogleSearch(
    searchQueryInput.Text,
    {
        location: locationInput.Text,
        gl: glInput.Text,
        hl: hlInput.Text,
        lat: latInput.Text,
        lon: lonInput.Text,
        radius: radiusInput.Text,
        uule: uuleInput.Text,
        google_domain: googleDomainInput.Text,
        cr: crInput.Text,
        lr: lrInput.Text,
        tbs: tbsInput.Text,
        nfpr: nfprCheckbox.Value,
        filter: filterCheckbox.Value,
        safe: safeDropdown.Selected.Value,
        device: deviceDropdown.Selected.Value,
        tbm: tbmDropdown.Selected.Value,
        start: startInput.Text,
        ludocid: ludocidInput.Text,
        lsig: lsigInput.Text,
        kgmid: kgmidInput.Text,
        si: siInput.Text,
        ibp: ibpInput.Text,
        uds: udsInput.Text,
        no_cache: noCacheCheckbox.Value
    }
))

Mapowanie typów kontrolek:

Typ parametru	Zalecana kontrolka Power Apps	Odwołanie do wartości
Tekst (ciąg)	Wprowadzanie tekstu	controlName.Text
logiczny	Przełącz lub pole wyboru	controlName.Value
Wyliczenie (stałe opcje)	Lista rozwijana	controlName.Selected.Value
Number	Wprowadzanie tekstu	controlName.Text

Uzyskiwanie dostępu do danych odpowiedzi

Odpowiedź jest obiektem JSON. Uzyskiwanie dostępu do właściwości najwyższego poziomu bezpośrednio ze zmiennej:

varJsonResponse.search_information.total_results

Aby powiązać galerię z wynikami organicznymi:

varJsonResponse.organic_results

Aby powiązać galerię z lokalnymi wynikami biznesowymi:

varJsonResponse.local_results.places

Zapoznaj się z dokumentacją serpApi Google Search , aby uzyskać pełną listę pól odpowiedzi.

Szukanie prawidłowego ciągu lokalizacji

Użyj GetLocations polecenia , aby znaleźć dokładną nazwę lokalizacji do przekazania do GoogleSearchelementu . Parametr q filtruje według nazwy miasta lub regionu i limit zwraca liczbę zwróconych wyników.

Set(varLocations, SerpApi.GetLocations("Austin", {limit: 5}))

Aby powiązać wyniki z galerią:

varLocations

Każdy element w kolekcji ma namepola , , canonical_namecountry_code, target_type, reachi gps . canonical_name Przekaż wartość jako location parametr w kolejnym GoogleSearch wywołaniu:

Set(varResults, SerpApi.GoogleSearch(
    "coffee shops",
    {location: locationGallery.Selected.canonical_name}
))

Sprawdzanie użycia konta

Użyj GetAccount polecenia , aby pobrać szczegóły bieżącego planu i użycie limitu przydziału. Jest to przydatne do sprawdzania, ile wyszukiwań pozostaje przed przekroczeniem limitu miesięcznego.

Set(varAccount, SerpApi.GetAccount())

Uzyskaj dostęp do poszczególnych pól poza odpowiedzią:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Aby uzyskać pełną listę pól odpowiedzi, zapoznaj się z dokumentacją interfejsu API konta serpApi .

Znane problemy i ograniczenia

• Struktura odpowiedzi zmiennej: pola obecne w odpowiedzi wyszukiwania Google zależą od zapytania i zwracanych przez firmę Google. Nie wszystkie pola są wyświetlane w każdej odpowiedzi. Zapoznaj się z dokumentacją serpApi Google Search , aby uzyskać pełny opis możliwych pól odpowiedzi.
• Limity szybkości: żądania podlegają miesięcznemu limitowi przydziału planu SerpApi i limitowi szybkości godzinowej. Przekroczenie jednej z tych wartości spowoduje wyświetlenie 429 odpowiedzi na błąd.
• Wyniki buforowane: domyślnie serpApi obsługuje wyniki z pamięci podręcznej dla zduplikowanych żądań specyficznych dla każdego użytkownika (do 1 godziny). Użyj parametru , no_cache aby wymusić nowy wynik. Należy pamiętać, że buforowane wyszukiwania nie są liczone do miesięcznego limitu przydziału.

Support

Aby uzyskać pomoc dotyczącą tego łącznika lub konta SerpApi, skontaktuj się z zespołem pomocy technicznej serpApi:

• Email:contact@serpapi.com
• Czat na żywo: dostępny 24/7 w serpapi.com, gdzie możesz porozmawiać bezpośrednio z członkiem zespołu pomocy technicznej SerpApi.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna	Parametry tworzenia połączenia.	Wszystkie regiony	Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name	Typ	Description	Wymagane
Klucz API	securestring	Klucz interfejsu API SerpApi. Znajdź go pod adresem https://serpapi.com/manage-api-key	True

Akcje

Uzyskiwanie informacji o koncie	Zwraca informacje o uwierzytelnianym koncie SerpApi, w tym szczegóły planu, pozostałe wyszukiwania i statystyki użycia.
Uzyskiwanie lokalizacji	Zwraca listę obsługiwanych lokalizacji geograficznych, których można użyć z parametrem location w wyszukiwaniu. Przydatne do znajdowania dokładnego ciągu lokalizacji dla miasta lub regionu.
Wyszukiwanie w Usłudze Google	Pobierz ustrukturyzowane wyniki wyszukiwania Google dla danego zapytania. Zwraca wyniki organiczne, reklamy, wykres wiedzy, powiązane pytania, najważniejsze historie, wyniki lokalne i inne.

Uzyskiwanie informacji o koncie

Uzyskiwanie lokalizacji

Wyszukiwanie w Usłudze Google

Definicje

Location

Informacje o koncie