v0.2.0-beta

OpenAPI 3.1.0

Tworzenie zadań opinii Google Shopping

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/merchant/google/reviews/task_post

Tworzenie zadań opinii Google Shopping

Kolejkuje opinie jednego produktu Google Shopping i zwraca id zadania. Produkt wskazujesz przez product_id oraz gid lub data_docid z wyniku produktów. Cała ta rodzina jest asynchroniczna: submit zwraca id zadania w tasks[0].id, a narzędzie fetch zwraca wynik, gdy będzie gotowy. Pobierz przez get_dataforseo_merchant_google_reviews_fetch.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.012.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej już kwoty klienta.

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

Treść

wymagane

application/json

Typ: array object[]
- Typ: object
  gid
  Typ: string
  wymagane
  
  globalny identyfikator produktu w Google Shopping. Pole wymagane. Zalecamy podanie gid razem z data_docid i product_id w celu uzyskania optymalnych wyników; tę wartość dla danego produktu możesz uzyskać, wysyłając osobne żądanie do endpointu Google Shopping Products. Przykład: 4702526954592161872. Więcej o parametrze w tym przewodniku Centrum pomocy.
  
  data_docid
  Typ: string
  
  unikalny identyfikator elementu danych SERP. Pole opcjonalne. Zalecamy podanie data_docid razem z product_id i gid w celu uzyskania optymalnych wyników; tę wartość dla danego elementu możesz uzyskać, wysyłając osobne żądanie do endpointu Google Shopping Products. Przykład: 13071766526042404278.
  
  depth
  Typ: integer
  
  głębokość analizy. Pole opcjonalne. Liczba opinii w SERP; zdecydowanie zalecamy ustawianie głębokości analizy w wielokrotnościach dziesięciu, ponieważ nasz system przetwarza po dziesięć opinii z rzędu. Maksymalna wartość: 8000. Wartość domyślna: 10. Twoje konto zostanie obciążone za każdy SERP zawierający do 10 wyników; ustawienie głębokości powyżej 10 może spowodować dodatkowe opłaty, jeśli wyszukiwarka zwróci więcej niż 10 wyników. Koszt można obliczyć na stronie Cennik.
  
  language_code
  Typ: string
  
  kod języka wyszukiwarki. Pole wymagane, jeśli nie podasz language_name. Jeśli używasz tego pola, nie musisz podawać language_name. Listę dostępnych języków wraz z ich parametrami language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/google/languages. Przykład: en_GB.
  
  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 ich parametrami language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/google/languages. Przykład: English (United Kingdom).
  
  location_code
  Typ: integer
  
  kod lokalizacji wyszukiwarki. Pole wymagane, jeśli nie podasz location_name lub location_coordinate. Jeśli używasz tego pola, nie musisz podawać location_name ani location_coordinate. Listę dostępnych lokalizacji wraz z ich parametrami location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/google/locations. Przykład: 9045969.
  
  location_coordinate
  Typ: string
  
  współrzędne GPS lokalizacji. Pole wymagane, jeśli nie podasz location_name lub 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żywasz tego pola, nie musisz podawać location_code ani location_coordinate. Listę dostępnych lokalizacji wraz z ich parametrami location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/google/locations. Przykład: HA1,England,United Kingdom.
  
  pingback_url
  Typ: string
  
  URL powiadomienia o ukończonym zadaniu pole opcjonalne po ukończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany URL możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag kodowanej w URL. Przed wysłaniem żądania ustawimy niezbędne 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 URL; m.in. znak # zostanie zakodowany jako %23 więcej informacji w naszym Centrum pomocy
  
  postback_data
  Typ: string
  
  typ danych postback_url pole opcjonalne odpowiada typowi danych, który zostanie wysłany na Twój serwer możliwe wartości: advanced
  
  postback_url
  Typ: string
  
  URL do wysyłania wyników zadania pole opcjonalne po ukoń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 kodowanej w URL. Przed wysłaniem żądania ustawimy niezbędne 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 URL; m.in. znak # zostanie zakodowany jako %23 więcej informacji w naszym Centrum pomocy
  
  priority
  Typ: integer
  
  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 z wysokim priorytetem wykonania zostanie naliczona dodatkowa opłata. koszt można obliczyć na stronie cennika.
  
  product_id
  Typ: string
  
  unikalny identyfikator produktu w Google Shopping pole opcjonalne zalecamy podawanie product_id razem z data_docid i gid, aby uzyskać optymalne wyniki; tę wartość dla konkretnego produktu można uzyskać, wysyłając osobne żądanie do endpointu Google Shopping Products przykład: 4485466949985702538 więcej informacji o parametrze w tym przewodniku Centrum pomocy
  
  se_domain
  Typ: string
  
  domena wyszukiwarki pole opcjonalne odpowiednią domenę wyszukiwarki wybieramy automatycznie na podstawie podanej lokalizacji i języka jednak w tym polu możesz ustawić niestandardową domenę wyszukiwarki przykład: google.co.uk, google.com.au, google.de itd.
  
  tag
  Typ: string
  
  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
  
  Pusty obiekt
  Pusty obiekt

Odpowiedzi

200
Typ: object

Pomyślna odpowiedź
cost
Typ: number

łączny koszt zadań, USD

status_code
Typ: integer

ogólny kod statusu. Pełną listę kodów odpowiedzi znajdziesz tutaj. Uwaga: zdecydowanie zalecamy zaprojektowanie systemu obsługi powiązanych warunków wyjątkowych lub błędów

status_message
Typ: string

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

tasks
Typ: array string[]

tablica zadań

tasks_count
Typ: integer

liczba zadań w tablicy tasks

tasks_error
Typ: integer

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

tasks.cost
Typ: number

koszt zadania, USD

tasks.data
Typ: object

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

tasks.id
Typ: string

unikalny identyfikator zadania w naszym systemie w formacie uniwersalnie unikalnego identyfikatora (UUID)

tasks.path
Typ: array string[]

ścieżka URL

tasks.result
Typ: array string[]

tablica wyników; w tym przypadku wartość będzie równa null

tasks.result_count
Typ: integer

liczba elementów w tablicy result

tasks.status_code
Typ: integer

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w zakresie: 10000-60000

tasks.status_message
Typ: string

komunikat informacyjny zadania

tasks.time
Typ: string

czas wykonania, sekundy

time
Typ: string

czas wykonania, sekundy

version
Typ: string

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/merchant/google/reviews/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

Pokaż schemat

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

Pomyślna odpowiedź

Tworzenie zadań opinii Google Shopping

UwierzytelnianieRequired

DataForSEO

Tworzenie zadań opinii Google Shopping

Cennik referencyjny