v0.2.0-beta

OpenAPI 3.1.0

Tworzenie zadań opinii Google (Business Data)

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operacje

post/v1/beta/dataforseo/business_data/google/reviews/task_post

Tworzenie zadań opinii Google (Business Data)

Dodaje do kolejki opinie profilu Google Business Profile i zwraca id zadania. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wynik pobierzesz przez get_dataforseo_business_google_reviews_fetch; sam profil zwraca post_dataforseo_business_google_gmb_info_live.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.06.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- cid
  Typ: string
  
  unikalny identyfikator podmiotu gospodarczego zdefiniowany przez Google
  pole wymagane, jeśli nie podasz keyword lub place_id
  przykład:
  194604053573767737
  więcej o identyfikatorze w tym artykule Centrum pomocy
- depth
  Typ: integer | null
  
  głębokość parsowania
  pole opcjonalne
  liczba opinii w SERP
  zdecydowanie zalecamy ustawianie głębokości parsowania w wielokrotnościach dziesięciu, ponieważ nasze systemy przetwarzają dziesięć opinii z rzędu
  wartość domyślna: 10
  wartość maksymalna: 4490
  Twoje konto zostanie rozliczone za każdy SERP zawierający do 10 wyników;
  ustawienie głębokości powyżej 10 może skutkować dodatkowymi opłatami, jeśli wyszukiwarka zwróci więcej niż 10 wyników;
  koszt można obliczyć na stronie Cennik.
- keyword
  Typ: string
  
  słowo kluczowe
  pole wymagane, jeśli nie podasz cid lub place_id
  podane słowo kluczowe powinno wskazywać nazwę lokalnego lokalu;
  w polu keyword możesz podać do 700 znaków;
  wszystkie ciągi %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja)
  jeśli potrzebujesz użyć znaku „%” w keyword, podaj go jako „%25”;
  
  jeśli to pole zawiera parametry takie jak „allinanchor:”, „allintext:”, „allintitle:”, „allinurl:”, „define:”, „filetype:”, „id:”, „inanchor:”, „info:”, „intext:”, „intitle:”, „inurl:”, „link:”, „related:”, „site:”, opłata za zadanie zostanie pomnożona przez 5
  Uwaga: zapytania zawierające parametr „cache:” nie są obsługiwane i zwrócą błąd walidacji
  
  więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach DataForSEO znajdziesz w tym artykule Centrum pomocy
- language_code
  Typ: string
  
  kod języka wyszukiwarki
  pole wymagane, jeśli nie podasz language_name
  jeśli użyjesz tego pola, nie musisz podawać language_name
  listę dostępnych języków wraz z ich language_code możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/languages
  przykład:
  en
- language_name
  Typ: string
  
  pełna nazwa języka wyszukiwarki
  pole wymagane, jeśli nie podasz language_code
  jeśli używasz tego pola, nie musisz podawać language_code
  listę dostępnych języków wraz z language_name możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/languages
  przykład:
  English
- location_code
  Typ: integer
  
  kod lokalizacji wyszukiwarki
  pole wymagane, jeśli nie podasz location_name lub location_coordinate
  jeśli użyjesz tego pola, nie musisz podawać location_name lub location_coordinate
  listę dostępnych lokalizacji z location_code możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/locations
  przykład:
  2840
- location_coordinate
  Typ: string
  
  współrzędne GPS lokalizacji
  pole wymagane, jeśli nie podasz location_name ani location_code
  jeśli używasz tego pola, nie musisz podawać location_name ani location_code
  parametr location_coordinate należy podać w formacie "latitude,longitude,radius"
  maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
  minimalna wartość dla "radius": 199.9
  przykład:
  53.476225,-2.243572,200
- location_name
  Typ: string
  
  pełna nazwa lokalizacji wyszukiwarki
  pole wymagane, jeśli nie podasz location_code lub location_coordinate
  jeśli użyjesz tego pola, nie musisz podawać location_code lub location_coordinate
  listę dostępnych lokalizacji z location_name możesz uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/business_data/google/locations
  przykład:
  London,England,United Kingdom
- pingback_url
  Typ: string | null
  
  adres URL powiadomienia o zakończonym zadaniu
  pole opcjonalne
  po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości
  przykład:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- place_id
  Typ: string
  
  identyfikator podmiotu gospodarczego w Google Maps
  pole wymagane, jeśli nie podasz keyword lub cid
  przykład:
  GhIJQWDl0CIeQUARxks3icF8U8A
  więcej o identyfikatorze w tym artykule Centrum pomocy
- postback_url
  Typ: string | null
  
  adres URL do wysyłania wyników zadania
  pole opcjonalne
  po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  przykład:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- priority
  Typ: integer | null
  
  priorytet zadania
  pole opcjonalne
  może przyjmować następujące wartości:
  1 – normalny priorytet wykonania (ustawiany domyślnie)
  2 – wysoki priorytet wykonania. Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
  Koszt można obliczyć na stronie Cennik.
- sort_by
  Typ: string | null
  
  parametry sortowania wyników
  pole opcjonalne
  za pomocą tego pola możesz sortować wyniki
  możliwe typy sortowania:
  newest – sortowanie od najnowszych
  highest_rating – sortowanie według najwyższej oceny
  lowest_rating – sortowanie według najniższej oceny
  relevant – sortowanie według trafności
  wartość domyślna: relevant
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  pole opcjonalne
  limit znaków: 255
  ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks
Typ: array (object | null)[] | null

tablica zadań

Typ: object | null · Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

propertyName
Typ: object | null
id
Typ: string | null

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

path
Typ: array (string | null)[] | null

ścieżka URL

result
Typ: object | null

tablica wyników
w tym przypadku wartością będzie null

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

post/v1/beta/dataforseo/business_data/google/reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "London,England,United Kingdom",
    "language_name": "English",
    "keyword": "hedonism wines",
    "depth": 50,
    "sort_by": "highest_rating"
  }
]'

Pokaż schemat

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Operacja zakończona powodzeniem

Tworzenie zadań opinii Google (Business Data)

UwierzytelnianieRequired

DataForSEO

Tworzenie zadań opinii Google (Business Data)

Informacje o cenach